Phosphor

A retro VFD-style desk gadget for the Waveshare ESP32-S3-Touch-LCD-3.49: clock, weather, internet radio, focus timer and pixel scenes.

Star on GitHub

Phosphor is free and open source. A star helps other people find it.

This replaces what the board runs now. Whatever is on it, including the Waveshare factory demo, is not kept. Phosphor does not back it up and cannot restore it.
This browser cannot talk to USB devices. Use Chrome or Edge on a computer. The installer needs a secure page (https).

Steps

  1. Connect the board to the computer with a USB-C data cable.
  2. Press Install Phosphor. Chrome lists serial ports: pick USB JTAG/serial debug unit (cu.usbmodem… on a Mac, COM3 or similar on Windows, ttyACM0 on Linux). On a first install tick Erase device, confirm, and wait for Installation complete (about a minute). Close the installer window with Next or the ×.
  3. The board restarts and shows a Wi-Fi name like Phosphor-Setup-1A2B and a QR code. On your phone, join that Wi-Fi (no password). A setup page opens by itself. If it does not, or your browser shows normal websites, the phone is still using mobile data: turn off mobile data, open Safari (or any browser) and type http://192.168.4.1 in the address bar.
  4. On the setup page (if you see a menu first, tap Configure WiFi):
    1. tap your home Wi-Fi in the list (2.4 GHz, see below),
    2. type its password,
    3. scroll down: under the password there is Device name, already filled in as phosphor-1a2b. Keep it or change it to something short like desk: this is the name you type in the next step.
      Write this name down. You need it in the next step to reach the settings, and the board does not show it anywhere else.
    4. tap Save. The board joins your Wi-Fi and shows the clock. Turn mobile data back on.
  5. With the phone back on your home Wi-Fi, open http://<your device name>.local/settings with the name from step 4. Named it desk? Then it is http://desk.local/settings; kept the default? Something like http://phosphor-1a2b.local/settings. There you set your city, language and radio stations.

Troubleshooting

No "USB JTAG/serial debug unit" in the port list
Try another cable (many only charge) or another USB port. Still nothing: hold BOOT on the back while you plug the cable in, then try again. Not sure which entry is the board? Unplug it, look at the list, plug it back in: the new entry is the board.
The board does not join my Wi-Fi
Most often a mistyped password: phones capitalise the first letter. Hold BOOT for 5 seconds and try again. The ESP32 also only works with 2.4 GHz Wi-Fi: if your router has a separate 5 GHz network (often named "…-5G"), pick the other one.
The setup Wi-Fi or setup page is gone
Hold BOOT on the back for 5 seconds. The board forgets the saved Wi-Fi and shows Phosphor-Setup-… again, until you finish the setup. (When a saved Wi-Fi fails, the board also opens the setup by itself after a restart, but only for 3 minutes.)
The setup page does not open, or the browser shows normal websites
The phone is using mobile data instead of the board's Wi-Fi. Turn off mobile data, check you are joined to Phosphor-Setup-… ("no internet" there is normal), then type http://192.168.4.1 in the browser's address bar (with http://, or the browser searches for it).
I forgot the device name
Open your router's list of connected devices: the board shows up under its name (and its IP address works too: http://192.168.x.x/settings). Or hold BOOT for 5 seconds and set up the Wi-Fi again.
desk.local does not open
The phone must be on the same Wi-Fi as the board. Some Android phones cannot open .local addresses: use a computer, or the board's IP address from your router's list of connected devices (http://192.168.x.x/settings).
A radio station does not play
Use Test on the settings page first. MP3 and AAC streams are tested; some others may not play.
Star on GitHub

Enjoying it on your desk? A star on GitHub is the easiest way to say thanks.

Source, issues and license (GPL-3.0): github.com/melihkoray/phosphor. Made by Melih Koray.