Troubleshooting

Troubleshooting

Problem	Fix
Screen is black / won't turn on	Use a USB-A → USB-C cable into a normal USB-A port or charger. Some C-to-C cables don't power this board. Try another port/charger.
Stuck on the "SETUP" screen	It can't reach your Wi-Fi. Re-join the StockTicker-Setup hotspot, open http://192.168.4.1, and carefully re-enter your Wi-Fi name + password (case-sensitive, 2.4GHz).
Setup page won't open	Keep your phone on the StockTicker-Setup network (turn off mobile data so it doesn't switch). Then browse to http://192.168.4.1 manually.
A stock shows "no data"	The symbol isn't valid on Yahoo Finance. Use e.g. BRK-B (dash, not dot). Verify at https://finance.yahoo.com.
Prices look stale / slow to update	Outside market hours the device updates slowly on purpose (closed_interval, default 600s). During market hours it uses refresh_interval (default 60s).
Chart says "no chart"	Not enough intraday data points yet (e.g. right at market open, or for thinly-traded symbols). It fills in as the day progresses.
Screen keeps dimming	That's the power-saving auto-dim. Tap BOOT to wake. Increase Dim after or set it to 0 to disable in Settings.
Wrong orientation	Change Screen orientation in Settings and Save & Reboot.
Forgot the device's IP	Tap BOOT to wake, tap again — the CONFIG screen shows the IP.
Want to start completely over	Re-run ./flash.sh (see Flashing Guide), or push a fresh config.json.

Watching the logs

Connect over USB and open the REPL to see what's happening:

mpremote connect /dev/cu.usbmodem* repl

Useful lines:

• web server on :80 (captive) — it's in setup/hotspot mode
• ntp synced, unix = ... — clock set (used for market-session timing)
• refreshed REGULAR {...} — a successful price fetch (with the session)
• fetch err SYMBOL ... — a problem fetching one symbol

Press Ctrl-] to exit the REPL.

Factory-ish reset

To wipe Wi-Fi/stocks back to defaults (useful before gifting), push a clean config.json with empty Wi-Fi:

mpremote connect /dev/cu.usbmodem* fs cp config.json :config.json

(The repo's config.json already ships with empty Wi-Fi, so the device boots straight into setup mode.)