BRINGUP: correct the hot-swap note - kernel overlay edits require an image flash

This commit is contained in:
ScottW514
2026-08-03 16:15:12 -04:00
parent 32cc3ecdee
commit 1a723fa303
+6 -7
View File
@@ -74,14 +74,13 @@ motion constants were extracted from the `_RESOURCES` pulse files
glowforge`. NOTE: a module reload turns off the lid LED (relight via glowforge`. NOTE: a module reload turns off the lid LED (relight via
`/sys/class/leds/lid_led*/target`) and resets analog config (below). `/sys/class/leds/lid_led*/target`) and resets analog config (below).
- **Module hot-swap vs kernel re-stamps**: the hot-swap only loads if - **Module hot-swap vs kernel re-stamps**: the hot-swap only loads if
the module was built against the FLASHED kernel's patch state — any the module was built against the FLASHED kernel's patch state. Any
edit under the kernel recipe's overlay (e.g. glowforge.dts) edit under the kernel recipe's overlay (e.g. glowforge.dts)
re-stamps CONFIG_LOCALVERSION_AUTO and the module's vermagic stops re-stamps CONFIG_LOCALVERSION_AUTO — and the stamp does NOT
matching. To build a hot-swappable module after such an edit: reproduce by reverting the edit (the kernel patch tree is a fresh
`git checkout HEAD~1 -- <the edited file>` in the WSL meta-openglow git commit each do_patch, not sstate-restored), so after any
copy, `bitbake kernel-module-glowforge` (sstate restores the flashed overlay edit the module can only ship with a full image flash.
kernel's tree bit-for-bit), restore the file. The DT change itself Batch kernel-overlay edits accordingly.
waits for the next image flash.
- **Build host**: WSL2 distro `forge-yocto`, tree at - **Build host**: WSL2 distro `forge-yocto`, tree at
`~/dev/openglow-forgefirm`. `~/src-sync.sh` rsyncs the Windows repos in `~/dev/openglow-forgefirm`. `~/src-sync.sh` rsyncs the Windows repos in
(includes `python3-gfhardware` and `grblHAL-glowforge`). Build: (includes `python3-gfhardware` and `grblHAL-glowforge`). Build: