Skip to content

docs(integracoes): status real do CX9240 e separador; variaveis MQTT … #49

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MatheusNespolo merged 1 commit into from
Oct 7, 2026
Merged

docs(integracoes): status real do CX9240 e separador; variaveis MQTT … #49

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/ARCHITECTURE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,7 @@ As imagens abaixo são anteriores à v3.0 e não mostram os marcos; vale o diagr

### 6.1 Beckhoff CX9240 (Historiador Local MQTT → SQLite)

**Status:** ✅ **CONCLUÍDO E VALIDADO (15/09/2026)**
**Status:** 🟡 **PARCIALMENTE VALIDADO** — persistência e DB comissionados (15/09/2026); fluxo completo Arduino/ESP32 → HiveMQ Cloud → Node.js → CX9240 homologado em 19/09/2026. Pendências: E2E automatizado (card #27) e confirmação do contrato `dataflow/eventos` com o firmware real (ver `docs/INTEGRATION_GUIDE.md` §1.5).

- **Hardware/OS:** Beckhoff CX9240 rodando TwinCAT 3 em RT Linux ARM64.
- **Banco de Dados:** SQLite local (`/var/lib/dfi/historian.db`) em modo WAL, operado via TF6420 Database Server (SQL Expert Mode).
Expand All @@ -236,14 +236,14 @@ As imagens abaixo são anteriores à v3.0 e não mostram os marcos; vale o diagr
|---|---|---|
| `MQTT_PUBLISH` | `false` | habilita a publicação do estoque |
| `MQTT_BROKER_URL` / `MQTT_PORT` | `mqtt://127.0.0.1` / `1883` | broker |
| `MQTT_USER` / `MQTT_PASS` | — | credenciais, se houver |
| `MQTT_USER` / `MQTT_PASS` | — | credenciais, se houver (o servidor `server/` usa `MQTT_USERNAME` / `MQTT_PASSWORD`) |
| `MQTT_TOPIC_ESTOQUE` | `dataflow/estoque` | tópico de publicação |

Passo a passo do lado Beckhoff (DDL SQL, TwinCAT 3): `docs/INTEGRATION_GUIDE.md`.

### 6.2 Separador — Roda de Separação

**Status:** Código comentado; integração em Sprint 5–6
**Status:** ⬜ **PENDENTE** — não há código ativo na v3.0 do firmware Uno. O trecho antigo (`Stepper.h`, `moverSeparador`) existe só no histórico do git (firmware v2.x). A integração depende da mecânica (Semana 8, Bloco 4).

**Hardware:** Motor 28BYJ-48 + ULN2003 (pinos 5-8)
**Integração:** Nova etapa FSM após ENTREGANDO_PECA
Expand Down
5 changes: 4 additions & 1 deletion docs/INTEGRATION_GUIDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Guia de Integração — Beckhoff CX9240 (Historiador SQLite) + Separador (Roda de Separação)

> **Passo a passo para integração final com PC industrial e roda de separação**
> ⚠️ **Status:** a §1 (CX9240) está parcialmente validada. A §2 (separador) é **pendente**: o código da §2.3 é da v2.x e não existe na v3.0 do firmware Uno.
> Data: 14/09/2026 · Sprint 5

---
Expand Down Expand Up @@ -111,7 +112,9 @@ CREATE TABLE IF NOT EXISTS eventos_log (
sqlite3 /var/lib/dfi/historian.db "SELECT * FROM eventos_hist ORDER BY id DESC LIMIT 10;"
```

### 1.5 Checklist CX9240 — ✅ CONCLUÍDO (15/09/2026)
### 1.5 Checklist CX9240 — 🟡 PARCIALMENTE VALIDADO (15/09/2026; homologado em 19/09/2026)

> Pendências: o contrato `dataflow/eventos` (usado por `eventos_hist`) ainda não foi confirmado com o firmware real, porque o simulador publica só `dataflow/estoque`. O card #27 (E2E) só pode ser marcado como concluído após uma execução verde no GitHub Actions da `main`.

- [x] Contrato MQTT e payload definidos (`dataflow/estoque` e `dataflow/eventos`)
- [x] Publicação MQTT validada no simulador (`MQTT_PUBLISH=true`)
Expand Down
Loading