diff --git a/growbox/README.md b/growbox/README.md index 1d53829..3db8ad6 100644 --- a/growbox/README.md +++ b/growbox/README.md @@ -26,47 +26,63 @@ Laravel (`DemoGrowboxSeeder` использует `sensor-1`/`fan-1`), а `zone_ ## Железо -| Назначение | Пин (по умолчанию) | -|-----------------|---------------------| -| DHT22 data | GPIO4 | -| Реле — light-1 | GPIO16 | -| Реле — pump-1 | GPIO17 | -| Реле — fan-1 | GPIO18 | +По фото реального комплекта: 30-контактная ESP32 DevKit, готовый модуль +DHT22 с распаянными проводами и **один 2-канальный** релейный модуль +(SRD-05VDC-SL-C×2, общий разъём `GND IN1 IN2 VCC`) — закрывает sensor-1, +light-1, pump-1. Для fan-1 нужен ещё один канал реле (третий модуль или +4-канальная плата) — в прошивке/config.h он уже заложен на GPIO18, физически +пока не подключён. -Реле-модули по умолчанию считаются активными по LOW (`RELAY_ACTIVE_LOW` в -`config.h`) — типично для дешёвых китайских модулей на оптопаре. Если ваши -реле активны по HIGH — поменяйте флаг. +| Назначение | Пин (по умолчанию) | Примечание | +|---------------------|---------------------|------------| +| DHT22 DATA | GPIO4 | провод жёлтый на нашем модуле | +| Реле IN1 — light-1 | GPIO16 | **на шёлкографии платы подписан `RX2`**, не «16» | +| Реле IN2 — pump-1 | GPIO17 | **на шёлкографии платы подписан `TX2`**, не «17» | +| Реле IN — fan-1 | GPIO18 | нужен третий канал реле, пока не подключено | -DHT22 требует подтягивающий резистор ~10кОм между data и VCC, если он не -встроен в конкретный модуль. +На этой конкретной 30-пиновой плате GPIO16/17 не подписаны номерами — они +выведены как пины UART2 и промаркированы `RX2`/`TX2`. Физически это те же +GPIO, `config.h`/прошивку менять не нужно, важно только не перепутать их при +пайке/монтаже на плате. + +Реле-модуль (2-канальный, SRD-05VDC-SL-C) активен по LOW — +`RELAY_ACTIVE_LOW` в `config.h` уже стоит в `true`. Перемычка `JD-VCC` на +модуле по умолчанию установлена (питание катушек реле — от той же VCC, без +гальванической развязки) — для этого проекта этого достаточно, снимать её +незачем. + +DHT22 требует подтягивающий резистор ~10кОм между DATA и VCC — на нашем +модуле, похоже, уже встроен (компактная плата-переходник с 3 проводами), но +если показания не читаются — проверьте отдельным резистором. ### Схема подключения ``` - ESP32 DevKitC + ESP32 (30 pin) ┌───────────────────────┐ DHT22 DATA ───────┤ GPIO4 │ - (+10к подтяжка │ │ - DATA -> 3V3) │ │ + (жёлтый провод) │ │ │ │ - Реле LIGHT IN ────┤ GPIO16 │ - Реле PUMP IN ────┤ GPIO17 │ - Реле FAN IN ────┤ GPIO18 │ + Реле IN1 (light-1)─┤ GPIO16 (на плате: RX2) + Реле IN2 (pump-1) ─┤ GPIO17 (на плате: TX2) + Реле IN (fan-1) ──┤ GPIO18 ← пока не подключено │ │ 3V3 ────┤ 3V3 │ GND ────┤ GND │ USB/5V ─┤ VIN │ └───────────────────────┘ -DHT22: VCC -> 3V3 GND -> GND DATA -> GPIO4 -Реле-модуль: VCC -> 5V (VIN) или 3V3 (смотри маркировку модуля) - GND -> GND (общий с ESP32) - IN -> GPIO16 / GPIO17 / GPIO18 +DHT22 (готовый модуль, 3 провода): + оранжевый(+/VCC) -> 3V3 жёлтый(out/DATA) -> GPIO4 зелёный(-/GND) -> GND + +Реле, 2-канальный модуль (разъём GND IN1 IN2 VCC): + VCC -> VIN (5V) GND -> GND (общий с ESP32) + IN1 -> GPIO16/RX2 (light-1) IN2 -> GPIO17/TX2 (pump-1) ⚠️ Реле коммутируют цепь самой нагрузки (свет/насос/вентилятор, обычно - 12V/220V) через контакты COM/NO/NC — это ОТДЕЛЬНАЯ силовая цепь со своим - источником питания, к GPIO ESP32 она не подключается. К плате идёт - только сигнальный IN каждого реле-модуля. + 12V/220V) через винтовые клеммы COM/NO/NC каждого канала — это + ОТДЕЛЬНАЯ силовая цепь со своим источником питания, к GPIO ESP32 она не + подключается. К плате идёт только сигнальный IN каждого канала. ``` ## Библиотеки @@ -102,16 +118,39 @@ DHT22: VCC -> 3V3 GND -> GND DATA -> GPIO4 авторизации — только для локальной сети, как и mosquitto платформы; для выхода за пределы LAN сначала нужно добавить хотя бы Basic Auth. -## Настройка и прошивка +## Настройка и прошивка через Arduino IDE -1. `cp config.h.example config.h`, заполнить Wi-Fi SSID/пароль, IP хоста, на - котором поднят `docker compose` платформы (mosquitto слушает `0.0.0.0:1883` - — доступен по IP машины в локальной сети), `zone_id` и `device_id`. -2. Открыть `growbox.ino` в Arduino IDE, выбрать плату (ESP32 Dev Module или - конкретную модель), порт. -3. Прошить. Открыть Serial Monitor на 115200 бод — там лог подключения к - Wi-Fi/NTP/MQTT/веб-сервера и каждой публикации телеметрии/команды, а - также IP платы для похода в веб-интерфейс. +1. **Поддержка ESP32.** Arduino IDE → Settings → «Additional boards manager + URLs» → добавить: + `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` +2. **Ядро.** Tools → Board → Boards Manager → найти `esp32` → установить + пакет `esp32 by Espressif Systems`. +3. **Библиотеки.** Tools → Manage Libraries → поставить по одной: + `PubSubClient`, `ArduinoJson` (v7), `DHT sensor library` (IDE предложит + доустановить зависимость `Adafruit Unified Sensor` — согласиться). +4. **Скетч.** File → Open → `controllers/growbox/growbox.ino` — остальные + `.h`/`.cpp` подхватятся вкладками автоматически. +5. **Конфиг.** `cp config.h.example config.h`, заполнить Wi-Fi SSID/пароль, + IP хоста с поднятым `docker compose` платформы (mosquitto слушает + `0.0.0.0:1883` — доступен по IP машины в локальной сети), `zone_id` и + `device_id`. Если IDE уже была открыта — переоткрыть скетч. +6. **Плата и порт.** Подключить ESP32 по USB (кабель именно с передачей + данных). Tools → Board → esp32 → `ESP32 Dev Module` (или точная модель). + Tools → Port → появившийся `/dev/cu.usbserial-*` / + `/dev/cu.SLAB_USBtoUART`. +7. **Заливка.** Кнопка Upload. Часть плат просит зажать кнопку `BOOT` на + плате до появления точек соединения в логе. +8. **Проверка.** Serial Monitor, 115200 бод — лог подключения к + Wi-Fi/NTP/MQTT/веб-сервера, публикации телеметрии/команд и IP платы для + похода в веб-интерфейс. + +**Если не заливается:** +- порта нет в списке — нужен драйвер USB-UART моста платы (CP2102 обычно + ставится сам на современной macOS, CH340 — вручную); +- `Failed to connect to ESP32` / `No serial data received` — зажать `BOOT` + на плате на время заливки; +- заливка обрывается или очень долгая — Tools → Upload Speed → понизить с + 921600 до 115200. ### Сборка через `arduino-cli` (если не через IDE) diff --git a/growbox/config.h.example b/growbox/config.h.example index dcb8431..b59967d 100644 --- a/growbox/config.h.example +++ b/growbox/config.h.example @@ -21,6 +21,8 @@ #define DEVICE_ID_FAN "fan-1" // --- Пины (ESP32 DevKitC) --- +// На 30-контактных платах GPIO16/17 часто подписаны на шёлкографии как +// RX2/TX2 (пины UART2), а не номерами — это те же GPIO, см. README.md. #define PIN_DHT22 4 #define PIN_RELAY_LIGHT 16 #define PIN_RELAY_PUMP 17