3 using the set function on virtual channels, Using the set function on virtual channels -3 – Echelon i.LON SmartServer 2.0 User Manual
Page 286
i.LON SmartServer 2.0 Programmer’s Reference
17-3
Property Description
A user-defined description of the channel. This can be a
maximum of 201 characters long.
The name of the file on the SmartServer flash disk containing
the configuration of the Virtual channel. This property is
always Virtual_Channel_Cfg.htm.
The handle assigned to the Virtual channel assigned by the
SmartServer. When you use the Set function to modify the
configuration of an existing Virtual channel, you must specify
the channel’s handle. If you do not specify the handle, a new
channel is created. You cannot use the Set function to modify
the handle assigned to the channel.
• The channel type, which is always Virtual.
17.1.3
Using the Set Function on Virtual Channels
You can use the Set function to overwrite the configuration of a Virtual channel, or to create a new
Virtual channel. The input parameters you supply to the function will include one or more
elements. Each
channel to be created or modified.
Each
(or modified) Virtual channel. This set of properties is the same whether you are creating a new
Virtual channel or modifying an existing Virtual channel.
• If you are creating a new Virtual channel, you only need to specify the
property and set it to “Virtual”; all other properties are optional.
• If you are modifying an existing channel, you must specify the channel’s
do not specify the handle, a new channel is created. All other properties must be filled; otherwise
the values stored in them are erased. The previous section, Using the Get Function on Virtual
Channels, details the properties you can include in the Set function. You can create up to two
Virtual channels with a single Set message.
Request (create a new Virtual channel on the SmartServer)
xsi:type="Virtual_Channel_Cfg"> Channel 1
Response
xsi:type="Virtual_Channel_Cfg"> Channel 1