From 3d09c66abd7e5ac169dce9cab31d55982b1f7eee Mon Sep 17 00:00:00 2001 From: IoTThinks Date: Sat, 14 Mar 2026 10:05:01 +0700 Subject: [PATCH] Revise wiring instructions and sensor address notes Updated wiring instructions for various boards and added notes for PowerSaving 13+. Clarified sensor address selection for BME280/680/BMP280. --- firmware/Add-sensors-to-repeaters.md | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/firmware/Add-sensors-to-repeaters.md b/firmware/Add-sensors-to-repeaters.md index ed01102..cbb7a2a 100644 --- a/firmware/Add-sensors-to-repeaters.md +++ b/firmware/Add-sensors-to-repeaters.md @@ -8,15 +8,23 @@ PowerSaving firmware has powersaving feature and additional features. - **8.5mA** power consumption for all NRF52 boards. ## 1. Quick Wiring -Ping us to add your boards in [Discussion](https://github.com/IoTThinks/EasySkyMesh/discussions/categories/ideas) +For PowerSaving 13 and above, you can enter CLI "sensor" to check I2C and GPS Serial pins +* PowerSaving 13+ automatically selects addresses for BME280/680/BMP280 for you. + +image +image + + +This is the wiring for some common boards: +* PowerSaving 13+ automatically selects addresses 0x76 or 0x77 for BME280/680/BMP280 for you. | Board | Wiring for I2C sensors | Notes | | ------------- | ------------- | ------------- | -| Heltec v3 / v4 / WSL3 | 3.3v => 3.3v
GND => GND
17 => SDA
18 => SCL

GND => SDO (BME280/680) | On Heltec v3, the GPIO17 and 18 are tiny pads in the middle of the board bottom.
Check the [notes](https://github.com/IoTThinks/EasySkyMesh/blob/main/firmware/Add-sensors-to-repeaters.md#heltec-v3) | -| Heltec T114 | 3.3v => 3.3v
GND => GND
**P0.8** => SDA
**P.07** => SCL

GND => SDO (BME280/680)| | -| RAK4631 | 3.3v => 3.3v
GND => GND
SDA => SDA
SCL => SCL

GND => SDO (BME280/680) | Both firmwares work | -| Xiao NRF52 | 3.3v => 3.3v
GND => GND
D7 => SDA
D6 => SCL

GND => SDO (BME280/680) | Both firmwares work | -| Xiao S3 | 3.3v => 3.3v
GND => GND
D4 => SDA
D5 => SCL

GND => SDO (BME280/680) | Both firmwares work | +| Heltec v3 / v4 / WSL3 | 3.3v => 3.3v
GND => GND
17 => SDA
18 => SCL | The GPIO17 and 18 are tiny pads at bottom board.
Check the [notes](https://github.com/IoTThinks/EasySkyMesh/blob/main/firmware/Add-sensors-to-repeaters.md#heltec-v3)

Not required for PowerSaving 13+
GND => SDO (BME280/680) | +| Heltec T114 | 3.3v => 3.3v
GND => GND
**P0.8** => SDA
**P.07** => SCL |
Not required for PowerSaving 13+
GND => SDO (BME280/680)| +| RAK4631 | 3.3v => 3.3v
GND => GND
SDA => SDA
SCL => SCL | Not required for PowerSaving 13+
| +| Xiao NRF52 | 3.3v => 3.3v
GND => GND
D7 => SDA
D6 => SCL | Not required for PowerSaving 13+
| +| Xiao S3 | 3.3v => 3.3v
GND => GND
D4 => SDA
D5 => SCL | Not required for PowerSaving 13+
| ## 2. Boards This section is for boards with some notes. @@ -34,7 +42,7 @@ This is the list of sensors currently supported by official MeshCore firmware. ### 3.1 GPS This is for GPS sensor. - For RAK boards: PIN_GPS_TX => 15 and PIN_GPS_RX => 16 -- [To be updated] For other boards: PIN_GPS_TX => XX and PIN_GPS_RX => YY. This depends on boards. +- For other boards: Enter CLI "sensor" to see the TX and RX GPIOs. ### 3.2 AHTX0 This is AHT10 and AHT20 Humidity and Temperature Sensor. @@ -42,18 +50,13 @@ This is AHT10 and AHT20 Humidity and Temperature Sensor. ### 3.3 BME680 The BME680 is a compact environmental sensor by Bosch that measures temperature, humidity, barometric pressure, and air quality (gas/VOC). -* Note: As of 20 Dec 2025, MeshCore app can not show the Gas telemetry properly in Channel 1 or 2. * I2C address: **0x76** -* For Adafruit BME280, you need to solder the Addr pad to use I2C address 0x76. -* For other BME280 boards, you are strongly recommended to wire **GND to SDO** to force to use address 0x76. Else, the I2C address may jump either 0x76 and 0x77. image image image ### 3.4 BME280 The BME280 is a compact environmental sensor by Bosch that measures temperature, humidity, and barometric pressure. * I2C address: **0x76** -* For Adafruit BME280, you need to solder the Addr pad to use I2C address 0x76 -* For other BME280 boards, you are strongly recommended to wire **GND to SDO** to force to use address 0x76. Else, the I2C address may jump either 0x76 and 0x77. image image image