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