dandri/EasySkyMesh
1
0
Fork 0
mirror of https://github.com/IoTThinks/EasySkyMesh.git synced 2026-08-29 07:08:18 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Revise wiring instructions and sensor address notes

Browse Source 
Updated wiring instructions for various boards and added notes for PowerSaving 13+. Clarified sensor address selection for BME280/680/BMP280.
This commit is contained in:
IoTThinks
2026-03-14 10:05:01 +07:00
committed by GitHub
parent 9367f30c54
commit 3d09c66abd
1 changed files with 15 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
firmware/Add-sensors-to-repeaters.md
+15 -12
View File
@@ -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.
<img height="512" alt="image" src="https://github.com/user-attachments/assets/060dd847-5984-4dc2-a5fe-cfe81180dc6c" />
<img height="512" alt="image" src="https://github.com/user-attachments/assets/49f25de7-a122-480f-a54a-a7176ec25f26" />
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 <br> GND => GND <br> 17 => SDA <br> 18 => SCL <br><br> GND => SDO (BME280/680) | On Heltec v3, the GPIO17 and 18 are tiny pads in the middle of the board bottom. <br> Check the [notes](https://github.com/IoTThinks/EasySkyMesh/blob/main/firmware/Add-sensors-to-repeaters.md#heltec-v3) |
| Heltec T114 | 3.3v => 3.3v <br> GND => GND <br> **P0.8** => SDA <br> **P.07** => SCL <br><br> GND => SDO (BME280/680)| |
| RAK4631 | 3.3v => 3.3v <br> GND => GND <br> SDA => SDA <br> SCL => SCL <br><br> GND => SDO (BME280/680) | Both firmwares work |
| Xiao NRF52 | 3.3v => 3.3v <br> GND => GND <br> D7 => SDA <br> D6 => SCL <br><br> GND => SDO (BME280/680) | Both firmwares work |
| Xiao S3 | 3.3v => 3.3v <br> GND => GND <br> D4 => SDA <br> D5 => SCL <br><br> GND => SDO (BME280/680) | Both firmwares work |
| Heltec v3 / v4 / WSL3 | 3.3v => 3.3v <br> GND => GND <br> 17 => SDA <br> 18 => SCL | The GPIO17 and 18 are tiny pads at bottom board. <br> Check the [notes](https://github.com/IoTThinks/EasySkyMesh/blob/main/firmware/Add-sensors-to-repeaters.md#heltec-v3) <br> <br> Not required for PowerSaving 13+ <br> GND => SDO (BME280/680) |
| Heltec T114 | 3.3v => 3.3v <br> GND => GND <br> **P0.8** => SDA <br> **P.07** => SCL | <br> Not required for PowerSaving 13+ <br> GND => SDO (BME280/680)|
| RAK4631 | 3.3v => 3.3v <br> GND => GND <br> SDA => SDA <br> SCL => SCL | Not required for PowerSaving 13+ <br> |
| Xiao NRF52 | 3.3v => 3.3v <br> GND => GND <br> D7 => SDA <br> D6 => SCL | Not required for PowerSaving 13+ <br> |
| Xiao S3 | 3.3v => 3.3v <br> GND => GND <br> D4 => SDA <br> D5 => SCL | Not required for PowerSaving 13+ <br> |
## 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.
<img height="384" alt="image" src="https://github.com/user-attachments/assets/3dbdafc2-af58-4304-b5b6-221cc1817ce3" /> <img height="192" alt="image" src="https://github.com/user-attachments/assets/84393dbe-8ac5-4824-9a39-0a390db8c115" /> <img height="192" alt="image" src="https://github.com/user-attachments/assets/01494234-047b-49ee-96a0-3877ed307bd9" />
### 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.
<img height="384" alt="image" src="https://github.com/user-attachments/assets/aef17a8b-994c-4090-84de-97d00e6d106c" /> <img height="192" alt="image" src="https://github.com/user-attachments/assets/488d290b-212e-4331-ac1a-e92bc1a964e5" /> <img height="192" alt="image" src="https://github.com/user-attachments/assets/d25c808f-5e58-4a0f-89ea-56e70fef6efb" />