Pular para o conteúdo principal

Câmara climática simulada (camara-sim)

O camara-sim simula uma câmara climática com ESP32: DHT22, OLED, potenciômetro (ADC), aquecedor e ventilador por PWM. Ele é isolado: não traz broker, Node-RED nem MQTT Explorer. Ele se conecta ao que já existe — o LAB IoT, o kit do grupo (gen_iot_scada_portal.py) ou qualquer broker MQTT.

A mesma planta é exposta, ao mesmo tempo, por cinco interfaces. Um comando enviado por qualquer uma delas (o setpoint, por exemplo) aparece em todas as outras.

InterfacePortaBiblioteca Python
MQTT 5 (cliente, como o ESP32 real)broker:1883paho-mqtt
Modbus TCP502pymodbus
Modbus RTU sobre TCP (quadro RTU + CRC, sem porta serial)5021pymodbus
Siemens S7 (ISO-on-TCP)102python-snap7
OPC-UA4840asyncua
Versões

O requirements.txt do simulador fixa as versões das bibliotecas de propósito: a API do pymodbus muda bastante entre versões. Instale sempre por ele.

Compatibilidade com o LAB IoT​

Convenção do LAB IoT (gen_iot_scada_portal.py)No simulador
Tópicos do grupo <grupo>/... (a ponte do kit só repassa <grupo>/#)<grupo>/camara/telemetria, /cmd, /cmd/<campo>, /status, /oled
Serviços na rede labnet, nomes <grupo>-nodered, <grupo>-fuxahost <grupo>-camara (ex.: lab05-a-camara)
Broker mosquitto:1883, anônimoMQTT_HOST=mosquitto ao entrar na rede do lab ou do kit
Node-RED em /<grupo>/ (httpNodeRoot)dashboard em /<grupo>/dashboard/camara
Volume /data do grupoSQLite em /data/camara.sqlite
ntfy: NTFY_URL, NTFY_TOPIC, NTFY_TOKEN no Node-REDos alarmes da câmara viram notificação no celular
Nós do Dockerfile do lab (modbus, s7, opcua, sqlite, dashboard 2)os fluxos usam só esses (nada de serial nem ui-led)

O endereço OPC-UA se adapta ao cliente: o servidor devolve o mesmo host que o cliente usou (localhost, o IP do PC ou lab05-a-camara). UaExpert, Node-RED e FUXA conectam sem configurar nada.

Tópicos da disciplina

Nos laboratórios, o tópico base segue o padrão da disciplina, e não <grupo>/camara. Ajuste MQTT_BASE no .env (ou --mqtt-base no Python), por exemplo MQTT_BASE=elt85b/lab08/grupo-a/camara.

1. Rodar​

Escolha uma das três formas. Os comandos são para o Prompt de Comando (cmd) do VS Code, dentro da pasta camara-sim.

Terminal (cmd), na pasta camara-sim
py -m pip install -r requirements.txt
py camara_sim.py --grupo lab05-a

Sem outras opções, o simulador usa o broker em localhost:1883 (o kit no próprio PC). Outras situações:

SituaçãoComando
Broker do laboratóriopy camara_sim.py --grupo lab05-a --mqtt-host 192.168.0.10
Sem MQTT (só Modbus, S7 e OPC-UA)py camara_sim.py --grupo lab05-a --sem-mqtt
Dinâmica 5× mais rápidapy camara_sim.py --grupo lab05-a --speed 5
Todas as opçõespy camara_sim.py --help
Linux e macOS

As portas 102 e 502 exigem administrador. Use outras, por exemplo --s7-port 1102 --modbus-tcp-port 5020.

Uma câmara por grupo no servidor do laboratório (professor)​

Terminal, na pasta camara-sim
py gerar_compose_lab.py --lab lab05 --grupos 10
docker compose -f docker-compose.camaras.yml up -d --build

Use os mesmos --lab e --grupos do portal. Isso cria lab05-a-camara … lab05-j-camara na rede lab05_labnet, sem abrir portas no servidor.

Testar​

Terminal (cmd), na pasta camara-sim
py testar_clientes.py --grupo lab05-a

O teste escreve o setpoint por um protocolo e confere a leitura por todos os outros.

2. Node-RED do grupo​

Terminal (cmd), na pasta camara-sim
py gerar_flows.py --grupo lab05-a

O comando gera flows/camara-lab05-a.json. No Node-RED do grupo: Menu ☰ → Import → selecione o arquivo → Import → Deploy. O arquivo cria quatro abas:

AbaO que faz
Câmara - Dashboard/<grupo>/dashboard/camara: medidores, gráficos, LEDs, réplica do OLED, comandos e simulação
Câmara - Banco SQLite/data/camara.sqlite, uma amostra a cada 10 s, consultas prontas e histórico no dashboard
Câmara - Controle Node-REDcontrolador externo (ON/OFF + ventilador P) e alarmes → ntfy do grupo
Câmara - Modbus / S7 / OPC-UAlê a câmara por cada protocolo e republica em <grupo>/camara/via/<protocolo>
Já existe um Dashboard 2.0 no Node-RED do grupo?

O Dashboard 2.0 aceita um só ui-base. Ao importar, aponte a página "Câmara Climática" para o ui-base que já existe e apague o importado.

3. FUXA do grupo​

No FUXA 1.3.x, os drivers Modbus, OPC-UA e S7 são plugins: instale-os em Editor > Configurações > Plugins (modbus-serial, node-opcua, node-snap7). Eles ficam em server/_pkg, que precisa de um volume para sobreviver à recriação do contêiner. O guia foi testado com o FUXA 1.3.4.

Conexão no FUXAConfiguração
MQTT clientmqtt://mosquitto:1883. Tag do tipo json: tópico lab05-a/camara/telemetria, chave temp (ou outra)
Modbus TCPendereço lab05-a-camara:502, slave 1. Os endereços do FUXA são base 1: IR0 = Input Register 1, HR3 = Holding 4. Temperatura ×10: Int16 com divisor 10; em float: Float32 no endereço 13
Siemens S7IP do contêiner (o snap7 não resolve nomes: docker exec <fuxa> getent hosts lab05-a-camara), rack 0, slot 1. Sintaxe Step 7: DB1.DBD20 (REAL), DB1.DBW2 (INT), DB1.DBX0.0 (BOOL), DB1.DBD48 (DINT)
OPC-UAopc.tcp://lab05-a-camara:4840/, segurança None, anônimo. Endereço da tag = NodeId (ns=2;s=Camara.temp), tipo igual ao do nó (Double, Int32, Boolean)

4. A câmara​

Objetivos de projeto atendidos​

ObjetivoImplementação
Medir temperatura e umidadeDHT22: leitura a cada 2 s, ruído de ±0,1 °C e ±0,5 %UR, 1 % de erros de leitura
Setpoint configurávelsetpoint remoto (20–55 °C) ou pelo potenciômetro (fonte_sp = 1)
Aquecedor e ventilador por PWM0–100 % e duty LEDC de 8 bits (0–255)
Tela OLED6 linhas × 21 caracteres (SSD1306 128×64)
PotenciômetroADC de 12 bits (0–4095)
Estratégia de controleMANUAL (controle externo), ON/OFF com histerese e PI com anti-windup
Estado da plantaDESLIGADO, AQUECENDO, RESFRIANDO, ESTÁVEL e ALARME; LEDs verde, amarelo e vermelho

Pinagem sugerida para a câmara real​

ComponenteESP32
DHT22GPIO4 (pull-up de 10 kΩ)
Potenciômetro de 10 kΩGPIO34 (ADC1_CH6)
Aquecedor (~25 W)GPIO25 → MOSFET, LEDC de 8 bits
Ventilador de 12 VGPIO26 → MOSFET, LEDC de 8 bits, 25 kHz
OLED SSD1306SDA GPIO21 / SCL GPIO22 (0x3C)
LEDs verde, amarelo e vermelhoGPIO16, GPIO17 e GPIO5

Modelo e firmware​

  • Térmico: dois estados (resistência e câmara) e perdas para o ambiente (25 °C). O ventilador aumenta a troca de calor.
  • Umidade: umidade absoluta mais uma carga úmida interna. A UR sai pela fórmula de Magnus, por isso aquecer derruba a UR.
  • Tempo: em tempo real, a câmara vai de 25 °C a 35 °C em cerca de 1,5 min. SIM_SPEED=5 (ou 10) acelera.
  • Modos:
    • 0 MANUAL: usa aquecedor_cmd e ventilador_cmd;
    • 1 ON/OFF: histerese de ±0,5 °C; o ventilador vai a 100 % se T > SP + 2;
    • 2 PI: Kp = 15 e Ki = 0,15, com anti-windup.
  • Proteções: com T ≥ 60 °C ou falha do DHT22, o estado vai para ALARME: aquecedor a 0 % e ventilador a 100 %. O alarme é liberado com T < 55 °C e o sensor OK.
estadoNomeCondição (e = SP − T)
0DESLIGADOhabilitado = 0
1AQUECENDOe > 1
2RESFRIANDOe < −1
3ESTAVEL|e| ≤ 1
4ALARMEproteção ativa

Bits de alarme: 1 = sobretemperatura, 2 = sensor.

5. Mapa de variáveis​

Base: <grupo>/camara (ou o MQTT_BASE).

TópicoSentidoConteúdo
…/statusESP32 →online/offline (retido, Last Will)
…/telemetriaESP32 →JSON a cada 2 s
…/oledESP32 →texto da tela
…/cmd→ ESP32JSON parcial, ex.: {"setpoint": 40, "modo": 2}
…/cmd/<campo>→ ESP32valor simples

Campos de comando: habilitado, modo, fonte_sp, setpoint, aquecedor_cmd, ventilador_cmd, pot_raw (simulação) e falha_dht (simulação). Valores fora da faixa são saturados.

6. Atividades sugeridas​

  1. Comparar ON/OFF, PI e o controlador do Node-RED pela consulta "Erro médio |SP − T| por modo" no SQLite.
  2. Escrever o próprio controlador na aba Controle Node-RED (P, PI, PID, fuzzy).
  3. Observar o acoplamento térmico e de umidade: ventilar e aquecer, e ver o que acontece com a UR.
  4. Provocar o alarme (MANUAL, aquecedor a 100 %, ventilador a 0 %) e receber o aviso no celular pelo ntfy.
  5. Ler a mesma variável por MQTT, Modbus, S7 e OPC-UA e comparar formatos (int × 10, float32, REAL) e latência.
  6. Parar o simulador (docker compose stop) e ver o Last Will offline no dashboard.

Arquivos​

📂 camara-sim/
  • ├── 📄camara_model.py👈 Verificar
  • ├── 📄camara_sim.py👈 Verificar
  • ├── 📄proto_mqtt.py👈 Verificar
  • ├── 📄proto_modbus.py👈 Verificar
  • ├── 📄proto_s7.py👈 Verificar
  • ├── 📄proto_opcua.py👈 Verificar
  • ├── 📄testar_clientes.py👈 Verificar
  • ├── 📄gerar_flows.py👈 Verificar
  • ├── 📄gerar_compose_lab.py👈 Verificar
  • ├── 🚀docker-compose.yml👈 Verificar
  • ├── 🚀docker-compose.lab.yml👈 Verificar
  • ├── 📄.env.example👈 Verificar
  • └── 📂wokwi
    • └── 📂camara_esp32
      • └── 📄camara_esp32.ino👈 Verificar
git conferir camara_model.py camara_sim.py proto_mqtt.py proto_modbus.py proto_s7.py proto_opcua.py testar_clientes.py gerar_flows.py gerar_compose_lab.py docker-compose.yml docker-compose.lab.yml .env.example wokwi/camara_esp32/camara_esp32.ino
ArquivoFunção
camara_model.pyplanta, DHT22, ADC, PWM, controle, estados e OLED
camara_sim.pyprograma principal (opções por argumento ou variável de ambiente)
proto_mqtt.py, proto_modbus.py, proto_s7.py, proto_opcua.pyum adaptador por protocolo
testar_clientes.pyteste de ponta a ponta em todos os protocolos
gerar_flows.pyfluxos do Node-RED para um grupo
gerar_compose_lab.pyuma câmara por grupo no servidor do laboratório
docker-compose.yml, docker-compose.lab.yml, .env.exampleDocker sozinho / na rede do lab ou do kit
wokwi/camara_esp32/firmware ESP32 + circuito Wokwi com o mesmo contrato MQTT e a planta virtual (veja o README da pasta)