With this plugin, the support of a IP gateway installed in your plant and a configuration of all installed
systems (MyHome does not support the autodiscovery of the system) you can control it. You need to disable the OpenWebNet password-based
authentication from the IP of the device that runs homebridge (ie. Raspberry) or set the auhentication to HMAC;
HMAC authentication is supported by all recent IP gateways or older one with updated firmware (eg. F454 with v2 firmware).
Installation (TBD)
Install plugin with npm install -g homebridge-myhome
Add platform within config.json of you homebridge instance:
Only the platforms section of the config.json file should be edited, the pair code and the port in bridge section can be ignored in most of the cases. A little sample:
ipaddress: put the IP address or name of the MyHome Gateway (eg. F454 or MH201, I'm not so updated about all gateways that BTicino-Legrand releases after 2015); the IP should be static but in the future I can implement a UPNP dicovery because all gateways supports that method
port: should be 20000 and keep this value
ownpassword: the OpenWebNet password, default is 12345 but everyone will suggest to you to change it with another password (4 to 9 digits), but you will keep the default one, I know...
discovery: boolean value, not supported but in the future allows the gateway to discover the plant and detect most of devices
devices: list of installed devices
The devices section contains the list of devices that will be managed. All devices contains three standard properties:
accessory: the technical name of the device, should be one of the names listed in this document
name: mnemonic name, will be displayed by iOS HomeKit application
address: the MyHome address, usually in B/A/PL format for lights and curtaints or single/double digits for other devices. B stands for BUS (usually 0), A and PL is the name of the addressing object used by BTicino and stands for Ambient and Light Point (Punto Luce in the original italian version)
Supported devices
MHRelay: Standard (Lighting) Relay (eg. F411), address is B/A/PL (eg. 0/1/10)
this device supports the definition of a custom frame for on and off command, so you can specify frame_on and/or frame_off:
to use a Group, CEN, CEN+ or other command to turn on and off that load, using the address load for the status monitor. Remember that HomeKit will think that the load has changed the status after the command even if is not true.
MHScene: Scene (F420) or IRBlaster, address is N, Scene is scenario number (thanks to dendeps) - NOT TESTED
MHThermostat: Standard Thermostat controlled by a 99-Zones Central Station (code 3550), address is the Zone Identifier (1-99)
MHExternalThermometer: External Probe controlled by a 99-Zones Central Station (code 3550), address is the Zone Identifier (1-9)
MHOutlet: Standard (not-Lighting) Relay, address is B/A/PL (eg. 0/1/10). See MHRelay for custom frame support
MHBlind: Standard Automation Relay (eg. F411, I need to check the F401), address is B/A/PL (eg. 0/1/10)
this device defines another property called "time" that defines the configured "stop time" in seconds; using this property the driver can evaluate the current position of the blind
MHBlindAdvanced: Advanced version of standard Blind (eg. F401 that manages internally the current position), address is B/A/PL (eg. 0/1/10)
MHContactSensor: Dry Contact sensor (eg. 3477 or some burgalarm sensors), address range is 1-201
MHPowerMeter: (WILL BE SUPPORTED)
MHAlarm: (WILL BE SUPPORTED)
Tested devices
F454v1 and MH201 as IP Gateway
F411/2 as MHRelay, MHOutlet and MHCurtain
F401 as MHBlindAdvanced
F416U1 as MHDimmer
3455 as MHExternalThermometer
3477 as MHContactSensor
Known Bug List
Groups are not managed
TODOS
Reconnection and infinite retry
Semi-auto discovery and/or read a plant configuration from MyHomeSuite configuration file
Re-order the code
IP Gateway discovery
Group and General Command support
Disclaimer
I'm furnishing this software "as is". I do not provide any warranty of the item whatsoever, whether express, implied, or statutory, including, but not limited to, any warranty of merchantability or fitness for a particular purpose or any warranty that the contents of the item will be error-free.
The development of this module is not supported by Legrand, BTicino or Apple. These vendors and me are not responsible for direct, indirect, incidental or consequential damages resulting from any defect, error or failure to perform.
请发表评论