Firmware Updates
Your display receives firmware updates automatically over WiFi.
How Updates Work
Each time your display wakes up, it checks with the LuxWX server for available firmware updates. If an update is available, the display downloads it automatically in the background.
During the update, the screen shows "Updating firmware..." for about 30–60 seconds. The display will restart once the update is complete.
Do I need to do anything?
No. Updates are fully automatic when enabled (the default). The display handles everything — downloading, installing, and restarting.
Can I disable automatic updates?
Yes. In your display settings, you can turn off automatic updates. You'll still be able to trigger updates manually when you choose.
What if an update fails?
The display has built-in safety mechanisms. If an update fails, it automatically rolls back to the previous working version. After 3 consecutive failures, the display pauses updates for 24 hours before trying again.
Will updates happen on low battery?
No. The display skips firmware updates when battery voltage is below 3.5V to prevent issues during the update process. Charge the display and it will update on the next wake cycle.
How often are updates released?
We release updates as needed for new features, bug fixes, and improvements. Updates are rolled out gradually — your display may receive an update a few hours after it's published.
How can I check my firmware version?
Your current firmware version is shown in the display settings page on luxwx.com, alongside battery level and other device info.
Flash Firmware via USB
You can install firmware directly via USB-C from your browser using the Flash Firmware page. This uses the Web Serial API (Chrome or Edge on desktop only).
When should I use USB flashing?
USB flashing is for situations where OTA updates can't reach the display:
- Initial setup — brand new display that has never connected to WiFi
- Recovery — display is stuck, not connecting to WiFi, or a previous OTA update failed
- Factory reset — you want to wipe the display and start from scratch
- BYOD — you have your own E1001 or E1002 and want to flash LuxWX firmware onto it
Which hardware model do I select?
The flash page has a model selector at the top. Choose the model that matches your display hardware:
- E1001 — 7.5" monochrome (black & white) e-ink display
- E1002 — 7.3" Spectra 6-color e-ink display (Seeed reTerminal)
Flashing the wrong model firmware won't damage the hardware, but the display won't render correctly until you re-flash with the correct version.
How do I view device logs?
The install dialog has a Logs & Console option after connecting to the display. This shows real-time serial output from the device — useful for diagnosing WiFi connection issues, boot loops, or sensor errors.
To view logs: click "Install" on the flash page, select the serial port, and in the dialog that appears choose Logs & Console instead of installing firmware.
I have my own E1001 or E1002 — can I flash it myself?
Yes. If you purchased an E1001 or E1002 display independently (BYOD), you can use the Flash Firmware page to install LuxWX firmware via USB. Select the correct model (E1001 or E1002), flash the firmware, and the display will boot into WiFi setup mode. From there, follow the WiFi setup guide to connect it, then claim the display to link it to your account.
LuxWX firmware only runs on E1001 and E1002 hardware. Other e-ink displays or generic ESP32 boards are not supported.
A LuxWX subscription is required to use an e-ink display, whether purchased from us or your own. E-ink support is included in the base subscription.