# Oficina Hardware & Projetos Lab

## 🛡️ Sentinel Status
- **Status:** 🟢 Operacional / Em Expansão
- **Tier:** S
- **Health:** 98% / **ROI Potencial:** Bancada unificada de prototipagem rápida, diagramas de pinagem GPIO/Grove, esquemas elétricos e guias passo a passo
- **Stack:** HTML5, CSS3 (Cyber-Growth), Vanilla JS, JSON, ESP32, Raspberry Pi (Zero W / Pi 5), M5Stack (Cardputer ADV), Sonoff (MINIR4 / POWR316D), ESPHome, MQTT, C++ PlatformIO

---

Bancada e catálogo interativo de **projetos de hardware e sistemas embarcados** integrados ao ecossistema **MonitorSonoff** e **Home Assistant OS**. A aplicação lê dinamicamente `data/projects.json` e fornece esquemas elétricos, divisores de tensão, pinagens completas e código-fonte com cópia rápida para a área de transferência.

Espelha e expande o padrão arquitetural de [`haos-device/`](../haos-device/) e [`M5Stack/`](../M5Stack/).

## Como Abrir Localmente

```bash
npx --yes serve oficina
# ou:
python -m http.server 8767 --directory oficina
```

Abra a URL indicada no terminal (requisições `fetch` para `data/projects.json` exigem servidor HTTP local).

## Estrutura da Oficina

| Arquivo / Diretório | Função |
|---|---|
| `data/projects.json` | Fonte de dados canônica — plataformas de hardware, categorias, pinagens, BOM, passos e códigos |
| `index.html` + `css/` + `js/` | Masterpiece Dashboard com busca instantânea, filtros por MCU/categoria, visualizador de pinagem e persistência local |
| `benchmark2026.html` | Masterpiece Dashboard: Benchmark 2026 de SBCs x86/ARM, NPU de IA e microcontroladores com links Shopee/AliExpress/ML/Amazon |
| `projeto-cisterna-monitor.html` | Guia completo: Monitor de cisterna com JSN-SR04T, divisor de tensão 1k/2k, boia de segurança e relé |
| `projeto-sensor-am2301-si7021.html` | Guia completo: Sensor de Temperatura & Umidade AM2301 / Si7021 (Jack 2.5mm, RJ9, Sonoff TH16, ESP32) |
| `projeto-cyd-touch-display.html` | Guia completo: Terminal HMI touch ESP32 CYD 2.8" (ESP-Screen, LVGL, pinagem CN1/P3, MQTT) |
| `projeto-cardputer-field-terminal.html` | Guia completo: Terminal de campo M5Stack Cardputer ADV (LoRa, ESP-NOW, teclado físico, porta Grove) |
| `oficina-PiZeroW.html` | Guia completo: Nó MQTT móvel com armazenamento SQLite offline, 48 projetos para Pi Zero W e pinagem 40 pinos |
| `unit-audioplayer-N9301.html` | Guia técnico: Módulo Unit AudioPlayer N9301 (UART serial 9600 8N1, comandos HEX e pinagem Grove) |
| `assets/` | Imagens cinemáticas em alta resolução da bancada e diagramas de pinagem |
| `manifest.json` + `sw.js` | Configuração PWA para execução offline e atalho de aplicativo na tela inicial |

## Plataformas e Microcontroladores Cobertos

1. **Raspberry Pi Zero W / Zero 2 W / Pi 5**: Pinagem 40 pinos GPIO, barramento I²C, 1-Wire (DS18B20), UART (GPS), SPI e USB Gadget OTG.
2. **ESP32 CYD (ESP32-2432S028)**: Display TFT 2.8" 240×320, touch resistivo XPT2046, portas de expansão JST-1.25 CN1 (I²C/UART) e P3 (ADC/LDR).
3. **M5Stack Cardputer ADV**: Microcontrolador ESP32-S3, teclado matricial de 56 teclas, tela 1.14" IPS, porta Grove Port A, rádio LoRa 915MHz e protocolo ESP-NOW.
4. **Sonoff MINIR4 & POWR316D**: Módulos relé de embutir e medidores de potência 16A em trilho DIN para acionamento e proteção de motobombas.
5. **ESP32 DevKit NodeMCU**: Prototipagem geral de sensores ultrassônicos estanques, estações meteorológicas e acionamento de contatores.

## Categorias de Projetos

- 💧 **Cisterna & Gestão de Água:** Ultrassônico JSN-SR04T, boias de nível mínimo, automação de bomba e proteção contra cavitação.
- 🌡️ **Sensores & Telemetria:** BME280, SHT30/SHT40, DS18B20, anemômetros e pluviômetros.
- 🔊 **Áudio, Voz & Notificações:** Unit AudioPlayer N9301 (UART Hex), Shairport Sync, Raspotify e avisos sonoros de bancada.
- 🖥️ **HMI, Displays & Painéis:** CYD 2.8" Touch, painéis e-Ink Waveshare e telas OLED I2C.
- 🌐 **Rede, Gateway & Servidor:** Pi-hole DNS Adblock, roteador Tailscale, VPN WireGuard e broker MQTT Mosquitto.
- 📡 **Rádio, LoRa & Meshtastic:** Nós repetidores 915MHz SX1262, gateways BLE e telemetria peer-to-peer ESP-NOW.
- 🔌 **USB Gadget & HID:** Ethernet-over-USB, injeção de teclas de teclado e consoles seriais de campo.
- 🔋 **Campo & Datalogger Solar:** Dimensionamento de baterias 18650, controladores MPPT e nós autônomos.

## Como Atualizar o Catálogo

Edite o arquivo `data/projects.json` (schema `2.0`). Adicione novos projetos seguindo a estrutura com `id`, `title`, `category`, `mcu`, `hardware_bom`, `pinout` (com mapeamento de pinos e avisos de tensão) e `step_by_step`.

Documentação relacionada:
- [HAOS Device](../haos-device/README.md)
- [M5Stack Lab](../M5Stack/README.md)
- [Cardputer ADV](../cardputer-adv/README.md)
- [HA-OS-EWELINK](../docs/HA-OS-EWELINK.md)