From 054f696fedf7799e005e8f06208c3aa4086b0cb4 Mon Sep 17 00:00:00 2001 From: Bdale Garbee Date: Mon, 11 Dec 2017 22:02:13 -0700 Subject: update docs --- AltOS/doc/easymini.html | 216 ++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 200 insertions(+), 16 deletions(-) (limited to 'AltOS/doc/easymini.html') diff --git a/AltOS/doc/easymini.html b/AltOS/doc/easymini.html index d19b32a..82f5b44 100644 --- a/AltOS/doc/easymini.html +++ b/AltOS/doc/easymini.html @@ -19,7 +19,7 @@ collaborators, and we certainly appreciate this level of contribution!

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

Bdale Garbee, KB0G
NAR #87103, TRA #12201

Keith Packard, KD7SQG
-NAR #88757, TRA #12200

Table of Contents

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

List of Figures

4.1. EasyMini Board
7.1. AltosUI Main Window
7.2. Flight Data Graph
7.3. Flight Graph Configuration
7.4. Flight Statistics
7.5. Altimeter Configuration
7.6. Configure AltosUI Dialog
7.7. Fire Igniter Window

List of Tables

3.1. AltOS Modes
3.2. Pad/Idle Indications
4.1. EasyMini Screw Terminals
D.1. Data Storage on Altus Metrum altimeters
E.1. Altus Metrum Flight Computer Electronics
E.2. Altus Metrum Flight Computer Mechanical Components

Chapter 1. Introduction and Overview

Welcome to the Altus Metrum community! Our circuits and software reflect +NAR #88757, TRA #12200

Table of Contents

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

List of Figures

4.1. EasyMini Board
7.1. AltosUI Main Window
7.2. Flight Data Graph
7.3. Flight Graph Configuration
7.4. Flight Statistics
7.5. Altimeter Configuration
7.6. Configure AltosUI Dialog
7.7. Fire Igniter Window

List of Tables

3.1. AltOS Modes
3.2. Pad/Idle Indications
4.1. EasyMini Screw Terminals
D.1. Data Storage on Altus Metrum altimeters
E.1. Altus Metrum Flight Computer Electronics
E.2. Altus Metrum Flight Computer Mechanical Components

Chapter 1. Introduction and Overview

Welcome to the Altus Metrum community! Our circuits and software reflect our passion for both hobby rocketry and Free Software. We hope their capabilities and performance will delight you in every way, but by releasing all of our hardware and software designs under open licenses, @@ -319,8 +319,27 @@ clicking and dragging allows the graph to be panned. The right mouse button causes a pop-up menu to be displayed, giving you the option save or print the plot.

7.3.2. Configure Graph

Figure 7.3. Flight Graph Configuration

graph-configure.png

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

7.3.3. Flight Statistics

Figure 7.4. Flight Statistics

graph-stats.png

Shows overall data computed from the flight.

7.4. Export Data

This tool takes the raw data files and makes them +very bottom. It also lets you configure how +the graph is drawn:

  • +Whether to use metric or imperial units +
  • +Whether to show a marker at each data +point. When displaying a small section of +the graph, these can be useful to know what +data values were recorded. +
  • +How wide to draw the lines in the graph +
  • +How to filter speed and acceleration data +computed from barometric data. Flight +computers with accelerometers never display +computed acceleration data, and only use +barometric data to compute speed during +descent. Flight computers without +accelerometers always compute both speed and +acceleration from barometric data. A larger +value smooths the data more. +

7.3.3. Flight Statistics

Figure 7.4. Flight Statistics

graph-stats.png

Shows overall data computed from the flight.

7.4. Export Data

This tool takes the raw data files and makes them available for external analysis. When you select this button, you are prompted to select a flight data file, which can be either a .eeprom or .telem. The .eeprom @@ -339,7 +358,7 @@ tools can be configured to skip over.

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

7.5. Configure Altimeter

Figure 7.5. Altimeter Configuration

configure-altimeter.png

Select this button and then select an altimeter.

The first few lines of the dialog provide information about the +both pressure, altitude and height above pad units.

7.5. Configure Altimeter

Figure 7.5. Altimeter Configuration

configure-altimeter.png

Select this button and then select an altimeter.

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

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

@@ -423,7 +442,7 @@ have more than one flight computer in a single airframe, having all of them sound at the same frequency can be confusing. This parameter lets you adjust the base beeper frequency -value.

7.6. Configure AltosUI

Figure 7.6. Configure AltosUI Dialog

configure-altosui.png

This button presents a dialog so that you can +value.

7.6. Configure AltosUI

Figure 7.6. Configure AltosUI Dialog

configure-altosui.png

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

7.6.1. Log Directory

AltosUI logs all telemetry data and saves all flash data to this directory. This directory is also used as the staring point @@ -457,7 +476,7 @@ EasyMini is programmed directly over USB (self programming). Please read the directions for flashing devices in -Appendix C, Updating Device Firmware.

7.8. Fire Igniter

Figure 7.7. Fire Igniter Window

fire-igniter.png

This activates the igniter circuits in the flight +Appendix C, Updating Device Firmware.

7.8. Fire Igniter

Figure 7.7. Fire Igniter Window

fire-igniter.png

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

Selecting the Fire Igniter button brings up the usual device selection dialog. Pick the desired @@ -623,7 +642,7 @@ during ascent and 10 samples per second during descent. Data are logged to an on-board flash memory part, which can be partitioned into -several equal-sized blocks, one for each flight.

Table D.1. Data Storage on Altus Metrum altimeters

Device Bytes per Sample Total Storage Minutes at Full Rate

EasyMini

16

1MB

10


The on-board flash is partitioned into separate flight logs, +several equal-sized blocks, one for each flight.

Table D.1. Data Storage on Altus Metrum altimeters

Device Bytes per Sample Total Storage Minutes at Full Rate

EasyMini

16

1MB

10


The on-board flash is partitioned into separate flight logs, each of a fixed maximum size. Increase the maximum size of each log and you reduce the number of flights that can be stored. Decrease the size and you can store more flights.

Configuration data is also stored in the flash memory on @@ -642,13 +661,178 @@ flight data, so be sure to download flight data and erase it from the flight computer before it fills up. The flight computer will still successfully control the flight even if it cannot log data, so the only thing you will lose is the data.

Appendix E. Altus Metrum Hardware Specifications

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

Table E.1. Altus Metrum Flight Computer Electronics

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

EasyMini v1.0

MS5607 30km (100k')

-

-

-

1MB

-

3.7-12V


Table E.2. Altus Metrum Flight Computer Mechanical Components

DeviceConnectorsScrew TerminalsWidthLengthTube Size

EasyMini

Debug USB Battery

Apogee pyro Main pyro Battery

0.8 inch (2.03cm)

1½ inch (3.81cm)

24mm coupler


Appendix F. Release Notes

F.1. Release Notes for Version 1.6.3

Version 1.6.3 adds idle mode to AltosDroid and has bug fixes +production and retired.

Table E.1. Altus Metrum Flight Computer Electronics

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

EasyMini v1.0

MS5607 30km (100k')

-

-

-

1MB

-

3.7-12V


Table E.2. Altus Metrum Flight Computer Mechanical Components

DeviceConnectorsScrew TerminalsWidthLengthTube Size

EasyMini

Debug USB Battery

Apogee pyro Main pyro Battery

0.8 inch (2.03cm)

1½ inch (3.81cm)

24mm coupler


Appendix F. Release Notes

F.1. Release Notes for Version 1.8.3

Version 1.8.3 includes support for TeleMega version 3.0 along +with two important flight computer fixes. This version also +changes KML export data to make Tripoli Record reporting +better and some updates to graph presentation and data +downloading.

F.1.1. AltOS

AltOS New Features

  • +Support for TeleMega version 3.0 hardware. +

AltOS Bug Fixes

  • +Ground testing EasyMega and TeleMega additional pyro +channels could result in a sticky fired status which would +prevent these channels from firing on future flights. +
  • +Corrupted flight log records could prevent future flights +from capturing log data. +
  • +Fixed saving of pyro configuration that ended with +Descending. +

F.1.2. AltosUI and TeleGPS Applications

AltosUI New Features

  • +Support for TeleMega version 3.0. +
  • +Graph lines have improved appearance to make them easier to +distinguish. Markers may be placed at data points to show +captured recorded data values. +
  • +Graphing offers the ability to adjust the smoothing of +computed speed and acceleration data. +
  • +The download dialog now offers to graph new flights, checks +for existing files to avoid overwriting data and reports if +there are checksum errors in the downloaded data. +

AltosUI/TeleGPS Bug Fixes

  • +Restore TeleGPS tracking behavior. +
  • +Display flight computer call sign and serial number in +Monitor Idle mode instead of ground station values. +

AltosUI and TeleGPS Changes

  • +KML export now reports both barometric and GPS altitude data +to make it more useful for Tripoli record reporting. +
  • +CSV export now includes TeleMega/EasyMega pyro voltages and +tilt angle. +

F.2. Release Notes for Version 1.8.2

Version 1.8.2 includes support for TeleGPS version 2.0 along +with accelerometer recalibration support in AltosUI.

1.8.2 also contains a couple of minor fixes for AltosUI when +analyzing saved data files.

F.2.1. AltOS

AltOS New Features

  • +Support for TeleGPS version 2.0 hardware. +

F.2.2. AltosUI and TeleGPS Applications

AltosUI and TeleGPS New Features

  • +Support for TeleGPS version 2.0. +
  • +Accelerometer re-calibration user interface. +

AltosUI and TeleGPS Bug Fixes

  • +Prevent some crashes when reading older saved flight data +for graphing or KML export. +

F.3. Release Notes for Version 1.8.1

Version 1.8.1 includes an important bug fix for Apogee Lockout +operation in all flight computers. Anyone using this option +must update firmware.

This release also contains a change in how flight computers +with accelerometers deal with speeds around and above Mach +1. In previous versions, the flight computer would completely +disregard the barometric sensor above 330m/s (around Mach +1). Now, the data from the barometric sensor is reduced in +effect without ever going away entirely. This prevents early +drogue deployment for flights which spend considerable time +above Mach 1.

1.8.1 also contains a couple of minor fixes for AltosUI when +analyzing saved data files.

F.3.1. AltOS

AltOS Bug Fixes

  • +Handle time value wrapping in Apogee Lockout +correctly. Without this, apogee lockout would sometimes +prevent any drogue charge from firing. +
  • +Change Kalman filter on flight computers with accelerometer +to continue using the barometric sensor even at high speeds +to avoid unintentional drogue deployment during +deceleration. +

F.3.2. AltosUI and TeleGPS Applications

AltosUI New Features

  • +Add new Huge font size to make text even bigger on high +resolution monitors. +

AltosUI Bug Fixes

  • +Prevent some crashes when reading older saved flight data +for graphing or KML export. +
  • +Load frequency preference at startup. The loading code was +broken, so you’d see only the default frequencies. +

F.4. Release Notes for Version 1.8

Version 1.8 includes support for our new TeleBT v4.0 ground +station, updates for data analysis in our ground station +software and bug fixes in in the flight software for all our +boards and ground station interfaces.

F.4.1. AltOS

AltOS New Features

  • +Add support for TeleBT v4.0 boards. +

F.4.2. AltosUI and TeleGPS Applications

AltosUI New Features

  • +Add support for TeleBT v4.0 hardware +
  • +Rewrite graphing and export functions. This code now handles +each data series separately so that graphs are drawn +correctly. Smoothing now uses a filter that looks both +forward and backwards in time to make computed speed and +acceleration data more accurate. +

AltosUI Bug Fixes

  • +Correct axis labeling of magnetic sensor in TeleMega and +EasyMega. The Y and Z axes were flipped. +

F.5. Release Notes for Version 1.7

Version 1.7 includes support for our new TeleMini v3.0 +flight computer and bug fixes in in the flight software for all our boards +and ground station interfaces.

F.5.1. AltOS

AltOS New Features

  • +Add support for TeleMini v3.0 boards. +

AltOS Fixes

  • +Fix interrupt priorities on STM32L processors. Run timer +interrupt at lowest priority so that device interrupts get +serviced first. +

F.5.2. AltosUI and TeleGPS Applications

AltosUI New Features

  • +Add support for TeleMini v3.0 hardware +

F.6. Release Notes for Version 1.6.8

Version 1.6.8 fixes a TeleMega and TeleMetrum v2.0 bug where +the device could stop logging data and transmitting +telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum +v2.0 users should update their flight firmware.

F.6.1. AltOS

AltOS fixes:

  • +Fix STM32L DMA driver to work around STM32L SoC DMA priority +issue t lock-up in the logging or radio code, either of +which could stop data logging and telemetry. +
  • +Avoid having TeleBT battery status values smash telemetry +packet data by holding a lock during both operations. +
  • +Don’t start reporting flight 0 when the log fills in +flight. +

AltOS changes:

  • +Flash LEDS on all products briefly during power up so that +they can be tested during production. +

F.6.2. AltosUI, TeleGPS and AltosDroid Applications

AltosUI fixes:

  • +Re-enable go/no-go entries after they’ve been disabled due +to lack of data. If telemetry information is delayed when +the Ui starts up, sometimes important fields would get +disabled to never re-appear. +
  • +Deal with ground station failure better during Configure +Ground Station operation by cleaning up pending operations. +

F.7. Release Notes for Version 1.6.5

Version 1.6.5 fixes a TeleMega and TeleMetrum v2.0 bug where +the device would often stop logging data and transmitting +telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum +v2.0 users should update their flight firmware.

F.7.1. AltOS

AltOS fixes:

  • +Fix STM32L SPI driver to prevent lock-up in the logging or +radio code, either of which could stop data logging and +telemetry. Found and characterized by Chuck Haskin, who also +tested the new firmware before release. +

F.7.2. AltosUI, TeleGPS and AltosDroid Applications

AltosUI fixes:

  • +Deliver firmward for TeleMega v2.0 and TeleBT v3.0 with +Windows package. +

F.8. Release Notes for Version 1.6.4

Version 1.6.4 fixes a bluetooth communication problem with +TeleBT v1.0 devices, along with some altosui and altosdroid +minor nits. It also now ships firmware for some newer devices.

F.8.1. AltOS

AltOS fixes:

  • +Fix hardware flow control on TeleBT v1.0. Hardware RTS/CTS +doesn’t seem to work, switch from using the hardware to +driving these pins with software. +
  • +Fix ARM USB drivers to deal with OS restarts. Needed to +reset all USB-related state when the USB bus is reset. These +fixes affect all STM32L, STM32F0 and LPC11U14 based devices. +

F.8.2. AltosUI, TeleGPS and AltosDroid Applications

AltosUI, TeleGPS and AltosDroid New Features:

  • +Automatically switch from meters or feet to kilometers or +miles for distance units. +
  • +Add Monitor Idle mode to TeleGPS application. +

AltosUI, TeleGPS and AltosDroid Fixes:

  • +Abort map preloading when the preload map dialog is closed. +
  • +In AltosDroid, Don’t reconnect to last device if the user +had disconnected it the last time the application was +active. +

F.8.3. Documentation

  • +Mention TeleMega v2.0 in hardware specs table. +
  • +Document TeleGPS RF output in telegps manual. +

F.9. Release Notes for Version 1.6.3

Version 1.6.3 adds idle mode to AltosDroid and has bug fixes for our host software on desktops, laptops an android devices -along with BlueTooth support for Windows.

F.1.1. AltOS

AltOS fixes:

  • +along with BlueTooth support for Windows.

    F.9.1. AltOS

    AltOS fixes:

    • Fix hardware flow control on TeleBT v3.0. RTS/CTS is wired backwards on this board, switch from using the hardware to driving these pins with software. -

    F.1.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS New Features:

    • +

    F.9.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS New Features:

    • Add BlueTooth support for Windows operating system. This supports connections to TeleBT over BlueTooth rather than just USB. @@ -670,7 +854,7 @@ the connected Altus Metrum USB devices appear again.
    • Fix acceleration data presented in MonitorIdle mode for TeleMetrum v2.0 flight computers. -

    F.1.3. AltosDroid

    AltosDroid new features:

    • +

    F.9.3. AltosDroid

    AltosDroid new features:

    • Monitor Idle mode. Check state of flight computer while in idle mode over the radio link
    • @@ -708,12 +892,12 @@ Recover old tracker positions when restarting application. This finally allows you to safely stop and restart the application without losing the last known location of any tracker. -

    F.1.4. Documentation

    • +

    F.9.4. Documentation

    • Document TeleMega and EasyMega additional pyro channel continuity audio alert pattern. -

F.2. Release Notes for Version 1.6.2

Version 1.6.2 includes support for our updated TeleMega v2.0 +

F.10. Release Notes for Version 1.6.2

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

F.2.1. AltOS

AltOS New Features:

  • +and ground station interfaces.

    F.10.1. AltOS

    AltOS New Features:

    • Add support for TeleMega v2.0 boards.
    • Add PWM servo driver. There’s no higher level code using @@ -722,14 +906,14 @@ servo output connector.

    AltOS Fixes:

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

    F.2.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS Fixes:

    • +

    F.10.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS Fixes:

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

    F.2.3. Documentation

    We spent a bunch of time trying to improve our documentation

    • +

    F.10.3. Documentation

    We spent a bunch of time trying to improve our documentation

    • HTML versions now have a table of contents on the left side.
    • EasyMini now has its own shorter manual. -- cgit v1.2.3