Eclipse.org Eclipse.org
XML Element

<signal> element

Device Kit Attributes Elements XML Reference
The signal tag denotes a logical event that can be triggered by the hardware device. Usually, a signal defines a message that can be received from the hardware device when an important event occurs. A message tag defines the hardware-specific bytes that represent the signal. See the hardware device specifications more information about the specific bytes that define the signal message.

Examples: signal examples


NameTypeDescriptionUse
Element <signal> attributes
type "Boolean" "Integer" "List" "Long" "Map" "Number" "Object" "String" Specifies the signal data type.optional
triggerbooleanSpecifies the signal supports trigger. The default is true.optional

NameDescriptionUse
Element <signal> elements
<description>Specifies the signal description.0 to 1
<deprecated>New Specifies that the contents of this element should be marked as deprecated.0 to 1
<specreference>Specification reference for this signal.0 to unbounded
<key>Specifies the unique signal key.0 to 1
<configuration>New Defines this signal as a configuration signal. 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 NameSibling Description
Element <signal> element siblings
<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>New Specifies that the contents of this element should be marked as deprecated.
<specreference>Specification reference for this measurement.
<key>Specifies a unique measurement key.
<configuration>New Defines this measurement as a configuration measurement.
<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>New Defines the parent measurement.
<parameter>New Specifies a parameter used to extract/insert the information within the parent data.
<parameters>New Specifies a group of 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 NameElement Description
Element <signal> element tree
<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>New Specifies that the contents of this element should be marked as deprecated.
¦  ¦  ¦  ¦  ¦--<specreference>Specification reference for this signal.
¦  ¦  ¦  ¦  ¦  ¦--<description>Description of the specification reference.(see description)
¦  ¦  ¦  ¦  ¦  ¦--<deprecated>New Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦  ¦  ¦  ¦  ¦  ¦--<spec>The hardware specification documentation.
¦  ¦  ¦  ¦  ¦  ¦  ¦--<description>Description of the specification.(see description)
¦  ¦  ¦  ¦  ¦  ¦  ¦--<deprecated>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Defines this signal as a configuration signal.
¦  ¦  ¦  ¦  ¦--<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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦  ¦  ¦  ¦  ¦  ¦  ¦  ¦--<specreference>Specification reference for this translate.(see specreference)
¦  ¦  ¦  ¦  ¦  ¦  ¦--<units>Specifies the optional parameter units.
¦  ¦  ¦  ¦  ¦  ¦  ¦  ¦--<description>Description of the units.(see description)
¦  ¦  ¦  ¦  ¦  ¦  ¦  ¦--<deprecated>New Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦  ¦  ¦  ¦  ¦  ¦  ¦  ¦--<specreference>Specification reference for this units.(see specreference)
¦  ¦  ¦  ¦  ¦  ¦--<parameters>Specifies a group of parameters.
¦  ¦  ¦  ¦  ¦  ¦  ¦--<description>Specifies the parameters description.(see description)
¦  ¦  ¦  ¦  ¦  ¦  ¦--<deprecated>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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>New Specifies that the contents of this element should be marked as deprecated.(see 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