Эта страница является
переводом страницы
Duotecno. Перевод выполнен на 100%.
iRidium for Duotecno
a set of tools to create a visualization interface
The driver is meant to control Duotecno equipment. Use the project examples:
Description
iRidium for Duotecno is a set of tools for creating interfaces to control home or office on the basis of Duotecno equipment. It supports TCP/IP commands of Duotecno protocol.
Connection
Control panels (iOS, Android, Windows, Mac) can control equipment in the Duotecno CAN bus only via TCP/IP Homeserver (DT18-HS).
Smartbox modules have their own TCP/IP interface and can be controlled directly. But, when you connect to Smartbox, you can control only Smartbox (even when other modules are connected to its CAN interface). All other modules of the CAN-bus are only available via TCP/IP Homeserver.
Bus Scanning for Adding Modules
Scanning of the Duotecno CAN-bus via TCP/IP Homeserver is the easiest way to add Duotecno equipment already connected to the bus and available for control in iRidium.
Open iRidium Studio, create a new project, open the side panel Project (PROJECT DEVICE PANEL):
- Press Scan and select Scan DuoTecno (TCP)
- Enter the IP-address and port of the TCP/IP Homeserver
- Tick the modules you want to control from iRidium (all modules are selected by default)
The IP-address and port of connection to TCP/IP Homeserver, see in the program "Duotecno Config Tool":
IP: 192.168.X.XX - the IP-address of the Homeserver, indicate it as Host in the settings for scanning and connection
Server IP Port: 5001 - the Homeserver port, indicate it as Port in the settings for scanning and connection
Manual Adding of Modules
If you cannot scan the bus via TCP/IP Homeserver or you have new devices, add Duotecno modules in the project from the iRidium database:
- Start iRidium Studio, create a new iRidium project
- Open the side panel Device (DEVICE BASE), the DuoTecno tab. Drag DuoTecno Network on the Project panel (PROJECT DEVICE PANEL)
- Open the tab of databases DuoTecno > Units. Drag the required modules on the DuoTecno Network device - they will be added in your project and available in the tabs of devices with corresponding types.
Add DuoTecno Network (the interface to access the bus)
Add modules you want to control
If you add modules manually, you need to indicate their addresses in the project. The address consists of two parts:
- NodeID - the node identifier (the HEX format)
- UnitID - the unit identifier (the HEX format)
Make sure to indicate addresses of devices in your iRidium project, otherwise they will not work. You can see addresses of dimmers, relays, sensors, etc. , for example, in "Duotecno Binding Software". The addresses are added automatically at network scanning.
Connection settings
When the modules are added in the project using scanning or manually, indicate settings of connection to TCP/IP Homeserver. They are indicated in DuoTecno Network.
- Host - the IP-address of the TCP/IP Homeserver interface;
- Port - the port of connection to the TCP/IP Homeserver, it is usually 5001;
- Login - the login to access the server;
- Keep Alive - timeout for connection in seconds.
The IP-address and port of connection to TCP/IP Homeserver, see in the program "Duotecno Config Tool":
IP: 192.168.X.XX - the IP-address of the Homeserver, indicate it as Host in the settings for scanning and connection
Server IP Port: 5001 - the Homeserver port, indicate it as Port in the settings for scanning and connection
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('DuoTecno Network').SetParameters({Host: "192.168.0.95", Port: 5001, Login: "duotecno"});
- }
- function External_1() {
- IR.GetDevice('DuoTecno Network').SetParameters({Host: "215.110.10.10", Port: 5001, Login: "duotecno"});
- }
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.
Setting Commands and Feedback Channels
To control equipment it is required to set commands (Commands) and feedback channels (Feedbacks). To send a command, drag'n'drop it on a graphic item and enter a value to send. To display a feedback value drag'n'drop a feedback channel on a graphic item and choose how to output a value.
Read more about work with graphic items in the
"Types of graphic items" article.
Control
Dimmer Units
A dimmer can be switched on and off. Brightness control of a dimmer can be performed only when the dimmer is turned on.
Commands:
| command |
function
|
| On/Off Toggle |
To turn the dimmer on/off
assign the command to the Press (Release) event of the Button item
|
| On |
To turn on the dimmer<
assign the command to the Press (Release) event of the Button item
|
| Off |
To turn off the dimmer
assign the command to the Press (Release) event of the Button item
|
| Value Set |
To set the dimmer brightness (1-99).
The brightness can be changed only for the TURNED ON dimmer.
Before using this command, send "Dimmer set on"
assign the "On" command, then the "Value Set" command to the to Release event of the Level/Button item
|
| Up |
To increase the dimmer brightness.
The brightness will be increasing, until you send "Dimmer set on"
assign the "Up" command to the Press event the Button item, the "On" command to the Release event
|
| Down |
Decrease the dimmer brightness.
The brightness will be decreasing until you send "Dimmer set on"
assign the "Down" command to the Press event of the Button item, the "On" command to the Release event
|
| Up/Down Toggle |
To increase or decrease the brightness relative to the current value.
The brightness will be changing until you send "On"
assign "Up/Down Toggle" to the Press event on the Button item, the "On" command to the Release event
|
Feedback:
| channel |
function
|
| Status On |
to return 1 when the dimmer is on, 0 when it is off
|
| Status Off |
to return 1 when the dimmer is off, 0 when it is on
|
| Status Value |
to return the brightness value of the dimmer from 1 to 99
|
| Status PIR Timed |
to return 1, if the light is turned on by a motion sensor
|
Switch/Relay Units
Relays (switches) can be turned on and off.
Commands:
| command |
function
|
| On/Off Toggle |
To turn the relay on/off
assign the command to the Press (Release) event of the Button item
|
| On |
To turn on the relay
assign the command to the Press (Release) event of the Button item
|
| Off |
To turn off the relay
assign the command to the Press (Release) event of the Button item
|
Feedback:
| channel |
function
|
| Status On |
to return 1 when the relay is on, 0 when it is off
|
| Status Off |
to return 1 when the relay is off, 0 when it is on
|
| Status PIR Timed |
to return 1, if the relay is turned on by a motion sensor
|
Control Input Unit
The control module can be physically connected to the input modules (motion sensor, door bell, ...). The module can be controlled to activate events. Its state can be monitored.
Commands:
| command |
function
|
| Short puls |
short pulse
assign the command to the Press (Release) event of the Button item
|
| Long puls |
1 - the beginning of a long pulse, 0 - the end of a long pulse.
"'Long pulse" [Value: 1] assign to the Hold event of the Button item
"'Long pulse" [Value: 0] assign to the End Of the Hold event of the Button item
|
Feedback:
| channel |
function
|
| Status on |
to return 1 when the input is closed, 0 - when it is opened
|
| Status off |
to return 0 when the input is closed, 1 - when it is opened
|
Sensor Units
The temperature sensor module can be used to control heating and cooling, but only if the sensor is a part of the temperature gateway node.
The sensor has preset temperature values. The actual temperature is compared with the preset value at regular intervals. Based on the results of this comparison, the module can activate the standby, heating or cooling mode. The sensor can be switched on and off.
Commands:
| command |
function
|
| Preset <MODE> select |
to select a temperature mode. The Preset parameter in the command settings allows you to select one of 4 available modes Preset: SUN, HALF SUN, MOON, HALF MOON. Each of these modes corresponds to a preset temperature value.
assign the command to the Press (Release) event of the Button item
|
| Setpoint <MODE> set |
You can change the preset value of temperature modes SUN, HALF SUN, MOON and HALF MOON. The temperature value is set in degrees Celsius, you can specify the fractional part with accuracy to the 1st decimal place.
assign the command to the Press(Release) event of the Button item, indicate Value - the temperature value, to change the preset value of the specified mode
|
| Sensor On/Off Toggle |
0 - turn the sensor on, 1 - turn it off
assign the command to the Press (Release) event of the Button item
|
| Setpoint Up |
to increase the value of the current mode by 0.5°
assign the command to the Press (Release) event of the Button item
|
| Setpoint Down |
to increase the set temperature of the current mode by 0.5°
assign a command to the Press (Release) event of the Button item.
|
Feedback:
| channel |
function
|
| Status Measured Value |
the current temperature value received from the sensor
|
| Status Sensor On |
to return 1 when the sensor is on, 0 when it is off
|
| Status Sensor Off |
to return 1 when the dimmer is off, 0 when it is on
|
| Status Sensor Cooling |
to return 1 when the cooling mode is on, if otherwise - 0
|
| Status Sensor Heating |
to return 1 when the heating mode is on, if otherwise - 0
|
| Status Sensor Idle |
to return 1 when both cooling and heating modes are off, if otherwise - 0
|
| Status Sensor Preset <MODE> |
to return 1 when the corresponding mode is on, if otherwise - 0
|
| Status Setpoint <MODE> |
to return the preset temperature value for the corresponding mode (in °C)
|
Basic Audio Units
The audio module is designed to control audio devices. An audio device can be a "room" (audio zone), which can have up to 8 audio sources and 1 playback device (audio output).
Commands:
| command |
function
|
| Destination Off |
to turn off the audio output
assign the command to the Press (Release) event of the Button item
|
| Destination On |
to turn on the audio output
assign the command to the Press (Release) event of the Button item
|
| Destination On/Off Toggle |
to turn the audio output on/off depending on its state
assign the command to the Press (Release) event of the Button item
|
| Source Select <1-8> |
to select the source
assign the command to the Press (Release) event of the Button item
|
| Source Function PLAY |
the source function: to start playback
assign the command to the Press (Release) event of the Button item
|
| Source Function PAUSE |
the source function: to pause playback
assign the command to the Press (Release) event of the Button item
|
| Source PRESS UP |
the source function: to press Up
assign the command to the Press (Release) event of the Button item
|
| Source PRESS DOWN |
the source function: to press Down
assign the command to the Press (Release) event of the Button item
|
| Volume Up |
to increase the volume
The volume will be increasing, until you send "Destination On"
assign the "Volume Up" command to the Press event the Button item, the "Destination On" command to the Release event
|
| Volume Down |
to decrease the volume
The volume will be decreasing, until you send "Destination On"
assign the "Volume Down" command to the Press event the Button item, the "Destination On" command to the Release event
|
| Volume Up/Down Toggle |
to increase/decrease the volumedepending on the direction it was changed before
The volume will be changing, until you send "Destination On"
assign the "Up/Down Toggle" command to the Press event the Button item, the "Destination On" command to the Release event
|
| The commands that work only with "BOSE V35" playback devices:
|
| Source Extra Function |
a set of additional commands of remote control (input of numbers, arrows, etc.)
assign the command to the Press (Release) event of the Button item
|
| Source FFWD |
to fast forward
assign the command to the Press (Release) event of the Button item
|
| Source FRWD |
to rewind
assign the command to the Press (Release) event of the Button item
|
| Source NEXT |
to select the next source
assign the command to the Press (Release) event of the Button item
|
| Source PREV |
to select the previous source
assign the command to the Press (Release) event of the Button item
|
| Source PLAY |
to start playback
assign the command to the Press (Release) event of the Button item
|
| Source PAUSE |
to pause playback
assign the command to the Press (Release) event of the Button item
|
| Source STOP |
to stop playback
assign the command to the Press (Release) event of the Button item
|
Feedback:
| channel |
function
|
| Status destination On/Off |
to return 1 when the playback device is on
|
| Status source <1-8> |
to return 1 when the corresponding source is playing, if otherwise - 0
|
| Status Volume |
the current volume of playback (0-99). The capability to get the volume value is supported only by BOSE Lifestyle 50 and BOSE Lifestyle V-class (sometimes these systems are unable to give the current volume value too)
|
| Status Disc Info |
information about a disc (1-9). This information can be sent only by BOSE Lifestyle 50
|
| Status Track Info |
information about a track (1-32). This information can be sent only by BOSE Lifestyle 50
|
| Status Tuner Preset |
the mode of tuner operation. BOSE Lifestyle 50 will send 0-254, BOSE Lifestyle 48 will send 1-9, BOSE Lifestyle V-class will send 1-25
|
| Status Tuner Frequency |
the tuner frequency. BOSE Lifestyle 50 will send the value of the FM-range, BOSE Lifestyle 48 will send 0 = AM, 1 = FM (or nothing), BOSE Lifestyle V-class will send the AM-range and FM-range (or nothing)
|
Motor Units
The module to control motors is a three-pin relay, which allows you to switch the motor drive in two directions - up and down.
When the motor is turned on, it turns off automatically after a certain period of time, and returns to the STOP position. Change of direction requires some time. Motion time and time for direction change are set up during system configuration.
Commands:
| command |
function
|
| Up |
to turn on - up
assign the command to the Press (Release) event of the Button item
|
| Down |
to turn on - down
assign the command to the Press (Release) event of the Button item
|
| Stop |
to stop the motor
assign the command to the Press (Release) event of the Button item
|
| Up/Down Toggle |
to turn on up or down depending on the previous direction
assign the command to the Press (Release) event of the Button item
|
Feedback:
| channel |
function
|
| Status Running up |
the motor is on, direction: up
|
| Status Running down |
the motor is on, direction: down
|
| Status Stopped |
the motor is stopped, the previous state is unknown (e.g. after reboot)
|
| Status Stopped up |
the motor is stopped, the previous direction: up
|
| Status Stopped down |
the motor is stopped, the previous direction: down
|
AV Matrix Units (Advanced)
The AV Matrix module is used to control matrix audio / video switches. Such switches are usually connected to Duotecno through the RS232 interface. The advanced audio control module supports commands for controlling switch functions.
The Duotecno server with firmware v65.50 and later supports the AV Matrix module. You can control third-party AV switches via the open TCP/IP protocol through it.
Supports matrix up to 8x16.
Commands:
| command |
function
|
| Input to Output [I] - [O] |
to connect the indicated input and output of the switch
assign the command to the Press (Release) event of the Button item
|
| On - Out [n] |
to turn off the output
assign a command to the Press (Release) event of the Button item
|
| Off - Out [n] |
to turn off the output
assign the command to the Press (Release) event of the Button item
|
| On/Off - Out [n] |
to turn the output on/off depending on its state
assign the command to the Press (Release) event of the Button item
|
| Volume value - Out [n] |
to set up the output volume value. The value range depends on equipment
assign the command to the Release event of the Level item
|
| Volume up - Out [n] |
to increase the volume of the output, step +1
assign the command to the Press (Release) event of the Button item
|
| Volume down - Out [n] |
to decrease the volume of the output, step -1
assign the command to the Press (Release) event of the Button item
|
| Volume mute - Out [n] |
to turn off the volume
assign the command to the Press (Release) event of the Button item
|
Feedback:
| channel |
function
|
| Status - Out [n] |
to return 1 if the output is connected, 0 - if not
|
| Status volume - Out [n] |
the volume value (0-50)
|
