API

Aperçu

Définition de l'API DALION.

Tout langage de programmation capable d'envoyer des requêtes HTTP GET peut interagir avec les lampes DALI via le DALION.

Les données sont transférées au format JSON et avec des paramètres URL.

Par exemple, les requêtes HTTP GET peuvent être envoyées via un script de ligne de commande à l'aide de la commande cURL.

curl -X "GET" "http://192.168.0.210/api/v100/dali_devices.ssi?action=set_level&ch=1&sa=3&da=1000"

Requêtes

Modifie l'intensité lumineuse de lampe, groupe ou canal

Permets de modifier l'intensité lumineuse d'une lampe ou de plusieurs lampes.

Cette requête utilise l'adresse courte DALI de la lampe. L'adresse courte d'un index de lampe peut être récupérée avec la requête get ou get_device.

Pour modifier l'intensité lumineuse d'une lampe avec son index de lampe, la requête set_device doit être utilisée.

URL de la requête

/api/v100/dali_devices.ssi?action=set_level&ch={channel}&sa={short-address}&da={value-in-percent}

Paramètres

Nom	Valeur
action	set_level
ch	Le numéro du canal DALI, 1-4
sa	L'adresse courte DALI, 0-63. Plusieurs adresses peuvent être transmises dans un tableau [sa, sa, ...]. Le tableau doit être encodé au format URL.
gi	Le groupe DALI, 0-15 ou -1 pour le canal. Plusieurs groupes peuvent être passés dans un tableau [gi, gi, ...]. Le tableau doit être encodé au format URL.
da	La valeur en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

Exemples

Modifie à 100 % l'intensité lumineuse de la lampe DALI avec l'adresse courte 3 sur le canal 1.

/api/v100/dali_devices.ssi?action=set_level&ch=1&sa=3&da=1000

Modifie à 100 % l'intensité lumineuse du groupe DALI 3 sur le canal 1.

/api/v100/dali_devices.ssi?action=set_level&ch=1&gi=3&da=1000

Modifie à 70% l'intensité lumineuse des groupes 1 et 10 sur le canal 1.

/api/v100/dali_devices.ssi?action=set_level&ch=1&gi=%5B1%2C%2010%5D&da=700

Modifie à 20 % l'intensité lumineuse de l'ensemble du canal DALI 1.

/api/v100/dali_devices.ssi?action=set_level&ch=1&gi=-1&da=200

Obtenir la liste des lampes et des dispositifs d'entrée

Permet de récupérer la liste des appareils DALI d'un canal.

URL de la requête

/api/v100/dali_devices.ssi?action=get&ch={channel}

Paramètres

Nom	Valeur
action	get
ch	Le numéro du canal DALI, 1-4

Réponse

La liste des lampes DALI assignées et non assignées, la liste des dispositifs d'entrée DALI-2 assignée et non assignée.

{
 "type": "dali_devices",
 "action": "get",
 "data": {
  "status": 0,
  "mode": 0,
  "devices": {
   "devices": [{
    "ii": "0",
    "na": "Lamp 1-00",
    "sa": 3,
    "fl": 1,
    "dt": [6, 255],
    "al": 0,
    "si": 0
   }]
  },
  "unassigned_devices": {
   "devices": []
  },
  "control_devices": {
   "devices": [{
    "ii": "0",
    "na": "Input 1-00",
    "sa": 1,
    "fl": 1,
    "it": "26",
    "dt": 0,
    "al": 0,
    "si": 32,
    "os": 255,
    "ls": 52
   }, {
    "ii": "1",
    "na": "Input 1-01",
    "sa": 3,
    "fl": 1,
    "it": "27",
    "dt": 0,
    "al": 0,
    "si": 32,
    "os": 0,
    "ls": 128
   }]
  },
  "unassigned_control_devices": {
   "devices": []
  }
 }
}

action

get

data

Contient les listes d'appareils DALI.

status

Valeur	Description
0	La recherche de lampes est actuellement inactive
1	La recherche de lampes a été lancée et certaines commandes peuvent ne pas être disponibles

mode

Value	Description
0	Le canal DALI est disponible
1	Les commandes affectant les lampes DALI sont désactivées

devices

Contient la liste des lampes assignées.

devices

La liste des lampes assignées.

ii

L'index de la lampe, 0-63.

na

Le nom de la lampe.

sa

L'adresse courte DALI de la lampe.

fl

Les drapeaux de la lampe.

Valeur	Description
0	Aucune lampe assignée pour cet index
1	Une lampe est assignée pour cet index

dt

Un tableau des types d'appareils DALI pris en charge par la lampe.

Valeur	Nom
0	Fluorescent
1	Self-contained emergency
2	Discharge HID
3	Low-voltage halogen
4	Incandescent lamp
5	Conversion to DC voltage
6	LED
7	Switching relay
8	Colour
255	Non spécifié

al

L'intensité lumineuse actuelle de la lampe en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

si

Les informations d'état actuel de la lampe.

La valeur 255 signifie un échec de communication avec la lampe. Sinon, lorsque le bit 2 est défini, cela signifie que la lampe a un problème. Les autres valeurs signifient que la lampe fonctionne normalement.

unassigned_devices

La liste des lampes non assignées et découvertes après une recherche.

control_devices

La liste des dispositifs d'entrée DALI-2.

it

Le type d'instances pris en charge par le dispositif d'entré. Chaque bit indique si un type est pris en charge ou non.

Bit	Type
1	Buttons
3	Détecteur d'occupation
4	Détecteur de luminosité

os

L'état d'occupation actuel du détecteur.

Valeur	Nom
0	Inoccupé
255	Occupé

ls

La valeur lumineuse actuelle du détecteur.

unassigned_control_devices

La liste des dispositifs d'entrée DALI-2 non assignés et découverts après recherche.

Exemples

Obtiens les appareils DALI du premier canal.

/api/v100/dali_devices.ssi?action=get&ch=1

Information d'une lampe

Permet de récupérer les informations d'une lampe.

URL de la requête

/api/v100/dali_devices.ssi?action=get_device&ch={channel}&di={device-index}

Paramètres

Nom	Valeur
action	get_device
ch	Le numéro du canal DALI, 1-4
di	L'index de la lampe, 0-63

Réponse

La réponse contient les valeurs ainsi que d'autres informations telles que la limitation des valeurs, les noms, etc.

{
 "type": "dali_devices",
 "action": "get_device",
 "data": {
  "device": {
   "name": "Lamp 1-00",
   "types": ["6", "255"],
   "variables": [{
    "ty": "nb10",
    "id": "dval",
    "tx": "Actual Level %",
    "va": "0",
    "ph": "",
    "mi": "0",
    "ma": "1000",
    "st": "1"
   }, {
    "ty": "tx",
    "id": "na",
    "tx": "Name",
    "va": "Lamp 1-00",
    "ph": ""
   }, {
    "ty": "nb10",
    "id": "dvpl",
    "tx": "Power On Level %",
    "va": "1000",
    "ph": "MASK",
    "mi": "0",
    "ma": "1000",
    "st": "1"
   }, {
    "ty": "nb10",
    "id": "dvsl",
    "tx": "System Failure Level %",
    "va": "1000",
    "ph": "MASK",
    "mi": "0",
    "ma": "1000",
    "st": "1"
   }, {
    "ty": "nb10",
    "id": "dvnl",
    "tx": "Minimum Level %",
    "va": "1",
    "ph": "",
    "mi": "1",
    "ma": "1000",
    "st": "1"
   }, {
    "ty": "nb10",
    "id": "dvxl",
    "tx": "Maximum Level %",
    "va": "1000",
    "ph": "",
    "mi": "10",
    "ma": "1000",
    "st": "1"
   }, {
    "ty": "se",
    "id": "dvfr",
    "tx": "Fade Rate steps/s",
    "va": "7",
    "op": [{
     "va": 1,
     "tx": "358"
    }, {
     "va": 2,
     "tx": "253"
    }, {
     "va": 3,
     "tx": "179"
    }, {
     "va": 4,
     "tx": "127"
    }, {
     "va": 5,
     "tx": "89.4"
    }, {
     "va": 6,
     "tx": "63.3"
    }, {
     "va": 7,
     "tx": "44.7"
    }, {
     "va": 8,
     "tx": "31.6"
    }, {
     "va": 9,
     "tx": "22.4"
    }, {
     "va": 10,
     "tx": "15.8"
    }, {
     "va": 11,
     "tx": "11.2"
    }, {
     "va": 12,
     "tx": "7.9"
    }, {
     "va": 13,
     "tx": "5.6"
    }, {
     "va": 14,
     "tx": "4.0"
    }, {
     "va": 15,
     "tx": "2.8"
    }]
   }, {
    "ty": "se",
    "id": "dvft",
    "tx": "Fade Time seconds",
    "va": "0",
    "op": [{
     "va": 0,
     "tx": "No fade"
    }, {
     "va": 1,
     "tx": "0.7"
    }, {
     "va": 2,
     "tx": "1.0"
    }, {
     "va": 3,
     "tx": "1.4"
    }, {
     "va": 4,
     "tx": "2.0"
    }, {
     "va": 5,
     "tx": "2.8"
    }, {
     "va": 6,
     "tx": "4.0"
    }, {
     "va": 7,
     "tx": "5.7"
    }, {
     "va": 8,
     "tx": "8.0"
    }, {
     "va": 9,
     "tx": "11.3"
    }, {
     "va": 10,
     "tx": "16.0"
    }, {
     "va": 11,
     "tx": "22.6"
    }, {
     "va": 12,
     "tx": "32.0"
    }, {
     "va": 13,
     "tx": "45.3"
    }, {
     "va": 14,
     "tx": "64.0"
    }, {
     "va": 15,
     "tx": "90.5"
    }]
   }, {
    "ty": "nb",
    "id": "dvgr",
    "tx": "Groups",
    "va": "0",
    "ph": "",
    "mi": "0",
    "ma": "65535",
    "st": "1"
   }, {
    "ty": "nb",
    "id": "dvsa",
    "tx": "Short Address",
    "va": "1",
    "ph": "",
    "mi": "0",
    "ma": "63",
    "st": "1"
   }, {
    "ty": "nb",
    "id": "dvrh",
    "tx": "Run Hours (seconds)",
    "va": "7440",
    "ph": "",
    "mi": "0",
    "ma": "2147483647",
    "st": "1"
   }, {
    "ty": "nb",
    "id": "dvbi",
    "tx": "Burn-In (seconds)",
    "va": "0",
    "ph": "",
    "mi": "0",
    "ma": "2147483647",
    "st": "1"
   }, {
    "ty": "lt",
    "id": "bo",
    "tx": "BACnet Object",
    "va": "Analog Output/Input 0"
   }, {
    "ty": "lt",
    "id": "re",
    "tx": "Reliability",
    "va": "0 (no-fault-detected)"
   }]
  }
 }
}

action

get_device

data

Contient les informations de la lampe DALI.

name

Le nom de la lampe.

types

Un tableau des types d'appareils DALI pris en charge par la lampe.

Valeur	Nom
0	Fluorescent
1	Self-contained emergency
2	Discharge HID
3	Low-voltage halogen
4	Incandescent lamp
5	Conversion to DC voltage
6	LED
7	Switching relay
8	Colour
255	Non spécifié

variables

Un tableau des variables de la lampe.

id

dval

L'intensité lumineuse actuelle en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

na

Le nom de la lampe.

dvpl

L'intensité lumineuse de Power On Level en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

dvsl

L'intensité lumineuse de System Failure Level en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

dvnl

L'intensité lumineuse de Minimum Level en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

dvxl

L'intensité lumineuse de Maximum Level en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

dvfr

La valeur de Fade Rate.

Valeur	Fade Rate (steps/secondes)
1	358
2	253
3	179
4	127
5	89.4
6	63.3
7	44.7
8	31.6
9	22.4
10	15.8
11	11.2
12	7.9
13	5.6
14	4.0
15	2.8

dvft

La valeur de Fade Time.

Valeur	Fade Time (secondes)
0	No fade
1	0.7
2	1.0
3	1.4
4	2.0
5	2.8
6	4.0
7	5.7
8	8.0
9	11.3
10	16.0
11	22.6
12	32.0
13	45.3
14	64.0
15	90.5

dvgr

Représente les variables DALI « GROUP_0_8 » et « GROUP_9_15 » concaténées en 16 bits.

dvsa

L'adresse courte DALI de la lampe.

dvrh

Nombre de secondes pendant lesquelles la lampe était allumée.

dvbi

Nombre de secondes restantes au burn-in.

bo

L'objet BACnet associé à la lampe.

re

La fiabilité de la lampe.

Examples

Obtient la lampe 0 pour le canal 1.

/api/v100/dali_devices.ssi?action=get_device&ch=1&di=0

Modifie l'information d'une lampe

Permet de modifier les informations d'une lampe, d'un groupe ou d'un canal.

URL de la requête

/api/v100/dali_devices.ssi?action=set_device&ch={channel}&di={device-index}&device={device-data}

Paramètres

Nom	Valeur
action	set_device
ch	Le numéro du canal DALI, 1-4
di	L'index de la lampe, 0-63
gi	Le groupe DALI, 0-15 ou -1 pour le canal
device	La variable de la lampe à modifier. Plusieurs variables peuvent être passées dans un tableau [data, data, ...]. Le tableau doit être encodé au format URL.

device

Tableau des informations sur la lampe à modifier. Le tableau doit être encodé au format URL.

id

Fait référence à l'identifiant id de la requête get_device.

va

Fait référence à la valeur value de la requête get_device.

Utilise le même type de données que la valeur de la requête get_device. La plupart des valeurs sont du type string.

Réponse

{
 "type": "dali_devices",
 "action": "set_device",
 "data": {
  "type": "sni",
  "result": "success",
  "result_code": 0
 }
}

Exemples

Définit le nom de la lampe 0 pour le canal 1.

/api/v100/dali_devices.ssi?action=set_device&ch=1&di=0&device=[{%22id%22:%22na%22,%22va%22:%22Lamp-00%22}]

Définit le nom du groupe 0 pour le canal 1.

/api/v100/dali_devices.ssi?action=set_device&ch=1&gi=0&device=[{%22id%22:%22na%22,%22va%22:%22Group-00%22}]

Modifie l'intensité lumineuse actuelle à 100% pour la lampe 0 du canal 1.

/api/v100/dali_devices.ssi?action=set_device&ch=1&di=0&device=[{%22id%22:%22dval%22,%22va%22:%221000%22}]

Obtenir les groupes

Permet de récupérer les informations des groupes.

URL de la requête

/api/v100/dali_devices.ssi?action=get_groups&ch={channel}

Paramètres

Nom	Valeur
action	get_groups
ch	Le numéro du canal DALI, 1-4

Réponse

La réponse contient les valeurs ainsi que d'autres informations telles que la limitation des valeurs, les noms, etc.

{
 "type": "dali_devices",
 "action": "get_groups",
 "data": {
  "status": 0,
  "devices": {
   "devices": [{
    "ii": "0",
    "na": "Lamp 1-00",
    "fl": 1,
    "gr": 1
   }, {
    "ii": "1",
    "na": "Lamp 1-01",
    "fl": 1,
    "gr": 2
   }, {
    "ii": "2",
    "na": "Lamp 1-02",
    "fl": 1,
    "gr": 4
   }, {
    "ii": "3",
    "na": "Lamp 1-03",
    "fl": 1,
    "gr": 7
   }],
   "groups": [{
    "ii": "-1",
    "na": "Channel 1",
    "fl": 0,
    "al": 76,
    "si": 4
   }, {
    "ii": "0",
    "na": "Group 1-00",
    "fl": 0,
    "al": 50,
    "si": 4
   }, {
    "ii": "1",
    "na": "Group 1-01",
    "fl": 0,
    "al": 100,
    "si": 4
   }, {
    "ii": "2",
    "na": "Group 1-02",
    "fl": 0,
    "al": 100,
    "si": 4
   }, {
    "ii": "3",
    "na": "Group 1-03",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "4",
    "na": "Group 1-04",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "5",
    "na": "Group 1-05",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "6",
    "na": "Group 1-06",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "7",
    "na": "Group 1-07",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "8",
    "na": "Group 1-08",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "9",
    "na": "Group 1-09",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "10",
    "na": "Group 1-10",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "11",
    "na": "Group 1-11",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "12",
    "na": "Group 1-12",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "13",
    "na": "Group 1-13",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "14",
    "na": "Group 1-14",
    "fl": 0,
    "al": 0,
    "si": 0
   }, {
    "ii": "15",
    "na": "Group 1-15",
    "fl": 0,
    "al": 0,
    "si": 0
   }]
  }
 }
}

action

get_groups

data

Contient les informations des groupes DALI.

devices

La liste des lampes assignées.

ii

L'index de la lampe, 0-63.

na

Le nom de la lampe.

fl

Les drapeaux de la lampe.

Valeur	Description
0	Aucune lampe assignée pour cet index
1	Une lampe est assignée pour cet index

gr

Représente les variables DALI « GROUP_0_8 » et « GROUP_9_15 » concaténées en 16 bits.

groups

La liste des groupes.

ii

L'index de groupe, 0-15 et -1 pour le canal.

na

Le nom du groupe.

fl

Les drapeaux du groupe.

al

L'intensité lumineuse actuelle du groupe en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

si

Les informations d'état actuel du groupe.

Examples

Obtient les groupes pour le canal 1.

/api/v100/dali_devices.ssi?action=get_groups&ch=1

Obtient les scènes

Permet de récupérer les informations des scènes.

URL de la requête

/api/v100/dali_devices.ssi?action=get_scenes&ch={channel}

Paramètres

Nom	Valeur
action	get_scenes
ch	Le numéro du canal DALI, 1-4

Réponse

La réponse contient les valeurs de scènes pour chaque lampe assignée ainsi que d'autres informations sur les lampes comme leurs noms.

{
 "type": "dali_devices",
 "action": "get_scenes",
 "data": {
  "status": 0,
  "devices": {
   "devices": [{
    "ii": "0",
    "na": "Lamp 1-00",
    "fl": 1,
    "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
   }, {
    "ii": "1",
    "na": "Lamp 1-01",
    "fl": 1,
    "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
   }, {
    "ii": "2",
    "na": "Lamp 1-02",
    "fl": 1,
    "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
   }, {
    "ii": "3",
    "na": "Lamp 1-03",
    "fl": 1,
    "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
   }]
  }
 }
}

action

get_scenes

data

Contient les informations sur les scènes DALI.

devices

La liste des lampes.

ii

L'index de la lampe, 0-63.

na

Le nom de la lampe.

fl

Les drapeaux de la lampe.

Valeur	Description
0	Aucune lampe assignée pour cet index
1	Une lampe est assignée pour cet index

sn

Un tableau des valeurs pour les 16 scènes. L'intensité lumineuse de chaque scène en pourcentage multipliée par 10. Par exemple ; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

Exemples

Obtient les scènes pour le canal 1.

/api/v100/dali_devices.ssi?action=get_scenes&ch=1

Modifie les scènes

Permet de modifier les scènes.

URL de la requête

/api/v100/dali_devices.ssi?action=set_scenes&ch={channel}&devices={data}

Paramètres

Nom	Valeur
action	set_scenes
ch	Le numéro du canal DALI, 1-4
devices	Les données de scène pour chaque lampe

devices

Contient les valeurs de scène pour chaque lampe assignées.

{
 "devices": [{
  "ii": "0",
  "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
 }, {
  "ii": "1",
  "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
 }, {
  "ii": "2",
  "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
 }, {
  "ii": "3",
  "sn": [1000, 100, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1]
 }]
}

ii

L'index de la lampe, 0-63.

sn

Un tableau des valeurs pour les 16 scènes. L'intensité lumineuse de chaque scène en pourcentage multipliée par 10. Par exemple ; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %. Une valeur de -1 représente DALI MASK.

Exemples

Définit les scènes pour le canal 1.

/api/v100/dali_devices.ssi?action=set_scenes&ch=1&devices=%7B%22devices%22%3A%5B%7B%22ii%22%3A%220%22%2C%22na%22%3A%22Lamp-00%22%2C%22fl%22%3A1%2C%22sn%22%3A%5B1000%2C100%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%5D%7D%2C%7B%22ii%22%3A%221%22%2C%22na%22%3A%22Lamp%201-01%22%2C%22fl%22%3A1%2C%22sn%22%3A%5B1000%2C100%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%5D%7D%2C%7B%22ii%22%3A%222%22%2C%22na%22%3A%22Lamp%201-02%22%2C%22fl%22%3A1%2C%22sn%22%3A%5B1000%2C100%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%5D%7D%2C%7B%22ii%22%3A%223%22%2C%22na%22%3A%22Lamp%201-03%22%2C%22fl%22%3A1%2C%22sn%22%3A%5B1000%2C100%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%2C-1%5D%7D%5D%7D

Commande de scène des groupes et des canaux

Grâce à cette requête, les scènes peuvent être rappelées, enregistrées ou supprimées.

URL de la requête

/api/v100/dali_devices.ssi?action=recall_scene&ch={channel}&gi={group-index}&si={scene-index}

Paramètres

Nom	Valeur
action	recall_scene, store_scene ou delete_scene
ch	Le numéro du canal DALI, 1-4
gi	Le groupe DALI, 0-15 ou -1 pour le canal. Plusieurs groupes peuvent être passés dans un tableau [gi, gi, ...]. Le tableau doit être encodé au format URL.
si	L'index de la scène DALI, 0-15

Exemples

Rappelle la scène 2 pour le groupe 10 sur le canal 1.

/api/v100/dali_devices.ssi?action=recall_scene&ch=1&gi=10&si=2

Enregistre la scène 2 pour le groupe 10 sur le canal 1.

/api/v100/dali_devices.ssi?action=store_scene&ch=1&gi=10&si=2

Supprime la scène 2 pour le groupe 10 sur le canal 1.

/api/v100/dali_devices.ssi?action=delete_scene&ch=1&gi=10&si=2

Modifie la couleur de lampe, groupe ou canal DT8

Permet de modifier la couleur d'une lampe ou de plusieurs lampes de type DALI 8.

Cette requête utilise l'adresse courte DALI de la lampe. L'adresse courte d'un index de lampe peut être récupérée avec la requête get ou get_device.

URL de la requête

/api/v100/dali_devices.ssi?action=set_colour&ch={channel}&sa={short-address}&cid={colour-id}&ctype={colour-type}&cvalue={colour-value}

Paramètres

Nom	Valeur
action	set_colour
ch	Le numéro du canal DALI, 1-4
sa	L'adresse courte DALI, 0-63. Les adresses doivent être transmises dans un tableau [sa, sa, ...]. Le tableau doit être encodé au format URL.
gi	Le groupe DALI, 0-15 ou -1 pour le canal. Les groupes doivent être passés dans un tableau [gi, gi, ...]. Le tableau doit être encodé au format URL.
cid	La couleur à modifier
ctype	Le type de couleur
cvalue	La valeur de la couleur

cid

Indique la couleur à modifier.

Valeur	Description
d8ac	Actual Level
d8tp	Power On Level
d8tf	System Failure Level
d8s0	Scene 0
d8s1	Scene 1
d8s2	Scene 2
d8s3	Scene 3
d8s4	Scene 4
d8s5	Scene 5
d8s6	Scene 6
d8s7	Scene 7
d8s8	Scene 8
d8s9	Scene 9
d8s10	Scene 10
d8s11	Scene 11
d8s12	Scene 12
d8s13	Scene 13
d8s14	Scene 14
d8s15	Scene 15
d8tw	Warmest Tc
d8tc	Coolest Tc

ctype

Indique le type de couleur.

Valeur	Description
16	xy-coordinate
32	colour temperature Tc
64	primary N
128	RGBWAF

cvalue

Indique la valeur de la couleur. Cette valeur est au format JSON et doit être encodée au format URL.

{
 "ll": 900,
 "xx": 400,
 "xy": 65535,
 "tc": 333,
 "p0": 400,
 "p1": 65535,
 "p2": 65535,
 "p3": 65535,
 "p4": 65535,
 "p5": 65535,
 "rr": 144,
 "rg": 1,
 "rb": 255,
 "rw": 255,
 "ra": 255,
 "rf": 255,
 "ll_isMask": false,
 "xx_isMask": false,
 "xy_isMask": true,
 "tc_isMask": false,
 "p0_isMask": false,
 "p1_isMask": true,
 "p2_isMask": true,
 "p3_isMask": true,
 "p4_isMask": true,
 "p5_isMask": true,
 "rr_isMask": false,
 "rg_isMask": false,
 "rb_isMask": true,
 "rw_isMask": true,
 "ra_isMask": true,
 "rf_isMask": true
}

ll

L'intensité lumineuse actuelle de la lampe en pourcentage multipliée par 10. Par exemple; 0 = 0 %, 1 = 0,1 %, 1000 = 100 %.

xx

La valeur x, 0-65535, pour le type xy-coordinate.

xy

La valeur y, 0-65535, pour le type xy-coordinate.

tc

La valeur, 0-65535, pour le type colour temperature Tc. L'unité de la valeur est Mirek. La valeur est donnée par la formule;
M = 1 000 000 / T,
où M est la valeur Mirek, T est la température de couleur en Kelvin.

p0, p1, p2, p3, p4, p5

La valeur, 0-65535, du niveau 0, 1, 2, 3, 4 ou 5 pour le type primary N.

rr

La valeur, 0-255, du niveau de rouge pour le type RGBWAF.

rg

La valeur, 0-255, du niveau de vert pour le type RGBWAF.

rb

La valeur, 0-255, du niveau de bleu pour le type RGBWAF.

rw

La valeur, 0-255, du niveau de blanc pour le type RGBWAF.

ra

La valeur, 0-255, du niveau ambre pour le type RGBWAF.

rf

La valeur, 0-255, du niveau freecolour pour le type RGBWAF.

xx_isMask

Indique que la valeur associée est la valeur DALI MASK.

Examples

Modifie la couleur actuelle pour 4000 Kelvin pour le groupe 1 du canal 1.

/api/v100/dali_devices.ssi?&action=set_colour&ch=1&sa=%5B5%5D&cid=d8ac&ctype=32&cvalue=%7B%22ll%22%3A921%2C%22xx%22%3A250%2C%22xy%22%3A65535%2C%22tc%22%3A250%2C%22p0%22%3A250%2C%22p1%22%3A65535%2C%22p2%22%3A65535%2C%22p3%22%3A65535%2C%22p4%22%3A65535%2C%22p5%22%3A65535%2C%22rr%22%3A250%2C%22rg%22%3A0%2C%22rb%22%3A255%2C%22rw%22%3A255%2C%22ra%22%3A255%2C%22rf%22%3A255%2C%22ll_isMask%22%3Afalse%2C%22xx_isMask%22%3Afalse%2C%22xy_isMask%22%3Atrue%2C%22tc_isMask%22%3Afalse%2C%22p0_isMask%22%3Afalse%2C%22p1_isMask%22%3Atrue%2C%22p2_isMask%22%3Atrue%2C%22p3_isMask%22%3Atrue%2C%22p4_isMask%22%3Atrue%2C%22p5_isMask%22%3Atrue%2C%22rr_isMask%22%3Afalse%2C%22rg_isMask%22%3Afalse%2C%22rb_isMask%22%3Atrue%2C%22rw_isMask%22%3Atrue%2C%22ra_isMask%22%3Atrue%2C%22rf_isMask%22%3Atrue%7D