README.md

Color Kit Grande Tide Clock

Tide clock application for the ThingPulse Color Kit Grande.

This project is based on the original Color Kit Grande weather project and was adapted to display tidal information.

Credits

Special thanks to John Mulvaney for adapting the weather project to a Tide Clock focused experience.

Setup

1) Prerequisites

• VS Code with the PlatformIO extension installed
• A ThingPulse Color Kit Grande connected via USB

2) Configure user settings

Edit src/settings.h and set at least:

• SSID and WIFI_PWD
• TIMEZONE
• OPEN_WEATHER_MAP_API_KEY
• OPEN_WEATHER_MAP_LOCATION_ID and DISPLAYED_LOCATION_NAME
• Tide station settings (STATION_ID, STATION_NAME, DATUM, and offsets)

3) Build and upload firmware

From the project root, run:

platformio run --target upload

4) Upload filesystem assets (LittleFS)

This project uses files in data/ (including moon and tide images). Upload them with:

platformio run --target uploadfs

5) Open serial monitor (optional)

platformio device monitor

Notes

• Tide data is fetched from NOAA and adjusted using the offset values in src/settings.h.
• The app also uses OpenWeatherMap for weather/sun/moon context.
• See general Color Kit Grande docs at https://docs.thingpulse.com/guides/esp32-color-kit-grande/.