Skip to content

Commit 839e4f4

Browse files
jamesarichclaude
andcommitted
docs: NOMADSTAR_METEOR_PRO likely needs no new board port (#5)
Diffed meshtastic/firmware's variants/nrf52840/rak4631_nomadstar_meteor_pro variant.h against plain rak4631's: the only differences are peripheral-level (RGB LED driver chip - NCP5623 vs LP5562, sensor I2C addresses, a buzzer pin, battery-sense calibration constants added via a WisBlock IO module). Nothing touches this bootloader's MCU, flash layout, or USB identity - it's the same RAK4631 module underneath. That means wiscore_rak4631_board's existing UF2 should already work on this hardware unchanged, with no new src/boards/ entry needed. Documenting this finding in README and AGENTS.md rather than opening a new board PR that would just duplicate wiscore_rak4631_board's files for no reason - but it's still unconfirmed on a real device, so not closing #5 yet. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
1 parent a64e2bc commit 839e4f4

2 files changed

Lines changed: 17 additions & 4 deletions

File tree

AGENTS.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -162,9 +162,20 @@ itself; a human has to edit it too.
162162
that pattern, don't replace the file.
163163
- **Board gaps are tracked as issues, not guessed at.** `Meshtastic-Android`
164164
flags `NANO_G2_ULTRA` and `NOMADSTAR_METEOR_PRO` as needing bootloader
165-
upgrade support with no board here yet (issues #4, #5) — bringing up a
166-
new board needs real hardware to get `UF2_BOARD_ID`/VID-PID/pin defs
167-
right; don't fabricate a `board.h` without one.
165+
upgrade support (issues #4, #5). Neither is hardware-confirmed yet:
166+
- `NOMADSTAR_METEOR_PRO` is RAK4631-based; diffing its firmware variant
167+
against plain `rak4631`'s shows only peripheral-level differences (RGB
168+
LED driver chip, sensor I2C, buzzer) — nothing this bootloader touches.
169+
Likely needs **no new `src/boards` entry at all**, just confirmation
170+
that `wiscore_rak4631_board`'s existing UF2 flashes and boots on one
171+
(see the [README's RAK4631 note](./README.md#notes-on-rak4631-bootloader)).
172+
- `NANO_G2_ULTRA` needs a genuinely new board — bringing one up requires
173+
real hardware to get `UF2_BOARD_ID`/VID-PID/pin defs right; don't
174+
fabricate a `board.h` without at least sourcing every field from
175+
somewhere real (`meshtastic/firmware`'s own variant files, the
176+
vendor's PlatformIO board manifest, etc.) and flagging clearly what's
177+
still unconfirmed.
178+
Don't close either issue without an actual hardware test.
168179
- **`CURRENT.UF2` dump-and-restore used to hang the device — fixed in #20,
169180
don't reintroduce it.** Root cause: `CURRENT.UF2` was sized off the max
170181
possible app region (`TRUE_USER_FLASH_SIZE`) instead of the real

README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ bootloader and SoftDevice zip package").
7777
- Minewsemi MX25LE01
7878
- Nologo ProMicro NRF52840 (aka SuperMini NRF52840)
7979
- RAK 3401
80-
- RAK 4631 ([See note](#notes-on-rak4631-bootloader))
80+
- RAK 4631 ([See note](#notes-on-rak4631-bootloader)) — also covers NomadStar Meteor Pro, see the same note
8181
- RAK WisMesh Tag
8282
- Seeed Studio SenseCAP Card Tracker T1000-E
8383
- Seeed SenseCAP Solar Node P1
@@ -221,6 +221,8 @@ If the file shows: "Board-ID: nRF52840-SeeedXiaoSense-v1" then the ***SENSE*** v
221221

222222
This version of the RAK4631 bootloader is based on a much newer version (0.9.2) of the Adafruit nRF52 bootloader than what RAK Wireless uses on their official bootloader (0.6.2-11). It has been tested with no problems found; whether RAK's own patches to the Adafruit bootloader introduce any behavioral difference has not been investigated. A variant of the official RAK bootloader with these patches included instead is available [here](https://github.com/oltaco/WisCore_RAK4631_Bootloader/releases).
223223

224+
**NomadStar Meteor Pro** is RAK4631-based hardware with an added RGBW LED and e-ink display bolted on via a WisBlock IO module. Diffing its [firmware variant](https://github.com/meshtastic/firmware/tree/master/variants/nrf52840/rak4631_nomadstar_meteor_pro) against plain RAK4631's shows only peripheral-level differences (the RGB LED driver chip, sensor I2C addresses, a buzzer pin, battery-sense calibration) — nothing this bootloader's MCU/flash/USB identity touches. It should be able to use this same RAK4631 UF2 unchanged, but **this has not been confirmed on real hardware** — if you have one, please try flashing it and report back on [issue #5](https://github.com/meshtastic/Adafruit_nRF52_Bootloader_OTAFIX/issues/5).
225+
224226
---
225227

226228
## Contributing

0 commit comments

Comments
 (0)