X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Faltusmetrum.xsl;h=55f02e265729a1d396afacdd082921367ce043c5;hb=9aca92a20343a2cf7e05abc7b100852d81f86c0d;hp=66c2b339feb24013633c2b0a0fb614d11e80d923;hpb=1bd781da934c738e0c9294197c7eb622b0710a9a;p=fw%2Faltos
diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl
index 66c2b339..55f02e26 100644
--- a/doc/altusmetrum.xsl
+++ b/doc/altusmetrum.xsl
@@ -22,7 +22,7 @@
Towns
- 2011
+ 2012
Bdale Garbee and Keith Packard
@@ -35,6 +35,22 @@
+
+ 1.1.1
+ 16 September 2012
+
+ Updated for software version 1.1.1 Version 1.1.1 fixes a few
+ bugs found in version 1.1.
+
+
+
+ 1.1
+ 13 September 2012
+
+ Updated for software version 1.1. Version 1.1 has new
+ features but is otherwise compatible with version 1.0.
+
+
1.0
24 August 2011
@@ -258,7 +274,21 @@ NAR #88757, TRA #12200
A typical TeleMetrum or TeleMini installation involves attaching
only a suitable Lithium Polymer battery, a single pole switch for
power on/off, and two pairs of wires connecting e-matches for the
- apogee and main ejection charges.
+ apogee and main ejection charges. All Altus Metrum products are
+ designed for use with single-cell batteries with 3.7 volts nominal.
+
+
+ The battery connectors are a standard 2-pin JST connector and
+ match batteries sold by Spark Fun. These batteries are
+ single-cell Lithium Polymer batteries that nominally provide 3.7
+ volts. Other vendors sell similar batteries for RC aircraft
+ using mating connectors, however the polarity for those is
+ generally reversed from the batteries used by Altus Metrum
+ products. In particular, the Tenergy batteries supplied for use
+ in Featherweight flight computers are not compatible with Altus
+ Metrum flight computers or battery chargers. Check
+ polarity and voltage before connecting any battery not purchased
+ from Altus Metrum or Spark Fun.
By default, we use the unregulated output of the Li-Po battery directly
@@ -464,7 +494,7 @@ NAR #88757, TRA #12200
You can monitor the operation of the radio link by watching the
lights on the devices. The red LED will flash each time a packet
- is tramsitted, while the green LED will light up on TeleDongle when
+ is transmitted, while the green LED will light up on TeleDongle when
it is waiting to receive a packet from the altimeter.
@@ -536,7 +566,7 @@ NAR #88757, TRA #12200
or radio link via TeleDongle.
- Radio Frequencies
+ Radio Frequency
Altus Metrum boards support radio frequencies in the 70cm
band. By default, the configuration interface provides a
@@ -583,6 +613,90 @@ NAR #88757, TRA #12200
simultaneously.
+
+ Maximum Flight Log
+
+ TeleMetrum version 1.1 and 1.2 have 2MB of on-board flash storage,
+ enough to hold over 40 minutes of data at full data rate
+ (100 samples/second). TeleMetrum 1.0 has 1MB of on-board
+ storage. As data are stored at a reduced rate during descent
+ (10 samples/second), there's plenty of space to store many
+ flights worth of data.
+
+
+ The on-board flash is partitioned into separate flight logs,
+ each of a fixed maximum size. Increase the maximum size of
+ each log and you reduce the number of flights that can be
+ stored. Decrease the size and TeleMetrum can store more
+ flights.
+
+
+ All of the configuration data is also stored in the flash
+ memory, which consumes 64kB on TeleMetrum v1.1/v1.2 and 256B on
+ TeleMetrum v1.0. This configuration space is not available
+ for storing flight log data.
+
+
+ To compute the amount of space needed for a single flight,
+ you can multiply the expected ascent time (in seconds) by
+ 800, multiply the expected descent time (in seconds) by 80
+ and add the two together. That will slightly under-estimate
+ the storage (in bytes) needed for the flight. For instance,
+ a flight spending 20 seconds in ascent and 150 seconds in
+ descent will take about (20 * 800) + (150 * 80) = 28000
+ bytes of storage. You could store dozens of these flights in
+ the on-board flash.
+
+
+ The default size, 192kB, allows for 10 flights of storage on
+ TeleMetrum v1.1/v1.2 and 5 flights on TeleMetrum v1.0. This
+ ensures that you won't need to erase the memory before
+ flying each time while still allowing more than sufficient
+ storage for each flight.
+
+
+ As TeleMini does not contain an accelerometer, it stores
+ data at 10 samples per second during ascent and one sample
+ per second during descent. Each sample is a two byte reading
+ from the barometer. These are stored in 5kB of
+ on-chip flash memory which can hold 256 seconds at the
+ ascent rate or 2560 seconds at the descent rate. Because of
+ the limited storage, TeleMini cannot hold data for more than
+ one flight, and so must be erased after each flight or it
+ will not capture data for subsequent flights.
+
+
+
+ Ignite Mode
+
+ Instead of firing one charge at apogee and another charge at
+ a fixed height above the ground, you can configure the
+ altimeter to fire both at apogee or both during
+ descent. This was added to support an airframe that has two
+ TeleMetrum computers, one in the fin can and one in the
+ nose.
+
+
+ Providing the ability to use both igniters for apogee or
+ main allows some level of redundancy without needing two
+ flight computers. In Redundant Apogee or Redundant Main
+ mode, the two charges will be fired two seconds apart.
+
+
+
+ Pad Orientation
+
+ TeleMetrum measures acceleration along the axis of the
+ board. Which way the board is oriented affects the sign of
+ the acceleration value. Instead of trying to guess which way
+ the board is mounted in the air frame, TeleMetrum must be
+ explicitly configured for either Antenna Up or Antenna
+ Down. The default, Antenna Up, expects the end of the
+ TeleMetrum board connected to the 70cm antenna to be nearest
+ the nose of the rocket, with the end containing the screw
+ terminals nearest the tail.
+
+
@@ -655,6 +769,15 @@ NAR #88757, TRA #12200
incorrect data from being reported.
+
+
+ The age of the displayed data, in seconds since the last
+ successfully received telemetry packet. In normal operation
+ this will stay in the low single digits. If the number starts
+ counting up, then you are no longer receiving data over the radio
+ link from the flight computer.
+
+
Finally, the largest portion of the window contains a set of
@@ -779,14 +902,16 @@ NAR #88757, TRA #12200
be below 10m/s when under the main parachute in a dual-deploy flight.
- 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.
Finally, the igniter voltages are reported in this tab as
@@ -1093,31 +1218,6 @@ NAR #88757, TRA #12200
size. A smaller value will allow more flights to be stored,
a larger value will record data from longer flights.
-
- During ascent, TeleMetrum records barometer and
- accelerometer values 100 times per second, other analog
- information (voltages and temperature) 6 times per second
- and GPS data once per second. During descent, the non-GPS
- data is recorded 1/10th as often. Each barometer +
- accelerometer record takes 8 bytes.
-
-
- The default, 192kB, will store over 200 seconds of data at
- the ascent rate, or over 2000 seconds of data at the descent
- rate. That's plenty for most flights. This leaves enough
- storage for five flights in 1MB systems, or 10 flights in 2MB
- systems.
-
-
- The configuration block takes the last available block of
- memory, on v1.0 boards that's just 256 bytes. However, the
- flash part on the v1.1 boards uses 64kB for each block.
-
-
- TeleMini has 5kB of on-board storage, which is plenty for a
- single flight. Make sure you download and delete the data
- before subsequent flights, or TeleMini will not log any data.
-
Ignite Mode
@@ -1231,6 +1331,16 @@ NAR #88757, TRA #12200
your local radio regulations.
+
+ Imperial Units
+
+ This switches between metric units (meters) and imperial
+ units (feet and miles). This affects the display of values
+ use during flight monitoring, data graphing and all of the
+ voice announcements. It does not change the units used when
+ exporting to CSV files, those are always produced in metric units.
+
+
Font Size
@@ -1260,6 +1370,73 @@ NAR #88757, TRA #12200
+
+ Configure Groundstation
+
+ Select this button and then select a TeleDongle Device from the list provided.
+
+
+ The first few lines of the dialog provide information about the
+ connected device, including the product name,
+ software version and hardware serial number. Below that are the
+ individual configuration entries.
+
+
+ Note that the TeleDongle itself doesn't save any configuration
+ data, the settings here are recorded on the local machine in
+ the Java preferences database. Moving the TeleDongle to
+ another machine, or using a different user account on the same
+ machine will cause settings made here to have no effect.
+
+
+ At the bottom of the dialog, there are three buttons:
+
+
+
+
+ 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.
+
+
+
+
+ Reset. This resets the dialog to the most recently saved values,
+ erasing any changes you have made.
+
+
+
+
+ Close. This closes the dialog. Any unsaved changes will be
+ lost.
+
+
+
+
+ The rest of the dialog contains the parameters to be configured.
+
+
+ Frequency
+
+ This configures the frequency to use for both telemetry and
+ packet command mode. Set this before starting any operation
+ involving packet command mode so that it will use the right
+ frequency. Telemetry monitoring mode also provides a menu to
+ change the frequency, and that menu also sets the same Java
+ preference value used here.
+
+
+
+ Radio Calibration
+
+ The radios in every Altus Metrum device are calibrated at the
+ factory to ensure that they transmit and receive on the
+ specified frequency. To change a TeleDongle's calibration,
+ you must reprogram the unit completely, so this entry simply
+ shows the current value and doesn't allow any changes.
+
+
+
Flash Image
@@ -1388,8 +1565,9 @@ NAR #88757, TRA #12200
In the rocket itself, you just need a TeleMetrum or
TeleMini board and
- a Li-Po rechargeable battery. An 860mAh battery weighs less than a 9V
- alkaline battery, and will run a TeleMetrum for hours.
+ a single-cell, 3.7 volt nominal Li-Po rechargeable battery. An
+ 850mAh battery weighs less than a 9V alkaline battery, and will
+ run a TeleMetrum for hours.
A 110mAh battery weighs less than a triple A battery and will run a TeleMetrum for
a few hours, or a TeleMini for much (much) longer.
@@ -1783,7 +1961,7 @@ NAR #88757, TRA #12200
Select the image you want put on the TeleMetrum, which should have a
- name in the form telemetrum-v1.1-1.0.0.ihx. It should be visible
+ 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.
@@ -2043,7 +2221,7 @@ NAR #88757, TRA #12200
- RF interface for battery charging, configuration, and data recovery.
+ RF interface for configuration, and data recovery.
@@ -2421,11 +2599,13 @@ NAR #88757, TRA #12200
Release Notes
-
-
-
-
-
+ Version 1.1.1
+ Version 1.1
+ Version 1.0.1
+ Version 0.9.2
+ Version 0.9
+ Version 0.8
+ Version 0.7.1