This page is a
translated version of the page
Domintell and the translation is 100% complete.
iRidium for Domintell
is a set of tools for creating interfaces to control Domintell equipment
The documentation was updated on 22.8.2022
Description
iRidium for Domintell - is a set of tools for creating interfaces to control homes or offices on the basis of Domintell equipment.
iRidium for Domintell enables connection of (iOS, Android, Windows, Mac) control panels via the DETH02 interface. The number of connections is limited by DETH02 - one connection at a time. You can increase the number of connections with the help of iRidium Server.
The list of supported devices with the Domintell Light Protocol:
- DPBUT1 (BU1), DPBUT2 (BU2), DPBUT4 (BU4), DPBUT6 (BU6), DISM04 (IS4), DISM08 (IS8), DISM20 (I20)
- DPBR02 (BR2), DPBR04 (BR4), DPBR06 (BR6)
- DPBL01 (B81), DPBL02 (B82), DPBL04 (B84), DPBL06 (B86)
- DAMPLI01 (AMP)
- DINTMB01 (MBD)
- DBIR01 (BIR), DMR01 (DMR), DTRP01 (TRP), DLED01 (LED)
- DTRV01 (TRV), DTRP02 (TPV), DTRVBT01 (V24)
- DDIM01 (DIM), DOUT10V01 (D10), DINTDALI01 (DAL)
- DLCD03 (LC3), DPBRLCD02 (PRL), DTEM01 (TE1), DTEM02 (TE2), DTSC01_03 (TSB), DTSC04 (LT4)
- DMOV01 (DET), DIN10V01 (I10), DISM04 (IS4), DISM08 (IS8)
- SOFT_VAR (VAR), SYS_VAR (SYS), MEM (MEM), SFE (SFE), ZON (ZON)
- DFAN01 (FAN), DMV01 (DMV)
- DPBC01 (CL1), DPBC02 (CL2), DPBC04 (CL4), DPBC06 (CL6), DENV01 (EV1), DDMX02 (DX2)
Connection
Equipment configuration and settings required for iRidium to control Domintell.
Ways of connection to Domintell
Different ways of connection enable local work and work via the Internet when connecting to the Domintell network via the DETH02 module.
1. Local connection works only in the local network of the automation object. The UDP protocol is used. The connection is established between DETH02 and a panel via the network router.
2. Internet connection enables connection to Domintell via the Internet. To work in this mode the network router is required to have a static IP-address or use the DDNS service.
You can connect to Domintell via DETH02 only. Control via DETH03, DETH04, DETH07 is not possible!
Network scanning
Scanning works only in the local network - it enables fast adding of all Domintell devices in iRidium projects.
close all programs connected to DETH02 before scanning.
- Create a new project and click Scan > Scan Domintell (UDP) in
PROJECT DEVICE PANEL
- Mark the devices you plan to control
If you cannot scan the network, add Domintell Network (UDP) and devices from DEVICE BASE
manually
To work with DGQG04 module and other modules working via WebSocket, choose WebSocket parameter in the Transport field and enter required values for scanning a controller.
As a result of scanning you will have three levels of the Domintell network:
- Domintell Network (UDP) - the Domintell bus, it unites all controlled devices (relays, sensors, etc.). The bus has an IP-address for external control via DETH02
- Domintell Devices - the devices in the bus. They have unique addresses
- Commands and Feedbacks - the commands and feedback channels inside the devices which enable control of their separate properties.
Setting up connection (TCP, UDP, WebSocket (TCP))
Select the connection settings by default. They can be changed while working with the project.
- Host - the IP-address of DETH02 (IPv4);
- Port - the ТСР port of connection to DETH02 (17481);
- Password - the password for protected access;
- Keep Alive - timeout for connection in seconds
- Update time (ms) - frequency of sending requests to devices to update data about their state
UDP:
- Host - IP-address;
- Port - UDP connection port
- Password - password for secure access;
- Update time (ms) - frequency of requesting devices to update data about their state.
WebSocket (TCP):
to work with DGQG04 module.
- Host - IP-address;
- Port - a port to connect to Web Socket;
- Login - a user's login;
- Password - a password for secure access.
To work via the Internet, indicate the public IP-address of the router to which DETH02 is connected and set up Port Forwarding.
You can see the public IP-address of the router
here
Change of connection settings
You need the possibility to change connection properties when you disconnect from the Wi-Fi network of the automation object and start using 3G or another Wi-Fi network. To maintain control of the object you need to switch from the local to public IP-address of the Internet router.
The switch is not automatic. You have to select the connection mode. For remote acces you have to make ports for controlling the automation system public. In order to do that you have o set up the Port Forwarding service on your Internet router. VPN can provide protected connection.
1 Download the template (*.js) (right-click button: "Save object as ..."), add the template in the script editor with the button (+) Add Script from file
2 Set up script properties as it is shown in the example:
- function Internal_1() {
- IR.GetDevice("Domintell Network (UDP)").SetParameters({Host: "192.168.0.100", Port: 17481, Password: "pass", PingTime: 1000});
- }
- function External_1() {
- IR.GetDevice("Domintell Network (UDP)").SetParameters({Host: "215.110.10.10", Port: 17481, Password: "pass", PingTime: 1000});
- }
Copy the driver name from Projeсt Device Panel - the list of properties has to be copied from the example.
3 Select the button which will be responsible for the switch of Internal and External properties. Open Macros Editor
for the Press event (Object Properties > Programming), select the Script Call
command and add it by double-clicking on it. Select the name of the function which will be activated by the button:
Now each pressing on the button will apply the corresponding connection properties.
Control of equipment
To control equipment it is required to set Commands and Feedbacks. To send a command, drag'n'drop it on a graphic item and enter a value to send. To display feedback drag'n'drop a feedback channel on a graphic item and choose how to output or display a value.
Read more about work with graphic items in the
"Types of graphic items" article.
Possible settings of commands and feedback channels are given below:
Push Buttons
The Push Buttons devices support simulation of clicking on buttons of wall panels and can display the state of buttons in the visualization interface.
A list of Push Buttons devices:
- DPBUT1 (BU1) - 1 Push Button
- DPBUT2 (BU2) - 2 Push Button
- DPBUT4 (BU4) - 4 Push Button
- DPBUT6 (BU6) - 6 Push Button
Commands for sending to Push Buttons:
Command:
Channel |
1 ... n |
the number of Push Buttons output (corresponds to the button number)
|
Command |
Value * |
|
none |
- |
to switch the output state to the opposite one
|
%P
|
1 |
to simulate a click on the button
|
2 |
the end of the click
|
3 |
the beginning of a long pressing
|
4 |
the end of the long pressing
|
* Value - indicate when dragging commands on graphic items
Feedback:
Channel |
1 ... n |
the number of the Push Buttons output(corresponds to the button number)
|
Command |
Value * |
|
I
|
0 |
the button state: pressed
|
1 |
the button state: released
|
O
|
0 |
the output state: unlocked
|
1 |
the output state: locked
|
* Value - comes to the feedback channel, use for displaying on items
Sound Module
It supports control of volume and playback sources, enables selection of radio frequency.
A list of devices:
- DAMPLI01 (AMP) - Sound Module
Commands for sending to Sound Module:
Command:
Channel |
1 ... 4 |
the audio output number
|
Command |
Value * |
|
%D |
0 ... 100 |
to set up the volume value
|
%I%D |
0 ... 100% |
to increase volume by the indicated percent
|
%O%D |
0 ... 100% |
to decrease volume by the indicated percent
|
%A |
1 |
to select the AUX1 source
|
2 |
to select the AUX2 source
|
3 |
to select the AUX3 source
|
4 |
to select the AUX4 source
|
5 |
to select the TUNER source
|
%F |
1015000 |
the radio frequency, 1015000 = 101.5 MHz, step - 500 Hz
|
* Value - indicate when dragging commands on graphic items
Feedback:
Channel |
1 ... n |
the audio output number
|
Command |
S |
the audio output state
|
Prperty |
Value * |
|
Volume |
0 ... 100% |
volume
|
Auxiliary |
1 ... 5 |
the audio source
|
Frequency |
1015000 |
the radio frequency
|
* Value - comes to the feedback channel, use for displaying on items
Relays
Control of relay channels: switch, lock and unlock.
A list of devices:
- DBIR01 (BIR) - 8 bipolar relays
- DMR01 (DMR) - 5 monopolar relays
- DTRP01 (TRP) - 4 pulse relays
Commands for sending to relays:
Command:
Channel |
1 ... n |
the relay output number
|
Command |
Value * |
|
none |
- |
to switch the output
|
%I |
- |
to lock the output
|
%O |
- |
to unlock the output
|
* when dragging commands on graphic items leave Value empty
Feedback:
Channel |
1 ... n |
the relay output number
|
Command |
Value * |
|
none |
0 |
the output is unlocked
|
1 |
the output is locked
|
* Value - comes to the feedback channel, use for displaying on items
Shutter inverters
Control of shutters: open, close, stop, change direction
A list of devices:
- DTRV01 (TRV) - 4 shutter inverters (up/down)
- DTRP02 (TPV) - 4 shutter inverters(up/down)
- DTRVBT01 (V24) - 1 DC shutter command (up/down)
Commands for sending to shutters drives:
Command:
Channel |
1 ... n |
the shutters drive number
|
Command |
Value * |
|
none |
- |
to change direction of shutters movement
|
%H |
- |
to oen shutters
|
%L |
- |
to close shutters
|
%O |
- |
to stop shutters
|
* when dragging commands on graphic items leave Value empty
Feedback:
Channel |
1 ... n |
the shutters drive number
|
Command |
Value * |
|
none |
0 |
shutters are opened
|
1 |
shutters are closed
|
* Value - comes to the feedback channel, use for displaying on items
Dimmers
Control of dimmers include a possibility to set up brightness, increment, start and stop light dimming.
A list of devices:
- DDIM01 (DIM) - 8 dimmer commands
- DOUT10V01 (D10) - 0/1-10V dimmer module
Set up control commands:
Command:
Channel |
1 ... n |
the dimmer channel number
|
Command |
Value * |
|
none |
- |
to switch states (on/off)
|
%D |
0...100 |
to set up brightness value
|
%I%D |
0 ... 100% |
to increment brightness by the indicated percent
|
%O%D |
0 ... 100% |
to decrement brightness by the indicated percent
|
%DB |
- |
to start dimming
|
%DE |
- |
to stop dimming
|
* Value - indicate when dragging commands on graphic items
Feedback:
Channel |
1 ... n |
the dimmer channel number
|
Command |
Value * |
|
none |
0...100 |
dimmer brightness
|
* Value - it can be used for displaying states on graphic items
DMX
Control of dimmers and RGB and RGBW lighting
A list of devices:
- DMX01 (DMX) - dmx control.
Set commands to control color
Command:
Device |
1...n |
Device number.
|
Channel |
1 |
Red
|
2 |
Green
|
3 |
Blue
|
4 |
White
|
Command |
Value * |
|
none |
0/1 |
Switch a state (on/off)
|
%X |
0...255 |
Set a value to a selected color
|
* Value - enter it when drag'n'dropping a command to a graphic item.
Feedback:
Device |
1...n |
Device number.
|
Channel |
1 |
Red
|
2 |
Green
|
3 |
Blue
|
4 |
White
|
Command |
Value * |
|
none |
0/1 |
State (on / off)
|
%X |
0...255 |
Value of a selected color.
|
* Value - comes to a feedback channel. use it to display on items
Control:
- Trigger Button - turns on/off light;
- Level - controls brightness of separate colors;
- Joystick - controls color with the help of Color Picker.
Use a script to control RGB light with the help of Color Picker. Before it create commands and feedback channels and add graphic items (Button, Level, etc.) to a project.
Write names of channels and paths to graphic ites used in a project in the script.
////////////////////Copy the equipment control code from under the script.//////////////////
var Driver = IR.GetDevice("Domintell"); // Driver in project
var ColorPicker = IR.GetPage("Page 1").GetItem("ColorSelector"); // Item "Color Picker"
IR.AddListener(IR.EVENT_ITEM_RELEASE, ColorPicker, function (){
//To send the value to the controller, convert the color to HEX:
var Red = (ColorPicker.Color >> 24) & 0xFF;
var Green = (ColorPicker.Color >> 16) & 0xFF;
var Blue = (ColorPicker.Color >> 8) & 0xFF;
Driver.Set("DMX:Red", Red) //Send to red channel
Driver.Set("DMX:Green", Green) //Send to green channel
Driver.Set("DMX:Blue", Blue) //Send to blue channel
})
////////////////////////////////Item "Display"///////////////////////////////////////////////
IR.AddListener(IR.EVENT_TAG_CHANGE, Driver, function (in_sName, in_sValue) {
if (in_sName == "DMX:Red" || in_sName == "DMX:Green" || in_sName == "DMX:Blue") {
IR.GetPage("Page 1").GetItem("FeedbackColor").GetState(0).FillColor = Driver.GetFeedback("DMX:Red") << 24 |
Driver.GetFeedback("DMX:Green") << 16 | Driver.GetFeedback("DMX:Blue") << 8 | 0xFF
}
})
Temperature
Control of temperature includes a possibility to set up temperature mode and value
A list of devices:
- DTEM01 (TE1) - temperature sensor
- DTEM02 (TE2) - temperature sensor with 2*16 char LCD
- DENV01 (EV1) - Outdoor environmental data measurement module
- DPBC01 (CL1) - 1-key push-button, with RGBW LED and T° probe
- DPBC02 (CL2) - 2-key push-button, with RGBW LED and T° probe
- DPBC04 (CL4) - 3-key push-button, with RGBW LED and T° probe
- DPBC06 (CL6) - 4-key push-button, with RGBW LED and T° probe
Set up control commands:
Command:
Command |
Value * |
|
%T |
0...n |
Heating Setpoint Temperature - the set point temperature value in the heating mode (degrees)
|
%U |
0 ... n |
Cooling Setpoint Temperature - the set point temperature value in the cooling mode (degrees)
|
%R |
0 |
OFF - Regulation Mode
|
1 |
HEATING - Regulation Mode
|
2 |
COOLING - Regulation Mode
|
3 |
MIXED - Regulation Mode
|
%M |
1 |
ABSENCE - Temperature Mode
|
2 |
AUTO - Temperature Mode
|
5 |
COMFORT - Temperature Mode
|
6 |
FROST - Temperature Mode
|
* Value - indicate when dragging commands on graphic items
Feedback:
Command |
|
|
T |
feedback for the heating mode
|
U |
feedback for the cooling mode
|
Property |
Value * |
|
Measured Temp |
0...n |
sensor temperature
|
Setpoint Temp |
0...n |
the current set point temperature value (degrees)
|
Mode |
4...7 |
Regualation mode (Command: U): 0 - Off, 1 - Heating, 2- Cooling, 3 - Mixed, Temperature mode (Command: T): 1 - Absence, 2 - Auto, 5 - Comfort, 6 - Frost
|
Range Value |
0...n |
the current temperature value (degrees)
|
* Value - it can be used for displaying states on graphic items
Inputs
Displaying statuses of modules with discrete or analog inputs. This list includes IS4, IS8 devices which can be also controlled with the help of #Push Buttons commands.
A list of devices:
- DIN10V01 (I10) - analog 0-10V input module
- DISM04 (IS4) - 4 inputs module
- DISM08 (IS8) - 8 inputs module
- DPBC01 (CL1) - 1-key push-button, with RGBW LED and T° probe (protocol feature)
- DPBC02 (CL2) - 2-key push-button, with RGBW LED and T° probe (protocol feature)
- DPBC04 (CL4) - 3-key push-button, with RGBW LED and T° probe (protocol feature)
- DPBC06 (CL6) - 4-key push-button, with RGBW LED and T° probe (protocol feature)
Outputs cannot be controlled so leave the list of commands empty.
Feedback:
Channel |
1...n |
the input number
|
Command |
Value * |
|
I |
0...1 |
the discrete input state
|
D |
0...100 |
the analog input state
|
* Value - it can be used for displaying states on graphic items
Fan controller
Control of air conditioners
A list of devices:
Commands for sending to relays:
Command:
Channel |
Command |
Set mode:
|
1 |
%I |
Fan Speed 1
|
2 |
%I |
Fan Speed 2
|
3 |
%I |
Fan Speed 3
|
4 |
%I |
Set Mode - Heating
|
5 |
%I |
Set Mode - Cooling
|
6 |
%I |
Set Mode - Manual
|
6 |
%O |
Set Mode - Automatic
|
* when dragging commands on graphic items leave Value empty
Feedback:
Channel |
0...6 |
the air conditioner property
|
Command |
Value * |
|
O |
0...1 |
the property value
|
* Value - comes to the feedback channel, use for displaying on items
System Functions & Variables
Control and displaying statuses of virtual Domintell variables which can be created in the process of setting up different types of devices.
The list of functions and variables:
- SOFT_VAR (VAR) - virtual programmed status
- SYS_VAR (SYS) - system status
- MEM (MEM) - MEMO Groups
- SFE (SFE) - Sfere
- ZON (ZON) - Zone
Set up control commands (for each variable type only a part of commands is available):
Command:
Channel |
0 |
the channel number is not needed, set 0
|
Command |
Value * |
|
none |
- |
to change the state
|
%I |
- |
to turn on
|
%O |
- |
to turn off (stop)
|
%D |
0...100 |
to set up value
|
%H |
- |
to open
|
%L |
- |
to close
|
%I%D |
0 ... 100% |
to increase the value by the indicated percent
|
%O%D |
0 ... 100% |
to decrease the value by the indicated percent
|
%R |
0 |
OFF - Regulation Mode
|
1 |
HEATING - Regulation Mode
|
2 |
COOLING - Regulation Mode
|
3 |
MIXED - Regulation Mode
|
%M |
1 |
ABSENCE - Temperature Mode
|
2 |
AUTO - Temperature Mode
|
5 |
COMFORT - Temperature Mode
|
6 |
FROST - Temperature Mode
|
* Value - indicate when dragging commands on graphic items
Feedback:
Channel |
0 |
the channel number to receive data from Command: None, D, T, U (value 0/1)
|
Channel |
1 |
the channel number to receive data from Command: O (value 0...100)
|
Command |
Value * |
|
None |
0/1 |
the state of the variable (Channel: 0)
|
D |
0/1 |
the state of the variable (Channel: 0)
|
O |
0...100 |
the state of the variable (Channel: 1)
|
T |
|
feedback for the heating mode (Channel: 0)
|
U |
|
feedback for the cooling mode (Channel: 0)
|
Property |
Value * |
|
Measured Temp |
0...n |
the sensor temperature
|
Setpoint Temp |
0...n |
the current set point temperature value (degrees)
|
Mode |
4...7 |
Regualation mode (Command: U): 0 - Off, 1 - Heating, 2- Cooling, 3 - Mixed, Temperature mode (Command: T): 1 - Absence, 2 - Auto, 5 - Comfort, 6 - Frost
|
Range Value |
0...n |
the current temperature value (degrees)
|
Reference |
- |
a link to a tag (the parameter is available only for MEM module). A link can be assigned after the net is scanned.
|
* Value - it can be used for displaying states on graphic items
Not supported devices
If you cannot find the module in the list of the Domintell Light protocol, it means external control of this module is not supported by the Domintell protocol. Control the module via the #Push Buttons panel.
For example, the DIREMIT01 module does not support the Domintell Light protocol. To send IR commands via this module, set up connection between DIREMIT01 and Input in Domintell Programation. To send commands it is enough to simulate Input activation.