update docs
[web/altusmetrum] / AltOS / doc / telegps.html
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>TeleGPS Owner’s Manual</title><link rel="stylesheet" type="text/css" href="am.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /></head><body><div xml:lang="en" class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="idm1"></a>TeleGPS Owner’s Manual</h1></div><div><h2 class="subtitle">An Owner's Manual for the TeleGPS recording GPS tracker</h2></div><div><h3 class="corpauthor">
3   <span class="inlinemediaobject"><img src="telegps-oneline.svg" width="270" /></span>
4 </h3></div><div><div class="author"><h3 class="author"><span class="firstname">Bdale</span> <span class="surname">Garbee</span></h3><code class="email">&lt;<a class="email" href="mailto:bdale@gag.com">bdale@gag.com</a>&gt;</code></div></div><div><div class="author"><h3 class="author"><span class="firstname">Keith</span> <span class="surname">Packard</span></h3><code class="email">&lt;<a class="email" href="mailto:keithp@keithp.com">keithp@keithp.com</a>&gt;</code></div></div><div><p class="copyright">Copyright © 2018 Bdale Garbee and Keith Packard</p></div><div><div class="legalnotice"><a id="idm23"></a><p>
5     This document is released under the terms of the
6     <a class="ulink" href="http://creativecommons.org/licenses/by-sa/3.0/" target="_top">
7       Creative Commons ShareAlike 3.0
8     </a>
9     license.
10   </p></div></div><div><a href="telegps-revhistory.html">Revision History</a></div></div><hr /></div><div class="dedication"><div class="titlepage"><div><div><h1 class="title"><a id="_acknowledgments"></a>Acknowledgments</h1></div></div></div><p>Thanks to Anthony (AJ) Towns for major contributions including
11 the TeleGPS graphing and site map code and associated documentation.
12 Free software means that our customers and friends can become our
13 collaborators, and we certainly appreciate this level of
14 contribution!</p><p>Have fun using these products, and we hope to meet all of you
15 out on the rocket flight line somewhere.</p><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p>Bdale Garbee, KB0G<br />
16 NAR #87103, TRA #12201</p></div></blockquote></div><div class="blockquote"><blockquote class="blockquote"><div class="literallayout"><p>Keith Packard, KD7SQG<br />
17 NAR #88757, TRA #12200</p></div></blockquote></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="#_telegps_quick_start_guide">1. TeleGPS Quick Start Guide</a></span></dt><dt><span class="chapter"><a href="#_using_telegps_hardware">2. Using TeleGPS Hardware</a></span></dt><dd><dl><dt><span class="section"><a href="#_hooking_up_lithium_polymer_batteries">2.1. Hooking Up Lithium Polymer Batteries</a></span></dt><dt><span class="section"><a href="#_on_board_data_recording">2.2. On-board Data Recording</a></span></dt><dt><span class="section"><a href="#_installation">2.3. Installation</a></span></dt></dl></dd><dt><span class="chapter"><a href="#_telegps_application">3. TeleGPS Application</a></span></dt><dd><dl><dt><span class="section"><a href="#_telemetry_monitoring">3.1. Telemetry Monitoring</a></span></dt><dd><dl><dt><span class="section"><a href="#_map">3.1.1. Map</a></span></dt><dt><span class="section"><a href="#_location">3.1.2. Location</a></span></dt><dt><span class="section"><a href="#_status">3.1.3. Status</a></span></dt><dt><span class="section"><a href="#_table">3.1.4. Table</a></span></dt></dl></dd><dt><span class="section"><a href="#_telegps_menus">3.2. TeleGPS Menus</a></span></dt><dd><dl><dt><span class="section"><a href="#_new_window">3.2.1. New Window</a></span></dt></dl></dd><dt><span class="section"><a href="#_graph_data">3.3. Graph Data</a></span></dt><dd><dl><dt><span class="section"><a href="#_data_graph">3.3.1. Data Graph</a></span></dt><dt><span class="section"><a href="#_graph_configuration">3.3.2. Graph Configuration</a></span></dt><dt><span class="section"><a href="#_statistics">3.3.3. Statistics</a></span></dt><dt><span class="section"><a href="#_map_2">3.3.4. Map</a></span></dt></dl></dd><dt><span class="section"><a href="#_export_data">3.4. Export Data</a></span></dt><dd><dl><dt><span class="section"><a href="#_comma_separated_value_format">3.4.1. Comma Separated Value Format</a></span></dt><dt><span class="section"><a href="#_keyhole_markup_language_for_google_earth">3.4.2. Keyhole Markup Language (for Google Earth)</a></span></dt></dl></dd><dt><span class="section"><a href="#_load_maps">3.5. Load Maps</a></span></dt><dt><span class="section"><a href="#_preferences">3.6. Preferences</a></span></dt><dd><dl><dt><span class="section"><a href="#_voice_settings">3.6.1. Voice Settings</a></span></dt><dt><span class="section"><a href="#_log_directory">3.6.2. Log Directory</a></span></dt><dt><span class="section"><a href="#_callsign">3.6.3. Callsign</a></span></dt><dt><span class="section"><a href="#_imperial_units">3.6.4. Imperial Units</a></span></dt><dt><span class="section"><a href="#_serial_debug">3.6.5. Serial Debug</a></span></dt><dt><span class="section"><a href="#_font_size">3.6.6. Font size</a></span></dt><dt><span class="section"><a href="#_look_amp_feel">3.6.7. Look &amp; feel</a></span></dt><dt><span class="section"><a href="#_menu_position">3.6.8. Menu position</a></span></dt><dt><span class="section"><a href="#_map_cache_size">3.6.9. Map Cache Size</a></span></dt><dt><span class="section"><a href="#_manage_frequencies">3.6.10. Manage Frequencies</a></span></dt></dl></dd><dt><span class="section"><a href="#_close">3.7. Close</a></span></dt><dt><span class="section"><a href="#_exit">3.8. Exit</a></span></dt><dt><span class="section"><a href="#_connect_device">3.9. Connect Device</a></span></dt><dt><span class="section"><a href="#_disconnect">3.10. Disconnect</a></span></dt><dt><span class="section"><a href="#_scan_channels">3.11. Scan Channels</a></span></dt><dt><span class="section"><a href="#_download_data">3.12. Download Data</a></span></dt><dt><span class="section"><a href="#_configure_device">3.13. Configure Device</a></span></dt><dd><dl><dt><span class="section"><a href="#_frequency">3.13.1. Frequency</a></span></dt><dt><span class="section"><a href="#_rf_calibration">3.13.2. RF Calibration</a></span></dt><dt><span class="section"><a href="#_telemetry_rdf_aprs_enable">3.13.3. Telemetry/RDF/APRS Enable</a></span></dt><dt><span class="section"><a href="#_telemetry_baud_rate">3.13.4. Telemetry baud rate</a></span></dt><dt><span class="section"><a href="#_aprs_interval">3.13.5. APRS Interval</a></span></dt><dt><span class="section"><a href="#_aprs_ssid">3.13.6. APRS SSID</a></span></dt><dt><span class="section"><a href="#_aprs_format">3.13.7. APRS Format</a></span></dt><dt><span class="section"><a href="#_callsign_2">3.13.8. Callsign</a></span></dt><dt><span class="section"><a href="#_logging_trigger_motion">3.13.9. Logging Trigger Motion</a></span></dt><dt><span class="section"><a href="#_position_reporting_interval">3.13.10. Position Reporting Interval</a></span></dt></dl></dd><dt><span class="section"><a href="#_flash_device">3.14. Flash Device</a></span></dt></dl></dd><dt><span class="appendix"><a href="#_telegps_system_operation">A. TeleGPS System Operation</a></span></dt><dd><dl><dt><span class="section"><a href="#_gfsk_telemetry">A.1. GFSK Telemetry</a></span></dt><dt><span class="section"><a href="#_aprs">A.2. APRS</a></span></dt><dt><span class="section"><a href="#_configurable_parameters">A.3. Configurable Parameters</a></span></dt></dl></dd><dt><span class="appendix"><a href="#_handling_precautions">B. Handling Precautions</a></span></dt><dt><span class="appendix"><a href="#_technical_information">C. Technical Information</a></span></dt><dd><dl><dt><span class="section"><a href="#_gps_receiver">C.1. GPS Receiver</a></span></dt><dt><span class="section"><a href="#_70cm_transmitter">C.2. 70cm Transmitter</a></span></dt><dt><span class="section"><a href="#_micro_controller">C.3. Micro-controller</a></span></dt><dt><span class="section"><a href="#_lithium_polymer_battery">C.4. Lithium Polymer Battery</a></span></dt><dt><span class="section"><a href="#_mechanical_considerations">C.5. Mechanical Considerations</a></span></dt><dt><span class="section"><a href="#_on_board_data_storage">C.6. On-board data storage</a></span></dt></dl></dd><dt><span class="appendix"><a href="#_updating_device_firmware">D. Updating Device Firmware</a></span></dt><dd><dl><dt><span class="section"><a href="#_updating_telegps_firmware">D.1. Updating TeleGPS Firmware</a></span></dt></dl></dd><dt><span class="appendix"><a href="#_release_notes">E. Release Notes</a></span></dt><dd><dl><dt><span class="section"><a href="#_release_notes_for_version_1_8_6">E.1. Release Notes for Version 1.8.6</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos">E.1.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_telegps">E.1.2. AltosUI, TeleGPS</a></span></dt><dt><span class="section"><a href="#_micropeak">E.1.3. MicroPeak</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_8_5">E.2. Release Notes for Version 1.8.5</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_2">E.2.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_telegps_2">E.2.2. AltosUI, TeleGPS</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_8_4">E.3. Release Notes for Version 1.8.4</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_3">E.3.1. AltOS</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_8_3">E.4. Release Notes for Version 1.8.3</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_4">E.4.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications">E.4.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_8_2">E.5. Release Notes for Version 1.8.2</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_5">E.5.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_2">E.5.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_8_1">E.6. Release Notes for Version 1.8.1</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_6">E.6.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_3">E.6.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_8">E.7. Release Notes for Version 1.8</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_7">E.7.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_4">E.7.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_7">E.8. Release Notes for Version 1.7</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_8">E.8.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_5">E.8.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6_8">E.9. Release Notes for Version 1.6.8</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_9">E.9.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_telegps_and_altosdroid_applications">E.9.2. AltosUI, TeleGPS and AltosDroid Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6_5">E.10. Release Notes for Version 1.6.5</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_10">E.10.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_telegps_and_altosdroid_applications_2">E.10.2. AltosUI, TeleGPS and AltosDroid Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6_4">E.11. Release Notes for Version 1.6.4</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_11">E.11.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_telegps_and_altosdroid_applications_3">E.11.2. AltosUI, TeleGPS and AltosDroid Applications</a></span></dt><dt><span class="section"><a href="#_documentation">E.11.3. Documentation</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6_3">E.12. Release Notes for Version 1.6.3</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_12">E.12.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_6">E.12.2. AltosUI and TeleGPS Applications</a></span></dt><dt><span class="section"><a href="#_altosdroid">E.12.3. AltosDroid</a></span></dt><dt><span class="section"><a href="#_documentation_2">E.12.4. Documentation</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6_2">E.13. Release Notes for Version 1.6.2</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_13">E.13.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_7">E.13.2. AltosUI and TeleGPS Applications</a></span></dt><dt><span class="section"><a href="#_documentation_3">E.13.3. Documentation</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6_1">E.14. Release Notes for Version 1.6.1</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_14">E.14.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_8">E.14.2. AltosUI and TeleGPS Applications</a></span></dt><dt><span class="section"><a href="#_altosdroid_2">E.14.3. AltosDroid</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_6">E.15. Release Notes for Version 1.6</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_15">E.15.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_9">E.15.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_5">E.16. Release Notes for Version 1.5</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_16">E.16.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_and_telegps_applications_10">E.16.2. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_4_2">E.17. Release Notes for Version 1.4.2</a></span></dt><dd><dl><dt><span class="section"><a href="#_altosui_and_telegps_applications_11">E.17.1. AltosUI and TeleGPS Applications</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_4_1">E.18. Release Notes for Version 1.4.1</a></span></dt><dd><dl><dt><span class="section"><a href="#_altosui_and_telegps_applications_12">E.18.1. AltosUI and TeleGPS Applications:</a></span></dt></dl></dd><dt><span class="section"><a href="#_release_notes_for_version_1_4">E.19. Release Notes for Version 1.4</a></span></dt><dd><dl><dt><span class="section"><a href="#_altos_17">E.19.1. AltOS</a></span></dt><dt><span class="section"><a href="#_altosui_application">E.19.2. AltosUI Application</a></span></dt><dt><span class="section"><a href="#_telegps_application_2">E.19.3. TeleGPS Application</a></span></dt><dt><span class="section"><a href="#_documentation_4">E.19.4. Documentation</a></span></dt></dl></dd></dl></dd></dl></div><div class="list-of-figures"><p><strong>List of Figures</strong></p><dl><dt>3.1. <a href="#idm133">TeleGPS Map View</a></dt><dt>3.2. <a href="#idm148">TeleGPS Location View</a></dt><dt>3.3. <a href="#idm158">TeleGPS Status View</a></dt><dt>3.4. <a href="#idm168">TeleGPS Information Table</a></dt><dt>3.5. <a href="#idm203">TeleGPS Graph</a></dt><dt>3.6. <a href="#idm212">TeleGPS Graph Configuration</a></dt><dt>3.7. <a href="#idm222">TeleGPS Statistics</a></dt><dt>3.8. <a href="#idm232">TeleGPS Map</a></dt><dt>3.9. <a href="#idm253">Load Maps Window</a></dt><dt>3.10. <a href="#idm286">TeleGPS Preferences Window</a></dt><dt>3.11. <a href="#idm345">Device Selection Dialog</a></dt><dt>3.12. <a href="#idm357">Radio Scanning Dialog</a></dt><dt>3.13. <a href="#idm375">TeleGPS Configuration Dialog</a></dt></dl></div><div class="list-of-tables"><p><strong>List of Tables</strong></p><dl><dt>A.1. <a href="#idm450">Altus Metrum APRS Comments</a></dt></dl></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="_telegps_quick_start_guide"></a>Chapter 1. TeleGPS Quick Start Guide</h1></div></div></div><p>TeleGPS is designed to be easy to use. Requiring no external
18 components, flying takes just a few steps.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
19 First, download and install the software from
20 <a class="ulink" href="http://altusmetrum.org/AltOS" target="_top">http://altusmetrum.org/AltOS</a>. This will make sure that
21 you have the right device drivers installed.
22 </li><li class="listitem">
23 Next, plug in the battery and USB cable and connect TeleGPS to
24 your computer. This will charge the battery and allow you to
25 configure the device.
26 </li><li class="listitem">
27 Start the TeleGPS application and set the callsign and frequency
28 on your TeleGPS device; refer to <a class="xref" href="#_configure_device" title="3.13. Configure Device">Section 3.13, “Configure Device”</a> for instructions.
29 </li><li class="listitem">
30 Unplug TeleGPS when the battery charger light goes green. This
31 will enable the radio and logging portions of the TeleGPS
32 firmware.
33 </li><li class="listitem">
34 Connect TeleDongle to your computer and start TeleGPS or start
35 AltosDroid on your android device and connect to TeleBT. Set the
36 frequency to match the TeleGPS and you should be receiving telemetry.
37 </li></ol></div></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="_using_telegps_hardware"></a>Chapter 2. Using TeleGPS Hardware</h1></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_hooking_up_lithium_polymer_batteries"></a>2.1. Hooking Up Lithium Polymer Batteries</h2></div></div></div><p>TeleGPS has a two pin JST PH series connector to connect up
38 a single-cell Lithium Polymer cell (3.7V nominal). You can
39 purchase matching batteries from the Altus Metrum store, or
40 other vendors, or you can make your own. Pin 1 of the
41 connector is positive, pin 2 is negative. Spark Fun sells a
42 cable with the connector attached, which they call a
43 <a class="ulink" href="https://www.sparkfun.com/products/9914" target="_top">JST Jumper 2 Wire Assembly</a></p><div class="warning" style="margin-left: 0; margin-right: 10%;"><h3 class="title">Warning</h3><p>Many RC vendors also sell lithium polymer batteries with
44 this same connector. All that we have found use the opposite
45 polarity, and if you use them that way, you will damage or
46 destroy TeleGPS.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_on_board_data_recording"></a>2.2. On-board Data Recording</h2></div></div></div><p>TeleGPS logs GPS data at a user-configurable
47 rate. Data are logged to a 2MB on-board flash memory
48 part, which can be partitioned into several
49 equal-sized blocks, one for each flight. 64kB of this
50 storage are reserved to hold configuration data,
51 leaving 1984kB for flight data.</p><p>The on-board flash is partitioned into separate flight
52 logs, each of a fixed maximum size. Increase the
53 maximum size of each log and you reduce the number of
54 flights that can be stored. Decrease the size and you
55 can store more flights.</p><p>To compute the amount of space needed for a single
56 log, you can divide the expected time (in seconds) by
57 the sample period (by default, 1 second per sample)
58 and then multiply the result by 32 bytes per
59 sample. For instance, a sample period of 1 second and
60 a flight lasting one hour will take 32 * 3600 = 115200
61 bytes. TeleGPS does try to reduce log space used by
62 not recording position information when it isn’t
63 moving, so actual space consumed may be less than
64 this.</p><p>The default size allows for four flights of 496kB
65 each, which provides over four hours of logging at 1
66 sample per second.</p><p>TeleGPS will not overwrite existing flight data, so be
67 sure to download flight data and erase it from the
68 onboard flash before it fills up. TeleGPS will still
69 report telemetry even if memory is full, so the only
70 thing you will lose is the on-board data log.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_installation"></a>2.3. Installation</h2></div></div></div><p>The battery connectors are a standard 2-pin JST
71 connector and match batteries sold by Spark Fun. These
72 batteries are single-cell Lithium Polymer batteries
73 that nominally provide 3.7 volts.  Other vendors sell
74 similar batteries for RC aircraft using mating
75 connectors, however the polarity for those is
76 generally reversed from the batteries used by Altus
77 Metrum products. In particular, the Tenergy batteries
78 supplied for use in Featherweight flight computers are
79 not compatible with Altus Metrum flight computers or
80 battery chargers.</p><div class="warning" style="margin-left: 0; margin-right: 10%;"><h3 class="title">Warning</h3><p>Check polarity and voltage before connecting any
81 battery not purchased from Altus Metrum or Spark
82 Fun.</p></div><p>TeleGPS uses an integrate GPS patch antenna and won’t
83 receive GPS signals if installed inside a metal or
84 carbon fiber compartment. Test GPS reception and
85 telemetry transmission with the system installed and
86 all other electronics powered up to verify signal
87 reception and make sure there isn’t any interference
88 from other systems.</p></div></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="_telegps_application"></a>Chapter 3. TeleGPS Application</h1></div></div></div><p>The TeleGPS application provides a graphical user interface for
89 interacting with the Altus Metrum product family. TeleGPS can
90 monitor telemetry data, configure devices and many other
91 tasks. The primary interface window is for displaying data
92 received over the telemetry link. There are additional
93 tasks available from the main window menu bar.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_telemetry_monitoring"></a>3.1. Telemetry Monitoring</h2></div></div></div><p>This is the window brought up when you start the
94 application. If you have a TeleDongle device connected
95 to the computer, it will automatically be selected for
96 telemetry monitoring</p><p>All telemetry data received are automatically recorded
97 in suitable log files. The name of the files includes
98 the current date and TeleGPS serial and flight
99 numbers.</p><p>The radio frequency being monitored by the TeleDongle
100 device is displayed at the top of the window. You can
101 configure the frequency by clicking on the frequency
102 box and selecting the desired frequency. The TeleGPS
103 application remembers the last frequency selected for
104 each TeleDongle and selects that automatically the
105 next time you use that device.</p><p>Below the TeleDongle frequency selector, the window
106 contains a few significant pieces of information about
107 the altimeter providing the telemetry data stream:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
108 The configured call-sign
109 </li><li class="listitem">
110 The device serial number
111 </li><li class="listitem">
112 The flight number. TeleGPS remembers how many times
113 it has flown.
114 </li><li class="listitem">
115 The Received Signal Strength Indicator value. This
116 lets you know how strong a signal TeleDongle is
117 receiving. The radio inside TeleDongle operates down
118 to about -100dBm; weaker signals may not be
119 receivable. The packet link uses error detection and
120 correction techniques which prevent incorrect data
121 from being reported.
122 </li><li class="listitem">
123 The age of the displayed data, in seconds since the
124 last successfully received telemetry packet.  In
125 normal operation this will stay in the low single
126 digits.  If the number starts counting up, then you
127 are no longer receiving data over the radio link
128 from the flight computer.
129 </li></ul></div><p>Finally, the largest portion of the window contains a set of
130 tabs, each of which contain some information about the TeleGPS
131 board. The final <span class="emphasis"><em>table</em></span> tab displays many of the raw telemetry
132 values in one place in a spreadsheet-like format.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_map"></a>3.1.1. Map</h3></div></div></div><p>The Map tab shows the TeleGPS track over time
133 on top of map data making it easy to locate
134 the device.</p><div class="figure"><a id="idm133"></a><p class="title"><strong>Figure 3.1. TeleGPS Map View</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-map.png" width="495" alt="telegps-map.png" /></div></div></div><br class="figure-break" /><p>The map’s default scale is approximately 3m
135 (10ft) per pixel. The map can be dragged using
136 the left mouse button. The map will attempt to
137 keep the rocket roughly centered while data is
138 being received.</p><p>You can adjust the style of map and the zoom
139 level with buttons on the right side of the
140 map window. You can draw a line on the map by
141 moving the mouse over the map with a button
142 other than the left one pressed, or by
143 pressing the left button while also holding
144 down the shift key. The length of the line in
145 real-world units will be shown at the start of
146 the line.</p><p>Images are fetched automatically via the
147 Google Maps Static API, and cached on disk for
148 reuse. If map images cannot be downloaded, the
149 rocket’s path will be traced on a dark gray
150 background instead.</p><p>You can pre-load images for your favorite
151 launch sites before you leave home; check out
152 <a class="xref" href="#_load_maps" title="3.5. Load Maps">Section 3.5, “Load Maps”</a>.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_location"></a>3.1.2. Location</h3></div></div></div><p>The Location tab shows the raw GPS data
153 received from TeleGPS.</p><div class="figure"><a id="idm148"></a><p class="title"><strong>Figure 3.2. TeleGPS Location View</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-location.png" width="495" alt="telegps-location.png" /></div></div></div><br class="figure-break" /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_status"></a>3.1.3. Status</h3></div></div></div><p>The Status tab shows data relative to the
154 location of TeleGPS when the application first
155 received telemetry from it.</p><div class="figure"><a id="idm158"></a><p class="title"><strong>Figure 3.3. TeleGPS Status View</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-status.png" width="495" alt="telegps-status.png" /></div></div></div><br class="figure-break" /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_table"></a>3.1.4. Table</h3></div></div></div><p>The Table tab shows detailed information about
156 the GPS receiver</p><div class="figure"><a id="idm168"></a><p class="title"><strong>Figure 3.4. TeleGPS Information Table</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-table.png" width="495" alt="telegps-table.png" /></div></div></div><br class="figure-break" /></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_telegps_menus"></a>3.2. TeleGPS Menus</h2></div></div></div><p>TeleGPS has three or four menus at the top of
157 the window:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
158 File
159 </span></dt><dd>
160 New Window, Graph Data, Export Data, Load Maps,
161 Preferences, Close and Exit
162 </dd><dt><span class="term">
163 Monitor
164 </span></dt><dd>
165 Connect Device, Disconnect and Scan Channels
166 </dd><dt><span class="term">
167 Device
168 </span></dt><dd>
169 Download Data, Configure Device and Flash Device
170 </dd><dt><span class="term">
171 Frequency
172 </span></dt><dd>
173 This shows the current monitoring frequency with a
174 drop-down menu listing other configured
175 frequencies. You can change the set of frequencies
176 shown here from the Preferences dialog. This menu is
177 only shown when the TeleGPS application is connected
178 to a TeleDongle or TeleBT device.
179 </dd></dl></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_new_window"></a>3.2.1. New Window</h3></div></div></div><p>This creates another telemetry monitoring window, in case
180 you have multiple TeleDongle devices connected to the
181 computer.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_graph_data"></a>3.3. Graph Data</h2></div></div></div><p>The Graph tab shows a plot of the the GPS data
182 collected. The X axis is time in seconds; there are a
183 variety of Y axes available for different kinds of
184 data. This window also allows you to see some
185 statistics computed from the data, and an overall map
186 of the entire data record.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_data_graph"></a>3.3.1. Data Graph</h3></div></div></div><div class="figure"><a id="idm203"></a><p class="title"><strong>Figure 3.5. TeleGPS Graph</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-graph-graph.png" width="495" alt="telegps-graph-graph.png" /></div></div></div><br class="figure-break" /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_graph_configuration"></a>3.3.2. Graph Configuration</h3></div></div></div><div class="figure"><a id="idm212"></a><p class="title"><strong>Figure 3.6. TeleGPS Graph Configuration</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-graph-configure.png" width="495" alt="telegps-graph-configure.png" /></div></div></div><br class="figure-break" /><p>This selects which graph elements to show, and, at the
187 bottom, lets you switch between metric and imperial
188 units</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_statistics"></a>3.3.3. Statistics</h3></div></div></div><div class="figure"><a id="idm222"></a><p class="title"><strong>Figure 3.7. TeleGPS Statistics</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-graph-stats.png" width="495" alt="telegps-graph-stats.png" /></div></div></div><br class="figure-break" /><p>Shows overall data computed from the flight.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_map_2"></a>3.3.4. Map</h3></div></div></div><div class="figure"><a id="idm232"></a><p class="title"><strong>Figure 3.8. TeleGPS Map</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-graph-map.png" width="540" alt="telegps-graph-map.png" /></div></div></div><br class="figure-break" /><p>Shows a map of the area overlaid with the GPS track. As with
189 the telemetry monitoring window, you can select the style
190 of map and zoom level using buttons along the side;
191 you can scroll the map by dragging within the map pressing
192 the left button and you can draw a line to measure
193 distances using either the left button with the shift key,
194 or any other button.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_export_data"></a>3.4. Export Data</h2></div></div></div><p>This tool takes the raw data files and makes them
195 available for external analysis. When you select this
196 button, you are prompted to select a data file, which
197 can be either a .eeprom or .telem.  The .eeprom files
198 contain higher resolution and more continuous data,
199 while .telem files contain receiver signal strength
200 information.  Next, a second dialog appears which is
201 used to select where to write the resulting file. It
202 has a selector to choose between CSV and KML file
203 formats.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_comma_separated_value_format"></a>3.4.1. Comma Separated Value Format</h3></div></div></div><p>This is a text file containing the data in a
204 form suitable for import into a spreadsheet or
205 other external data analysis tool. The first
206 few lines of the file contain the version and
207 configuration information from TeleGPS, then
208 there is a single header line which labels all
209 of the fields. All of these lines start with a
210 <span class="emphasis"><em>#</em></span> character which many tools can be
211 configured to skip over.</p><p>The remaining lines of the file contain the
212 data, with each field separated by a comma and
213 at least one space. All of the sensor values
214 are converted to standard units, with the
215 barometric data reported in both pressure,
216 altitude and height above pad units.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_keyhole_markup_language_for_google_earth"></a>3.4.2. Keyhole Markup Language (for Google Earth)</h3></div></div></div><p>This is the format used by Google Earth to provide an overlay
217 within that application. With this, you can use Google Earth to
218 see the whole path in 3D.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_load_maps"></a>3.5. Load Maps</h2></div></div></div><div class="figure"><a id="idm253"></a><p class="title"><strong>Figure 3.9. Load Maps Window</strong></p><div class="figure-contents"><div class="mediaobject"><img src="load-maps.png" width="468" alt="load-maps.png" /></div></div></div><br class="figure-break" /><p>Before heading out to a new launch site, you can use
219 this to load satellite images in case you don’t have
220 internet connectivity at the site.  Try not to wait
221 until the last minute, though, particularly if you’re
222 heading to a major launch.  If too many people are
223 all trying to download map data at once, Google may
224 limit access until the next day.</p><p>There’s a drop-down menu of launch sites we know
225 about; if your favorites aren’t there, please let us
226 know the lat/lon and name of the site. The contents of
227 this list are actually downloaded from our server at
228 run-time, so as new sites are sent in, they’ll get
229 automatically added to this list.  If the launch site
230 isn’t in the list, you can manually enter the lat/lon
231 values</p><p>There are four different kinds of maps you can view;
232 you can select which to download by selecting as many
233 as you like from the available types:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
234 Hybrid
235 </span></dt><dd>
236 A combination of satellite imagery and road data. This
237 is the default view.
238 </dd><dt><span class="term">
239 Satellite
240 </span></dt><dd>
241 Just the satellite imagery without any annotation.
242 </dd><dt><span class="term">
243 Roadmap
244 </span></dt><dd>
245 Roads, political boundaries and a few geographic
246 features.
247 </dd><dt><span class="term">
248 Terrain
249 </span></dt><dd>
250 Contour intervals and shading that show hills and
251 valleys.
252 </dd></dl></div><p>You can specify the range of zoom levels to download;
253 smaller numbers show more area with less
254 resolution. The default level, 0, shows about
255 3m/pixel. One zoom level change doubles or halves that
256 number. Larger zoom levels show more detail, smaller
257 zoom levels less.</p><p>The Map Radius value sets how large an area around the
258 center point to download. Select a value large enough
259 to cover any plausible flight from that site. Be aware
260 that loading a large area with a high maximum zoom
261 level can attempt to download a lot of data. Loading
262 hybrid maps with a 10km radius at a minimum zoom of -2
263 and a maximum zoom of 2 consumes about 120MB of
264 space. Terrain and road maps consume about 1/10 as
265 much space as satellite or hybrid maps.</p><p>Clicking the <span class="emphasis"><em>Load Map</em></span> button will fetch images from
266 Google Maps; note that Google limits how many images
267 you can fetch at once, so if you load more than one
268 launch site, you may get some gray areas in the map
269 which indicate that Google is tired of sending data to
270 you. Try again later.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_preferences"></a>3.6. Preferences</h2></div></div></div><div class="figure"><a id="idm286"></a><p class="title"><strong>Figure 3.10. TeleGPS Preferences Window</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-preferences.png" width="216" alt="telegps-preferences.png" /></div></div></div><br class="figure-break" /><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_voice_settings"></a>3.6.1. Voice Settings</h3></div></div></div><p>TeleGPS provides voice announcements during
271 flight so that you can keep your eyes on the
272 sky and still get information about the
273 current flight status. However, sometimes you
274 don’t want to hear them.</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
275 Enable
276 </span></dt><dd>
277 Turns all voice announcements on and off
278 </dd><dt><span class="term">
279 Test Voice
280 </span></dt><dd>
281 Plays a short message allowing you to verify
282 that the audio system is working and the volume settings
283 are reasonable
284 </dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_log_directory"></a>3.6.2. Log Directory</h3></div></div></div><p>TeleGPS logs all telemetry data and saves all
285 flash data to this directory. This
286 directory is also used as the staring point
287 when selecting data files for display or
288 export.</p><p>Click on the directory name to bring up a
289 directory choosing dialog, select a new
290 directory and click <span class="emphasis"><em>Select Directory</em></span> to
291 change where TeleGPS reads and writes data
292 files.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_callsign"></a>3.6.3. Callsign</h3></div></div></div><p>This value is transmitted in each command
293 packet sent from TeleDongle and received from
294 an altimeter.  It is not used in telemetry
295 mode, as the callsign configured in the
296 altimeter board is included in all telemetry
297 packets.  Configure this with the TeleGPS
298 operators call sign as needed to comply with
299 your local radio regulations.</p><p>Note that to successfully command a flight
300 computer over the radio (to configure the
301 altimeter, monitor idle, or fire pyro
302 charges), the callsign configured here must
303 exactly match the callsign configured in the
304 flight computer.  This matching is case
305 sensitive.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_imperial_units"></a>3.6.4. Imperial Units</h3></div></div></div><p>This switches between metric units (meters)
306 and imperial units (feet and miles). This
307 affects the display of values use during
308 flight monitoring, configuration, data
309 graphing and all of the voice
310 announcements. It does not change the units
311 used when exporting to CSV files, those are
312 always produced in metric units.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_serial_debug"></a>3.6.5. Serial Debug</h3></div></div></div><p>This causes all communication with a connected
313 device to be dumped to the console from which
314 TeleGPS was started. If you’ve started it from
315 an icon or menu entry, the output will simply
316 be discarded. This mode can be useful to debug
317 various serial communication issues.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_font_size"></a>3.6.6. Font size</h3></div></div></div><p>Selects the set of fonts used in the flight
318 monitor window. Choose between the small,
319 medium and large sets.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_look_amp_feel"></a>3.6.7. Look &amp; feel</h3></div></div></div><p>Switches between the available Java user
320 interface appearances. The default selection
321 is supposed to match the native window system
322 appearance for the target platform.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_menu_position"></a>3.6.8. Menu position</h3></div></div></div><p>Selects the initial position for the main
323 TeleGPS window that includes all of the
324 command buttons.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_map_cache_size"></a>3.6.9. Map Cache Size</h3></div></div></div><p>Sets the number of map <span class="emphasis"><em>tiles</em></span> kept in memory
325 while the application is running. More tiles
326 consume more memory, but will make panning
327 around the map faster.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_manage_frequencies"></a>3.6.10. Manage Frequencies</h3></div></div></div><p>This brings up a dialog where you can
328 configure the set of frequencies shown in the
329 various frequency menus. You can add as many
330 as you like, or even reconfigure the default
331 set. Changing this list does not affect the
332 frequency settings of any devices, it only
333 changes the set of frequencies shown in the
334 menus.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_close"></a>3.7. Close</h2></div></div></div><p>This closes the current window, leaving any other windows
335 open and the application running.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_exit"></a>3.8. Exit</h2></div></div></div><p>This closes all TeleGPS windows and terminates the
336 application.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_connect_device"></a>3.9. Connect Device</h2></div></div></div><p>Selecting this item brings up a dialog box listing all
337 of the connected TeleDongle devices. When you choose
338 one of these, AltosUI will display telemetry data as
339 received by the selected TeleDongle device.</p><div class="figure"><a id="idm345"></a><p class="title"><strong>Figure 3.11. Device Selection Dialog</strong></p><div class="figure-contents"><div class="mediaobject"><img src="device-selection.png" width="279" alt="device-selection.png" /></div></div></div><br class="figure-break" /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_disconnect"></a>3.10. Disconnect</h2></div></div></div><p>Disconnects the currently connected TeleDongle or
340 TeleBT</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_scan_channels"></a>3.11. Scan Channels</h2></div></div></div><div class="figure"><a id="idm357"></a><p class="title"><strong>Figure 3.12. Radio Scanning Dialog</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-scan.png" width="279" alt="telegps-scan.png" /></div></div></div><br class="figure-break" /><p>Scans the configured set of frequencies looking for
341 telemetry signals. A list of all of the discovered
342 signals is show; selecting one of those and clicking
343 on <span class="emphasis"><em>Monitor</em></span> will select that frequency in the
344 associated TeleGPS application window.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_download_data"></a>3.12. Download Data</h2></div></div></div><p>TeleGPS records data to its internal flash memory.
345 On-board data is recorded at the same rate as
346 telemetry but is not subject to radio drop-outs. As
347 such, it generally provides a more complete and
348 precise record.  The <span class="emphasis"><em>Download Data</em></span> menu entry allows
349 you to read the flash memory and write it to disk.</p><p>Select the <span class="emphasis"><em>Download Data</em></span> menu entry to bring up a
350 list of connected TeleGPS devices. After the device
351 has been selected, a dialog showing the data stored in
352 the device will be shown allowing you to select which
353 entries to download and which to delete. You must
354 erase flights in order for the space they consume to
355 be reused by another track. This prevents accidentally
356 losing data if you neglect to download data before
357 starting TeleGPS again. Note that if there is no more
358 space available in the device, then no data will be
359 recorded.</p><p>The file name for each data log is computed
360 automatically from the recorded date, altimeter serial
361 number and flight number information.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_configure_device"></a>3.13. Configure Device</h2></div></div></div><div class="figure"><a id="idm375"></a><p class="title"><strong>Figure 3.13. TeleGPS Configuration Dialog</strong></p><div class="figure-contents"><div class="mediaobject"><img src="telegps-configure.png" width="324" alt="telegps-configure.png" /></div></div></div><br class="figure-break" /><p>Select this button and then select any connected TeleGPS
362 device from the list provided.</p><p>The first few lines of the dialog provide information
363 about the connected device, including the product
364 name, software version and hardware serial
365 number. Below that are the individual configuration
366 entries.</p><p>At the bottom of the dialog, there are four buttons:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
367 Save
368 </span></dt><dd>
369 This writes any changes to the configuration parameter
370 block in flash memory. If you don’t press this button,
371 any changes you make will be lost.
372 </dd><dt><span class="term">
373 Reset
374 </span></dt><dd>
375 This resets the dialog to the most recently saved
376 values, erasing any changes you have made.
377 </dd><dt><span class="term">
378 Reboot
379 </span></dt><dd>
380 This reboots the device. Use this to switch from idle
381 to pad mode by rebooting once the rocket is oriented
382 for flight, or to confirm changes you think you saved
383 are really saved.
384 </dd><dt><span class="term">
385 Close
386 </span></dt><dd>
387 This closes the dialog. Any unsaved changes will be
388 lost.
389 </dd></dl></div><p>The rest of the dialog contains the parameters to be configured.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_frequency"></a>3.13.1. Frequency</h3></div></div></div><p>This configures which of the frequencies to use for
390 both telemetry and packet command mode. Note that if
391 you set this value via packet command mode, the
392 TeleDongle frequency will also be automatically
393 reconfigured to match so that communication will
394 continue afterwards.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_rf_calibration"></a>3.13.2. RF Calibration</h3></div></div></div><p>The radios in every Altus Metrum device are calibrated
395 at the factory to ensure that they transmit and
396 receive on the specified frequency.  If you need to
397 you can adjust the calibration by changing this value.
398 Do not do this without understanding what the value
399 means, read the appendix on calibration and/or the
400 source code for more information.  To change a
401 TeleDongle’s calibration, you must reprogram the unit
402 completely.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_telemetry_rdf_aprs_enable"></a>3.13.3. Telemetry/RDF/APRS Enable</h3></div></div></div><p>Enables the radio for transmission during
403 flight. When disabled, the radio will not
404 transmit anything during flight at all.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_telemetry_baud_rate"></a>3.13.4. Telemetry baud rate</h3></div></div></div><p>This sets the modulation bit rate for data
405 transmission for both telemetry and packet
406 link mode. Lower bit rates will increase range
407 while reducing the amount of data that can be
408 sent and increasing battery consumption. All
409 telemetry is done using a rate 1/2 constraint
410 4 convolution code, so the actual data
411 transmission rate is 1/2 of the modulation bit
412 rate specified here.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_aprs_interval"></a>3.13.5. APRS Interval</h3></div></div></div><p>How often to transmit GPS information via APRS
413 (in seconds). When set to zero, APRS
414 transmission is disabled.
415 Note that a single APRS packet
416 takes nearly a full second to transmit, so
417 enabling this option will prevent sending any
418 other telemetry during that time.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_aprs_ssid"></a>3.13.6. APRS SSID</h3></div></div></div><p>Which SSID to report in APRS packets. By
419 default, this is set to the last digit of the
420 serial number, but can be configured to any
421 value from 0 to 9.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_aprs_format"></a>3.13.7. APRS Format</h3></div></div></div><p>Whether to send APRS data in Compressed or
422 Uncompressed format. Compressed format is
423 smaller and more precise. Uncompressed
424 format is older, but may work better with your
425 device. The Kenwood TH-D72 only displays
426 altitude information with Uncompressed
427 format, while the Yaesu FT1D only displays
428 altitude with Compressed format. Test before
429 you fly to see which to use.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_callsign_2"></a>3.13.8. Callsign</h3></div></div></div><p>This sets the call sign included in each
430 telemetry packet. Set this as needed to
431 conform to your local radio regulations.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_logging_trigger_motion"></a>3.13.9. Logging Trigger Motion</h3></div></div></div><p>This sets the amount of motion that TeleGPS
432 needs to see before logging the new
433 position. Motions smaller than this are
434 skipped, which saves storage space.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_position_reporting_interval"></a>3.13.10. Position Reporting Interval</h3></div></div></div><p>The interval between TeleGPS position reports,
435 both over the air and in the log. Increase
436 this to reduce the frequency of radio
437 transmissions and the length of time available
438 in the log.</p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_flash_device"></a>3.14. Flash Device</h2></div></div></div><p>This reprograms TeleGPS devices with new
439 firmware. Please read the directions for flashing
440 devices in <a class="xref" href="#_updating_device_firmware" title="Appendix D. Updating Device Firmware">Appendix D, <em>Updating Device Firmware</em></a>.</p></div></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="_telegps_system_operation"></a>Appendix A. TeleGPS System Operation</h1></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_gfsk_telemetry"></a>A.1. GFSK Telemetry</h2></div></div></div><p>TeleGPS’s native telemetry system doesn’t use a
441 <span class="emphasis"><em>normal packet radio</em></span> mode like APRS because it’s not
442 very efficient.  The GFSK modulation we use is FSK
443 with the base-band pulses passed through a Gaussian
444 filter before they go into the modulator to limit the
445 transmitted bandwidth.  When combined with forward
446 error correction and interleaving, this allows us to
447 have a very robust 19.2 kilobit data link with only
448 10-40 milliwatts of transmit power, a whip antenna in
449 the rocket, and a hand-held Yagi on the ground.  We’ve
450 had flights to above 21k feet AGL with great
451 reception, and calculations suggest we should be good
452 to well over 40k feet AGL with a 5-element yagi on the
453 ground with our 10mW units and over 100k feet AGL with
454 the 40mW devices.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_aprs"></a>A.2. APRS</h2></div></div></div><p>TeleGPS can send APRS if desired, and the
455 interval between APRS packets can be configured. As each APRS
456 packet takes a full second to transmit, we recommend an
457 interval of at least 5 seconds to avoid consuming too much
458 battery power or radio channel bandwidth. You can configure
459 the APRS interval using TeleGPS; that process is described in
460 <a class="xref" href="#_configure_device" title="3.13. Configure Device">Section 3.13, “Configure Device”</a>.</p><p>AltOS supports both compressed and uncompressed APRS
461 position report data formats. The compressed format
462 provides for higher position precision and shorter
463 packets than the uncompressed APRS format. We’ve found
464 some older APRS receivers that do not handle the
465 compressed format. The Kenwood TH-72A requires the use
466 of uncompressed format to display altitude information
467 correctly. The Yaesu FT1D requires the use of
468 compressed format to display altitude information.</p><p>APRS packets include an SSID (Secondary Station Identifier)
469 field that allows one operator to have multiple
470 transmitters. AltOS allows you to set this to a single digit
471 from 0 to 9, allowing you to fly multiple transmitters at the
472 same time while keeping the identify of each one separate in
473 the receiver. By default, the SSID is set to the last digit of
474 the device serial number.</p><p>The APRS packet format includes a comment field that
475 can have arbitrary text in it. AltOS uses this to send
476 status information as shown in the following table.</p><div class="table"><a id="idm450"></a><p class="title"><strong>Table A.1. Altus Metrum APRS Comments</strong></p><div class="table-contents"><table class="table" summary="Altus Metrum APRS Comments" cellpadding="4px" style="border-collapse: collapse;border-top: 1px solid #78079a; border-bottom: 1px solid #78079a; border-left: 1px solid #78079a; border-right: 1px solid #78079a; "><colgroup><col class="col_1" /><col class="col_2" /><col class="col_3" /></colgroup><thead><tr><th style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top">Field        </th><th style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top">Example        </th><th style="border-bottom: 1px solid #78079a; " align="left" valign="top">Description</th></tr></thead><tbody><tr><td style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top"><p>1</p></td><td style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top"><p>L</p></td><td style="border-bottom: 1px solid #78079a; " align="left" valign="top"><p>GPS Status U for unlocked, L for locked</p></td></tr><tr><td style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top"><p>2</p></td><td style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top"><p>6</p></td><td style="border-bottom: 1px solid #78079a; " align="left" valign="top"><p>Number of Satellites in View</p></td></tr><tr><td style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top"><p>3</p></td><td style="border-right: 1px solid #78079a; border-bottom: 1px solid #78079a; " align="left" valign="top"><p>B4.0</p></td><td style="border-bottom: 1px solid #78079a; " align="left" valign="top"><p>Altimeter Battery Voltage</p></td></tr><tr><td style="border-right: 1px solid #78079a; " align="left" valign="top"><p>4</p></td><td style="border-right: 1px solid #78079a; " align="left" valign="top"><p>1286</p></td><td style="" align="left" valign="top"><p>Device Serial Number</p></td></tr></tbody></table></div></div><br class="table-break" /><p>Here’s an example of an APRS comment showing GPS lock with 6
477 satellites in view and a primary battery at 4.0V from device 1876.</p><pre class="literallayout">L6 B4.0 1876</pre><p>Make sure your primary battery is above 3.8V
478 and GPS is locked with at least 5 or 6 satellites in
479 view before flying. If GPS is switching between L and
480 U regularly, then it doesn’t have a good lock and you
481 should wait until it becomes stable.</p><p>If the GPS receiver loses lock, the APRS data
482 transmitted will contain the last position for which
483 GPS lock was available. You can tell that this has
484 happened by noticing that the GPS status character
485 switches from <span class="emphasis"><em>L</em></span> to <span class="emphasis"><em>U</em></span>. Before GPS has locked, APRS
486 will transmit zero for latitude, longitude and
487 altitude.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_configurable_parameters"></a>A.3. Configurable Parameters</h2></div></div></div><p>Configuring TeleGPS is very simple; the few configurable
488 parameters can all be set using the TeleGPS application over
489 USB. Check out <a class="xref" href="#_configure_device" title="3.13. Configure Device">Section 3.13, “Configure Device”</a>.</p></div></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="_handling_precautions"></a>Appendix B. Handling Precautions</h1></div></div></div><p>All Altus Metrum products are sophisticated electronic devices.
490 When handled gently and properly installed in an air-frame, they
491 will deliver impressive results.  However, as with all electronic
492 devices, there are some precautions you must take.</p><div class="warning" style="margin-left: 0; margin-right: 10%;"><h3 class="title">Warning</h3><p>The Lithium Polymer rechargeable batteries have an
493 extraordinary power density.  This is great because we can fly with
494 much less battery mass than if we used alkaline batteries or previous
495 generation rechargeable batteries… but if they are punctured
496 or their leads are allowed to short, they can and will release their
497 energy very rapidly!
498 Thus we recommend that you take some care when handling our batteries
499 and consider giving them some extra protection in your air-frame.  We
500 often wrap them in suitable scraps of closed-cell packing foam before
501 strapping them down, for example.</p></div><p>The barometric sensors used on all of our flight computers are
502 sensitive to sunlight.  In normal mounting situations, the baro sensor
503 and all of the other surface mount components
504 are “down” towards whatever the underlying mounting surface is, so
505 this is not normally a problem.  Please consider this when designing an
506 installation in an air-frame with a see-through plastic payload bay.  It
507 is particularly important to
508 consider this with TeleMini v1.0, both because the baro sensor is on the
509 “top” of the board, and because many model rockets with payload bays
510 use clear plastic for the payload bay!  Replacing these with an opaque
511 cardboard tube, painting them, or wrapping them with a layer of masking
512 tape are all reasonable approaches to keep the sensor out of direct
513 sunlight.</p><p>The barometric sensor sampling port must be able to “breathe”,
514 both by not being covered by foam or tape or other materials that might
515 directly block the hole on the top of the sensor, and also by having a
516 suitable static vent to outside air.</p><p>As with all other rocketry electronics, Altus Metrum altimeters must
517 be protected from exposure to corrosive motor exhaust and ejection
518 charge gasses.</p></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="_technical_information"></a>Appendix C. Technical Information</h1></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_gps_receiver"></a>C.1. GPS Receiver</h2></div></div></div><p>TeleGPS uses the u-Blox Max-7Q GPS receiver.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_70cm_transmitter"></a>C.2. 70cm Transmitter</h2></div></div></div><p>TeleGPS uses a TI CC115L transmitter. This radio
519 produces 10mW of RF output.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_micro_controller"></a>C.3. Micro-controller</h2></div></div></div><p>TeleGPS uses an NXP LPC11U14 micro-controller. This
520 tiny CPU contains 32kB of flash for the application
521 and 4kB of RAM for temporary data storage.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_lithium_polymer_battery"></a>C.4. Lithium Polymer Battery</h2></div></div></div><p>Shipping restrictions may prevent us from including a
522 battery battery with TeleGPS.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_mechanical_considerations"></a>C.5. Mechanical Considerations</h2></div></div></div><p>TeleGPS is designed to be rugged enough for typical
523 rocketry applications.  The 4 mounting holes on the
524 board are sized for use with 4-40 or M3 screws.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_on_board_data_storage"></a>C.6. On-board data storage</h2></div></div></div><p>TeleGPS has 2MB of non-volatile storage, separate from
525 the code storage memory. The TeleGPS firmware uses
526 this to log information during flight.</p></div></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="_updating_device_firmware"></a>Appendix D. Updating Device Firmware</h1></div></div></div><p>TeleGPS is programmed directly over its USB connectors.</p><p>You may wish to begin by ensuring you have current firmware images.
527 These are distributed as part of the TeleGPS software bundle that
528 also includes the TeleGPS ground station program.  Newer ground
529 station versions typically work fine with older firmware versions,
530 so you don’t need to update your devices just to try out new
531 software features.  You can always download the most recent
532 version from <a class="ulink" href="http://www.altusmetrum.org/AltOS/" target="_top">http://www.altusmetrum.org/AltOS/</a></p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_updating_telegps_firmware"></a>D.1. Updating TeleGPS Firmware</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
533 Attach a battery and power switch to the target
534 device. Power up the device.
535 </li><li class="listitem">
536 Using a Micro USB cable, connect the target device to
537 your computer’s USB socket.
538 </li><li class="listitem">
539 Run TeleGPS, and select <span class="emphasis"><em>Flash Device</em></span> from the
540 Device menu.
541 </li><li class="listitem">
542 Select the target device in the Device Selection
543 dialog.
544 </li><li class="listitem">
545 Select the image you want to flash to the device,
546 which should have a name in the form
547 &lt;product&gt;-v&lt;product-version&gt;-&lt;software-version&gt;.ihx,
548 such as TeleGPS-v1.0-1.4.0.ihx.
549 </li><li class="listitem">
550 Make sure the configuration parameters are reasonable
551 looking. If the serial number and/or RF configuration
552 values aren’t right, you’ll need to change them.
553 </li><li class="listitem">
554 Hit the <span class="emphasis"><em>OK</em></span> button and the software should proceed
555 to flash the device with new firmware, showing a
556 progress bar.
557 </li><li class="listitem">
558 Verify that the device is working by using the
559 'Configure Device item to check over the
560 configuration.
561 </li></ol></div></div></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="_release_notes"></a>Appendix E. Release Notes</h1></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8_6"></a>E.1. Release Notes for Version 1.8.6</h2></div></div></div><p>Version 1.8.6</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos"></a>E.1.1. AltOS</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
562 Use maximum of 64 previous tilt values in pyro tilt tests
563 </li><li class="listitem">
564 Eliminate 100m height requirement for coast detection
565 </li><li class="listitem">
566 Change After Motor pyro check to be &gt;= instead of ==
567 </li><li class="listitem">
568 Change Time since Boost to be Time since launch.
569 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_telegps"></a>E.1.2. AltosUI, TeleGPS</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
570 Clarify pyro test phrasing
571 </li><li class="listitem">
572 Remove ascending/descending from pyro config UI
573 </li><li class="listitem">
574 Fix accel calibration in Antenna Down mode
575 </li><li class="listitem">
576 Add mag sensor reporting for TeleMega v3 idle monitoring.
577 </li><li class="listitem">
578 Fix radio parameter saving at 2400 bps telmetry rate.
579 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_micropeak"></a>E.1.3. MicroPeak</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
580 Report altimeter-recorded maximum height value
581 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8_5"></a>E.2. Release Notes for Version 1.8.5</h2></div></div></div><p>Version 1.8.5 includes fixes to the ground software support
582 for TeleBT v4, along with a few other minor updates.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_2"></a>E.2.1. AltOS</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
583 Fix startup beeps that indicate sensor failures.
584 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_telegps_2"></a>E.2.2. AltosUI, TeleGPS</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
585 When updating device firmware, make sure selected firmware
586 matches target device.
587 </li><li class="listitem">
588 Correct Bluetooth device matching when looking for TeleBT
589 devices.
590 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8_4"></a>E.3. Release Notes for Version 1.8.4</h2></div></div></div><p>Version 1.8.4 includes support for EasyMini version 2.0</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_3"></a>E.3.1. AltOS</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
591 Support for EasyMini version 2.0 hardware.
592 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8_3"></a>E.4. Release Notes for Version 1.8.3</h2></div></div></div><p>Version 1.8.3 includes support for TeleMega version 3.0 along
593 with two important flight computer fixes. This version also
594 changes KML export data to make Tripoli Record reporting
595 better and some updates to graph presentation and data
596 downloading.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_4"></a>E.4.1. AltOS</h3></div></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_altos_new_features"></a>AltOS New Features</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
597 Support for TeleMega version 3.0 hardware.
598 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_altos_bug_fixes"></a>AltOS Bug Fixes</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
599 Ground testing EasyMega and TeleMega additional pyro
600 channels could result in a sticky <span class="emphasis"><em>fired</em></span> status which would
601 prevent these channels from firing on future flights.
602 </li><li class="listitem">
603 Corrupted flight log records could prevent future flights
604 from capturing log data.
605 </li><li class="listitem">
606 Fixed saving of pyro configuration that ended with
607 <span class="emphasis"><em>Descending</em></span>.
608 </li></ul></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications"></a>E.4.2. AltosUI and TeleGPS Applications</h3></div></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_altosui_new_features"></a>AltosUI New Features</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
609 Support for TeleMega version 3.0.
610 </li><li class="listitem">
611 Graph lines have improved appearance to make them easier to
612 distinguish. Markers may be placed at data points to show
613 captured recorded data values.
614 </li><li class="listitem">
615 Graphing offers the ability to adjust the smoothing of
616 computed speed and acceleration data.
617 </li><li class="listitem">
618 The download dialog now offers to graph new flights, checks
619 for existing files to avoid overwriting data and reports if
620 there are checksum errors in the downloaded data.
621 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_altosui_telegps_bug_fixes"></a>AltosUI/TeleGPS Bug Fixes</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
622 Restore TeleGPS tracking behavior.
623 </li><li class="listitem">
624 Display flight computer call sign and serial number in
625 Monitor Idle mode instead of ground station values.
626 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_altosui_and_telegps_changes"></a>AltosUI and TeleGPS Changes</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
627 KML export now reports both barometric and GPS altitude data
628 to make it more useful for Tripoli record reporting.
629 </li><li class="listitem">
630 CSV export now includes TeleMega/EasyMega pyro voltages and
631 tilt angle.
632 </li></ul></div><p></p></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8_2"></a>E.5. Release Notes for Version 1.8.2</h2></div></div></div><p>Version 1.8.2 includes support for TeleGPS version 2.0 along
633 with accelerometer recalibration support in AltosUI.</p><p>1.8.2 also contains a couple of minor fixes for AltosUI when
634 analyzing saved data files.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_5"></a>E.5.1. AltOS</h3></div></div></div><p>AltOS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
635 Support for TeleGPS version 2.0 hardware.
636 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_2"></a>E.5.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI and TeleGPS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
637 Support for TeleGPS version 2.0.
638 </li><li class="listitem">
639 Accelerometer re-calibration user interface.
640 </li></ul></div><p>AltosUI and TeleGPS Bug Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
641 Prevent some crashes when reading older saved flight data
642 for graphing or KML export.
643 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8_1"></a>E.6. Release Notes for Version 1.8.1</h2></div></div></div><p>Version 1.8.1 includes an important bug fix for Apogee Lockout
644 operation in all flight computers. Anyone using this option
645 must update firmware.</p><p>This release also contains a change in how flight computers
646 with accelerometers deal with speeds around and above Mach
647 1. In previous versions, the flight computer would completely
648 disregard the barometric sensor above 330m/s (around Mach
649 1). Now, the data from the barometric sensor is reduced in
650 effect without ever going away entirely. This prevents early
651 drogue deployment for flights which spend considerable time
652 above Mach 1.</p><p>1.8.1 also contains a couple of minor fixes for AltosUI when
653 analyzing saved data files.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_6"></a>E.6.1. AltOS</h3></div></div></div><p>AltOS Bug Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
654 Handle time value wrapping in Apogee Lockout
655 correctly. Without this, apogee lockout would sometimes
656 prevent any drogue charge from firing.
657 </li><li class="listitem">
658 Change Kalman filter on flight computers with accelerometer
659 to continue using the barometric sensor even at high speeds
660 to avoid unintentional drogue deployment during
661 deceleration.
662 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_3"></a>E.6.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
663 Add new <span class="emphasis"><em>Huge</em></span> font size to make text even bigger on high
664 resolution monitors.
665 </li></ul></div><p>AltosUI Bug Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
666 Prevent some crashes when reading older saved flight data
667 for graphing or KML export.
668 </li><li class="listitem">
669 Load frequency preference at startup. The loading code was
670 broken, so you’d see only the default frequencies.
671 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_8"></a>E.7. Release Notes for Version 1.8</h2></div></div></div><p>Version 1.8 includes support for our new TeleBT v4.0 ground
672 station, updates for data analysis in our ground station
673 software and bug fixes in in the flight software for all our
674 boards and ground station interfaces.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_7"></a>E.7.1. AltOS</h3></div></div></div><p>AltOS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
675 Add support for TeleBT v4.0 boards.
676 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_4"></a>E.7.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
677 Add support for TeleBT v4.0 hardware
678 </li><li class="listitem">
679 Rewrite graphing and export functions. This code now handles
680 each data series separately so that graphs are drawn
681 correctly. Smoothing now uses a filter that looks both
682 forward and backwards in time to make computed speed and
683 acceleration data more accurate.
684 </li></ul></div><p>AltosUI Bug Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
685 Correct axis labeling of magnetic sensor in TeleMega and
686 EasyMega. The Y and Z axes were flipped.
687 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_7"></a>E.8. Release Notes for Version 1.7</h2></div></div></div><p>Version 1.7 includes support for our new TeleMini v3.0
688 flight computer and bug fixes in in the flight software for all our boards
689 and ground station interfaces.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_8"></a>E.8.1. AltOS</h3></div></div></div><p>AltOS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
690 Add support for TeleMini v3.0 boards.
691 </li></ul></div><p>AltOS Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
692 Fix interrupt priorities on STM32L processors. Run timer
693 interrupt at lowest priority so that device interrupts get
694 serviced first.
695 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_5"></a>E.8.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
696 Add support for TeleMini v3.0 hardware
697 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6_8"></a>E.9. Release Notes for Version 1.6.8</h2></div></div></div><p>Version 1.6.8 fixes a TeleMega and TeleMetrum v2.0 bug where
698 the device could stop logging data and transmitting
699 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
700 v2.0 users should update their flight firmware.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_9"></a>E.9.1. AltOS</h3></div></div></div><p>AltOS fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
701 Fix STM32L DMA driver to work around STM32L SoC DMA priority
702 issue t lock-up in the logging or radio code, either of
703 which could stop data logging and telemetry.
704 </li><li class="listitem">
705 Avoid having TeleBT battery status values smash telemetry
706 packet data by holding a lock during both operations.
707 </li><li class="listitem">
708 Don’t start reporting <span class="emphasis"><em>flight 0</em></span> when the log fills in
709 flight.
710 </li></ul></div><p>AltOS changes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
711 Flash LEDS on all products briefly during power up so that
712 they can be tested during production.
713 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_telegps_and_altosdroid_applications"></a>E.9.2. AltosUI, TeleGPS and AltosDroid Applications</h3></div></div></div><p>AltosUI fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
714 Re-enable go/no-go entries after they’ve been disabled due
715 to lack of data. If telemetry information is delayed when
716 the Ui starts up, sometimes important fields would get
717 disabled to never re-appear.
718 </li><li class="listitem">
719 Deal with ground station failure better during Configure
720 Ground Station operation by cleaning up pending operations.
721 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6_5"></a>E.10. Release Notes for Version 1.6.5</h2></div></div></div><p>Version 1.6.5 fixes a TeleMega and TeleMetrum v2.0 bug where
722 the device would often stop logging data and transmitting
723 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
724 v2.0 users should update their flight firmware.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_10"></a>E.10.1. AltOS</h3></div></div></div><p>AltOS fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
725 Fix STM32L SPI driver to prevent lock-up in the logging or
726 radio code, either of which could stop data logging and
727 telemetry. Found and characterized by Chuck Haskin, who also
728 tested the new firmware before release.
729 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_telegps_and_altosdroid_applications_2"></a>E.10.2. AltosUI, TeleGPS and AltosDroid Applications</h3></div></div></div><p>AltosUI fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
730 Deliver firmward for TeleMega v2.0 and TeleBT v3.0 with
731 Windows package.
732 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6_4"></a>E.11. Release Notes for Version 1.6.4</h2></div></div></div><p>Version 1.6.4 fixes a bluetooth communication problem with
733 TeleBT v1.0 devices, along with some altosui and altosdroid
734 minor nits. It also now ships firmware for some newer devices.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_11"></a>E.11.1. AltOS</h3></div></div></div><p>AltOS fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
735 Fix hardware flow control on TeleBT v1.0. Hardware RTS/CTS
736 doesn’t seem to work, switch from using the hardware to
737 driving these pins with software.
738 </li><li class="listitem">
739 Fix ARM USB drivers to deal with OS restarts. Needed to
740 reset all USB-related state when the USB bus is reset. These
741 fixes affect all STM32L, STM32F0 and LPC11U14 based devices.
742 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_telegps_and_altosdroid_applications_3"></a>E.11.2. AltosUI, TeleGPS and AltosDroid Applications</h3></div></div></div><p>AltosUI, TeleGPS and AltosDroid New Features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
743 Automatically switch from meters or feet to kilometers or
744 miles for distance units.
745 </li><li class="listitem">
746 Add Monitor Idle mode to TeleGPS application.
747 </li></ul></div><p>AltosUI, TeleGPS and AltosDroid Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
748 Abort map preloading when the preload map dialog is closed.
749 </li><li class="listitem">
750 In AltosDroid, Don’t reconnect to last device if the user
751 had disconnected it the last time the application was
752 active.
753 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_documentation"></a>E.11.3. Documentation</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
754 Mention TeleMega v2.0 in hardware specs table.
755 </li><li class="listitem">
756 Document TeleGPS RF output in telegps manual.
757 </li></ul></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6_3"></a>E.12. Release Notes for Version 1.6.3</h2></div></div></div><p>Version 1.6.3 adds idle mode to AltosDroid and has bug fixes
758 for our host software on desktops, laptops an android devices
759 along with BlueTooth support for Windows.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_12"></a>E.12.1. AltOS</h3></div></div></div><p>AltOS fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
760 Fix hardware flow control on TeleBT v3.0. RTS/CTS is
761 wired backwards on this board, switch from using the
762 hardware to driving these pins with software.
763 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_6"></a>E.12.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI and TeleGPS New Features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
764 Add BlueTooth support for Windows operating system. This
765 supports connections to TeleBT over BlueTooth rather than
766 just USB.
767 </li></ul></div><p>AltosUI and TeleGPS Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
768 Change Java detection and install on Windows. Detection is
769 now done by looking for the <span class="emphasis"><em>javaw.exe</em></span> program, and
770 installation by opening a browser on the java.com web site.
771 </li><li class="listitem">
772 Delay polling while the Fire Igniters is visible to allow
773 for TeleMega to report back complete status over the radio.
774 </li><li class="listitem">
775 Disallow changing RF calibration numbers in the
776 configuration UI. There’s no good reason to change this from
777 the field, and recovering is really hard if you haven’t
778 written down the right number.
779 </li><li class="listitem">
780 Fix USB device discovery on Mac OS X El Capitan. This makes
781 the connected Altus Metrum USB devices appear again.
782 </li><li class="listitem">
783 Fix acceleration data presented in MonitorIdle mode for
784 TeleMetrum v2.0 flight computers.
785 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosdroid"></a>E.12.3. AltosDroid</h3></div></div></div><p>AltosDroid new features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
786 Monitor Idle mode. Check state of flight computer while in
787 idle mode over the radio link
788 </li><li class="listitem">
789 Fire Igniters. Remotely fire ignires for recovery system
790 ground tests.
791 </li><li class="listitem">
792 Remote reboot. Cause the flight computer to reboot over the
793 radio link. This provides a method for switching the flight
794 computer from idle to flight mode without needing to reach
795 the power switch.
796 </li><li class="listitem">
797 Configurable frequency menu. Change the set of available
798 frequencies and provide more descriptive names.
799 </li></ul></div><p>AltosDroid bug fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
800 Don’t set target location if GPS hasn’t locked yet.
801 </li><li class="listitem">
802 Fix saving target states so they can be reloaded when the
803 application restarts. When the application is shut down and
804 restarted, all previous target state information will be
805 restored (including GPS position if available).
806 </li><li class="listitem">
807 Fix crash on some Android devices for offline maps when
808 changing the map scale or location.
809 </li><li class="listitem">
810 Don’t require USB OTG support. This kept the latest
811 AltosDroid from being offered on devices without USB device
812 support, although it can work without that just fine using
813 BlueTooth.
814 </li><li class="listitem">
815 Don’t require bluetooth to be enabled. This allows the
816 application to operate with USB devices or just show old
817 data without turning on the bluetooth radio.
818 </li><li class="listitem">
819 Recover old tracker positions when restarting
820 application. This finally allows you to safely stop and
821 restart the application without losing the last known
822 location of any tracker.
823 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_documentation_2"></a>E.12.4. Documentation</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
824 Document TeleMega and EasyMega additional pyro channel
825 continuity audio alert pattern.
826 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6_2"></a>E.13. Release Notes for Version 1.6.2</h2></div></div></div><p>Version 1.6.2 includes support for our updated TeleMega v2.0
827 product and bug fixes in in the flight software for all our boards
828 and ground station interfaces.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_13"></a>E.13.1. AltOS</h3></div></div></div><p>AltOS New Features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
829 Add support for TeleMega v2.0 boards.
830 </li><li class="listitem">
831 Add PWM servo driver. There’s no higher level code using
832 this yet, but the driver allows testing of the TeleMega v2.0
833 servo output connector.
834 </li></ul></div><p>AltOS Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
835 Slow down telemetry packets to allow receiver to keep
836 up.
837 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_7"></a>E.13.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI and TeleGPS Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
838 Fix post-flight orientation computation when processing
839 TeleMega and EasyMega eeprom data files.
840 </li><li class="listitem">
841 Capture complete eeprom data even when there are invalid
842 entries in the data. This keeps reading eeprom contents and
843 writing the associated .eeprom file when an error is detected.
844 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_documentation_3"></a>E.13.3. Documentation</h3></div></div></div><p>We spent a bunch of time trying to improve our documentation</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
845 HTML versions now have a table of contents on the left side.
846 </li><li class="listitem">
847 EasyMini now has its own shorter manual.
848 </li><li class="listitem">
849 Provide links between sections in each document.
850 </li><li class="listitem">
851 Lots of minor rewriting and restructuring to avoid
852 duplication of information
853 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6_1"></a>E.14. Release Notes for Version 1.6.1</h2></div></div></div><p>Version 1.6.1 includes support for our updated TeleBT v3.0
854 product and bug fixes in in the flight software for all our boards
855 and ground station interfaces.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_14"></a>E.14.1. AltOS</h3></div></div></div><p>AltOS New Features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
856 Add support for TeleBT v3.0 boards.
857 </li><li class="listitem">
858 Add support for uncompressed APRS data, providing support
859 for older APRS receivers. Uncompressed APRS data is less
860 precise, takes more bandwidth and doesn’t have integrated
861 altitude data.
862 </li></ul></div><p>AltOS Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
863 Make TeleDongle and TeleBT more tolerant of data rate
864 variations from transmitting devices.
865 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_8"></a>E.14.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI and TeleGPS New Features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
866 Add map to Monitor Idle display. It’s nice to be able to
867 verify that maps are working, instead of needing to use
868 Monitor Flight.
869 </li></ul></div><p>AltosUI and TeleGPS Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
870 Fix frequency configuration to round values instead of
871 truncate them, avoiding a common 1kHz error in the setting.
872 </li><li class="listitem">
873 Turn the Windows stub into a more useful program that can
874 launch the application with parameters so that file manager
875 icons work more reliably.
876 </li><li class="listitem">
877 Force KML export to use a C locale so that numbers are
878 formatted with <span class="emphasis"><em>.</em></span> instead of <span class="emphasis"><em>,</em></span> for a decimal separator in
879 non-US locales.
880 </li><li class="listitem">
881 Preload map tiles based on distance rather than number of
882 tiles; this means you get the same resolution covering the
883 entire area, rather than having high resolution near the
884 center and low resolution further away.
885 </li><li class="listitem">
886 Allow configuration of frequency and callsign in Monitor
887 Idle mode.
888 </li><li class="listitem">
889 Fix layout weirdness when resizing windows on
890 Windows. Windows shouldn’t have giant blank spaces around
891 the useful content anymore.
892 </li><li class="listitem">
893 Fix layout weirdness when resizing windows on
894 Windows. Windows shouldn’t have giant blank spaces around
895 the useful content anymore.
896 </li><li class="listitem">
897 Use a longer filter for descent speed values. This should
898 provide something more useful on the display, although it
899 will take longer to respond to changes now.
900 </li><li class="listitem">
901 Make Replay Flight run in realtime again. It had been set to
902 run at 10x speed by mistake.
903 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosdroid_2"></a>E.14.3. AltosDroid</h3></div></div></div><p>AltosDroid New Features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
904 Add offline map support using mapping code from AltosUI.
905 </li><li class="listitem">
906 Support TeleDongle (and TeleBT via USB) on devices
907 supporting USB On-The-Go.
908 </li><li class="listitem">
909 Display additional TeleMega pyro channel status in Pad tab.
910 </li><li class="listitem">
911 Switch between metric and imperial units.
912 </li><li class="listitem">
913 Monitor TeleBT battery voltage.
914 </li><li class="listitem">
915 Track multiple devices at the same time, selecting between
916 them with a menu or using the map.
917 </li><li class="listitem">
918 Add hybrid, satellite and terrain map types.
919 </li></ul></div><p>AltosDroid Fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
920 Use standard Android display conventions so that a menu
921 button is available in the application title bar.
922 </li><li class="listitem">
923 Adjust layout to work on large and small screens; shrinking
924 the go/no-go lights in smaller environments to try and make
925 everything visible.
926 </li><li class="listitem">
927 Make voice announcements depend on current tab.
928 </li><li class="listitem">
929 Compute adjustment to current travel direction while in
930 motion towards rocket.
931 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_6"></a>E.15. Release Notes for Version 1.6</h2></div></div></div><p>Version 1.6 includes support for our updated TeleDongle v3.0
932 product and bug fixes in in the flight software for all our boards
933 and ground station interfaces.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_15"></a>E.15.1. AltOS</h3></div></div></div><p>AltOS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
934 Add support for TeleDongle v3.0 boards.
935 </li></ul></div><p>AltOS Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
936 Don’t beep out the continuity twice by accident in idle mode.
937 If the battery voltage report takes longer than the initialiation
938 sequence, the igniter continuity would get reported twice.
939 </li><li class="listitem">
940 Record all 32 bits of gyro calibration data in TeleMega and
941 EasyMega log files. This fixes computation of the gyro rates
942 in AltosUI.
943 </li><li class="listitem">
944 Change TeleDongle LED usage. Green LED flashes when valid
945 packet is received. Red LED flashes when invalid packet is
946 received.
947 </li><li class="listitem">
948 Replace LPC11U14 SPI driver with non-interrupt version. The
949 interrupt code would occasionally wedge on long transfers
950 if interrupts were blocked for too long. This affects all
951 released TeleGPS products; if you have a TeleGPS device,
952 you’ll want to reflash the firmware.
953 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_9"></a>E.15.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI and TeleGPS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
954 Compute tilt angle from TeleMega and EasyMega log
955 files. This duplicates the quaternion-based angle tracking
956 code from the flight firmware inside the ground station
957 software so that post-flight analysis can include evaluation
958 of the tilt angle.
959 </li><li class="listitem">
960 Shows the tool button window when starting with a data file
961 specified. This means that opening a data file from the file
962 manager will now bring up the main window to let you operate
963 the whole application.
964 </li></ul></div><p>AltosUI Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
965 Show the <span class="emphasis"><em>Connecting</em></span> dialog when using Monitor Idle. Lets
966 you cancel the Monitor Idle startup when connecting over the
967 radio link.
968 </li><li class="listitem">
969 Make <span class="emphasis"><em>Monitor Idle</em></span> work for TeleGPS devices when connected
970 over USB. It’s nice for testing without needing to broadcast
971 over the radio.
972 </li><li class="listitem">
973 Use different Windows API to discover USB devices. This
974 works better on my Windows 7 box, and will be used if the
975 older API fails to provide the necessary information.
976 </li><li class="listitem">
977 Look in more places in the registry to try and identify the
978 installed Java version on Windows. If you install the
979 default 32-bit version of Windows on a 64-bit OS, the Java
980 registry information is hiding \SOFTWARE\Wow6432Node for
981 some reason.
982 </li><li class="listitem">
983 Fix file association on Windows by searching for the
984 javaw.exe program instead of assuming it is in
985 %SYSTEMROOT%. This makes double-clicking on Altus Metrum
986 data files in the file manager work correctly.
987 </li><li class="listitem">
988 When replaying a file, put <span class="emphasis"><em>done</em></span> in the Age field when we
989 reach the end of the file, instead of continuing to count forever.
990 </li><li class="listitem">
991 In the Scan Channels code, wait for five seconds if we see
992 any packet. This is needed because AltOS now sends the
993 callsign, serial number and flight number only once every
994 five seconds these days.
995 </li><li class="listitem">
996 In the Scan Channels code, reset pending flight state
997 information each time we change channels. This avoids having
998 flight computers appear on multiple frequencies by accident.
999 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_5"></a>E.16. Release Notes for Version 1.5</h2></div></div></div><p>Version 1.5 is a major release. It includes support for our new
1000 EasyMega product, new features and bug fixes in in the flight
1001 software for all our boards and the AltosUI ground station</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_16"></a>E.16.1. AltOS</h3></div></div></div><p>AltOS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1002 Add support for EasyMega boards.
1003 </li><li class="listitem">
1004 Make the APRS SSID be configurable. This lets you track
1005 different rockets on the same receiver without getting
1006 things mixed up.
1007 </li><li class="listitem">
1008 Report extra pyro channel continuity state on EasyMega and
1009 TeleMega via the beeper. This lets you easily verify flight
1010 readiness on these boards after powering up the electronics
1011 on the rail.
1012 </li><li class="listitem">
1013 Add lower telemetry data rates (2400 and 9600 bps) to
1014 increase telemetry radio range. This reduces the amount of
1015 data received as well as increasing battery consumption in
1016 the transmitter.
1017 </li><li class="listitem">
1018 Change TeleGPS to have only a single log, and append new
1019 data to it rather than using seperate per-flight logs. This
1020 avoids accidentally filling up log storage by turning
1021 TeleGPS on/off several times.
1022 </li></ul></div><p>AltOS Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1023 Increase the maximum range for altitude values from +/-32767m
1024 to +/-2147483647m, allowing the flight computers to function
1025 correctly above the 32km level.
1026 </li><li class="listitem">
1027 Continuously test pyro firing conditions during delay stage,
1028 inhibiting the pyro channel if the test fails. This prevents
1029 firing pyro charges where the conditions were good before
1030 the delay, but become bad before the delay expires.
1031 </li><li class="listitem">
1032 Allow negative numbers in pyro configuration values. This
1033 lets you specify things like descending speed or
1034 deceleration.
1035 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_10"></a>E.16.2. AltosUI and TeleGPS Applications</h3></div></div></div><p>AltosUI and TeleGPS New Features</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1036 Support telemetry baud rate selection. Adds menus to
1037 the flight monitoring and configuration for baud rate
1038 selection.
1039 </li><li class="listitem">
1040 Support APRS SSID configuration.
1041 </li><li class="listitem">
1042 Integrate with file managers. This provides icons for all of
1043 our file types and associates our application with the files
1044 so that using a file manager to open a AltOS data file
1045 results in launching our application.
1046 </li></ul></div><p>AltosUI Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1047 Make the <span class="emphasis"><em>Graph</em></span> button on the landed tab work again.
1048 </li><li class="listitem">
1049 Make tests for Java on Windows a bit smarter, and also
1050 provide the user with the option to skip installing Java for
1051 cases where we just can’t figure out what version is installed.
1052 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_4_2"></a>E.17. Release Notes for Version 1.4.2</h2></div></div></div><p>Version 1.4.2 is a minor release. It fixes Java-related install issues on
1053 Windows</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_11"></a>E.17.1. AltosUI and TeleGPS Applications</h3></div></div></div><p>Windows Install Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1054 Checks for Java installation data in more registry locations.
1055 </li><li class="listitem">
1056 Allows user to bypass Java installation in case the
1057 detection fails.
1058 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_4_1"></a>E.18. Release Notes for Version 1.4.1</h2></div></div></div><p>Version 1.4.1 is a minor release. It fixes install issues on
1059 Windows and provides the missing TeleMetrum V2.0 firmware. There
1060 aren’t any changes to the firmware or host applications at
1061 all. All Windows users will want to upgrade to get the signed
1062 driver, but Mac and Linux users who do not need the TeleMetrum
1063 V2.0 firmware image will not need to upgrade.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_and_telegps_applications_12"></a>E.18.1. AltosUI and TeleGPS Applications:</h3></div></div></div><p>Windows Install Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1064 Provide signed Windows driver files. This should avoid any need to
1065 disable driver signature checking on Windows 7 or 8.
1066 </li><li class="listitem">
1067 Fix Java version detection and download. Previously, the
1068 installer would only look for Java 6 or 7 and insist on
1069 downloading its own Java bits if there was something else
1070 installed. Furthermore, the 64-bit Java link provided didn’t
1071 work for anyone other than Keith, making it impossible to
1072 install AltOS on any machine with Java SE 8 installed.
1073 </li></ul></div><p>Other Fixes</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1074 Include 1.4 firmware for TeleMetrum V2.0. None of the
1075 installers shipped this file. Now it’s included in the AltOS
1076 packages for Linux, Mac and Windows.
1077 </li><li class="listitem">
1078 Include Google Application Key for map downloading. The 1.4
1079 release didn’t have this key in the released version of the
1080 software, making map downloading fail for most people.
1081 </li></ul></div><p></p></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_release_notes_for_version_1_4"></a>E.19. Release Notes for Version 1.4</h2></div></div></div><p>Version 1.4 is a major release. It includes support for our new
1082 TeleGPS product, new features and bug fixes in in the flight
1083 software for all our boards and the AltosUI ground station</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altos_17"></a>E.19.1. AltOS</h3></div></div></div><p>AltOS new features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1084 Add support for TeleGPS boards.
1085 </li><li class="listitem">
1086 Make the beeper tone configurable, making it
1087 possible to distinguish between two Altus Metrum
1088 products in the same ebay.
1089 </li><li class="listitem">
1090 Make the firing time for extra pyro channels
1091 configurable, allowing longer (or shorter) than the
1092 default 50ms.  Only relevant for TeleMega at this
1093 time.
1094 </li></ul></div><p>AltOS fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1095 Replace the <span class="emphasis"><em>dit dit dit</em></span> tones at startup with the
1096 current battery voltage, measured in tenths of a
1097 volt. This lets you check the battery voltage
1098 without needing telemetry, which is especially
1099 useful on EasyMini.
1100 </li><li class="listitem">
1101 Change state beeping to "Farnsworth spacing", which
1102 means they’re quite a bit faster than before, and so
1103 they take less time to send.
1104 </li><li class="listitem">
1105 Fix bug preventing the selection of the <span class="emphasis"><em>Flight
1106 State After</em></span> mode in pyro configuration.
1107 </li><li class="listitem">
1108 Fix bug where erasing flights would reset the flight
1109 number to 2 on TeleMega and TeleMetrum v2.
1110 </li><li class="listitem">
1111 Fix u-Blox GPS driver to mark course and speed data
1112 as being present.
1113 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_altosui_application"></a>E.19.2. AltosUI Application</h3></div></div></div><p>AltosUI new features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1114 Add zooming and new content types (terrain and road
1115 maps) to map view. Change map storage format from
1116 PNG to Jpeg, which saves a huge amount of disk
1117 space. You will need to re-download all of your
1118 pre-loaded map images.
1119 </li><li class="listitem">
1120 Add a distance measuring device to the maps
1121 view. Select this by using any button other than the
1122 left one, or by pressing shift or control on the
1123 keyboard while using the left button.
1124 </li><li class="listitem">
1125 Add new <span class="emphasis"><em>Ignitor</em></span> tab to the flight monitor display
1126 for TeleMega’s extra ignitors.
1127 </li><li class="listitem">
1128 Add additional ignitor firing marks and voltages to
1129 the graph so you can see when the ignitors fired,
1130 along with the ignitor voltages.
1131 </li><li class="listitem">
1132 Add GPS course, ground speed and climb rate as
1133 optional graph elements.
1134 </li></ul></div><p>AltosUI fixes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1135 When flashing new firmware, re-try opening the
1136 device as sometimes it takes a while for the
1137 underlying operating system to recognize that the
1138 device has rebooted in preparation for the flashing
1139 operation.
1140 </li><li class="listitem">
1141 Hide Tilt Angle in ascent tab for devices that don’t
1142 have a gyro.
1143 </li><li class="listitem">
1144 Increase the width of data lines in the graphs to
1145 make them easier to read.
1146 </li><li class="listitem">
1147 Filter out speed and acceleration spikes caused by
1148 ejection charge firing when computing the maximum
1149 values. This provides a more accurate reading of
1150 those maximums.
1151 </li><li class="listitem">
1152 Fix EasyMini voltage displays. Early EasyMini
1153 prototypes used a 3.0V regulator, and AltosUI still
1154 used that value as the basis of the
1155 computation. Production EasyMini boards have always
1156 shipped with a 3.3V regulator. Also, purple EasyMini
1157 boards sensed the battery voltage past the blocking
1158 diode, resulting in a drop of about 150mV from the
1159 true battery voltage. Compensate for that when
1160 displaying the value.
1161 </li><li class="listitem">
1162 Display error message when trying to configure
1163 maximum flight log size while the flight computer
1164 still has flight data stored.
1165 </li><li class="listitem">
1166 Handle TeleMetrum and TeleMini eeprom files
1167 generated with pre-1.0 firmware. Those ancient
1168 versions didn’t report the log format, so just use
1169 the product name instead.
1170 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_telegps_application_2"></a>E.19.3. TeleGPS Application</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1171 New application designed for use with TeleGPS boards.
1172 </li><li class="listitem">
1173 Shares code with AltosUI, mostly just trimmed down
1174 to focus on TeleGPS-related functions.
1175 </li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="_documentation_4"></a>E.19.4. Documentation</h3></div></div></div><p>Documentation changes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
1176 Re-create the drill template images; they should
1177 print correctly from Firefox at least. Ship these as
1178 individual PDF files so they’re easy to print.
1179 </li><li class="listitem">
1180 Add a description of the <span class="emphasis"><em>Apogee Lockout</em></span> setting,
1181 which prevents the apogee charge from firing for a
1182 configurable amount of time after boost.
1183 </li></ul></div></div></div></div></div></body></html>