Материал из for iRidium developers
Перейти к: навигация, поиск
Эта страница является переводом страницы Duotecno. Перевод выполнен на 100%.

Other languages:
English • ‎русский

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.

DuoConnecttoBus.png


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):

DuoScanBus.png
  1. Press "'Scan"' and select "'Scan DuoTecno (TCP)"'
  2. Enter the IP-address and port of the TCP/IP Homeserver
  3. 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":

ConfigToolDuoConnecttoBus-1.png

"'IP: 192.168.X.XX"' - the IP-address of the Homeserver, indicate it as Host in the settings for scanning and connection

ConfigToolDuoConnecttoBus-2.png

"'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:

  1. Start iRidium Studio, create a new iRidium project
  2. Open the side panel Device (DEVICE BASE), the DuoTecno tab. Drag DuoTecno Network on the Project panel (PROJECT DEVICE PANEL)
  3. 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.


DuoAddModuleManually-1.png

Add DuoTecno Network (the interface to access the bus)

DuoAddModuleManually-2.png

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.

DuoNetConnecttonSettings.png
  • "'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


The IP-address and port of connection to TCP/IP Homeserver, see in the program "Duotecno Config Tool":

ConfigToolDuoConnecttoBus-1.png

"'IP: 192.168.X.XX"' - the IP-address of the Homeserver, indicate it as Host in the settings for scanning and connection

ConfigToolDuoConnecttoBus-2.png

"'Server IP Port: 5001"' - the Homeserver port, indicate it as Port in the settings for scanning and connection


Change of Connection Settings

Шаблон:Переключение интернет-локальная сеть (en)


Commands & Feedbacks

As a result of scanning you will have three levels of the bus:

  • DuoTecno Network - the DuoTecno bus, it unites all controlled devices (relays, sensors, etc.). The bus has an IP-address for external control via the TCP/IP Homeserver
  • DuoTecno Devices - the devices in the bus. They have unique addresses - NodeID и UnitID
  • Commands and Feedbacks - the commands and feedback channels inside the devices which enable you to control the devices and get information about their state.


Commands and feedback channels have to be assigned to graphical items to control the equipment:

  • Commands are assigned to graphic items. Some commands require you to indicate the value for sending, but usually it is enough to write 0 in the Value field when sending the command
  • Feedback channels are assigned to graphic items to display the status of the variables


To assign commands or channels to graphic items use the drag&drop method.

To send a command, drag it on a graphic item. To display feedback, drag the channel on the graphic item and indicate where to output the value (Value):

SendValue.png


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 уменьшить уставку текущего режима на 0.5°

привяжите команду на на событие Press (Release) элемента Button

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] включить выход

привяжите команду на на событие Press (Release) элемента Button

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)