Waveshare ESP32 board compiles and uploads, but does not work with Reticulum yet

Boards.h

@@ -125,6 +125,10 @@
   #define MODEL_FE            0xFE // Homebrew board, max 17dBm output power
   #define MODEL_FF            0xFF // Homebrew board, max 14dBm output power
 
+  // Board added by Mees Electronics
+  #define BOARD_WAVESHARE_ESP32_S3_PICO 0x61 // Waveshare ESP32 S3 Pico
+  #define MODEL_31                      0x31 // SX1278
+
   // Displays
   #define OLED 0x01
   #define EINK_BW 0x02
@@ -411,15 +415,15 @@
 
       const uint8_t interfaces[INTERFACE_COUNT] = {SX1276};
       #if HAS_TCXO == true
-        const bool interface_cfg[INTERFACE_COUNT][3] = { 
+        const bool interface_cfg[INTERFACE_COUNT][3] = {
                         // SX127X
               {
                   true, // DEFAULT_SPI
                   true, // HAS_TCXO
                   false  // DIO2_AS_RF_SWITCH
-              }, 
+              },
         };
-      const int8_t interface_pins[INTERFACE_COUNT][10] = { 
+      const int8_t interface_pins[INTERFACE_COUNT][10] = {
                   // SX127X
           {
               18, // pin_ss
@@ -444,16 +448,16 @@
       #endif
 
       #if HAS_TCXO == false
-      const bool interface_cfg[INTERFACE_COUNT][3] = { 
+      const bool interface_cfg[INTERFACE_COUNT][3] = {
                     // SX127X
           {
               true, // DEFAULT_SPI
               false, // HAS_TCXO
               false  // DIO2_AS_RF_SWITCH
-          }, 
+          },
       };
 
-      const int8_t interface_pins[INTERFACE_COUNT][10] = { 
+      const int8_t interface_pins[INTERFACE_COUNT][10] = {
                   // SX127X
           {
               18, // pin_ss
@@ -1022,6 +1026,61 @@
               -1  // pin_tcxo_enable
           }
       };
+
+    #elif BOARD_MODEL == BOARD_WAVESHARE_ESP32_S3_PICO
+      #define IS_ESP32S3 true
+      #define HAS_DISPLAY false
+      #define HAS_BLUETOOTH false
+      #define HAS_BLE true
+      #define HAS_PMU true
+      #define HAS_CONSOLE true
+      #define HAS_EEPROM true
+      //#define HAS_INPUT true
+      //#define HAS_SLEEP true
+      //#define PIN_WAKEUP GPIO_NUM_0
+      //#define WAKEUP_LEVEL 0
+      #define INTERFACE_COUNT 1
+      #define OCP_TUNED 0x38
+
+      const int pin_btn_usr1 = 0;
+
+      #define HAS_NP true
+      const int pin_np = 21;
+      #if HAS_NP == false
+        #if defined(EXTERNAL_LEDS)
+          const int pin_led_rx = 16;
+          const int pin_led_tx = 17;
+        #else
+          const int pin_led_rx = 21;
+          const int pin_led_tx = 21;
+        #endif
+      #endif
+
+      const uint8_t interfaces[INTERFACE_COUNT] = {SX1278};
+      const bool interface_cfg[INTERFACE_COUNT][3] = {
+                    // SX1278
+          {
+              false, // DEFAULT_SPI
+              false, // HAS_TCXO
+              false  // DIO2_AS_RF_SWITCH
+          },
+      };
+      const uint8_t interface_pins[INTERFACE_COUNT][10] = {
+                  // SX1278
+          {
+               10, // pin_ss
+               12, // pin_sclk
+               11, // pin_mosi
+               13, // pin_miso
+              -1, // pin_busy
+              15, // pin_dio
+               14, // pin_reset
+              -1, // pin_txen
+              -1, // pin_rxen
+              -1  // pin_tcxo_enable
+          }
+      };
+
     #else
       #error An unsupported ESP32 board was selected. Cannot compile RNode firmware.
     #endif

CHANGELOG.md

@@ -11,6 +11,23 @@ All notable changes to this project will be documented in this file.
     Fixed     : for any bug fixes.
     Security  : in case of vulnerabilities.
 
+## 2025-02-24
+
+Added new board (Waveshare ESP32-S3 Pico) to source code.
+
+Pinout Ra-02 LoRa transceiver:
+
+|pin|GPIO|
+|---|----|
+|NSS|10|
+|MOSI|11|
+|MISO|13|
+|SCK|12|
+|RST|14|
+|DIO|15|
+
+Can compile the source (with "make firmware-waveshare-esp32-s3-pico") and upload the program to ESP32 (with "make upload-waveshare-esp32-s3-pico"). According to the oscilloscope the SPI bus works. Reticulum still gives errors: "TX power mismatch" and "Radio state mismatch". RGB LED works, so Reticulum seems to communicate with the rnode.
+
 ## [1.74] - 2025-02-17
 
 Version from https://github.com/liberatedsystems/RNode_Firmware_CE

Documentation/HOWTO-change-firmware-and-compile-it_MeesElectronics.md

@@ -0,0 +1,248 @@
+# How to compile the rnode firmware yourself
+
+## Dependencies
+
+Make sure 'git', 'make', 'python' and 'pip' are instaled. Most like;y these are already availble on your system. Otherwise do:
+
+    $ sudo apt install git
+    $ sudo apt install make
+    $ sudo apt install pip
+    $ sudo apt install python
+
+Download arduino-cli
+
+    $ cd
+    $ curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh
+
+Add arduino-cli to path by editing ~/.bashrc
+
+    $ nano ~/.bashrc
+
+    add 'export PATH=~/bin:$PATH' to end of file
+
+## Clone git repo
+
+    $ git clone https://github.com/liberatedsystems/RNode_Firmware_CE.git
+
+## Prepare
+
+Install the required BSP and libraries for the ESP32 system.
+
+    $ cd RNode_Firmware_CE/
+    $ make prep-esp32
+
+This command stalled. I stopped the command by hiting CTRL-C and restarted it.
+
+Add rns software to path:
+
+    $ nano ~/.bashrc
+
+    add 'export PATH=~/.local/bin:$PATH' to the end of the file.
+
+## Test
+
+To test if you can compile the firmware try it:
+
+    $ make firmware-heltec32_v3
+
+Fingers crossed!
+
+## Define new board, the theory
+
+In order to build custom firmware for a new board it has to be defined in several files.
+
+### Makefile
+
+BOARD_MODEL defines the target board. It is a unique 8 bit number.
+BOARD_VARIANT defines the variant of the board. A board could come with different LoRa transceivers, for example. It is also a unique 8 bit number.
+
+Every target board has a section 'firmware-<board_name>', 'upload-<board-name>' and 'release-<board-name>'
+
+### boards.h
+
+Both BOARD_MODEL and BOARD_VARIANT are #defines in this file. They are used to define the pinout of the SPI port and if it has certain perifirals such as a screen BLE etc.
+
+Let's see an example:
+
+    #elif BOARD_MODEL == BOARD_HELTEC32_V3
+      #define IS_ESP32S3 true
+      #define HAS_DISPLAY true
+      #define DISPLAY OLED
+      #define HAS_BLUETOOTH false
+      #define HAS_BLE true
+      #define HAS_PMU true
+      #define HAS_CONSOLE true
+      #define HAS_EEPROM true
+      #define HAS_INPUT true
+      #define HAS_SLEEP true
+      #define PIN_WAKEUP GPIO_NUM_0
+      #define WAKEUP_LEVEL 0
+      #define INTERFACE_COUNT 1
+      #define OCP_TUNED 0x38
+
+      const int pin_btn_usr1 = 0;
+
+      #if defined(EXTERNAL_LEDS)
+        const int pin_led_rx = 13;
+        const int pin_led_tx = 14;
+      #else
+        const int pin_led_rx = 35;
+        const int pin_led_tx = 35;
+      #endif
+
+      const uint8_t interfaces[INTERFACE_COUNT] = {SX1262};
+      const bool interface_cfg[INTERFACE_COUNT][3] = { 
+                    // SX1262
+          {
+              true, // DEFAULT_SPI
+              true, // HAS_TCXO
+              true  // DIO2_AS_RF_SWITCH
+          }, 
+      };
+      const int8_t interface_pins[INTERFACE_COUNT][10] = { 
+                  // SX1262
+          {
+              8, // pin_ss
+              9, // pin_sclk
+              10, // pin_mosi
+              11, // pin_miso
+              13, // pin_busy
+              14, // pin_dio
+              12, // pin_reset
+              -1, // pin_txen
+              -1, // pin_rxen
+              -1  // pin_tcxo_enable
+          }
+      };
+
+If we want to add support for a new board we have to add a new section for this board. Here we define all the features it has or not has.
+
+## Define new board for real
+
+Let's say we want to add support for the Waveshare ESP32-S3 Pico with an SX1278 LoRa transceiver. First we have to make define both BOARD_MODEL and BOARD_VARIANT. Let's define BOARD_MODEL as 0x61 and BOARD_VARIANT as 0x31 as these numbers are not used yet. Here the 0x31 indicates the use of a SX1278 LoRa transceiver. In the future we can define more transceivers for this board. Then we make entries in the Makefile.
+
+    firmware-waveshare-esp32-s3-pico:
+	    arduino-cli compile --fqbn "esp32:esp32:esp32s3:CDCOnBoot=cdc" $(COMMON_BUILD_FLAGS) --build-property "compiler.cpp.extra_flags=\"-DBOARD_MODEL=0x61\" \"-DBOARD_VARIANT=0x31\""
+
+    upload-waveshare-esp32-s3-pico:
+	    arduino-cli upload -p $(or $(port), /dev/ttyACM0) --fqbn esp32:esp32:esp32s3
+	    @sleep 1
+	    rnodeconf $(or $(port), /dev/ttyACM0) --firmware-hash $$(./partition_hashes ./build/esp32.esp32.waveshare-esp32-s3-pico/RNode_Firmware_CE.ino.bin)
+	    @sleep 3
+	    python ./Release/esptool/esptool.py --port $(or $(port), /dev/ttyACM0) --chip esp32-s3 --baud 921600 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 80m --flash_size 4MB 0x210000 ./Release/console_image.bin
+
+    release-waveshare-esp32-s3-pico:
+        arduino-cli compile --fqbn "esp32:esp32:esp32s3:CDCOnBoot=cdc" $(COMMON_BUILD_FLAGS) --build-property "compiler.cpp.extra_flags=\"-DBOARD_MODEL=0x61\" \"-DBOARD_VARIANT=0x31\""
+        cp ~/.arduino15/packages/esp32/hardware/esp32/$(ARDUINO_ESP_CORE_VER)/tools/partitions/boot_app0.bin build/rnode_firmware_waveshare-esp32-s3-pico.boot_app0
+        cp build/esp32.esp32.waveshare-esp32-s3-pico/RNode_Firmware_CE.ino.bin build/rnode_firmware_waveshare-esp32-s3-pico.bin
+        cp build/esp32.esp32.waveshare-esp32-s3-pico/RNode_Firmware_CE.ino.bootloader.bin build/rnode_firmware_waveshare-esp32-s3-pico.bootloader
+        cp build/esp32.esp32.waveshare-esp32-s3-pico/RNode_Firmware_CE.ino.partitions.bin build/rnode_firmware_waveshare-esp32-s3-pico.partitions
+        zip --junk-paths ./Release/rnode_firmware_waveshare-esp32-s3-pico.zip ./Release/esptool/esptool.py ./Release/console_image.bin build/rnode_firmware_t3s3_sx126xrnode_firmware_waveshare-esp32-s3-pico.boot_app0 build/rnode_firmware_waveshare-esp32-s3-pico.bin build/rnode_firmware_waveshare-esp32-s3-pico.bootloader build/rnode_firmware_waveshare-esp32-s3-pico.partitions
+        rm -r build
+
+In the file Boards.h make an entry for the new board within the '#if MCU_VARIANT == MCU_ESP32':
+
+    #elif BOARD_MODEL == BOARD_WAVESHARE_ESP32_S3_PICO
+      #define HAS_DISPLAY true
+      #define DISPLAY OLED
+      #define HAS_BLUETOOTH true
+      #define HAS_PMU true
+      #define HAS_CONSOLE true
+      #define HAS_EEPROM true
+      #define INTERFACE_COUNT 1
+
+      const uint8_t interfaces[INTERFACE_COUNT] = {SX1276};
+      #if HAS_TCXO == true
+        const bool interface_cfg[INTERFACE_COUNT][3] = {
+                        // SX127X
+              {
+                  true, // DEFAULT_SPI
+                  true, // HAS_TCXO
+                  false  // DIO2_AS_RF_SWITCH
+              },
+        };
+      const int8_t interface_pins[INTERFACE_COUNT][10] = {
+                  // SX127X
+          {
+              18, // pin_ss
+              -1, // pin_sclk
+              -1, // pin_mosi
+              -1, // pin_miso
+              -1, // pin_busy
+              26, // pin_dio
+              23, // pin_reset
+              -1, // pin_txen
+              -1, // pin_rxen
+              33  // pin_tcxo_enable
+          }
+      };
+      #endif
+      #if defined(EXTERNAL_LEDS)
+        const int pin_led_rx = 15;
+        const int pin_led_tx = 4;
+      #else
+        const int pin_led_rx = 25;
+        const int pin_led_tx = 25;
+      #endif
+
+      #if HAS_TCXO == false
+      const bool interface_cfg[INTERFACE_COUNT][3] = {
+                    // SX127X
+          {
+              true, // DEFAULT_SPI
+              false, // HAS_TCXO
+              false  // DIO2_AS_RF_SWITCH
+          },
+      };
+
+      const int8_t interface_pins[INTERFACE_COUNT][10] = {
+                  // SX127X
+          {
+              18, // pin_ss
+              -1, // pin_sclk
+              -1, // pin_mosi
+              -1, // pin_miso
+              -1, // pin_busy
+              26, // pin_dio
+              23, // pin_reset
+              -1, // pin_txen
+              -1, // pin_rxen
+              -1  // pin_tcxo_enable
+          }
+      };
+      #endif
+
+Also, in the file Utilities.h add entry. Again, within the '#if MCU_VARIANT == MCU_ESP32'.
+
+    	#elif BOARD_MODEL == BOARD_LORA32_V2_1
+            void led_rx_on()  { digitalWrite(pin_led_rx, HIGH); }
+            void led_rx_off() {	digitalWrite(pin_led_rx, LOW); }
+            void led_tx_on()  { digitalWrite(pin_led_tx, HIGH); }
+            void led_tx_off() { digitalWrite(pin_led_tx, LOW); }
+            void led_id_on()  { }
+            void led_id_off() { }
+
+### Flashing the board
+
+Make shure you are in the dialout group. If not:
+
+    $ sudo usermod -aG dialout <username>
+
+If you are flashing a custom board, you will need to generate a signing key in rnodeconf prior to flashing if you do not already have one by running:
+
+    $ rnodeconf -k
+
+Than flash the firmware.
+
+    $ make upload-waveshare-esp32-s3-pico
+
+This will end with error 'This device has not been provisioned yet, cannot set firmware hash'. But fear not. After flashing a custom board, you will also need to provision the EEPROM before use:
+
+    $ rnodeconf /dev/ttyACM0 -r --platform ESP32 --model a4 --product f0 --hwrev 3
+
+### Migrating to a other system
+
+When the rnode is flashed, it is signed with a key. If you conect the rnode to another system, this key cannot be validated. It is possible to write a new key to the rnode by erasing the eeprom and writing the local key to it.
+
+    $ rnodeconf /dev/ttyACM0 --eeprom-wipe
+    $ rnodeconf /dev/ttyACM0 -r --platform ESP32 --model a9 --product f0 --hwrev 3

Makefile

@@ -151,6 +151,10 @@ firmware-opencom-xl:
 firmware-heltec_t114:
 	arduino-cli compile --log --fqbn Heltec_nRF52:Heltec_nRF52:HT-n5262 -e --build-property "build.partitions=no_ota" --build-property "upload.maximum_size=2097152" --build-property "compiler.cpp.extra_flags=\"-DBOARD_MODEL=0x3C\""
 
+# Added board from Mees Electronics
+firmware-waveshare-esp32-s3-pico: check_bt_buffers
+	arduino-cli compile --fqbn "esp32:esp32:esp32s3:CDCOnBoot=cdc" $(COMMON_BUILD_FLAGS) --build-property "compiler.cpp.extra_flags=\"-DBOARD_MODEL=0x61\""
+
 upload-tbeam:
 	arduino-cli upload -p $(or $(port), /dev/ttyACM0) --fqbn esp32:esp32:t-beam
 	@sleep 1
@@ -264,6 +268,14 @@ upload-techo:
 	@sleep 6
 	rnodeconf /dev/ttyACM0 --firmware-hash $$(./partition_hashes from_device /dev/ttyACM0)
 
+# Added board from Mees Electronics
+upload-waveshare-esp32-s3-pico:
+	arduino-cli upload -p $(or $(port), /dev/ttyACM0) --fqbn esp32:esp32:esp32s3
+	@sleep 1
+	rnodeconf $(or $(port), /dev/ttyACM0) --firmware-hash $$(./partition_hashes ./build/esp32.esp32.esp32s3/RNode_Firmware_CE.ino.bin)
+	@sleep 3
+	python3 ./Release/esptool/esptool.py --port $(or $(port), /dev/ttyACM0) --chip esp32-s3 --baud 921600 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 80m --flash_size 4MB 0x210000 ./Release/console_image.bin
+
 release:  console-site spiffs-image $(shell grep ^release- Makefile | cut -d: -f1)
 
 release-hashes:
@@ -504,3 +516,13 @@ release-heltec_t114:
 	cp build/Heltec_nRF52.Heltec_nRF52.HT-n5262/RNode_Firmware_CE.ino.hex build/rnode_firmware_heltec_t114.hex
 	adafruit-nrfutil dfu genpkg --dev-type 0x0052 --application build/rnode_firmware_heltec_t114.hex Release/rnode_firmware_heltec_t114.zip
 	rm -r build
+
+# Added by Mees Electronics
+release-waveshare-esp32-s3-pico: check_bt_buffers
+	arduino-cli compile --fqbn esp32:esp32:ttgo-lora32 $(COMMON_BUILD_FLAGS) --build-property "compiler.cpp.extra_flags=\"-DBOARD_MODEL=0x61\""
+	cp ~/.arduino15/packages/esp32/hardware/esp32/$(ARDUINO_ESP_CORE_VER)/tools/partitions/boot_app0.bin build/rnode_firmware_lora32v21.boot_app0
+	cp build/esp32.esp32.ttgo-lora32/RNode_Firmware_CE.ino.bin build/rnode_firmware_lora32v21.bin
+	cp build/esp32.esp32.ttgo-lora32/RNode_Firmware_CE.ino.bootloader.bin build/rnode_firmware_lora32v21.bootloader
+	cp build/esp32.esp32.ttgo-lora32/RNode_Firmware_CE.ino.partitions.bin build/rnode_firmware_lora32v21.partitions
+	zip --junk-paths ./Release/rnode_firmware_lora32v21.zip ./Release/esptool/esptool.py ./Release/console_image.bin build/rnode_firmware_lora32v21.boot_app0 build/rnode_firmware_lora32v21.bin build/rnode_firmware_lora32v21.bootloader build/rnode_firmware_lora32v21.partitions
+	rm -r build

Utilities.h

@@ -289,6 +289,13 @@ uint8_t boot_vector = 0x00;
 		void led_tx_off() { digitalWrite(pin_led_tx, LOW); }
 		void led_id_on()  { }
 		void led_id_off() { }
+	#elif BOARD_MODEL == BOARD_WAVESHARE_ESP32_S3_PICO
+		void led_rx_on()  { digitalWrite(pin_led_rx, HIGH); }
+		void led_rx_off() {	digitalWrite(pin_led_rx, LOW); }
+		void led_tx_on()  { digitalWrite(pin_led_tx, HIGH); }
+		void led_tx_off() { digitalWrite(pin_led_tx, LOW); }
+		void led_id_on()  { }
+		void led_id_off() { }
 	#endif
 #elif MCU_VARIANT == MCU_NRF52
     #if HAS_NP == true