background image

Using i!-ConnectLinx

9

i!-ConnectLinx

Commands

i!-ConnectLinx supports the following out-bound commands (Master to device).

The commands are sent in the standard Send_Command format:

SEND_COMMAND dvMP, "'SET ROOM NAME-Tesla'"

SEND_COMMAND dvMP, "'ADD MACRO-vcr'"

i!-ConnectLinx Commands

'SET ROOM INFO-[Room Name], 

[Room Location], [Room Owner]'

Sets the room name, room location and room owner to be 
displayed in the action list file.

'SET ROOM NAME-[Room Name]'

Sets the room name to be displayed in the action list file.

'SET ROOM LOCATION-[Room 

Location]'

Sets the room location to be displayed in the action list file.

'SET ROOM OWNER-[Owner Name]'

Sets the room owner to be displayed in the action list file.

'ADD MACRO-[Macro Name]'

Adds a group of standard actions. 
See 

i!-ConnectLinxStdFunctionList.xls

 for a complete list of 

macro names.

'ADD STD-[ID]-[ID]&[ID]'

Adds one or more standard actions by ID. The ‘

&

’ is used for 

"AND" and ‘

-

‘ is used for "THROUGH".

'ADD FOLDER-[Folder Name],

[Parent]'

Adds a folder to the action list. The parent specifies which parent 
folder the new folder is added to. If parent is not supplied, this 
folder is added to the root of the action list.

'ADD ACTION-[ID],[Action],[Help 

String],[Folder]'

Adds an action. The ID and Action are required. The 

Help String

 appears in the action list file to help the user 

determine this action’s function more clearly. The 

Folder

 is the 

folder in which this action is added to, and must have been 
previously created. If the folder is not supplied, the action is 
added to the root of the action list.

'ADD NARG-[Action],[Arg 

Name],[Min],[Max],[Step,]

[Default]'

Adds a number argument to 

Action

. The 

Arg Name

 (Argument 

Name) is required. The 

Min

 and 

Max

 define the limits for this 

argument in the range 

–32767

 to 

32767

. The 

Step

 defines the 

minimum step between increments/decrements. The 

Default

 

value defines the initial value this argument is set to when the 
user edits this argument.

'ADD LARG-[Action],[Arg 

Name],[Min],[Max],[Step],

[Default]'

Adds a level argument to 

Action

. The 

Arg Name

 (Argument 

Name) is required. The 

Min

 and 

Max

 define the limits for this 

argument in the range 

–32767

 to 

32767

. The 

Step

 defines the 

minimum step between increments/decrements. The 

Default

 

value defines the initial value this argument is set to when the 
user edits this argument.

'ADD SARG-[Action],[Arg 

Name],[Min],[Max],[Default]'

Adds a string argument to 

Action

. The 

Arg Name

 (Argument 

Name) is required. The 

Min

 and 

Max

define the min and max 

length of the string. The 

Default

 value defines the initial value 

this argument is set to when the user edits this argument.

'ADD EARG-[Action],

[Arg Name],[Default],[Enum1],

[Enum2]...'

Adds an enum argument to  

Action

. The 

Arg Name

 (Argument 

Name) is required. The 

Default

 value defines the initial value 

this argument is set to when the user edits this argument. 

Enum1

Enum2

,… define the available choices for the argument.

'GET NODE-[Name],[Start],[End]'

Get the node description for Name including children from Start 
to End. Returns a PARENT string and multiple CHILD strings.

'GET ACTION-[Name]'

Get the action description for Name. Returns ACTION string and 
mulitple argumnet strings (NARG, LARG, SARG and EARG).

'GET UUID'

Get the UUID for this i!-ConnectLinx. Returns a UUID string.

'GET ROOM INFO'

Get the room info for this i!-ConnectLinx. Returns ROOM NAME, 
ROOM LOCATION and ROOM OWNER strings.

Summary of Contents for i!-ConnectLinx

Page 1: ...instruction manual integration Solutions i ConnectLinx...

Page 2: ...ceipt AMX DISCLAIMS ALL OTHER WARRANTIES EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE WITH REGARD TO THE AMX SOFTWA...

Page 3: ...d Operating Systems 1 Minimum PC Requirements 1 Installing i ConnectLinx 2 Using i ConnectLinx 3 Standard Actions 4 Action Arguments 6 Action Persistence and Distribution 7 International Issues Locali...

Page 4: ...ii i ConnectLinx Table of Contents...

Page 5: ...nectLinx module that handles exposing and executing action requests see the Module section on page 11 To support i ConnectLinx you simply include this module in your program define your actions and wr...

Page 6: ...Windows programs before going any further Click Next to proceed 4 In the Select i ConnectLinx Install Location dialog use the Browse button to navigate to a directory other than the default install di...

Page 7: ...s say you want the user to be able to allow the ability to play and stop a VCR Imagine you have two touch panel buttons that do these functions write code that responds to the pushes BUTTON_EVENT TP 1...

Page 8: ...technology programs itself to execute an action on a system it also stores a copy of the system identifier from the action list This identifier is sent to i ConnectLinx along with this action executio...

Page 9: ...x with the macro you want added For example DATA_EVENT vdvCLActions ONLINE Setup actions VCR Select and Play Record SEND_COMMAND vdvCLActions ADD MACRO vcr For a complete list of macros see the i Conn...

Page 10: ...alue from Each argument is numbered in the order they are added Arguments are added by using the ADD NARG ADD LARG ADD SARG and ADD EARG commands When an i ConnectLinx compatible technology requests a...

Page 11: ...ks to any URL with any file name in any folder In the above example the IT department might collect all the action list files and place them in the connectlinx directory of the company s web server Ea...

Page 12: ...wever this file is difficult to edit in a standard text editor so an XML file editor is recommended Alternatively the i ConnectLinxStdText xml file can be created using the i ConnectLinxEngineStdTextW...

Page 13: ...Min Max Step Default Adds a number argument to Action The Arg Name Argument Name is required The Min and Max define the limits for this argument in the range 32767 to 32767 The Step defines the minim...

Page 14: ...Parent Describes a child of a node Returned by GET NODE command ACTION ID Action Help String Folder Describes an action Returned by GET ACTION command NARG Action Arg Name Min Max Step Default Descri...

Page 15: ...LinxEngineMod Module definition code is displayed below DEFINE_MODULE i ConnectLinxEngineMod mdlCL vdvCLActions Where mdlCL is a unique module name i ConnectLinxEngineMod Module Parameter vdvCLActions...

Page 16: ...ve richardson TX 75082 USA 469 624 8000 800 222 0193 fax 469 624 7153 technical support 800 932 6993 033 004 2641 2 05 2005 AMX Corporation All rights reserved AMX the AMX logo the building icon the h...

Reviews: