Skip to the content
2 layers70 × 30 mmPump controller, the printed circuit board in 3D

Прошивка управляет насосом через аппаратно выбранный Zigbee Router либо прямое подключение Wi-Fi/MQTT: насос включается вручную или на заданное время, а импульсы расходомера превращаются в литры и текущий расход.

Size
70 × 30 mm
Copper layers
2
Thickness
1.6 mm
Parts
20
Nets
27
Pads
71
Tracks, vias
86, 13
Pours
6
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
17 Jul 2026
Updated
12 Aug 2026

Overview

Pump controller is an open-source printed circuit board by aspinozaxxx-lab, from the aspinozaxxx-lab/zigbee_pump repository on GitHub. It is a 2-layer board of 70 × 30 mm with 20 parts on 27 nets, routed with 86 tracks and 13 vias.

It is built around the AONR34332C and STPS5L60U. Its parts include 8 resistors, 3 connectors, 2 switches, 1 diode and 1 transistor. It belongs with the ESP32 and RISC-V boards of this library.

Main components

2

README

README.md

Контроллер насоса Zigbee / Wi-Fi на ESP32-C6 SuperMini

Прошивка управляет насосом через аппаратно выбранный Zigbee Router либо прямое подключение Wi-Fi/MQTT: насос включается вручную или на заданное время, а импульсы расходомера превращаются в литры и текущий расход. Расходомер является только источником телеметрии: отсутствие импульсов не выключает и не блокирует насос. Локальная безопасность насоса не зависит от доступности MQTT или Zigbee-координатора.

Текущая версия: 1.1.1, hardware version 3. Модель Zigbee: ESP32C6-WP1, производитель: pump_zigbee. Endpoint объявляется стандартным устройством Zigbee HA Pump (0x0303), чтобы универсальные координаторы могли выбрать встроенную иконку насоса.

В режиме сопряжения контроллер сканирует все каналы Zigbee 2,4 ГГц с 11 по 26. Канал задаёт координатор сети; прошивка не привязана к каналу 25. Стандартные On/Off, Flow Measurement и Metering доступны сторонним координаторам без специальной интеграции. Таймеры, настройки, аварии и подробная телеметрия из кластера 0xFC00 требуют внешнего конвертера Zigbee2MQTT либо соответствующего device handler в другой системе.

Плата rev. 6.0 имеет размер 70×30 мм и поддерживает два аппаратно выбираемых транспорта: Zigbee и прямой Wi-Fi/MQTT. Заказывается только голая PCB; все компоненты пользователь устанавливает вручную на переднюю сторону. ESP32-C6 SuperMini M1 управляет насосом 12 В / 15 Вт, принимает импульсы расходомера и сохраняет одинаковую модель команд/состояний независимо от выбранного транспорта. Готовые Gerber, BOM и файлы для заказа находятся в hardware/production.

Что реализовано

  • стандартное Zigbee-сопряжение и повторное подключение после перезагрузки;
  • прямой Wi-Fi/MQTT с открытой установочной точкой доступа и captive portal;
  • одинаковые MQTT-топики, JSON-команды и состояния для Zigbee2MQTT и прямого Wi-Fi;
  • обычное ON/OFF и полив на заданное число секунд;
  • жёсткий предел непрерывной работы, который нельзя продлить повторной командой ON;
  • информационный статус потока idle/checking/flowing/no_flow, не влияющий на насос;
  • защёлкиваемые аварии предельного времени, NVS и внутреннего счётчика;
  • счётчик воды с настраиваемым числом импульсов на литр;
  • общий объём, текущий расход, импульсы и статистика последнего запуска;
  • сохранение настроек, счётчиков и аварии в NVS; насос после перезагрузки всегда остаётся выключенным;
  • Zigbee OTA и загрузка подписанного BIN из Wi-Fi-портала с двумя разделами и rollback;
  • расширенный производительский Zigbee-кластер для настройки и телеметрии.

Значения по умолчанию:

ПараметрЗначение
Импульсов на литр5880
Максимальная работа1800 с
Задержка статуса no_flow после старта10 с
Задержка статуса no_flow после потери импульсов5 с

Подключение

Назначение выводов:

GPIOНазначениеУровень
GPIO0прямое управление затвором MOSFET насоса через 220 Омактивный HIGH, 3,3 В
GPIO3импульсы с J4 через подтяжку 2,2 кОм и делитель 10 кОм / 20 кОмфронт LOW→HIGH; на J4 допускается HIGH до 5 В
GPIO1угловая кнопка сопряжения на краю PCBкнопка на GND, внутренняя подтяжка вверх
GPIO2аппаратный переключатель S1 ZIGBEE / WIFILOW = Zigbee, HIGH = Wi-Fi; внешний pulldown 10 кОм
GPIO7внешний светодиод состоянияHIGH через резистор 330 Ом
GPIO8встроенный адресный RGB LEDподключать ничего не нужно

Полная силовая схема, номиналы и предупреждения находятся в docs/wiring.md. Редактируемый проект — в hardware/pump_controller.kicad_pro. На PCB rev. 6.0 разведены GPIO0…GPIO3; внешний GPIO7 LED на неё не выведен. Не подключайте насос непосредственно к GPIO, а выход расходомера — непосредственно к ESP32 в обход цепи J4.

Сопряжение

Для Zigbee2MQTT скопируйте версионируемый конвертер esp32c6_water_pump.mjs в каталог data/external_converters используемого экземпляра и включите advanced.enable_external_js: true. После загрузки в журнале должна появиться запись Loaded external converter 'esp32c6_water_pump.mjs'.

  1. Откройте интерфейс Zigbee2MQTT: http://127.0.0.1:8080.
  2. Разрешите подключение новых устройств.
  3. Удерживайте угловую кнопку PAIR / RESET ZB на GPIO1 не менее 5 секунд.
  4. Устройство остановит насос, удалит старую Zigbee-сеть и откроет окно сопряжения на 180 секунд.
  5. В Zigbee2MQTT появится water_pump.

Короткое нажатие кнопки ничего не делает. Настройки, водомер и защёлкнутая авария при повторном сопряжении не стираются.

Кнопка на PCB подключена к GPIO1 и GND. Её можно нажимать после загрузки прошивки; при подаче питания или аппаратном Reset оставляйте её отпущенной.

Индикация встроенного RGB LED на GPIO8:

ЦветСостояние
красный постоянновыбранная сеть не подключена
жёлтый мигаетоткрыто сопряжение Zigbee или Wi-Fi-портал
зелёный, 5 вспышекподключение успешно
синий постоянноустройство в сети

Индикация необязательного внешнего LED на GPIO7:

ИндикацияСостояние
выключенподключён, насос остановлен
горит постояннонасос работает
быстро мигаетрежим сопряжения
медленно мигаетвыбранная сеть не найдена
две короткие вспышкизащёлкнута авария

Режим Wi-Fi

Переведите S1 в WIFI и перезапустите устройство. При отсутствии сохранённой конфигурации контроллер поднимает открытую точку PumpSetup-XXXXXX; портал доступен по http://192.168.4.1. Удержание SW1 5 секунд открывает портал повторно. Настройки Wi-Fi и MQTT сохраняются только после успешной проверки подключения.

Поддерживаются mqtt:// и mqtts://, логин/пароль MQTT, системный набор публичных CA и пользовательский PEM CA. Отключение проверки сертификата не предусмотрено. Имя устройства задаёт базовый топик:

text
zigbee2mqtt/<device_name>
zigbee2mqtt/<device_name>/set
zigbee2mqtt/<device_name>/get
zigbee2mqtt/<device_name>/availability

JSON-команды и состояния совпадают с интерфейсом Zigbee2MQTT. Потеря Wi-Fi/MQTT не отменяет локальные ограничения времени и не обходит защиту контроллера. Перевод S1 во время работы после фильтрации 300 мс аварийно останавливает насос и перезапускает ESP32 в новом режиме.

Управление через MQTT

Наблюдение за всеми параметрами:

powershell
& 'C:\Program Files\mosquitto\mosquitto_sub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump' -v

Обычное включение и выключение:

powershell
'{"state":"ON"}'  | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l
'{"state":"OFF"}' | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l

Полив ровно 60 секунд — обе формы поддерживаются:

powershell
'{"run_duration":60}' | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l
'{"state":"ON","on_time":60}' | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l

Настройка и сброс аварии:

powershell
'{"pulses_per_liter":5880}' | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l
'{"max_run_time":1800}'     | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l
'{"reset_fault":"RESET"}' | & 'C:\Program Files\mosquitto\mosquitto_pub.exe' -h 127.0.0.1 -t 'zigbee2mqtt/water_pump/set' -l

Все свойства, статусы потока и коды аварий описаны в docs/zigbee.md; Wi-Fi-режим использует те же имена полей.

Калибровка расходомера

Пропустите через датчик точно известный объём и запишите разницу total_pulses:

text
pulses_per_liter = измеренные_импульсы / фактические_литры

Если известны старый коэффициент и показания устройства:

text
новый_коэффициент = старый_коэффициент × показанные_литры / фактические_литры

Задайте полученное целое значение через Zigbee2MQTT или прямой MQTT. Коэффициент 5880 — только отправная точка для YF-S401; конкретный экземпляр лучше откалибровать.

Сборка и прошивка

Для сборки нужен ESP-IDF 5.5.4; версия esp-zigbee-lib зафиксирована в dependencies.lock. Node.js, MQTT broker и Zigbee2MQTT нужны только для необязательной локальной интеграционной проверки. Конфигурация, база сети, ключи и логи из каталога zigbee2mqtt/ намеренно не версионируются; исключение — внешний конвертер zigbee2mqtt/external_converters/esp32c6_water_pump.mjs.

Образы 1.1.1 подписываются внешним ключом ECDSA-P256. Приватный ключ не должен находиться в репозитории; перед сборкой укажите его через PUMP_SIGNING_KEY. Проверка подписи выполняется при OTA без программирования eFuse Secure Boot.

powershell
$env:PUMP_SIGNING_KEY = 'D:\secure\pump-signing-key.pem'
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\build.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\flash.ps1 -Port COM3
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-ota.ps1

flash.ps1 не стирает Zigbee NVS и сохранённую Wi-Fi/MQTT-конфигурацию. Для стендовой проверки счётчика существует отдельная сборка, которая подаёт внутренние тестовые импульсы на PCNT:

powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\build.ps1 -SelfTest
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\flash.ps1 -Port COM3 -SelfTest

Эту сборку нельзя оставлять в эксплуатации; верните обычную прошивку командой flash.ps1 без -SelfTest.

Необязательный запуск инфраструктуры и безопасная MQTT-проверка требуют отдельно настроенного локального каталога zigbee2mqtt/:

powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\start-zigbee2mqtt.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\mqtt-smoke-test.ps1

Статические проверки:

powershell
& 'C:\Espressif\tools\python\v5.5.4\venv\Scripts\python.exe' -m unittest -v tests.test_contract

Результаты аппаратной отладки приведены в docs/test-report.md.

Безопасность

Это низковольтный контроллер 12 В, но насос создаёт пусковой ток и индуктивный выброс. На rev. 6.0 намеренно нет предохранителя, защиты от переполюсовки и входного TVS: используйте стабилизированный БП 12 В с собственной защитой и строго соблюдайте полярность штекера J1 (центр — плюс). Обратный диод D4 STPS5L60U остаётся обязательной частью платы. Контакт J2.1 и плюсовой провод насоса постоянно находятся под +12 В даже при OFF.

Обычный USB и 12 В к J1 нельзя подключать одновременно. В rev. 6.0 нет развязывающего диода: шина +5 В общая для Mini-360, ESP32 и J4. Прошивайте M1 до пайки на плату, далее используйте OTA либо USB-кабель только с линиями данных и физически отключённым VBUS. Перед обслуживанием отключайте питание, установите плату в влагозащищённый корпус и не запускайте насос всухую. Прошивка намеренно не считает отсутствие импульсов аварией и не защищает насос от сухого хода.

Parts

20
QtyValueFootprintReferences
310kResistor_SMD:R_0805_2012MetricR4, R6, R10
3M2 NPTHMountingHole:MountingHole_2.2mm_M2H1, H2, H3
21kResistor_SMD:R_0805_2012MetricR3, R9
12.2kResistor_SMD:R_0805_2012MetricR8
120kResistor_SMD:R_0805_2012MetricR7
1220RResistor_SMD:R_0805_2012MetricR5
1AONR34332CPumpController:AONR34332C_DFN3.3x3.3_EPQ2
1B3B-XH-A FLOWConnector_JST:JST_XH_B3B-XH-A_1x03_P2.50mm_VerticalJ4
1DC-005 5.5x2.1 CENTER+PumpController:DC005_5.5x2.1_PlatedSlotsJ1
1ESP32-C6 SuperMini 2x10 edge padsPumpController:ESP32-C6_SuperMini_20EdgeP_P2.54_26x18M1
1GT308-2.54-02P-14-00PumpController:GT308-2.54-02P-14-00J2
1Mini-360 12V-to-5V modulePumpController:Mini-360_17.8x11.6_P15.24x9.144M2
1PAIR / PORTALPumpController:PTS645VL39_Drill1.0SW1
1STPS5L60UDiode_SMD:D_SMBD4
1ZIGBEE / WIFIPumpController:OS102011MA1QN1_3mm_ProtrusionS1

Similar boards

  • 2 layers165.6 × 94 mmECK-88, the printed circuit board in 3D

    ECK-88

    BryanOrabutt/ECK-88

    This project is an attempt to recreate the Intel ECK-88 development kit using KiCAD software to recreate the board and schematics.

    181 partsMIT
  • 4 layers50 × 40 mmRAPS-5 V1, the printed circuit board in 3D

    RAPS-5 V1

    itsTasos/RAPS-5

    Dual-input power module with independent LiPo protection, buck conversion and ideal-diode OR-ing.

    96 parts
  • 4 layers100 × 80 mmPellet burner, the printed circuit board in 3D

    Pellet burner

    Weyla/pellet-burner-pcb

    171 parts
  • 2 layers66.9 × 74.5 mmDeskHop Rev1, the printed circuit board in 3D

    DeskHop Rev1

    hrvach/deskhop

    Fast Desktop Switching Device

    20 parts7.9kGPL-3.0
  • 2 layers86.4 × 64.8 mmSlot machine, the printed circuit board in 3D

    Slot machine

    google/google-ctf

    Google CTF

    20 parts5.1kApache-2.0
  • 2 layers36.2 × 26.8 mmEsp32 minimal, the printed circuit board in 3D

    Esp32 minimal

    atopile/atopile

    Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️

    20 parts4kMIT
  • 2 layers108.1 × 393.8 mmSweep compact ble, the printed circuit board in 3D

    Sweep compact ble

    davidphilipbarr/Sweep

    Sweep - a small promicro based keyboard inspired by the Ferris.

    20 parts2.1k
  • 2 layers26 × 15.9 mmTPS54340 Buck Regulator, the printed circuit board in 3D

    TPS54340 Buck Regulator

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    20 parts1.2k

Questions

How big is the Pump controller PCB?

It measures 70 × 30 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Pump controller use?

20 parts, built around the AONR34332C and STPS5L60U. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Pump controller KiCad files?

From the aspinozaxxx-lab/zigbee_pump repository on GitHub, at the commit this page was made from: the board is hardware/production/_factory_package/source/pump_controller.kicad_pcb and its schematic hardware/production/_factory_package/source/pump_controller.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Pump controller design in my own project?

Its repository states no licence, so its author keeps all rights: ask aspinozaxxx-lab before reusing the design.