<?xml version="1.0" standalone="yes"?>
<?xml-stylesheet type="text/xsl" href="..\..\XSLTemplates\CommandsStyleSheet.xsl"?>
<Command>
<Name>scan &lt; ioname &gt; [ [ addr ] | [ &lt; on | off &gt; ] | [ &lt; value &gt; ] | [ &lt; bon | boff &gt; ] | [ &lt; son | soff &gt; ] ]</Name>
<Description>
<DescriptionText><text>
This is the top level I/O scanner command.  It allows users to display the
current state of all local or remote system I/O 'points'.  An I/O points is
either a 32-bit value considered as a unit (typically an analog value) or a
single discrete bit that is a members of 32-bit discrete I/O group.
</text></DescriptionText>
<DescriptionText><text>
I/O groups are always a full 32-bits wide regardless of how many bits are
actually implemented within the group.  Analog values are always contained
within a single I/O group dedicated to only one scalar value.  Discrete I/O
bits are contained somewhere within a 32-bit discrete I/O group.  Not all
bits within any given I/O group (analog or discrete) are necessarily implemented.
The following commands allows various I/O displays options:
</text></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan &lt;ioname&gt;".  This command displays the state of any unique I/O point
if the full I/O name is entered for &lt;ioname&gt; or all I/O points matching the
&lt;ioname&gt; specification up to the number of characters entered.
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan &lt;ioname&gt; on|off". This command allows the discrete I/O point specified
by &lt;ioname&gt; to be 'forced' on ("scan &lt;ioname&gt; on") or off ("scan &lt;ioname&gt; off").
This command is available in engineering firmware builds only.  The entire I/O
name must be specified.
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan &lt;ioname&gt; &lt;value&gt;". This command allows the value specifed to be written
to the specified group as long as the group is an analog output. This command
is available in engineering firmware builds only.  The entire I/O group name
must be specified.
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan ioname bon|boff".  This command allows 'bypass' status to be turned on
("scan &lt;ioname&gt; bon") or off ("scan &lt;ioname&gt; boff") for the I/O point specified
by &lt;ioname&gt;.  The entire I/O name must be specified.  See the command 'scan
bstatus' for more information on bypassing.
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan ioname son|soff"  This command allows scanning to be turned on
("scan &lt;ioname&gt; son") or off ("scan &lt;ioname&gt; soff") set for the I/O group
I/O specified by &lt;ioname&gt;.  This command is available in engineering firmware
builds only.  Only a group names are valid for &lt;ioname&gt;.  It is not possible
to disable scanning for a discrete IO bit unless the entire group of which it
is a member is disabled. The command "scan bits" can be used to determine the
group to which an I/O bit belongs.
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan ioname addr"  This command displays address and register information
for the remote I/O group specified by &lt;ioname&gt;.  The entire I/O group name must
be specified.
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><text>
Commands are also available for the following operations (Go to "See Also"
below for links to more information on these commands and read the "Notes"
section below for important background information )
</text></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
"scan groups"......List all I/O groups
</Text></ListItem>
<ListItem><Text>
"scan bits"..........List all I/O bits
</Text></ListItem>
<ListItem><Text>
"scan presence"...List all 'presence' bits
</Text></ListItem>
<ListItem><Text>
"scan bclear".......List all 'bypass' statuses
</Text></ListItem>
<ListItem><Text>
"scan bstatus"....Clear all 'bypass' statuses
</Text></ListItem>
<ListItem><Text>
"scan time".........Display scanner time diagnostics
</Text></ListItem>
<ListItem><Text>
"scan events"......Display I/O bits connected to system event flags
</Text></ListItem>
</UnnumberedList></DescriptionText>
</Description>
<AppliesTo>
<UnnumberedList>
<ListItem><TextApplies>Trendsetter_400/800</TextApplies></ListItem>
<ListItem><TextApplies>Trendsetter_NEWS</TextApplies></ListItem>
</UnnumberedList>
</AppliesTo>
<Syntax>
<NumberedList>
<ListItem><Text>
scan groups
</Text></ListItem>
<ListItem><Text>
scan bits
</Text></ListItem>
<ListItem><Text>
scan presence
</Text></ListItem>
<ListItem><Text>
scan bclear
</Text></ListItem>
<ListItem><Text>
scan bstatus
</Text></ListItem>
<ListItem><Text>
scan time
</Text></ListItem>
<ListItem><Text>
scan time [&lt;clear&gt;]
</Text></ListItem>
<ListItem><Text>
scan events
</Text></ListItem>
<ListItem><Text>
scan &lt;ioname&gt;
</Text></ListItem>
<ListItem><Text>
scan &lt;ioname&gt; [&lt;addr&gt;]
</Text></ListItem>
<ListItem><Text>
scan &lt;ioname&gt; [&lt;on|off&gt;]
</Text></ListItem>
<ListItem><Text>
scan &lt;ioname&gt; [&lt;value&gt;]
</Text></ListItem>
<ListItem><Text>
scan &lt;ioname&gt; [&lt;bon|boff&gt;]
</Text></ListItem>
<ListItem><Text>
scan &lt;ioname&gt; [&lt;son|soff&gt;]
</Text></ListItem>
</NumberedList>
</Syntax>
<Notes>
<DescriptionText><text>
All I/O bits or groups are accessed with the scan command by a 'standard
firmware name'.  Standard firmware names generally have similar functionality
in all CTP machines.  For example, users used to a name for a given I/O point
in one product will find the same name for an I/O point with an identical
function in another product.  A standard firmware name has the general form
'XXX_ProperCaseName' where 'XXX' is a class mnemonic referring to the machine
subsystem in which the I/O bit or group is used and 'ProperCaseName' is a name
describing the function of the I/O in a reasonably concise way.  The class
component and the proper name component are always separated a single
underscore character.  The class mnemonic can be any length but is usually
two to four characters in length.  Examples:
</text></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
UI_LampStartButton
</Text></ListItem>
<ListItem><Text>
UI_Buzzer
</Text></ListItem>
<ListItem><Text>
CH_Power
</Text></ListItem>
<ListItem><Text>
DOOR_FrontLock
</Text></ListItem>
<ListItem><Text>
RLR_SensorHomeSideDown
</Text></ListItem>
<ListItem><Text>
REG_Sensor1
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><text>
Where "UI" = "User Interface",  "CH" = "Chiller", "RLR" = "Roller" and
"REG" = "Registration".
</text></DescriptionText>
<DescriptionText><text>
Analog I/O is the one case where the class portion of the name is fixed.  A
class name of "AI_" denotes an analog input.  A class name of "AO_" (that's
the letter O not a zero) denotes an analog output.  This convention allows the
isolation of all analog values into a easily displayable list.  Following are
some self-explanatory examples of analog standard firmware names:
</text></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
AI_BallScrewTemp
</Text></ListItem>
<ListItem><Text>
AI_SystemPressure
</Text></ListItem>
<ListItem><Text>
AI_MainBoardTemp
</Text></ListItem>
<ListItem><Text>
AI_EngineTemp
</Text></ListItem>
<ListItem><Text>
AI_DrumVacuum
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><text>
The only exception to the standard firmware I/O naming convention above is in
the case of 'presence bits'.  A presence bit is a discrete input bit used to
indicate if a particular hardware component is detected in a machine.  These
bits have no operational function other than to flag missing hardware.  Presence
names always contain an ampersand character after the underscore separating the
class mnemonic and the proper name. Examples:
</text></DescriptionText>
<DescriptionText><UnnumberedList>
<ListItem><Text>
EH_&amp;PowerCable              (Head power cable presence)
</Text></ListItem>
<ListItem><Text>
TE_&amp;Tach",                  (Tach encoder presence)
</Text></ListItem>
</UnnumberedList></DescriptionText>
<DescriptionText><text>
Where "EH" = "Exposure Head" and "TE" = "Tachometer Encoder".
</text></DescriptionText>
</Notes>
<Availability>
<DescriptionText><text>
This command is available.
</text></DescriptionText>
</Availability>
<Access>
Field
</Access>
<LastModified>
18-Jun-2001
</LastModified>
<SeeAlso>
<UnnumberedList>
<li><Link><LinkAddress>../commands/scan_groups.xml</LinkAddress><LinkTitle>Command: scan groups</LinkTitle></Link></li>
<li><Link><LinkAddress>../commands/scan_bits.xml</LinkAddress><LinkTitle>Command: scan bits</LinkTitle></Link></li>
<li><Link><LinkAddress>../commands/scan_presence.xml</LinkAddress><LinkTitle>Command: scan presence</LinkTitle></Link></li>
<li><Link><LinkAddress>../commands/scan_bclear.xml</LinkAddress><LinkTitle>Command: scan bclear</LinkTitle></Link></li>
<li><Link><LinkAddress>../commands/scan_bstatus.xml</LinkAddress><LinkTitle>Command: scan bstatus</LinkTitle></Link></li>
<li><Link><LinkAddress>../commands/scan_time.xml</LinkAddress><LinkTitle>Command: scan time</LinkTitle></Link></li>
<li><Link><LinkAddress>../commands/scan_events.xml</LinkAddress><LinkTitle>Command: scan events</LinkTitle></Link></li>
</UnnumberedList>
</SeeAlso>
<OtherLinks>
<Link><LinkAddress>..\..\ShowAllErrors.htm</LinkAddress><LinkTitle>Firmware 1 Error Index</LinkTitle></Link>
<Link><LinkAddress>..\..\ShowAllCommands.htm</LinkAddress><LinkTitle>Firmware 1 Command Index</LinkTitle></Link>
<Link><LinkAddress>..\..\ShowAllParameters.htm</LinkAddress><LinkTitle>Firmware 1 Parameter Index</LinkTitle></Link>
</OtherLinks>
<Updated>
Updated: Thu Jul 17 07:25:27 2008 PST
</Updated>
<Links>
</Links>
</Command>
