Remote CLI Tool
Overview
The DALION Remote CLI (command-line interface) Tool is a Windows tool to help with multiple configurations and setups of the DALION lighting controller.
Commands
A list of the available commands and parameters.
help
Lists the available commands and parameters.
Example
--help
version
Displays the tool version.
Example
--version
ip
IP address of the DALION controller.
Example
--ip 192.168.0.210
channel
DALI channel number between 1 and 4. It is possible to use a single channel or have multiple channels.
Example
# single channel
--channel 1
# multiple channels
--channel [1, 2]
channelcsvfile
This parameter is a path to a CSV (comma-separated values) file. CSV file can be created in a spreadsheet software like Microsoft Excel or directly as a text file.
It is possible to use a single channel or have multiple channels.
Example
# single channel
--channelcsvfile "[\"C:\\channel1_lamps.csv\"]"
# multiple channels
--channelcsvfile "[\"C:\\channel1_lamps.csv\", \"C:\\channel2_lamps.csv\"]"
channelgroupscsvfile
This parameter is a path to a CSV (comma-separated values) file. CSV file can be created in a spreadsheet software like Microsoft Excel or directly as a text file.
It is possible to use a single channel or have multiple channels.
Example
# single channel
--channelgroupscsvfile "[\"C:\\channel1_groups.csv\"]"
# multiple channels
--channelgroupscsvfile "[\"C:\\channel1_groups.csv\", \"C:\\channel2_groups.csv\"]"
channelinputscsvfile
This parameter is a path to a CSV (comma-separated values) file. CSV file can be created in a spreadsheet software like Microsoft Excel or directly as a text file.
It is possible to use a single channel or have multiple channels.
Example
# single channel
--channelinputscsvfile "[\"C:\\channel1_inputs.csv\"]"
# multiple channels
--channelinputscsvfile "[\"C:\\channel1_inputs.csv\", \"C:\\channel2_inputs.csv\"]"
action
Action to perform on the DALION.
| Action | Description |
|---|---|
| setup_channel | Pre-commissioning of DALI lamps |
| get_backup | Download backup files from the controller |
| put_backup | Upload backup files to the controller |
| push_firmware | Allows upgrading of the controller firmware |
firmwarefile
Path to a firmware file.
backupfileouttype
Type of backup output; directory or zip. The default value is directory.
directory
Backup files are created in the directory.
zip
A ZIP file containing all the backup is created in the directory.
backupconfig
Select the backup. By default all backups are used. Multiple configurations can be passed.
| Value | Description |
|---|---|
| systemconfig | Controller system configuration |
| dali1 | Configuration and commissioning of DALI channel 1 |
| dali2 | Configuration and commissioning of DALI channel 2 |
| dali3 | Configuration and commissioning of DALI channel 3 |
| dali4 | Configuration and commissioning of DALI channel 4 |
Example
--backupconfig "[\"systemconfig\", \"dali2\"]"
backupfileout
The directory where the backup files are copied.
Example
backupfileout "C:\backup\"
backupfilein
The ZIP or TAR configuration file to upload to the controller.
Example
backupfilein "C:\backup\backup_DALION.zip"
Channel Lamps CSV File Format
The format of the CSV file is as follows.
#DALION DALI CHANNEL CSV,,,,,,,,,,,
#dali-channel-csv-version: 1,,,,,,,,,,,
#channel,lampIndex,shortAddress,name,groups,powerOnLevel,systemFailureLevel,minLevel,maxLevel,fadeRate,fadeTime,scenes
4,1,1,AABBCC,"[1,4]",10,30,0.1,100,4,2,"[100, 20, null, 80]"
First line
File description.
#DALION DALI CHANNEL CSV,,,,,,,,,,,
Second line
File content version. The version number should be 1.
#dali-channel-csv-version: 1,,,,,,,,,,,
Third line
File content header. Should have the following columns.
#channel,lampIndex,shortAddress,name,groups,powerOnLevel,systemFailureLevel,minLevel,maxLevel,fadeRate,fadeTime,scenes
| Column |
|---|
| channel |
| lampIndex |
| shortAddress |
| name |
| groups |
| powerOnLevel |
| systemFailureLevel |
| minLevel |
| maxLevel |
| fadeRate |
| fadeTime |
| scenes |
Columns
The lamp data columns.
channel
The DALI channel number of the DALION, starting at zero (0).
lampIndex
The DALI lamp index in the DALION starting at zero (0). Number between 0 and 63.
shortAddress
The DALI lamp short address between 0 and 63. A value of null can be used not to modify the short address.
name
The name of the DALI lamp that will appear in the DALION and BACnet network.
groups
The DALI groups that the lamp takes part of. The format is "[GROUP_NUMBER, GROUP_NUMBER]". Replace GROUP_NUMBER by any group number between 0 and 15.
DALI default value is "[]".
powerOnLevel
The DALI lamp parameter "POWER ON LEVEL" in percent. For DALI MASK use the value null.
DALI default value is 100.
systemFailureLevel
The DALI lamp parameter "SYSTEM FAILURE LEVEL" in percent. For DALI MASK use the value null.
DALI default value is 100.
minLevel
The DALI lamp parameter "MIN LEVEL" in percent. For DALI MASK use the value null.
maxLevel
The DALI lamp parameter "MAX LEVEL" in percent. For DALI MASK use the value null.
DALI default value is 100.
fadeRate
The DALI lamp parameter "FADE RATE". Should be a number between 1 and 15.
DALI default value is 7.
| Value | Fade Rate (steps/seconds) |
|---|---|
| 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 |
fadeTime
The DALI lamp parameter "FADE TIME". Should be a number between 0 and 15.
DALI default value is 0.
| Value | Fade Time (seconds) |
|---|---|
| 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 |
scenes
The values in percent of the different light intensity scenes of the lamp. For DALI MASK use the value null. The format is "[SCENE_VALUE, SCENE_VALUE]". Replace SCENE_VALUE by the scene value in percent. Each index represents the value of the scene X for that index.
DALI default value is "[]".
Channel Groups CSV File Format
The format of the CSV file is as follows.
#DALION DALI CHANNEL GROUPS CSV,,
#dali-channel-groups-csv-version: 1,,
#channel,groupIndex,name
0,0,"DALI 1-4-BD1-G0"
First line
File description.
#DALION DALI CHANNEL GROUPS CSV,,
Second line
File content version. The version number should be 1.
#dali-channel-groups-csv-version: 1,,
Third line
File content header. Should have the following columns.
#channel,groupIndex,name
| Column |
|---|
| channel |
| groupIndex |
| name |
Columns
The group data columns.
channel
The DALI channel number of the DALION, starting at zero (0).
groupIndex
The DALI group index in the DALION starting at zero (0). Number between 0 and 15.
name
The name of the DALI group that will appear in the DALION and BACnet network.
Channel Inputs CSV File Format
The format of the CSV file is as follows.
#DALION DALI CHANNEL INPUTS CSV,,,,,,,,,,,,,,,,,,
#dali-channel-inputs-csv-version: 1,,,,,,,,,,,,,,,,,,
#channel,inputIndex,shortAddress,name,numberOfInstances,instancesType,instancesResolution,instancesClassButtonRepeatTime,instancesClassButtonOptions,instancesClassButtonPressTime,instancesClassButtonDestination,instancesClassButtonCommand,instancesClassButtonValue1,instancesClassButtonValue2,instancesClassOccupancySensorHoldTime,instancesClassOccupancySensorDeadTime,instancesClassOccupancySensorReportTime,instancesClassLightSensorHysteresis,instancesClassLightSensorHysteresisMin
0,1,7,Input Button 1,7,"[1, 1, 1, 1, 1, 1, 1]","[0, 0, 0, 0, 0, 0, 0]","[1, 1, 1, 1, 1, 1, 1]","[0, 0, 0, 0, 0, 0, 0]","[0, 0, 0, 0, 0, 0, 0]","[1, 1, 1, 1, 1, 1, 1]","[1, 1, 1, 1, 1, 1, 1]","[0, 0, 0, 0, 0, 0, 0]","[0, 0, 0, 0, 0, 0, 0]",[],[],[],[],[]
First line
File description.
#DALION DALI CHANNEL INPUTS CSV,,,,,,,,,,,,,,,,,,
Second line
File content version. The version number should be 1.
#dali-channel-inputs-csv-version: 1,,,,,,,,,,,,,,,,,,
Third line
File content header. Should have the following columns.
#channel,inputIndex,shortAddress,name,numberOfInstances,instancesType,instancesResolution,instancesClassButtonRepeatTime,instancesClassButtonOptions,instancesClassButtonPressTime,instancesClassButtonDestination,instancesClassButtonCommand,instancesClassButtonValue1,instancesClassButtonValue2,instancesClassOccupancySensorHoldTime,instancesClassOccupancySensorDeadTime,instancesClassOccupancySensorReportTime,instancesClassLightSensorHysteresis,instancesClassLightSensorHysteresisMin
| Column |
|---|
| channel |
| inputIndex |
| shortAddress |
| name |
| numberOfInstances |
| instancesType |
| instancesResolution |
| instancesClassButtonRepeatTime |
| instancesClassButtonOptions |
| instancesClassButtonPressTime |
| instancesClassButtonDestination |
| instancesClassButtonCommand |
| instancesClassButtonValue1 |
| instancesClassButtonValue2 |
| instancesClassOccupancySensorHoldTime |
| instancesClassOccupancySensorDeadTime |
| instancesClassOccupancySensorReportTime |
| instancesClassLightSensorHysteresis |
| instancesClassLightSensorHysteresisMin |
Columns
The input data columns.
channel
The DALI channel number of the DALION, starting at zero (0).
inputIndex
The DALI input index in the DALION starting at zero (0). Number between 0 and 31.
shortAddress
The DALI lamp short address between 0 and 63. A value of null can be used not to modify the short address.
name
The name of the DALI input that will appear in the DALION and BACnet network.
numberOfInstances
The number of instances.
instancesType
The type of instance. The format is "[INSTANCE_TYPE, INSTANCE_TYPE]". Replace INSTANCE_TYPE by one of the following supported instance type numbers.
| Name | Number |
|---|---|
| Push-Button | 1 |
| Occupancy Sensor | 3 |
| Light Sensor | 4 |
instancesResolution
The instance resolution number. The format is "[INSTANCE_RESOLUTION, INSTANCE_RESOLUTION]". Replace INSTANCE_RESOLUTION by the instance resolution number.
instancesClassButtonRepeatTime
For push-button. The instance repeat time. The format is "[REPEAT_TIME, REPEAT_TIME]". Replace REPEAT_TIME by the instance repeat time.
instancesClassButtonOptions
For push-button. The instance options. The format is "[OPTIONS, OPTIONS]". Replace OPTIONS by the instance options.
instancesClassButtonPressTime
For push-button. The instance press time. The format is "[PRESS_TIME, PRESS_TIME]". Replace PRESS_TIME by the instance press time.
instancesClassButtonDestination
For push-button. The instance destination. The format is "[DESTINATION, DESTINATION]". Replace DESTINATION by the instance destination.
instancesClassButtonCommand
For push-button. The instance command. The format is "[COMMAND, COMMAND]". Replace COMMAND by the instance command.
instancesClassButtonValue1
For push-button. The instance value 1. The format is "[VALUE_1, VALUE_1]". Replace VALUE_1 by the instance value 1.
instancesClassButtonValue2
For push-button. The instance value 2. The format is "[VALUE_2, VALUE_2]". Replace VALUE_2 by the instance value 2.
instancesClassOccupancySensorHoldTime
For occupancy sensor. The instance hold time. The format is "[HOLD_TIME, HOLD_TIME]". Replace HOLD_TIME by the instance hold time.
instancesClassOccupancySensorDeadTime
For occupancy sensor. The instance dead time. The format is "[DEAD_TIME, DEAD_TIME]". Replace DEAD_TIME by the instance dead time.
instancesClassOccupancySensorReportTime
For occupancy sensor. The instance report time. The format is "[REPORT_TIME, REPORT_TIME]". Replace REPORT_TIME by the instance report time.
instancesClassLightSensorHysteresis
For light sensor. The instance hysteresis. The format is "[HYSTERESIS, HYSTERESIS]". Replace HYSTERESIS by the instance hysteresis.
instancesClassLightSensorHysteresisMin
For light sensor. The instance hysteresis minimum. The format is "[HYSTERESIS_MIN, HYSTERESIS_MIN]". Replace HYSTERESIS_MIN by the instance hysteresis minimum.
Example of command
DALI Pre-comminising configuration
To perform offline pre-commissioning of DALI lamps of a channel the following parameters are used.
| Parameters | Value |
|---|---|
| action | setup_channel |
| ip | IP address of the controller |
| channel | Channel to modify |
| channelcsvfile | CSV file for the DALI lamps |
| channelgroupscsvfile | CSV file for the DALI groups |
| channelinputscsvfile | CSV file for the DALI inputs |
Example
lwgwu-cli.exe --action setup_channel --ip 192.168.0.210 --channel 1 --channelcsvfile "[\"C:\\channel1.csv\"]"
Download Backup
To download the backup files from the controller the following parameters are used.
| Parameters | Value |
|---|---|
| action | get_backup |
| ip | IP address of the controller |
| backupfileouttype | Type of backup output |
| backupconfig | Backup config files to download |
| backupfileout | Directory where the backup is copied |
Example
lwgwu-cli.exe --action get_backup --ip 192.168.0.210 --backupfileouttype zip --backupfileout "C:\\backup\\"
Upload Backup
To upload a backup file to the controller the following parameters are used.
| Parameters | Value |
|---|---|
| action | put_backup |
| ip | IP address of the controller |
| backupfilein | Path to the backup file to upload |
Example
lwgwu-cli.exe --action put_backup --ip 192.168.0.210 --backupfilein "C:\\backup\\backup_DALI-ON.zip"
Firmware Upgrade
- MAKE SURE THE DALION HAS A STABLE POWER SUPPLY DURING THE FIRMWARE UPGRADE.
- DO NOT REMOVE THE POWER SUPPLY FROM THE DALION DURING THE FIRMWARE UPGRADE.
To upgrade the firmware of the controller the following parameters are used.
| Parameters | Value |
|---|---|
| action | push_firmware |
| ip | IP address of the controller |
| firmwarefile | Path to the firmware file to upload |
Example
lwgwu-cli.exe --action push_firmware --ip 192.168.0.210 --firmwarefile "C:\\firmware\\DALION_1.0.0.bin"