<?xml version="1.0" standalone="yes"?>
<?xml-stylesheet type="text/xsl" href="..\..\XSLTemplates\CommandsStyleSheet.xsl"?>
<Command>
<Name>drum cal</Name>
<Description>
<DescriptionText><text>
This command is available starting at version 1.09 of the drum software module.
The purpose of this command is to calculate and put into effect a correction
offset  that will compensate for dead-band drift within the drive amp (in certain specific cases).
</text></DescriptionText>
<DescriptionText><text>
This command applies a torque ramp to the drum and measures the point at which movement occurs.
If that value of torque is above the drum friction (dfrict) then it sets the deadband offset
(doff) to the measured value minus dfrict.
</text></DescriptionText>
<DescriptionText><text>
The nvs needs to be saved to make the value permanent. The torque numbers displayed &amp; dfrict
&amp; doff are all in half-microseconds (which is proportional to torque.)
</text></DescriptionText>
<DescriptionText><text>
On drum module 1.11 and older,  if the current value of doff is greater that zero  then
doff is not updated by drum cal. Manually set doff to zero if required.
</text></DescriptionText>
<DescriptionText><text>
Encoder Required:  For this command to function a working encoder is required including the
index pulse.
</text></DescriptionText>
<DescriptionText><text>
The torque numbers displayed &amp; dfrict &amp; doff
are all in half-microseconds (which is proportional to torque.)
</text></DescriptionText>
<DescriptionText><text>
See procedure to set dfrict, under nvs dfrict on the nvs page.
</text></DescriptionText>
</Description>
<AppliesTo>
<UnnumberedList>
<ListItem><TextApplies>All</TextApplies></ListItem>
</UnnumberedList>
</AppliesTo>
<Syntax>
<NumberedList>
<ListItem><Text>
drum cal
</Text></ListItem>
</NumberedList>
</Syntax>
<Notes>
<DescriptionText><text>
This command is available only in drum module versions 1.09 and greater.
</text></DescriptionText>
<DescriptionText><text>
Before actual drum calibration is attempted, the DRUM CAL command tries
to get the drum to "settle".  This is done by releasing the dynamic break
and setting the drum drive zero.  Depending on the condition of the drum
amplifier, one of the following three things can occur:
</text></DescriptionText>
<DescriptionText><NumberedList>
<ListItem><Text>
The drum will turn slightly then stop (i.e. reach equilibrium)
</Text></ListItem>
<ListItem><Text>
The drum will continue to turn slowly for an indefinite time
</Text></ListItem>
<ListItem><Text>
The drum will accelerate
</Text></ListItem>
</NumberedList></DescriptionText>
<DescriptionText><text>
Case 1 is usual.  The calibration attempt will proceed normally after this.
Case 2 and 3 are error conditions.  In these cases the dynamic break will be
applied and the calibration will fail because the drum wont settle.  This
may be as result of negative deadband in the drum amplifier.  Case 2 occurs
if the drum does not stop within about 15 seconds.  Case 3 occurs if the
speed of the drum becomes greater than 30 RPM.
</text></DescriptionText>
</Notes>
<SeeAlso>
<UnnumberedList>
<li><Link><LinkAddress>../commands/drum.xml</LinkAddress><LinkTitle>Command: drum</LinkTitle></Link></li>
<li>NVS:  </li><li><Link><LinkAddress>../nvs/drum_cfg_doff.xml</LinkAddress><LinkTitle>NVS: drum doff</LinkTitle></Link></li>
<li>NVS:  </li><li><Link><LinkAddress>../nvs/drum_cfg_dfrict.xml</LinkAddress><LinkTitle>NVS: drum dfrict</LinkTitle></Link></li>
</UnnumberedList>
</SeeAlso>
<OtherLinks>
<Link><LinkAddress>..\..\ShowAllErrors.htm</LinkAddress><LinkTitle>Firmware 0 Error Index</LinkTitle></Link>
<Link><LinkAddress>..\..\ShowAllCommands.htm</LinkAddress><LinkTitle>Firmware 0 Command Index</LinkTitle></Link>
<Link><LinkAddress>..\..\ShowAllNVS.htm</LinkAddress><LinkTitle>Firmware 0 NVS Index</LinkTitle></Link>
</OtherLinks>
<Updated>
Updated: Wed Jul 16 19:38:57 2008 PST
</Updated>
<Links>
</Links>
</Command>
