Skip to content

About

PAROL6 STM32F446 bootloader with staged USB/CAN firmware updates and Python host tools. Experimental prerelease.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

PAROL6 STM32F446 bootloader

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

Install the host tools

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 COMx

Use 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.

Quick start

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 --start

The 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.

Works with

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.

Tools and examples

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

Build and test from this source archive

python -m pip install platformio==6.2.0
python tests/verify.py --arm

Windows 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.

Release status

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.

Community

Ask questions in Source Robotics Discussions and report reproducible problems in this repository's issue tracker.

Licensing

GPL-3.0-only, with corresponding source and LICENSE included. See THIRD_PARTY.md for build dependencies and references.

About

PAROL6 STM32F446 bootloader with staged USB/CAN firmware updates and Python host tools. Experimental prerelease.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages