Связать между собой Neptun Base RS и HomeAssistant
Небольшая статья о том, как связать между собой Neptun Base RS и HomeAssistant.
Intro
Neptun - это семейство систем защиты от протечек. В данный момент, мне известно о трех поколениях данных систем - Neptun Base, Neptun Smart Plus Tuya, Neptun Alisa.
Neptun Base - это простое решение, которое состоит из трех? компонентов - управляющей платы, датчиков протечки, электрических шаровых кранов. Работает дешево и сердито. Шаровые краны питаются от напряжения в 230 Вольт переменного тока.
Существует также улучшенная ревизия с модулем ModBus. Отличие от первой версии на крышке есть надпись “RS”. И модуль ModBus. Но я не могу найти именно эту модель на сайте, если вы знаете, то напишите мне на почту, пожалуйста.
Для данной модели существует документация, карта для ModBus. Мне кажется, что вторую ревизию выпустили, чтобы была возможность провести улучшение в существующих системах защиты от протечки, просто поменяв одну плату. Думаю, многим установкам данной системы более 10 - 15 лет. И там шаровые краны на 230 Вольт переменного тока.
В данный момент все новые решения от Neptun используют шаровые краны на 12 Вольт постоянного тока.
History
В 2024 году я делал ремонты в своих квартирах, в первой поставил систему Neptun Base, а во второй квартире уже была установлена Neptun Smart Plus Tuya.
В 2026 году я узнал про вторую ревизию платы, купил ее, но потом передумал ставить, а купил Neptun Smart Plus Tuya и шаровые краны на 12 Вольт постоянного тока. Вызвал сантехника и в течение часа поменяли все. В SmartThings добавил новый модуль и через телефон могу видеть состояние системы в двух квартирах.
Но на руках осталось 1 модуль Neptun Base, 1 модуль Neptun Base RS, 1 шаровый кран на 230 Вольт переменного тока.
Я решил, что рано или поздно этим модулям найдется применение.
Components
Для связи Neptun Base RS с HomeAssistant я купил следующие компоненты - TTL Turn To RS485 Module Hardware Automatic Flow Control Module Serial UART Level Mutual Conversion Power Supply Module 3.3V 5V, ESP32-C3 Development Board ESP32 SuperMini .
Ну в качестве прошивки буду использовать EspHome, отлично прошивает платы на базе ESP32, поддерживает протокол ModBus.
EspHome Yaml File
Данный файл был написан совместно с Google Gemini. Я в Google поиске задавал вопрос, затем продолжал диалог с ИИ, добавляя вывод консоли в поисковый запрос, ИИ думал и выдавал еще ответы, и так пока не получил готовый файл, который делает то, что мне нужно.
Что делает EspHome:
- Подключается к Wifi сети, данные берутся из файла secrets.yaml;
- Поднимает UART на пинах GPIO6, GPIO7. Здесь будьте внимательнее, на вашей плате распиновка может быть совсем другой;
- Не использует пины GPIO20, GPIO21, так как они используются для logging;
- Поднимает ModBus соединение поверх UART;
- Подключается к ModBus контроллеру по адресу 1;
- Определяет sensors, binary_sensors, switches. Данные берутся из документации;
- Логика кнопки - Switch - neptun_siren - если она включена, то в случае аварии будет пищать сирена, если не включена, то система будет молчать.
- Логика кнопки - Switch - neptun_valve - если нет тревоги, то позволяет закрывать/открывать краны. если есть тревога, то открыть кран не получится.
esphome:
name: neptunmodbus
friendly_name: neptunmodbus
logger:
level: DEBUG
api:
encryption:
key: !secret api_encryption_key
esp32:
board: esp32-c3-devkitm-1
variant: ESP32C3
framework:
type: arduino
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
output_power: 11dB
fast_connect: false
uart:
id: mod_uart
tx_pin: GPIO6
rx_pin: GPIO7
baud_rate: 9600
parity: NONE
stop_bits: 1
modbus:
id: modbus_bus
uart_id: mod_uart
send_wait_time: 1500ms
modbus_controller:
- id: neptun_base
address: 1
modbus_id: modbus_bus
update_interval: 10s
command_throttle: 1500ms
binary_sensor:
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Протечка"
address: 11
register_type: holding
bitmask: 0x0001 # Бит 0: 0 - нет, 1 - протечка
device_class: moisture
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Краны закрыты"
address: 11
register_type: holding
bitmask: 0x0002 # Бит 1: 0 - открыты, 1 - закрыты
device_class: lock
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Сервисное обслуживание кранов"
address: 11
register_type: holding
bitmask: 0x0004 # Бит 2: 0 - не активно, 1 - выполняется
device_class: running
# 2. ПЕРЕКЛЮЧАТЕЛИ УПРАВЛЕНИЯ (Слово управления, регистр 10 / 0x0A, Таблица 3)
switch:
- platform: template
id: neptun_siren
name: "Neptun Звук сирены"
icon: "mdi:volume-high"
turn_on_action:
- lambda: |-
uint16_t val = (id(neptun_valve).state ? 0x0002 : 0x0000) | 0x0001;
auto cmd = esphome::modbus_controller::ModbusCommandItem::create_write_multiple_command(
id(neptun_base), 10, 1, {val});
id(neptun_base)->queue_command(cmd);
id(neptun_siren).publish_state(true);
turn_off_action:
- lambda: |-
uint16_t val = (id(neptun_valve).state ? 0x0002 : 0x0000);
auto cmd = esphome::modbus_controller::ModbusCommandItem::create_write_multiple_command(
id(neptun_base), 10, 1, {val});
id(neptun_base)->queue_command(cmd);
id(neptun_siren).publish_state(false);
- platform: template
id: neptun_valve
name: "Neptun Краны (Открыть)"
icon: "mdi:valve"
turn_on_action:
- lambda: |-
uint16_t val = (id(neptun_siren).state ? 0x0001 : 0x0000) | 0x0002;
auto cmd = esphome::modbus_controller::ModbusCommandItem::create_write_multiple_command(
id(neptun_base), 10, 1, {val});
id(neptun_base)->queue_command(cmd);
id(neptun_valve).publish_state(true);
turn_off_action:
- lambda: |-
uint16_t val = (id(neptun_siren).state ? 0x0001 : 0x0000);
auto cmd = esphome::modbus_controller::ModbusCommandItem::create_write_multiple_command(
id(neptun_base), 10, 1, {val});
id(neptun_base)->queue_command(cmd);
id(neptun_valve).publish_state(false);
sensor:
- platform: modbus_controller
modbus_controller_id: neptun_base
id: neptun_control_word
address: 10
register_type: holding
value_type: U_WORD
internal: true
on_value:
then:
- lambda: |-
uint16_t val = (uint16_t)x;
id(neptun_siren).publish_state(val & 0x0001);
id(neptun_valve).publish_state(val & 0x0002);
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Тип устройства"
address: 0
register_type: holding
value_type: U_WORD
entity_category: diagnostic
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Версия ПО"
address: 4
register_type: holding
value_type: U_WORD
entity_category: diagnostic
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Время подачи питания на краны"
address: 8
register_type: holding
value_type: U_WORD
unit_of_measurement: "мин"
entity_category: diagnostic
- platform: modbus_controller
modbus_controller_id: neptun_base
name: "Neptun Период обслуживания кранов"
address: 9
register_type: holding
value_type: U_WORD
unit_of_measurement: "дн"
entity_category: diagnostic
Images
Быстро “собрал на коленке” все компоненты, чтобы проверить прошивку и как это работает.
Вывод из HomeAssistant