Fhem-Gateway and Accessory-Simulator Plugin for Homebridge
npm install homebridge-puntNew: JSON-editor - Runtime Configuration
If you're new to Homebridge, please first read the Homebridge documentation.
You should have a look at the Wiki if you're running on a Raspberry.
Install homebridge:
``sh`
sudo npm install -g homebridge`
Install homebridge-punt:sh`
sudo npm install -g homebridge-punt
.`sh
{
"platform" : "punt",
"name" : "punt"
}
`Add
config-punt.json into your directory .homebridge/plugins/homebridge-punt.`sh
{
"gateway": {
"name": "fhem",
"url": "127.0.0.1",
"port": "8083",
"auth": {"user": "foo", "password": "bar"},
"run": true,
"longpoll": true
},
"puntview": {
"run": true,
"port": "4040"
},
"simulator": {
"run": true,
"port": "4080"
},
"monitor": {
"run": true,
"port": "8081"
},
"accessories": [
{
"name": "alarm_control",
"service": "Switch"
},
{
"name": "flex_lamp",
"service": "Outlet"
},
{
"name": "garden_door",
"service": "ContactSensor"
},
{
"name": "local_weather",
"service": "TemperatureSensor",
"CurrentTemperature": { "minValue": -20, "maxValue": 60 }
},
{
"name": "smoke_living",
"service": "SmokeSensor",
"StatusLowBattery": "default"
},
{
"name": "led_bulb",
"service": "Lightbulb",
"Brightness": "default",
"Hue": "default",
"Saturation": "default"
},
{
"name": "bathroom_blind",
"service": "WindowCovering",
"CurrentPosition": { "minStep": 5 },
"TargetPosition": { "minStep": 5 },
"CurrentHorizontalTiltAngle": { "minValue": 0, "minStep": 5 },
"TargetHorizontalTiltAngle": { "minValue": 0, "minStep": 5 }
}
]
}
`To add an optional Characteristic define the Characteristic with "default" for the default values.
However, the default values can be changed:
`
{ "minValue": 0, "maxValue": 100, "minStep": 10 }
`HomeKitTypes.js describes all the predifined Services and Characteristcs.
To define Multifunctions Sensors like Fibaro FGMS-001 with different services add a suffix to the accessory name separated by ".":
`sh
{
"accessories": [
{
"name": "multi_living.temp",
"service": "TemperatureSensor"
},
{
"name": "multi_living.light",
"service": "LightSensor",
"CurrentAmbientLightLevel": { "minValue": 0, "minStep": 1 }
},
{
"name": "multi_living.motion",
"service": "MotionSensor"
},
{
"name": "multi_living.battery",
"service": "BatteryService"
}
]
}
`$3
puntView is a WUI (web-based user interface) that displays the Accessory Services and Characteristics in real-time.
puntView incorporates a JSON-editor, to open the editor select
Setting in Menu. You can add, remove or modify accessories without having to restart homebridge. Tap Saveto save your changes, homebridge-punt will reload the new configuration.Type the puntView-address in your browser:
`sh
http://127.0.0.1:4040
`Change the port number in config-punt.json if neccessary.
$3
Deactivate the gateway ("run": false) to run the simulator without connecting to the Fhem-Server. However, the simulator can run simultaneously with the gateway.
Type the Simulator-address in your browser:
`sh
http://127.0.0.1:4080
`$3
The Monitor is still supported but
puntView is recommended.`sh
http://127.0.0.1:8081
``