Carrol Touch TouchSystems CarrollTouch Prog, Руководство программиста

Страница: 152 / 274

CARROLL TOUCH Appendix B - Smart-Frame Protocol II Function Reference
Touch System Programmer’s Guide B-3
GetConfiguration (11H)
Command Description
The GetConfiguration (11H) command instructs the touch system to
return the Get Configuration Report, which describes each component
of the touch system.
A component is a portion of the touch system hardware such as a
sensor/frame or a controller. The information for each component is
contained in its attributes. An attribute is a single piece of information
that applies to that component. Each attribute consists of two parts: a
tag that indicates the attribute’s meaning, and a value that indicates its
value.
For example, a guided wave touch system consists of a sensor/frame
component and a controller component. The sensor/frame has one
attribute - touch technology - with a value of guided wave. The
controller component has two attributes - a touch technology attribute
with a value of guided wave and an interface attribute with a value of
RS-232.
Because the GetConfiguration (11H) command is extensible, new
component types, attribute types, and attribute values may be added as
needed.
Application or driver software that seeks to list the entire configuration
of a touch system should maintain a table of strings that match the
defined component types, attribute types, and attribute values, and
should display those strings if the numeric values for the types and
values correspond to a string in the table. If a numeric value for a type
or value does not correspond to any of the strings in the table, the
numeric value should be displayed.
Application or driver software that seeks to determine the value of a
specific attribute should use the value supplied by the Get
Configuration Report if an attribute tag and value pair is returned that
corresponds to that specific attribute. If no attribute tag and value pair
is returned, the application or driver software should use the default
value for that specific attribute, if a default is defined. (Note that not all
attributes have default values defined; in that case, the application or
driver software will be unable to determine via software means the
value of the attribute.) If the touch system does not support the
GetConfiguration (11H) function (as indicated by Cmderr), the
application or driver software should act as if no attribute tag and value
pair is returned that corresponds to that specific attribute; that is, the