在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:planetk/homebridge-netatmo开源软件地址:https://github.com/planetk/homebridge-netatmo开源编程语言:JavaScript 100.0%开源软件介绍:Like this? Please buy me a beer ... homebridge-netatmoThis is a plugin for homebridge. It's a working implementation for several netatmo devices:
Please check notes on devices below for detailed information on supported modules. Installation
ConfigurationSimple ConfigurationConfiguration sample:
To retrieve client id and secret please follow following guide:
Advanced ConfigurationThere are some optional configuration options in the netatmo section of the config which provide finer control about what device and services to use to create accessories. API Refresh and timingsCommunication towards netatmo API is time by three parameters:
"platforms": [ { "platform": "netatmo", ... "ttl": 10, "refresh_check": 900000 "refresh_run": 20000 ... } ], Control Accessories by device type"platforms": [ { "platform": "netatmo", ... "deviceTypes": [ "weatherstation", "thermostat", "camera" ], ... } ], This allows you to include/exclude devices of a certain type in your accessories. The device types marked bold are the default types, if this config section is left out. Please note, that welcome support is by default switched off, since it is not fully implemented yet. Control Accessories by device IDControlling devices can be done pn a finer level by id. The id of a netatmo device or module basically is it's mac address. In order to include or exclude a specific device, the corresponding id can be included in a whitelist resp. blacklist. If the whitelist contains at least one entry, all oter ids will be excluded. "platforms": [ { "platform": "netatmo", ... "whitelist": [ "aa:bb:cc:11:22:33" ], "blacklist": [ "01:02:03:04:05:06", "01:23:45:67:89:ab" ], ... } ], Control ServicesTBD (Needs description here) Weather stationThe indoor module and outdoor module are fully supported. The rain gauge and the wind gauge are in general supported, but these devices use characteristics, which are not supported by the home app. For this reason the home app shows the devices as not supported. If you want to use this devices you should consider to use a different homekit app. For example elgato's eve app is a good free alternative. ThermostatThe thermostat is fully supported. There are a few things to know:
Cameras (Welcome and Presence)The camera devices are currently only supported as simple motion sensors. Motion detection might be delayed, since the polling is required an netatmo has strict request rate limits. Any events of Type "movement", "person" and "outdoor" will be considered as a motion. This implementation will most likely be refactored in future. #FAQ ##My rain/wind gauge shows up as not supported This is due to limmited support of the home app. Try to use a different homekit app. Check notes on devices for further info. ##I only get notifications when home app is opened This themes to ba an issue with ios and hap lib. There is nothing I can do about it. Possible you should check the hombridge ifttt plugin with pushover app for notifications. ##Updates of vlaues are delayed This is due to rate limits from netatmo. If polling rate is increased your account might get blocked by netatmo ##netatmo authentication failes Please recheck your config settings and your netatmo account. Sometimes the used netatmo API seems to have connection problems. Often a reload is enough ##Things are messed up. How do I start from scratch? In short:
##This is cool, how can I support? If you like this, your welcome to give a small donation. Check button at top/bottom of page. If you like to join development check the sources, open issues and pull requests. Thanx! Changes0.2.1
0.2.0
DevelopmentFollowing information is not relevant for users who just want to access netatmo via homekit. It is intented for software developers who want to modify / enhance the functionality of the software. Terms
ConceptsNew deviceTypes should be put into the /devices folder. It might be helpful to use the existing deviceTypess as template and to inherit the NetatmoDevice. Each device provides one or more accessories which provide one or more services. Services are defined inside the /services folder. The naming convention is, that a service source code file starts with the device name. The default set of devices and services that are used is the one which resulted from earlier versions. Please see Chapter Advanced Configuration on details about how to add a device or a service. Mock API & TestingNew features should be developed with a test scenario. Tests are executed via travis-ci or npm test. For debugging and test purposes the software contains a support for a mock netatmo api. The mock-api is activate by putting a
into the netatmo section of the config file. When activated there will be no calls to the netatmo API. Instead raw json data is read from file located in the /mockapi_calls folder. The file name is [apimethod]-[name].json where
If this file is not found a [apimethod]-default.json file is read. If this is not found as well, empty data is returned. TODO / Next FeaturesFollowing things are to be developed next.
Is this plugin useful for you? Please buy me a beer ... Thank you for buying me a beer to follwing users:
|
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
请发表评论