doc: Get altusmetrum.xsl to validate
authorKeith Packard <keithp@keithp.com>
Mon, 18 Nov 2013 20:06:31 +0000 (12:06 -0800)
committerKeith Packard <keithp@keithp.com>
Mon, 18 Nov 2013 20:06:31 +0000 (12:06 -0800)
Mostly involved getting the listitem contents into para elements.

Signed-off-by: Keith Packard <keithp@keithp.com>
doc/altusmetrum.xsl
doc/release-notes-0.7.1.xsl
doc/release-notes-0.8.xsl
doc/release-notes-0.9.2.xsl
doc/release-notes-0.9.xsl
doc/release-notes-1.0.1.xsl
doc/release-notes-1.1.1.xsl
doc/release-notes-1.1.xsl
doc/release-notes-1.2.1.xsl
doc/release-notes-1.2.xsl
doc/release-notes-1.3.xsl

index 1df270bcc858328462607002d46987132ee7457c..5375e8c29462065bc775a141101b7856ac750ded 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8" ?>
+<?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">
 <book>
       </revision>
     </revhistory>
   </bookinfo>
-  <acknowledgements>
+  <dedication>
+    <title>Acknowledgements</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
@@ -130,7 +131,7 @@ Keith Packard, KD7SQG
 NAR #88757, TRA #12200
       </literallayout>
     </para>
-  </acknowledgements>
+  </dedication>
   <chapter>
     <title>Introduction and Overview</title>
     <para>
@@ -490,16 +491,24 @@ NAR #88757, TRA #12200
        configured as follows:
        <itemizedlist>
          <listitem>
+           <para>
            Sets the radio frequency to 434.550MHz
+           </para>
          </listitem>
          <listitem>
+           <para>
            Sets the radio calibration back to the factory value.
+           </para>
          </listitem>
          <listitem>
+           <para>
            Sets the callsign to N0CALL
+           </para>
          </listitem>
          <listitem>
+           <para>
            Does not go to 'pad' mode after five seconds.
+           </para>
          </listitem>
        </itemizedlist>
       </para>
@@ -991,12 +1000,12 @@ NAR #88757, TRA #12200
               </para>
             </listitem>
           </itemizedlist>
-          <para>
-            The Launchpad tab also shows the computed launch pad position
-            and altitude, averaging many reported positions to improve the
-            accuracy of the fix.
-          </para>
         </para>
+       <para>
+         The Launchpad tab also shows the computed launch pad position
+         and altitude, averaging many reported positions to improve the
+         accuracy of the fix.
+       </para>
       </section>
       <section>
         <title>Ascent</title>
@@ -1821,12 +1830,12 @@ NAR #88757, TRA #12200
               </para>
             </listitem>
           </itemizedlist>
-          <para>
-            The Launchpad tab also shows the computed launch pad position
-            and altitude, averaging many reported positions to improve the
-            accuracy of the fix.
-          </para>
-        </para>
+       </para>
+       <para>
+         The Launchpad tab also shows the computed launch pad position
+         and altitude, averaging many reported positions to improve the
+         accuracy of the fix.
+       </para>
       </section>
     </section>
     <section>
@@ -1913,19 +1922,29 @@ NAR #88757, TRA #12200
           So, to recap, on the ground the hardware you'll need includes:
           <orderedlist inheritnum='inherit' numeration='arabic'>
             <listitem>
-              an antenna and feed-line or adapter
+              <para>
+             an antenna and feed-line or adapter
+             </para>
             </listitem>
             <listitem>
-              a TeleDongle
+              <para>
+             a TeleDongle
+             </para>
             </listitem>
             <listitem>
-              a notebook computer
+              <para>
+             a notebook computer
+             </para>
             </listitem>
             <listitem>
-              optionally, a hand-held GPS receiver
+              <para>
+             optionally, a hand-held GPS receiver
+             </para>
             </listitem>
             <listitem>
-              optionally, an HT or receiver covering 435 MHz
+              <para>
+             optionally, an HT or receiver covering 435 MHz
+             </para>
             </listitem>
           </orderedlist>
         </para>
@@ -2021,14 +2040,18 @@ NAR #88757, TRA #12200
       </para>
       <orderedlist inheritnum='inherit' numeration='arabic'>
        <listitem>
-         Make sure TeleMetrum is aligned precisely along the axis of
-         acceleration so that the accelerometer can accurately
-         capture data during the flight.
+         <para>
+           Make sure TeleMetrum is aligned precisely along the axis of
+           acceleration so that the accelerometer can accurately
+           capture data during the flight.
+         </para>
        </listitem>
        <listitem>
-         Watch for any metal touching components on the
-         board. Shorting out connections on the bottom of the board
-         can cause the altimeter to fail during flight.
+         <para>
+           Watch for any metal touching components on the
+           board. Shorting out connections on the bottom of the board
+           can cause the altimeter to fail during flight.
+         </para>
        </listitem>
       </orderedlist>
     </section>
@@ -2094,18 +2117,22 @@ NAR #88757, TRA #12200
        attenuate the GPS signal.
       <orderedlist inheritnum='inherit' numeration='arabic'>
        <listitem>
-         Conductive tubing or coatings. Carbon fiber and metal
-         tubing, or metallic paint will all dramatically attenuate the
-         GPS signal. We've never heard of anyone successfully
-         receiving GPS from inside these materials.
+         <para>
+           Conductive tubing or coatings. Carbon fiber and metal
+           tubing, or metallic paint will all dramatically attenuate the
+           GPS signal. We've never heard of anyone successfully
+           receiving GPS from inside these materials.
+         </para>
        </listitem>
        <listitem>
-         Metal components near the GPS patch antenna. These will
-         de-tune the patch antenna, changing the resonant frequency
-         away from the L1 carrier and reduce the effectiveness of the
-         antenna. You can place as much stuff as you like beneath the
-         antenna as that's covered with a ground plane. But, keep
-         wires and metal out from above the patch antenna.
+         <para>
+           Metal components near the GPS patch antenna. These will
+           de-tune the patch antenna, changing the resonant frequency
+           away from the L1 carrier and reduce the effectiveness of the
+           antenna. You can place as much stuff as you like beneath the
+           antenna as that's covered with a ground plane. But, keep
+           wires and metal out from above the patch antenna.
+         </para>
        </listitem>
       </orderedlist>
       </para>
@@ -2132,16 +2159,21 @@ NAR #88757, TRA #12200
       </para>
       <itemizedlist>
        <listitem>
-         Keep wires from different circuits apart. Moving circuits
-         further apart will reduce RFI.
+         <para>
+           Keep wires from different circuits apart. Moving circuits
+           further apart will reduce RFI.
+         </para>
        </listitem>
        <listitem>
+         <para>
          Avoid parallel wires from different circuits. The longer two
          wires run parallel to one another, the larger the amount of
          transferred energy. Cross wires at right angles to reduce
          RFI.
+         </para>
        </listitem>
        <listitem>
+         <para>
          Twist wires from the same circuits. Two wires the same
          distance from the transmitter will get the same amount of
          induced energy which will then cancel out. Any time you have
@@ -2149,14 +2181,17 @@ NAR #88757, TRA #12200
          even out distances and reduce RFI. For altimeters, this
          includes battery leads, switch hookups and igniter
          circuits.
+         </para>
        </listitem>
        <listitem>
+         <para>
          Avoid resonant lengths. Know what frequencies are present
          in the environment and avoid having wire lengths near a
          natural resonant length. Altusmetrum products transmit on the
          70cm amateur band, so you should avoid lengths that are a
          simple ratio of that length; essentially any multiple of 1/4
          of the wavelength (17.5cm).
+         </para>
        </listitem>
       </itemizedlist>
     </section>
@@ -2238,59 +2273,83 @@ NAR #88757, TRA #12200
       <title>Updating TeleMetrum Firmware</title>
       <orderedlist inheritnum='inherit' numeration='arabic'>
         <listitem>
+         <para>
           Find the 'programming cable' that you got as part of the starter
           kit, that has a red 8-pin MicroMaTch connector on one end and a
           red 4-pin MicroMaTch connector on the other end.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Take the 2 screws out of the TeleDongle case to get access
           to the circuit board.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Plug the 8-pin end of the programming cable to the
           matching connector on the TeleDongle, and the 4-pin end to the
           matching connector on the TeleMetrum.
          Note that each MicroMaTch connector has an alignment pin that
          goes through a hole in the PC board when you have the cable
          oriented correctly.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Attach a battery to the TeleMetrum board.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Plug the TeleDongle into your computer's USB port, and power
           up the TeleMetrum.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Run AltosUI, and select 'Flash Image' from the File menu.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Pick the TeleDongle device from the list, identifying it as the
           programming device.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Select the image you want put on the TeleMetrum, which should have a
           name in the form telemetrum-v1.2-1.0.0.ihx.  It should be visible
        in the default directory, if not you may have to poke around
        your system to find it.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Make sure the configuration parameters are reasonable
           looking. If the serial number and/or RF configuration
           values aren't right, you'll need to change them.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Hit the 'OK' button and the software should proceed to flash
           the TeleMetrum with new firmware, showing a progress bar.
+         </para>
         </listitem>
         <listitem>
+         <para>
           Confirm that the TeleMetrum board seems to have updated OK, which you
           can do by plugging in to it over USB and using a terminal program
           to connect to the board and issue the 'v' command to check
           the version, etc.
+         </para>
         </listitem>
         <listitem>
+         <para>
           If something goes wrong, give it another try.
+         </para>
         </listitem>
       </orderedlist>
     </section>
@@ -2298,16 +2357,21 @@ NAR #88757, TRA #12200
       <title>Updating TeleMini Firmware</title>
       <orderedlist inheritnum='inherit' numeration='arabic'>
         <listitem>
+<para>
          You'll need a special 'programming cable' to reprogram the
          TeleMini. It's available on the Altus Metrum web store, or
          you can make your own using an 8-pin MicroMaTch connector on
          one end and a set of four pins on the other.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Take the 2 screws out of the TeleDongle case to get access
           to the circuit board.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Plug the 8-pin end of the programming cable to the matching
           connector on the TeleDongle, and the 4-pins into the holes
           in the TeleMini circuit board.  Note that the MicroMaTch
@@ -2315,44 +2379,63 @@ NAR #88757, TRA #12200
           the PC board when you have the cable oriented correctly, and
           that pin 1 on the TeleMini board is marked with a square pad
           while the other pins have round pads.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Attach a battery to the TeleMini board.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Plug the TeleDongle into your computer's USB port, and power
           up the TeleMini
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Run AltosUI, and select 'Flash Image' from the File menu.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Pick the TeleDongle device from the list, identifying it as the
           programming device.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Select the image you want put on the TeleMini, which should have a
           name in the form telemini-v1.0-1.0.0.ihx.  It should be visible
        in the default directory, if not you may have to poke around
        your system to find it.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Make sure the configuration parameters are reasonable
           looking. If the serial number and/or RF configuration
           values aren't right, you'll need to change them.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Hit the 'OK' button and the software should proceed to flash
           the TeleMini with new firmware, showing a progress bar.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Confirm that the TeleMini board seems to have updated OK, which you
           can do by configuring it over the radio link through the TeleDongle, or
          letting it come up in "flight" mode and listening for telemetry.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           If something goes wrong, give it another try.
-        </listitem>
+        </para>
+</listitem>
       </orderedlist>
     </section>
     <section>
@@ -2363,68 +2446,94 @@ NAR #88757, TRA #12200
        </para>
       <orderedlist inheritnum='inherit' numeration='arabic'>
         <listitem>
+<para>
           Find the 'programming cable' that you got as part of the starter
           kit, that has a red 8-pin MicroMaTch connector on one end and a
           red 4-pin MicroMaTch connector on the other end.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
          Find the USB cable that you got as part of the starter kit, and
          plug the "mini" end in to the mating connector on TeleMetrum or TeleDongle.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Take the 2 screws out of the TeleDongle case to get access
           to the circuit board.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Plug the 8-pin end of the programming cable to the
           matching connector on the programmer, and the 4-pin end to the
           matching connector on the TeleDongle.
          Note that each MicroMaTch connector has an alignment pin that
          goes through a hole in the PC board when you have the cable
          oriented correctly.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Attach a battery to the TeleMetrum board if you're using one.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Plug both the programmer and the TeleDongle into your computer's USB
          ports, and power up the programmer.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Run AltosUI, and select 'Flash Image' from the File menu.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Pick the programmer device from the list, identifying it as the
           programming device.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Select the image you want put on the TeleDongle, which should have a
           name in the form teledongle-v0.2-1.0.0.ihx.  It should be visible
        in the default directory, if not you may have to poke around
        your system to find it.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Make sure the configuration parameters are reasonable
           looking. If the serial number and/or RF configuration
           values aren't right, you'll need to change them.  The TeleDongle
          serial number is on the "bottom" of the circuit board, and can
          usually be read through the translucent blue plastic case without
          needing to remove the board from the case.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Hit the 'OK' button and the software should proceed to flash
           the TeleDongle with new firmware, showing a progress bar.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           Confirm that the TeleDongle board seems to have updated OK, which you
           can do by plugging in to it over USB and using a terminal program
           to connect to the board and issue the 'v' command to check
           the version, etc.  Once you're happy, remove the programming cable
          and put the cover back on the TeleDongle.
-        </listitem>
+        </para>
+</listitem>
         <listitem>
+<para>
           If something goes wrong, give it another try.
-        </listitem>
+        </para>
+</listitem>
       </orderedlist>
       <para>
         Be careful removing the programming cable from the locking 8-pin
@@ -2936,21 +3045,80 @@ NAR #88757, TRA #12200
         </para>
       </section>
   </appendix>
-  <appendix
-      xmlns:xi="http://www.w3.org/2001/XInclude">
+  <appendix>
     <title>Release Notes</title>
-    <simplesect><title>Version 1.3</title><xi:include  href="release-notes-1.3.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 1.2.1</title><xi:include        href="release-notes-1.2.1.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 1.2</title><xi:include  href="release-notes-1.2.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 1.1.1</title><xi:include        href="release-notes-1.1.1.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 1.1</title><xi:include  href="release-notes-1.1.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 1.0.1</title><xi:include        href="release-notes-1.0.1.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 0.9.2</title><xi:include        href="release-notes-0.9.2.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 0.9</title><xi:include  href="release-notes-0.9.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 0.8</title><xi:include  href="release-notes-0.8.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
-    <simplesect><title>Version 0.7.1</title><xi:include        href="release-notes-0.7.1.xsl"  xpointer="xpointer(/article/*)"/></simplesect>
+    <simplesect>
+      <title>Version 1.3</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-1.3.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 1.2.1</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-1.2.1.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 1.2</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-1.2.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 1.1.1</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-1.1.1.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 1.1</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-1.1.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 1.0.1</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-1.0.1.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 0.9.2</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-0.9.2.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 0.9</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-0.9.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 0.8</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-0.8.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
+    <simplesect>
+      <title>Version 0.7.1</title>
+      <xi:include
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         href="release-notes-0.7.1.xsl"
+         xpointer="xpointer(/article/*)"/>
+    </simplesect>
   </appendix>
 </book>
 
-<!--  LocalWords:  Altusmetrum
--->
+<!-- LocalWords: Altusmetrum
+-->
\ No newline at end of file
index 75158a02a38c384c75d4e4fd9804683d291bb5fb..1f2feeb0c5ddd30239453ae1b0df113baa0e9350 100644 (file)
@@ -8,42 +8,55 @@ Version 0.7.1 is the first release containing our new cross-platform Java-based
   </para>
   <itemizedlist>
     <listitem>
+<para>
       Receive and log telemetry from a connected TeleDongle
       device. All data received is saved to log files named with the
       current date and the connected rocket serial and flight
       numbers. There is no mode in which telemetry data will not be
       saved.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Download logged data from TeleMetrum devices, either through a
       direct USB connection or over the air through a TeleDongle
       device.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Configure a TeleMetrum device, setting the radio channel,
       callsign, apogee delay and main deploy height. This can be done
       through either a USB connection or over a radio link via a
       TeleDongle device.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Replay a flight in real-time. This takes a saved telemetry log
       or eeprom download and replays it through the user interface so
       you can relive your favorite rocket flights.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Reprogram Altus Metrum devices. Using an Altus Metrum device
       connected via USB, another Altus Metrum device can be
       reprogrammed using the supplied programming cable between the
       two devices.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Export Flight data to a comma-separated-values file. This takes
       either telemetry or on-board flight data and generates data
       suitable for use in external applications. All data is exported
       using standard units so that no device-specific knowledge is
       needed to handle the data.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Speak to you during the flight. Instead of spending the flight
       hunched over your laptop looking at the screen, enjoy the view
       while the computer tells you what’s going on up there. During
@@ -52,6 +65,7 @@ Version 0.7.1 is the first release containing our new cross-platform Java-based
       range information to try and help you find your rocket in the
       air. Once on the ground, the direction and distance are
       reported.
-    </listitem>
+    </para>
+</listitem>
   </itemizedlist>
 </article>
index c54f97e97a0d1501e98a208efe482a2cea34e378..df7ef32d9afae8934ebbe547b26896ad6db26dd5 100644 (file)
@@ -9,25 +9,32 @@
   </para>
   <itemizedlist>
     <listitem>
+<para>
       Post-flight graphing tool. This lets you explore the behaviour
       of your rocket after flight with a scroll-able and zoom-able
       chart showing the altitude, speed and acceleration of the
       airframe along with events recorded by the flight computer. You
       can export graphs to PNG files, or print them directly.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Real-time moving map which overlays the in-progress flight on
       satellite imagery fetched from Google Maps. This lets you see in
       pictures where your rocket has landed, allowing you to plan
       recovery activities more accurately.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Wireless recovery system testing. Prep your rocket for flight
       and test fire the deployment charges to make sure things work as
       expected. All without threading wires through holes in your
       airframe.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Optimized flight status displays. Each flight state now has it's
       own custom 'tab' in the flight monitoring window so you can
       focus on the most important details. Pre-flight, the system
       they're all green and your rocket is ready for flight. There are
       also tabs for ascent, descent and landing along with the
       original tabular view of the data.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Monitor multiple flights simultaneously. If you have more than
       one TeleDongle, you can monitor a flight with each one on the
       same computer.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Automatic flight monitoring at startup. Plug TeleDongle into the
       machine before starting AltosUI and it will automatically
       connect to it and prepare to monitor a flight.
-    </listitem>
+    </para>
+</listitem>
     <listitem>
+<para>
       Exports Google Earth flight tracks. Using the Keyhole Markup
       Language (.kml) file format, this provides a 3D view of your
       rocket flight through the Google Earth program.
-    </listitem>
+    </para>
+</listitem>
   </itemizedlist>
 </article>
index e5f66c60cbc828f7bf29df0fea27bb129a14793d..16ff989ed0d432e51e0614db2ace31b494f0c376 100644 (file)
@@ -8,13 +8,19 @@
   </para>
   <itemizedlist>
     <listitem>
+<para>
       Fix plotting problems due to missing file in the Mac OS install image.
+</para>
     </listitem>
     <listitem>
+<para>
       Always read whole eeprom blocks, mark empty records invalid, display parsing errors to user.
+</para>
     </listitem>
     <listitem>
+      <para>
       Add software version to Configure AltosUI dialog
+</para>
     </listitem>
   </itemizedlist>
 </article>
index 547f46b12c27de47857e1507c53f01397f16f4b8..a5d6b3d7a5796f8823c1e30beedfe62d8960c370 100644 (file)
@@ -9,23 +9,29 @@
   </para>
   <itemizedlist>
     <listitem>
+      <para>
       Support for TeleMetrum v1.1 hardware. Sources for the flash
       memory part used in v1.0 dried up, so v1.1 uses a different part
       which required a new driver and support for explicit flight log
       erasing.
+</para>
     </listitem>
     <listitem>
+      <para>
       Multiple flight log support. This stores more than one flight
       log in the on-board flash memory. It also requires the user to
       explicitly erase flights so that you won't lose flight logs just
       because you fly the same board twice in one day.
+</para>
     </listitem>
     <listitem>
+      <para>
       Telemetry support for devices with serial number >=
       256. Previous versions used a telemetry packet format that
       provided only 8 bits for the device serial number. This change
       requires that both ends of the telemetry link be running the 0.9
       firmware or they will not communicate.
+</para>
     </listitem>
   </itemizedlist>
 </article>
index 1e9fcabcd43539de681f27544e705358eaf67251..8b66f7e0470d2a248281799334eb20b3d2895629 100644 (file)
     AltOS Firmware Changes
     <itemizedlist>
       <listitem>
+<para>
        Add TeleMini v1.0 support. Firmware images for TeleMini are
        included in AltOS releases.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Change telemetry to be encoded in multiple 32-byte packets. This
        enables support for TeleMini and other devices without requiring
        further updates to the TeleDongle firmware.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Support operation of TeleMetrum with the antenna pointing
        aft. Previous firmware versions required the antenna to be
        pointing upwards, now there is a configuration option allowing
        the antenna to point aft, to aid installation in some airframes.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Ability to disable telemetry. For airframes where an antenna
        just isn't possible, or where radio transmissions might cause
        trouble with other electronics, there's a configuration option
        to disable all telemetry. Note that the board will still
        enable the radio link in idle mode.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Arbitrary frequency selection. The radios in Altus Metrum
        devices can be programmed to a wide range of frequencies, so
        instead of limiting devices to 10 pre-selected 'channels', the
        70cm band. Note that the RF matching circuit on the boards is
        tuned for around 435MHz, so frequencies far from that may
        reduce the available range.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Kalman-filter based flight-tracking. The model based sensor
        fusion approach of a Kalman filter means that AltOS now
        computes apogee much more accurately than before, generally
        allows the baro-only TeleMini device to correctly identify
        Mach transitions, avoiding the error-prone selection of a Mach
        delay.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
   <para>
     AltosUI Changes
     <itemizedlist>
       <listitem>
+<para>
        Wait for altimeter when using packet mode. Instead of quicly
        timing out when trying to initialize a packet mode
        configuration connection, AltosUI now waits indefinitely for
        the remote device to appear, providing a cancel button should
        the user get bored. This is necessary as the TeleMini can only
        be placed in "Idle" mode if AltosUI is polling it.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add main/apogee voltage graphs to the data plot. This provides
        a visual indication if the igniters fail before being fired.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Scan for altimeter devices by watching the defined telemetry
        frequencies. This avoids the problem of remembering what
        frequency a device was configured to use, which is especially
        important with TeleMini which does not include a USB connection.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Monitor altimeter state in "Idle" mode. This provides much of
        the information presented in the "Pad" dialog from the Monitor
        Flight command, monitoring the igniters, battery and GPS
        status withing requiring the flight computer to be armed and
        ready for flight.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Pre-load map images from home. For those launch sites which
        don't provide free Wi-Fi, this allows you to download the
        necessary satellite images given the location of the launch
        you've got a launch site not on that list, please send the
        name of it, latitude and longitude along with a link to the
        web site of the controlling club to the altusmetrum mailing list.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Flight statistics are now displayed in the Graph data
        window. These include max height/speed/accel, average descent
        rates and a few other bits of information. The Graph Data
        window can now be reached from the 'Landed' tab in the Monitor
        Flight window so you can immediately see the results of a
        flight.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
 </article>
index 14984a2aeb4e004ac9b1984bd1c37529ef6a871c..6f3a925dd66a556eb894f0f4235f18534eb85c48 100644 (file)
@@ -14,6 +14,7 @@
     AltOS Firmware Changes
     <itemizedlist>
       <listitem>
+<para>
        TeleMetrum v1.0 boards use the AT45DB081D flash memory part to
        store flight data, which is different from later TeleMetrum
        boards. The AltOS v1.1 driver for this chip couldn't erase
        configuration values. This bug doesn't affect newer TeleMetrum
        boards, and it doesn't affect the safety of rockets flying
        version 1.1 firmware.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
   <para>
     AltosUI Changes
     <itemizedlist>
       <listitem>
+<para>
        Creating a Google Earth file (KML) from on-board flight data
        (EEPROM) would generate an empty file. The code responsible
        for reading the EEPROM file wasn't ever setting the GPS valid
        bits, and so the KML export code thought there was no GPS data
        in the file.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        The “Landed” tab was displaying all values in metric units,
        even when AltosUI was configured to display imperial
        units. Somehow I just missed this tab when doing the units stuff.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        The “Descent” tab displays the range to the rocket, which is a
        combination of the over-the-ground distance to the rockets
        current latitude/longitude and the height of the rocket. As
        eventually land. A new “Ground Distance” field has been added
        which displays the distance to a spot right underneath the
        rocket.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Sensor data wasn't being displayed for TeleMini flight
        computers in Monitor Idle mode, including things like battery
        voltage. The code that picked which kinds of data to fetch
        from the flight computer was missing a check for TeleMini when
        deciding whether to fetch the analog sensor data.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
 </article>
index 519cd40c2378ae05b7b56c55ee601724a7f8de2f..0b2cce4e74f9a10acdb671b34737bd7ad719cebc 100644 (file)
     AltOS Firmware Changes
     <itemizedlist>
       <listitem>
+<para>
        Add apogee-lockout value. Overrides the apogee detection logic to
        prevent incorrect apogee charge firing.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Fix a bug where the data reported in telemetry packets was
        from 320ms ago.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Force the radio frequency to 434.550MHz when the debug clock
        pin is connected to ground at boot time. This provides a way
        to talk to a TeleMini which is configured to some unknown frequency.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Provide RSSI values for Monitor Idle mode. This makes it easy to check radio
        range without needing to go to flight mode.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Fix a bug which caused the old received telemetry packets to
        be retransmitted over the USB link when the radio was turned
        off and back on.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
   <para>
     AltosUI Changes
     <itemizedlist>
       <listitem>
+<para>
        Fix a bug that caused GPS ready to happen too quickly. The
        software was using every telemetry packet to signal new GPS
        data, which caused GPS ready to be signalled after 10 packets
        instead of 10 GPS updates.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Fix Google Earth data export to work with recent versions. The
        google earth file loading code got a lot pickier, requiring
        some minor white space changes in the export code.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Make the look-n-feel configurable, providing a choice from
        the available options.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add an 'Age' element to mark how long since a telemetry packet
        has been received. Useful to quickly gauge whether
        communications with the rocket are still active.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add 'Configure Ground Station' dialog to set the radio
        frequency used by a particular TeleDongle without having to go
        through the flight monitor UI.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add configuration for the new apogee-lockout value. A menu provides a list of
        reasonable values, or the value can be set by hand.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Changed how flight data are downloaded. Now there's an initial
        dialog asking which flights to download, and after that
        finishes, a second dialog comes up asking which flights to delete.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Re-compute time spent in each state for the flight graph; this
        figures out the actual boost and landing times instead of
        using the conservative values provide by the flight
        electronics. This improves the accuracy of the boost
        acceleration and main descent rate computations.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Make AltosUI run on Mac OS Lion. The default Java heap space
        was dramatically reduced for this release causing much of the
        UI to fail randomly. This most often affected the satellite
        mapping download and displays.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Change how data are displayed in the 'table' tab of the flight
        monitoring window. This eliminates entries duplicated from the
        header and adds both current altitude and pad altitude, which
        are useful in 'Monitor Idle' mode.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add Imperial units mode to present data in feet instead of
        meters.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
 </article>
index 5f9aef01ffad52aa1a61ad13cab1f6b864e47555..0f0569547931b17d2ceaf00f885dcd7d1c68f85d 100644 (file)
     AltOS Firmware Changes
     <itemizedlist>
       <listitem>
+<para>
        Add support for TeleBT
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        In TeleMini recovery mode (when booted with the outer two
        debug pins connected together), the radio parameters are also
        set back to defaults (434.550MHz, N0CALL, factory radio cal).
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add support for reflashing the SkyTraq GPS chips. This
        requires special host-side code which currently only exists
        for Linux.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Correct Kalman filter model error covariance matrix. The
        values used previously assumed continuous measurements instead
        of discrete measurements.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Fix some bugs in the USB driver for TeleMetrum and TeleDongle
        that affected Windows users.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Adjusted the automatic gain control parameters that affect
        receive performance for TeleDongle. Field tests indicate that this
        may improve receive performance somewhat.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
   <para>
     AltosUI Changes
     <itemizedlist>
       <listitem>
+<para>
        Handle missing GPS lock in 'Descent' tab. Previously, if the
        GPS position of the pad was unknown, an exception would be
        raised, breaking the Descent tab contents.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Improve the graph, adding tool-tips to show values near the
        cursor and making the displayed set of values configurable,
        adding all of the flight data as options while leaving the
        default settings alone so that the graph starts by showing
        height, speed and acceleration.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Make the initial position of the AltosUI top level window
        configurable. Along with this change, the other windows will
        pop up at 'sensible' places now, instead of on top of one
        another.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add callsign to Monitor idle window and connecting
        dialogs. This makes it clear which callsign is being used so
        that the operator will be aware that it must match the flight
        computer value or no communication will work.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        When downloading flight data, display the block number so that
        the user has some sense of progress. Unfortunately, we don't
        know how many blocks will need to be downloaded, but at least
        it isn't just sitting there doing nothing for a long time.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Add GPS data and a map to the graph window. This lets you see
        a complete summary of the flight without needing to 'replay'
        the whole thing.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
 </article>
index 64ba46a90d2d269a4560d5b70a9cc1c576a56db9..f26480a1f7424288557d2d1cf99d72de3108c583 100644 (file)
     AltOS Firmware Changes
     <itemizedlist>
       <listitem>
+<para>
        Add MicroPeak support. This includes support for the ATtiny85
        processor and adaptations to the core code to allow for
        devices too small to run the multi-tasking scheduler.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
   <para>
     MicroPeak UI changes
     <itemizedlist>
       <listitem>
+<para>
        Added this new application
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
   <para>
     Distribution Changes
     <itemizedlist>
       <listitem>
+<para>
        Distribute Mac OS X packages in disk image ('.dmg') format to
        greatly simplify installation.
-      </listitem>
+      </para>
+</listitem>
       <listitem>
+<para>
        Provide version numbers for the shared Java libraries to
        ensure that upgrades work properly, and to allow for multiple
        Altus Metrum software packages to be installed in the same
        directory at the same time.
-      </listitem>
+      </para>
+</listitem>
     </itemizedlist>
   </para>
 </article>
index 149e024e62047f3ebd8a2e67ca3ccf9277e155de..3bc4857f98b0bb103d762ae4cb286d6e1bc202db 100644 (file)
     AltOS Firmware Changes
     <itemizedlist>
       <listitem>
-       Add STM32L processor support. This includes enhancements to
-       the scheduler to support products with many threads.
+       <para>
+         Add STM32L processor support. This includes enhancements to
+         the scheduler to support products with many threads.
+       </para>
       </listitem>
       <listitem>
-       Add NXP LPC11U14 processor support.
+       <para>
+         Add NXP LPC11U14 processor support.
+       </para>
       </listitem>
       <listitem>
-       Support additional pyro channels. These are configurable
-       through the UI to handle air starts, staging, additional
-       recovery events and external devices such as cameras.
+       <para>
+         Support additional pyro channels. These are configurable
+         through the UI to handle air starts, staging, additional
+         recovery events and external devices such as cameras.
+       </para>
       </listitem>
       <listitem>
-       Add 3-axis gyro support for orientation tracking. This
-       integrates the gyros to compute the angle from vertical during
-       flight, allowing the additional pyro events to be controlled
-       by this value.
+       <para>
+         Add 3-axis gyro support for orientation tracking. This
+         integrates the gyros to compute the angle from vertical during
+         flight, allowing the additional pyro events to be controlled
+         by this value.
+       </para>
       </listitem>
       <listitem>
-       Many more device drivers, including u-Blox Max 7Q GPS,
-       Freescale MMA6555 digital single-axis accelerometer,
-       Invensense MPU6000 3-axis accelerometer + 3 axis gyro,
-       Honeywell HMC5883 3-axis magnetic sensor and the TI CC1120 and
-       CC115L digital FM transceivers
+       <para>
+         Many more device drivers, including u-Blox Max 7Q GPS,
+         Freescale MMA6555 digital single-axis accelerometer,
+         Invensense MPU6000 3-axis accelerometer + 3 axis gyro,
+         Honeywell HMC5883 3-axis magnetic sensor and the TI CC1120 and
+         CC115L digital FM transceivers
+       </para>
       </listitem>
     </itemizedlist>
   </para>
     AltosUI changes
     <itemizedlist>
       <listitem>
-       Support TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini telemetry and log formats.
+       <para>
+         Support TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini telemetry and log formats.
+       </para>
       </listitem>
       <listitem>
-       Use preferred units for main deployment height configuration,
-       instead of always doing configuration in meters.
+       <para>
+         Use preferred units for main deployment height configuration,
+         instead of always doing configuration in meters.
+       </para>
       </listitem>
     </itemizedlist>
   </para>
     MicroPeak UI changes
     <itemizedlist>
       <listitem>
-       Add 'Download' button to menu bar.
+       <para>
+         Add 'Download' button to menu bar.
+       </para>
       </listitem>
       <listitem>
-       Save the last log directory and offer that as the default for new downloads
+       <para>
+         Save the last log directory and offer that as the default for new downloads
+       </para>
       </listitem>
     </itemizedlist>
   </para>