Данная статья формируется в процессе написания кода
LightHub можно настроить на работу в качестве шлюза с фактически любым устройством, поддерживающим Modbus RTU и работающем в режиме Slave
В корневом разделе modbus конфигурации описывается библиотека используемых типов устройств.
Для каждого устройства в библиотеки возможно задать такие параметры как скорость обмена (раздел baud) /параметры четности (раздел serial), назначение и тип регистров (раздел par), а также, интервал и параметры опроса этих регистров (раздел poll)
Данный раздел содержит информацию о назначении каждого опрашиваемого или управляемого регистра (или групп регистров) используемого устройства. Раздел состоит из JSON объектов следующего формата:
"t_heat":{"reg":8,"map":[0,1024,0,1024],"type":"i16"},
В примере выше:
Возможные варианты типов:
задает интервал и параметры опроса регистров устройства
Причем, в целях оптимизации обмена, можно опрашивать устройство командой чтения группы регистров. Пример:
"poll":{"regs":[[40000,40014],[30000,30002],40099],"delay":10000}
Обозначает, что с интервалом 10 сек будут произведены следующие три опроса:
Для каждого из успешно прочитанных регистров, проводится поиск соответствия в разделе par Если есть запись, соответствующая данному регистру, прочитанные значения преобразовываются (см описание map) и направляются в MQTT и/или локальным объектам контроллера
Отправка происходит, если с момента последнего опроса значение регистра изменилось
Пример:
"baud":9600, "serial":"8E1"
Соответственно, скорость обмена (по умолчанию, 9600) и параметр четности порта Параметр четности - одно из значений ниже. По умолчанию 8N1
“8E1”,“8N1”,“8E2”, “8N2”, “8O1”, “8O2”, “8M1”, “8S1”, “7E1”, “7N1”, “7E2”, “7N2”, “7O1”, “7O2”, “7M1”, “7S1”
В данном разделе задаются конкретные modbus устройства
"items": { "dimer1":[14,[1, "dim4", { "ch1":{"emit":"aaa1,"item":"localdimmer1"}, "ch2":{"emit":"abc/aaa2"}, "ch3":{"item":"localdimmer3"}, "ch4":[{"emit":"aaa4,"item":"localdimmer4"},{"emit":"aaa44,"item":"localdimmer44"}] } ] ],
В данном примере, создается item (объект) dimer1 с адресом modbus=1, на основе библиотечного устройства “dim4”
Устройство опрашивается согласно настройкам в библиотеке. А вот результаты опроса используются согласно настройкам в items. В данном примере,
Далее, соберем фрагменты в более полный пример:
"modbus": { "airset":{ "baud":9600, "serial":"8N1", "poll":{"regs":[1,[8,24]],"delay":1000}, "par":{ "t_heat":{"reg":8,"map":[0,1024,0,1024],"type":"i16"}, "mode":{"reg":24} } }, "dim4":{ "poll":{"regs":[[0,4]],"delay":10000}, "par":{ "ch1":{"reg":0}, "ch2":{"reg":1}, "ch3":{"reg":2}, "ch4":{"reg":3} } }, "panel":{ "poll":{"regs":[[40000,40014],[30000,30002]],"delay":10000}, "par":{ "fan" :{"reg":40000}, "mode" :{"reg":40001}, "set" :{"reg":40002}, "pwr" :{"reg":40003}, "alm01":{"reg":40004}, "alm17":{"reg":40005}, "alm33":{"reg":40006}, "sethum" :{"reg":40007}, "setvoc" :{"reg":40008}, "temp" :{"reg":30000}, "hum" :{"reg":30001}, "voc" :{"reg":30002}, "ch_temp" :{"reg":40009}, "ext_temp" :{"reg":40010}, "out_temp" :{"reg":40011}, "water_temp" :{"reg":40012}, "ch_hum" :{"reg":40013}, "heat_pwr":{"reg":40014} } } }, "items": { "airset1":[14,[10,"airset",{"t_heat":{"emit":"aaa"}}]], "panel1":[14,[2,"panel"]], "dimer1":[14,[1,"dim4", { "ch1":{"emit":"aaa1,"item":"localdimmer1"}, "ch2":{"emit":"abc/aaa2"}, "ch3":{"item":"localdimmer3"}, "ch4":[{"emit":"aaa4,"item":"localdimmer4"},{"emit":"aaa44,"item":"localdimmer44"}] } ] ] }