|
|
<signal> element |
Device Kit Attributes Elements XML Reference |
Examples: signal examples
| Name | Type | Description | Use |
|---|---|---|---|
| type | "Boolean" "Integer" "List" "Long" "Map" "Number" "Object" "String" | Specifies the signal data type. | optional |
| trigger | boolean | Specifies the signal supports trigger. The default is true. | optional |
| Name | Description | Use |
|---|---|---|
| <description> | Specifies the signal description. | 0 to 1 |
| <deprecated> | 0 to 1 | |
| <specreference> | Specification reference for this signal. | 0 to unbounded |
| <key> | Specifies the unique signal key. | 0 to 1 |
| <configuration> | 0 to 1 | |
| <rate> | Specifies the rate that the signal is received in milliseconds. | 0 to 1 |
| <message> | Specifies the message to trigger the signal. | 0 to unbounded |
| <method> | Specifies the method to handle the signal. | 0 to 1 |
| <data> | Specifies the data when the signal triggers. | 0 to unbounded |
| <messages> | Specifies the messages to trigger the signal. | 0 to 1 |
| <pid> | Specifies the pid for this signal. | 0 to unbounded |
| <parameter> | Specifies a message parameter. | 0 to unbounded |
| <parameters> | Specifies a parameter group. | 0 to unbounded |
| <maximum> | Specifies the maximum value. | 1 to 1 |
| <minimum> | Specifies the minimum value. | 1 to 1 |
| <negative> | Negate the value. | 1 to 1 |
| <not> | Logical not of a boolean value. | 1 to 1 |
| <scale> | Scale the value. | 1 to 1 |
| <shift> | Shift the value. | 1 to 1 |
| <translate> | Translate (add) to the value. | 1 to 1 |
| Sibling Name | Sibling Description |
|---|---|
| <command> | Defines a command supported by this concrete device. |
| <commands> | Specifies a command group. |
| <group> | Defines a group supported by this concrete device. |
| <measurement> | Defines a measurement supported by this concrete device. |
| <description> | Specifies the measurement description. |
| <deprecated> | |
| <specreference> | Specification reference for this measurement. |
| <key> | Specifies a unique measurement key. |
| <configuration> | |
| <rate> | Specifies the measurement polling rate in milliseconds. |
| <message> | Specifies the measurement message. |
| <data> | Specifies the measurement data. |
| <readcommand> | Specifies the command to request a read of the current value of the measurement. |
| <writecommand> | Specifies the command to request a change of the measurement value. |
| <method> | Specifies the method. |
| <measurement> | |
| <parameter> | |
| <parameters> | |
| <units> | Specifies the measurement units. |
| <value> | Specifies the optional initial measurement value. |
| <maximum> | Specifies the maximum value. |
| <minimum> | Specifies the minimum value. |
| <negative> | Negate the value. |
| <not> | Logical not of a boolean value. |
| <scale> | Specifies a numeric scale value. |
| <shift> | Specifies an integer shift value. |
| <translate> | Specifies a numeric translate (add) value. |
| Element Name | Element Description |
|---|---|
| <dkml> | Specifies the root element of a Device Kit Device Kit Language (dkml) document. |
| ¦--<adapter> | Specifies an adapter. |
| ¦ ¦--<group> | Defines a group supported by this concrete device. |
| ¦ ¦ ¦--<measurement> | Specifies a measurement supported by this group. |
| ¦ ¦ ¦ ¦--<signal> | Specifies the signal containing the measurement value. |
| ¦ ¦ ¦ ¦ ¦--<description> | Specifies the signal description. |
| ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this signal. |
| ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the specification reference.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦--<spec> | The hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the specification.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<speccomment> | Comment about the hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specdate> | Date of the hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<spectitle> | Title of the hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specvendor> | Vendor the hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specversion> | Version of the hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦ ¦--<specsection> | The reference to section in the hardware specification documentation. |
| ¦ ¦ ¦ ¦ ¦--<key> | Specifies the unique signal key. |
| ¦ ¦ ¦ ¦ ¦--<configuration> | |
| ¦ ¦ ¦ ¦ ¦--<rate> | Specifies the rate that the signal is received in milliseconds. |
| ¦ ¦ ¦ ¦ ¦--<message> | Specifies the message to trigger the signal. |
| ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the message.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this message.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦--<ascii> | Specifies a set of ASCII character (8 bits). |
| ¦ ¦ ¦ ¦ ¦ ¦--<bytes> | Specifies a set of bytes. Each byte is 8 bits. |
| ¦ ¦ ¦ ¦ ¦ ¦--<nibbles> | Specifies a set of nibbles. Each nibble is 4 bits. |
| ¦ ¦ ¦ ¦ ¦ ¦--<tokens> | Specifies the message tokens. |
| ¦ ¦ ¦ ¦ ¦ ¦--<parameter> | Specifies a parameter within the message. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the parameter.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this parameter.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<key> | Specifies the parameter key.(see key) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<bigendian> | Specifies that the parameter data is in big endian order. This is the default order. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<field> | Specifies the field parameter name. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<insert> | Specifies that the parameter should be inserted into the message. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<littleendian> | Specifies that the parameter data is in little endian order. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<offset> | Specifies the starting bit offset of the parameter within the message. Offset 0 is the first bit in the message. See the offset element to specify the parameter offset in bytes. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<index> | Specifies the starting byte index of the parameter within the message. Index 0 is the first byte of the message. See the offset element to specify the parameter offset in bits. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<length> | Specifies the parameter length in bits. See the length element to specify the parameter length in bytes. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<size> | Specifies the parameter size in bytes. See the length element to specify the parameter length in bits. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<enum> | Specifies a enum for this parameter. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the enum.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this enum.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<minimum> | Specifies the minimum value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<maximum> | Specifies the maximum value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<negative> | Negate the parameter value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<not> | Logical not of a boolean value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<scale> | Specifies the value to scale the parameter value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the scale.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this scale.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<shift> | Specifies the value to shift the parameter value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the shift.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this shift.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<translate> | Specifies the value to add (translate) to the parameter value. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the translate.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this translate.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<units> | Specifies the optional parameter units. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the units.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this units.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦--<parameters> | Specifies a group of parameters. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Specifies the parameters description.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this group of parameters.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<key> | Specifies the unique parameters key.(see key) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<parameter> | Specifies the parameter.(see parameter) |
| ¦ ¦ ¦ ¦ ¦ ¦--<filter> | Specifies the message filter. |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the filter.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this filter.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦ ¦--<bytes> | Specifies the message filter (Bit off - ignore, Bit on - compare).(see bytes) |
| ¦ ¦ ¦ ¦ ¦ ¦--<sentmessage> | Specifies the message that was sent that caused this message. |
| ¦ ¦ ¦ ¦ ¦--<method> | Specifies the method to handle the signal. |
| ¦ ¦ ¦ ¦ ¦--<data> | Specifies the data when the signal triggers. |
| ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the data.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this data.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦--<key> | Specifies the data key.(see key) |
| ¦ ¦ ¦ ¦ ¦ ¦--<length> | Specifies the data length in bits. See the length element to specify the data length in bytes. (see length) |
| ¦ ¦ ¦ ¦ ¦ ¦--<size> | Specifies the data size in bytes. See the length element to specify the data length in bits. (see size) |
| ¦ ¦ ¦ ¦ ¦ ¦--<minimum> | Specifies the minimum value.(see minimum) |
| ¦ ¦ ¦ ¦ ¦ ¦--<maximum> | Specifies the maximum value.(see maximum) |
| ¦ ¦ ¦ ¦ ¦ ¦--<units> | Specifies the optional data units.(see units) |
| ¦ ¦ ¦ ¦ ¦--<messages> | Specifies the messages to trigger the signal. |
| ¦ ¦ ¦ ¦ ¦ ¦--<description> | Specifies the messages description.(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this group of messages.(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦--<key> | Specifies the unique messages key.(see key) |
| ¦ ¦ ¦ ¦ ¦ ¦--<message> | Specifies the message.(see message) |
| ¦ ¦ ¦ ¦ ¦--<pid> | Specifies the pid for this signal. |
| ¦ ¦ ¦ ¦ ¦ ¦--<description> | Description of the parameter identifier (PID).(see description) |
| ¦ ¦ ¦ ¦ ¦ ¦--<deprecated> | |
| ¦ ¦ ¦ ¦ ¦ ¦--<specreference> | Specification reference for this parameter identifier (PID).(see specreference) |
| ¦ ¦ ¦ ¦ ¦ ¦--<key> | Specifies the parameter identifier (pid) key.(see key) |
| ¦ ¦ ¦ ¦ ¦ ¦--<identifier> | Specifies the parameter identifier. |
| ¦ ¦ ¦ ¦ ¦ ¦--<length> | Specifies the parameter (pid) data length in bits.(see length) |
| ¦ ¦ ¦ ¦ ¦ ¦--<size> | Specifies the parameter identifier (pid) size in bytes. See the length element to specify the parameter (pid) data length in bits. (see size) |
| ¦ ¦ ¦ ¦ ¦ ¦--<minimum> | Specifies the minimum value.(see minimum) |
| ¦ ¦ ¦ ¦ ¦ ¦--<maximum> | Specifies the maximum value.(see maximum) |
| ¦ ¦ ¦ ¦ ¦ ¦--<negative> | Negate the parameter value.(see negative) |
| ¦ ¦ ¦ ¦ ¦ ¦--<not> | Logical not of a boolean value.(see not) |
| ¦ ¦ ¦ ¦ ¦ ¦--<scale> | Specifies the value to scale the parameter value.(see scale) |
| ¦ ¦ ¦ ¦ ¦ ¦--<shift> | Specifies the value to shift the parameter value.(see shift) |
| ¦ ¦ ¦ ¦ ¦ ¦--<translate> | Specifies the value to add (translate) to the parameter value.(see translate) |
| ¦ ¦ ¦ ¦ ¦ ¦--<units> | Specifies the optional parameter identifier (pid) units.(see units) |
| ¦ ¦ ¦ ¦ ¦--<parameter> | Specifies a message parameter.(see parameter) |
| ¦ ¦ ¦ ¦ ¦--<parameters> | Specifies a parameter group.(see parameters) |
| ¦ ¦ ¦ ¦ ¦--<maximum> | Specifies the maximum value.(see maximum) |
| ¦ ¦ ¦ ¦ ¦--<minimum> | Specifies the minimum value.(see minimum) |
| ¦ ¦ ¦ ¦ ¦--<negative> | Negate the value.(see negative) |
| ¦ ¦ ¦ ¦ ¦--<not> | Logical not of a boolean value.(see not) |
| ¦ ¦ ¦ ¦ ¦--<scale> | Scale the value.(see scale) |
| ¦ ¦ ¦ ¦ ¦--<shift> | Shift the value.(see shift) |
| ¦ ¦ ¦ ¦ ¦--<translate> | Translate (add) to the value.(see translate) |
| ¦ ¦ ¦--<signal> | Specifies a signal supported by this group.(see signal) |
| ¦ ¦--<measurement> | Defines a measurement supported by this concrete device.(see measurement) |
| ¦ ¦--<signal> | Defines a signal supported by this concrete device.(see signal) |
| ¦ ¦--<device> | Specifies the device used by the adapter. |
| ¦ ¦ ¦--<group> | Defines a group supported by this device.(see group) |
| ¦ ¦ ¦--<measurement> | Specifies a measurement supported by this device.(see measurement) |
| ¦ ¦ ¦--<signal> | Specifies a signal supported by this device.(see signal) |
| ¦--<adaptertest> | Specifies an adapter test. |
| ¦ ¦--<adapter> | Specifies the adapter to be tested.(see adapter) |
| ¦--<agent> | Specifies an agent. |
| ¦ ¦--<agentmodel> | Specifies the agent model used by the agent. |
| ¦ ¦ ¦--<device> | Specifies the device used by the agent model.(see device) |
| ¦ ¦--<device> | Specifies the device used by the agent.(see device) |
| ¦--<agentmodel> | Specifies the agent model used by the agent.(see agentmodel) |
| ¦--<agenttest> | Specifies an agent test. |
| ¦ ¦--<agent> | Specifies the agent to be tested.(see agent) |
| ¦ ¦--<agentmodeltest> | Specifies the agent model test. |
| ¦ ¦ ¦--<agentmodel> | Specifies the agent model to be tested.(see agentmodel) |
| ¦--<agentmodeltest> | Specifies an agent model test.(see agentmodeltest) |
| ¦--<concrete> | Specifies a concrete device. |
| ¦ ¦--<group> | Defines a group supported by this concrete device.(see group) |
| ¦ ¦--<measurement> | Defines a measurement supported by this concrete device.(see measurement) |
| ¦ ¦--<signal> | Defines a signal supported by this concrete device.(see signal) |
| ¦--<concretetest> | Specifies a concrete test. |
| ¦ ¦--<concrete> | Specifies the concrete device to be tested.(see concrete) |
| ¦--<device> | Specifies a device.(see device) |
| ¦--<devicetest> | Specifies a device test. |
| ¦ ¦--<device> | Specifies the device to be tested.(see device) |
| ¦--<profile> | Specifies a profile. |
| ¦ ¦--<group> | Defines a group supported by this profile.(see group) |
| ¦ ¦--<measurement> | Specifies a measurement supported by this profile.(see measurement) |
| ¦ ¦--<signal> | Specifies a signal supported by this profile.(see signal) |
| ¦ ¦--<adapter> | Specifies the adapter used by the profile.(see adapter) |
| ¦ ¦--<device> | Specifies the device used by the profile.(see device) |
| ¦--<profiletest> | Specifies a profile test. |
| ¦ ¦--<profile> | Specifies the profile to be tested.(see profile) |
| ¦--<testagent> | Specifies a test agent. |
| ¦ ¦--<profile> | Specifies the profile to be tested.(see profile) |
| Copyright (c) IBM 2007. | Device Kit XML Reference 1.0.0 |