From: Bdale Garbee Date: Wed, 28 Aug 2013 21:19:15 +0000 (-0600) Subject: TeleMini sn re-assigned from 92 to 96 to resolve conflict. X-Git-Url: https://git.gag.com/?a=commitdiff_plain;h=77f6661cd893dadf422376a7302be97105f4a9a8;hp=9bf704fa540dcd377503847f00bec1b3db26bbb6;p=web%2Faltusmetrum TeleMini sn re-assigned from 92 to 96 to resolve conflict. Merge branch 'master' of ssh://git.gag.com/scm/git/web/altusmetrum Conflicts: production.mdwn --- diff --git a/AltOS/doc/altusmetrum.html b/AltOS/doc/altusmetrum.html index 745a398..657633c 100644 --- a/AltOS/doc/altusmetrum.html +++ b/AltOS/doc/altusmetrum.html @@ -1,10 +1,17 @@ -The Altus Metrum System

The Altus Metrum System

An Owner's Manual for TeleMetrum, TeleMini and TeleDongle Devices

Bdale Garbee

Keith Packard

Bob Finch

Anthony Towns

+The Altus Metrum System

The Altus Metrum System

An Owner's Manual for TeleMetrum, TeleMini, TeleDongle and TeleBT Devices

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.1.116 September 2012
+

Revision History
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
@@ -19,7 +26,7 @@ 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

Acknowledgements

+
Revision 0.824 November 2010
Updated for software version 0.8

Acknowledgements

Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing "The Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter @@ -46,7 +53,7 @@ Keith NAR #88757, TRA #12200
      

-

Table of Contents

1. Introduction and Overview
2. Getting Started
3. Handling Precautions
4. Hardware Overview
5. System Operation
1. Firmware Modes
2. GPS
3. Controlling An Altimeter Over The Radio Link
4. Ground Testing
5. Radio Link
6. Configurable Parameters
6.1. Radio Frequency
6.2. Apogee Delay
6.3. Main Deployment Altitude
6.4. Maximum Flight Log
6.5. Ignite Mode
6.6. Pad Orientation
6. AltosUI
1. Monitor Flight
1.1. Launch Pad
1.2. Ascent
1.3. Descent
1.4. Landed
1.5. Site Map
2. Save Flight Data
3. Replay Flight
4. Graph Data
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. Radio Frequency
6.4. Radio Calibration
6.5. Callsign
6.6. Maximum Flight Log Size
6.7. Ignite Mode
6.8. Pad Orientation
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. Radio Calibration
9. Flash Image
10. Fire Igniter
11. Scan Channels
12. Load Maps
13. Monitor Idle
7. Using Altus Metrum Products
1. Being Legal
2. In the Rocket
3. On the Ground
4. Data Analysis
5. Future Plans
8. 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
9. Updating Device Firmware
1. Updating TeleMetrum Firmware
2. Updating TeleMini Firmware
3. Updating TeleDongle Firmware
10. Hardware Specifications
1. TeleMetrum Specifications
2. TeleMini Specifications
11. FAQ
A. Notes for Older Software
B. Calibration
1. Radio Frequency
2. TeleMetrum Accelerometer
C. Release Notes

Chapter 1. Introduction and Overview

+

Table of Contents

1. Introduction and Overview
2. Getting Started
3. Handling Precautions
4. Hardware Overview
5. System Operation
1. Firmware Modes
2. GPS
3. Controlling An Altimeter Over The Radio Link
4. Ground Testing
5. Radio Link
6. Configurable Parameters
6.1. Radio Frequency
6.2. Apogee Delay
6.3. Main Deployment Altitude
6.4. Maximum Flight Log
6.5. Ignite Mode
6.6. Pad Orientation
6. AltosUI
1. Monitor Flight
1.1. Launch Pad
1.2. Ascent
1.3. Descent
1.4. Landed
1.5. Site Map
2. Save Flight Data
3. Replay Flight
4. Graph Data
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. Radio Frequency
6.4. Radio Calibration
6.5. Callsign
6.6. Maximum Flight Log Size
6.7. Ignite Mode
6.8. Pad Orientation
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. Radio Calibration
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. Altos Droid 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 TeleMetrum Firmware
2. Updating TeleMini Firmware
3. Updating TeleDongle Firmware
11. Hardware Specifications
1. TeleMetrum Specifications
2. TeleMini Specifications
12. FAQ
A. Notes for Older Software
B. Drill Templates
1. TeleMetrum template
2. TeleMini template
C. Calibration
1. Radio Frequency
2. TeleMetrum Accelerometer
D. Release Notes

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 @@ -59,23 +66,29 @@ NAR as standard features, and a "companion interface" that will support optional capabilities in the future.

- The newest device is TeleMini, a dual deploy altimeter with + Our second device was TeleMini, a dual deploy altimeter with radio telemetry and radio direction finding. This device is only 13mm by 38mm (½ inch by 1½ inches) and can fit easily in an 18mm air-frame.

- Complementing TeleMetrum and TeleMini is TeleDongle, a USB to RF - interface 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 + 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 Altos Droid + 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

+

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.

@@ -100,8 +113,9 @@ NAR

The TeleMini battery can be charged by disconnecting it from the TeleMini board and plugging it into a standalone battery charger - board, and connecting that via a USB cable to a laptop or other USB - power source + 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.

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

Chapter 3. Handling Precautions

+

+ If you're using a TeleBT instead of the TeleDongle, you'll want + to go install the Altos Droid application from the Google Play + store. You don't need a data plan to use Altos Droid, 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 @@ -160,7 +183,7 @@ NAR As with all other rocketry electronics, Altus Metrum altimeters must be protected from exposure to corrosive motor exhaust and ejection charge gasses. -

Chapter 4. Hardware Overview

+

Chapter 4. Hardware Overview

TeleMetrum is a 1 inch by 2.75 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 @@ -188,6 +211,18 @@ NAR 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. +

+ The battery connectors are a standard 2-pin JST connector and + match batteries sold by Spark Fun. These batteries are + single-cell Lithium Polymer batteries that nominally provide 3.7 + volts. Other vendors sell similar batteries for RC aircraft + using mating connectors, however the polarity for those is + generally reversed from the batteries used by Altus Metrum + products. In particular, the Tenergy batteries supplied for use + in Featherweight flight computers are not compatible with Altus + Metrum flight computers or battery chargers. Check + polarity and voltage before connecting any battery not purchased + from Altus Metrum or Spark Fun.

By default, we use the unregulated output of the Li-Po battery directly to fire ejection charges. This works marvelously with standard @@ -214,7 +249,7 @@ NAR connection, and, on TeleMetrum, 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

+

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 @@ -249,15 +284,15 @@ NAR 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 to a TeleMetrum in idle mode - over either - USB or the radio link equivalently. TeleMini 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 + 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 + to a TeleMetrum in idle mode over either USB or the radio link + equivalently. TeleMini 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.

One "neat trick" of particular value when TeleMetrum is used with @@ -269,7 +304,30 @@ NAR 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! -

2. GPS

+

+ TeleMini is configured 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 + 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 includes 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 TeleMetrum GPS receiver needs to lock onto at least @@ -287,12 +345,13 @@ NAR 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. +

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 TeleMetrum can either be done with TeleMetrum directly connected to the @@ -312,7 +371,7 @@ NAR 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.

    • @@ -353,9 +412,9 @@ NAR

      You can monitor the operation of the radio link by watching the lights on the devices. The red LED will flash each time a packet - is tramsitted, while the green LED will light up on TeleDongle when + is transmitted, while the green LED will light up on TeleDongle when it is waiting to receive a packet from the altimeter. -

    4. Ground Testing

    +

    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, @@ -371,7 +430,7 @@ NAR 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

    +

    5. Radio Link

    The chip our boards are based on incorporates 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 @@ -402,13 +461,13 @@ NAR with a 5-element yagi on the ground. We hope to fly boards to higher altitudes over time, and would of course appreciate customer feedback on performance in higher altitude flights! -

    6. Configurable Parameters

    +

    6. Configurable Parameters

    Configuring an Altus Metrum altimeter for flight is very simple. Even on our baro-only TeleMini board, 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. -

    6.1. Radio Frequency

    +

    6.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 @@ -418,7 +477,7 @@ NAR 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. -

    6.2. Apogee Delay

    +

    6.2. 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 @@ -434,7 +493,7 @@ NAR 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. -

    6.3. Main Deployment Altitude

    +

    6.3. 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 @@ -443,7 +502,7 @@ NAR deployment elevation for the backup altimeter to be something lower than the primary so that both pyrotechnic charges don't fire simultaneously. -

    6.4. Maximum Flight Log

    +

    6.4. Maximum Flight Log

    TeleMetrum version 1.1 and 1.2 have 2MB of on-board flash storage, enough to hold over 40 minutes of data at full data rate (100 samples/second). TeleMetrum 1.0 has 1MB of on-board @@ -487,7 +546,7 @@ NAR the limited storage, TeleMini cannot hold data for more than one flight, and so must be erased after each flight or it will not capture data for subsequent flights. -

    6.5. Ignite Mode

    +

    6.5. 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 @@ -499,7 +558,7 @@ NAR 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. -

    6.6. Pad Orientation

    +

    6.6. Pad Orientation

    TeleMetrum measures acceleration along the axis of the board. Which way the board is oriented affects the sign of the acceleration value. Instead of trying to guess which way @@ -509,7 +568,7 @@ NAR TeleMetrum board connected to the 70cm antenna to be nearest the nose of the rocket, with the end containing the screw terminals nearest the tail. -

Chapter 6. AltosUI

The AltosUI program provides a graphical user interface for interacting with the Altus Metrum product family, including TeleMetrum, TeleMini and TeleDongle. AltosUI can monitor telemetry data, @@ -518,7 +577,7 @@ NAR buttons, one for each major activity in the system. This manual is split into chapters, each of which documents one of the tasks provided from the top-level toolbar. -

1. Monitor Flight

Receive, Record and Display Telemetry Data

+

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 @@ -538,7 +597,7 @@ NAR 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 +

    • 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 @@ -551,6 +610,12 @@ NAR 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. @@ -559,12 +624,12 @@ NAR 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

    +

    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 TeleMetrum has sufficient charge to last for the duration of the flight. A value of more than @@ -608,7 +673,7 @@ NAR and altitude, averaging many reported positions to improve the accuracy of the fix.

        -

      1.2. Ascent

      +

      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. @@ -627,7 +692,7 @@ NAR 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

      +

      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, @@ -656,7 +721,7 @@ NAR 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

      +

      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 @@ -685,7 +750,7 @@ NAR 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. Site Map

      +

      1.5. 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 @@ -704,7 +769,7 @@ NAR

      You can pre-load images for your favorite launch sites before you leave home; check out the 'Preload Maps' section below. -

    2. Save Flight Data

    +

    2. Save Flight Data

    The altimeter records flight data to its internal flash memory. TeleMetrum data is recorded at a much higher rate than the telemetry system can handle, and is not subject to radio drop-outs. As @@ -735,7 +800,7 @@ NAR The file name for each flight log is computed automatically from the recorded flight date, altimeter serial number and flight number information. -

    3. Replay Flight

    +

    3. 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 @@ -744,20 +809,21 @@ NAR Once a flight record is selected, the flight monitor interface is displayed and the flight is re-enacted in real time. Check the Monitor Flight chapter above to learn how this window operates. -

    4. Graph Data

    +

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

    - Once a flight record is selected, a window with two tabs is + Once a flight record is selected, a window with four tabs is opened. The first tab contains a graph with acceleration (blue), velocity (green) and altitude (red) of the flight, - measured in metric units. The - apogee(yellow) and main(magenta) igniter voltages are also - displayed; high voltages indicate continuity, low voltages - indicate open circuits. The second tab contains some basic - flight statistics. + measured in metric units. The apogee(yellow) and main(magenta) + igniter voltages are also displayed; high voltages indicate + continuity, low voltages indicate open circuits. The second + tab lets you configure which data to show in the graph. The + third contains some basic flight statistics while the fourth + has a map with the ground track of the flight displayed.

    The graph can be zoomed into a particular area by clicking and dragging down and to the right. Once zoomed, the graph can be @@ -769,7 +835,7 @@ NAR 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. -

    5. Export Data

    +

    5. 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 @@ -778,7 +844,7 @@ NAR data). Next, a second dialog appears which is used to select where to write the resulting file. It has a selector to choose between CSV and KML file formats. -

    5.1. Comma Separated Value Format

    +

    5.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 @@ -792,11 +858,11 @@ NAR the sensor values are converted to standard units, with the barometric data reported in both pressure, altitude and height above pad units. -

    5.2. Keyhole Markup Language (for Google Earth)

    +

    5.2. Keyhole Markup Language (for Google Earth)

    This is the format used by Google Earth to provide an overlay within that application. With this, you can use Google Earth to see the whole flight path in 3D. -

    6. Configure Altimeter

    +

    6. Configure Altimeter

    Select this button and then select either a TeleMetrum or TeleDongle Device from the list provided. Selecting a TeleDongle device will use the radio link to configure a remote altimeter. @@ -807,7 +873,7 @@ NAR 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. @@ -824,14 +890,14 @@ NAR lost.

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

      6.1. Main Deploy Altitude

      +

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

      6.2. Apogee Delay

      +

      6.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 @@ -839,13 +905,13 @@ NAR Delay parameter tells the flight computer to fire the apogee charge a certain number of seconds after apogee has been detected. -

      6.3. Radio Frequency

      +

      6.3. Radio Frequency

      This configures which of the configured frequencies to use for both telemetry and packet command mode. Note that if you set this value via packet command mode, you will have to reconfigure the TeleDongle frequency before you will be able to use packet command mode again. -

      6.4. Radio Calibration

      +

      6.4. Radio Calibration

      The radios in every Altus Metrum device are calibrated at the factory to ensure that they transmit and receive on the specified frequency. If you need to you can adjust the calibration @@ -853,20 +919,20 @@ NAR the value means, read the appendix on calibration and/or the source code for more information. To change a TeleDongle's calibration, you must reprogram the unit completely. -

      6.5. Callsign

      +

      6.5. Callsign

      This sets the call sign included in each telemetry packet. Set this as needed to conform to your local radio regulations. -

      6.6. Maximum Flight Log Size

      +

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

      6.7. Ignite Mode

      +

      6.7. Ignite Mode

      TeleMetrum and TeleMini provide two igniter channels as they were originally designed as dual-deploy flight computers. This configuration parameter allows the two channels 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 @@ -881,13 +947,13 @@ NAR Altitude setting during descent. The 'apogee' channel is fired first, followed after a two second delay by the 'main' channel. -

      6.8. Pad Orientation

      +

    6.8. Pad Orientation

    Because it includes an accelerometer, TeleMetrum is sensitive to the orientation of the board. By default, it expects the antenna end to point forward. This parameter allows that default to be changed, permitting the board to be mounted with the antenna pointing aft instead. -

    • +

      • Antenna Up. In this mode, the antenna end of the TeleMetrum board must point forward, in line with the expected flight path. @@ -895,18 +961,18 @@ NAR Antenna Down. In this mode, the antenna end of the TeleMetrum board must point aft, in line with the expected flight path. -

    7. Configure AltosUI

    +

7. Configure AltosUI

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

7.1. Voice Settings

+

7.1. Voice Settings

AltosUI provides voice announcements during flight so that you can keep your eyes on the sky and still get information about the current flight status. However, sometimes you don't want to hear them. -

  • Enable—turns all voice announcements on and off

  • +

    • Enable—turns all voice announcements on and off

    • Test Voice—Plays a short message allowing you to verify that the audio system is working and the volume settings are reasonable -

7.2. Log Directory

+

7.2. Log Directory

AltosUI logs all telemetry data and saves all TeleMetrum flash data to this directory. This directory is also used as the staring point when selecting data files for display or export. @@ -914,36 +980,36 @@ NAR 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.3. Callsign

+

7.3. Callsign

This value is transmitted in each command packet sent from TeleDongle and received from an altimeter. It is not used in telemetry mode, as the callsign configured in the altimeter board is included in all telemetry packets. Configure this with the AltosUI operators call sign as needed to comply with your local radio regulations. -

7.4. Imperial Units

+

7.4. Imperial Units

This switches between metric units (meters) and imperial units (feet and miles). This affects the display of values use during flight monitoring, data graphing and all of the voice announcements. It does not change the units used when exporting to CSV files, those are always produced in metric units. -

7.5. Font Size

+

7.5. Font Size

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

7.6. Serial Debug

+

7.6. 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.7. Manage Frequencies

+

7.7. Manage Frequencies

This brings up a dialog where you can configure the set of frequencies shown in the various frequency menus. You can add as many as you like, or even reconfigure the default set. Changing this list does not affect the frequency settings of any devices, it only changes the set of frequencies shown in the menus. -

8. Configure Groundstation

+

8. Configure Groundstation

Select this button and then select a TeleDongle Device from the list provided.

The first few lines of the dialog provide information about the @@ -958,7 +1024,7 @@ NAR machine will cause settings made here to have no effect.

At the bottom of the dialog, there are three buttons: -

  • +

    • Save. This writes any changes to the local Java preferences file. If you don't press this button, any changes you make will be lost. @@ -970,20 +1036,20 @@ NAR lost.

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

    8.1. Frequency

    +

    8.1. Frequency

    This configures the frequency to use for both telemetry and packet command mode. Set this before starting any operation involving packet command mode so that it will use the right frequency. Telemetry monitoring mode also provides a menu to change the frequency, and that menu also sets the same Java preference value used here. -

    8.2. Radio Calibration

    +

    8.2. Radio Calibration

    The radios in every Altus Metrum device are calibrated at the factory to ensure that they transmit and receive on the specified frequency. To change a TeleDongle's calibration, you must reprogram the unit completely, so this entry simply shows the current value and doesn't allow any changes. -

    9. Flash Image

    +

9. Flash Image

This reprograms any Altus Metrum device by using a TeleMetrum or TeleDongle as a programming dongle. Please read the directions for flashing devices in the Updating Device @@ -1013,7 +1079,7 @@ NAR will have to unplug it and then plug it back in for the USB connection to reset so that you can communicate with the device again. -

10. Fire Igniter

+

10. Fire Igniter

This activates the igniter circuits in TeleMetrum to help test recovery systems deployment. Because this command can operate over the Packet Command Link, you can prepare the rocket as @@ -1033,14 +1099,14 @@ NAR 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. -

11. Scan Channels

+

11. Scan Channels

This listens for telemetry packets on all of the configured frequencies, displaying information about each device it receives a packet from. You can select which of the three telemetry formats should be tried; by default, it only listens for the standard telemetry packets used in v1.0 and later firmware. -

12. Load Maps

+

12. Load Maps

Before heading out to a new launch site, you can use this to load satellite images in case you don't have internet connectivity at the site. This loads a fairly large area @@ -1059,16 +1125,112 @@ NAR once, so if you load more than one launch site, you may get some gray areas in the map which indicate that Google is tired of sending data to you. Try again later. -

13. Monitor Idle

+

13. Monitor Idle

This brings up a dialog similar to the Monitor Flight UI, except it works with the altimeter in "idle" mode by sending query commands to discover the current state rather than listening for telemetry packets. -

Chapter 7. Using Altus Metrum Products

1. Being Legal

+

Chapter 7. AltosDroid

+ AltosDroid provides the same flight monitoring capabilities as + AltosUI, but runs on Android devices and is designed to connect + to a TeleBT receiver over Bluetooth™. Altos Droid monitors + telemetry data, logging it to internal storage in the Android + device, and presents that data in a UI the same way the 'Monitor + Flight' window does in AltosUI. +

+ This manual will explain how to configure AltosDroid, connect + to TeleBT, operate the flight monitoring interface and describe + what the displayed data means. +

1. Installing AltosDroid

+ AltosDroid is included in the Google Play store. To install + it on your Android device, open open the Google Play Store + application and search for "altosdroid". Make sure you don't + have a space between "altos" and "droid" or you probably won't + find what you want. That should bring you to the right page + from which you can download and install the application. +

2. Connecting to TeleBT

+ Press the Android 'Menu' button or soft-key to see the + configuration options available. Select the 'Connect a device' + option and then the 'Scan for devices' entry at the bottom to + look for your TeleBT device. Select your device, and when it + asks for the code, enter '1234'. +

+ Subsequent connections will not require you to enter that + code, and your 'paired' device will appear in the list without + scanning. +

3. Configuring AltosDroid

+ The only configuration option available for AltosDroid is + which frequency to listen on. Press the Android 'Menu' button + or soft-key and pick the 'Select radio frequency' entry. That + brings up a menu of pre-set radio frequencies; pick the one + which matches your altimeter. +

4. Altos Droid Flight Monitoring

+ Altos Droid is designed to mimic the AltosUI flight monitoring + display, providing separate tabs for each stage of your rocket + flight along with a tab containing a map of the local area + with icons marking the current location of the altimeter and + the Android device. +

4.1. 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 TeleMetrum has sufficient charge to last for + the duration of the flight. A value of more than + 3.7V is required for a 'GO' status. +

  • + 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. TeleMetrum can store multiple flights, depending + on the configured maximum flight log size. TeleMini + stores only a single flight, so it will need to be + downloaded and erased after each flight to capture + data. This only affects on-board flight logging; the + altimeter will still transmit telemetry and fire + ejection charges at the proper times. +

  • + GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is + currently able to compute position information. GPS requires + at least 4 satellites to compute an accurate position. +

  • + GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least + 10 consecutive positions without losing lock. This ensures + that the GPS receiver has reliable reception from the + satellites. +

+

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

+

5. Downloading Flight Logs

+ Altos Droid always saves every bit of telemetry data it + receives. To download that to a computer for use with AltosUI, + simply remove the SD card from your Android device, or connect + your device to your computer's USB port and browse the files + on that device. You will find '.telem' files in the TeleMetrum + directory that will work with AltosUI directly. +

Chapter 8. Using Altus Metrum Products

1. Being Legal

First off, in the US, you need an amateur radio license or other authorization to legally operate the radio transmitters that are part of our products. -

2. In the Rocket

+

2. In the Rocket

In the rocket itself, you just need a TeleMetrum or TeleMini board and a single-cell, 3.7 volt nominal Li-Po rechargeable battery. An @@ -1082,9 +1244,11 @@ NAR which is opaque to RF signals, you may choose to have an SMA connector installed so that you can run a coaxial cable to an antenna mounted elsewhere in the rocket. -

3. On the Ground

+

3. On the Ground

To receive the data stream from the rocket, you need an antenna and short - feed-line connected to one of our TeleDongle units. The + feed-line connected to one of our TeleDongle units. If possible, use an SMA to BNC + adapter instead of feedline between the antenna feedpoint and + TeleDongle, as this will give you the best performance. The TeleDongle in turn plugs directly into the USB port on a notebook computer. Because TeleDongle looks like a simple serial port, your computer does not require special device drivers... just plug it in. @@ -1115,7 +1279,7 @@ NAR

So, to recap, on the ground the hardware you'll need includes:

  1. - an antenna and feed-line + an antenna and feed-line or adapter
  2. a TeleDongle
  3. @@ -1132,8 +1296,10 @@ NAR Arrow Antennas. The 440-3 and 440-5 are both good choices for finding a - TeleMetrum- or TeleMini- equipped rocket when used with a suitable 70cm HT. -

4. Data Analysis

+ TeleMetrum- or TeleMini- equipped rocket when used with a suitable + 70cm HT. TeleDongle and an SMA to BNC adapter fit perfectly + between the driven element and reflector of Arrow antennas. +

4. 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 @@ -1148,29 +1314,41 @@ NAR 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. -

5. Future Plans

- In the future, we intend to offer "companion boards" for the rocket that will - plug in to TeleMetrum to collect additional data, provide more pyro channels, - and so forth. +

5. Future Plans

+ In the future, we intend to offer "companion boards" for the rocket + that will plug in to TeleMetrum to collect additional data, provide + more pyro channels, and so forth. +

+ Also under design is a new flight computer with more sensors, more + pyro channels, and a more powerful radio system designed for use + in multi-stage, complex, and extreme altitude projects.

- We are also working on the design of a hand-held ground terminal that will - allow monitoring the rocket's status, collecting data during flight, and - logging data after flight without the need for a notebook computer on the - flight line. Particularly since it is so difficult to read most notebook - screens in direct sunlight, we think this will be a great thing to have. + We are also working on alternatives to TeleDongle. One is a + a stand-alone, hand-held ground terminal that will allow monitoring + the rocket's status, collecting data during flight, and logging data + after flight without the need for a notebook computer on the + flight line. Particularly since it is so difficult to read most + notebook screens in direct sunlight, we think this will be a great + thing to have. We are also working on a TeleDongle variant with + Bluetooth that will work with Android phones and tablets.

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

Chapter 8. Altimeter Installation Recommendations

+ 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 9. Altimeter Installation Recommendations

Building high-power rockets that fly safely is hard enough. Mix in some sophisticated electronics and a bunch of radio energy and oftentimes you find few perfect solutions. This chapter contains some suggestions about how to install Altus Metrum products into the rocket air-frame, including how to safely and reliably mix a variety of electronics into the same air-frame. -

1. Mounting the Altimeter

+

1. Mounting the Altimeter

The first consideration is to ensure that the altimeter is securely fastened to the air-frame. For TeleMetrum, we use nylon standoffs and nylon screws; they're good to at least 50G @@ -1187,7 +1365,7 @@ NAR Watch for any metal touching components on the board. Shorting out connections on the bottom of the board can cause the altimeter to fail during flight. -

2. Dealing with the Antenna

+

2. Dealing with the Antenna

The antenna supplied is just a piece of solid, insulated, wire. If it gets damaged or broken, it can be easily replaced. It should be kept straight and not cut; bending or @@ -1230,7 +1408,7 @@ NAR SMA connector, and then run 50Ω coax from the board to the antenna. Building a remote antenna is beyond the scope of this manual. -

3. Preserving GPS Reception

+

3. Preserving GPS Reception

The GPS antenna and receiver in TeleMetrum are highly sensitive and normally have no trouble tracking enough satellites to provide accurate position information for @@ -1249,7 +1427,7 @@ NAR antenna as that's covered with a ground plane. But, keep wires and metal out from above the patch antenna.

-

4. Radio Frequency Interference

+

4. Radio Frequency Interference

Any altimeter will generate RFI; the digital circuits use high-frequency clocks that spray radio interference across a wide band. Altus Metrum altimeters generate intentional radio @@ -1264,7 +1442,7 @@ NAR Voltages are induced when radio frequency energy is transmitted from one circuit to another. Here are things that influence the induced voltage and current: -

  • +

    • Keep wires from different circuits apart. Moving circuits further apart will reduce RFI.
    • @@ -1287,7 +1465,7 @@ NAR 70cm amateur band, so you should avoid lengths that are a simple ratio of that length; essentially any multiple of 1/4 of the wavelength (17.5cm). -

5. The Barometric Sensor

+

5. The Barometric Sensor

Altusmetrum altimeters measure altitude with a barometric sensor, essentially measuring the amount of air above the rocket to figure out how high it is. A large number of @@ -1305,7 +1483,7 @@ NAR chemical damage from the products of APCP or BP combustion, so make sure the ebay is carefully sealed from any compartment which contains ejection charges or motors. -

6. Ground Testing

+

6. Ground Testing

The most important aspect of any installation is careful ground testing. Bringing an air-frame up to the LCO table which hasn't been ground tested can lead to delays or ejection @@ -1327,7 +1505,7 @@ NAR interface through a TeleDongle to command each charge to fire. Make sure the charge is sufficient to robustly separate the air-frame and deploy the recovery system. -

Chapter 10. Updating Device Firmware

The big concept to understand is that you have to use a TeleDongle as a programmer to update a TeleMetrum or TeleMini, and a TeleMetrum or other TeleDongle to program the TeleDongle @@ -1343,7 +1521,7 @@ NAR version from http://www.altusmetrum.org/AltOS/.

We recommend updating the altimeter first, before updating TeleDongle. -

1. Updating TeleMetrum Firmware

  1. +

    1. Updating TeleMetrum Firmware

    1. Find the 'programming cable' that you got as part of the starter kit, that has a red 8-pin MicroMaTch connector on one end and a red 4-pin MicroMaTch connector on the other end. @@ -1386,7 +1564,7 @@ NAR the version, etc.
    2. If something goes wrong, give it another try. -

    2. Updating TeleMini Firmware

    1. +

    2. Updating TeleMini Firmware

    1. You'll need a special 'programming cable' to reprogram the TeleMini. It's available on the Altus Metrum web store, or you can make your own using an 8-pin MicroMaTch connector on @@ -1430,7 +1608,7 @@ NAR letting it come up in "flight" mode and listening for telemetry.
    2. If something goes wrong, give it another try. -

    3. Updating TeleDongle Firmware

    +

3. Updating TeleDongle Firmware

Updating TeleDongle's firmware is just like updating TeleMetrum or TeleMini firmware, but you use either a TeleMetrum or another TeleDongle as the programmer.

  1. @@ -1490,7 +1668,7 @@ NAR slightly to extract the connector. We used a locking connector on TeleMetrum to help ensure that the cabling to companion boards used in a rocket don't ever come loose accidentally in flight. -

Chapter 10. Hardware Specifications

1. TeleMetrum Specifications

  • +

Chapter 11. Hardware Specifications

1. TeleMetrum Specifications

  • Recording altimeter for model rocketry.

  • Supports dual deployment (can fire 2 ejection charges). @@ -1514,7 +1692,7 @@ NAR optional separate pyro battery if needed.

  • 2.75 x 1 inch board designed to fit inside 29mm air-frame coupler tube. -

2. TeleMini Specifications

  • +

2. TeleMini Specifications

  • Recording altimeter for model rocketry.

  • Supports dual deployment (can fire 2 ejection charges). @@ -1525,7 +1703,7 @@ NAR

  • On-board 5 kilobyte non-volatile memory for flight data storage.

  • - RF interface for battery charging, configuration, and data recovery. + RF interface for configuration, and data recovery.

  • Support for Li-Po rechargeable batteries, using an external charger.

  • @@ -1533,7 +1711,7 @@ NAR optional separate pyro battery if needed.

  • 1.5 x .5 inch board designed to fit inside 18mm air-frame coupler tube. -

Chapter 11. FAQ

+

Chapter 12. FAQ

TeleMetrum seems to shut off when disconnected from the computer. Make sure the battery is adequately charged. Remember the unit will pull more power than the USB port can deliver before the @@ -1573,7 +1751,7 @@ NAR data after physically retrieving your altimeter. Make sure to save the on-board data after each flight; while the TeleMetrum can store multiple flights, you never know when you'll lose the altimeter... -

Appendix A. Notes for Older Software

+

Appendix A. Notes for Older Software

Before AltosUI was written, using Altus Metrum devices required some finesse with the Linux command line. There was a limited @@ -1749,7 +1927,16 @@ NAR the Log and Device menus. It has a wonderful display of the incoming flight data and I am sure you will enjoy what it has to say to you once you enable the voice output! -

Appendix B. Calibration

+

Appendix B. Drill Templates

+ These images, when printed, provide precise templates for the + mounting holes in Altus Metrum flight computers +

1. TeleMetrum template

+ TeleMetrum has overall dimensions of 1.000 x 2.750 inches, and the + mounting holes are sized for use with 4-40 or M3 screws. +

2. TeleMini template

+ TeleMini has overall dimensions of 0.500 x 1.500 inches, and the + mounting holes are sized for use with 2-56 or M2 screws. +

Appendix C. Calibration

There are only two calibrations required for a TeleMetrum board, and only one for TeleDongle and TeleMini. All boards are shipped from the factory pre-calibrated, but the procedures are documented here @@ -1757,7 +1944,7 @@ NAR AltosUI, you must connect to the board with a serial terminal program and interact directly with the on-board command interpreter to effect calibration. -

1. Radio Frequency

+

1. Radio Frequency

The radio frequency is synthesized from a clock based on the 48 MHz crystal on the board. The actual frequency of this oscillator must be measured to generate a calibration constant. While our @@ -1792,7 +1979,7 @@ NAR radio frequency is reset to the default 434.550 Mhz. If you want to use another frequency, you will have to set that again after calibration is completed. -

2. TeleMetrum Accelerometer

+

2. TeleMetrum Accelerometer

The TeleMetrum accelerometer we use has its own 5 volt power supply and the output must be passed through a resistive voltage divider to match @@ -1836,7 +2023,93 @@ NAR to the index post on the 4-pin end of the programming cable, and power up the board. It should come up in 'idle mode' (two beeps), allowing a re-cal. -

Appendix C. Release Notes

+

Appendix D. Release Notes

Version 1.21

+ Version 1.2.1 is a minor release. It adds support for TeleBT and + the AltosDroid application, provides several new features in + AltosUI and fixes some bugs in the AltOS firmware. +

+ AltOS Firmware Changes +

  • + Add support for TeleBT +
  • + In TeleMini recovery mode (when booted with the outer two + debug pins connected together), the radio parameters are also + set back to defaults (434.550MHz, N0CALL, factory radio cal). +
  • + Add support for reflashing the SkyTraq GPS chips. This + requires special host-side code which currently only exists + for Linux. +
  • + Correct Kalman filter model error covariance matrix. The + values used previously assumed continuous measurements instead + of discrete measurements. +
  • + Fix some bugs in the USB driver for TeleMetrum and TeleDongle + that affected Windows users. +
  • + Adjusted the automatic gain control parameters that affect + receive performance for TeleDongle. Field tests indicate that this + may improve receive performance somewhat. +

+

+ AltosUI Changes +

  • + Handle missing GPS lock in 'Descent' tab. Previously, if the + GPS position of the pad was unknown, an exception would be + raised, breaking the Descent tab contents. +
  • + Improve the graph, adding tool-tips to show values near the + cursor and making the displayed set of values configurable, + adding all of the flight data as options while leaving the + default settings alone so that the graph starts by showing + height, speed and acceleration. +
  • + Make the initial position of the AltosUI top level window + configurable. Along with this change, the other windows will + pop up at 'sensible' places now, instead of on top of one + another. +
  • + Add callsign to Monitor idle window and connecting + dialogs. This makes it clear which callsign is being used so + that the operator will be aware that it must match the flight + computer value or no communication will work. +
  • + When downloading flight data, display the block number so that + the user has some sense of progress. Unfortunately, we don't + know how many blocks will need to be downloaded, but at least + it isn't just sitting there doing nothing for a long time. +
  • + Add GPS data and a map to the graph window. This lets you see + a complete summary of the flight without needing to 'replay' + the whole thing. +

+

Version 1.2

+ Version 1.2 is a major release. It adds support for MicroPeak and + the MicroPeak USB adapter. +

+ AltOS Firmware Changes +

  • + Add MicroPeak support. This includes support for the ATtiny85 + processor and adaptations to the core code to allow for + devices too small to run the multi-tasking scheduler. +

+

+ MicroPeak UI changes +

  • + Added this new application +

+

+ Distribution Changes +

  • + Distribute Mac OS X packages in disk image ('.dmg') format to + greatly simplify installation. +
  • + Provide version numbers for the shared Java libraries to + ensure that upgrades work properly, and to allow for multiple + Altus Metrum software packages to be installed in the same + directory at the same time. +

+

Version 1.1.1

Version 1.1.1 is a bug-fix release. It fixes a couple of bugs in AltosUI and one firmware bug that affects TeleMetrum version 1.0 boards. Thanks to Bob Brown for help diagnosing the Google Earth @@ -1844,7 +2117,7 @@ NAR Distance value in the Descent tab.

AltOS Firmware Changes -

  • +

    • TeleMetrum v1.0 boards use the AT45DB081D flash memory part to store flight data, which is different from later TeleMetrum boards. The AltOS v1.1 driver for this chip couldn't erase @@ -1855,7 +2128,7 @@ NAR

    AltosUI Changes -

    • +

      • Creating a Google Earth file (KML) from on-board flight data (EEPROM) would generate an empty file. The code responsible for reading the EEPROM file wasn't ever setting the GPS valid @@ -1881,12 +2154,12 @@ NAR from the flight computer was missing a check for TeleMini when deciding whether to fetch the analog sensor data.

      -

      +

    Version 1.1

    Version 1.1 is a minor release. It provides a few new features in AltosUI and the AltOS firmware and fixes bugs.

    AltOS Firmware Changes -

    • +

      • Add apogee-lockout value. Overrides the apogee detection logic to prevent incorrect apogee charge firing.
      • @@ -1906,7 +2179,7 @@ NAR

      AltosUI Changes -

      • +

        • Fix a bug that caused GPS ready to happen too quickly. The software was using every telemetry packet to signal new GPS data, which caused GPS ready to be signalled after 10 packets @@ -1953,12 +2226,12 @@ NAR Add Imperial units mode to present data in feet instead of meters.

        -

        +

      Version 1.0.1

      Version 1.0.1 is a major release, adding support for the TeleMini device and lots of new AltosUI features

      AltOS Firmware Changes -

      • +

        • Add TeleMini v1.0 support. Firmware images for TeleMini are included in AltOS releases.
        • @@ -1995,7 +2268,7 @@ NAR

        AltosUI Changes -

        • +

          • Wait for altimeter when using packet mode. Instead of quicly timing out when trying to initialize a packet mode configuration connection, AltosUI now waits indefinitely for @@ -2033,18 +2306,18 @@ NAR Flight window so you can immediately see the results of a flight.

          -

          +

        Version 0.9.2

        Version 0.9.2 is an AltosUI bug-fix release, with no firmware changes. -

        • +

          • Fix plotting problems due to missing file in the Mac OS install image.
          • Always read whole eeprom blocks, mark empty records invalid, display parsing errors to user.
          • Add software version to Configure AltosUI dialog -

          +

        Version 0.9

        Version 0.9 adds a few new firmware features and accompanying AltosUI changes, along with new hardware support. -

        • +

          • Support for TeleMetrum v1.1 hardware. Sources for the flash memory part used in v1.0 dried up, so v1.1 uses a different part which required a new driver and support for explicit flight log @@ -2060,10 +2333,10 @@ NAR provided only 8 bits for the device serial number. This change requires that both ends of the telemetry link be running the 0.9 firmware or they will not communicate. -

          +

        Version 0.8

        Version 0.8 offers a major upgrade in the AltosUI interface. Significant new features include: -

        • +

          • Post-flight graphing tool. This lets you explore the behaviour of your rocket after flight with a scroll-able and zoom-able chart showing the altitude, speed and acceleration of the @@ -2100,9 +2373,9 @@ NAR Exports Google Earth flight tracks. Using the Keyhole Markup Language (.kml) file format, this provides a 3D view of your rocket flight through the Google Earth program. -

          +

        Version 0.7.1

        Version 0.7.1 is the first release containing our new cross-platform Java-based user interface. AltosUI can: -

        • +

          • Receive and log telemetry from a connected TeleDongle device. All data received is saved to log files named with the current date and the connected rocket serial and flight @@ -2141,4 +2414,4 @@ Version 0.7.1 is the first release containing our new cross-platform Java-based range information to try and help you find your rocket in the air. Once on the ground, the direction and distance are reported. -
        +
    diff --git a/AltOS/doc/altusmetrum.pdf b/AltOS/doc/altusmetrum.pdf index 3b69f9c..3751b88 100644 Binary files a/AltOS/doc/altusmetrum.pdf and b/AltOS/doc/altusmetrum.pdf differ diff --git a/AltOS/doc/release-notes-1.2.1.html b/AltOS/doc/release-notes-1.2.1.html new file mode 100644 index 0000000..7b869ce --- /dev/null +++ b/AltOS/doc/release-notes-1.2.1.html @@ -0,0 +1,61 @@ +

    + Version 1.2.1 is a minor release. It adds support for TeleBT and + the AltosDroid application, provides several new features in + AltosUI and fixes some bugs in the AltOS firmware. +

    + AltOS Firmware Changes +

    • + Add support for TeleBT +
    • + In TeleMini recovery mode (when booted with the outer two + debug pins connected together), the radio parameters are also + set back to defaults (434.550MHz, N0CALL, factory radio cal). +
    • + Add support for reflashing the SkyTraq GPS chips. This + requires special host-side code which currently only exists + for Linux. +
    • + Correct Kalman filter model error covariance matrix. The + values used previously assumed continuous measurements instead + of discrete measurements. +
    • + Fix some bugs in the USB driver for TeleMetrum and TeleDongle + that affected Windows users. +
    • + Adjusted the automatic gain control parameters that affect + receive performance for TeleDongle. Field tests indicate that this + may improve receive performance somewhat. +

    +

    + AltosUI Changes +

    • + Handle missing GPS lock in 'Descent' tab. Previously, if the + GPS position of the pad was unknown, an exception would be + raised, breaking the Descent tab contents. +
    • + Improve the graph, adding tool-tips to show values near the + cursor and making the displayed set of values configurable, + adding all of the flight data as options while leaving the + default settings alone so that the graph starts by showing + height, speed and acceleration. +
    • + Make the initial position of the AltosUI top level window + configurable. Along with this change, the other windows will + pop up at 'sensible' places now, instead of on top of one + another. +
    • + Add callsign to Monitor idle window and connecting + dialogs. This makes it clear which callsign is being used so + that the operator will be aware that it must match the flight + computer value or no communication will work. +
    • + When downloading flight data, display the block number so that + the user has some sense of progress. Unfortunately, we don't + know how many blocks will need to be downloaded, but at least + it isn't just sitting there doing nothing for a long time. +
    • + Add GPS data and a map to the graph window. This lets you see + a complete summary of the flight without needing to 'replay' + the whole thing. +

    +

    diff --git a/AltOS/doc/release-notes-1.2.html b/AltOS/doc/release-notes-1.2.html new file mode 100644 index 0000000..3f7453e --- /dev/null +++ b/AltOS/doc/release-notes-1.2.html @@ -0,0 +1,27 @@ +

    + Version 1.2 is a major release. It adds support for MicroPeak and + the MicroPeak USB adapter. +

    + AltOS Firmware Changes +

    • + Add MicroPeak support. This includes support for the ATtiny85 + processor and adaptations to the core code to allow for + devices too small to run the multi-tasking scheduler. +

    +

    + MicroPeak UI changes +

    • + Added this new application +

    +

    + Distribution Changes +

    • + Distribute Mac OS X packages in disk image ('.dmg') format to + greatly simplify installation. +
    • + Provide version numbers for the shared Java libraries to + ensure that upgrades work properly, and to allow for multiple + Altus Metrum software packages to be installed in the same + directory at the same time. +

    +

    diff --git a/AltOS/doc/telemetry.html b/AltOS/doc/telemetry.html index 6cabe0b..dc7c606 100644 --- a/AltOS/doc/telemetry.html +++ b/AltOS/doc/telemetry.html @@ -1,10 +1,10 @@ -AltOS Telemetry

    AltOS Telemetry

    Packet Definitions

    Keith Packard

    +AltOS Telemetry

    AltOS Telemetry

    Packet Definitions

    Keith Packard

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

    Revision History
    Revision 0.101 July 2011
    Initial content

    1. Packet Format Design

    +

    Revision History
    Revision 0.101 July 2011
    Initial content

    1. Packet Format Design

    AltOS telemetry data is split into multiple different packets, all the same size, but each includs an identifier so that the ground station can distinguish among different types. A single @@ -22,14 +22,14 @@ All packet types start with a five byte header which encodes the device serial number, device clock value and the packet type. The remaining 27 bytes encode type-specific data. -

    2. Packet Formats

    +

    2. Packet Formats

    This section first defines the packet header common to all packets and then the per-packet data layout. -

    2.1. Packet Header

    Table 1. Telemetry Packet Header

    OffsetData TypeNameDescription
    0uint16_tserialDevice serial Number
    2uint16_ttickDevice time in 100ths of a second
    4uint8_ttypePacket type
    5   

    +

    2.1. Packet Header

    Table 1. Telemetry Packet Header

    OffsetData TypeNameDescription
    0uint16_tserialDevice serial Number
    2uint16_ttickDevice time in 100ths of a second
    4uint8_ttypePacket type
    5   

    Each packet starts with these five bytes which serve to identify which device has transmitted the packet, when it was transmitted and what the rest of the packet contains. -

    2.2. Sensor Data

    TypeDescription
    0x01TeleMetrum Sensor Data
    0x02TeleMini Sensor Data
    0x03TeleNano Sensor Data

    +

    2.2. Sensor Data

    TypeDescription
    0x01TeleMetrum Sensor Data
    0x02TeleMini Sensor Data
    0x03TeleNano Sensor Data

    TeleMetrum, TeleMini and TeleNano share this same packet format for sensor data. Each uses a distinct packet type so that the receiver knows which data values are valid and which @@ -38,63 +38,63 @@ Sensor Data packets are transmitted once per second on the ground, 10 times per second during ascent and once per second during descent and landing -

    Table 2. Sensor Packet Contents

    OffsetData TypeNameDescription
    5uint8_tstateFlight state
    6int16_taccelaccelerometer (TM only)
    8int16_tprespressure sensor
    10int16_ttemptemperature sensor
    12int16_tv_battbattery voltage
    14int16_tsense_ddrogue continuity sense (TM/Tm)
    16int16_tsense_mmain continuity sense (TM/Tm)
    18int16_taccelerationm/s² * 16
    20int16_tspeedm/s * 16
    22int16_theightm
    24int16_tground_presAverage barometer reading on ground
    26int16_tground_accelTM
    28int16_taccel_plus_gTM
    30int16_taccel_minus_gTM
    32   

    2.3. Configuration Data

    TypeDescription
    0x04Configuration Data

    +

    Table 2. Sensor Packet Contents

    OffsetData TypeNameDescription
    5uint8_tstateFlight state
    6int16_taccelaccelerometer (TM only)
    8int16_tprespressure sensor
    10int16_ttemptemperature sensor
    12int16_tv_battbattery voltage
    14int16_tsense_ddrogue continuity sense (TM/Tm)
    16int16_tsense_mmain continuity sense (TM/Tm)
    18int16_taccelerationm/s² * 16
    20int16_tspeedm/s * 16
    22int16_theightm
    24int16_tground_presAverage barometer reading on ground
    26int16_tground_accelTM
    28int16_taccel_plus_gTM
    30int16_taccel_minus_gTM
    32   

    2.3. Configuration Data

    TypeDescription
    0x04Configuration Data

    This provides a description of the software installed on the flight computer as well as any user-specified configuration data.

    Configuration data packets are transmitted once per second during all phases of the flight -

    Table 3. Sensor Packet Contents

    OffsetData TypeNameDescription
    5uint8_ttypeDevice type
    6uint16_tflightFlight number
    8uint8_tconfig_majorConfig major version
    9uint8_tconfig_minorConfig minor version
    10uint16_tapogee_delayApogee deploy delay in seconds
    12uint16_tmain_deployMain deploy alt in meters
    14uint16_tflight_log_maxMaximum flight log size (kB)
    16charcallsign[8]Radio operator identifier
    24charversion[8]Software version identifier
    32   

    2.4. GPS Location

    TypeDescription
    0x05GPS Location

    +

    Table 3. Sensor Packet Contents

    OffsetData TypeNameDescription
    5uint8_ttypeDevice type
    6uint16_tflightFlight number
    8uint8_tconfig_majorConfig major version
    9uint8_tconfig_minorConfig minor version
    10uint16_tapogee_delayApogee deploy delay in seconds
    12uint16_tmain_deployMain deploy alt in meters
    14uint16_tflight_log_maxMaximum flight log size (kB)
    16charcallsign[8]Radio operator identifier
    24charversion[8]Software version identifier
    32   

    2.4. GPS Location

    TypeDescription
    0x05GPS Location

    This packet provides all of the information available from the Venus SkyTraq GPS receiver—position, time, speed and precision estimates.

    GPS Location packets are transmitted once per second during all phases of the flight -

    Table 4. GPS Location Packet Contents

    OffsetData TypeNameDescription
    5uint8_tflagsSee GPS Flags table below
    6int16_taltitudem
    8int32_tlatitudedegrees * 107
    12int32_tlongitudedegrees * 107
    16uint8_tyear 
    17uint8_tmonth 
    18uint8_tday 
    19uint8_thour 
    20uint8_tminute 
    21uint8_tsecond 
    22uint8_tpdop* 5
    23uint8_thdop* 5
    24uint8_tvdop* 5
    25uint8_tmodeSee GPS Mode table below
    26uint16_tground_speedcm/s
    28int16_tclimb_ratecm/s
    30uint8_tcourse/ 2
    31uint8_tunused[1] 
    32   

    +

    Table 4. GPS Location Packet Contents

    OffsetData TypeNameDescription
    5uint8_tflagsSee GPS Flags table below
    6int16_taltitudem
    8int32_tlatitudedegrees * 107
    12int32_tlongitudedegrees * 107
    16uint8_tyear 
    17uint8_tmonth 
    18uint8_tday 
    19uint8_thour 
    20uint8_tminute 
    21uint8_tsecond 
    22uint8_tpdop* 5
    23uint8_thdop* 5
    24uint8_tvdop* 5
    25uint8_tmodeSee GPS Mode table below
    26uint16_tground_speedcm/s
    28int16_tclimb_ratecm/s
    30uint8_tcourse/ 2
    31uint8_tunused[1] 
    32   

    Packed into a one byte field are status flags and the count of satellites used to compute the position fix. Note that this number may be lower than the number of satellites being tracked; the receiver will not use information from satellites with weak signals or which are close enough to the horizon to have significantly degraded position accuracy. -

    Table 5. GPS Flags

    BitsNameDescription
    0-3nsatsNumber of satellites in solution
    4validGPS solution is valid
    5runningGPS receiver is operational
    6date_validReported date is valid
    7course_validground speed, course and climb rates are valid

    +

    Table 5. GPS Flags

    BitsNameDescription
    0-3nsatsNumber of satellites in solution
    4validGPS solution is valid
    5runningGPS receiver is operational
    6date_validReported date is valid
    7course_validground speed, course and climb rates are valid

    Here are all of the valid GPS operational modes. Altus Metrum products will only ever report 'N' (not valid), 'A' (Autonomous) modes or 'E' (Estimated). The remaining modes are either testing modes or require additional data. -

    Table 6. GPS Mode

    ModeNameDecsription
    NNot ValidAll data are invalid
    AAutonomous modeData are derived from satellite data
    DDifferential Mode +

    Table 6. GPS Mode

    ModeNameDecsription
    NNot ValidAll data are invalid
    AAutonomous modeData are derived from satellite data
    DDifferential Mode Data are augmented with differential data from a known ground station. The SkyTraq unit in TeleMetrum does not support this mode
    EEstimated Data are estimated using dead reckoning from the last known data -
    MManualData were entered manually
    SSimulatedGPS receiver testing mode

    2.5. GPS Satellite Data

    TypeDescription
    0x06GPS Satellite Data

    +

    MManualData were entered manually
    SSimulatedGPS receiver testing mode

    2.5. GPS Satellite Data

    TypeDescription
    0x06GPS Satellite Data

    This packet provides space vehicle identifiers and signal quality information in the form of a C/N1 number for up to 12 satellites. The order of the svids is not specified.

    GPS Satellite data are transmitted once per second during all phases of the flight. -

    Table 7. GPS Satellite Data Contents

    OffsetData TypeNameDescription
    5uint8_tchannelsNumber of reported satellite information
    6sat_info_tsats[12]See Per-Satellite data table below
    30uint8_tunused[2] 
    32   

    Table 8. GPS Per-Satellite data (sat_info_t)

    OffsetData TypeNameDescription
    0uint8_tsvidSpace Vehicle Identifier
    1uint8_tc_n_1C/N1 signal quality indicator
    2   

    3. Data Transmission

    +

    Table 7. GPS Satellite Data Contents

    OffsetData TypeNameDescription
    5uint8_tchannelsNumber of reported satellite information
    6sat_info_tsats[12]See Per-Satellite data table below
    30uint8_tunused[2] 
    32   

    Table 8. GPS Per-Satellite data (sat_info_t)

    OffsetData TypeNameDescription
    0uint8_tsvidSpace Vehicle Identifier
    1uint8_tc_n_1C/N1 signal quality indicator
    2   

    3. Data Transmission

    Altus Metrum devices use the Texas Instruments CC1111 microcontroller which includes an integrated sub-GHz digital transceiver. This transceiver is used to both transmit and receive the telemetry packets. This section discusses what modulation scheme is used and how this device is configured. -

    3.1. Modulation Scheme

    +

    3.1. Modulation Scheme

    Texas Instruments provides a tool for computing modulation parameters given a desired modulation format and basic bit rate. For AltOS, the basic bit rate was specified as 38 kBaud, resulting in the following signal parmeters: -

    Table 9. 

    ParameterValueDescription
    ModulationGFSKGaussian Frequency Shift Keying
    Deviation20.507812 kHzFrequency modulation
    Data rate38.360596 kBaudRaw bit rate
    RX Filter Bandwidth93.75 kHzReceiver Band pass filter bandwidth
    IF Frequency140.62 kHzReceiver intermediate frequency

    3.2. Error Correction

    +

    Table 9. 

    ParameterValueDescription
    ModulationGFSKGaussian Frequency Shift Keying
    Deviation20.507812 kHzFrequency modulation
    Data rate38.360596 kBaudRaw bit rate
    RX Filter Bandwidth93.75 kHzReceiver Band pass filter bandwidth
    IF Frequency140.62 kHzReceiver intermediate frequency

    3.2. Error Correction

    The cc1111 provides forward error correction in hardware, which AltOS uses to improve reception of weak signals. The overall effect of this is to halve the available bandwidth for data from 38 kBaud to 19 kBaud. -

    Table 10. 

    ParameterValueDescription
    Error CorrectionConvolutional coding FEC1/2 code, constraint length m=4
    Interleaving4 x 4Reduce effect of noise burst
    Data WhiteningXOR with 9-bit PNRRotate right with bit 8 = bit 0 xor bit 5, initial - value 111111111

    4. TeleDongle packet format

    +

    Table 10. 

    ParameterValueDescription
    Error CorrectionConvolutional coding FEC1/2 code, constraint length m=4
    Interleaving4 x 4Reduce effect of noise burst
    Data WhiteningXOR with 9-bit PNRRotate right with bit 8 = bit 0 xor bit 5, initial + value 111111111

    4. TeleDongle packet format

    TeleDongle does not do any interpretation of the packet data, instead it is configured to receive packets of a specified length (32 bytes in this case). For each received packet, @@ -106,9 +106,9 @@ the packet data, two bytes added by the cc1111 radio receiver hardware and finally a checksum so that the host software can validate that the line was transmitted without any errors. -

    Table 11. 

    OffsetNameExampleDescription
    0length22Total length of data bytes in the line. Note that +

    Table 11. 

    OffsetNameExampleDescription
    0length22Total length of data bytes in the line. Note that this includes the added RSSI and status bytes
    1 ·· length-3packet4f ·· 00Bytes of actual packet data
    length-2rssi3fReceived signal strength. dBm = rssi / 2 - 74
    length-1lqia9Link Quality Indicator and CRC status. Bit 7 - is set when the CRC is correct
    lengthchecksum88(0x5a + sum(bytes 1 ·· length-1)) % 256

    5. History and Motivation

    + is set when the CRC is correct

    lengthchecksum88(0x5a + sum(bytes 1 ·· length-1)) % 256

    5. History and Motivation

    The original AltoOS telemetry mechanism encoded everything available piece of information on the TeleMetrum hardware into a single unified packet. Initially, the packets contained very diff --git a/AltOS/doc/telemetry.pdf b/AltOS/doc/telemetry.pdf index 1556094..987f01d 100644 Binary files a/AltOS/doc/telemetry.pdf and b/AltOS/doc/telemetry.pdf differ diff --git a/AltOS/launch-sites.txt b/AltOS/launch-sites.txt index 4082a2e..48a1c8c 100644 --- a/AltOS/launch-sites.txt +++ b/AltOS/launch-sites.txt @@ -1,3 +1,4 @@ +4 Corners Rocketry Association:36.50965:-107.830711: Advanced Rocketry Queensland:-27.82533:151.48001:http://advrocketry.com AARC South Australia:-35.092063:140.014786:http://www.australianrocketryclub.com.au/forum/index.php/board,28.0.html AHPRA BALLS:40.808:-119.15:http://www.ahpra.org diff --git a/EasyMini.mdwn b/EasyMini.mdwn new file mode 100644 index 0000000..2092a44 --- /dev/null +++ b/EasyMini.mdwn @@ -0,0 +1 @@ +[[!map pages="EasyMini/* and ! EasyMini/*/*"]] diff --git a/EasyMini/index.mdwn b/EasyMini/index.mdwn new file mode 100644 index 0000000..41b1c61 --- /dev/null +++ b/EasyMini/index.mdwn @@ -0,0 +1,61 @@ +# EasyMini + +This is a small, baro-only recording dual-deploy altimeter for +model rocketry + +EasyMini is currently in development, with a handful of prototype +boards built and flown. Production units will eventually be available from the +[Garbee and Garbee](http://auric.gag.com) web +store. + +For the latest EasyMini firmware and related ground station software, please +visit the [AltOS](../AltOS) page on this site. + +These are photos of our current prototype version: + + + + +## Features ## + +### User View ### + +* Recording altimeter for model rocketry +* Supports dual deployment (can fire 2 ejection charges) +* Barometric pressure sensor good to 100k feet MSL +* Designed to use a battery supplying 3.7V-12V. +* 1.5 x 0.8 inch board designed to fit inside 24mm airframe coupler tube +* 2MB on-board data logging flash + +### Developer View ### + +* Hardware Features + * [NXP LPC11U14](http://www.nxp.com/products/microcontrollers/cortex_m0_m0/LPC11U14FHI33.html) System-on-Chip + * ARM Cortex-M0 MCU + * 32k Flash + * 6k RAM + * USB 2.0 + * 8 12-bit analog inputs + * I2C, SPI, async serial + * digital I/O + * [Measurement Specialties MS5607](http://www.meas-spec.com/product/pressure/MS5607-02BA03.aspx) pressure sensor + * 1MB SPI flash +* Software Features + * Written mostly in C with some ARM assembler + * Runs from on-chip flash, uses on-chip RAM, stores flight data to + flash memory part +* Tools Used + * [gEDA](http://www.gpleda.org/) for schematic capture and PCB layout + * [GCC](http://gcc.gnu.org/) compiler and source debugger +* Licenses + * The hardware is licensed under the [TAPR](http://www.tapr.org) [Open Hardware License](http://www.tapr.org/ohl.html) + * The software is licensed [GPL version 2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html) + +## Artifacts ## + +There is a single manual for EasyMini and all other Altus Metrum products, +which is available in [html](../AltOS/doc/altusmetrum.html) and +[pdf](../AltOS/doc/altusmetrum.pdf) formats. + +The hardware design files can be found on [git.gag.com](http://git.gag.com) +in the project [hw/easymini](http://git.gag.com/?p=hw/easymini;a=summary). diff --git a/EasyMini/v0.2.mdwn b/EasyMini/v0.2.mdwn new file mode 100644 index 0000000..453e346 --- /dev/null +++ b/EasyMini/v0.2.mdwn @@ -0,0 +1 @@ +[[!map pages="EasyMini/v0.2/* and ! EasyMini/v0.2/*/*"]] diff --git a/EasyMini/v0.2/easymini-parts-thumb.jpg b/EasyMini/v0.2/easymini-parts-thumb.jpg new file mode 100644 index 0000000..ec79fc0 Binary files /dev/null and b/EasyMini/v0.2/easymini-parts-thumb.jpg differ diff --git a/EasyMini/v0.2/easymini-parts.jpg b/EasyMini/v0.2/easymini-parts.jpg new file mode 100644 index 0000000..724d4ea Binary files /dev/null and b/EasyMini/v0.2/easymini-parts.jpg differ diff --git a/EasyMini/v0.2/easymini-top-thumb.jpg b/EasyMini/v0.2/easymini-top-thumb.jpg new file mode 100644 index 0000000..f018f15 Binary files /dev/null and b/EasyMini/v0.2/easymini-top-thumb.jpg differ diff --git a/EasyMini/v0.2/easymini-top.jpg b/EasyMini/v0.2/easymini-top.jpg new file mode 100644 index 0000000..2b9e0a3 Binary files /dev/null and b/EasyMini/v0.2/easymini-top.jpg differ diff --git a/TeleGPS.mdwn b/TeleGPS.mdwn new file mode 100644 index 0000000..b91aeb8 --- /dev/null +++ b/TeleGPS.mdwn @@ -0,0 +1 @@ +[[!map pages="TeleGPS/* and ! TeleGPS/*/*"]] diff --git a/TeleGPS/index.mdwn b/TeleGPS/index.mdwn new file mode 100644 index 0000000..7d4a163 --- /dev/null +++ b/TeleGPS/index.mdwn @@ -0,0 +1,61 @@ +# TeleGPS + +This is a GPS-based position tracker and logger. + +TeleGPS is currently in development, with a handful of prototype +boards built. Production units will eventually be available from the +[Garbee and Garbee](http://auric.gag.com) web +store. + +For the latest TeleGPS firmware and related ground station software, please +visit the [AltOS](../AltOS) page on this site. + +These are photos of our current prototype version: + + + + +## Features ## + +### User View ### + +* GPS tracker and logger +* Offers custom digital telemetry, APRS and direction beacons +* High-dynamics GPS receiver for accurate tracking +* Uses 3.7V Lithium Polymer battery. +* 1.5 x 0.8 inch board designed to fit inside 24mm airframe coupler tube +* 2MB on-board data logging flash +* Built-in USB connection for configuration, data download and battery charging + +### Developer View ### + +* Hardware Features + * [NXP LPC11U14](http://www.nxp.com/products/microcontrollers/cortex_m0_m0/LPC11U14FHI33.html) System-on-Chip + * ARM Cortex-M0 MCU + * 32k Flash + * 6k RAM + * USB 2.0 + * 8 12-bit analog inputs + * I2C, SPI, async serial + * digital I/O + * [uBlox Max 7Q](http://www.u-blox.com/en/gps-modules/pvt-modules/max-7.html) GPS receiver + * 2MB SPI flash +* Software Features + * Written mostly in C with some ARM assembler + * Runs from on-chip flash, uses on-chip RAM, stores tracking data to + flash memory part +* Tools Used + * [gEDA](http://www.gpleda.org/) for schematic capture and PCB layout + * [GCC](http://gcc.gnu.org/) compiler and source debugger +* Licenses + * The hardware is licensed under the [TAPR](http://www.tapr.org) [Open Hardware License](http://www.tapr.org/ohl.html) + * The software is licensed [GPL version 2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html) + +## Artifacts ## + +There is a single manual for TeleGPS and all other Altus Metrum products, +which is available in [html](../AltOS/doc/altusmetrum.html) and +[pdf](../AltOS/doc/altusmetrum.pdf) formats. + +The hardware design files can be found on [git.gag.com](http://git.gag.com) +in the project [hw/telegps](http://git.gag.com/?p=hw/telegps;a=summary). diff --git a/TeleGPS/v0.3.mdwn b/TeleGPS/v0.3.mdwn new file mode 100644 index 0000000..9c149a6 --- /dev/null +++ b/TeleGPS/v0.3.mdwn @@ -0,0 +1 @@ +[[!map pages="TeleGPS/v0.3/* and ! TeleGPS/v0.3/*/*"]] diff --git a/TeleGPS/v0.3/telegps-parts-thumb.jpg b/TeleGPS/v0.3/telegps-parts-thumb.jpg new file mode 100644 index 0000000..f89bb1d Binary files /dev/null and b/TeleGPS/v0.3/telegps-parts-thumb.jpg differ diff --git a/TeleGPS/v0.3/telegps-parts.jpg b/TeleGPS/v0.3/telegps-parts.jpg new file mode 100644 index 0000000..088e9eb Binary files /dev/null and b/TeleGPS/v0.3/telegps-parts.jpg differ diff --git a/TeleGPS/v0.3/telegps-top-thumb.jpg b/TeleGPS/v0.3/telegps-top-thumb.jpg new file mode 100644 index 0000000..4b5f858 Binary files /dev/null and b/TeleGPS/v0.3/telegps-top-thumb.jpg differ diff --git a/TeleGPS/v0.3/telegps-top.jpg b/TeleGPS/v0.3/telegps-top.jpg new file mode 100644 index 0000000..fdeb0d4 Binary files /dev/null and b/TeleGPS/v0.3/telegps-top.jpg differ diff --git a/TeleMini/history.mdwn b/TeleMini/history.mdwn new file mode 100644 index 0000000..8074dd4 --- /dev/null +++ b/TeleMini/history.mdwn @@ -0,0 +1,62 @@ +# TeleMini History + +# TeleMini Version 1.0 # + +The very first TeleMini design became 1.0. It was a very small, +baro-only recording dual-deploy altimeter for model rocketry with +integrated telemetry link. + + + + +## Features ## + +### User View ### + +* Recording altimeter for model rocketry +* Supports dual deployment (can fire 2 ejection charges) +* 70cm ham-band transceiver for telemetry downlink +* Barometric pressure sensor good to 45k feet MSL +* Designed to use a single LiPo rechargeable battery +* 1.5 x 0.5 inch board designed to fit inside 18mm airframe coupler tube + +### Developer View ### + +* Hardware Features + * [TI CC1111F32](http://focus.ti.com/docs/prod/folders/print/cc1111f32.html) Low Power RF System-on-Chip + * Sub-1Ghz transceiver + * 8051 MCU + * 32k Flash + * 4k RAM + * USB 2.0 + * 6 12-bit analog inputs (11 bits with single-ended sensors) + * 2 channels of serial I/O + * digital I/O + * [Freescale MP3H6115A](http://www.freescale.com/webapp/search.partparamdetail.framework?PART_NUMBER=MP3H6115A6U) pressure sensor +* Software Features + * Written mostly in C with some 8051 assembler + * Runs from on-chip flash, uses on-chip RAM, stores flight data to + upper blocks of on-chip flash +* Tools Used + * [gEDA](http://www.gpleda.org/) for schematic capture and PCB layout + * [SDCC](http://sdcc.sourceforge.net/) compiler and source debugger +* Licenses + * The hardware is licensed under the [TAPR](http://www.tapr.org) [Open Hardware License](http://www.tapr.org/ohl.html) + * The software is licensed [GPL version 2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html) + +## Artifacts ## + +There is a single manual for TeleMini and all other Altus Metrum products, +which is available in [html](../AltOS/doc/altusmetrum.html) and +[pdf](../AltOS/doc/altusmetrum.pdf) formats. + +The hardware design files can be found on [git.gag.com](http://git.gag.com) +in the project [hw/telemini](http://git.gag.com/?p=hw/telemini;a=summary). + +For those who don't have ready access to the gEDA suite, here are pdf snapshots +of the files for Production PCB version 1.0 in more easily readable form. + +* [schematic](v1.0/telemini.pdf) +* [pcb artwork](v1.0/telemini.pcb.pdf) +* [bill of materials](v1.0/partslist.csv) + diff --git a/TeleMini/index.mdwn b/TeleMini/index.mdwn index 5a783cb..ee861c3 100644 --- a/TeleMini/index.mdwn +++ b/TeleMini/index.mdwn @@ -1,31 +1,30 @@ -# TeleMini +# TeleMini # -This is a very small, baro-only recording dual-deploy altimeter for -model rocketry with integrated telemetry link. - -Production units are available from the -[Garbee and Garbee](http://auric.gag.com) web -store. TeleMini starter kits are also available from -[Apogee Components](http://www.apogeerockets.com/Altus_Metrum_telemini.asp). +TeleMini version 2.0 is a small, baro-only recording dual-deploy +altimeter for model rocketry with integrated telemetry link. It's +currently in development, with production planned to start in the fall +of 2013. For the latest TeleMini firmware and related ground station software, please visit the [AltOS](../AltOS) page on this site. -These are photos of our current production version: +These are photos of our current prototype version: - - + + ## Features ## ### User View ### -* Recording altimeter for model rocketry -* Supports dual deployment (can fire 2 ejection charges) -* 70cm ham-band transceiver for telemetry downlink -* Barometric pressure sensor good to 45k feet MSL -* Designed to use a single LiPo rechargeable battery -* 1.5 x 0.5 inch board designed to fit inside 18mm airframe coupler tube + * Recording altimeter for model rocketry + * Supports dual deployment (can fire 2 ejection charges) + * 70cm ham-band transceiver for telemetry downlink + * Barometric pressure sensor good to 100k' feet MSL + * Designed to use any battery from 3.7 - 12V + * Screw terminals for pyro connectors, switch and external battery + * Built-in USB connector for configuration and data download + * 1.5 x 0.8 inch board designed to fit inside 24mm airframe coupler tube ### Developer View ### @@ -39,11 +38,12 @@ These are photos of our current production version: * 6 12-bit analog inputs (11 bits with single-ended sensors) * 2 channels of serial I/O * digital I/O - * [Freescale MP3H6115A](http://www.freescale.com/webapp/search.partparamdetail.framework?PART_NUMBER=MP3H6115A6U) pressure sensor + * [Measurement Specialties MS5607](http://www.meas-spec.com/product/pressure/MS5607-02BA03.aspx) pressure sensor + * 1MB SPI flash * Software Features * Written mostly in C with some 8051 assembler * Runs from on-chip flash, uses on-chip RAM, stores flight data to - upper blocks of on-chip flash + on-board flash memory * Tools Used * [gEDA](http://www.gpleda.org/) for schematic capture and PCB layout * [SDCC](http://sdcc.sourceforge.net/) compiler and source debugger @@ -60,10 +60,4 @@ which is available in [html](../AltOS/doc/altusmetrum.html) and The hardware design files can be found on [git.gag.com](http://git.gag.com) in the project [hw/telemini](http://git.gag.com/?p=hw/telemini;a=summary). -For those who don't have ready access to the gEDA suite, here are pdf snapshots -of the files for Production PCB version 1.0 in more easily readable form. - -* [schematic](v1.0/telemini.pdf) -* [pcb artwork](v1.0/telemini.pcb.pdf) -* [bill of materials](v1.0/partslist.csv) - +## [History of TeleMini](history) ## diff --git a/TeleMini/v1.2.mdwn b/TeleMini/v1.2.mdwn new file mode 100644 index 0000000..b1b4a5a --- /dev/null +++ b/TeleMini/v1.2.mdwn @@ -0,0 +1 @@ +[[!map pages="TeleMini/v1.2/* and ! TeleMini/v1.2/*/*"]] diff --git a/TeleMini/v2.0.mdwn b/TeleMini/v2.0.mdwn new file mode 100644 index 0000000..bc7a228 --- /dev/null +++ b/TeleMini/v2.0.mdwn @@ -0,0 +1 @@ +[[!map pages="TeleMini/v2.0/* and ! TeleMini/v2.0/*/*"]] diff --git a/TeleMini/v2.0/telemini-parts-thumb.jpg b/TeleMini/v2.0/telemini-parts-thumb.jpg new file mode 100644 index 0000000..cc56555 Binary files /dev/null and b/TeleMini/v2.0/telemini-parts-thumb.jpg differ diff --git a/TeleMini/v2.0/telemini-parts.jpg b/TeleMini/v2.0/telemini-parts.jpg new file mode 100644 index 0000000..08adf3b Binary files /dev/null and b/TeleMini/v2.0/telemini-parts.jpg differ diff --git a/TeleMini/v2.0/telemini-top-thumb.jpg b/TeleMini/v2.0/telemini-top-thumb.jpg new file mode 100644 index 0000000..aa47526 Binary files /dev/null and b/TeleMini/v2.0/telemini-top-thumb.jpg differ diff --git a/TeleMini/v2.0/telemini-top.jpg b/TeleMini/v2.0/telemini-top.jpg new file mode 100644 index 0000000..bc8ae45 Binary files /dev/null and b/TeleMini/v2.0/telemini-top.jpg differ diff --git a/index.mdwn b/index.mdwn index 9c4866a..1a2ec6e 100644 --- a/index.mdwn +++ b/index.mdwn @@ -82,17 +82,25 @@ These are projects we're working on that may become products someday: is the name of the firmware and related utilities that Keith maintains for the set of hardware projects here. +* [EasyMini](EasyMini/) +is a small dual-deploy rocketry altimeter using the MS5607 barometry +pressure sensor. + * [MegaDongle](MegaDongle/) is a higher-performance alternative to [TeleDongle](TeleDongle/). -* [TeleMega](TeleMega/) -is a high-end flight computer with 6 pyro channels, more and better sensors, -GPS, and a high performance bidirectional RF telemetry link. - * [OpenAlt](OpenAlt/) was Bdale's original project here, a dual-deploy rocketry altimeter. One prototype was built, but never flown. This project is now indefinitely on hold. +* [TeleGPS](TeleGPS/) +is a GPS tracker and logger using the uBlox Max 7Q GPS receiver for +high dynamic performance and a combination digital/APRS transmitter. + +* [TeleMega](TeleMega/) +is a high-end flight computer with 6 pyro channels, more and better sensors, +GPS, and a high performance bidirectional RF telemetry link. + * [TeleNano](TeleNano/) is a tiny rocketry altimeter with telemetry using only a barometric pressure sensor diff --git a/production.mdwn b/production.mdwn index f5930a3..aa12bcc 100644 --- a/production.mdwn +++ b/production.mdwn @@ -303,6 +303,10 @@ TeleMetrum v1.9 2013.08.27 TeleMega v0.4 P 2013.08.28 +## sn 96 ## + +TeleMini v1.1 2013.08.25. From Phoenix panel. + ## sn 100-207 ## First production run of 108 pieces of TeleDongle v0.2 by