PureAware Senzor Calitate Aer

1. Arhitectura Sistem

1.1 Diagrama Bloc

  ┌─────────────────────────────────────────────────────────────────┐
  │                     ESP32 (Dual-Core, 240 MHz)                 │
  │                                                                │
  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │
  │  │  Core 0  │  │  Core 1  │  │  WiFi    │  │  LittleFS    │  │
  │  │ AsyncTCP │  │ main()   │  │ 802.11n  │  │  Filesystem  │  │
  │  │ callbacks│  │ loop()   │  │  2.4 GHz │  │  OTA+Logs    │  │
  │  └──────────┘  └──────────┘  └──────────┘  └──────────────┘  │
  │                                                                │
  │  ┌──────────────────────┐    ┌──────────────────────────────┐  │
  │  │  NVS Preferences     │    │  RAM Buffers                 │  │
  │  │  "config" + "alarm"  │    │  Log: 288 entries (24h)      │  │
  │  │  namespaces          │    │  Pending emails: 6 slots     │  │
  │  └──────────────────────┘    └──────────────────────────────┘  │
  └───┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────────┘
      │      │      │      │      │      │      │      │
  ┌───▼──┐┌──▼──┐┌──▼──┐┌──▼──┐┌──▼──┐┌──▼──┐┌──▼──┐┌──▼────────┐
  │I2C-1 ││I2C-2││UART1││UART2││ 22  ││ 23  ││ 13  ││   12      │
  │SEN66 ││MS637││RS485││Nextn││CONFIG││ RUN ││NeoP ││Status LED │
  └──────┘└─────┘└─────┘└─────┘└─────┘└─────┘└─────┘└───────────┘

1.2 Model de Executie

1.3 Organizare Memorie

2. Specificatii Senzori

2.1 Sensirion SEN66

Interfata: Bus I2C 1 — SDA: GPIO 26, SCL: GPIO 25, 100 kHz

2.2 TE Connectivity MS5637

Setari OSR

Coeficienti de Calibrare PROM

3. Algoritm de Calcul TVOC

Echivalent TVOC derivat din Indicele VOC folosind Mølhave / WELL Building Standard:

tvocW = (ln(501 - vocIndex) - 6.24) * (-996.94)   [µg/m³]

// Implementare C:
static inline float tvoc_well_from_vi(float vi) {
  if (vi < 1.f) vi = 1.f;
  if (vi > 499.f) vi = 499.f;
  return (logf(501.f - vi) - 6.24f) * (-996.94f);
}

4. Referinta GPIO & Hardware

5. Butoane Fizice

Doua butoane amplasate pe spatele (partea de rezerva) carcasei modulului:

Detalii Mod AP

• SSID: PureAware_XXXXXX (XXXXXX = 6 caractere hex din MAC)
• Parola: 123456789
• IP: 192.168.1.25 (fix)
• Gateway: 192.168.1.25
• Subnet: 255.255.255.0
• Portal captiv DNS pe portul 53 (redirecteaza toate interogatile catre IP-ul dispozitivului)

// Gestionare butoane in checkSerialForCommands():
if (!digitalRead(BUT_Config) && (run_mode != 0)) {
  saveModeAndReboot(WIFI_MODE_AP_CMD);   // salveaza in NVS, apeleaza ESP.restart()
}
if (!digitalRead(BUT_Run) && (run_mode != 1)) {
  saveModeAndReboot(WIFI_MODE_STA_CMD);  // salveaza in NVS, apeleaza ESP.restart()
}

6. Detalii Protocol BACnet/IP

Proprietati Obiect Device

Obiecte AI (0–10)

Fiecare AI expune: Object_Identifier(75), Object_Name(77), Object_Type(79), Present_Value(85), Status_Flags(111), Event_State(36), Out_Of_Service(81), Units(117), Reliability(103), Description(28).

7. Detalii Modbus TCP Async

Detalii Registre de Intrare (FC 04)

8. Protocoale MQTT & Zabbix

MQTT (Async)

Zabbix Sender

9. Motor Email SMTP

10. Harta Preferinte NVS

Namespace: "config"

Namespace: "alarm"

11. Arhitectura Inregistrare Date

struct LogEntry {
  uint32_t ts;                          // Unix timestamp
  float temp, hum, press, co2;
  float pm1, pm25, pm4, pm10;
  float voc, nox, tvocw;
};
LogEntry logBuf[288];  // 288 × 5 min = 24 ore (circular)

12. Motor Alarme

struct AlarmCfg {
  uint8_t enabled, dir;   // dir: 1=peste, 0=sub
  String  param;          // "co2","pm25","voc","temp","hum","press"...
  float   trigger, hyst;  // prag + histerezis banda moarta
  uint8_t state;          // 0=OK, 1=Armat, 2=Declansat
};
AlarmCfg alarms[3];       // 3 alarme independente

// Masina de stari:
//   OK → Armat (valoarea intra in banda moarta)
//      → Declansat (pragul depasit, email trimis)
//      → Rearmat (valoarea revine sub histerezis, email trimis)
//      → OK

Emailuri in asteptare: 2 sloturi per alarma (declansare + rearmare). Trimise la reconectare WiFi cu intarziere de 5s.

13. Arhitectura Server Web

14. Mecanism Actualizare OTA

15. Numar de Serie & Identificare