Hombridge plugin for controlling appliances through ModbusTCP
You must define each accessory in the config.json file, with a name
, a type
(that matches any HomeKit Service type), and one or more characteristics (that match HomeKit Characteristics for this Service).
If you want to group several services under the same accessory, just reuse the same accessory name, and add a subtype
field if services are of the same type.
The characteristics value in the json is the modbus address associated with it.
Coils are defined with the letter 'c' followed by the coil number, holding registers are defined with the letter 'r' followed by the register number, input registers are defined with the letter 'i' followed by the register number.
If you want more advanced control, the characteristic value can instead be an object having address
as the coil/register type and number, and optional elements like validValues
, maxValue
, value
to configure HomeKit, mask
, map
, scale
to map different values between modbus and homekit, readOnly
to force holding registers or coils to not be written on modbus (input registers are always read-only).
Example config.json:
{
"platforms": [
{
"platform": "Modbus",
"ip": "192.168.1.201",
"port": 502,
"pollFrequency": 1000,
"accessories": [
{
"name": "Bedroom ventilation",
"type": "Fan",
"On": "r1"
},
{
"name": "Bedroom light",
"type": "Switch",
"On": "c1"
},
{
"name": "Bedroom",
"type": "Thermostat",
"TargetTemperature": "r2",
"CurrentTemperature": "i1",
"CurrentHeatingCoolingState": {
"address": "r3",
"readonly": true,
"mask": "2",
"map": {"0": 0, "2": 1},
"validValues": [0, 1]
},
"TargetHeatingCoolingState": {"value": 1, "validValues": [1]}
},
{
"name": "Water Heater",
"type": "TemperatureSensor",
"subtype": "from boiler",
"CurrentTemperature": "i2"
},
{
"name": "Water Heater",
"type": "TemperatureSensor",
"subtype": "to boiler",
"CurrentTemperature": "i3"
}
]
}
]
}