+ that TeleMetrum or TeleMega may always come up in 'pad mode'
+ and as such not be listening to either the USB or radio link.
+ If that happens, there is a special hook in the firmware to
+ force the board back in to 'idle mode' so you can re-do the
+ cal. To use this hook, you just need to ground the SPI clock
+ pin at power-on. This pin is available as pin 2 on the 8-pin
+ companion connector, and pin 1 is ground. So either
+ carefully install a fine-gauge wire jumper between the two
+ pins closest to the index hole end of the 8-pin connector, or
+ plug in the programming cable to the 8-pin connector and use
+ a small screwdriver or similar to short the two pins closest
+ to the index post on the 4-pin end of the programming cable,
+ and power up the board. It should come up in 'idle mode'
+ (two beeps), allowing a re-cal.
+ </p></div></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a name="idp54567264"></a>Appendix D. Release Notes</h1></div></div></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54567904"></a>Version 1.3.1</h2></div></div></div><p>
+ Version 1.3.1 is a minor release. It improves support for TeleMega,
+ TeleMetrum v2.0, TeleMini v2.0 and EasyMini.
+ </p><p>
+ AltOS Firmware Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Improve sensor boot code. If sensors fail to self-test, the
+ device will still boot up and check for pad/idle modes. If
+ in idle mode, the device will warn the user with a distinct
+ beep, if in Pad mode, the unit will operate as best it
+ can. Also, the Z-axis accelerometer now uses the factory
+ calibration values instead of re-calibrating on the pad each
+ time. This avoids accidental boost detect when moving the
+ device around while in Pad mode.
+ </p></li><li class="listitem"><p>
+ Fix antenna-down mode accelerometer configuration. Antenna
+ down mode wasn't working because the accelerometer
+ calibration values were getting re-computed incorrectly in
+ inverted mode.
+ </p></li><li class="listitem"><p>
+ Improved APRS mode. Now uses compressed position format for
+ smaller data size, improved precision and to include
+ altitude data as well as latitude and longitude. Also added
+ battery and pyro voltage reports in the APRS comment field
+ so you can confirm that the unit is ready for launch.
+ </p></li></ul></div><p>
+ </p><p>
+ AltosUI changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Display additional TeleMega sensor values in real
+ units. Make all of these values available for
+ plotting. Display TeleMega orientation value in the Ascent
+ and Table tabs.
+ </p></li><li class="listitem"><p>
+ Support additional TeleMega pyro channels in the Fire
+ Igniter dialog. This lets you do remote testing of all of
+ the channels, rather than just Apogee and Main.
+ </p></li><li class="listitem"><p>
+ Limit data rate when downloading satellite images from
+ Google to make sure we stay within their limits so that all
+ of the map tiles download successfully.
+ </p></li></ul></div><p>
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54569504"></a>Version 1.3</h2></div></div></div><p>
+ Version 1.3 is a major release. It adds support for TeleMega,
+ TeleMetrum v2.0, TeleMini v2.0 and EasyMini.
+ </p><p>
+ AltOS Firmware Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Add STM32L processor support. This includes enhancements to
+ the scheduler to support products with many threads.
+ </p></li><li class="listitem"><p>
+ Add NXP LPC11U14 processor support.
+ </p></li><li class="listitem"><p>
+ Support additional pyro channels. These are configurable
+ through the UI to handle air starts, staging, additional
+ recovery events and external devices such as cameras.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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
+ </p></li></ul></div><p>
+ </p><p>
+ AltosUI changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Support TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini telemetry and log formats.
+ </p></li><li class="listitem"><p>
+ Use preferred units for main deployment height configuration,
+ instead of always doing configuration in meters.
+ </p></li></ul></div><p>
+ </p><p>
+ MicroPeak UI changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Add 'Download' button to menu bar.
+ </p></li><li class="listitem"><p>
+ Save the last log directory and offer that as the default for new downloads
+ </p></li></ul></div><p>
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54571104"></a>Version 1.2.1</h2></div></div></div><p>
+ Version 1.2.1 is a minor release. It adds support for TeleBT and
+ the AltosDroid application, provides several new features in
+ AltosUI and fixes some bugs in the AltOS firmware.
+ </p><p>
+ AltOS Firmware Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Add support for TeleBT
+ </p></li><li class="listitem"><p>
+ 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).
+ </p></li><li class="listitem"><p>
+ Add support for reflashing the SkyTraq GPS chips. This
+ requires special host-side code which currently only exists
+ for Linux.
+ </p></li><li class="listitem"><p>
+ Correct Kalman filter model error covariance matrix. The
+ values used previously assumed continuous measurements instead
+ of discrete measurements.
+ </p></li><li class="listitem"><p>
+ Fix some bugs in the USB driver for TeleMetrum and TeleDongle
+ that affected Windows users.
+ </p></li><li class="listitem"><p>
+ Adjusted the automatic gain control parameters that affect
+ receive performance for TeleDongle. Field tests indicate that this
+ may improve receive performance somewhat.
+ </p></li></ul></div><p>
+ </p><p>
+ AltosUI Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li></ul></div><p>
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54572608"></a>Version 1.2</h2></div></div></div><p>
+ Version 1.2 is a major release. It adds support for MicroPeak and
+ the MicroPeak USB adapter.
+ </p><p>
+ AltOS Firmware Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ 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.
+ </p></li></ul></div><p>
+ </p><p>
+ MicroPeak UI changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Added this new application
+ </p></li></ul></div><p>
+ </p><p>
+ Distribution Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Distribute Mac OS X packages in disk image ('.dmg') format to
+ greatly simplify installation.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li></ul></div><p>
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54574112"></a>Version 1.1.1</h2></div></div></div><p>
+ 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.
+ </p><p>
+ AltOS Firmware Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ 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.
+ </p></li></ul></div><p>
+ </p><p>
+ AltosUI Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li></ul></div><p>
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54575616"></a>Version 1.1</h2></div></div></div><p>
+ Version 1.1 is a minor release. It provides a few new features in AltosUI
+ and the AltOS firmware and fixes bugs.
+ </p><p>
+ AltOS Firmware Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ Add apogee-lockout value. Overrides the apogee detection logic to
+ prevent incorrect apogee charge firing.
+ </p></li><li class="listitem"><p>
+ Fix a bug where the data reported in telemetry packets was
+ from 320ms ago.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ Provide RSSI values for Monitor Idle mode. This makes it easy to check radio
+ range without needing to go to flight mode.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li></ul></div><p>
+ </p><p>
+ AltosUI Changes
+ </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ Make the look-n-feel configurable, providing a choice from
+ the available options.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ Add 'Configure Ground Station' dialog to set the radio
+ frequency used by a particular TeleDongle without having to go
+ through the flight monitor UI.
+ </p></li><li class="listitem"><p>
+ Add configuration for the new apogee-lockout value. A menu provides a list of
+ reasonable values, or the value can be set by hand.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ 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.
+ </p></li><li class="listitem"><p>
+ Add Imperial units mode to present data in feet instead of
+ meters.
+ </p></li></ul></div><p>
+ </p></div><div class="simplesect"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp54577120"></a>Version 1.0.1</h2></div></div></div><p>