</revhistory>
</bookinfo>
<dedication>
- <title>Acknowledgements</title>
+ <title>Acknowledgments</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
</para>
<table frame='all'>
<title>Altus Metrum Electronics</title>
+ <?dbfo keep-together="always"?>
<tgroup cols='8' align='center' colsep='1' rowsep='1'>
<colspec align='center' colwidth='*' colname='Device'/>
<colspec align='center' colwidth='*' colname='Barometer'/>
</table>
<table frame='all'>
<title>Altus Metrum Boards</title>
+ <?dbfo keep-together="always"?>
<tgroup cols='6' align='center' colsep='1' rowsep='1'>
<colspec align='center' colwidth='*' colname='Device'/>
<colspec align='center' colwidth='*' colname='Connectors'/>
</para></entry>
<entry>½ inch (1.27cm)</entry>
<entry>1½ inch (3.81cm)</entry>
- <entry>18mm aiframe</entry>
+ <entry>18mm airframe</entry>
</row>
<row>
<entry>TeleMini <?linebreak?>v2.0</entry>
</para>
<table frame='all'>
<title>Data Storage on Altus Metrum altimeters</title>
+ <?dbfo keep-together="always"?>
<tgroup cols='4' align='center' colsep='1' rowsep='1'>
<colspec align='center' colwidth='*' colname='Device'/>
<colspec align='center' colwidth='*' colname='Bytes per sample'/>
</listitem>
<listitem>
<para>
- Main. The rocket is still descending, and is blow
+ Main. The rocket is still descending, and is below
the Main altitude
</para>
</listitem>
<para>
You can select a state to limit when the pyro channel
may activate; note that the check is based on when the
- rocket transitions *into* the state, and so checking for
- 'greater than Boost' means that the rocket is currently
- in boost state.
+ rocket transitions <emphasis>into</emphasis> the state, and so checking for
+ “greater than Boost” means that the rocket is currently
+ in boost or some later state.
</para>
<para>
When a motor burns out, the rocket enters either Fast or
rocket is ready for flight. The first elements include red/green
indicators, if any of these is red, you'll want to evaluate
whether the rocket is ready to launch:
- <itemizedlist>
- <listitem>
- <para>
- Battery Voltage. This indicates whether the Li-Po battery
- powering the TeleMetrum has sufficient charge to last for
- the duration of the flight. A value of more than
- 3.7V is required for a 'GO' status.
- </para>
- </listitem>
- <listitem>
- <para>
- Apogee Igniter Voltage. This indicates whether the apogee
- igniter has continuity. If the igniter has a low
- resistance, then the voltage measured here will be close
- to the Li-Po battery voltage. A value greater than 3.2V is
- required for a 'GO' status.
- </para>
- </listitem>
- <listitem>
- <para>
- Main Igniter Voltage. This indicates whether the main
- igniter has continuity. If the igniter has a low
- resistance, then the voltage measured here will be close
- to the Li-Po battery voltage. A value greater than 3.2V is
- required for a 'GO' status.
- </para>
- </listitem>
- <listitem>
- <para>
- On-board Data Logging. This indicates whether there is
- space remaining on-board to store flight data for the
- upcoming flight. If you've downloaded data, but failed
- to erase flights, there may not be any space
- left. TeleMetrum can store multiple flights, depending
- on the configured maximum flight log size. TeleMini
- stores only a single flight, so it will need to be
- downloaded and erased after each flight to capture
- data. This only affects on-board flight logging; the
- altimeter will still transmit telemetry and fire
- ejection charges at the proper times.
- </para>
- </listitem>
- <listitem>
- <para>
- GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is
- currently able to compute position information. GPS requires
- at least 4 satellites to compute an accurate position.
- </para>
- </listitem>
- <listitem>
- <para>
- GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least
- 10 consecutive positions without losing lock. This ensures
- that the GPS receiver has reliable reception from the
- satellites.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>Battery Voltage</term>
+ <listitem>
+ <para>
+ This indicates whether the Li-Po battery
+ powering the TeleMetrum has sufficient charge to last for
+ the duration of the flight. A value of more than
+ 3.8V is required for a 'GO' status.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Apogee Igniter Voltage</term>
+ <listitem>
+ <para>
+ This indicates whether the apogee
+ igniter has continuity. If the igniter has a low
+ resistance, then the voltage measured here will be close
+ to the Li-Po battery voltage. A value greater than 3.2V is
+ required for a 'GO' status.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Main Igniter Voltage</term>
+ <listitem>
+ <para>
+ This indicates whether the main
+ igniter has continuity. If the igniter has a low
+ resistance, then the voltage measured here will be close
+ to the Li-Po battery voltage. A value greater than 3.2V is
+ required for a 'GO' status.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>On-board Data Logging</term>
+ <listitem>
+ <para>
+ This indicates whether there is
+ space remaining on-board to store flight data for the
+ upcoming flight. If you've downloaded data, but failed
+ to erase flights, there may not be any space
+ left. TeleMetrum can store multiple flights, depending
+ on the configured maximum flight log size. TeleMini
+ stores only a single flight, so it will need to be
+ downloaded and erased after each flight to capture
+ data. This only affects on-board flight logging; the
+ altimeter will still transmit telemetry and fire
+ ejection charges at the proper times.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>GPS Locked</term>
+ <listitem>
+ <para>
+ For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is
+ currently able to compute position information. GPS requires
+ at least 4 satellites to compute an accurate position.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>GPS Ready</term>
+ <listitem>
+ <para>
+ For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least
+ 10 consecutive positions without losing lock. This ensures
+ that the GPS receiver has reliable reception from the
+ satellites.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
<para>
The Launchpad tab also shows the computed launch pad position
flash memory.
</para>
<para>
- Once a flight record is selected, a window with four tabs is
- opened. The first tab contains a graph with acceleration
- (blue), velocity (green) and altitude (red) of the flight,
- measured in metric units. The apogee(yellow) and main(magenta)
- igniter voltages are also displayed; high voltages indicate
- continuity, low voltages indicate open circuits. The second
- tab lets you configure which data to show in the graph. The
- third contains some basic flight statistics while the fourth
- has a map with the ground track of the flight displayed.
+ Once a flight record is selected, a window with multiple tabs is
+ opened.
+ <variablelist>
+ <varlistentry>
+ <term>Flight Graph</term>
+ <listitem>
+ <para>
+ By default, the graph contains acceleration (blue),
+ velocity (green) and altitude (red).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Configure Graph</term>
+ <listitem>
+ <para>
+ This selects which graph elements to show, and, at the
+ very bottom, lets you switch between metric and
+ imperial units
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Flight Statistics</term>
+ <listitem>
+ <para>
+ Shows overall data computed from the flight.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Map</term>
+ <listitem>
+ <para>
+ Shows a satellite image of the flight area overlaid
+ with the path of the flight. The red concentric
+ circles mark the launch pad, the black concentric
+ circles mark the landing location.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
<para>
The graph can be zoomed into a particular area by clicking and
<section>
<title>Configure Altimeter</title>
<para>
- Select this button and then select either a TeleMetrum or
+ Select this button and then select either an altimeter or
TeleDongle Device from the list provided. Selecting a TeleDongle
device will use the radio link to configure a remote altimeter.
</para>
<para>
At the bottom of the dialog, there are four buttons:
</para>
- <itemizedlist>
- <listitem>
- <para>
- Save. This writes any changes to the
- configuration parameter block in flash memory. If you don't
- press this button, any changes you make will be lost.
- </para>
- </listitem>
- <listitem>
- <para>
- Reset. This resets the dialog to the most recently saved values,
- erasing any changes you have made.
- </para>
- </listitem>
- <listitem>
- <para>
- Reboot. This reboots the device. Use this to
- switch from idle to pad mode by rebooting once the rocket is
- oriented for flight, or to confirm changes you think you saved
- are really saved.
- </para>
- </listitem>
- <listitem>
- <para>
- Close. This closes the dialog. Any unsaved changes will be
- lost.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>Save</term>
+ <listitem>
+ <para>
+ This writes any changes to the
+ configuration parameter block in flash memory. If you don't
+ press this button, any changes you make will be lost.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Reset</term>
+ <listitem>
+ <para>
+ This resets the dialog to the most recently saved values,
+ erasing any changes you have made.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Reboot</term>
+ <listitem>
+ <para>
+ This reboots the device. Use this to
+ switch from idle to pad mode by rebooting once the rocket is
+ oriented for flight, or to confirm changes you think you saved
+ are really saved.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Close</term>
+ <listitem>
+ <para>
+ This closes the dialog. Any unsaved changes will be
+ lost.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
The rest of the dialog contains the parameters to be configured.
</para>
<section>
<title>Radio Frequency</title>
<para>
- This configures which of the configured frequencies to use for both
+ This configures which of the frequencies to use for both
telemetry and packet command mode. Note that if you set this
- value via packet command mode, you will have to reconfigure
- the TeleDongle frequency before you will be able to use packet
- command mode again.
+ value via packet command mode, the TeleDongle frequency will
+ also be automatically reconfigured to match so that
+ communication will continue afterwards.
</para>
</section>
<section>
- <title>Radio Calibration</title>
+ <title>RF Calibration</title>
<para>
The radios in every Altus Metrum device are calibrated at the
factory to ensure that they transmit and receive on the
you must reprogram the unit completely.
</para>
</section>
+ <section>
+ <title>Telemetry/RDF/APRS Enable</title>
+ <para>
+ Enables the radio for transmission during flight. When
+ disabled, the radio will not transmit anything during flight
+ at all.
+ </para>
+ </section>
+ <section>
+ <title>APRS Interval</title>
+ <para>
+ How often to transmit GPS information via APRS. This option
+ is available on TeleMetrum v2 and TeleMega
+ boards. TeleMetrum v1 boards cannot transmit APRS
+ packets. Note that a single APRS packet takes nearly a full
+ second to transmit, so enabling this option will prevent
+ sending any other telemetry during that time.
+ </para>
+ </section>
<section>
<title>Callsign</title>
<para>
computers. This configuration parameter allows the two
channels to be used in different configurations.
</para>
- <itemizedlist>
- <listitem>
- <para>
- Dual Deploy. This is the usual mode of operation; the
- 'apogee' channel is fired at apogee and the 'main'
- channel at the height above ground specified by the
- 'Main Deploy Altitude' during descent.
- </para>
- </listitem>
- <listitem>
- <para>
- Redundant Apogee. This fires both channels at
- apogee, the 'apogee' channel first followed after a two second
- delay by the 'main' channel.
- </para>
- </listitem>
- <listitem>
- <para>
- Redundant Main. This fires both channels at the
- height above ground specified by the Main Deploy
- Altitude setting during descent. The 'apogee'
- channel is fired first, followed after a two second
- delay by the 'main' channel.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>Dual Deploy</term>
+ <listitem>
+ <para>
+ This is the usual mode of operation; the
+ 'apogee' channel is fired at apogee and the 'main'
+ channel at the height above ground specified by the
+ 'Main Deploy Altitude' during descent.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Redundant Apogee</term>
+ <listitem>
+ <para>
+ This fires both channels at
+ apogee, the 'apogee' channel first followed after a two second
+ delay by the 'main' channel.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Redundant Main</term>
+ <listitem>
+ <para>
+ This fires both channels at the
+ height above ground specified by the Main Deploy
+ Altitude setting during descent. The 'apogee'
+ channel is fired first, followed after a two second
+ delay by the 'main' channel.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</section>
<section>
<title>Pad Orientation</title>
parameter allows that default to be changed, permitting the
board to be mounted with the antenna pointing aft instead.
</para>
- <itemizedlist>
- <listitem>
- <para>
- Antenna Up. In this mode, the antenna end of the
- TeleMetrum board must point forward, in line with the
- expected flight path.
- </para>
- </listitem>
- <listitem>
- <para>
- Antenna Down. In this mode, the antenna end of the
- TeleMetrum board must point aft, in line with the
- expected flight path.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>Antenna Up</term>
+ <listitem>
+ <para>
+ In this mode, the antenna end of the
+ TeleMetrum board must point forward, in line with the
+ expected flight path.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Antenna Down</term>
+ <listitem>
+ <para>
+ In this mode, the antenna end of the
+ TeleMetrum board must point aft, in line with the
+ expected flight path.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section>
+ <title>Configure Pyro Channels</title>
+ <para>
+ This opens a separate window to configure the additional
+ pyro channels available on TeleMega. One column is
+ presented for each channel. Each row represents a single
+ parameter, if enabled the parameter must meet the specified
+ test for the pyro channel to be fired. See the Pyro Channels
+ section in the System Operation chapter above for a
+ description of these parameters.
+ </para>
+ <para>
+ Select conditions and set the related value; the pyro
+ channel will be activated when <emphasis>all</emphasis> of the
+ conditions are met. Each pyro channel has a separate set of
+ configuration values, so you can use different values for
+ the same condition with different channels.
+ </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
+ configuration by pressing the 'Save' button in the main
+ Configure Flight Computer window.
+ </para>
</section>
</section>
<section>
<para>
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.
+ use during flight monitoring, configuration, 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.
</para>
</section>
<section>
<para>
At the bottom of the dialog, there are three buttons:
</para>
- <itemizedlist>
- <listitem>
- <para>
- 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.
- </para>
- </listitem>
- <listitem>
- <para>
- Reset. This resets the dialog to the most recently saved values,
- erasing any changes you have made.
- </para>
- </listitem>
- <listitem>
- <para>
- Close. This closes the dialog. Any unsaved changes will be
- lost.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>Save</term>
+ <listitem>
+ <para>
+ This writes any changes to the
+ local Java preferences file. If you don't
+ press this button, any changes you make will be lost.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Reset</term>
+ <listitem>
+ <para>
+ This resets the dialog to the most recently saved values,
+ erasing any changes you have made.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Close</term>
+ <listitem>
+ <para>
+ This closes the dialog. Any unsaved changes will be
+ lost.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
The rest of the dialog contains the parameters to be configured.
</para>
<section>
<title>Flash Image</title>
<para>
- This reprograms any Altus Metrum device by using a TeleMetrum
- or TeleDongle as a programming dongle. Please read the
- directions for flashing devices in the Updating Device
- Firmware chapter below.
+ This reprograms Altus Metrum device with new
+ firmware. TeleMetrum v1.x, TeleDongle, TeleMini and TeleBT are
+ all reprogrammed by using another similar unit as a
+ programming dongle (pair programming). TeleMega, TeleMetrum v2
+ and EasyMini are all programmed directly over their USB ports
+ (self programming). Please read the directions for flashing
+ devices in the Updating Device Firmware chapter below.
+ </para>
+ <para>
+ For “self programming”, connect USB to the device to be
+ programmed and push the 'Flash Image' button. That will
+ present a dialog box listing all of the connected
+ devices. Carefully select the device to be programmed.
</para>
<para>
- Once you have the programmer and target devices connected,
- push the 'Flash Image' button. That will present a dialog box
- listing all of the connected devices. Carefully select the
- programmer device, not the device to be programmed.
+ For “pair programming”, once you have the programmer and
+ target devices connected, push the 'Flash Image' button. That
+ will present a dialog box listing all of the connected
+ devices. Carefully select the programmer device, not the
+ device to be programmed.
</para>
<para>
Next, select the image to flash to the device. These are named
</para>
<para>
When programming is complete, the target device will
- reboot. Note that if the target device is connected via USB, you
- will have to unplug it and then plug it back in for the USB
- connection to reset so that you can communicate with the device
- again.
+ reboot. Note that if a pair programmed target device is
+ connected via USB, you will have to unplug it and then plug it
+ back in for the USB connection to reset so that you can
+ communicate with the device again.
</para>
</section>
<section>
This brings up a dialog similar to the Monitor Flight UI,
except it works with the altimeter in “idle” mode by sending
query commands to discover the current state rather than
- listening for telemetry packets.
+ listening for telemetry packets. Because this uses command
+ mode, it needs to have the TeleDongle and flight computer
+ callsigns match exactly. If you can receive telemetry, but
+ cannot manage to run Monitor Idle, then it's very likely that
+ your callsigns are different in some way.
</para>
</section>
</chapter>
rocket is ready for flight. The first elements include red/green
indicators, if any of these is red, you'll want to evaluate
whether the rocket is ready to launch:
- <itemizedlist>
- <listitem>
- <para>
- Battery Voltage. This indicates whether the Li-Po battery
- powering the TeleMetrum has sufficient charge to last for
- the duration of the flight. A value of more than
- 3.7V is required for a 'GO' status.
- </para>
- </listitem>
- <listitem>
- <para>
- Apogee Igniter Voltage. This indicates whether the apogee
- igniter has continuity. If the igniter has a low
- resistance, then the voltage measured here will be close
- to the Li-Po battery voltage. A value greater than 3.2V is
- required for a 'GO' status.
- </para>
- </listitem>
- <listitem>
- <para>
- Main Igniter Voltage. This indicates whether the main
- igniter has continuity. If the igniter has a low
- resistance, then the voltage measured here will be close
- to the Li-Po battery voltage. A value greater than 3.2V is
- required for a 'GO' status.
- </para>
- </listitem>
- <listitem>
- <para>
- On-board Data Logging. This indicates whether there is
- space remaining on-board to store flight data for the
- upcoming flight. If you've downloaded data, but failed
- to erase flights, there may not be any space
- left. TeleMetrum can store multiple flights, depending
- on the configured maximum flight log size. TeleMini
- stores only a single flight, so it will need to be
- downloaded and erased after each flight to capture
- data. This only affects on-board flight logging; the
- altimeter will still transmit telemetry and fire
- ejection charges at the proper times.
- </para>
- </listitem>
- <listitem>
- <para>
- GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is
- currently able to compute position information. GPS requires
- at least 4 satellites to compute an accurate position.
- </para>
- </listitem>
- <listitem>
- <para>
- GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least
- 10 consecutive positions without losing lock. This ensures
- that the GPS receiver has reliable reception from the
- satellites.
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>Battery Voltage</term>
+ <listitem>
+ <para>
+ This indicates whether the Li-Po battery
+ powering the TeleMetrum has sufficient charge to last for
+ the duration of the flight. A value of more than
+ 3.8V is required for a 'GO' status.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Apogee Igniter Voltage</term>
+ <listitem>
+ <para>
+ This indicates whether the apogee
+ igniter has continuity. If the igniter has a low
+ resistance, then the voltage measured here will be close
+ to the Li-Po battery voltage. A value greater than 3.2V is
+ required for a 'GO' status.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Main Igniter Voltage</term>
+ <listitem>
+ <para>
+ This indicates whether the main
+ igniter has continuity. If the igniter has a low
+ resistance, then the voltage measured here will be close
+ to the Li-Po battery voltage. A value greater than 3.2V is
+ required for a 'GO' status.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>On-board Data Logging</term>
+ <listitem>
+ <para>
+ This indicates whether there is
+ space remaining on-board to store flight data for the
+ upcoming flight. If you've downloaded data, but failed
+ to erase flights, there may not be any space
+ left. TeleMetrum can store multiple flights, depending
+ on the configured maximum flight log size. TeleMini
+ stores only a single flight, so it will need to be
+ downloaded and erased after each flight to capture
+ data. This only affects on-board flight logging; the
+ altimeter will still transmit telemetry and fire
+ ejection charges at the proper times.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>GPS Locked</term>
+ <listitem>
+ <para>
+ For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is
+ currently able to compute position information. GPS requires
+ at least 4 satellites to compute an accurate position.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>GPS Ready</term>
+ <listitem>
+ <para>
+ For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least
+ 10 consecutive positions without losing lock. This ensures
+ that the GPS receiver has reliable reception from the
+ satellites.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
<para>
The Launchpad tab also shows the computed launch pad position
if the rocket is hiding in sage brush or a tree, or if the last GPS position
doesn't get you close enough because the rocket dropped into a canyon, or
the wind is blowing it across a dry lake bed, or something like that... Keith
- and Bdale both currently own and use the Yaesu VX-7R at launches.
+ currently uses a Yaesu VX-7R, Bdale has a Baofung UV-5R
+ which isn't as nice, but was a whole lot cheaper.
</para>
<para>
So, to recap, on the ground the hardware you'll need includes:
<chapter>
<title>Updating Device Firmware</title>
<para>
- The big concept to understand is that you have to use a
- TeleDongle as a programmer to update a TeleMetrum or TeleMini,
- and a TeleMetrum or other TeleDongle to program the TeleDongle
- Due to limited memory resources in the cc1111, we don't support
- programming directly over USB.
+ TeleMega, TeleMetrum v2 and EasyMini are all programmed directly
+ over their USB connectors (self programming). TeleMetrum v1, TeleMini and
+ TeleDongle are all programmed by using another device as a
+ programmer (pair programming). It's important to recognize which
+ kind of devices you have before trying to reprogram them.
</para>
<para>
You may wish to begin by ensuring you have current firmware images.
<para>
We recommend updating the altimeter first, before updating TeleDongle.
</para>
+ <para>
+ Self-programmable devices (TeleMega, TeleMetrum v2 and EasyMini)
+ are reprogrammed by connecting them to your computer over USB
+ </para>
<section>
- <title>Updating TeleMetrum Firmware</title>
+ <title>
+ Updating TeleMega, TeleMetrum v2 or EasyMini Firmware
+ </title>
+ <orderedlist inheritnum='inherit' numeration='arabic'>
+ <listitem>
+ <para>
+ Attach a battery and power switch to the target
+ device. Power up the device.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Using a Micro USB cable, connect the target device to your
+ computer's USB socket.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Run AltosUI, and select 'Flash Image' from the File menu.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select the target device in the Device Selection dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select the image you want to flash to the device, which
+ should have a name in the form
+ <product>-v<product-version>-<software-version>.ihx, such
+ as TeleMega-v1.0-1.3.0.ihx.
+ </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 device with new firmware, showing a progress bar.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Verify that the device is working by using the 'Configure
+ Altimeter' item to check over the configuration.
+ </para>
+ </listitem>
+ </orderedlist>
+ <section>
+ <title>Recovering From Self-Flashing Failure</title>
+ <para>
+ If the firmware loading fails, it can leave the device
+ unable to boot. Not to worry, you can force the device to
+ start the boot loader instead, which will let you try to
+ flash the device again.
+ </para>
+ <para>
+ On each device, connecting two pins from one of the exposed
+ connectors will force the boot loader to start, even if the
+ regular operating system has been corrupted in some way.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>TeleMega</term>
+ <listitem>
+ <para>
+ Connect pin 6 and pin 1 of the companion connector. Pin 1
+ can be identified by the square pad around it, and then
+ the pins could sequentially across the board. Be very
+ careful to <emphasis>not</emphasis> short pin 8 to
+ anything as that is connected directly to the battery. Pin
+ 7 carries 3.3V and the board will crash if that is
+ connected to pin 1, but shouldn't damage the board.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TeleMetrum v2</term>
+ <listitem>
+ <para>
+ Connect pin 6 and pin 1 of the companion connector. Pin 1
+ can be identified by the square pad around it, and then
+ the pins could sequentially across the board. Be very
+ careful to <emphasis>not</emphasis> short pin 8 to
+ anything as that is connected directly to the battery. Pin
+ 7 carries 3.3V and the board will crash if that is
+ connected to pin 1, but shouldn't damage the board.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>EasyMini</term>
+ <listitem>
+ <para>
+ Connect pin 6 and pin 1 of the debug connector, which is
+ the six holes next to the beeper. Pin 1 can be identified
+ by the square pad around it, and then the pins could
+ sequentially across the board, making Pin 6 the one on the
+ other end of the row.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ </section>
+ <section>
+ <title>Pair Programming</title>
+ <para>
+ The big concept to understand is that you have to use a
+ TeleMega, TeleMetrum or TeleDongle as a programmer to update a
+ pair programmed device. Due to limited memory resources in the
+ cc1111, we don't support programming directly over USB for these
+ devices.
+ </para>
+ </section>
+ <section>
+ <title>Updating TeleMetrum v1.x Firmware</title>
<orderedlist inheritnum='inherit' numeration='arabic'>
<listitem>
<para>
<chapter>
<title>Hardware Specifications</title>
<section>
- <title>TeleMetrum Specifications</title>
+ <title>
+ TeleMega Specifications
+ </title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Recording altimeter for model rocketry.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Supports dual deployment and four auxiliary pyro channels
+ (a total of 6 events).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 70cm 40mW ham-band transceiver for telemetry down-link.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Barometric pressure sensor good to 100k feet MSL.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 1-axis high-g accelerometer for motor characterization, capable of
+ +/- 102g.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 9-axis IMU including integrated 3-axis accelerometer,
+ 3-axis gyroscope and 3-axis magnetometer.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On-board, integrated uBlox Max 7 GPS receiver with 5Hz update rate capability.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On-board 8 Megabyte non-volatile memory for flight data storage.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ USB interface for battery charging, configuration, and data recovery.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Fully integrated support for Li-Po rechargeable batteries.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Uses Li-Po to fire e-matches, can be modified to support
+ optional separate pyro battery if needed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 3.25 x 1.25 inch board designed to fit inside 38mm air-frame coupler tube.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>
+ TeleMetrum v2 Specifications
+ </title>
<itemizedlist>
<listitem>
<para>
</listitem>
<listitem>
<para>
- 70cm ham-band transceiver for telemetry down-link.
+ 70cm, 40mW ham-band transceiver for telemetry down-link.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Barometric pressure sensor good to 100k feet MSL.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 1-axis high-g accelerometer for motor characterization, capable of
+ +/- 102g.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On-board, integrated uBlox Max 7 GPS receiver with 5Hz update rate capability.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On-board 8 Megabyte non-volatile memory for flight data storage.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ USB interface for battery charging, configuration, and data recovery.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Fully integrated support for Li-Po rechargeable batteries.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Uses Li-Po to fire e-matches, can be modified to support
+ optional separate pyro battery if needed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 2.75 x 1 inch board designed to fit inside 29mm air-frame coupler tube.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>TeleMetrum v1 Specifications</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Recording altimeter for model rocketry.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Supports dual deployment (can fire 2 ejection charges).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 70cm, 10mW ham-band transceiver for telemetry down-link.
</para>
</listitem>
<listitem>
</itemizedlist>
</section>
<section>
- <title>TeleMini Specifications</title>
+ <title>
+ TeleMini v2.0 Specifications
+ </title>
<itemizedlist>
<listitem>
<para>
</listitem>
<listitem>
<para>
- 70cm ham-band transceiver for telemetry down-link.
+ 70cm, 10mW ham-band transceiver for telemetry down-link.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Barometric pressure sensor good to 100k feet MSL.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On-board 1 megabyte non-volatile memory for flight data storage.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ USB interface for configuration, and data recovery.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Support for Li-Po rechargeable batteries (using an
+ external charger), or any 3.7-15V external battery.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Uses Li-Po to fire e-matches, can be modified to support
+ optional separate pyro battery if needed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 1.5 x .8 inch board designed to fit inside 24mm air-frame coupler tube.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>
+ TeleMini v1.0 Specifications
+ </title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Recording altimeter for model rocketry.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Supports dual deployment (can fire 2 ejection charges).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 70cm, 10mW ham-band transceiver for telemetry down-link.
</para>
</listitem>
<listitem>
</listitem>
</itemizedlist>
</section>
+ <section>
+ <title>
+ EasyMini Specifications
+ </title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Recording altimeter for model rocketry.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Supports dual deployment (can fire 2 ejection charges).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Barometric pressure sensor good to 100k feet MSL.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On-board 1 megabyte non-volatile memory for flight data storage.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ USB interface for configuration, and data recovery.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Support for Li-Po rechargeable batteries (using an
+ external charger), or any 3.7-15V external battery.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Uses Li-Po to fire e-matches, can be modified to support
+ optional separate pyro battery if needed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 1.5 x .8 inch board designed to fit inside 24mm air-frame coupler tube.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
</chapter>
<chapter>
<title>FAQ</title>
These images, when printed, provide precise templates for the
mounting holes in Altus Metrum flight computers
</para>
+ <section>
+ <title>TeleMega template</title>
+ <para>
+ TeleMega has overall dimensions of 1.250 x 3.250 inches, and
+ the mounting holes are sized for use with 4-40 or M3 screws.
+ </para>
+ <mediaobject id="TeleMegaTemplate">
+ <imageobject>
+ <imagedata format="SVG" fileref="telemega-outline.svg"/>
+ </imageobject>
+ </mediaobject>
+ </section>
<section>
<title>TeleMetrum template</title>
<para>
</mediaobject>
</section>
<section>
- <title>TeleMini template</title>
+ <title>TeleMini v2/EasyMini template</title>
+ <para>
+ TeleMini v2 and EasyMini have overall dimensions of 0.800 x 1.500 inches, and the
+ mounting holes are sized for use with 4-40 or M3 screws.
+ </para>
+ <mediaobject id="MiniTemplate">
+ <imageobject>
+ <imagedata format="SVG" fileref="easymini-outline.svg"/>
+ </imageobject>
+ </mediaobject>
+ </section>
+ <section>
+ <title>TeleMini v1 template</title>
<para>
TeleMini has overall dimensions of 0.500 x 1.500 inches, and the
mounting holes are sized for use with 2-56 or M2 screws.
<appendix>
<title>Calibration</title>
<para>
- There are only two calibrations required for a TeleMetrum board, and
- only one for TeleDongle and TeleMini. All boards are shipped from
- the factory pre-calibrated, but the procedures are documented here
- in case they are ever needed. Re-calibration is not supported by
- AltosUI, you must connect to the board with a serial terminal program
- and interact directly with the on-board command interpreter to effect
- calibration.
+ There are only two calibrations required for TeleMetrum and
+ TeleMega, and only one for TeleDongle, TeleMini and EasyMini.
+ All boards are shipped from the factory pre-calibrated, but
+ the procedures are documented here in case they are ever
+ needed. Re-calibration is not supported by AltosUI, you must
+ connect to the board with a serial terminal program and
+ interact directly with the on-board command interpreter to
+ effect calibration.
</para>
<section>
<title>Radio Frequency</title>
<para>
- The radio frequency is synthesized from a clock based on the 48 MHz
+ The radio frequency is synthesized from a clock based on the
crystal on the board. The actual frequency of this oscillator
must be measured to generate a calibration constant. While our
GFSK modulation
should generally not be required.
</para>
<para>
- To calibrate the radio frequency, connect the UHF antenna port to a
- frequency counter, set the board to 434.550MHz, and use the 'C'
- command in the on-board command interpreter to generate a CW
- carrier. For TeleMetrum, this is best done over USB. For TeleMini,
- note that the only way to escape the 'C' command is via power cycle
- since the board will no longer be listening for commands once it
- starts generating a CW carrier.
+ To calibrate the radio frequency, connect the UHF antenna
+ port to a frequency counter, set the board to 434.550MHz,
+ and use the 'C' command in the on-board command interpreter
+ to generate a CW carrier. For USB-enabled boards, this is
+ best done over USB. For TeleMini v1, note that the only way
+ to escape the 'C' command is via power cycle since the board
+ will no longer be listening for commands once it starts
+ generating a CW carrier.
</para>
<para>
Wait for the transmitter temperature to stabilize and the frequency
command. Testing with the 'C' command again should show a carrier
within a few tens of Hertz of the intended frequency.
As with all 'c' sub-commands, follow this with a 'c w' to write the
- change to the parameter block in the on-board DataFlash chip.
+ change to the parameter block in the on-board storage chip.
</para>
<para>
Note that any time you re-do the radio frequency calibration, the
</para>
</section>
<section>
- <title>TeleMetrum Accelerometer</title>
+ <title>TeleMetrum and TeleMega Accelerometers</title>
<para>
- The TeleMetrum accelerometer we use has its own 5 volt power
- supply and
- the output must be passed through a resistive voltage divider to match
- the input of our 3.3 volt ADC. This means that unlike the barometric
- sensor, the output of the acceleration sensor is not ratio-metric to
- the ADC converter, and calibration is required. Explicitly
- calibrating the accelerometers also allows us to load any device
- from a Freescale family that includes at least +/- 40g, 50g, 100g,
- and 200g parts. Using gravity,
- a simple 2-point calibration yields acceptable results capturing both
- the different sensitivities and ranges of the different accelerometer
- parts and any variation in power supply voltages or resistor values
- in the divider network.
+ While barometric sensors are factory-calibrated,
+ accelerometers are not, and so each must be calibrated once
+ installed in a flight computer. Explicitly calibrating the
+ accelerometers also allows us to load any compatible device.
+ We perform a two-point calibration using gravity.
</para>
<para>
To calibrate the acceleration sensor, use the 'c a 0' command. You
</para>
<para>
In the unlikely event an accel cal goes badly, it is possible
- that TeleMetrum 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.
+ 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.
</para>
</section>
</appendix>
projects / fw / altos / blobdiff