Skip to content

Open-Source Firmware

Zenso firmware is fully open source under the GNU General Public License v3 (GPLv3). It manages power cycling, Wi-Fi connectivity, and display updates.

Clone the official repository and open it in PlatformIO (VS Code or CLI):

Terminal window
git clone https://github.com/zensoink/zenso-firmware.git
cd zenso-firmware
pio run -t upload

Connect the frame to your computer via USB-C while holding the BOOT button if entering download mode manually.

Open the PlatformIO serial monitor at 115200 baud (pio device monitor) to access the developer diagnostic interface:

  • h: Print diagnostic command list
  • c: Clear saved Wi-Fi credentials from LittleFS
  • r: Force hardware reboot
  • 1: Render primary color test pattern
  • 2: Cycle waveform white-wipe test
  • 4: Print battery ADC reading and supply voltage

You are free to audit, modify, and extend the firmware. If you distribute modified firmware binaries, you must make the corresponding source code publicly available under GPLv3.