From dc43d6dff4db11dbccaf9880fcde4f2ef5c3d4b1 Mon Sep 17 00:00:00 2001 From: Bdale Garbee Date: Sun, 18 Mar 2018 16:18:53 -0600 Subject: update docs --- AltOS/doc/easymini.html | 81 +++++++++++++++++++++++++++---------------------- 1 file changed, 45 insertions(+), 36 deletions(-) (limited to 'AltOS/doc/easymini.html') diff --git a/AltOS/doc/easymini.html b/AltOS/doc/easymini.html index 03820f4..f1079cc 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.8.4
F.1.1. AltOS
F.2. Release Notes for Version 1.8.3
F.2.1. AltOS
F.2.2. AltosUI and TeleGPS Applications
F.3. Release Notes for Version 1.8.2
F.3.1. AltOS
F.3.2. AltosUI and TeleGPS Applications
F.4. Release Notes for Version 1.8.1
F.4.1. AltOS
F.4.2. AltosUI and TeleGPS Applications
F.5. Release Notes for Version 1.8
F.5.1. AltOS
F.5.2. AltosUI and TeleGPS Applications
F.6. Release Notes for Version 1.7
F.6.1. AltOS
F.6.2. AltosUI and TeleGPS Applications
F.7. Release Notes for Version 1.6.8
F.7.1. AltOS
F.7.2. AltosUI, TeleGPS and AltosDroid Applications
F.8. Release Notes for Version 1.6.5
F.8.1. AltOS
F.8.2. AltosUI, TeleGPS and AltosDroid Applications
F.9. Release Notes for Version 1.6.4
F.9.1. AltOS
F.9.2. AltosUI, TeleGPS and AltosDroid Applications
F.9.3. Documentation
F.10. Release Notes for Version 1.6.3
F.10.1. AltOS
F.10.2. AltosUI and TeleGPS Applications
F.10.3. AltosDroid
F.10.4. Documentation
F.11. Release Notes for Version 1.6.2
F.11.1. AltOS
F.11.2. AltosUI and TeleGPS Applications
F.11.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.5
F.1.1. AltOS
F.1.2. AltosUI, TeleGPS
F.2. Release Notes for Version 1.8.4
F.2.1. AltOS
F.3. Release Notes for Version 1.8.3
F.3.1. AltOS
F.3.2. AltosUI and TeleGPS Applications
F.4. Release Notes for Version 1.8.2
F.4.1. AltOS
F.4.2. AltosUI and TeleGPS Applications
F.5. Release Notes for Version 1.8.1
F.5.1. AltOS
F.5.2. AltosUI and TeleGPS Applications
F.6. Release Notes for Version 1.8
F.6.1. AltOS
F.6.2. AltosUI and TeleGPS Applications
F.7. Release Notes for Version 1.7
F.7.1. AltOS
F.7.2. AltosUI and TeleGPS Applications
F.8. Release Notes for Version 1.6.8
F.8.1. AltOS
F.8.2. AltosUI, TeleGPS and AltosDroid Applications
F.9. Release Notes for Version 1.6.5
F.9.1. AltOS
F.9.2. AltosUI, TeleGPS and AltosDroid Applications
F.10. Release Notes for Version 1.6.4
F.10.1. AltOS
F.10.2. AltosUI, TeleGPS and AltosDroid Applications
F.10.3. Documentation
F.11. Release Notes for Version 1.6.3
F.11.1. AltOS
F.11.2. AltosUI and TeleGPS Applications
F.11.3. AltosDroid
F.11.4. Documentation
F.12. Release Notes for Version 1.6.2
F.12.1. AltOS
F.12.2. AltosUI and TeleGPS Applications
F.12.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, @@ -661,13 +661,22 @@ 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.8.4

Version 1.8.4 includes support for EasyMini version 2.0

F.1.1. AltOS

  • +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.5

Version 1.8.5 includes fixes to the ground software support +for TeleBT v4, along with a few other minor updates.

F.1.1. AltOS

  • +Fix startup beeps that indicate sensor failures. +

F.1.2. AltosUI, TeleGPS

  • +When updating device firmware, make sure selected firmware +matches target device. +
  • +Correct Bluetooth device matching when looking for TeleBT +devices. +

F.2. Release Notes for Version 1.8.4

Version 1.8.4 includes support for EasyMini version 2.0

F.2.1. AltOS

  • Support for EasyMini version 2.0 hardware. -

F.2. Release Notes for Version 1.8.3

Version 1.8.3 includes support for TeleMega version 3.0 along +

F.3. 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.2.1. AltOS

AltOS New Features

  • +downloading.

    F.3.1. AltOS

    AltOS New Features

    • Support for TeleMega version 3.0 hardware.

    AltOS Bug Fixes

    • Ground testing EasyMega and TeleMega additional pyro @@ -679,7 +688,7 @@ from capturing log data.
    • Fixed saving of pyro configuration that ended with Descending. -

    F.2.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • +

    F.3.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • Support for TeleMega version 3.0.
    • Graph lines have improved appearance to make them easier to @@ -703,18 +712,18 @@ to make it more useful for Tripoli record reporting.
    • CSV export now includes TeleMega/EasyMega pyro voltages and tilt angle. -

F.3. Release Notes for Version 1.8.2

Version 1.8.2 includes support for TeleGPS version 2.0 along +

F.4. 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.3.1. AltOS

AltOS New Features

  • +analyzing saved data files.

    F.4.1. AltOS

    AltOS New Features

    • Support for TeleGPS version 2.0 hardware. -

    F.3.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS New Features

    • +

    F.4.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.4. Release Notes for Version 1.8.1

Version 1.8.1 includes an important bug fix for Apogee Lockout +

F.5. 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 @@ -724,7 +733,7 @@ disregard the barometric sensor above 330m/s (around Mach 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.4.1. AltOS

AltOS Bug Fixes

  • +analyzing saved data files.

    F.5.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. @@ -733,7 +742,7 @@ 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.4.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • +

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

    • @@ -742,12 +751,12 @@ for graphing or KML export.
    • Load frequency preference at startup. The loading code was broken, so you’d see only the default frequencies. -

F.5. Release Notes for Version 1.8

Version 1.8 includes support for our new TeleBT v4.0 ground +

F.6. 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.5.1. AltOS

AltOS New Features

  • +boards and ground station interfaces.

    F.6.1. AltOS

    AltOS New Features

    • Add support for TeleBT v4.0 boards. -

    F.5.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • +

    F.6.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • Add support for TeleBT v4.0 hardware
    • Rewrite graphing and export functions. This code now handles @@ -758,20 +767,20 @@ 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.6. Release Notes for Version 1.7

Version 1.7 includes support for our new TeleMini v3.0 +

F.7. 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.6.1. AltOS

AltOS New Features

  • +and ground station interfaces.

    F.7.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.6.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • +

    F.7.2. AltosUI and TeleGPS Applications

    AltosUI New Features

    • Add support for TeleMini v3.0 hardware -

F.7. Release Notes for Version 1.6.8

Version 1.6.8 fixes a TeleMega and TeleMetrum v2.0 bug where +

F.8. 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.7.1. AltOS

AltOS fixes:

  • +v2.0 users should update their flight firmware.

    F.8.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. @@ -784,7 +793,7 @@ flight.

    AltOS changes:

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

    F.7.2. AltosUI, TeleGPS and AltosDroid Applications

    AltosUI fixes:

    • +

    F.8.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 @@ -792,20 +801,20 @@ disabled to never re-appear.
    • Deal with ground station failure better during Configure Ground Station operation by cleaning up pending operations. -

F.8. Release Notes for Version 1.6.5

Version 1.6.5 fixes a TeleMega and TeleMetrum v2.0 bug where +

F.9. 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.8.1. AltOS

AltOS fixes:

  • +v2.0 users should update their flight firmware.

    F.9.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.8.2. AltosUI, TeleGPS and AltosDroid Applications

    AltosUI fixes:

    • +

    F.9.2. AltosUI, TeleGPS and AltosDroid Applications

    AltosUI fixes:

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

F.9. Release Notes for Version 1.6.4

Version 1.6.4 fixes a bluetooth communication problem with +

F.10. 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.9.1. AltOS

AltOS fixes:

  • +minor nits. It also now ships firmware for some newer devices.

    F.10.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. @@ -813,7 +822,7 @@ 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.9.2. AltosUI, TeleGPS and AltosDroid Applications

    AltosUI, TeleGPS and AltosDroid New Features:

    • +

    F.10.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.
    • @@ -824,17 +833,17 @@ 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.9.3. Documentation

    • +

    F.10.3. Documentation

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

F.10. Release Notes for Version 1.6.3

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

F.11. 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.10.1. AltOS

AltOS fixes:

  • +along with BlueTooth support for Windows.

    F.11.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.10.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS New Features:

    • +

    F.11.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. @@ -856,7 +865,7 @@ the connected Altus Metrum USB devices appear again.
    • Fix acceleration data presented in MonitorIdle mode for TeleMetrum v2.0 flight computers. -

    F.10.3. AltosDroid

    AltosDroid new features:

    • +

    F.11.3. AltosDroid

    AltosDroid new features:

    • Monitor Idle mode. Check state of flight computer while in idle mode over the radio link
    • @@ -894,12 +903,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.10.4. Documentation

    • +

    F.11.4. Documentation

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

F.11. Release Notes for Version 1.6.2

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

F.12. 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.11.1. AltOS

AltOS New Features:

  • +and ground station interfaces.

    F.12.1. AltOS

    AltOS New Features:

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

    AltOS Fixes:

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

    F.11.2. AltosUI and TeleGPS Applications

    AltosUI and TeleGPS Fixes:

    • +

    F.12.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.11.3. Documentation

    We spent a bunch of time trying to improve our documentation

    • +

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