Project Run Book

To Run Docusaurus Locally

It is useful to run Docusaurus locally to preview the changes before pushing to remote repository.

cd website
npm install
npm run build
npm run serve

Platform IO Commands

List Connected Devices

pio device list

Monitor Serial Output

pio device monitor

Unit Test

pio test -e native -v

or

sh ./run_test.sh

Build Project with default environment

pio run

Troubleshooting

Board Not Detected

Make sure the USB cable is properly connected and is a data-capable cable (some cables are power-only). Check that the correct drivers for your board are installed.

If the Board is in deep sleep mode, press the reset button to wake it up before uploading.

If the cable is already connected, you press and hold the BOOT key then press the Reset key once, you can enter BootLoader Mode

When it somehow still gets stuck in deep sleep the device won't be detected. while push and holding the boot button and connect the cable again. then it will be in Bootloader Mode

# List available devices
pio device list

# Manual port specification
pio run --target upload --upload-port /dev/ttyUSB0

Filesystem Upload Fails

The data partition (LittleFS/SPIFFS) has been removed. The HTML configuration page is now embedded directly in the firmware binary. If you need to update the HTML, edit data/config_my_station.html and rebuild the firmware — the pre-build script (tools/embed_html.py) regenerates the header automatically.

# Erase flash completely
pio run --target erase

# Re-upload firmware
pio run --target upload