doc: Update altusmetrum docs and screen shots for 1.4

Signed-off-by: Keith Packard <keithp@keithp.com>

12 files changed, 116 insertions, 8 deletions

diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl
index f91ac191..de541147 100644
--- a/doc/altusmetrum.xsl
+++ b/doc/altusmetrum.xsl
@@ -2772,10 +2772,19 @@ NAR #88757, TRA #12200
           dark blue for main, and black for landed.
         </para>
         <para>
-          The map's scale is approximately 3m (10ft) per pixel. The map
+          The map's default scale is approximately 3m (10ft) per pixel. The map
           can be dragged using the left mouse button. The map will attempt
           to keep the rocket roughly centered while data is being received.
         </para>
+	<para>
+	  You can adjust the style of map and the zoom level with
+	  buttons on the right side of the map window. You can draw a
+	  line on the map by moving the mouse over the map with a
+	  button other than the left one pressed, or by pressing the
+	  left button while also holding down the shift key. The
+	  length of the line in real-world units will be shown at the
+	  start of the line.
+	</para>
         <para>
           Images are fetched automatically via the Google Maps Static API,
           and cached on disk for reuse. If map images cannot be downloaded,
@@ -2787,6 +2796,24 @@ NAR #88757, TRA #12200
 	  before you leave home; check out the 'Preload Maps' section below.
 	</para>
       </section>
+      <section>
+        <title>Ignitor</title>
+	<informalfigure>
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="ignitor.png" width="5.5in"/>
+	    </imageobject>
+	  </mediaobject>
+	</informalfigure>
+        <para>
+          TeleMega includes four additional programmable pyro
+          channels. The Ignitor tab shows whether each of them has
+          continuity. If an ignitor has a low resistance, then the
+          voltage measured here will be close to the pyro battery
+          voltage. A value greater than 3.2V is required for a 'GO'
+          status.
+	</para>
+      </section>
     </section>
     <section>
       <title>Save Flight Data</title>
@@ -3053,7 +3080,21 @@ NAR #88757, TRA #12200
         </para>
       </section>
       <section>
-        <title>Radio Frequency</title>
+        <title>Apogee Lockoug</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>Frequency</title>
         <para>
           This configures which of the frequencies to use for both
           telemetry and packet command mode. Note that if you set this
@@ -3111,12 +3152,11 @@ NAR #88757, TRA #12200
 	</para>
       </section>
       <section>
-        <title>Ignite Mode</title>
+        <title>Ignitor Firing Mode</title>
 	<para>
-	  TeleMetrum and TeleMini provide two igniter channels as they
-	  were originally designed as dual-deploy flight
-	  computers. This configuration parameter allows the two
-	  channels to be used in different configurations.
+	  This configuration parameter allows the two standard ignitor
+	  channels (Apogee and Main) to be used in different
+	  configurations.
 	</para>
           <variablelist>
 	    <varlistentry>
@@ -3187,6 +3227,16 @@ NAR #88757, TRA #12200
 	</variablelist>
       </section>
       <section>
+        <title>Beeper Frequency</title>
+	<para>
+	  The beeper on all Altus Metrum flight computers works best
+	  at 4000Hz, however if you have more than one flight computer
+	  in a single airframe, having all of them sound at the same
+	  frequency can be confusing. This parameter lets you adjust
+	  the base beeper frequency value.
+	</para>
+      </section>
+      <section>
 	<title>Configure Pyro Channels</title>
 	<informalfigure>
 	  <mediaobject>
@@ -3212,6 +3262,11 @@ NAR #88757, TRA #12200
 	  the same condition with different channels.
 	</para>
 	<para>
+	  At the bottom of the window, the 'Pyro Firing Time'
+	  configuration sets the length of time (in seconds) which
+	  each of these pyro channels will fire for.
+	</para>
+	<para>
 	  Once you have selected the appropriate configuration for all
 	  of the necessary pyro channels, you can save the pyro
 	  configuration along with the rest of the flight computer
@@ -3498,9 +3553,62 @@ NAR #88757, TRA #12200
 	and name of the site. The contents of this list are actually
 	downloaded from our server at run-time, so as new sites are sent 
 	in, they'll get automatically added to this list.
+	If the launch site isn't in the list, you can manually enter the lat/lon values
       </para>
       <para>
-	If the launch site isn't in the list, you can manually enter the lat/lon values
+	There are four different kinds of maps you can view; you can
+	select which to download by selecting as many as you like from
+	the available types:
+	<variablelist>
+	  <varlistentry>
+	    <term>Hybrid</term>
+	    <listitem>
+	      <para>
+		A combination of satellite imagery and road data. This
+		is the default view.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>Satellite</term>
+	    <listitem>
+	      <para>
+		Just the satellite imagery without any annotation.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>Roadmap</term>
+	    <listitem>
+	      <para>
+		Roads, political boundaries and a few geographic features.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>Terrain</term>
+	    <listitem>
+	      <para>
+		Contour intervals and shading that show hills and
+		valleys.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+      <para>
+	You can specify the range of zoom levels to download; smaller
+	numbers show more area with less resolution. The default
+	level, 0, shows about 3m/pixel. One zoom level change
+	doubles or halves that number.
+      </para>
+      <para>
+	The Tile Radius value sets how large an area around the center
+	point to download. Each tile is 512x512 pixels, and the
+	'radius' value specifies how many tiles away from the center
+	will be downloaded. Specify a radius of 0 and you get only the
+	center tile. A radius of 1 loads a 3x3 grid, centered on the
+	specified location.
       </para>
       <para>
 	Clicking the 'Load Map' button will fetch images from Google
diff --git a/doc/ascent.png b/doc/ascent.png
index d486d19c..2d62f06e 100644
--- a/doc/ascent.png
+++ b/doc/ascent.png
diff --git a/doc/configure-altimeter.png b/doc/configure-altimeter.png
index afb19325..514db3ed 100644
--- a/doc/configure-altimeter.png
+++ b/doc/configure-altimeter.png
diff --git a/doc/configure-pyro.png b/doc/configure-pyro.png
index 1c6ae066..599d45b5 100644
--- a/doc/configure-pyro.png
+++ b/doc/configure-pyro.png
diff --git a/doc/descent.png b/doc/descent.png
index 4ac4b962..5a7baadd 100644
--- a/doc/descent.png
+++ b/doc/descent.png
diff --git a/doc/graph-configure.png b/doc/graph-configure.png
index d3374ba8..ed0d5112 100644
--- a/doc/graph-configure.png
+++ b/doc/graph-configure.png
diff --git a/doc/graph-map.png b/doc/graph-map.png
index fd0fb134..bcea5ff8 100644
--- a/doc/graph-map.png
+++ b/doc/graph-map.png
diff --git a/doc/ignitor.png b/doc/ignitor.png
new file mode 100644
index 00000000..d1f5aebe
--- /dev/null
+++ b/doc/ignitor.png
diff --git a/doc/landed.png b/doc/landed.png
index 777d2445..a58cfbf4 100644
--- a/doc/landed.png
+++ b/doc/landed.png
diff --git a/doc/launch-pad.png b/doc/launch-pad.png
index a7a05c08..f2c41e6b 100644
--- a/doc/launch-pad.png
+++ b/doc/launch-pad.png
diff --git a/doc/load-maps.png b/doc/load-maps.png
index dc7ea64c..ae98c9a5 100644
--- a/doc/load-maps.png
+++ b/doc/load-maps.png
diff --git a/doc/site-map.png b/doc/site-map.png
index 755e7361..ebac1dfb 100644
--- a/doc/site-map.png
+++ b/doc/site-map.png