Configuration
La configuration de l'interface de commande vocale est effectuée en téléchargeant un fichier texte au format JSON (codage de caractères UTF-8) sur le serveur GIRA HomeServer. Il est recommandé de créer ou d'éditer le fichier de configuration à l'aide d'un éditeur de texte tel que Notepad ++ et de le copier / coller dans la zone de texte de saisie de la page de configuration du serveur HomeServer.N'oubliez pas de conserver une copie de sauvegarde du fichier de configuration dans un emplacement séparé (extension de fichier .js) sur votre lecteur local.
• Edit: pour modifier/télécharger la configuration.• Show: affiche la configuration sans commentaires pour vous permettre de vérifier la syntaxe avec JSON-Lint en cas de problème.
• Example: montre un exemple de configuration.
Remarque: pour activer les modifications dans le fichier de configuration, il est nécessaire de rechercher les périphériques (exécuter la découverte) dans la compétence respective après avoir chargé / enregistré la configuration (cliquez sur "Enregistrer la configuration JSON") sur le serveur GIRA HomeServer.
Dans la compétence Smart Home, vous pouvez le faire via "Alexa App-> Smart Home-> Appareils-> Recherche" ou avec la commande vocale "Alexa, lancez la découverte".
1. Notation JSON
La configuration des périphériques est effectuée au format JSON (voir également Wikipedia: Notation d'objets JavaScript).Exemple:
(En supposant l'utilisation d'adresses de groupe à 3 niveaux, les adresses de groupe doivent bien sûr être remplacées par vos propres valeurs.)
{
"devices":
[
{ "room":"salon", "targetTemperature":"2/1/1", "actualTemperature":"2/1/2",
"appliances":
[
{"name":"plafonnier", "onOff":"1/1/1", "percent":"1/1/2", "aliases":["salon lumière"]},
{"name":"lampadaire", "onOff":"1/1/3"}
]
},
{ "room":"cuisine", "targetTemperature":"2/2/1", "actualTemperature":"2/2/2",
"appliances":
[
{"name":"lumière", "onOff":"1/2/1"}
]
}
]
}
2. Définition du périphérique
Les périphériques contrôlables sont configurés dans la section "devices": [] du fichier de configuration. Ici, vous liez également les objets utilisés dans les commandes vocales aux adresses de groupe des objets KNX respectifs.La configuration comporte deux niveaux: "Niveau 1 - Salle" définit les étiquettes de Room (désignant les Room, les zones ou les localités) utilisées dans les commandes vocales. Dans le sous-niveau "Level 1.1 - devices" vous définissez les appareils/appareils (actionneurs, capteurs, ...) dans une pièce spécifique.
2.1 Niveau 1 - Room
Exemple:{ "room":"salon", "targetTemperature":"2/1/1", "actualTemperature":"2/1/2" }, ...
Ce niveau prend en charge les attributs suivants:
| Attribute Name | Attribute Value | Data Type | Example | Notes |
|---|---|---|---|---|
| id | ID | String | "LR" | Optional - the provided string must be unique within "Level 1 - Room". By providing a manual ID the automatically generated value can be overridden. |
| room | Room Name | String | "Living Room" | Name of the room/area/locality. If you would like to define global/non-location specific objects omit this attribute. |
| targetTemperature | Target Temperature | KNX group address 16-Bit (-671088,64..670760,96/EIS 5) | "2/1/1" | KNX group address to set and retrieve the target/setpoint temperature - note that some room controllers require two separate KNX objects for this - this is not supported at the moment but you may be able to set the target value's read attribute in ETS to work around this issue. Also, no decimal temperature values are supported by Alexa in English language, only whole numbers. Alexa, set the Living Room to 21 degrees.
Alexa, what is the thermostat in the Living Room set to?
|
| actualTemperature | Current Temperature | KNX group address 16-Bit (-671088,64..670760,96/EIS 5) | "2/1/2" | KNX group address to check the current temperature in the room.
Alexa, what is the temperature in the Living Room.
|
| control | Call logic sub-module | KNX group address 14-Byte Text | "5/2/1" | The possible voice commands depend on the supporting logic sub-module. |
| appliances | List of devices | Array | [...] | Initiates the definitions section for "Level 1.1 - Appliances". |
2.1.1 Level 1.1 - Appliances
Example:{"name":"Ceiling Light", "onOff":"1/1/1", "percent":"1/1/2", "aliases":["Living Room Light"]}, ...
This level supports the following attributes:
| Attribute Name | Attribute Value | Data Type | Example | Notes |
|---|---|---|---|---|
| id | ID | String | "LI1" | Optional - the provided string must be unique within "Level 1.1 - Appliances". By providing a manual ID the automatically generated value can be overridden. |
| name | Device Name (object name) | String | "Light" |
Name of the device/appliance (object). If the Room Name (attribute "room" in the level above) is not empty it will be appended to the Device Name.
Alexa, turn on the Ceiling Light in the Living Room.
|
| onOff | used for turn on/off command | KNX group address | "1/1/1" | KNX group address that will be set to "onValue" when switching on and to "offValue" when switching off. When using onOff the two subsequent attributes are ignored.
Alexa, turn on the Ceiling Light in the Living Room.
Alexa, turn off the Ceiling Light in the Living Room.
|
| on | used for turn on command | KNX group address | "1/1/1" | KNX group address that will be set to "onValue" when switching on. Alexa, turn on the Ceiling Light in the Living Room.
|
| off | used for turn off command | KNX group address | "1/1/1" | KNX group address that will be set to "offValue" when switching off. Alexa, turn off the Ceiling Light in the Living Room.
|
| onValue | On Value | Number | "1" |
If the default value of "1" is not suitable it can be changed here. The KNX groupp address set under "onOff" or "on" will be set to this value for a turn on command. |
| offValue | Off Value | Number | "0" |
If the default value of "0" is not suitable it can be changed here. The KNX groupp address set under "onOff" or "off" will be set to this value for a turn off command. |
| percent | Percentage Control | KNX group address 8-Bit (0..100%/EIS 6) | "1/1/2" | KNX group address used for the percentage control of the device. Alexa, set the Ceiling Light in the Living Room to 50 percent.
Alexa, dim the Ceiling Light in the Living Room by 10 percent.
Alexa, increase the Ceiling Light in the Living Room by 10 percent.
|
| control | Call logic sub-module | KNX group address 14-Byte Text | "5/2/1" | The possible voice commands depend on the respective logic sub-module. |
| aliases | List of Aliases | Array | [...] |
List of alternative names for this device. Caution: The room name is NOT appended to alias names! |