Add release notes for version 1.1.1
authorKeith Packard <keithp@keithp.com>
Sun, 16 Sep 2012 19:38:33 +0000 (12:38 -0700)
committerKeith Packard <keithp@keithp.com>
Sun, 16 Sep 2012 19:38:33 +0000 (12:38 -0700)
Signed-off-by: Keith Packard <keithp@keithp.com>
doc/Makefile
doc/altusmetrum.xsl
doc/release-notes-1.1.1.xsl [new file with mode: 0644]

index fbe8bc11c8056f1ceaacd06a132c3e4454836f10..3e1626f06a1c326be083dbf29bbd917b44f6d33e 100644 (file)
@@ -8,6 +8,7 @@ RELNOTES=\
        release-notes-0.9.html \
        release-notes-0.9.2.html \
        release-notes-1.0.1.html \
+       release-notes-1.1.1.html \
        release-notes-1.1.html
 
 RELNOTES_XSL=$(RELNOTES:.html=.xsl)
index 87220baa50cb1b9a92e91d293e74492f2011ac33..b2677a029ed9c66f3c33b3861fddb0382ece3ee0 100644 (file)
       </para>
     </legalnotice>
     <revhistory>
+      <revision>
+       <revnumber>1.1.1</revnumber>
+       <date>16 September 2012</date>
+       <revremark>
+         Updated for software version 1.1.1 Version 1.1.1 fixes a few
+         bugs found in version 1.1.
+       </revremark>
+      </revision>
       <revision>
        <revnumber>1.1</revnumber>
        <date>13 September 2012</date>
@@ -872,14 +880,16 @@ NAR #88757, TRA #12200
          be below 10m/s when under the main parachute in a dual-deploy flight.
         </para>
         <para>
-          For TeleMetrum altimeters, you can locate the rocket in the sky
-         using the elevation and
-          bearing information to figure out where to look. Elevation is
-          in degrees above the horizon. Bearing is reported in degrees
-          relative to true north. Range can help figure out how big the
-          rocket will appear. Note that all of these values are relative
-          to the pad location. If the elevation is near 90°, the rocket
-          is over the pad, not over you.
+          For TeleMetrum altimeters, you can locate the rocket in the
+          sky using the elevation and bearing information to figure
+          out where to look. Elevation is in degrees above the
+          horizon. Bearing is reported in degrees relative to true
+          north. Range can help figure out how big the rocket will
+          appear. Ground Distance shows how far it is to a point
+          directly under the rocket and can help figure out where the
+          rocket is likely to land. Note that all of these values are
+          relative to the pad location. If the elevation is near 90°,
+          the rocket is over the pad, not over you.
         </para>
         <para>
           Finally, the igniter voltages are reported in this tab as
@@ -2567,6 +2577,7 @@ NAR #88757, TRA #12200
   <appendix
       xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Release Notes</title>
+    <xi:include        href="release-notes-1.1.1.xsl"  xpointer="xpointer(/article/*)"/>
     <xi:include        href="release-notes-1.1.xsl"  xpointer="xpointer(/article/*)"/>
     <xi:include        href="release-notes-1.0.1.xsl"  xpointer="xpointer(/article/*)"/>
     <xi:include        href="release-notes-0.9.2.xsl"  xpointer="xpointer(/article/*)"/>
diff --git a/doc/release-notes-1.1.1.xsl b/doc/release-notes-1.1.1.xsl
new file mode 100644 (file)
index 0000000..14984a2
--- /dev/null
@@ -0,0 +1,61 @@
+<?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">
+
+<article>
+  <para>
+    Version 1.1.1 is a bug-fix release. It fixes a couple of bugs in
+    AltosUI and one firmware bug that affects TeleMetrum version 1.0
+    boards. Thanks to Bob Brown for help diagnosing the Google Earth
+    file export issue, and for suggesting the addition of the Ground
+    Distance value in the Descent tab.
+  </para>
+  <para>
+    AltOS Firmware Changes
+    <itemizedlist>
+      <listitem>
+       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
+       memory, leaving it impossible to delete flight data or update
+       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>
+    </itemizedlist>
+  </para>
+  <para>
+    AltosUI Changes
+    <itemizedlist>
+      <listitem>
+       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>
+      <listitem>
+       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>
+      <listitem>
+       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
+       such, it's useful for knowing how far away the rocket is, but
+       difficult to use when estimating where the rocket might
+       eventually land. A new “Ground Distance” field has been added
+       which displays the distance to a spot right underneath the
+       rocket.
+      </listitem>
+      <listitem>
+       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>
+    </itemizedlist>
+  </para>
+</article>