USB/CAN firmware-update bootloader for the PAROL6 control PCB, with Python host tools, verified staging and read-only SPI flash backup. V1-alpha.3 is an experimental prerelease candidate; USB bench results do not qualify robot use.
Installation · Compatibility · Release notes · Version policy
Bootloader idle: double flash every 2 seconds. Updating: rapid alternating flashes. New application: one heartbeat per second. Errors use a triple flash. See LED patterns and UART pin ownership. An application heartbeat does not indicate that motors are enabled or homed.
python -m pip install pyserial python-can
python host/update.py hello --transport usb --port COMx
python host/update.py info --transport usb --port COMxUse the board's actual port. Initial loader installation needs an SWD programmer
and reviewed backups; see INSTALL.md. Do not flash stock PAROL6 or F103 driver
application binaries through this loader.
With the loader already reachable, inspect an image before writing:
python host/update.py inspect --image parol6-bootloader-V1-alpha.3-probe.bin
python host/update.py flash --transport usb --port COMx --uid <verified-24-hex-uid> --image parol6-bootloader-V1-alpha.3-probe.bin --version 1 --require-runtime-handoff --startThe probe never commands motion. USB byte B requests recovery. From idle
recovery, host/update.py start --transport usb --port COMx --uid <uid> verifies
and starts the committed app without reflashing. App health must be observed
after USB re-enumeration; a Start ACK alone does not prove it.
STM32F446RE PAROL6 control PCB, layout 1. The loader occupies up to 64 KiB;
the boot journal reserves another 64 KiB. A cooperating app starts at
0x08020000, has up to 384 KiB, reserves the top 32 SRAM bytes and feeds the
inherited watchdog. Staging uses 0x501000..0x560fff of supported 8 MiB SPI NOR.
Actual PCB/module revisions and external storage ownership need review.
USB has physical smoke-test evidence. CAN1 is implemented but hardware testing is pending. UART PB10/PC11 is a separately routed engineering candidate; no UART binary is included in the prepared bundle. STEPFOC/Spectral use the separate STM32F103 loader, whose tools and firmware are not interchangeable with this one.
| Tool | Purpose |
|---|---|
host/update.py |
Offline image inspection, Hello, firmware information, staged update and installed-app start |
host/nor.py |
UID-pinned full/ranged NOR backups; twice-read chunks, CRC framing and file SHA-256 |
host/staging_test.py |
Explicit backed-up three-sector pattern test; cannot send Install/Boot/reset |
probe/ |
Relocated non-motion recovery example |
tests/ |
Native engine, interruption, wire, diagnostics and host tests; no physical port use |
tools/package_release.py |
Build a deterministic experimental bundle; never publishes |
python -m pip install platformio==6.2.0
python tests/verify.py --armWindows needs MSVC C++ Build Tools; Linux needs GCC/Clang. The source archive
contains its native build helper and does not depend on a parent checkout.
Platform, STM32duino and ARM toolchain package versions are pinned in
platformio.ini. Build/model evidence remains distinct from PCB evidence.
No stable release has been approved. CAN/UART, physical power-loss recovery, button entry, electrical timing and loaded-arm update/holding policies remain open. There are no signed images, anti-rollback, automatic rollback/resume or multi-mainboard CAN discovery. The extended IDs are fixed for one mainboard per initial test channel. The package does not add motion control or full Commander/Python runtime compatibility.
Ask questions in Source Robotics Discussions and report reproducible problems in this repository's issue tracker.
GPL-3.0-only, with corresponding source and LICENSE included. See
THIRD_PARTY.md for build dependencies and references.