PyroniaDE / iobrokerAdapter

MIT License
0 stars 0 forks source link

Logo

ioBroker cloud adapter

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

NPM version Downloads

NPM

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.

Intro

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:

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:

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:

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:

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. Configuration

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

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.7.1 (2018-09-07)

2.7.0 (2018-06-18)

2.6.2 (2018-06-18)

2.6.1 (2018-05-04)

2.5.0 (2018-03-17)

2.4.7 (2018-02-09)

2.4.6 (2018-02-09)

2.4.5 (2018-01-29)

2.4.4 (2018-01-20)

2.4.2 (2018-01-20)

2.2.0 (2017-12-22)

2.1.1 (2017-12-11)

2.1.0 (2017-12-06)

2.0.8 (2017-11-28)

2.0.7 (2017-10-29)

2.0.6 (2017-10-26)

2.0.5 (2017-09-26)

2.0.4 (2017-09-12)

1.0.8 (2017-07-13)

1.0.7 (2017-06-26)

1.0.3 (2017-05-23)

1.0.2 (2017-05-23)

1.0.0 (2017-05-22)

0.8.2 (2017-04-24)

0.7.1 (2017-04-05)

0.7.0 (2017-04-01)

0.6.12 (2017-03-26)

0.6.11 (2017-03-20)

0.6.10 (2017-03-03)

0.6.9 (2017-02-17)

0.6.8 (2017-02-16)

0.6.7 (2017-02-14)

0.6.5 (2017-02-06)

0.6.3 (2017-01-28)

0.6.2 (2017-01-25)

0.6.1 (2017-01-24)

0.5.0 (2017-01-20)

0.4.2 (2017-01-12)

0.4.1 (2017-01-06)

0.4.0 (2017-01-06)

0.3.3 (2017-01-02)

0.3.0 (2016-12-29)

0.2.0 (2016-12-13)

0.1.2 (2016-11-17)

0.1.1 (2016-10-23)

0.1.0 (2016-08-01)