PlantCtrl/website/content/Software/1737993506015-Firmware-Upload/index.md

title, date, draft, description, tags

title	date	draft	description	tags
Firmware Upload	2025-01-27	false	a description	firmeware upload

From Source

Preconditions

• Rust: Current version of rustup.
• ESP32 Toolchain: espup installed and configured.
• espflash: Installed via cargo install espflash.
• Node.js: npm installed (for the web interface).

Flashing via USB

1. Connect the MainBoard to your computer via USB.
2. Ensure the board is powered and not in deep sleep.
3. Build the web interface (only required once or if you changed something in src_webpack):

   cd Software/MainBoard/rust/src_webpack
   npm install
   npx webpack
   cd ..
   

4. Flash the firmware:

   espflash flash --monitor --partition-table partitions.csv
   

   Note: If the flashing fails, you might need to put the ESP32-C6 into bootloader mode by holding the BOOT button while resetting or connecting USB.

Simplified Flashing with Scripts

You can use the provided bash scripts to automate the build and flash process:

• ./flash.sh: Cleans temporary files, builds the web interface, compiles the firmware, and flashes it to the board.
• ./all.sh: Similar to flash.sh, but also saves a local image.bin of the firmware.

OTA (Over-the-Air) Update

You can also update the firmware wirelessly if the system is already running and connected to your network.

1. Generate the OTA binary:

   cargo build --release
   

2. The binary will be at target/riscv32imac-unknown-none-elf/release/plant-ctrl2.
3. Open the PlantCtrl web interface in your browser.
4. Navigate to the OTA section.
5. Upload the plant-ctrl2 file.
6. The system will reboot into the new firmware once the upload and verification are complete.

Troubleshooting

• Bootloader Partition: If the bootloader is currently booting from ota_2, flashing to the factory partition via USB might not automatically switch the active partition. You can use espflash erase-parts otadata to reset the OTA state.
• Serial Terminal: Use espflash monitor to view the serial logs for debugging.