Add variant for ST Nucleo-WL55JC1

Adds repeater, room_server, companion_radio_usb and kiss_modem
environments for the NUCLEO-WL55JC1 (STM32WL55JC, integrated SubGHz radio).

Notes on the board setup:

- Uses the upstream nucleo_wl55jc board. PlatformIO's boards_remap maps it
  to the core's NUCLEO_WL55JC1 variant, so the LEDs, user buttons and the
  LPUART1 -> ST-LINK VCP serial mapping all come from the core rather than
  being redefined here.
- The RF switch table is built from the core's LORAWAN_RFSWITCH_* macros
  (SP3T front end on PC3/PC4/PC5) so it tracks upstream if those are ever
  revised. Both RFO_LP and RFO_HP are registered, so RadioLib selects HP
  above 14 dBm and LP below it.
- board_build.extra_flags pins the device to STM32WL55xx. The stock board
  manifest declares product_line STM32WL55xx but extra_flags -DSTM32WLE5xx;
  that only works because every #elif chain happens to test WL55xx first.
- The Nucleo's LD1..LD3 are driven active HIGH, so the TX LED hooks are
  inverted relative to STM32Board's active-LOW default.
- 32 KB reserved at the top of flash for LittleFS, as on the other
  STM32WL variants.

Verified on hardware: all four environments build; repeater and room_server
flash and run over ST-LINK; identity and prefs persist across reboot and
across a firmware swap; and GPIOC reads back the documented RX levels at
idle, confirming the front-end switch is driven correctly.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Will MacGregorandClaude Opus 5 committed 2026-11-04 09:46:40 -05:00
1 parent bb3e77dc36
commit dd78cc35d2
4 files changed
+174

No files matched your search

+57
View File
@@ -0,0 +1,57 @@
[nucleo_wl55jc]
extends = stm32_base
board = nucleo_wl55jc
; The upstream board manifest tags the part as STM32WLE5xx even though its
; product_line is STM32WL55xx. Pin both to WL55 so a single device header and
; startup file (startup_stm32wl55xx_cm4.s) are in play.
board_build.extra_flags = -DSTM32WL -DSTM32WLxx -DSTM32WL55xx
board_upload.maximum_size = 229376 ; 32kb at the top of flash reserved for LittleFS
build_flags = ${stm32_base.build_flags}
-D RADIO_CLASS=CustomSTM32WLx
-D WRAPPER_CLASS=CustomSTM32WLxWrapper
-D LORA_TX_POWER=22
-D SPI_INTERFACES_COUNT=0
-D RX_BOOSTED_GAIN=true
-D STM32WL_TCXO_VOLTAGE=1.7
-D P_LORA_TX_LED=LED_BLUE
-D PIN_USER_BTN=USER_BTN
-D USER_BTN_PRESSED=LOW
-I variants/nucleo_wl55jc
build_src_filter = ${stm32_base.build_src_filter}
+<../variants/nucleo_wl55jc>
[env:nucleo_wl55jc_repeater]
extends = nucleo_wl55jc
build_flags = ${nucleo_wl55jc.build_flags}
-D ADVERT_NAME='"Nucleo WL55JC Repeater"'
-D ADMIN_PASSWORD='"password"'
-D MAX_NEIGHBOURS=50
build_src_filter = ${nucleo_wl55jc.build_src_filter}
+<../examples/simple_repeater/*.cpp>
[env:nucleo_wl55jc_companion_radio_usb]
extends = nucleo_wl55jc
build_flags = ${nucleo_wl55jc.build_flags}
-D MAX_CONTACTS=100
-D MAX_GROUP_CHANNELS=8
-D ENABLE_USB_INTERFACE ; binds to Serial, i.e. the ST-LINK virtual COM port
build_src_filter = ${nucleo_wl55jc.build_src_filter}
+<../examples/companion_radio/*.cpp>
lib_deps = ${nucleo_wl55jc.lib_deps}
densaugeo/base64 @ ~1.4.0
[env:nucleo_wl55jc_kiss_modem]
extends = nucleo_wl55jc
build_src_filter = ${nucleo_wl55jc.build_src_filter}
+<../examples/kiss_modem/>
[env:nucleo_wl55jc_room_server]
extends = nucleo_wl55jc
build_flags = ${nucleo_wl55jc.build_flags}
-D ADVERT_NAME='"Nucleo WL55JC Room"'
-D ADVERT_LAT=0.0
-D ADVERT_LON=0.0
-D ADMIN_PASSWORD='"password"'
-D ROOM_PASSWORD='"hello"'
build_src_filter = ${nucleo_wl55jc.build_src_filter}
+<../examples/simple_room_server>
+65
View File
@@ -0,0 +1,65 @@
#include <Arduino.h>
#include "target.h"
#include <helpers/ArduinoHelpers.h>
NucleoWL55JCBoard board;
RADIO_CLASS radio = new STM32WLx_Module();
WRAPPER_CLASS radio_driver(radio, board);
// The NUCLEO-WL55JC1 drives an SP3T front-end switch from FE_CTRL1..3 (PC4, PC5, PC3),
// routing the single SMA between RX, RFO_LP and RFO_HP. Pin order and levels are taken
// straight from the core's board definition (variant_NUCLEO_WL55JC1.h) so they stay in
// sync with upstream.
static const uint32_t rfswitch_pins[] = {LORAWAN_RFSWITCH_PINS, RADIOLIB_NC, RADIOLIB_NC};
static const Module::RfSwitchMode_t rfswitch_table[] = {
{STM32WLx::MODE_IDLE, {LORAWAN_RFSWITCH_OFF_VALUES}},
{STM32WLx::MODE_RX, {LORAWAN_RFSWITCH_RX_VALUES}},
{STM32WLx::MODE_TX_LP, {LORAWAN_RFSWITCH_RFO_LP_VALUES}},
{STM32WLx::MODE_TX_HP, {LORAWAN_RFSWITCH_RFO_HP_VALUES}},
END_OF_MODE_TABLE,
};
VolatileRTCClock rtc_clock;
SensorManager sensors;
#ifndef LORA_CR
#define LORA_CR 5
#endif
#ifndef STM32WL_TCXO_VOLTAGE
// The board is fitted with a 32MHz TCXO powered from the radio's DIO3 at 1.7V
#define STM32WL_TCXO_VOLTAGE 1.7
#endif
#ifndef LORA_TX_POWER
#define LORA_TX_POWER 22
#endif
bool radio_init() {
radio.setRfSwitchTable(rfswitch_pins, rfswitch_table);
// Both PA paths are registered above, so RadioLib picks RFO_HP whenever the
// requested power is above 14dBm, and RFO_LP below that.
int status = radio.begin(LORA_FREQ, LORA_BW, LORA_SF, LORA_CR, RADIOLIB_SX126X_SYNC_WORD_PRIVATE, LORA_TX_POWER, 16, STM32WL_TCXO_VOLTAGE, 0);
if (status != RADIOLIB_ERR_NONE) {
Serial.print("ERROR: radio init failed: ");
Serial.println(status);
return false; // fail
}
#ifdef RX_BOOSTED_GAIN
radio.setRxBoostedGainMode(RX_BOOSTED_GAIN);
#endif
radio.setCRC(1);
return true; // success
}
mesh::LocalIdentity radio_new_identity() {
RadioNoiseListener rng(radio);
return mesh::LocalIdentity(&rng); // create new random identity
}
+47
View File
@@ -0,0 +1,47 @@
#pragma once
#define RADIOLIB_STATIC_ONLY 1
#include <RadioLib.h>
#include <helpers/radiolib/RadioLibWrappers.h>
#include <helpers/stm32/STM32Board.h>
#include <helpers/radiolib/CustomSTM32WLxWrapper.h>
#include <helpers/ArduinoHelpers.h>
#include <helpers/SensorManager.h>
class NucleoWL55JCBoard : public STM32Board {
public:
void begin() override {
STM32Board::begin();
pinMode(P_LORA_TX_LED, OUTPUT);
digitalWrite(P_LORA_TX_LED, LOW); // see note on LED polarity below
pinMode(PIN_USER_BTN, INPUT_PULLUP);
}
const char* getManufacturerName() const override {
return "ST Nucleo WL55JC1";
}
// LD1..LD3 on the Nucleo are driven active HIGH, whereas STM32Board's
// default TX-LED handling assumes the active LOW wiring used by the
// Wio-E5 boards. Invert both halves here.
void onBeforeTransmit() override {
digitalWrite(P_LORA_TX_LED, HIGH); // turn TX LED on
}
void onAfterTransmit() override {
digitalWrite(P_LORA_TX_LED, LOW); // turn TX LED off
}
// No battery on this dev board, it is USB/ST-LINK powered.
uint16_t getBattMilliVolts() override {
return 0;
}
};
extern NucleoWL55JCBoard board;
extern WRAPPER_CLASS radio_driver;
extern VolatileRTCClock rtc_clock;
extern SensorManager sensors;
bool radio_init();
mesh::LocalIdentity radio_new_identity();
+5
View File
@@ -0,0 +1,5 @@
#pragma once
#include <variant_NUCLEO_WL55JC1.h>
#undef RNG