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 NameAttribute ValueData TypeExampleNotes
idIDString"LR" Optional - the provided string must be unique within "Level 1 - Room".
By providing a manual ID the automatically generated value can be overridden.
roomRoom NameString"Living Room" Name of the room/area/locality.
If you would like to define global/non-location specific objects omit this attribute.
targetTemperatureTarget TemperatureKNX 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?
actualTemperatureCurrent TemperatureKNX 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.
controlCall logic
sub-module
KNX group address
14-Byte Text
"5/2/1" The possible voice commands depend on the supporting logic sub-module.
appliancesList of devicesArray[...] 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 NameAttribute ValueData TypeExampleNotes
idIDString"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.
nameDevice 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.
onOffused 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.
onused 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.
offused 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.
onValueOn ValueNumber"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.
offValueOff ValueNumber"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.
percentPercentage ControlKNX 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.
controlCall logic
sub-module
KNX group address
14-Byte Text
"5/2/1" The possible voice commands depend on the respective logic sub-module.
aliasesList of AliasesArray[...] List of alternative names for this device.
Caution: The room name is NOT appended to alias names!