LED Matrix Clock with weather running on a Raspberry Pico W and a WaveShare Pico-RGB-Matrix-P3-64x32
This project requires that you use circuitpython 9.x.x. If you still wish to use 8.x you will need to use an older release
A subscription to Open Weather Map (OWM) is required to display the current conditions and the current condition icon. Tempest api is optional, if provided it will pull all information except the above two items from OWM.
Go to the OWM sign up and using the free subscription is enough to create a working Token for this project. Put the token from the OWM API Keys page into the settings.toml file in the OWM_API_TOKEN="" setting. OWM uses your geolocation which gets looked up via the Geolocation api, for this you need to provide your zipcode and the Country under OWM settings listed below. Be sure to enable the OWM api by setting the OWM_ENABLE=1 to turn it on.
Sign into your tempest portal to create a application token under Settings and find your stationID (in the URL after you sign up). Put the token from Data Authorizations in the settings.toml file under TEMPEST_API_TOKEN="" and enter the station under the TEMPEST_STATION=xxxxx where xxxxx is the number from tempestwx.com/station/xxxxx/ Be sure to enable the tempest api by setting the TEMPEST_ENABLE=1 to turn it on.
Requires a settings.toml file with the following settings in settings file:
- WIFI_SSID="your ssid"
- WIFI_PASSWORD="yoursupersecretpassword"
- NTP_HOST="0.adafruit.pool.ntp.org"
- TZ_OFFSET= ie TZ_OFFSET=-5
- NTP_INTERVAL=6
- UNITS="imperial" # imperial or metric
- TEMPEST_ENABLE=0 # 0 = disabled, 1 = enabled
- TEMPEST_API_TOKEN="yourDataAuthorizationToken"
- TEMPEST_STATION=0 #YourStationNumber
- OWM_ENABLE=0 # 0 = disabled, 1 = enabled
- OWM_API_TOKEN="Your Token"
- OWM_ZIP="zip/post code"
- OWM_COUNTRY="US" # Please use ISO 3166 country codes
To enable in application settings you must rename the _boot.py file to boot.py and place it on your device.
With this setting enabled any changes to the in menu setting ( Buzzer/ Autodim / 12/24 hr clock / DST Adjust ) will persist when you turn the device off and turn it back on again.
Settings:
- APPLY DST - Moves time ahead by 1 hour (you must manually turn it on and off) ** Only Works with NTP enabled **
- BEEP SET - Turns the beeping for button presses on and off
- AUTODIM - When the light sensor detects its dark it will dim the display (turn the LED display off).
- 12/24 HR - Changes the clock between 12 and 24 hour display.
NOTE When boot.py is enabled the drive becomes read only for your computer, to make changes you must hold down the menu / KEY0 button (Bottom button) when you turn on the device. This setting is only read at boot and restarting will have no effect on this setting.
This project requires the use of a Raspberry Pico W to use the WIFI for getting information for displaying on the screen such as updated time, and eventually local weather. (api to be defined soon)
This project requires that you use circuitpython 9.x.x.
Circuit libraries are included in the ./lib/src folder, just copy the ./src folder to the Pico. Most of the libraries are located on the CircuitPython libraries page. Notes:
- The schedule library is located in the version 8.x Community Bundle.
- The IR_RX library is located on github.
Connects to a Network Time Protocol server (0.adafruit.pool.ntp.org) and sets the onboard DS3231 RTC based on the time from the NTP response.
Not implemented yetS
This project moving forward will be converting changed code to loosely meet the google python coding standard.
To ignore the code.py overriding the std lib error add the following to your .vscode.json config file.
"python.languageServer": "Pylance",
[...]
"python.analysis.diagnosticSeverityOverrides": {
"reportShadowedImports": "none"
},
Memory is on the ragged edge of the Pico W limits and as such many api requests fail do to memory allocation issues.