Keep tables together on a page
[fw/altos] / doc / altusmetrum.xsl
index 302b8d6041363cc2abd8d39c4f1a7f950e9a2684..659ea2f91125b0eb03321f5d8e8843efc049e3bd 100644 (file)
     </revhistory>
   </bookinfo>
   <dedication>
-    <title>Acknowledgements</title>
+    <title>Acknowledgments</title>
     <para>
       Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing “The
       Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter
@@ -329,6 +329,7 @@ NAR #88757, TRA #12200
       </para>
       <table frame='all'>
        <title>Altus Metrum Electronics</title>
+       <?dbfo keep-together="always"?>
        <tgroup cols='8' align='center' colsep='1' rowsep='1'>
          <colspec align='center' colwidth='*' colname='Device'/>
          <colspec align='center' colwidth='*' colname='Barometer'/>
@@ -436,6 +437,7 @@ NAR #88757, TRA #12200
       </table>
       <table frame='all'>
        <title>Altus Metrum Boards</title>
+       <?dbfo keep-together="always"?>
        <tgroup cols='6' align='center' colsep='1' rowsep='1'>
          <colspec align='center' colwidth='*' colname='Device'/>
          <colspec align='center' colwidth='*' colname='Connectors'/>
@@ -481,7 +483,7 @@ NAR #88757, TRA #12200
              </para></entry>
              <entry>½ inch (1.27cm)</entry>
              <entry>1½ inch (3.81cm)</entry>
-             <entry>18mm aiframe</entry>
+             <entry>18mm airframe</entry>
            </row>
            <row>
              <entry>TeleMini <?linebreak?>v2.0</entry>
@@ -612,6 +614,7 @@ NAR #88757, TRA #12200
       </para>
       <table frame='all'>
        <title>Data Storage on Altus Metrum altimeters</title>
+       <?dbfo keep-together="always"?>
        <tgroup cols='4' align='center' colsep='1' rowsep='1'>
          <colspec align='center' colwidth='*' colname='Device'/>
          <colspec align='center' colwidth='*' colname='Bytes per sample'/>
@@ -1286,7 +1289,7 @@ NAR #88757, TRA #12200
                </listitem>
                <listitem>
                  <para>
-                   Main. The rocket is still descending, and is blow
+                   Main. The rocket is still descending, and is below
                    the Main altitude
                  </para>
                </listitem>
@@ -1300,9 +1303,9 @@ NAR #88757, TRA #12200
            <para>
              You can select a state to limit when the pyro channel
              may activate; note that the check is based on when the
-             rocket transitions *into* the state, and so checking for
-             'greater than Boost' means that the rocket is currently
-             in boost state.
+             rocket transitions <emphasis>into</emphasis> the state, and so checking for
+             “greater than Boost” means that the rocket is currently
+             in boost or some later state.
            </para>
            <para>
              When a motor burns out, the rocket enters either Fast or
@@ -1410,64 +1413,82 @@ NAR #88757, TRA #12200
           rocket is ready for flight. The first elements include red/green
           indicators, if any of these is red, you'll want to evaluate
           whether the rocket is ready to launch:
-          <itemizedlist>
-            <listitem>
-              <para>
-                Battery Voltage. This indicates whether the Li-Po battery
-                powering the TeleMetrum has sufficient charge to last for
-                the duration of the flight. A value of more than
-                3.7V is required for a 'GO' status.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Apogee Igniter Voltage. This indicates whether the apogee
-                igniter has continuity. If the igniter has a low
-                resistance, then the voltage measured here will be close
-                to the Li-Po battery voltage. A value greater than 3.2V is
-                required for a 'GO' status.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Main Igniter Voltage. This indicates whether the main
-                igniter has continuity. If the igniter has a low
-                resistance, then the voltage measured here will be close
-                to the Li-Po battery voltage. A value greater than 3.2V is
-                required for a 'GO' status.
-              </para>
-            </listitem>
-           <listitem>
-             <para>
-               On-board Data Logging. This indicates whether there is
-               space remaining on-board to store flight data for the
-               upcoming flight. If you've downloaded data, but failed
-               to erase flights, there may not be any space
-               left. TeleMetrum can store multiple flights, depending
-               on the configured maximum flight log size. TeleMini
-               stores only a single flight, so it will need to be
-               downloaded and erased after each flight to capture
-               data. This only affects on-board flight logging; the
-               altimeter will still transmit telemetry and fire
-               ejection charges at the proper times.
-             </para>
-           </listitem>
-            <listitem>
-              <para>
-                GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is
-                currently able to compute position information. GPS requires
-                at least 4 satellites to compute an accurate position.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least
-                10 consecutive positions without losing lock. This ensures
-                that the GPS receiver has reliable reception from the
-                satellites.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+           <varlistentry>
+             <term>Battery Voltage</term>
+             <listitem>
+               <para>
+                 This indicates whether the Li-Po battery
+                 powering the TeleMetrum has sufficient charge to last for
+                 the duration of the flight. A value of more than
+                 3.8V is required for a 'GO' status.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>Apogee Igniter Voltage</term>
+             <listitem>
+               <para>
+                 This indicates whether the apogee
+                 igniter has continuity. If the igniter has a low
+                 resistance, then the voltage measured here will be close
+                 to the Li-Po battery voltage. A value greater than 3.2V is
+                 required for a 'GO' status.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>Main Igniter Voltage</term>
+             <listitem>
+               <para>
+                 This indicates whether the main
+                 igniter has continuity. If the igniter has a low
+                 resistance, then the voltage measured here will be close
+                 to the Li-Po battery voltage. A value greater than 3.2V is
+                 required for a 'GO' status.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>On-board Data Logging</term>
+             <listitem>
+               <para>
+                 This indicates whether there is
+                 space remaining on-board to store flight data for the
+                 upcoming flight. If you've downloaded data, but failed
+                 to erase flights, there may not be any space
+                 left. TeleMetrum can store multiple flights, depending
+                 on the configured maximum flight log size. TeleMini
+                 stores only a single flight, so it will need to be
+                 downloaded and erased after each flight to capture
+                 data. This only affects on-board flight logging; the
+                 altimeter will still transmit telemetry and fire
+                 ejection charges at the proper times.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>GPS Locked</term>
+             <listitem>
+               <para>
+                 For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is
+                 currently able to compute position information. GPS requires
+                 at least 4 satellites to compute an accurate position.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>GPS Ready</term>
+             <listitem>
+               <para>
+                 For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least
+                 10 consecutive positions without losing lock. This ensures
+                 that the GPS receiver has reliable reception from the
+                 satellites.
+               </para>
+             </listitem>
+           </varlistentry>
+          </variablelist>
         </para>
        <para>
          The Launchpad tab also shows the computed launch pad position
@@ -1662,15 +1683,48 @@ NAR #88757, TRA #12200
         flash memory.
       </para>
       <para>
-        Once a flight record is selected, a window with four tabs is
-        opened. The first tab contains a graph with acceleration
-        (blue), velocity (green) and altitude (red) of the flight,
-        measured in metric units. The apogee(yellow) and main(magenta)
-        igniter voltages are also displayed; high voltages indicate
-        continuity, low voltages indicate open circuits. The second
-        tab lets you configure which data to show in the graph.  The
-        third contains some basic flight statistics while the fourth
-        has a map with the ground track of the flight displayed.
+        Once a flight record is selected, a window with multiple tabs is
+        opened.
+       <variablelist>
+         <varlistentry>
+           <term>Flight Graph</term>
+           <listitem>
+             <para>
+               By default, the graph contains acceleration (blue),
+               velocity (green) and altitude (red).
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>Configure Graph</term>
+           <listitem>
+             <para>
+               This selects which graph elements to show, and, at the
+               very bottom, lets you switch between metric and
+               imperial units
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>Flight Statistics</term>
+           <listitem>
+             <para>
+               Shows overall data computed from the flight.
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>Map</term>
+           <listitem>
+             <para>
+               Shows a satellite image of the flight area overlaid
+               with the path of the flight. The red concentric
+               circles mark the launch pad, the black concentric
+               circles mark the landing location.
+             </para>
+           </listitem>
+         </varlistentry>
+       </variablelist>
       </para>
       <para>
         The graph can be zoomed into a particular area by clicking and
@@ -1742,35 +1796,47 @@ NAR #88757, TRA #12200
       <para>
         At the bottom of the dialog, there are four buttons:
       </para>
-      <itemizedlist>
-        <listitem>
-          <para>
-            Save. This writes any changes to the
-            configuration parameter block in flash memory. If you don't
-            press this button, any changes you make will be lost.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            Reset. This resets the dialog to the most recently saved values,
-            erasing any changes you have made.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            Reboot. This reboots the device. Use this to
-            switch from idle to pad mode by rebooting once the rocket is
-            oriented for flight, or to confirm changes you think you saved 
-           are really saved.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            Close. This closes the dialog. Any unsaved changes will be
-            lost.
-          </para>
-        </listitem>
-      </itemizedlist>
+      <variablelist>
+       <varlistentry>
+         <term>Save</term>
+         <listitem>
+           <para>
+             This writes any changes to the
+             configuration parameter block in flash memory. If you don't
+             press this button, any changes you make will be lost.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>Reset</term>
+         <listitem>
+           <para>
+             This resets the dialog to the most recently saved values,
+             erasing any changes you have made.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>Reboot</term>
+         <listitem>
+           <para>
+             This reboots the device. Use this to
+             switch from idle to pad mode by rebooting once the rocket is
+             oriented for flight, or to confirm changes you think you saved 
+             are really saved.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>Close</term>
+         <listitem>
+           <para>
+             This closes the dialog. Any unsaved changes will be
+             lost.
+           </para>
+         </listitem>
+       </varlistentry>
+      </variablelist>
       <para>
         The rest of the dialog contains the parameters to be configured.
       </para>
@@ -1862,32 +1928,41 @@ NAR #88757, TRA #12200
          computers. This configuration parameter allows the two
          channels to be used in different configurations.
        </para>
-       <itemizedlist>
-         <listitem>
-           <para>
-             Dual Deploy. This is the usual mode of operation; the
-             'apogee' channel is fired at apogee and the 'main'
-             channel at the height above ground specified by the
-             'Main Deploy Altitude' during descent.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Redundant Apogee. This fires both channels at
-             apogee, the 'apogee' channel first followed after a two second
-             delay by the 'main' channel.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Redundant Main. This fires both channels at the
-             height above ground specified by the Main Deploy
-             Altitude setting during descent. The 'apogee'
-             channel is fired first, followed after a two second
-             delay by the 'main' channel.
-           </para>
-         </listitem>
-       </itemizedlist>
+          <variablelist>
+           <varlistentry>
+             <term>Dual Deploy</term>
+             <listitem>
+               <para>
+                 This is the usual mode of operation; the
+                 'apogee' channel is fired at apogee and the 'main'
+                 channel at the height above ground specified by the
+                 'Main Deploy Altitude' during descent.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>Redundant Apogee</term>
+             <listitem>
+               <para>
+                 This fires both channels at
+                 apogee, the 'apogee' channel first followed after a two second
+                 delay by the 'main' channel.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>Redundant Main</term>
+             <listitem>
+               <para>
+                 This fires both channels at the
+                 height above ground specified by the Main Deploy
+                 Altitude setting during descent. The 'apogee'
+                 channel is fired first, followed after a two second
+                 delay by the 'main' channel.
+               </para>
+             </listitem>
+           </varlistentry>
+       </variablelist>
       </section>
       <section>
         <title>Pad Orientation</title>
@@ -1898,22 +1973,28 @@ NAR #88757, TRA #12200
          parameter allows that default to be changed, permitting the
          board to be mounted with the antenna pointing aft instead.
        </para>
-       <itemizedlist>
-         <listitem>
-           <para>
-             Antenna Up. In this mode, the antenna end of the
-             TeleMetrum board must point forward, in line with the
-             expected flight path.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Antenna Down. In this mode, the antenna end of the
-             TeleMetrum board must point aft, in line with the
-             expected flight path.
-           </para>
-         </listitem>
-       </itemizedlist>
+       <variablelist>
+         <varlistentry>
+           <term>Antenna Up</term>
+           <listitem>
+             <para>
+               In this mode, the antenna end of the
+               TeleMetrum board must point forward, in line with the
+               expected flight path.
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>Antenna Down</term>
+           <listitem>
+             <para>
+               In this mode, the antenna end of the
+               TeleMetrum board must point aft, in line with the
+               expected flight path.
+             </para>
+           </listitem>
+         </varlistentry>
+       </variablelist>
       </section>
       <section>
        <title>Configure Pyro Channels</title>
@@ -1922,92 +2003,10 @@ NAR #88757, TRA #12200
          pyro channels available on TeleMega.  One column is
          presented for each channel. Each row represents a single
          parameter, if enabled the parameter must meet the specified
-         test for the pyro channel to be fired.
+         test for the pyro channel to be fired. See the Pyro Channels
+         section in the System Operation chapter above for a
+         description of these parameters.
        </para>
-       <itemizedlist>
-         <listitem>
-           <para>
-             Acceleration less than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Acceleration greater than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Speed less than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Speed greater than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Height less than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Height greater than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Angle from vertical less than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Angle from vertical greater than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Time since boost less than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Time since boost greater than.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Ascending. This is exactly the same as setting a
-             condition for speed &gt; 0.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Descending. This is exactly the same as setting a
-             condition for speed &lt; 0.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             After motor number.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Delay after other conditions.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Flight state before.
-           </para>
-         </listitem>
-         <listitem>
-           <para>
-             Flight state after.
-           </para>
-         </listitem>
-       </itemizedlist>
        <para>
          Select conditions and set the related value; the pyro
          channel will be activated when <emphasis>all</emphasis> of the
@@ -2142,27 +2141,36 @@ NAR #88757, TRA #12200
       <para>
         At the bottom of the dialog, there are three buttons:
       </para>
-      <itemizedlist>
-        <listitem>
-          <para>
-            Save. This writes any changes to the
-            local Java preferences file. If you don't
-            press this button, any changes you make will be lost.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            Reset. This resets the dialog to the most recently saved values,
-            erasing any changes you have made.
-          </para>
-        </listitem>
-        <listitem>
-          <para>
-            Close. This closes the dialog. Any unsaved changes will be
-            lost.
-          </para>
-        </listitem>
-      </itemizedlist>
+      <variablelist>
+       <varlistentry>
+         <term>Save</term>
+         <listitem>
+           <para>
+             This writes any changes to the
+             local Java preferences file. If you don't
+             press this button, any changes you make will be lost.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>Reset</term>
+         <listitem>
+           <para>
+             This resets the dialog to the most recently saved values,
+             erasing any changes you have made.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>Close</term>
+         <listitem>
+           <para>
+             This closes the dialog. Any unsaved changes will be
+             lost.
+           </para>
+         </listitem>
+       </varlistentry>
+      </variablelist>
       <para>
         The rest of the dialog contains the parameters to be configured.
       </para>
@@ -2382,64 +2390,82 @@ NAR #88757, TRA #12200
           rocket is ready for flight. The first elements include red/green
           indicators, if any of these is red, you'll want to evaluate
           whether the rocket is ready to launch:
-          <itemizedlist>
-            <listitem>
-              <para>
-                Battery Voltage. This indicates whether the Li-Po battery
-                powering the TeleMetrum has sufficient charge to last for
-                the duration of the flight. A value of more than
-                3.7V is required for a 'GO' status.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Apogee Igniter Voltage. This indicates whether the apogee
-                igniter has continuity. If the igniter has a low
-                resistance, then the voltage measured here will be close
-                to the Li-Po battery voltage. A value greater than 3.2V is
-                required for a 'GO' status.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Main Igniter Voltage. This indicates whether the main
-                igniter has continuity. If the igniter has a low
-                resistance, then the voltage measured here will be close
-                to the Li-Po battery voltage. A value greater than 3.2V is
-                required for a 'GO' status.
-              </para>
-            </listitem>
-           <listitem>
-             <para>
-               On-board Data Logging. This indicates whether there is
-               space remaining on-board to store flight data for the
-               upcoming flight. If you've downloaded data, but failed
-               to erase flights, there may not be any space
-               left. TeleMetrum can store multiple flights, depending
-               on the configured maximum flight log size. TeleMini
-               stores only a single flight, so it will need to be
-               downloaded and erased after each flight to capture
-               data. This only affects on-board flight logging; the
-               altimeter will still transmit telemetry and fire
-               ejection charges at the proper times.
-             </para>
-           </listitem>
-            <listitem>
-              <para>
-                GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is
-                currently able to compute position information. GPS requires
-                at least 4 satellites to compute an accurate position.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least
-                10 consecutive positions without losing lock. This ensures
-                that the GPS receiver has reliable reception from the
-                satellites.
-              </para>
-            </listitem>
-          </itemizedlist>
+          <variablelist>
+           <varlistentry>
+             <term>Battery Voltage</term>
+             <listitem>
+               <para>
+                 This indicates whether the Li-Po battery
+                 powering the TeleMetrum has sufficient charge to last for
+                 the duration of the flight. A value of more than
+                 3.8V is required for a 'GO' status.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>Apogee Igniter Voltage</term>
+             <listitem>
+               <para>
+                 This indicates whether the apogee
+                 igniter has continuity. If the igniter has a low
+                 resistance, then the voltage measured here will be close
+                 to the Li-Po battery voltage. A value greater than 3.2V is
+                 required for a 'GO' status.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>Main Igniter Voltage</term>
+             <listitem>
+               <para>
+                 This indicates whether the main
+                 igniter has continuity. If the igniter has a low
+                 resistance, then the voltage measured here will be close
+                 to the Li-Po battery voltage. A value greater than 3.2V is
+                 required for a 'GO' status.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>On-board Data Logging</term>
+             <listitem>
+               <para>
+                 This indicates whether there is
+                 space remaining on-board to store flight data for the
+                 upcoming flight. If you've downloaded data, but failed
+                 to erase flights, there may not be any space
+                 left. TeleMetrum can store multiple flights, depending
+                 on the configured maximum flight log size. TeleMini
+                 stores only a single flight, so it will need to be
+                 downloaded and erased after each flight to capture
+                 data. This only affects on-board flight logging; the
+                 altimeter will still transmit telemetry and fire
+                 ejection charges at the proper times.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>GPS Locked</term>
+             <listitem>
+               <para>
+                 For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is
+                 currently able to compute position information. GPS requires
+                 at least 4 satellites to compute an accurate position.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term>GPS Ready</term>
+             <listitem>
+               <para>
+                 For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least
+                 10 consecutive positions without losing lock. This ensures
+                 that the GPS receiver has reliable reception from the
+                 satellites.
+               </para>
+             </listitem>
+           </varlistentry>
+          </variablelist>
        </para>
        <para>
          The Launchpad tab also shows the computed launch pad position
@@ -2526,7 +2552,8 @@ NAR #88757, TRA #12200
           if the rocket is hiding in sage brush or a tree, or if the last GPS position
           doesn't get you close enough because the rocket dropped into a canyon, or
           the wind is blowing it across a dry lake bed, or something like that...  Keith
-          and Bdale both currently own and use the Yaesu VX-7R at launches.
+          currently uses a Yaesu VX-7R, Bdale has a Baofung UV-5R
+         which isn't as nice, but was a whole lot cheaper.
         </para>
         <para>
           So, to recap, on the ground the hardware you'll need includes:
@@ -2861,7 +2888,7 @@ NAR #88757, TRA #12200
   <chapter>
     <title>Updating Device Firmware</title>
     <para>
-      TeleMega, TeleMetrum v2 and EasMini are all programmed directly
+      TeleMega, TeleMetrum v2 and EasyMini are all programmed directly
       over their USB connectors (self programming). TeleMetrum v1, TeleMini and
       TeleDongle are all programmed by using another device as a
       programmer (pair programming). It's important to recognize which
@@ -2883,13 +2910,6 @@ NAR #88757, TRA #12200
       Self-programmable devices (TeleMega, TeleMetrum v2 and EasyMini)
       are reprogrammed by connecting them to your computer over USB
     </para>
-    <para>
-      The big concept to understand is that you have to use a
-      TeleMega, TeleMetrum or TeleDongle as a programmer to update a
-      pair programmed device. Due to limited memory resources in the
-      cc1111, we don't support programming directly over USB for these
-      devices.
-    </para>
     <section>
       <title>
        Updating TeleMega, TeleMetrum v2 or EasyMini Firmware
@@ -2912,6 +2932,11 @@ NAR #88757, TRA #12200
            Run AltosUI, and select 'Flash Image' from the File menu.
          </para>
        </listitem>
+       <listitem>
+         <para>
+           Select the target device in the Device Selection dialog.
+         </para>
+       </listitem>
        <listitem>
          <para>
            Select the image you want to flash to the device, which
@@ -2940,6 +2965,72 @@ NAR #88757, TRA #12200
          </para>
        </listitem>
       </orderedlist>
+      <section>
+       <title>Recovering From Self-Flashing Failure</title>
+       <para>
+         If the firmware loading fails, it can leave the device
+         unable to boot. Not to worry, you can force the device to
+         start the boot loader instead, which will let you try to
+         flash the device again.
+       </para>
+       <para>
+         On each device, connecting two pins from one of the exposed
+         connectors will force the boot loader to start, even if the
+         regular operating system has been corrupted in some way.
+       </para>
+       <variablelist>
+         <varlistentry>
+           <term>TeleMega</term>
+           <listitem>
+             <para>
+               Connect pin 6 and pin 1 of the companion connector. Pin 1
+               can be identified by the square pad around it, and then
+               the pins could sequentially across the board. Be very
+               careful to <emphasis>not</emphasis> short pin 8 to
+               anything as that is connected directly to the battery. Pin
+               7 carries 3.3V and the board will crash if that is
+               connected to pin 1, but shouldn't damage the board.
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>TeleMetrum v2</term>
+           <listitem>
+             <para>
+               Connect pin 6 and pin 1 of the companion connector. Pin 1
+               can be identified by the square pad around it, and then
+               the pins could sequentially across the board. Be very
+               careful to <emphasis>not</emphasis> short pin 8 to
+               anything as that is connected directly to the battery. Pin
+               7 carries 3.3V and the board will crash if that is
+               connected to pin 1, but shouldn't damage the board.
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>EasyMini</term>
+           <listitem>
+             <para>
+               Connect pin 6 and pin 1 of the debug connector, which is
+               the six holes next to the beeper. Pin 1 can be identified
+               by the square pad around it, and then the pins could
+               sequentially across the board, making Pin 6 the one on the
+               other end of the row.
+             </para>
+           </listitem>
+         </varlistentry>
+       </variablelist>
+      </section>
+    </section>
+    <section>
+      <title>Pair Programming</title>
+      <para>
+       The big concept to understand is that you have to use a
+       TeleMega, TeleMetrum or TeleDongle as a programmer to update a
+       pair programmed device. Due to limited memory resources in the
+       cc1111, we don't support programming directly over USB for these
+       devices.
+      </para>
     </section>
     <section>
       <title>Updating TeleMetrum v1.x Firmware</title>
@@ -3231,7 +3322,8 @@ NAR #88757, TRA #12200
        </listitem>
        <listitem>
          <para>
-           Supports dual deployment and four auxilary pyro channels (can initiate 6 events).
+           Supports dual deployment and four auxiliary pyro channels
+           (a total of 6 events).
          </para>
        </listitem>
        <listitem>