background image

- 9 -

3.3

The NetLinx module interface

3.3.1

Commands for module

Commands to the module always take place per SEND_COMMAND to the virtual device.

The module knows the following commands:

Command

Description

ADD=<No>:
<Type>:
<GrpAdr>
[:Flags]

Add an EIB group address to list
Note: Flags are optional

<No> - 1_3000 = AMX number of actuator
<Type> - Actuator type (Switch, Dim4, 1Byte, 2Byte, 3Byte, 4Byte)
<GrpAdr> - EIB group address in 2 or 3 grouped display
<Flags> - EIS5 - value is reported additionally as ASCII float value. The EIB value is converted

according to EIS5 standard (only valid for 2Byte actuators)

              - Time - value is reported additionally as ASCII time (hh:mm:ss) (only valid for 3Byte

actuators)

              - Date - value is reported additionally as ASCII date (Caution: AMX format: MM/DD/YY)

(only valid for 3Byte actuators)

- PS – actuator is automatically polled with 

Start 

of AMX system

              Flags are separated by commas
Examples:
SEND_COMMAND vdvEIB,’ADD=13:Switch:1/0/11’
SEND_COMMAND vdvEIB,’ADD=17:1BYTE:4/7/12:PS’
SEND_COMMAND vdvEIB,’ADD=45:2BYTE:3/0/11:EIS5’
SEND_COMMAND vdvEIB,’ADD=12:3BYTE:2/1/101:TIME,PS’

DATE=<No>:
<Date>

Setting the date
Note: Only valid for actuators type 3Byte

<No> - 1 … 3000 = AMX number of actuator
<Date> - date in format dd/mm/yy

Example: SEND_COMMAND vdvEIB,’DATE=17:14/08/06’

DATE? <No>

Inquiry date value
Note: Only valid for actuators type 3Byte

<No> - 1 … 3000 = AMX number of actuator

Example: SEND_COMMAND vdvEIB,’DATE?17’

DEBUGON=<Level>

Activating the debug reports

<Level> - (… upcoming …)
With activated debug report all actuators of the terminal are listed, which can be accessed via
EIB. This allows simple diagnostics.

Example: SEND_COMMAND vdvEIB,’DEBUGON=1’

DEBUGOFF

Deactivating the debug reports

Example: SEND_COMMAND vdvEIB,’DEBUGOFF’

EIS5=<No>:
<floating point
value>

Setting an EIS5 value
Converts a floating-point value mapped in ASCII into 2Byte EIS5 value before transfer.

<No> - 1 … 3000 = AMX number of actuator
<Floating Point Value> - number in the range of –671088,64 and 670760,96
Note: Only valid for actuators type 2Byte

Example: SEND_COMMAND vdvEIB,’EIS5=12:24,3’

Summary of Contents for CTG-IP

Page 1: ...1 User Manual for the COMM TEC EIB Gateway CTG KNX IP v1 0 1...

Page 2: ...3 3 2 Feedback from module 11 Description 11 3 3 3 Terminal Mode 11 3 3 4 Channels and levels 14 4 Data Types 14 5 Appendix A Sample program 15 5 1 Notes EIB table 15 5 2 Notes for programming 15 5 2...

Page 3: ...there is no special master controlling the communication but any device can send data to any other device A sophisticated protocol ensures that only one device is sending at any time and collisions ar...

Page 4: ...4 Figure 1 Process of Communication NetLinx Master EIB Gateway NetLinx Module NetLinx Program Virtual Device...

Page 5: ...components their filter tables are to be programmed in such a way that all relevant telegrams are really passed through On the other hand the EI bus couplers are slow upon receipt of a telegram an EIB...

Page 6: ...from Gateway to AVIT AMX RX indicates data transmission from AVIT AMX to Gateway Betrieb is lightened when voltage feed is being impressed Prog LED flashes when the Gateway is being set to programmin...

Page 7: ...communication module COMM module translates between standard command interface on NetLinx side and the protocol for EIB connection The communication module for EIB connection is integrated with the fo...

Page 8: ...contained in Appendix A In addition the file EIB_Tools AXI should be integrated to have easy access to commonly used functions see Appendix B INCLUDE EIB_Tools axi 3 2 Analyzing feedback signals All f...

Page 9: ...13 Switch 1 0 11 SEND_COMMAND vdvEIB ADD 17 1BYTE 4 7 12 PS SEND_COMMAND vdvEIB ADD 45 2BYTE 3 0 11 EIS5 SEND_COMMAND vdvEIB ADD 12 3BYTE 2 1 101 TIME PS DATE No Date Setting the date Note Only valid...

Page 10: ...Value Set actuator Note Observe actuator type in value range The module limits the value range automatically to max valid range of the accessed actuator No 1 3000 AMX number of actuator Value value t...

Page 11: ...raw data Example SET 8 1 TIME No Value Feedback of time Note Is transmitted as ADDITIONAL feedback if in actuator No the time flag is set No 1 3000 AMX number of actuator Value Time string in format h...

Page 12: ...t sum of individual types sum of all actuators Example SEND_COMMAND vdvEIB LIST LIST_ Typ List all entered actuators with AMX number EIB group address current value set flags if applicable and resulti...

Page 13: ...delete or add actuators and finally reconstructed with LOAD see above File name is optional If no file name is specified the default file name is used Default file name EIBTableNX TXT In monitor conn...

Page 14: ...s in EIB table are available as levels For every value change the current value is transmitted as level to the program for instance to control a bar graph Level Description lay of values of first 200...

Page 15: ...n less typing errors will occur and the compiler can perform several checks Poll triggers are only entered if the polling and polled addresses are already entered We recommend entering the poll trigge...

Page 16: ...ADD Start Set light 1 Set light 2 Set light 3 Lights status Light 2 status Light 3 status Light scenes 1 2 Light scenes 3 4 Dimmer on off Dimmer relative Dimmer absolute Dimmer value Shutters up down...

Page 17: ...Set light 1 Set light 2 Set light 3 Lights1 status Light 2 status Light 3 status Scenes 1 2 Scenes 3 4 Shutters up down Shutters blinds Dimmer on off Dimmer relative Dimmer absolute Dimmer read value...

Page 18: ...ith Only one command per line is permitted Leading spaces are ignored Lines starting with are completely treated as a comment and not edited by the controls Set light 1 Set light 2 Set light 3 Light 1...

Page 19: ...19 5 2 4 Example 4 Main program feedback array for max 3000 addresses Light 1 ON Analog actuator 50 Dimmer brighter feedback for light 1 see EIB table Key illuminated if actuator 50...

Page 20: ...ule limits the value range automatically to the maximum range of the selected actuator Example EIBSet vdvEIB 13 1 EIBGet Virtual Device AMXNo Function Gets the value of actuator AMXNo to Value stored...

Page 21: ...s get a distinct number 1 3000 independent of their type Via this number the actuators sensors are accessed Additionally several flags can be set in the following example for instance PS This means th...

Page 22: ...o power supply No controls possible no acknowledgement according to Status the gateway is detected Enter command List in monitor mode Are all addresses entered Are here acknowledgment values displayed...

Reviews: