ioBroker cloud adapter

=================

This adapter allows connection from internet through ioBroker cloud to local installation of ioBroker.

Settings

APP-KEY

To use cloud adapter you should first get the APP-Key on https://iobroker.net.

This is application key that the user can get on https://iobroker.net site. Please get the key there and enter it here.

Instance

All requests from cloud adapter will be routed to some WEB Instance. User must specify here the WEB instance, that will be showed to user, when he logs in https://iobroker.net site.

Allow self-signed certificates

If you use standard iobroker.net cloud, you can deactivate it. This option is only important if own cloud used.

Language

If you select "default" language the smart names of devices and of enumerations will not be translated. If some language specified all known names will be translated into this language. It is done to switch fast between many languages for demonstration purposes.

Place function in names first

Change the order of function and roles in self generated names:

• if false: "Room function", e.g. "Living room dimmer"
• if true: "Function room", e.g. "Dimmer living room"

Concatenate words with

You can define the word which will be placed between function and room. E.g. "in" and from "Dimmer living room" will be "Dimmer in living room".

But is not suggested to do so, because recognition engine must analyse one more word and it can lead to misunderstandings.

OFF level for switches

Some groups consist of mixed devices: dimmers and switches. It is allowed to control them with "ON" and "OFF" commands and with percents. If command is "Set to 30%" and the *OFF level" is "30%" so the switches will be turned on. By command "Set to 25%" all switches will be turned OFF.

Additionally if the command is "OFF", so the adapter will remember the current dimmer level if the actual value is over or equal to the "30%". Later when the new "ON" command will come the adapter will switch the dimmer not to 100% but to the level in memory.

Example:

• Assume, that OFF level is 30%.
• Virtual device "Light" has two physical devices: switch and dimmer.
• Command: "set the light to 40%". The adapter will remember this value for dimmer, will set it for "dimmer" and will turn the switch ON.
• Command: "turn the light off". The adapter will set the dimmer to 0% and will turn off the switch.
• Command: "turn on the light". dimmer => 40%, switch => ON.
• Command: "set the light to 20%". dimmer => 20%, switch => OFF. The value for dimmer will not be remembered, because it is bellow OFF level.
• Command: "turn on the light". dimmer => 40%, switch => ON.

by ON

You can select the behaviour of ON command will come for the number state. The specific value can be selected or last non zero value will be used.

Write response to

For every command the text response will be generated. You can define here the Object ID , where this text must be written to. E.g. sayit.0.tts.text.

Colors

Just now only english alexa supports the color control. The channel must have 4 states with following roles:

• level.color.saturation (required for detection of the channel),
• level.color.hue,
• level.dimmer,
• switch (optional)

Alexa, set the "device name" to "color"
Alexa, turn the light fuschia
Alexa, set the bedroom light to red
Alexa, change the kitchen to the color chocolate

Lock

To have the possibility to lock the locks, the state must have the role "switch.lock" and have native.LOCK_VALUE to determine the lock state.

Alexa, is "lock name" locked/unlocked
Alexa, lock the "lock name"

How names will be generated

The adapter tries to generate virtual devices for smart home control (e.g. Amazon Alexa or Google Home).

The are two important enumerations for that: rooms and functions.

Rooms are like: living room, bath room, sleeping room. Functions are like: light, blind, heating.

Following conditions must be met to get the state in the automatically generated list:

• the state must be in some "function" enumeration.
• the state must have role ("state", "switch" or "level.*", e.g. level.dimmer) if not directly included into "functions". It can be that the channel is in the "functions", but state itself not.
• the state must be writable: common.write = true
• the state dimmer must have common.type as 'number'
• the state heating must have common.unit as '°C', '°F' or '°K' and common.type as 'number'

If the state is only in "functions" and not in any "room", the name of state will be used.

The state names will be generated from function and room. E.g. all lights in the living room will be collected in the virtual device living room light. The user cannot change this name, because it is generated automatically. But if the enumeration name changes, this name will be changed too. (e.g. function "light" changed to "lights", so the living room light will be changed to living room lights)

All the rules will be ignored if the state has common.smartName. In this case just the smart name will be used.

if common.smartName is false, the state or enumeration will not be included into the list generation.

The configuration dialog lets comfortable remove and add the single states to virtual groups or as single device.

If the group has only one state it can be renamed, as for this the state's smartName will be used. If the group has more than one state, the group must be renamed via the enumeration's names.

To create own groups the user can install "scenes" adapter or create "script" in Javascript adapter.

Replaces

You can specify strings, that could be automatically replaced in the devices names. E.g if you set replaces to: .STATE,.LEVEL, so all ".STATE" and ".LEVEL" will be deleted from names. Be careful with spaces. If you will set .STATE, .LEVEL, so ".STATE" and " .LEVEL" will be replaced and not ".LEVEL".

Helper states

• smart.lastObjectID: This state will be set if only one device was controlled by home skill (alexa, google home).
• smart.lastFunction: Function name (if exists) for which last command was executed.
• smart.lastRoom: Room name (if exists) for which last command was executed.
• smart.lastCommand: Last executed command. Command can be: true(ON), false(OFF), number(%), -X(decrease at x), +X(increase at X)
• smart.lastResponse: Textual response on command. It can be sent to some text2speech (sayit) engine.

IFTTT

instructions

Services

There is a possibility to send messages to cloud adapter. If you call [POST]https://iobroker.net/service/custom_<NAME>/<user-app-key> und value as payload.

curl --data "myString" https://iobroker.net/service/custom_test/<user-app-key>

If you set in the settings the field "White list for services" the name custom_test, and call with "custom_test" as the service name, the state cloud.0.services.custom_test will be set to myString.

You may write "*" in white list and all services will be allowed.

From version 2.0.5 you can use GET request in form [GET]https://iobroker.net/service/custom_<NAME>/<user-app-key>/<data> to place the <data> into cloud.0.services.custom_<NAME>.

Here you can find instructions how to use it with tasker.

IFTTT service is allowed only if IFTTT key is set.

Reserved names are "ifttt", "text2command", "simpleApi", "swagger". These must be used without the "custom_" prefix.

text2command

You may write "text2command" in white list, you can send POST request to https://iobroker.net/service/text2command/<user-app-key> to write data into text2command.X.text variable.

"X" can be defined in settings by the "Use text2command instance" option.

simpleApi

to do

Changelog

2.4.5 (2018-01-29)

• (bluefox) Changes for Admin 3

2.4.4 (2018-01-20)

• (bluefox) The errors by controlling of temperature are caught now

2.4.2 (2018-01-20)

• (bluefox) Do not subscribe all objects

2.2.0 (2017-12-22)

• (bluefox) Better update of the devices in configuration dialog

2.1.1 (2017-12-11)

• (bluefox) Add settings for the ping timeout
• (grimneko) corrected some spelling mistakes
• (grimneko) update readme for IFTTT

2.1.0 (2017-12-06)

• (bluefox) Allow to disable alexa service by state

2.0.8 (2017-11-28)

• (bluefox / Philipp Beckers) Translations

2.0.7 (2017-10-29)

• (bluefox) Changes for socket-io

2.0.6 (2017-10-26)

• (bluefox) Fix small error in configuration
• (bluefox) Send uuid to cloud for authentication

2.0.5 (2017-09-26)

• (bluefox) The small custom service reaction improvement

2.0.4 (2017-09-12)

• (bluefox) Allow access to admin via iobroker.pro
• (c-klinger) Add settings for the connection timeout

1.0.8 (2017-07-13)

• (bluefox) Allow control light colors

1.0.7 (2017-06-26)

• (bluefox) AI deactivated
• (bluefox) change ping interval from 10 to 30 seconds
• (bluefox) fix double auth on connect

1.0.3 (2017-05-23)

• (bluefox) Rename some german words

1.0.2 (2017-05-23)

• (bluefox) Support of IFTTT

1.0.0 (2017-05-22)

• (bluefox) Catch an error if the invalid smart name set

0.8.2 (2017-04-24)

• (bluefox) controls of colors (english only)
• (bluefox) request temperature (target temperature and sensor temperature, english only)
• (bluefox) support of double names

0.7.1 (2017-04-05)

• (bluefox) Fixed reconnection

0.7.0 (2017-04-01)

• (bluefox) Try to fix reconnection

0.6.12 (2017-03-26)

• (bluefox) Try to fix error with names

0.6.11 (2017-03-20)

• (bluefox) Fixed scrollbar in configuration

0.6.10 (2017-03-03)

• (bluefox) Add tooltips in config
• (bluefox) Add workaround for alexa reconnection

0.6.9 (2017-02-17)

• (bluefox) Allow to use more than one smart name

0.6.8 (2017-02-16)

• (bluefox) Fix deactivation of enums

0.6.7 (2017-02-14)

• (bluefox) allow buttons to be controller with alexa

0.6.5 (2017-02-06)

• (bluefox) print warnings for invalid states

0.6.3 (2017-01-28)

• (bluefox) fix enum names
• (bluefox) add helper states and response text

0.6.2 (2017-01-25)

• (bluefox) add option "Place function in names first"

0.6.1 (2017-01-24)

• (bluefox) fix reconnect
• (bluefox) change smartName structure

0.5.0 (2017-01-20)

• (bluefox) add value by ON

0.4.2 (2017-01-12)

• (bluefox) add daily restart

0.4.1 (2017-01-06)

• (bluefox) use devices with ":" symbols in the names
• (bluefox) add debug outputs

0.4.0 (2017-01-06)

• (bluefox) Support of english language
• (bluefox) Use rooms of channel and not only states

0.3.3 (2017-01-02)

• (bluefox) Fix error with smartNames
• (bluefox) Take the superset of actions for group and not the last one
• (bluefox) if group has switches and dimmers, turn devices OFF if the percent level is less than 30%
• (bluefox) Remember ON level for dimmers to switch it later ON

0.3.0 (2016-12-29)

• (bluefox) Implement Heating profile for Alexa

0.2.0 (2016-12-13)

• (bluefox) support of amazon alexa

0.1.2 (2016-11-17)

• (bluefox) update socket.io

0.1.1 (2016-10-23)

• (bluefox) update some packages

0.1.0 (2016-08-01)

• (bluefox) support of read/write files