Leges Gentium

Hardware

Board companion

Put the country explorer on a Waveshare ESP32-C6-LCD-1.47. The 1.47-inch screen shows each nation’s flag colors, name, continent, and system of government. Use desktop Chrome or Edge.

Hardware actions unavailable. Checking browser support…

1

Install / update CircuitPython

Do this once per board. It flashes the official CircuitPython 10.3.2 build for waveshare_esp32_c6_lcd_1_47 from this site. The installer checks that the chip is an ESP32-C6 before it writes anything.

Installing may erase the program and saved settings on the board. The installer will ask whether to erase the whole flash; choose erase for a clean first install. No Waveshare factory image is hosted here, so reinstalling CircuitPython is the way to recover.

Installing needs desktop Chrome or Edge over HTTPS.

The installer can’t find the board
  1. Use a USB data cable, not a charge-only cable.
  2. In the port picker, look for “USB JTAG/serial debug unit” or “Espressif”. Labels vary; unplug and replug to see which entry appears.
  3. Close other tabs, serial monitors, Thonny, or Arduino IDE.
  4. For download mode: hold BOOT, press and release RESET, then release BOOT. Try again.
  5. After flashing, press RESET once if the screen stays blank.
2

Upload app

Copies the Leges Gentium app 1.0.0 to the board over USB serial: code.py, boot.py, and the libraries it needs (adafruit_display_text, adafruit_ticks from the pinned 10.x bundle 20261112). Nothing is recompiled or reflashed; you never have to find libraries yourself.

Each file is staged, checked with a CRC, and import-tested before it replaces anything. Your current code.py stays active until then, and is kept as code_prev.py.

Uploading needs desktop Chrome or Edge.

3

Connect ESP32

Connecting only talks to the app that is already on the board; it never installs or erases anything. This page shows Connected only after the board answers the version handshake.

Not connected

Connecting needs desktop Chrome or Edge.

Which port do I pick?
  • Look for “USB JTAG/serial debug unit” or “Espressif”. Labels vary by computer.
  • Not sure? Unplug the board, open the picker, plug it back in, and choose the entry that appears.
  • Only one tab or program can use the port. Close serial monitors and other tabs of this app.
  • Resetting the board can change the port entry. If it disconnects, click Connect again.
LEGES GENTIUMAMArmeniaASIAGOVERNMENTUnitary parliamentaryrepublicBOOT: NEXT 1/15
Browser preview only · 172 × 320 px. Flags are simplified; the board uses its built-in pixel font.
Intended (this page)
Armenia · 5%
Confirmed by board
Not connected

Picking a country on the home page globe also updates the board. The BOOT button on the board steps to the next country.

5%
0%Max 50% (Waveshare guidance)

Settings are stored on the board only when you save. Without saved settings the board starts at 5%.

Diagnostics (0 events)

Also written to the browser console with a “[v0]” prefix. Lines from the board without “LG:” are diagnostic only.

  1. No events yet.

Before the workshop: test on a real board

Automated browser tests here only checked the page, its validation, and the simulated preview. None of these have been verified on hardware yet. Run each one in a normal browser tab.

  • Fresh CircuitPython install from step 1 — not yet tested
  • Upload with no libraries already on the board — not yet tested
  • Library imports succeed on the board — not yet tested
  • App starts and the screen draws — not yet tested
  • Command and acknowledgement round-trip — not yet tested
  • Brightness stays low at boot — not yet tested
  • Reconnect restores brightness and country — not yet tested
  • Unplugging mid-upload leaves the old app working — not yet tested
  • BOOT button steps to the next country — not yet tested
  • Board screen matches the web preview — not yet tested