/ioBroker.hmip

Adapter for the Homematic IP Cloud Accesspoint

Primary LanguageJavaScriptMIT LicenseMIT

Logo

ioBroker HomeMatic IP Cloud AccessPoint Adapter

Number of Installations Number of Installations NPM version Downloads Build Status

NPM

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Description

This adapter allows to communicate with a HomematicIP CloudAccessPoint via the Rest API of the Homematic IP Cloud

Installation

This Adapter needs node-js in version >= 8.6

Here a Step-by-Step Installation Video on YouTube https://youtu.be/kXWfJRUYJIA

Info

Most Homematic IP devices are already working with the latest adapter version.

I will improve it constantly, but it will take time. Any help from the community thru e.g. Pull Request would be highly appreciated.

For not working HmIP devices, please create an issue with this info (please one per device and if possible the technical name in the subject). Switch adapter logging in ioBroker to silly mode and add the json of the device which is printed to the log in the issue. I may also need a json of a state change.

Thank you

Important Info what can be done with this adapter

!!! You can only trigger events with this adapater that can be triggered thru the original Homematic IP app. For example direct connections between devices have no events in the app and can also not be triggert thru this adapter!!!

Settings

  • enter your SGTIN (back of the Access Point) and the PIN (if set before), and validate the data via press of the blue LED Button. This will create an Authentication token.

Thanks

to coreGreenberet for his python lib (https://github.com/coreGreenberet/homematicip-rest-api)

Diskussion in ioBroker Forum

https://forum.iobroker.net/topic/27532/homematic-ip-cloud-access-point-adapter

Adapter Request auf GitHub

ioBroker/AdapterRequests#62

Changelog

1.3.1 (2020-09-18)

  • (Apollon77) Fix missing write permission for Notification Light "On" channel

1.3.0 (2020-09-18)

  • (SliX185) Add MAINS_FAILURE_CHANNEL
  • (Apollon77) Add DEVICE_RECHARGEABLE_WITH_SABOTAGE, ACCESS_CONTROLLER_CHANNEL, FLOOR_TERMINAL_BLOCK_MECHANIC_CHANNEL, DEVICE_BASE_FLOOR_HEATING, MULTI_MODE_INPUT_DIMMER_CHANNEL, MULTI_MODE_INPUT_SWITCH_CHANNEL, ANALOG_OUTPUT_CHANNEL, ACCELERATION_SENSOR_CHANNEL, TILT_VIBRATION_SENSOR_CHANNEL, SHADING_CHANNEL
  • (Apollon77) try to add dim/rgb support for NotificationLight. You might need to delete/recreate the states if it is not working.
  • (Apollon77) add additional functions for setOperationLock, setClimateControlDisplay, setMinimumFloorHeatingValvePosition, setRgbDimLevel. You might need to delete/recreate the states if it is not working.
  • (Apollon77) adjusted some roles. You might need to delete/recreate the states if it is not working.

1.2.2 (2020-08-17)

  • (Apollon77) Prevent Crash case (Sentry IOBROKER-HMIP-1B)

1.2.1 (2020-08-10)

  • (Apollon77) Fix pairing process

1.2.0 (2020-07-26)

  • (saschaabraham) Added an active property INTERNAL and EXTERNAL groups for alarm zones
  • (marcus0303/slix185) added DOOR_CHANNEL properties

1.1.1 (2020-07-23)

  • (Apollon77) Crash prevented if object is deleted by state changed (Sentry IOBROKER-HMIP-Y)

1.1.0 (2020-07-14)

  • (Apollon77) Remember already sent unknown channel infos to not spam Sentry
  • (Apollon77) Handle reconnects better (Sentry IOBROKER-HMIP-G)
  • (Apollon77) Try to prevent crashes on i valid server reponses, warning is logged
  • (SliX185) Add HMIP-SPDR (PASSAGE_DETECTOR_CHANNEL)

1.0.1 (2020-05-16)

  • (Apollon77) Make sure invalid data do not crash adapter (Sentry IOBROKER-HMIP-7)
  • (Apollon77) code cleanup
  • (Apollon77) fix several roles (role info is not allowed)

1.0.0 (2020-05-12)

  • (Apollon77) Add Sentry for error/crash reporting
  • (Apollon77) multiple fixes and optimizations
  • (Apollon77) prevent adapter crashes in some places
  • (Apollon77)
  • (ApolloSK) add vaporAmount for WeatherSensorPro
  • (ApolloSK) fix HmIP-SWO-PR wrong DataType actualTemperature
  • (marcus0303) Added DEVICE_GLOBAL_PUMP_CONTROL, FLOOR_TERMINAL_BLOCK_LOCAL_PUMP_CHANNEL and DEVICE_INCORRECT_POSITIONED, Fixed role in _createWaterSensorChannel and function call in _createWeatherSensorPlusChannel
  • (marcus0303) Added CONTACT_INTERFACE_CHANNEL for HmIP-SCI (see Issue #70 ), Added FLOOR_TERMINAL_BLOCK_CHANNEL, HEAT_DEMAND_CHANNEL, DEHUMIDIFIER_DEMAND_CHANNEL, CHANGE_OVER_CHANNEL, but without functionality, because it's not implemented in REST-API. Only to supress Warnings in Log.

0.0.12

  • (jogibear9988) multiple fixes

0.0.11

  • (jogibear9988) multiple fixes

0.0.10

  • (jogibear9988) added ping/pong, enable setBoots, more units, more hardware

0.0.9

  • (jogibear9988) fullrx and operationlock channel

0.0.8

  • (jogibear9988) fixes a few devices

0.0.7

  • (jogibear9988) fixes wrong state handling

0.0.6

  • (jogibear9988) fixes for more devices, alarm handling

0.0.5

  • (jogibear9988) more devices and big refactoring (switched from DeviceType to FunctionalChannelType)

0.0.4

  • (jogibear9988) more devices, bugfixes. thanks to TobiasF1986, steckenpferd and Ma-ster77

0.0.3

  • (jogibear9988) bugfixes and more devices

0.0.2

  • (jogibear9988) bugfixes, more devices and initial support of groups

0.0.1

  • (jogibear9988) initial release

License

The MIT License (MIT)

Copyright (c) 2018-2019 jogibear9988 jochen.kuehner@gmx.de

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.