From 6409eee47a07294ec1a763f0a66d92ba47030b09 Mon Sep 17 00:00:00 2001 From: Bdale Garbee Date: Sun, 10 Jan 2016 20:45:25 -0700 Subject: update docs --- AltOS/doc/easymini.html | 670 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 670 insertions(+) create mode 100644 AltOS/doc/easymini.html (limited to 'AltOS/doc/easymini.html') diff --git a/AltOS/doc/easymini.html b/AltOS/doc/easymini.html new file mode 100644 index 0000000..10cbdf2 --- /dev/null +++ b/AltOS/doc/easymini.html @@ -0,0 +1,670 @@ + +EasyMini Owner’s Manual

EasyMini Owner’s Manual

A Dual-Deploy Rocketry Flight Computer

+ +

Bdale Garbee

Keith Packard

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

Revision History

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
2.1. Batteries
2.2. Linux/Mac/Windows Ground Station Software
3. Using Altus Metrum Hardware
3.1. Wiring and Electrical Interference
3.2. Hooking Up Lithium Polymer Batteries
3.3. Hooking Up Pyro Charges
3.4. Hooking Up a Power Switch
3.5. Understanding Beeps
3.6. Turning On the Power
3.7. Using an External Active Switch Circuit
3.8. Using a Separate Pyro Battery
3.9. Using a Different Kind of Battery
4. EasyMini
4.1. EasyMini Screw Terminals
4.2. Connecting A Battery To EasyMini
4.3. Charging Lithium Batteries
4.4. Using a Separate Pyro Battery with EasyMini
4.5. Using an Active Switch with EasyMini
5. Installation
6. Using Altus Metrum Products
6.1. In the Rocket
6.2. On the Ground
6.3. Data Analysis
6.4. Future Plans
7. AltosUI
7.1. Save Flight Data
7.2. Replay Flight
7.3. Graph Data
7.3.1. Flight Graph
7.3.2. Configure Graph
7.3.3. Flight Statistics
7.4. Export Data
7.4.1. Comma Separated Value Format
7.5. Configure Altimeter
7.5.1. Main Deploy Altitude
7.5.2. Apogee Delay
7.5.3. Apogee Lockout
7.5.4. Maximum Flight Log Size
7.5.5. Ignitor Firing Mode
7.5.6. Beeper Frequency
7.6. Configure AltosUI
7.6.1. Log Directory
7.6.2. Imperial Units
7.6.3. Serial Debug
7.6.4. Font size
7.6.5. Look & feel
7.6.6. Menu position
7.7. Flash Image
7.8. Fire Igniter
A. System Operation
A.1. Firmware Modes
A.2. Ground Testing
A.3. Configurable Parameters
B. Handling Precautions
C. Updating Device Firmware
C.1. Updating EasyMini Firmware
C.1.1. Recovering From Self-Flashing Failure
D. Flight Data Recording
E. Altus Metrum Hardware Specifications
F. Release Notes
F.1. Release Notes for Version 1.6.2
F.1.1. AltOS
F.1.2. AltosUI and TeleGPS Applications
F.1.3. Documentation

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 v0.2 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. The latest version, TeleDongle +v3, has all new electronics with a higher performance radio +for improved range.

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 open the box is to hook up a +battery and charge it if necessary.

2.1. Batteries

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

You can also choose to use another battery with +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.

2.2. Linux/Mac/Windows Ground Station Software

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, Mac OSX. Full +source code and build instructions are also +available. The latest version may always be downloaded +from http://altusmetrum.org/AltOS

Chapter 3. Using Altus Metrum Hardware

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.

3.1. Wiring and Electrical Interference

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.

3.2. 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

Warning

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.

3.3. 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.

3.4. 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.

3.5. Understanding Beeps

Altus Metrum flight computers include a beeper to +provide information about the state of the system.

Here’s a short summary of all of the modes and the +beeping +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 3.1. AltOS Modes

Mode Name

Abbreviation

Beeps

Description

Startup

S

battery voltage in decivolts

Calibrating sensors, detecting orientation.

Idle

I

dit dit

Ready to accept commands over USB

Pad

P

dit dah dah dit

Waiting for launch. Not listening for commands.

Boost

B

dah dit dit dit

Accelerating upwards.

Fast

F

dit dit dah dit

Decelerating, but moving faster than 200m/s.

Coast

C

dah dit dah dit

Decelerating, moving slower than 200m/s

Drogue

D

dah dit dit

Descending after apogee. Above main height.

Main

M

dah dah

Descending. Below main height.

Landed

L

dit dah dit dit

Stable altitude for at least ten seconds.

Sensor error

X

dah dit dit dah

Error detected during sensor calibration.


Here’s a summary of all of the Pad and Idle mode +indications. In Idle mode, you’ll hear one of these +just once after the two short dits indicating idle +mode. In Pad mode, after the dit dah dah dit +indicating Pad mode, you’ll hear these once every five +seconds.

Table 3.2. Pad/Idle Indications

Name Beeps Description

Neither

brap

No continuity detected on either apogee or main igniters.

Apogee

dit

Continuity detected only on apogee igniter.

Main

dit dit

Continuity detected only on main igniter.

Both

dit dit dit

Continuity detected on both igniters.

Storage Full

warble

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.


3.6. Turning On the Power

Connect a battery and power switch and turn the switch +to "on". The flight computer will signal power on by +reporting the battery voltage and then perform an internal self +test and sensor calibration.

Once the self test and calibration are complete, there +are two modes that an Altus Metrum flight computer can +operate in:

+Flight/Pad +
+The flight computer is waiting to detect +launch and then fly the rocket. In this mode, the USB +link is +disabled. +The only way to get out of this +mode is to power the flight computer down. +
+Idle +
+The flight computer is ready to communicate over USB +You can configure +the flight computer, download data or display +the current state. +

For EasyMini, if the USB cable is connected to a +computer, it will enter Idle mode. Otherwise, it will +enter Flight/Pad mode.

You can see in Section 3.5, “Understanding Beeps” +how to tell which mode the flight computer is in.

3.7. 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. Then follow +the instructions that come with your active switch to +connect it up.

3.8. Using a Separate Pyro Battery

As mentioned above in Section 3.3, “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 for each flight computer will be found +in the section below for that flight computer.

3.9. Using a Different Kind of Battery

EasyMini +is +designed to use either a +lithium polymer battery or any other battery producing +between 4 and 12 volts, such as a rectangular 9V +battery.

Chapter 4. EasyMini

Figure 4.1. EasyMini Board

easymini-top.jpg

EasyMini is built on a 0.8 inch by 1½ inch circuit board. It’s +designed to fit in a 24mm coupler tube.

You usually don’t need to configure EasyMini at all; it’s set +up to do dual-deployment with an event at apogee to separate +the airframe and deploy a drogue and another event at 250m +(820ft) to deploy the main. Install EasyMini in your airframe, +hook up a battery, igniters and a power switch and you’re +ready to fly.

4.1. EasyMini Screw Terminals

EasyMini has two sets of four screw terminals near one end of the +board. 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.1. EasyMini Screw Terminals

Terminal #Terminal NameDescription

Top 1

Main -

Main pyro channel connection to pyro circuit

Top 2

Main

Main pyro channel common connection to battery

Top 3

Battery

Positive external battery terminal

Top 4

Battery -

Negative external battery terminal

Bottom 1

Apogee -

Apogee pyro channel connection to pyro circuit

Bottom 2

Apogee

Apogee pyro channel common connection to battery

Bottom 3

Switch Output

Switch connection to flight computer

Bottom 4

Switch Input

Switch connection to positive battery terminal


4.2. Connecting A Battery To EasyMini

There are two possible battery connections on +EasyMini. You can use either method; both feed +through the power switch terminals.

One battery connection is the standard Altus Metrum +white JST plug. This mates with single-cell Lithium +Polymer batteries sold by Altus Metrum.

The other is a pair of screw terminals marked Battery ++ and Battery -. Connect a battery from 4 to 12 +volts to these terminals, being careful to match polarity.

4.3. Charging Lithium Batteries

Because EasyMini allows for batteries other than the +standard Altus Metrum Lithium Polymer cells, it cannot +incorporate a battery charger circuit. Therefore, when +using a Litium Polymer cell, you’ll need an external +charger. These are available from Altus Metrum, or +from Spark Fun.

4.4. 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 EasyMini +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).

4.5. 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.

Chapter 5. 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. +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; you +can purchase suitable batteries from the any vendor selling +Altus Metrum products. 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.

Warning

Check polarity and voltage before connecting any battery not +purchased from Altus Metrum.

Warning

Spark Fun sells batteries that have a matching connector with +the correct polarity. However, these batteries include an +integrated current limiting circuit. That circuit will cause +the battery to shut down when firing the igniter circuit. Do +not use these batteries unless you remove the current limiting +circuit.

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 +Section 3.8, “Using a Separate Pyro Battery” 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. +The screw terminal block is also used for the power switch leads.

Chapter 6. Using Altus Metrum Products

6.1. In the Rocket

In the rocket itself, you just need a flight computer +and a single-cell, 3.7 volt nominal Li-Po rechargeable +battery. +A 110mAh battery weighs less +than a triple A battery and is a good choice for use +with +EasyMini.

6.2. On the Ground

The GUI tool, AltosUI, is written in Java and runs +across Linux, Mac OS and Windows. There’s also a suite +of C tools for Linux which can perform most of the +same tasks.

After the flight, +you can use a +USB cable to plug into the flight computer board directly. +A USB cable is also how you +charge the Li-Po battery, so you’ll want one of those +anyway. The same cable used by lots of digital +cameras and other modern electronic stuff will work +fine.

6.3. Data Analysis

Our software makes it easy to log the data from each +flight, both the telemetry received during the flight +itself, and the more complete data log recorded in the +flash memory on the altimeter board. Once this data +is on your computer, our post-flight tools make it +easy to quickly get to the numbers everyone wants, +like apogee altitude, max acceleration, and max +velocity. You can also generate and view a standard +set of plots showing the altitude, acceleration, and +velocity of the rocket during flight. And you can +even export a flight log in a format usable with Google +Maps and Google Earth for visualizing the flight path +in two or three dimensions!

Our ultimate goal is to emit a set of files for each +flight that can be published as a web page per flight, +or just viewed on your local disk with a web browser.

6.4. Future Plans

Because all of our work is open, both the hardware +designs and the software, if you have some great idea +for an addition to the current Altus Metrum family, +feel free to dive in and help! Or let us know what +you’d like to see that we aren’t already working on, +and maybe we’ll get excited about it too…

Watch our web site for +more news and information as our family of products +evolves!

Chapter 7. AltosUI

Figure 7.1. AltosUI Main Window

altosui.png

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.

7.1. Save Flight Data

The altimeter records flight data to its internal +flash memory. +The Save Flight Data button allows you to +read the flash memory and write it to disk.

Clicking on the Save Flight Data button brings up a +list of connected flight computers and TeleDongle +devices. If you select a flight computer, the flight +data will be downloaded from that device directly.

After the device has been selected, a dialog showing +the flight data saved in the device will be shown +allowing you to select which flights to download and +which to delete. With version 0.9 or newer firmware, +you must erase flights in order for the space they +consume to be reused by another flight. This prevents +accidentally losing flight data if you neglect to +download data before flying again. Note that if there +is no more space available in the device, then no data +will be recorded during the next flight.

The file name for each flight log is computed +automatically from the recorded flight date, altimeter +serial number and flight number information.

7.2. Replay Flight

Select this button and you are prompted to select a flight +record file, either a .telem file recording telemetry data or a +.eeprom file containing flight data saved from the altimeter +flash memory.

Once a flight record is selected, the flight monitor interface +is displayed and the flight is re-enacted in real +time.

7.3. Graph Data

Select this button and you are prompted to select a flight +record file, either a .telem file recording telemetry data or a +.eeprom file containing flight data saved from +flash memory.

Note that telemetry files will generally produce poor graphs +due to the lower sampling rate and missed telemetry packets. +Use saved flight data in .eeprom files for graphing where possible.

Once a flight record is selected, a window with multiple tabs is +opened.

7.3.1. Flight Graph

Figure 7.2. Flight Data Graph

graph.png

By default, the graph contains acceleration (blue), +velocity (green) and altitude (red).

The graph can be zoomed into a particular area by +clicking and dragging down and to the right. Once +zoomed, the graph can be reset by clicking and +dragging up and to the left. Holding down control and +clicking and dragging allows the graph to be panned. +The right mouse button causes a pop-up menu to be +displayed, giving you the option save or print the +plot.

7.3.2. Configure Graph

Figure 7.3. Flight Graph Configuration

graph-configure.png

This selects which graph elements to show, and, at the +very bottom, lets you switch between metric and +imperial units

7.3.3. Flight Statistics

Figure 7.4. Flight Statistics

graph-stats.png

Shows overall data computed from the flight.

7.4. Export Data

This tool takes the raw data files and makes them +available for external analysis. When you select this +button, you are prompted to select a flight data file, +which can be either a .eeprom or .telem. The .eeprom +files contain higher resolution and more continuous +data, while .telem files contain receiver signal +strength information. Next, a second dialog appears +which is used to select where to write the resulting +file.

7.4.1. Comma Separated Value Format

This is a text file containing the data in a form +suitable for import into a spreadsheet or other +external data analysis tool. The first few lines of +the file contain the version and configuration +information from the altimeter, then there is a single +header line which labels all of the fields. All of +these lines start with a # character which many +tools can be configured to skip over.

The remaining lines of the file contain the data, with +each field separated by a comma and at least one +space. All of the sensor values are converted to +standard units, with the barometric data reported in +both pressure, altitude and height above pad units.

7.5. Configure Altimeter

Figure 7.5. Altimeter Configuration

configure-altimeter.png

Select this button and then select an altimeter.

The first few lines of the dialog provide information about the +connected device, including the product name, +software version and hardware serial number. Below that are the +individual configuration entries.

At the bottom of the dialog, there are four buttons:

+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. +
+Reset +
+This resets the dialog to the most recently saved +values, erasing any changes you have made. +
+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. +
+Close +
+This closes the dialog. Any unsaved changes will be +lost. +

The rest of the dialog contains the parameters to be configured.

7.5.1. Main Deploy Altitude

This sets the altitude (above the recorded pad +altitude) at which the main igniter will fire. The +drop-down menu shows some common values, but you can +edit the text directly and choose whatever you +like. If the apogee charge fires below this altitude, +then the main charge will fire two seconds after the +apogee charge fires.

7.5.2. Apogee Delay

When flying redundant electronics, it’s often +important to ensure that multiple apogee charges don’t +fire at precisely the same time, as that can over +pressurize the apogee deployment bay and cause a +structural failure of the air-frame. The Apogee Delay +parameter tells the flight computer to fire the apogee +charge a certain number of seconds after apogee has +been detected.

7.5.3. 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.5.4. Maximum Flight Log Size

This sets the space (in kilobytes) allocated +for each flight log. The available space will +be divided into chunks of this size. A smaller +value will allow more flights to be stored, a +larger value will record data from longer +flights.

7.5.5. Ignitor Firing Mode

This configuration parameter allows the two standard ignitor +channels (Apogee and Main) to be used in different +configurations.

+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. +
+Redundant Apogee +
+This fires both channels at apogee, the +apogee channel first followed after a two +second delay by the main channel. +
+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. +

7.5.6. Beeper Frequency

The beeper on all Altus Metrum flight +computers works best at 4000Hz, however if you +have more than one flight computer in a single +airframe, having all of them sound at the same +frequency can be confusing. This parameter +lets you adjust the base beeper frequency +value.

7.6. Configure AltosUI

Figure 7.6. Configure AltosUI Dialog

configure-altosui.png

This button presents a dialog so that you can +configure the AltosUI global settings.

7.6.1. Log Directory

AltosUI logs all telemetry data and saves all +flash data to this directory. This +directory is also used as the staring point +when selecting data files for display or +export.

Click on the directory name to bring up a +directory choosing dialog, select a new +directory and click Select Directory to +change where AltosUI reads and writes data +files.

7.6.2. Imperial Units

This switches between metric units (meters) +and imperial units (feet and miles). This +affects the display of values 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.

7.6.3. Serial Debug

This causes all communication with a connected +device to be dumped to the console from which +AltosUI was started. If you’ve started it from +an icon or menu entry, the output will simply +be discarded. This mode can be useful to debug +various serial communication issues.

7.6.4. Font size

Selects the set of fonts used in the flight +monitor window. Choose between the small, +medium and large sets.

7.6.5. Look & feel

Switches between the available Java user +interface appearances. The default selection +is supposed to match the native window system +appearance for the target platform.

7.6.6. Menu position

Selects the initial position for the main +AltosUI window that includes all of the +command buttons.

7.7. Flash Image

This reprograms Altus Metrum devices with new +firmware. +EasyMini is +programmed directly +over USB (self programming). Please read +the directions for flashing devices in +Appendix C, Updating Device Firmware.

7.8. Fire Igniter

Figure 7.7. Fire Igniter Window

fire-igniter.png

This activates the igniter circuits in the flight +computer to help test recovery systems +deployment.

Selecting the Fire Igniter button brings up the +usual device selection dialog. Pick the desired +device. This brings up another window which shows the +current continuity test status for all of the pyro +channels.

Next, select the desired igniter to fire. This will +enable the Arm button.

Select the Arm button. This enables the Fire +button. The word Arm is replaced by a countdown +timer indicating that you have 10 seconds to press the +Fire button or the system will deactivate, at which +point you start over again at selecting the desired +igniter.

Appendix A. System Operation

A.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. +Since +EasyMini doesn’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.

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.

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. +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”)

See Section 3.5, “Understanding Beeps” for a summary of all of +the audio signals used.

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.

A.2. Ground Testing

An important aspect of preparing a rocket using electronic deployment +for flight is ground testing the recovery system.

Just prep the rocket for flight, then power up the altimeter +in “idle” +mode. +You can now command the altimeter to fire the apogee +or main charges from a safe distance using your +computer and the Fire Igniter tab to complete ejection testing.

A.3. 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”. All of the +configurable parameters can be set using AltosUI. Read +Section 7.5, “Configure Altimeter” for more information.

Appendix B. 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.

Warning

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.

Appendix C. Updating Device Firmware

EasyMini is +programmed directly over their USB connectors (self +programming).

You may wish to begin by ensuring you have current firmware +images. These are distributed as part of the AltOS software +bundle that also includes the AltosUI ground station program. +Newer ground station versions typically work fine with older +firmware versions, so you don’t need to update your devices +just to try out new software features. You can always +download the most recent version from +http://www.altusmetrum.org/AltOS/

C.1. Updating EasyMini Firmware

Self-programmable devices are reprogrammed by +connecting them to your computer over USB.

  1. +Attach a battery if necessary and power switch to +the target device. Power up the device. +
  2. +Using a Micro USB cable, connect the target device to your +computer’s USB socket. +
  3. +Run AltosUI, and select Flash Image from the File menu. +
  4. +Select the target device in the Device Selection dialog. +
  5. +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 EasyMini-v1.0-1.6.0.ihx. +
  6. +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. +
  7. +Hit the OK button and the software should proceed +to flash the device with new firmware, showing a +progress bar. +
  8. +Verify that the device is working by using the +Configure Altimeter or Configure Groundstation +item to check over the configuration. +

C.1.1. Recovering From Self-Flashing Failure

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.

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.

+EasyMini +
+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. +

Once you’ve located the right pins:

  1. +Turn the altimeter power off. +
  2. +Connect a battery. +
  3. +Connect the indicated terminals together with a +short piece of wire. Take care not to accidentally +connect anything else. +
  4. +Connect USB +
  5. +Turn the board power on. +

The board should now be visible over USB as +AltosFlash and be ready to receive firmware. Once +the board has been powered up, you can remove the +piece of wire.

Appendix D. Flight Data Recording

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

Table D.1. Data Storage on Altus Metrum altimeters

Device Bytes per Sample Total Storage Minutes at Full Rate

EasyMini

16

1MB

10


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 +EasyMini. +This consumes 64kB +of flash space. This configuration space is not available +for storing flight log data.

To compute the amount of space needed for a single flight, you +can multiply the expected ascent time (in seconds) by 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.

The default size allows for several flights on each flight +computer. +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.

Appendix E. Altus Metrum Hardware Specifications

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

Table E.1. Altus Metrum Flight Computer Electronics

Device Barometer Z-axis accel GPS 3D sensors Storage RF Output Battery

EasyMini v1.0

MS5607 30km (100k')

-

-

-

1MB

-

3.7-12V


Table E.2. Altus Metrum Flight Computer Mechanical Components

DeviceConnectorsScrew TerminalsWidthLengthTube Size

EasyMini

Debug USB Battery

Apogee pyro Main pyro Battery

0.8 inch (2.03cm)

1½ inch (3.81cm)

24mm coupler


Appendix F. Release Notes

F.1. Release Notes for Version 1.6.2

Version 1.6.2 includes support for our updated TeleMega v2.0 +product and bug fixes in in the flight software for all our boards +and ground station interfaces.

F.1.1. AltOS

AltOS New Features:

  • +Add support for TeleMega v2.0 boards. +
  • +Add PWM servo driver. There’s no higher level code using +this yet, but the driver allows testing of the TeleMega v2.0 +servo output connector. +

AltOS Fixes:

  • +Slow down telemetry packets to allow receiver to keep +up. +

F.1.2. AltosUI and TeleGPS Applications

AltosUI and TeleGPS Fixes:

  • +Fix post-flight orientation computation when processing +TeleMega and EasyMega eeprom data files. +
  • +Capture complete eeprom data even when there are invalid +entries in the data. This keeps reading eeprom contents and +writing the associated .eeprom file when an error is detected. +

F.1.3. Documentation

We spent a bunch of time trying to improve our documentation

  • +HTML versions now have a table of contents on the left side. +
  • +EasyMini now has its own shorter manual. +
  • +Provide links between sections in each document. +
  • +Lots of minor rewriting and restructuring to avoid +duplication of information +
\ No newline at end of file -- cgit v1.2.3