Senzor de Calitate a Aerului PureAware

1. API HTTP Status (Port 80)

Public, nu necesita autentificare.

Format Raspuns JSON

{
  "co2":    845,
  "pm1":    3.2,
  "pm25":   5.8,
  "pm4":    7.1,
  "pm10":   8.4,
  "voc":    127,
  "nox":    15,
  "tvocw":  342,
  "temp":   23.5,
  "hum":    55.2,
  "press":  1013.2,
  "rssi":   -52,
  "uptime": 86400,
  "fw":     "PureAware_V1.027",
  "hw":     "AQS-PureAware-R1.2",
  "build":  "2026-03-14",
  "model":  "PureAQS66",
  "sn":     "AQS2608-8A0DE8",
  "host":   "pureaware-8a0de8",
  "mac":    "AA:BB:CC:DD:EE:FF",
  "ip":     "192.168.1.100",
  "lang":   "en",
  "wifi_mode": 1,
  "wifi_ok":   true,
  "mqtt_ok":   false,
  "email_en":  false,
  "email_cfg_ok": false,
  "sleep_en":     0,
  "sleep_active": false,
  "aq_level": 0,
  "alarms": [
    {"param":"co2","trigger":1000,"hyst":50,"state":0,"en":1,"val":845},
    {"param":"","trigger":0,"hyst":0,"state":0,"en":0,"val":0},
    {"param":"","trigger":0,"hyst":0,"state":0,"en":0,"val":0}
  ]
}

Referinta Campuri

Exemplu: cURL

# Obtinere citiri curente
curl http://192.168.1.100/data.json

# Obtinere date log
curl http://192.168.1.100/log

Exemplu: Python

import requests
import json

resp = requests.get("http://192.168.1.100/data.json")
data = resp.json()

print(f"CO2:         {data['co2']} ppm")
print(f"PM2.5:       {data['pm25']} ug/m3")
print(f"Temperature: {data['temp']} C")
print(f"Humidity:    {data['hum']} %RH")
print(f"VOC Index:   {data['voc']}")
print(f"Pressure:    {data['press']} hPa")

Exemplu: JavaScript

async function getSensorData() {
  const resp = await fetch('http://192.168.1.100/data.json');
  const data = await resp.json();

  document.getElementById('co2').textContent = data.co2 + ' ppm';
  document.getElementById('pm25').textContent = data.pm25 + ' ug/m3';
  document.getElementById('temp').textContent = data.temp + ' C';
}

// Interogare la fiecare 30 secunde
setInterval(getSensorData, 30000);
getSensorData();

2. API HTTP Configurare (Port 8080)

Autentificare: HTTP Basic Auth — admin / pureaware

Parametri de Configurare

WiFi si Retea

MQTT

Zabbix

BACnet/IP

Email / SMTP

Alarme (N = 0, 1, 2)

Repaus WiFi

Afisaj si Limba

Exemplu: Actualizare Setari MQTT

# Activare MQTT si setare broker
curl -u admin:pureaware -X POST \
  http://192.168.1.100:8080/setting \
  -d "mqtt_en=on&mserver=mqtt.local&mport=1883&mtopic=sensors/aq1&minterval=60"

Exemplu: Export / Import Configuratie

# Export configuratie
curl -u admin:pureaware http://192.168.1.100:8080/config/export -o config-backup.json

# Import configuratie
curl -u admin:pureaware -X POST \
  http://192.168.1.100:8080/config/import \
  -H "Content-Type: application/data.json" \
  -d @config-backup.json

Exemplu: Setare Alarma

# Alarma 0: CO2 peste 1000 ppm cu histerezis de 50 ppm
curl -u admin:pureaware -X POST \
  http://192.168.1.100:8080/setting \
  -d "a0_en=1&a0_param=co2&a0_trigger=1000&a0_hyst=50&a0_dir=1"

3. API HTTP OTA (Port 8081)

Exemplu: Incarcare Firmware

curl -X POST http://192.168.1.100:8081/update \
  -F "firmware=@PureAware_SEN66_V1.027.bin"

# Python
import requests
with open('PureAware_SEN66_V1.027.bin', 'rb') as f:
    requests.post('http://192.168.1.100:8081/update',
                  files={'firmware': f})

4. API HTTP Nextion (Port 8082)

curl -X POST http://192.168.1.100:8082/upload \
  -F "file=@pureaware_v3.tft"

5. Protocol BACnet/IP (UDP 47808)

5.1 Transport

5.2 Servicii Suportate

5.3 Harta Obiectelor

5.4 ID-uri Proprietati

6. Harta Registrelor Modbus TCP (TCP 502)

6.1 Conexiune

6.2 Coduri de Functie Suportate

6.3 Registre de Intrare (FC 04) — Date Senzor

6.4 Coils (FC 01/05/0F)

16 coils la adresa de baza 0. Disponibile pentru controlul iesirilor digitale personalizate.

6.5 Intrari Discrete (FC 02)

16 intrari discrete la adresa de baza 0. Disponibile pentru starea intrarilor digitale personalizate.

6.6 Registre Holding (FC 03/06/10)

16 registre holding la adresa de baza 0. Disponibile pentru parametri R/W personalizati.

7. Format Mesaje MQTT

7.1 Structura Topic-urilor

Dispozitivul publica pe un topic unic per dispozitiv:

{mtopic}/{mac6}/data

Unde {mtopic} este topic-ul de baza configurat si {mac6} sunt ultimele 6 cifre hexazecimale ale adresei MAC ESP32.

Exemplu: PureAware_Office/8a0de8/data

7.2 Parametri de Publicare

7.3 Payload JSON

7.4 Exemplu Payload

{
  "device_type": "SEN66",
  "name":   "Office Sensor",
  "co2":    "845",
  "pm1":    "3",
  "pm25":   "5",
  "pm4":    "7",
  "pm10":   "8",
  "voc":    "127",
  "nox":    "15",
  "tvocw":  "342",
  "temp":   "23.5",
  "hum":    "55.2",
  "press":  "1013.2",
  "rssi":   "-52"
}

7.5 Exemple de Abonare

# Abonare la un dispozitiv specific
mosquitto_sub -h broker.emqx.io -t "PureAware_Office/8a0de8/data" -v

# Abonare la toate dispozitivele de pe acelasi topic de baza
mosquitto_sub -h broker.emqx.io -t "PureAware_Office/#" -v

8. Protocol Zabbix Sender

8.1 Format Mesaj

Protocol standard Zabbix Sender JSON prin TCP:

{
  "request": "sender data",
  "data": [
    {"host": "PureAware_Office", "key": "device_type", "value": "PureAQS66"},
    {"host": "PureAware_Office", "key": "co2",   "value": "845"},
    {"host": "PureAware_Office", "key": "pm1",   "value": "3"},
    {"host": "PureAware_Office", "key": "pm25",  "value": "5"},
    {"host": "PureAware_Office", "key": "pm4",   "value": "7"},
    {"host": "PureAware_Office", "key": "pm10",  "value": "8"},
    {"host": "PureAware_Office", "key": "voc",   "value": "127"},
    {"host": "PureAware_Office", "key": "nox",   "value": "15"},
    {"host": "PureAware_Office", "key": "tvocw", "value": "342"},
    {"host": "PureAware_Office", "key": "temp",  "value": "23.5"},
    {"host": "PureAware_Office", "key": "hum",   "value": "55.2"},
    {"host": "PureAware_Office", "key": "press", "value": "1013.2"},
    {"host": "PureAware_Office", "key": "rssi",  "value": "-52"}
  ]
}

8.2 Chei Element Zabbix

9. Comenzi Serial UART

9.1 Interfata Serial2

9.2 Comenzi de Schimbare Mod

Firmware-ul mentine un buffer cu fereastra glisanta de 6 octeti (window6[6]). Cand fereastra se potriveste cu unul dintre modelele de comanda, dispozitivul schimba modul si reporneste.

9.3 Interfata Serial1 (RS-485)