The Altus Metrum System

An Owner's Manual for Altus Metrum Rocketry Electronics

Bdale Garbee

Keith Packard

Bob Finch

Anthony Towns

This document is released under the terms of the Creative Commons ShareAlike 3.0 license.

Revision History
Revision 1.56 September 2014
Major release adding EasyMega support.
Revision 1.4.120 June 2014
Minor release fixing some installation bugs.
Revision 1.415 June 2014
Major release adding TeleGPS support.
Revision 1.3.224 January 2014
Bug fixes for TeleMega and AltosUI.
Revision 1.3.121 January 2014
Bug fixes for TeleMega and TeleMetrum v2.0 along with a few small UI improvements.
Revision 1.312 November 2013
Updated for software version 1.3. Version 1.3 adds support for TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini and fixes bugs in AltosUI and the AltOS firmware.
Revision 1.2.121 May 2013
Updated for software version 1.2. Version 1.2 adds support for TeleBT and AltosDroid. It also adds a few minor features and fixes bugs in AltosUI and the AltOS firmware.
Revision 1.218 April 2013
Updated for software version 1.2. Version 1.2 adds support for MicroPeak and the MicroPeak USB interface.
Revision 1.1.116 September 2012
Updated for software version 1.1.1 Version 1.1.1 fixes a few bugs found in version 1.1.
Revision 1.113 September 2012
Updated for software version 1.1. Version 1.1 has new features but is otherwise compatible with version 1.0.
Revision 1.024 August 2011
Updated for software version 1.0. Note that 1.0 represents a telemetry format change, meaning both ends of a link (TeleMetrum/TeleMini and TeleDongle) must be updated or communications will fail.
Revision 0.918 January 2011
Updated for software version 0.9. Note that 0.9 represents a telemetry format change, meaning both ends of a link (TeleMetrum and TeleDongle) must be updated or communications will fail.
Revision 0.824 November 2010
Updated for software version 0.8

Acknowledgments

Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing “The Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter Kit” which formed the basis of the original Getting Started chapter in this manual. Bob was one of our first customers for a production TeleMetrum, and his continued enthusiasm and contributions are immensely gratifying and highly appreciated!

And thanks to Anthony (AJ) Towns for major contributions including the AltosUI graphing and site map code and associated documentation. Free software means that our customers and friends can become our collaborators, and we certainly appreciate this level of contribution!

Have fun using these products, and we hope to meet all of you out on the rocket flight line somewhere.


Bdale Garbee, KB0G
NAR #87103, TRA #12201

Keith Packard, KD7SQG
NAR #88757, TRA #12200
      

Table of Contents

1. Introduction and Overview
2. Getting Started
3. Handling Precautions
4. Altus Metrum Hardware
1. General Usage Instructions
1.1. Hooking Up Lithium Polymer Batteries
1.2. Hooking Up Pyro Charges
1.3. Hooking Up a Power Switch
1.4. Using a Separate Pyro Battery
1.5. Using a Different Kind of Battery
2. Specifications
3. TeleMetrum
3.1. TeleMetrum Screw Terminals
3.2. Using a Separate Pyro Battery with TeleMetrum
3.3. Using an Active Switch with TeleMetrum
4. TeleMini v1.0
4.1. TeleMini v1.0 Screw Terminals
4.2. Using a Separate Pyro Battery with TeleMini v1.0
4.3. Using an Active Switch with TeleMini v1.0
5. TeleMini v2.0
5.1. TeleMini v2.0 Screw Terminals
5.2. Using a Separate Pyro Battery with TeleMini v2.0
5.3. Using an Active Switch with TeleMini v2.0
6. EasyMini
6.1. EasyMini Screw Terminals
6.2. Using a Separate Pyro Battery with EasyMini
6.3. Using an Active Switch with EasyMini
7. TeleMega
7.1. TeleMega Screw Terminals
7.2. Using a Separate Pyro Battery with TeleMega
7.3. Using Only One Battery With TeleMega
7.4. Using an Active Switch with TeleMega
8. EasyMega
8.1. EasyMega Screw Terminals
8.2. Using a Separate Pyro Battery with EasyMega
8.3. Using Only One Battery With EasyMega
8.4. Using an Active Switch with EasyMega
9. Flight Data Recording
10. Installation
5. System Operation
1. Firmware Modes
2. GPS
3. Controlling An Altimeter Over The Radio Link
4. Ground Testing
5. Radio Link
6. APRS
7. Configurable Parameters
7.1. Radio Frequency
7.2. Callsign
7.3. Telemetry/RDF/APRS Enable
7.4. Telemetry baud rate
7.5. APRS Interval
7.6. APRS SSID
7.7. Apogee Delay
7.8. Apogee Lockout
7.9. Main Deployment Altitude
7.10. Maximum Flight Log
7.11. Ignite Mode
7.12. Pad Orientation
7.13. Configurable Pyro Channels
6. AltosUI
1. Monitor Flight
1.1. Launch Pad
1.2. Ascent
1.3. Descent
1.4. Landed
1.5. Table
1.6. Site Map
1.7. Ignitor
2. Save Flight Data
3. Replay Flight
4. Graph Data
4.1. Flight Graph
4.2. Configure Graph
4.3. Flight Statistics
4.4. Map
5. Export Data
5.1. Comma Separated Value Format
5.2. Keyhole Markup Language (for Google Earth)
6. Configure Altimeter
6.1. Main Deploy Altitude
6.2. Apogee Delay
6.3. Apogee Lockoug
6.4. Frequency
6.5. RF Calibration
6.6. Telemetry/RDF/APRS Enable
6.7. Telemetry baud rate
6.8. APRS Interval
6.9. APRS SSID
6.10. Callsign
6.11. Maximum Flight Log Size
6.12. Ignitor Firing Mode
6.13. Pad Orientation
6.14. Beeper Frequency
6.15. Configure Pyro Channels
7. Configure AltosUI
7.1. Voice Settings
7.2. Log Directory
7.3. Callsign
7.4. Imperial Units
7.5. Font Size
7.6. Serial Debug
7.7. Manage Frequencies
8. Configure Groundstation
8.1. Frequency
8.2. RF Calibration
8.3. Telemetry Rate
9. Flash Image
10. Fire Igniter
11. Scan Channels
12. Load Maps
13. Monitor Idle
7. AltosDroid
1. Installing AltosDroid
2. Connecting to TeleBT
3. Configuring AltosDroid
4. AltosDroid Flight Monitoring
4.1. Pad
5. Downloading Flight Logs
8. Using Altus Metrum Products
1. Being Legal
2. In the Rocket
3. On the Ground
4. Data Analysis
5. Future Plans
9. Altimeter Installation Recommendations
1. Mounting the Altimeter
2. Dealing with the Antenna
3. Preserving GPS Reception
4. Radio Frequency Interference
5. The Barometric Sensor
6. Ground Testing
10. Updating Device Firmware
1. Updating TeleMega, TeleMetrum v2, EasyMega or EasyMini Firmware
1.1. Recovering From Self-Flashing Failure
2. Pair Programming
3. Updating TeleMetrum v1.x Firmware
4. Updating TeleMini Firmware
5. Updating TeleDongle Firmware
11. Hardware Specifications
1. TeleMega Specifications
2. EasyMega Specifications
3. TeleMetrum v2 Specifications
4. TeleMetrum v1 Specifications
5. TeleMini v2.0 Specifications
6. TeleMini v1.0 Specifications
7. EasyMini Specifications
12. FAQ
A. Notes for Older Software
B. Drill Templates
1. TeleMega template
2. EasyMega template
3. TeleMetrum template
4. TeleMini v2/EasyMini template
5. TeleMini v1 template
C. Calibration
1. Radio Frequency
2. TeleMetrum, TeleMega and EasyMega Accelerometers
D. Release Notes

List of Tables

4.1. Altus Metrum Electronics
4.2. Altus Metrum Boards
4.3. TeleMetrum Screw Terminals
4.4. TeleMini v1.0 Connections
4.5. TeleMini v2.0 Connections
4.6. EasyMini Connections
4.7. TeleMega Screw Terminals
4.8. EasyMega Screw Terminals
4.9. Data Storage on Altus Metrum altimeters
5.1. AltOS Modes
5.2. Pad/Idle Indications
5.3. Altus Metrum APRS Comments

Chapter 1. Introduction and Overview

Welcome to the Altus Metrum community! Our circuits and software reflect our passion for both hobby rocketry and Free Software. We hope their capabilities and performance will delight you in every way, but by releasing all of our hardware and software designs under open licenses, we also hope to empower you to take as active a role in our collective future as you wish!

The first device created for our community was TeleMetrum, a dual deploy altimeter with fully integrated GPS and radio telemetry as standard features, and a “companion interface” that will support optional capabilities in the future. The latest version of TeleMetrum, v2.0, has all of the same features but with improved sensors and radio to offer increased performance.

Our second device was TeleMini, a dual deploy altimeter with radio telemetry and radio direction finding. The first version of this device was only 13mm by 38mm (½ inch by 1½ inches) and could fit easily in an 18mm air-frame. The latest version, v2.0, includes a beeper, USB data download and extended on-board flight logging, along with an improved barometric sensor.

TeleMega is our most sophisticated device, including six pyro channels (four of which are fully programmable), integrated GPS, integrated gyroscopes for staging/air-start inhibit and high performance telemetry.

EasyMini is a dual-deploy altimeter with logging and built-in USB data download.

EasyMega is essentially a TeleMega board with the GPS receiver and telemetry transmitter removed. It offers the same 6 pyro channels and integrated gyroscopes for staging/air-start inhibit.

TeleDongle was our first ground station, providing a USB to RF interfaces for communicating with the altimeters. Combined with your choice of antenna and notebook computer, TeleDongle and our associated user interface software form a complete ground station capable of logging and displaying in-flight telemetry, aiding rocket recovery, then processing and archiving flight data for analysis and review.

For a slightly more portable ground station experience that also provides direct rocket recovery support, TeleBT offers flight monitoring and data logging using a Bluetooth™ connection between the receiver and an Android device that has the AltosDroid application installed from the Google Play store.

More products will be added to the Altus Metrum family over time, and we currently envision that this will be a single, comprehensive manual for the entire product family.

Chapter 2. Getting Started

The first thing to do after you check the inventory of parts in your “starter kit” is to charge the battery.

For TeleMetrum, TeleMega and EasyMega, the battery can be charged by plugging it into the corresponding socket of the device and then using the USB cable to plug the flight computer into your computer's USB socket. The on-board circuitry will charge the battery whenever it is plugged in, because the on-off switch does NOT control the charging circuitry.

On TeleMetrum v1 boards, when the GPS chip is initially searching for satellites, TeleMetrum will consume more current than it pulls from the USB port, so the battery must be attached in order to get satellite lock. Once GPS is locked, the current consumption goes back down enough to enable charging while running. So it's a good idea to fully charge the battery as your first item of business so there is no issue getting and maintaining satellite lock. The yellow charge indicator led will go out when the battery is nearly full and the charger goes to trickle charge. It can take several hours to fully recharge a deeply discharged battery.

TeleMetrum v2.0, TeleMega and EasyMega use a higher power battery charger, allowing them to charge the battery while running the board at maximum power. When the battery is charging, or when the board is consuming a lot of power, the red LED will be lit. When the battery is fully charged, the green LED will be lit. When the battery is damaged or missing, both LEDs will be lit, which appears yellow.

The Lithium Polymer TeleMini and EasyMini battery can be charged by disconnecting it from the board and plugging it into a standalone battery charger such as the LipoCharger product included in TeleMini Starter Kits, and connecting that via a USB cable to a laptop or other USB power source.

You can also choose to use another battery with TeleMini v2.0 and EasyMini, anything supplying between 4 and 12 volts should work fine (like a standard 9V battery), but if you are planning to fire pyro charges, ground testing is required to verify that the battery supplies enough current to fire your chosen e-matches.

The other active device in the starter kit is the TeleDongle USB to RF interface. If you plug it in to your Mac or Linux computer it should “just work”, showing up as a serial port device. Windows systems need driver information that is part of the AltOS download to know that the existing USB modem driver will work. We therefore recommend installing our software before plugging in TeleDongle if you are using a Windows computer. If you are using an older version of Linux and are having problems, try moving to a fresher kernel (2.6.33 or newer).

Next you should obtain and install the AltOS software. The AltOS distribution includes the AltosUI ground station program, current firmware images for all of the hardware, and a number of standalone utilities that are rarely needed. Pre-built binary packages are available for Linux, Microsoft Windows, and recent MacOSX versions. Full source code and build instructions are also available. The latest version may always be downloaded from http://altusmetrum.org/AltOS.

If you're using a TeleBT instead of the TeleDongle, you'll want to install the AltosDroid application from the Google Play store on an Android device. You don't need a data plan to use AltosDroid, but without network access, the Map view will be less useful as it won't contain any map data. You can also use TeleBT connected over USB with your laptop computer; it acts exactly like a TeleDongle. Anywhere this manual talks about TeleDongle, you can also read that as 'and TeleBT when connected via USB'.

Chapter 3. Handling Precautions

All Altus Metrum products are sophisticated electronic devices. When handled gently and properly installed in an air-frame, they will deliver impressive results. However, as with all electronic devices, there are some precautions you must take.

The Lithium Polymer rechargeable batteries have an extraordinary power density. This is great because we can fly with much less battery mass than if we used alkaline batteries or previous generation rechargeable batteries... but if they are punctured or their leads are allowed to short, they can and will release their energy very rapidly! Thus we recommend that you take some care when handling our batteries and consider giving them some extra protection in your air-frame. We often wrap them in suitable scraps of closed-cell packing foam before strapping them down, for example.

The barometric sensors used on all of our flight computers are sensitive to sunlight. In normal mounting situations, the baro sensor and all of the other surface mount components are “down” towards whatever the underlying mounting surface is, so this is not normally a problem. Please consider this when designing an installation in an air-frame with a see-through plastic payload bay. It is particularly important to consider this with TeleMini v1.0, both because the baro sensor is on the “top” of the board, and because many model rockets with payload bays use clear plastic for the payload bay! Replacing these with an opaque cardboard tube, painting them, or wrapping them with a layer of masking tape are all reasonable approaches to keep the sensor out of direct sunlight.

The barometric sensor sampling port must be able to “breathe”, both by not being covered by foam or tape or other materials that might directly block the hole on the top of the sensor, and also by having a suitable static vent to outside air.

As with all other rocketry electronics, Altus Metrum altimeters must be protected from exposure to corrosive motor exhaust and ejection charge gasses.

Chapter 4. Altus Metrum Hardware

1. General Usage Instructions

Here are general instructions for hooking up an Altus Metrum flight computer. Instructions specific to each model will be found in the section devoted to that model below.

To prevent electrical interference from affecting the operation of the flight computer, it's important to always twist pairs of wires connected to the board. Twist the switch leads, the pyro leads and the battery leads. This reduces interference through a mechanism called common mode rejection.

1.1. Hooking Up Lithium Polymer Batteries

All Altus Metrum flight computers have a two pin JST PH series connector to connect up a single-cell Lithium Polymer cell (3.7V nominal). You can purchase matching batteries from the Altus Metrum store, or other vendors, or you can make your own. Pin 1 of the connector is positive, pin 2 is negative. Spark Fun sells a cable with the connector attached, which they call a JST Jumper 2 Wire Assembly.

Many RC vendors also sell lithium polymer batteries with this same connector. All that we have found use the opposite polarity, and if you use them that way, you will damage or destroy the flight computer.

1.2. Hooking Up Pyro Charges

Altus Metrum flight computers always have two screws for each pyro charge. This means you shouldn't need to put two wires into a screw terminal or connect leads from pyro charges together externally.

On the flight computer, one lead from each charge is hooked to the positive battery terminal through the power switch. The other lead is connected through the pyro circuit, which is connected to the negative battery terminal when the pyro circuit is fired.

1.3. Hooking Up a Power Switch

Altus Metrum flight computers need an external power switch to turn them on. This disconnects both the computer and the pyro charges from the battery, preventing the charges from firing when in the Off position. The switch is in-line with the positive battery terminal.

1.3.1. Using an External Active Switch Circuit

You can use an active switch circuit, such as the Featherweight Magnetic Switch, with any Altus Metrum flight computer. These require three connections, one to the battery, one to the positive power input on the flight computer and one to ground. Find instructions on how to hook these up for each flight computer below. The follow the instructions that come with your active switch to connect it up.

1.4. Using a Separate Pyro Battery

As mentioned above in the section on hooking up pyro charges, one lead for each of the pyro charges is connected through the power switch directly to the positive battery terminal. The other lead is connected to the pyro circuit, which connects it to the negative battery terminal when the pyro circuit is fired. The pyro circuit on all of the flight computers is designed to handle up to 16V.

To use a separate pyro battery, connect the negative pyro battery terminal to the flight computer ground terminal, the positive battery terminal to the igniter and the other igniter lead to the negative pyro terminal on the flight computer. When the pyro channel fires, it will complete the circuit between the negative pyro terminal and the ground terminal, firing the igniter. Specific instructions on how to hook this up will be found in each section below.

1.5. Using a Different Kind of Battery

EasyMini and TeleMini v2 are designed to use either a lithium polymer battery or any other battery producing between 4 and 12 volts, such as a rectangular 9V battery. TeleMega, EasyMega and TeleMetrum are not designed for this, and must only be powered by a lithium polymer battery. Find instructions on how to use other batteries in the EasyMini and TeleMini sections below.

2. Specifications

Here's the full set of Altus Metrum products, both in production and retired.

Table 4.1. Altus Metrum Electronics

DeviceBarometerZ-axis accelerometerGPS3D sensorsStorageRF OutputBattery
TeleMetrum v1.0

MP3H6115 10km (33k')

MMA2202 50g

SkyTraq-1MB10mW3.7V
TeleMetrum v1.1

MP3H6115 10km (33k')

MMA2202 50g

SkyTraq-2MB10mW3.7V
TeleMetrum v1.2

MP3H6115 10km (33k')

ADXL78 70g

SkyTraq-2MB10mW3.7V
TeleMetrum v2.0

MS5607 30km (100k')

MMA6555 102g

uBlox Max-7Q-8MB40mW3.7V

TeleMini v1.0

MP3H6115 10km (33k')

---5kB10mW3.7V
TeleMini v2.0

MS5607 30km (100k')

---1MB10mW3.7-12V
EasyMini v1.0

MS5607 30km (100k')

---1MB-3.7-12V
TeleMega v1.0

MS5607 30km (100k')

MMA6555 102g

uBlox Max-7Q

MPU6000 HMC5883

8MB40mW3.7V
EasyMega v1.0

MS5607 30km (100k')

MMA6555 102g

-

MPU6000 HMC5883

8MB-3.7V

Table 4.2. Altus Metrum Boards

DeviceConnectorsScrew TerminalsWidthLengthTube Size
TeleMetrum

Antenna Debug Companion USB Battery

Apogee pyro Main pyro Switch

1 inch (2.54cm)2 ¾ inch (6.99cm)29mm coupler

TeleMini v1.0

Antenna Debug Battery

Apogee pyro Main pyro

½ inch (1.27cm)1½ inch (3.81cm)18mm coupler
TeleMini v2.0

Antenna Debug USB Battery

Apogee pyro Main pyro Battery Switch

0.8 inch (2.03cm)1½ inch (3.81cm)24mm coupler
EasyMini

Debug USB Battery

Apogee pyro Main pyro Battery Switch

0.8 inch (2.03cm)1½ inch (3.81cm)24mm coupler
TeleMega

Antenna Debug Companion USB Battery

Apogee pyro Main pyro Pyro A-D Switch Pyro battery

1¼ inch (3.18cm)3¼ inch (8.26cm)38mm coupler
EasyMega

Debug Companion USB Battery

Apogee pyro Main pyro Pyro A-D Switch Pyro battery

1¼ inch (3.18cm)2¼ inch (5.62cm)38mm coupler

3. TeleMetrum

TeleMetrum is a 1 inch by 2¾ inch circuit board. It was designed to fit inside coupler for 29mm air-frame tubing, but using it in a tube that small in diameter may require some creativity in mounting and wiring to succeed! The presence of an accelerometer means TeleMetrum should be aligned along the flight axis of the airframe, and by default the ¼ wave UHF wire antenna should be on the nose-cone end of the board. The antenna wire is about 7 inches long, and wiring for a power switch and the e-matches for apogee and main ejection charges depart from the fin can end of the board, meaning an ideal “simple” avionics bay for TeleMetrum should have at least 10 inches of interior length.

3.1. TeleMetrum Screw Terminals

TeleMetrum has six screw terminals on the end of the board opposite the telemetry antenna. Two are for the power switch, and two each for the apogee and main igniter circuits. Using the picture above and starting from the top, the terminals are as follows:

Table 4.3. TeleMetrum Screw Terminals

Terminal #Terminal NameDescription
1Switch OutputSwitch connection to flight computer
2Switch InputSwitch connection to positive battery terminal
3Main +Main pyro channel common connection to battery +
4Main -Main pyro channel connection to pyro circuit
5Apogee +Apogee pyro channel common connection to battery +
6Apogee -Apogee pyro channel connection to pyro circuit

3.2. Using a Separate Pyro Battery with TeleMetrum

As described above, using an external pyro battery involves connecting the negative battery terminal to the flight computer ground, connecting the positive battery terminal to one of the igniter leads and connecting the other igniter lead to the per-channel pyro circuit connection.

To connect the negative battery terminal to the TeleMetrum ground, insert a small piece of wire, 24 to 28 gauge stranded, into the GND hole just above the screw terminal strip and solder it in place.

Connecting the positive battery terminal to the pyro charges must be done separate from TeleMetrum, by soldering them together or using some other connector.

The other lead from each pyro charge is then inserted into the appropriate per-pyro channel screw terminal (terminal 4 for the Main charge, terminal 6 for the Apogee charge).

3.3. Using an Active Switch with TeleMetrum

As explained above, an external active switch requires three connections, one to the positive battery terminal, one to the flight computer positive input and one to ground.

The positive battery terminal is available on screw terminal 2, the positive flight computer input is on terminal 1. To hook a lead to ground, solder a piece of wire, 24 to 28 gauge stranded, to the GND hole just above terminal 1.

4. TeleMini v1.0

TeleMini v1.0 is ½ inches by 1½ inches. It was designed to fit inside an 18mm air-frame tube, but using it in a tube that small in diameter may require some creativity in mounting and wiring to succeed! Since there is no accelerometer, TeleMini can be mounted in any convenient orientation. The default ¼ wave UHF wire antenna attached to the center of one end of the board is about 7 inches long. Two wires for the power switch are connected to holes in the middle of the board. Screw terminals for the e-matches for apogee and main ejection charges depart from the other end of the board, meaning an ideal “simple” avionics bay for TeleMini should have at least 9 inches of interior length.

4.1. TeleMini v1.0 Screw Terminals

TeleMini v1.0 has four screw terminals on the end of the board opposite the telemetry antenna. Two are for the apogee and two are for main igniter circuits. There are also wires soldered to the board for the power switch. Using the picture above and starting from the top for the terminals and from the left for the power switch wires, the connections are as follows:

Table 4.4. TeleMini v1.0 Connections

Terminal #Terminal NameDescription
1Apogee -Apogee pyro channel connection to pyro circuit
2Apogee +Apogee pyro channel common connection to battery +
3Main -Main pyro channel connection to pyro circuit
4Main +Main pyro channel common connection to battery +
LeftSwitch OutputSwitch connection to flight computer
RightSwitch InputSwitch connection to positive battery terminal

4.2. Using a Separate Pyro Battery with TeleMini v1.0

As described above, using an external pyro battery involves connecting the negative battery terminal to the flight computer ground, connecting the positive battery terminal to one of the igniter leads and connecting the other igniter lead to the per-channel pyro circuit connection. Because there is no solid ground connection to use on TeleMini, this is not recommended.

The only available ground connection on TeleMini v1.0 are the two mounting holes next to the telemetry antenna. Somehow connect a small piece of wire to one of those holes and hook it to the negative pyro battery terminal.

Connecting the positive battery terminal to the pyro charges must be done separate from TeleMini v1.0, by soldering them together or using some other connector.

The other lead from each pyro charge is then inserted into the appropriate per-pyro channel screw terminal (terminal 3 for the Main charge, terminal 1 for the Apogee charge).

4.3. Using an Active Switch with TeleMini v1.0

As explained above, an external active switch requires three connections, one to the positive battery terminal, one to the flight computer positive input and one to ground. Again, because TeleMini doesn't have any good ground connection, this is not recommended.

The positive battery terminal is available on the Right power switch wire, the positive flight computer input is on the left power switch wire. Hook a lead to either of the mounting holes for a ground connection.

5. TeleMini v2.0

TeleMini v2.0 is 0.8 inches by 1½ inches. It adds more on-board data logging memory, a built-in USB connector and screw terminals for the battery and power switch. The larger board fits in a 24mm coupler. There's also a battery connector for a LiPo battery if you want to use one of those.

5.1. TeleMini v2.0 Screw Terminals

TeleMini v2.0 has two sets of four screw terminals on the end of the board opposite the telemetry antenna. Using the picture above, the top four have connections for the main pyro circuit and an external battery and the bottom four have connections for the apogee pyro circuit and the power switch. Counting from the left, the connections are as follows:

Table 4.5. TeleMini v2.0 Connections

Terminal #Terminal NameDescription
Top 1Main -Main pyro channel connection to pyro circuit
Top 2Main +Main pyro channel common connection to battery +
Top 3Battery +Positive external battery terminal
Top 4Battery -Negative external battery terminal
Bottom 1Apogee -Apogee pyro channel connection to pyro circuit
Bottom 2Apogee +Apogee pyro channel common connection to battery +
Bottom 3Switch OutputSwitch connection to flight computer
Bottom 4Switch InputSwitch connection to positive battery terminal

5.2. Using a Separate Pyro Battery with TeleMini v2.0

As described above, using an external pyro battery involves connecting the negative battery terminal to the flight computer ground, connecting the positive battery terminal to one of the igniter leads and connecting the other igniter lead to the per-channel pyro circuit connection.

To connect the negative pyro battery terminal to TeleMini ground, connect it to the negative external battery connection, top terminal 4.

Connecting the positive battery terminal to the pyro charges must be done separate from TeleMini v2.0, by soldering them together or using some other connector.

The other lead from each pyro charge is then inserted into the appropriate per-pyro channel screw terminal (top terminal 1 for the Main charge, bottom terminal 1 for the Apogee charge).

5.3. Using an Active Switch with TeleMini v2.0

As explained above, an external active switch requires three connections, one to the positive battery terminal, one to the flight computer positive input and one to ground. Use the negative external battery connection, top terminal 4 for ground.

The positive battery terminal is available on bottom terminal 4, the positive flight computer input is on the bottom terminal 3.

6. EasyMini

EasyMini is built on a 0.8 inch by 1½ inch circuit board. It's designed to fit in a 24mm coupler tube. The connectors and screw terminals match TeleMini v2.0, so you can easily swap between EasyMini and TeleMini.

6.1. EasyMini Screw Terminals

EasyMini has two sets of four screw terminals on the end of the board opposite the telemetry antenna. Using the picture above, the top four have connections for the main pyro circuit and an external battery and the bottom four have connections for the apogee pyro circuit and the power switch. Counting from the left, the connections are as follows:

Table 4.6. EasyMini Connections

Terminal #Terminal NameDescription
Top 1Main -Main pyro channel connection to pyro circuit
Top 2Main +Main pyro channel common connection to battery +
Top 3Battery +Positive external battery terminal
Top 4Battery -Negative external battery terminal
Bottom 1Apogee -Apogee pyro channel connection to pyro circuit
Bottom 2Apogee +Apogee pyro channel common connection to battery +
Bottom 3Switch OutputSwitch connection to flight computer
Bottom 4Switch InputSwitch connection to positive battery terminal

6.2. Using a Separate Pyro Battery with EasyMini

As described above, using an external pyro battery involves connecting the negative battery terminal to the flight computer ground, connecting the positive battery terminal to one of the igniter leads and connecting the other igniter lead to the per-channel pyro circuit connection.

To connect the negative pyro battery terminal to TeleMini ground, connect it to the negative external battery connection, top terminal 4.

Connecting the positive battery terminal to the pyro charges must be done separate from EasyMini, by soldering them together or using some other connector.

The other lead from each pyro charge is then inserted into the appropriate per-pyro channel screw terminal (top terminal 1 for the Main charge, bottom terminal 1 for the Apogee charge).

6.3. Using an Active Switch with EasyMini

As explained above, an external active switch requires three connections, one to the positive battery terminal, one to the flight computer positive input and one to ground. Use the negative external battery connection, top terminal 4 for ground.

The positive battery terminal is available on bottom terminal 4, the positive flight computer input is on the bottom terminal 3.

7. TeleMega

TeleMega is a 1¼ inch by 3¼ inch circuit board. It was designed to easily fit in a 38mm coupler. Like TeleMetrum, TeleMega has an accelerometer and so it must be mounted so that the board is aligned with the flight axis. It can be mounted either antenna up or down.

7.1. TeleMega Screw Terminals

TeleMega has two sets of nine screw terminals on the end of the board opposite the telemetry antenna. They are as follows:

Table 4.7. TeleMega Screw Terminals

Terminal #Terminal NameDescription
Top 1Switch InputSwitch connection to positive battery terminal
Top 2Switch OutputSwitch connection to flight computer
Top 3GNDGround connection for use with external active switch
Top 4Main -Main pyro channel connection to pyro circuit
Top 5Main +Main pyro channel common connection to battery +
Top 6Apogee -Apogee pyro channel connection to pyro circuit
Top 7Apogee +Apogee pyro channel common connection to battery +
Top 8D -D pyro channel connection to pyro circuit
Top 9D +D pyro channel common connection to battery +
Bottom 1GNDGround connection for negative pyro battery terminal
Bottom 2PyroPositive pyro battery terminal
Bottom 3Lipo Power switch output. Use to connect main battery to pyro battery input
Bottom 4A -A pyro channel connection to pyro circuit
Bottom 5A +A pyro channel common connection to battery +
Bottom 6B -B pyro channel connection to pyro circuit
Bottom 7B +B pyro channel common connection to battery +
Bottom 8C -C pyro channel connection to pyro circuit
Bottom 9C +C pyro channel common connection to battery +

7.2. Using a Separate Pyro Battery with TeleMega

TeleMega provides explicit support for an external pyro battery. All that is required is to remove the jumper between the lipo terminal (Bottom 3) and the pyro terminal (Bottom 2). Then hook the negative pyro battery terminal to ground (Bottom 1) and the positive pyro battery to the pyro battery input (Bottom 2). You can then use the existing pyro screw terminals to hook up all of the pyro charges.

7.3. Using Only One Battery With TeleMega

Because TeleMega has built-in support for a separate pyro battery, if you want to fly with just one battery running both the computer and firing the charges, you need to connect the flight computer battery to the pyro circuit. TeleMega has two screw terminals for this—hook a wire from the Lipo terminal (Bottom 3) to the Pyro terminal (Bottom 2).

7.4. Using an Active Switch with TeleMega

As explained above, an external active switch requires three connections, one to the positive battery terminal, one to the flight computer positive input and one to ground.

The positive battery terminal is available on Top terminal 1, the positive flight computer input is on Top terminal 2. Ground is on Top terminal 3.

8. EasyMega

EasyMega is a 1¼ inch by 2¼ inch circuit board. It was designed to easily fit in a 38mm coupler. Like TeleMetrum, EasyMega has an accelerometer and so it must be mounted so that the board is aligned with the flight axis. It can be mounted either antenna up or down.

8.1. EasyMega Screw Terminals

EasyMega has two sets of nine screw terminals on the end of the board opposite the telemetry antenna. They are as follows:

Table 4.8. EasyMega Screw Terminals

Terminal #Terminal NameDescription
Top 1Switch InputSwitch connection to positive battery terminal
Top 2Switch OutputSwitch connection to flight computer
Top 3GNDGround connection for use with external active switch
Top 4Main -Main pyro channel connection to pyro circuit
Top 5Main +Main pyro channel common connection to battery +
Top 6Apogee -Apogee pyro channel connection to pyro circuit
Top 7Apogee +Apogee pyro channel common connection to battery +
Top 8D -D pyro channel connection to pyro circuit
Top 9D +D pyro channel common connection to battery +
Bottom 1GNDGround connection for negative pyro battery terminal
Bottom 2PyroPositive pyro battery terminal
Bottom 3Lipo Power switch output. Use to connect main battery to pyro battery input
Bottom 4A -A pyro channel connection to pyro circuit
Bottom 5A +A pyro channel common connection to battery +
Bottom 6B -B pyro channel connection to pyro circuit
Bottom 7B +B pyro channel common connection to battery +
Bottom 8C -C pyro channel connection to pyro circuit
Bottom 9C +C pyro channel common connection to battery +

8.2. Using a Separate Pyro Battery with EasyMega

EasyMega provides explicit support for an external pyro battery. All that is required is to remove the jumper between the lipo terminal (Bottom 3) and the pyro terminal (Bottom 2). Then hook the negative pyro battery terminal to ground (Bottom 1) and the positive pyro battery to the pyro battery input (Bottom 2). You can then use the existing pyro screw terminals to hook up all of the pyro charges.

8.3. Using Only One Battery With EasyMega

Because EasyMega has built-in support for a separate pyro battery, if you want to fly with just one battery running both the computer and firing the charges, you need to connect the flight computer battery to the pyro circuit. EasyMega has two screw terminals for this—hook a wire from the Lipo terminal (Bottom 3) to the Pyro terminal (Bottom 2).

8.4. Using an Active Switch with EasyMega

As explained above, an external active switch requires three connections, one to the positive battery terminal, one to the flight computer positive input and one to ground.

The positive battery terminal is available on Top terminal 1, the positive flight computer input is on Top terminal 2. Ground is on Top terminal 3.

9. Flight Data Recording

Each flight computer logs data at 100 samples per second during ascent and 10 samples per second during descent, except for TeleMini v1.0, which records ascent at 10 samples per second and descent at 1 sample per second. Data are logged to an on-board flash memory part, which can be partitioned into several equal-sized blocks, one for each flight.

Table 4.9. Data Storage on Altus Metrum altimeters

DeviceBytes per SampleTotal StorageMinutes at Full Rate
TeleMetrum v1.081MB20
TeleMetrum v1.1 v1.282MB40
TeleMetrum v2.0168MB80
TeleMini v1.025kB4
TeleMini v2.0161MB10
EasyMini161MB10
TeleMega328MB40
EasyMega328MB40

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 you can store more flights.

Configuration data is also stored in the flash memory on TeleMetrum v1.x, TeleMini and EasyMini. This consumes 64kB of flash space. This configuration space is not available for storing flight log data. TeleMetrum v2.0, TeleMega and EasyMega store configuration data in a bit of eeprom available within the processor chip, leaving that space available in flash for more flight data.

To compute the amount of space needed for a single flight, you can multiply the expected ascent time (in seconds) by 100 times bytes-per-sample, multiply the expected descent time (in seconds) by 10 times the bytes per sample and add the two together. That will slightly under-estimate the storage (in bytes) needed for the flight. For instance, a TeleMetrum v2.0 flight spending 20 seconds in ascent and 150 seconds in descent will take about (20 * 1600) + (150 * 160) = 56000 bytes of storage. You could store dozens of these flights in the on-board flash.

The default size allows for several flights on each flight computer, except for TeleMini v1.0, which only holds data for a single flight. You can adjust the size.

Altus Metrum flight computers will not overwrite existing flight data, so be sure to download flight data and erase it from the flight computer before it fills up. The flight computer will still successfully control the flight even if it cannot log data, so the only thing you will lose is the data.

10. Installation

A typical installation involves attaching only a suitable battery, a single pole switch for power on/off, and two pairs of wires connecting e-matches for the apogee and main ejection charges. All Altus Metrum products are designed for use with single-cell batteries with 3.7 volts nominal. TeleMini v2.0 and EasyMini may also be used with other batteries as long as they supply between 4 and 12 volts.

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 battery directly to fire ejection charges. This works marvelously with standard low-current e-matches like the J-Tek from MJG Technologies, and with Quest Q2G2 igniters. However, if you want or need to use a separate pyro battery, check out the “External Pyro Battery” section in this manual for instructions on how to wire that up. The altimeters are designed to work with an external pyro battery of no more than 15 volts.

Ejection charges are wired directly to the screw terminal block at the aft end of the altimeter. You'll need a very small straight blade screwdriver for these screws, such as you might find in a jeweler's screwdriver set.

Except for TeleMini v1.0, the flight computers also use the screw terminal block for the power switch leads. On TeleMini v1.0, the power switch leads are soldered directly to the board and can be connected directly to a switch.

For most air-frames, the integrated antennas are more than adequate. However, if you are installing in a carbon-fiber or metal electronics bay which is opaque to RF signals, you may need to use off-board external antennas instead. In this case, you can replace the stock UHF antenna wire with an edge-launched SMA connector, and, on TeleMetrum v1, you can unplug the integrated GPS antenna and select an appropriate off-board GPS antenna with cable terminating in a U.FL connector.

Chapter 5. System Operation

1. Firmware Modes

The AltOS firmware build for the altimeters has two fundamental modes, “idle” and “flight”. Which of these modes the firmware operates in is determined at start up time. For TeleMetrum, TeleMega and EasyMega, which have accelerometers, the mode is controlled by the orientation of the rocket (well, actually the board, of course...) at the time power is switched on. If the rocket is “nose up”, then the flight computer assumes it's on a rail or rod being prepared for launch, so the firmware chooses flight mode. However, if the rocket is more or less horizontal, the firmware instead enters idle mode. Since TeleMini v2.0 and EasyMini don't have an accelerometer we can use to determine orientation, “idle” mode is selected if the board is connected via USB to a computer, otherwise the board enters “flight” mode. TeleMini v1.0 selects “idle” mode if it receives a command packet within the first five seconds of operation.

At power on, the altimeter will beep out the battery voltage to the nearest tenth of a volt. Each digit is represented by a sequence of short “dit” beeps, with a pause between digits. A zero digit is represented with one long “dah” beep. Then there will be a short pause while the altimeter completes initialization and self test, and decides which mode to enter next.

Here's a short summary of all of the modes and the beeping (or flashing, in the case of TeleMini v1) that accompanies each mode. In the description of the beeping pattern, “dit” means a short beep while "dah" means a long beep (three times as long). “Brap” means a long dissonant tone.

Table 5.1. AltOS Modes

Mode NameAbbreviationBeepsDescription
StartupSbattery voltage in decivolts

Calibrating sensors, detecting orientation.

IdleIdit dit

Ready to accept commands over USB or radio link.

PadPdit dah dah dit

Waiting for launch. Not listening for commands.

BoostBdah dit dit dit

Accelerating upwards.

FastFdit dit dah dit

Decelerating, but moving faster than 200m/s.

CoastCdah dit dah dit

Decelerating, moving slower than 200m/s

DrogueDdah dit dit

Descending after apogee. Above main height.

MainMdah dah

Descending. Below main height.

LandedLdit dah dit dit

Stable altitude for at least ten seconds.

Sensor errorXdah dit dit dah

Error detected during sensor calibration.


In flight or “pad” mode, the altimeter engages the flight state machine, goes into transmit-only mode to send telemetry, and waits for launch to be detected. Flight mode is indicated by an “di-dah-dah-dit” (“P” for pad) on the beeper or lights, followed by beeps or flashes indicating the state of the pyrotechnic igniter continuity. One beep/flash indicates apogee continuity, two beeps/flashes indicate main continuity, three beeps/flashes indicate both apogee and main continuity, and one longer “brap” sound which is made by rapidly alternating between two tones indicates no continuity. For a dual deploy flight, make sure you're getting three beeps or flashes before launching! For apogee-only or motor eject flights, do what makes sense.

If idle mode is entered, you will hear an audible “di-dit” or see two short flashes (“I” for idle), and the flight state machine is disengaged, thus no ejection charges will fire. The altimeters also listen for the radio link when in idle mode for requests sent via TeleDongle. Commands can be issued in idle mode over either USB or the radio link equivalently. TeleMini v1.0 only has the radio link. Idle mode is useful for configuring the altimeter, for extracting data from the on-board storage chip after flight, and for ground testing pyro charges.

In “Idle” and “Pad” modes, once the mode indication beeps/flashes and continuity indication has been sent, if there is no space available to log the flight in on-board memory, the flight computer will emit a warbling tone (much slower than the “no continuity tone”)

Here's a summary of all of the “pad” and “idle” mode indications.

Table 5.2. Pad/Idle Indications

NameBeepsDescription
Neitherbrap

No continuity detected on either apogee or main igniters.

Apogeedit

Continuity detected only on apogee igniter.

Maindit dit

Continuity detected only on main igniter.

Bothdit dit dit

Continuity detected on both igniters.

Storage Fullwarble

On-board data logging storage is full. This will not prevent the flight computer from safely controlling the flight or transmitting telemetry signals, but no record of the flight will be stored in on-board flash.


Once landed, the flight computer will signal that by emitting the “Landed” sound described above, after which it will beep out the apogee height (in meters). Each digit is represented by a sequence of short “dit” beeps, with a pause between digits. A zero digit is represented with one long “dah” beep. The flight computer will continue to report landed mode and beep out the maximum height until turned off.

One “neat trick” of particular value when TeleMetrum, TeleMega or EasyMega are used with very large air-frames, is that you can power the board up while the rocket is horizontal, such that it comes up in idle mode. Then you can raise the air-frame to launch position, and issue a 'reset' command via TeleDongle over the radio link to cause the altimeter to reboot and come up in flight mode. This is much safer than standing on the top step of a rickety step-ladder or hanging off the side of a launch tower with a screw-driver trying to turn on your avionics before installing igniters!

TeleMini v1.0 is configured solely via the radio link. Of course, that means you need to know the TeleMini radio configuration values or you won't be able to communicate with it. For situations when you don't have the radio configuration values, TeleMini v1.0 offers an 'emergency recovery' mode. In this mode, TeleMini is configured as follows:

  • Sets the radio frequency to 434.550MHz

  • Sets the radio calibration back to the factory value.

  • Sets the callsign to N0CALL

  • Does not go to 'pad' mode after five seconds.

To get into 'emergency recovery' mode, first find the row of four small holes opposite the switch wiring. Using a short piece of small gauge wire, connect the outer two holes together, then power TeleMini up. Once the red LED is lit, disconnect the wire and the board should signal that it's in 'idle' mode after the initial five second startup period.

2. GPS

TeleMetrum and TeleMega include a complete GPS receiver. A complete explanation of how GPS works is beyond the scope of this manual, but the bottom line is that the GPS receiver needs to lock onto at least four satellites to obtain a solid 3 dimensional position fix and know what time it is.

The flight computers provide backup power to the GPS chip any time a battery is connected. This allows the receiver to “warm start” on the launch rail much faster than if every power-on were a GPS “cold start”. In typical operations, powering up on the flight line in idle mode while performing final air-frame preparation will be sufficient to allow the GPS receiver to cold start and acquire lock. Then the board can be powered down during RSO review and installation on a launch rod or rail. When the board is turned back on, the GPS system should lock very quickly, typically long before igniter installation and return to the flight line are complete.

3. Controlling An Altimeter Over The Radio Link

One of the unique features of the Altus Metrum system is the ability to create a two way command link between TeleDongle and an altimeter using the digital radio transceivers built into each device. This allows you to interact with the altimeter from afar, as if it were directly connected to the computer.

Any operation which can be performed with a flight computer can either be done with the device directly connected to the computer via the USB cable, or through the radio link. TeleMini v1.0 doesn't provide a USB connector and so it is always communicated with over radio. Select the appropriate TeleDongle device when the list of devices is presented and AltosUI will interact with an altimeter over the radio link.

One oddity in the current interface is how AltosUI selects the frequency for radio communications. Instead of providing an interface to specifically configure the frequency, it uses whatever frequency was most recently selected for the target TeleDongle device in Monitor Flight mode. If you haven't ever used that mode with the TeleDongle in question, select the Monitor Flight button from the top level UI, and pick the appropriate TeleDongle device. Once the flight monitoring window is open, select the desired frequency and then close it down again. All radio communications will now use that frequency.

  • Save Flight Data—Recover flight data from the rocket without opening it up.

  • Configure altimeter apogee delays, main deploy heights and additional pyro event conditions to respond to changing launch conditions. You can also 'reboot' the altimeter. Use this to remotely enable the flight computer by turning TeleMetrum or TeleMega on in “idle” mode, then once the air-frame is oriented for launch, you can reboot the altimeter and have it restart in pad mode without having to climb the scary ladder.

  • Fire Igniters—Test your deployment charges without snaking wires out through holes in the air-frame. Simply assemble the rocket as if for flight with the apogee and main charges loaded, then remotely command the altimeter to fire the igniters.

Operation over the radio link for configuring an altimeter, ground testing igniters, and so forth uses the same RF frequencies as flight telemetry. To configure the desired TeleDongle frequency, select the monitor flight tab, then use the frequency selector and close the window before performing other desired radio operations.

The flight computers only enable radio commanding in 'idle' mode. TeleMetrum and TeleMega use the accelerometer to detect which orientation they start up in, so make sure you have the flight computer lying horizontally when you turn it on. Otherwise, it will start in 'pad' mode ready for flight, and will not be listening for command packets from TeleDongle.

TeleMini listens for a command packet for five seconds after first being turned on, if it doesn't hear anything, it enters 'pad' mode, ready for flight and will no longer listen for command packets. The easiest way to connect to TeleMini is to initiate the command and select the TeleDongle device. At this point, the TeleDongle will be attempting to communicate with the TeleMini. Now turn TeleMini on, and it should immediately start communicating with the TeleDongle and the desired operation can be performed.

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 transmitted, while the green LED will light up on TeleDongle when it is waiting to receive a packet from the altimeter.

4. Ground Testing

An important aspect of preparing a rocket using electronic deployment for flight is ground testing the recovery system. Thanks to the bi-directional radio link central to the Altus Metrum system, this can be accomplished in a TeleMega, TeleMetrum or TeleMini equipped rocket with less work than you may be accustomed to with other systems. It can even be fun!

Just prep the rocket for flight, then power up the altimeter in “idle” mode (placing air-frame horizontal for TeleMetrum or TeleMega, or selecting the Configure Altimeter tab for TeleMini). This will cause the firmware to go into “idle” mode, in which the normal flight state machine is disabled and charges will not fire without manual command. You can now command the altimeter to fire the apogee or main charges from a safe distance using your computer and TeleDongle and the Fire Igniter tab to complete ejection testing.

5. Radio Link

Our flight computers all incorporate an RF transceiver, but it's not a full duplex system... each end can only be transmitting or receiving at any given moment. So we had to decide how to manage the link.

By design, the altimeter firmware listens for the radio link when it's in “idle mode”, which allows us to use the radio link to configure the rocket, do things like ejection tests, and extract data after a flight without having to crack open the air-frame. However, when the board is in “flight mode”, the altimeter only transmits and doesn't listen at all. That's because we want to put ultimate priority on event detection and getting telemetry out of the rocket through the radio in case the rocket crashes and we aren't able to extract data later...

We don't generally use a 'normal packet radio' mode like APRS because they're just too inefficient. The GFSK modulation we use is FSK with the base-band pulses passed through a Gaussian filter before they go into the modulator to limit the transmitted bandwidth. When combined with forward error correction and interleaving, this allows us to have a very robust 19.2 kilobit data link with only 10-40 milliwatts of transmit power, a whip antenna in the rocket, and a hand-held Yagi on the ground. We've had flights to above 21k feet AGL with great reception, and calculations suggest we should be good to well over 40k feet AGL with a 5-element yagi on the ground with our 10mW units and over 100k feet AGL with the 40mW devices. We hope to fly boards to higher altitudes over time, and would of course appreciate customer feedback on performance in higher altitude flights!

6. APRS

TeleMetrum v2.0 and TeleMega can send APRS if desired, and the interval between APRS packets can be configured. As each APRS packet takes a full second to transmit, we recommend an interval of at least 5 seconds to avoid consuming too much battery power or radio channel bandwidth. You can configure the APRS interval using AltosUI; that process is described in the Configure Altimeter section of the AltosUI chapter.

AltOS uses the APRS compressed position report data format, which provides for higher position precision and shorter packets than the original APRS format. It also includes altitude data, which is invaluable when tracking rockets. We haven't found a receiver which doesn't handle compressed positions, but it's just possible that you have one, so if you have an older device that can receive the raw packets but isn't displaying position information, it's possible that this is the cause.

APRS packets include an SSID (Secondary Station Identifier) field that allows one operator to have multiple transmitters. AltOS allows you to set this to a single digit from 0 to 9, allowing you to fly multiple transmitters at the same time while keeping the identify of each one separate in the receiver. By default, the SSID is set to the last digit of the device serial number.

The APRS packet format includes a comment field that can have arbitrary text in it. AltOS uses this to send status information about the flight computer. It sends four fields as shown in the following table.

Table 5.3. Altus Metrum APRS Comments

FieldExampleDescription
1LGPS Status U for unlocked, L for locked
26Number of Satellites in View
3B4.0Altimeter Battery Voltage
4A3.7Apogee Igniter Voltage
5M3.7Main Igniter Voltage
61286Device Serial Number

Here's an example of an APRS comment showing GPS lock with 6 satellites in view, a primary battery at 4.0V, and apogee and main igniters both at 3.7V from device 1286.

	  L6 B4.0 A3.7 M3.7 1286
	

Make sure your primary battery is above 3.8V, any connected igniters are above 3.5V and GPS is locked with at least 5 or 6 satellites in view before flying. If GPS is switching between L and U regularly, then it doesn't have a good lock and you should wait until it becomes stable.

If the GPS receiver loses lock, the APRS data transmitted will contain the last position for which GPS lock was available. You can tell that this has happened by noticing that the GPS status character switches from 'L' to 'U'. Before GPS has locked, APRS will transmit zero for latitude, longitude and altitude.

7. Configurable Parameters

Configuring an Altus Metrum altimeter for flight is very simple. Even on our baro-only TeleMini and EasyMini boards, the use of a Kalman filter means there is no need to set a “mach delay”. The few configurable parameters can all be set using AltosUI over USB or or radio link via TeleDongle. Read the Configure Altimeter section in the AltosUI chapter below for more information.

7.1. Radio Frequency

Altus Metrum boards support radio frequencies in the 70cm band. By default, the configuration interface provides a list of 10 “standard” frequencies in 100kHz channels starting at 434.550MHz. However, the firmware supports use of any 50kHz multiple within the 70cm band. At any given launch, we highly recommend coordinating when and by whom each frequency will be used to avoid interference. And of course, both altimeter and TeleDongle must be configured to the same frequency to successfully communicate with each other.

7.2. Callsign

This sets the callsign used for telemetry, APRS and the packet link. For telemetry and APRS, this is used to identify the device. For the packet link, the callsign must match that configured in AltosUI or the link will not work. This is to prevent accidental configuration of another Altus Metrum flight computer operating on the same frequency nearby.

7.3. Telemetry/RDF/APRS Enable

You can completely disable the radio while in flight, if necessary. This doesn't disable the packet link in idle mode.

7.4. Telemetry baud rate

This sets the modulation bit rate for data transmission for both telemetry and packet link mode. Lower bit rates will increase range while reducing the amount of data that can be sent and increasing battery consumption. All telemetry is done using a rate 1/2 constraint 4 convolution code, so the actual data transmission rate is 1/2 of the modulation bit rate specified here.

7.5. APRS Interval

This selects how often APRS packets are transmitted. Set this to zero to disable APRS without also disabling the regular telemetry and RDF transmissions. As APRS takes a full second to transmit a single position report, we recommend sending packets no more than once every 5 seconds.

7.6. APRS SSID

This selects the SSID reported in APRS packets. By default, it is set to the last digit of the serial number, but you can change this to any value from 0 to 9.

7.7. Apogee Delay

Apogee delay is the number of seconds after the altimeter detects flight apogee that the drogue charge should be fired. In most cases, this should be left at the default of 0. However, if you are flying redundant electronics such as for an L3 certification, you may wish to set one of your altimeters to a positive delay so that both primary and backup pyrotechnic charges do not fire simultaneously.

The Altus Metrum apogee detection algorithm fires exactly at apogee. If you are also flying an altimeter like the PerfectFlite MAWD, which only supports selecting 0 or 1 seconds of apogee delay, you may wish to set the MAWD to 0 seconds delay and set the TeleMetrum to fire your backup 2 or 3 seconds later to avoid any chance of both charges firing simultaneously. We've flown several air-frames this way quite happily, including Keith's successful L3 cert.

7.8. Apogee Lockout

Apogee lockout is the number of seconds after boost where the flight computer will not fire the apogee charge, even if the rocket appears to be at apogee. This is often called 'Mach Delay', as it is intended to prevent a flight computer from unintentionally firing apogee charges due to the pressure spike that occurrs across a mach transition. Altus Metrum flight computers include a Kalman filter which is not fooled by this sharp pressure increase, and so this setting should be left at the default value of zero to disable it.

7.9. Main Deployment Altitude

By default, the altimeter will fire the main deployment charge at an elevation of 250 meters (about 820 feet) above ground. We think this is a good elevation for most air-frames, but feel free to change this to suit. In particular, if you are flying two altimeters, you may wish to set the deployment elevation for the backup altimeter to be something lower than the primary so that both pyrotechnic charges don't fire simultaneously.

7.10. Maximum Flight Log

Changing this value will set the maximum amount of flight log storage that an individual flight will use. The available storage is divided into as many flights of the specified size as can fit in the available space. You can download and erase individual flight logs. If you fill up the available storage, future flights will not get logged until you erase some of the stored ones.

Even though our flight computers (except TeleMini v1.0) can store multiple flights, we strongly recommend downloading and saving flight data after each flight.

7.11. 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 Bdale designed that had two altimeters, 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.

7.12. Pad Orientation

TeleMetrum, TeleMega and EasyMega measure 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, the altimeter must be explicitly configured for either Antenna Up or Antenna Down. The default, Antenna Up, expects the end of the board connected to the 70cm antenna to be nearest the nose of the rocket, with the end containing the screw terminals nearest the tail.

7.13. Configurable Pyro Channels

In addition to the usual Apogee and Main pyro channels, TeleMega and EasyMega have four additional channels that can be configured to activate when various flight conditions are satisfied. You can select as many conditions as necessary; all of them must be met in order to activate the channel. The conditions available are:

  • Acceleration away from the ground. Select a value, and then choose whether acceleration should be above or below that value. Acceleration is positive upwards, so accelerating towards the ground would produce negative numbers. Acceleration during descent is noisy and inaccurate, so be careful when using it during these phases of the flight.

  • Vertical speed. Select a value, and then choose whether vertical speed should be above or below that value. Speed is positive upwards, so moving towards the ground would produce negative numbers. Speed during descent is a bit noisy and so be careful when using it during these phases of the flight.

  • Height. Select a value, and then choose whether the height above the launch pad should be above or below that value.

  • Orientation. TeleMega and EasyMega contain a 3-axis gyroscope and accelerometer which is used to measure the current angle. Note that this angle is not the change in angle from the launch pad, but rather absolute relative to gravity; the 3-axis accelerometer is used to compute the angle of the rocket on the launch pad and initialize the system. Because this value is computed by integrating rate gyros, it gets progressively less accurate as the flight goes on. It should have an accumulated error of less than 0.2°/second (after 10 seconds of flight, the error should be less than 2°).

    The usual use of the orientation configuration is to ensure that the rocket is traveling mostly upwards when deciding whether to ignite air starts or additional stages. For that, choose a reasonable maximum angle (like 20°) and set the motor igniter to require an angle of less than that value.

  • Flight Time. Time since boost was detected. Select a value and choose whether to activate the pyro channel before or after that amount of time.

  • Ascending. A simple test saying whether the rocket is going up or not. This is exactly equivalent to testing whether the speed is > 0.

  • Descending. A simple test saying whether the rocket is going down or not. This is exactly equivalent to testing whether the speed is < 0.

  • After Motor. The flight software counts each time the rocket starts accelerating (presumably due to a motor or motors igniting). Use this value to count ignitions for multi-staged or multi-airstart launches.

  • Delay. This value doesn't perform any checks, instead it inserts a delay between the time when the other parameters become true and when the pyro channel is activated.

  • Flight State. The flight software tracks the flight through a sequence of states:

    1. Boost. The motor has lit and the rocket is accelerating upwards.

    2. Fast. The motor has burned out and the rocket is decelerating, but it is going faster than 200m/s.

    3. Coast. The rocket is still moving upwards and decelerating, but the speed is less than 200m/s.

    4. Drogue. The rocket has reached apogee and is heading back down, but is above the configured Main altitude.

    5. Main. The rocket is still descending, and is below the Main altitude

    6. Landed. The rocket is no longer moving.

    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 or some later state.

    When a motor burns out, the rocket enters either Fast or Coast state (depending on how fast it is moving). If the computer detects upwards acceleration again, it will move back to Boost state.

Chapter 6. AltosUI

The AltosUI program provides a graphical user interface for interacting with the Altus Metrum product family. AltosUI can monitor telemetry data, configure devices and many other tasks. The primary interface window provides a selection of buttons, one for each major activity in the system. This chapter is split into sections, each of which documents one of the tasks provided from the top-level toolbar.

1. Monitor Flight

Receive, Record and Display Telemetry Data

Selecting this item brings up a dialog box listing all of the connected TeleDongle devices. When you choose one of these, AltosUI will create a window to display telemetry data as received by the selected TeleDongle device.

All telemetry data received are automatically recorded in suitable log files. The name of the files includes the current date and rocket serial and flight numbers.

The radio frequency being monitored by the TeleDongle device is displayed at the top of the window. You can configure the frequency by clicking on the frequency box and selecting the desired frequency. AltosUI remembers the last frequency selected for each TeleDongle and selects that automatically the next time you use that device.

Below the TeleDongle frequency selector, the window contains a few significant pieces of information about the altimeter providing the telemetry data stream:

  • The configured call-sign

  • The device serial number

  • The flight number. Each altimeter remembers how many times it has flown.

  • The rocket flight state. Each flight passes through several states including Pad, Boost, Fast, Coast, Drogue, Main and Landed.

  • The Received Signal Strength Indicator value. This lets you know how strong a signal TeleDongle is receiving. The radio inside TeleDongle operates down to about -99dBm; weaker signals may not be receivable. The packet link uses error detection and correction techniques which prevent 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 tabs, each of which contain some information about the rocket. They're arranged in 'flight order' so that as the flight progresses, the selected tab automatically switches to display data relevant to the current state of the flight. You can select other tabs at any time. The final 'table' tab displays all of the raw telemetry values in one place in a spreadsheet-like format.

1.1. Launch Pad

The 'Launch Pad' tab shows information used to decide when the 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:

Battery Voltage

This indicates whether the Li-Po battery powering the flight computer has sufficient charge to last for the duration of the flight. A value of more than 3.8V is required for a 'GO' status.

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.

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.

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. Most of our flight computers can store multiple flights, depending on the configured maximum flight log size. TeleMini v1.0 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 even if the flight data storage is full.

GPS Locked

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.

GPS Ready

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.

The Launchpad tab also shows the computed launch pad position and altitude, averaging many reported positions to improve the accuracy of the fix.

1.2. Ascent

This tab is shown during Boost, Fast and Coast phases. The information displayed here helps monitor the rocket as it heads towards apogee.

The height, speed, acceleration and tilt are shown along with the maximum values for each of them. This allows you to quickly answer the most commonly asked questions you'll hear during flight.

The current latitude and longitude reported by the GPS are also shown. Note that under high acceleration, these values may not get updated as the GPS receiver loses position fix. Once the rocket starts coasting, the receiver should start reporting position again.

Finally, the current igniter voltages are reported as in the Launch Pad tab. This can help diagnose deployment failures caused by wiring which comes loose under high acceleration.

1.3. Descent

Once the rocket has reached apogee and (we hope) activated the apogee charge, attention switches to tracking the rocket on the way back to the ground, and for dual-deploy flights, waiting for the main charge to fire.

To monitor whether the apogee charge operated correctly, the current descent rate is reported along with the current height. Good descent rates vary based on the choice of recovery components, but generally range from 15-30m/s on drogue and should be below 10m/s when under the main parachute in a dual-deploy flight.

With GPS-equipped flight computers, 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 well, both to monitor the main charge as well as to see what the status of the apogee charge is. Note that some commercial e-matches are designed to retain continuity even after being fired, and will continue to show as green or return from red to green after firing.

1.4. Landed

Once the rocket is on the ground, attention switches to recovery. While the radio signal is often lost once the rocket is on the ground, the last reported GPS position is generally within a short distance of the actual landing location.

The last reported GPS position is reported both by latitude and longitude as well as a bearing and distance from the launch pad. The distance should give you a good idea of whether to walk or hitch a ride. Take the reported latitude and longitude and enter them into your hand-held GPS unit and have that compute a track to the landing location.

Our flight computers will continue to transmit RDF tones after landing, allowing you to locate the rocket by following the radio signal if necessary. You may need to get away from the clutter of the flight line, or even get up on a hill (or your neighbor's RV roof) to receive the RDF signal.

The maximum height, speed and acceleration reported during the flight are displayed for your admiring observers. The accuracy of these immediate values depends on the quality of your radio link and how many packets were received. Recovering the on-board data after flight may yield more precise results.

To get more detailed information about the flight, you can click on the 'Graph Flight' button which will bring up a graph window for the current flight.

1.5. Table

The table view shows all of the data available from the flight computer. Probably the most useful data on this tab is the detailed GPS information, which includes horizontal dilution of precision information, and information about the signal being received from the satellites.

1.6. Site Map

When the TeleMetrum has a GPS fix, the Site Map tab will map the rocket's position to make it easier for you to locate the rocket, both while it is in the air, and when it has landed. The rocket's state is indicated by color: white for pad, red for boost, pink for fast, yellow for coast, light blue for drogue, dark blue for main, and black for landed.

The map's default scale is approximately 3m (10ft) per pixel. The map can be dragged using the left mouse button. The map will attempt to keep the rocket roughly centered while data is being received.

You can adjust the style of map and the zoom level with buttons on the right side of the map window. You can draw a line on the map by moving the mouse over the map with a button other than the left one pressed, or by pressing the left button while also holding down the shift key. The length of the line in real-world units will be shown at the start of the line.

Images are fetched automatically via the Google Maps Static API, and cached on disk for reuse. If map images cannot be downloaded, the rocket's path will