doc: Document the Apogee Lockout setting

[fw/altos] / doc / altusmetrum.xsl

diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl
index fb08f5c642fa32f284ba2958a14d76a77b762794..39b3998a5154f35e35fa9042b56222b79340e736 100644 (file)
--- a/doc/altusmetrum.xsl
+++ b/doc/altusmetrum.xsl
@@ -1539,10 +1539,13 @@ NAR #88757, TRA #12200
         first five seconds of operation.
       </para>
       <para>
-        At power on, you will hear three beeps or see three flashes
-        (“S” in Morse code for start up) and then a pause while
-        the altimeter completes initialization and self test, and decides 
-       which mode to enter next.
+        At power on, the altimeter will beep out the battery voltage
+        to the nearest tenth of a volt.  Each digit is represented by
+        a sequence of short “dit” beeps, with a pause between
+        digits. A zero digit is represented with one long “dah”
+        beep. Then there will be a short pause while the altimeter
+        completes initialization and self test, and decides which mode
+        to enter next.
       </para>
       <para>
        Here's a short summary of all of the modes and the beeping (or
@@ -1570,7 +1573,7 @@ NAR #88757, TRA #12200
              <row>
                <entry>Startup</entry>
                <entry>S</entry>
-               <entry>dit dit dit</entry>
+               <entry>battery voltage in decivolts</entry>
                <entry>
                  <para>
                    Calibrating sensors, detecting orientation.
@@ -2180,6 +2183,20 @@ NAR #88757, TRA #12200
           way quite happily, including Keith's successful L3 cert.
         </para>
       </section>
+      <section>
+       <title>Apogee Lockout</title>
+       <para>
+         Apogee lockout is the number of seconds after boost where
+         the flight computer will not fire the apogee charge, even if
+         the rocket appears to be at apogee. This is often called
+         'Mach Delay', as it is intended to prevent a flight computer
+         from unintentionally firing apogee charges due to the pressure
+         spike that occurrs across a mach transition. Altus Metrum
+         flight computers include a Kalman filter which is not fooled
+         by this sharp pressure increase, and so this setting should
+         be left at the default value of zero to disable it.
+       </para>
+      </section>
       <section>
         <title>Main Deployment Altitude</title>
         <para>
@@ -5127,7 +5144,8 @@ NAR #88757, TRA #12200
       <informalfigure>
        <mediaobject id="TeleMegaTemplate">
          <imageobject>
-           <imagedata format="SVG" fileref="telemega-outline.svg"/>
+           <imagedata format="SVG" fileref="telemega.svg"
+                      scalefit="0" scale="100" align="center" />
          </imageobject>
        </mediaobject>
       </informalfigure>
@@ -5141,7 +5159,8 @@ NAR #88757, TRA #12200
       <informalfigure>
        <mediaobject id="TeleMetrumTemplate">
          <imageobject>
-           <imagedata format="SVG" fileref="telemetrum.svg"/>
+           <imagedata format="SVG" fileref="telemetrum.svg"
+                      scalefit="0" scale="100" align="center" />
          </imageobject>
        </mediaobject>
       </informalfigure>
@@ -5155,7 +5174,8 @@ NAR #88757, TRA #12200
       <informalfigure>
        <mediaobject id="MiniTemplate">
          <imageobject>
-           <imagedata format="SVG" fileref="easymini-outline.svg"/>
+           <imagedata format="SVG" fileref="easymini.svg"
+                      scalefit="0" scale="100" align="center" />
          </imageobject>
        </mediaobject>
       </informalfigure>
@@ -5169,7 +5189,8 @@ NAR #88757, TRA #12200
       <informalfigure>
        <mediaobject id="TeleMiniTemplate">
          <imageobject>
-           <imagedata format="SVG" fileref="telemini.svg"/>
+           <imagedata format="SVG" fileref="telemini.svg"
+                      scalefit="0" scale="100" align="center" />
          </imageobject>
        </mediaobject>
       </informalfigure>