Skip to content

Commit 0589e7e

Browse files
committed
docs: update pinouts and manuals for v1.4.4 universal slot + BME280
- WIRING.md: 16 universal slots (GPIO 0-15) replace fixed DS18B20/DHT22 assignments. Added BME280 I2C wiring diagram and slot configuration section with CLI examples. Updated all three pin reference tables to show configurable slots. Added GPIO requirement table per sensor type. Updated wiring checklists. - MANUAL.md: sensor count 11→16, SHT31→DHT22+BME280. Updated pinout table with configurable slots. Added Slot Configuration CLI section (create, type, pin, name, hwid, active). Added gpio/show sensor types. Version bump to v1.4.4-beta. - README.md: architecture diagram now shows DS18B20×16, DHT22×16, BME280×8. Version badge updated.
1 parent 5e33fca commit 0589e7e

3 files changed

Lines changed: 193 additions & 117 deletions

File tree

README.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
[![Platform: RP2040](https://img.shields.io/badge/Platform-RP2040-green.svg)](https://www.raspberrypi.com/products/raspberry-pi-pico/)
1111
[![Framework: Arduino](https://img.shields.io/badge/Framework-Arduino-teal.svg)](https://arduino-pico.readthedocs.io/)
1212
[![CI](https://github.com/angeloINTJ/simut/actions/workflows/build.yml/badge.svg)](https://github.com/angeloINTJ/simut/actions/workflows/build.yml)
13-
[![Version](https://img.shields.io/badge/Version-v1.0.0-blue.svg)](https://github.com/angeloINTJ/simut/releases)
13+
[![Version](https://img.shields.io/badge/Version-v1.4.4--beta-blue.svg)](https://github.com/angeloINTJ/simut/releases)
1414
[![Docs](https://img.shields.io/badge/Docs-GitHub_Pages-34D058.svg)](https://angelointj.github.io/simut/)
1515
[![Contributors](https://img.shields.io/badge/All_Contributors-4-orange.svg)](CONTRIBUTORS.md)
1616
[![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg)](CONTRIBUTING.md)
@@ -59,8 +59,9 @@ SIMUT is a professional-grade IoT firmware for the **Raspberry Pi Pico W** that
5959
│ ┌──────────┴──────────────────────────────────────────┐ │
6060
│ │ Hardware Interfaces │ │
6161
│ │ ◆ SPI → ILI9341 TFT 320×240 + XPT2046 Touch │ │
62-
│ │ ◆ 1-Wire (PIO) → DS18B20 ×10 │ │
63-
│ │ ◆ I2C → DHT22 Ambient │ │
62+
│ │ ◆ 1-Wire (PIO) → DS18B20 (up to 16) │ │
63+
│ │ ◆ Data → DHT22 (up to 16) │ │
64+
│ │ ◆ I2C → BME280 T+H+P (up to 8) │ │
6465
│ │ ◆ USB CDC → CLI Serial │ │
6566
│ │ ◆ Bluetooth (BLE) → CLI Remote │ │
6667
│ │ ◆ WiFi (CYW43439) → HTTP Server + Telemetry │ │

docs/MANUAL.md

Lines changed: 28 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ header-includes: |
3030
3131
---
3232

33-
**Firmware version:** v1.0.0
33+
**Firmware version:** v1.4.4-beta
3434
**Target hardware:** Raspberry Pi Pico W (RP2040 + CYW43439)
3535
**Repository:** https://github.com/angeloINTJ/SIMUT
3636
**License:** MIT
@@ -62,8 +62,10 @@ banks, vaccine freezers, water baths, microbiological incubators).
6262

6363
### 1.1 Key Capabilities
6464

65-
- **Up to 11 simultaneous sensors**: 1 SHT31 (ambient — T+RH) + 10
66-
DS18B20 (1-Wire, T)
65+
- **Up to 16 simultaneous sensors** on configurable slots: DS18B20 (1-Wire, T),
66+
DHT22 (Data, T+RH), BME280 (I2C, T+RH+Pressure)
67+
- **16 configurable GPIO slots** — each slot accepts any sensor type;
68+
configure via CLI before physical wiring (`gpio`, `sensor create`, `sensor pin`)
6769
- **320×240 TFT display** with resistive touch — operation without a PC
6870
- **Complete web interface** (dashboard, history, alarms, configuration)
6971
- **Binary history** (1 point/min, compact format, ~1 year of data in
@@ -110,24 +112,17 @@ out of range:
110112
| MCU | Raspberry Pi Pico W (RP2040 + CYW43439) | Processing + WiFi/BT |
111113
| Display | TFT 320×240 ILI9341 SPI | Main UI |
112114
| Touch | XPT2046 SPI | Display interaction |
113-
| T+RH Sensors | SHT31 I2C | Ambient |
114-
| T Sensor | DS18B20 1-Wire | Individual points (up to 10) |
115+
| T Sensor | DS18B20 1-Wire | Individual points (up to 16) |
116+
| T+RH Sensor | DHT22 Data | Ambient / individual points (up to 16) |
117+
| T+RH+Pressure Sensor | BME280 I2C | Environmental (up to 8, 2 GPIOs each) |
115118
| Buzzer | PIO active buzzer | Audible alarms |
116119
| Storage | LittleFS on internal flash (1.5 MB usable) | Config + history |
117120

118121
### 2.2 Pinout (Pico W)
119122

120123
| GPIO | Function |
121124
|---|---|
122-
| 0 | Reserved (UART0 TX) |
123-
| 1 | Reserved (UART0 RX) |
124-
| 4 | DS18B20 Sensor #1 (1-Wire) |
125-
| 5 | DS18B20 Sensor #2 (1-Wire) |
126-
| 6 | I2C SDA (SHT31) |
127-
| 7 | I2C SCL (SHT31) |
128-
| 8 | UART1 TX (debug — see §11) |
129-
| 9 | UART1 RX |
130-
| 10..15 | DS18B20 #3..#8 (1-Wire) |
125+
| 0–15 | **SLOT 0–15** — configurable via CLI. Any sensor type: DS18B20 (1-Wire), DHT22 (Data), or BME280 (I2C SDA+SCL). Assign with `sensor create` + `sensor pin`. |
131126
| 16 | TFT MISO |
132127
| 17 | TFT CS |
133128
| 18 | TFT SCK |
@@ -511,17 +506,31 @@ show storage stats FS used/total
511506
show net status IP, RSSI, NTP
512507
show themes List themes
513508
show metrics Heap, uptime, telemetry, sensors, storage
514-
show sensors List mapped sensors
509+
show sensors List configured slots with type, channels, alarms
510+
show sensor types List compiled-in sensor drivers (DS18B20, DHT22, BME280)
511+
gpio GPIO resource map (16 pins, free/used by slot)
512+
show gpio Same as above
515513
```
516514

517515
#### Sensor Diagnostics
518516

519517
```
520-
sensor scan Scan 1-Wire for new sensors
518+
sensor scan Scan for new sensors (1-Wire + I2C)
521519
sensor accept <gpio> Authorize newly detected sensor
522520
sensor wipe <gpio> [confirm] Wipe slot history
523521
```
524522

523+
#### Slot Configuration (GPIO Resource Management)
524+
525+
```
526+
sensor <n> create <type> Create slot — sets type, shows pin requirements
527+
sensor <n> type <type> Change sensor driver (ds18b20|dht22|bme280)
528+
sensor <n> pin <idx>,<gpio> Assign GPIO to pin (with conflict detection)
529+
sensor <n> name "<name>" Set friendly name (max 31 chars)
530+
sensor <n> hwid <id> Set hardware ID (max 15 chars)
531+
sensor <n> active <on|off> Enable/disable slot (validates prerequisites)
532+
```
533+
525534
#### System Configuration
526535

527536
```
@@ -551,11 +560,13 @@ tel sync Force upload now
551560
tel dump Capture next payload on console
552561
```
553562

554-
#### Sensor Mapping
563+
#### Sensor Mapping (Legacy)
555564

556565
```
557566
sensor define <gpio> <rom> <hwid> "<name>"
558567
Ex: sensor define 4 28AABB.. STM0001 "Vaccine_Fridge"
568+
569+
Prefer the slot-based commands above for new deployments.
559570
```
560571

561572
#### Static IP Configuration

0 commit comments

Comments
 (0)