update docs
[web/altusmetrum] / AltOS / doc / altusmetrum.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="UTF-8">
5 <meta http-equiv="X-UA-Compatible" content="IE=edge">
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <meta name="generator" content="Asciidoctor 2.0.10">
8 <meta name="author" content="Keith Packard, Bdale Garbee, Bob Finch, Anthony Towns">
9 <meta name="copyright" content="Bdale Garbee and Keith Packard 2020">
10 <title>The Altus Metrum System: An Owner&#8217;s Manual for Altus Metrum Rocketry Electronics</title>
11 <link rel="stylesheet" href="./am.css">
12 </head>
13 <body class="book">
14 <div id="header">
15 <h1>The Altus Metrum System: An Owner&#8217;s Manual for Altus Metrum Rocketry Electronics</h1>
16 <div class="details">
17 <span id="author" class="author">Keith Packard</span><br>
18 <span id="email" class="email"><a href="mailto:keithp@keithp.com">keithp@keithp.com</a></span><br>
19 <span id="author2" class="author">Bdale Garbee</span><br>
20 <span id="email2" class="email"><a href="mailto:bdale@gag.com">bdale@gag.com</a></span><br>
21 <span id="author3" class="author">Bob Finch</span><br>
22 <span id="author4" class="author">Anthony Towns</span><br>
23 <span id="revnumber">version v1.9.4,</span>
24 <span id="revdate">02 Jul 2020</span>
25 </div>
26 <div id="toc" class="toc">
27 <div id="toctitle">Table of Contents</div>
28 <ul class="sectlevel1">
29 <li><a href="#_license">License</a></li>
30 <li><a href="#_acknowledgments">Acknowledgments</a></li>
31 <li><a href="#_introduction_and_overview">1. Introduction and Overview</a></li>
32 <li><a href="#_getting_started">2. Getting Started</a>
33 <ul class="sectlevel2">
34 <li><a href="#_batteries">2.1. Batteries</a></li>
35 <li><a href="#_ground_station_hardware">2.2. Ground Station Hardware</a></li>
36 <li><a href="#_linuxmacwindows_ground_station_software">2.3. Linux/Mac/Windows Ground Station Software</a></li>
37 <li><a href="#_android_ground_station_software">2.4. Android Ground Station Software</a></li>
38 </ul>
39 </li>
40 <li><a href="#_using_altus_metrum_hardware">3. Using Altus Metrum Hardware</a>
41 <ul class="sectlevel2">
42 <li><a href="#_wiring_and_electrical_interference">3.1. Wiring and Electrical Interference</a></li>
43 <li><a href="#_hooking_up_lithium_polymer_batteries">3.2. Hooking Up Lithium Polymer Batteries</a></li>
44 <li><a href="#_hooking_up_pyro_charges">3.3. Hooking Up Pyro Charges</a></li>
45 <li><a href="#_hooking_up_a_power_switch">3.4. Hooking Up a Power Switch</a></li>
46 <li><a href="#_understanding_beeps">3.5. Understanding Beeps</a></li>
47 <li><a href="#_turning_on_the_power">3.6. Turning On the Power</a></li>
48 <li><a href="#_using_an_external_active_switch_circuit">3.7. Using an External Active Switch Circuit</a></li>
49 <li><a href="#_using_a_separate_pyro_battery">3.8. Using a Separate Pyro Battery</a></li>
50 <li><a href="#_using_a_different_kind_of_battery">3.9. Using a Different Kind of Battery</a></li>
51 <li><a href="#_using_packet_link_mode">3.10. Using Packet Link Mode</a></li>
52 </ul>
53 </li>
54 <li><a href="#_telemetrum">4. TeleMetrum</a>
55 <ul class="sectlevel2">
56 <li><a href="#_telemetrum_screw_terminals">4.1. TeleMetrum Screw Terminals</a></li>
57 <li><a href="#_using_a_separate_pyro_battery_with_telemetrum">4.2. Using a Separate Pyro Battery with TeleMetrum</a></li>
58 <li><a href="#_using_an_active_switch_with_telemetrum">4.3. Using an Active Switch with TeleMetrum</a></li>
59 </ul>
60 </li>
61 <li><a href="#_telemini">5. TeleMini</a>
62 <ul class="sectlevel2">
63 <li><a href="#_telemini_v3_screw_terminals">5.1. TeleMini v3 Screw Terminals</a></li>
64 <li><a href="#_using_a_separate_pyro_battery_with_telemini_v3">5.2. Using a Separate Pyro Battery with TeleMini v3</a></li>
65 <li><a href="#_using_an_active_switch_with_telemini_v3">5.3. Using an Active Switch with TeleMini v3</a></li>
66 <li><a href="#_using_packet_link_mode_with_telemini">5.4. Using Packet Link Mode with TeleMini</a></li>
67 <li><a href="#_forcing_telemini_radio_parameters_to_known_defaults">5.5. Forcing TeleMini radio parameters to known defaults</a></li>
68 <li><a href="#_telemini_v1">5.6. TeleMini v1</a></li>
69 </ul>
70 </li>
71 <li><a href="#_easymini">6. EasyMini</a>
72 <ul class="sectlevel2">
73 <li><a href="#_easymini_screw_terminals">6.1. EasyMini Screw Terminals</a></li>
74 <li><a href="#_connecting_a_battery_to_easymini">6.2. Connecting A Battery To EasyMini</a></li>
75 <li><a href="#_charging_lithium_batteries">6.3. Charging Lithium Batteries</a></li>
76 <li><a href="#_using_a_separate_pyro_battery_with_easymini">6.4. Using a Separate Pyro Battery with EasyMini</a></li>
77 <li><a href="#_using_an_active_switch_with_easymini">6.5. Using an Active Switch with EasyMini</a></li>
78 </ul>
79 </li>
80 <li><a href="#_telemega">7. TeleMega</a>
81 <ul class="sectlevel2">
82 <li><a href="#_telemega_screw_terminals">7.1. TeleMega Screw Terminals</a></li>
83 <li><a href="#_using_a_separate_pyro_battery_with_telemega">7.2. Using a Separate Pyro Battery with TeleMega</a></li>
84 <li><a href="#_using_only_one_battery_with_telemega">7.3. Using Only One Battery With TeleMega</a></li>
85 <li><a href="#_using_an_active_switch_with_telemega">7.4. Using an Active Switch with TeleMega</a></li>
86 </ul>
87 </li>
88 <li><a href="#_easymega">8. EasyMega</a>
89 <ul class="sectlevel2">
90 <li><a href="#_easymega_screw_terminals">8.1. EasyMega Screw Terminals</a></li>
91 <li><a href="#_using_a_separate_pyro_battery_with_easymega">8.2. Using a Separate Pyro Battery with EasyMega</a></li>
92 <li><a href="#_using_only_one_battery_with_easymega">8.3. Using Only One Battery With EasyMega</a></li>
93 <li><a href="#_using_an_active_switch_with_easymega">8.4. Using an Active Switch with EasyMega</a></li>
94 </ul>
95 </li>
96 <li><a href="#_easytimer">9. EasyTimer</a>
97 <ul class="sectlevel2">
98 <li><a href="#_easytimer_screw_terminals">9.1. EasyTimer Screw Terminals</a></li>
99 <li><a href="#_connecting_a_battery_to_easytimer">9.2. Connecting A Battery To EasyTimer</a></li>
100 <li><a href="#_charging_lithium_batteries_2">9.3. Charging Lithium Batteries</a></li>
101 <li><a href="#_using_a_separate_pyro_battery_with_easytimer">9.4. Using a Separate Pyro Battery with EasyTimer</a></li>
102 <li><a href="#_using_an_active_switch_with_easytimer">9.5. Using an Active Switch with EasyTimer</a></li>
103 </ul>
104 </li>
105 <li><a href="#_installation">10. Installation</a></li>
106 <li><a href="#_using_altus_metrum_products">11. Using Altus Metrum Products</a>
107 <ul class="sectlevel2">
108 <li><a href="#_being_legal">11.1. Being Legal</a></li>
109 <li><a href="#_in_the_rocket">11.2. In the Rocket</a></li>
110 <li><a href="#_on_the_ground">11.3. On the Ground</a></li>
111 <li><a href="#_data_analysis">11.4. Data Analysis</a></li>
112 <li><a href="#_future_plans">11.5. Future Plans</a></li>
113 </ul>
114 </li>
115 <li><a href="#_altosui">12. AltosUI</a>
116 <ul class="sectlevel2">
117 <li><a href="#_monitor_flight">12.1. Monitor Flight</a></li>
118 <li><a href="#_save_flight_data">12.2. Save Flight Data</a></li>
119 <li><a href="#_replay_flight">12.3. Replay Flight</a></li>
120 <li><a href="#_graph_data">12.4. Graph Data</a></li>
121 <li><a href="#_export_data">12.5. Export Data</a></li>
122 <li><a href="#_configure_altimeter">12.6. Configure Altimeter</a></li>
123 <li><a href="#_configure_altosui">12.7. Configure AltosUI</a></li>
124 <li><a href="#_configure_groundstation">12.8. Configure Groundstation</a></li>
125 <li><a href="#_flash_image">12.9. Flash Image</a></li>
126 <li><a href="#_fire_igniter">12.10. Fire Igniter</a></li>
127 <li><a href="#_scan_channels">12.11. Scan Channels</a></li>
128 <li><a href="#_load_maps">12.12. Load Maps</a></li>
129 <li><a href="#_monitor_idle">12.13. Monitor Idle</a></li>
130 </ul>
131 </li>
132 <li><a href="#_altosdroid">13. AltosDroid</a>
133 <ul class="sectlevel2">
134 <li><a href="#_installing_altosdroid">13.1. Installing AltosDroid</a></li>
135 <li><a href="#_charging_telebt_battery">13.2. Charging TeleBT Battery</a></li>
136 <li><a href="#_connecting_to_telebt_over_bluetooth">13.3. Connecting to TeleBT over Bluetooth™</a></li>
137 <li><a href="#_connecting_to_teledongle_or_telebt_over_usb">13.4. Connecting to TeleDongle or TeleBT over USB</a></li>
138 <li><a href="#_altosdroid_menu">13.5. AltosDroid Menu</a></li>
139 <li><a href="#_setup">13.6. Setup</a></li>
140 <li><a href="#_idle_mode">13.7. Idle Mode</a></li>
141 <li><a href="#_altosdroid_flight_monitoring">13.8. AltosDroid Flight Monitoring</a></li>
142 <li><a href="#_pad">13.9. Pad</a></li>
143 <li><a href="#_flight">13.10. Flight</a></li>
144 <li><a href="#_recover">13.11. Recover</a></li>
145 <li><a href="#_map_2">13.12. Map</a></li>
146 <li><a href="#_downloading_flight_logs">13.13. Downloading Flight Logs</a></li>
147 </ul>
148 </li>
149 <li><a href="#_system_operation">Appendix A: System Operation</a>
150 <ul class="sectlevel2">
151 <li><a href="#_firmware_modes">A.1. Firmware Modes</a></li>
152 <li><a href="#_gps">A.2. GPS</a></li>
153 <li><a href="#_controlling_an_altimeter_over_the_radio_link">A.3. Controlling An Altimeter Over The Radio Link</a></li>
154 <li><a href="#_ground_testing">A.4. Ground Testing</a></li>
155 <li><a href="#_radio_link">A.5. Radio Link</a></li>
156 <li><a href="#_aprs">A.6. APRS</a></li>
157 <li><a href="#_configurable_parameters">A.7. Configurable Parameters</a></li>
158 </ul>
159 </li>
160 <li><a href="#_handling_precautions">Appendix B: Handling Precautions</a></li>
161 <li><a href="#_updating_device_firmware">Appendix C: Updating Device Firmware</a>
162 <ul class="sectlevel2">
163 <li><a href="#_updating_telemega_telemetrum_v2_or_newer_easymega_easymini_teledongle_v3_or_telebt_v3_firmware">C.1. Updating TeleMega, TeleMetrum v2 or newer, EasyMega, EasyMini, TeleDongle v3 or TeleBT v3 Firmware</a></li>
164 <li><a href="#_pair_programming">C.2. Pair Programming</a></li>
165 </ul>
166 </li>
167 <li><a href="#_flight_data_recording">Appendix D: Flight Data Recording</a></li>
168 <li><a href="#_altus_metrum_hardware_specifications">Appendix E: Altus Metrum Hardware Specifications</a></li>
169 <li><a href="#_release_notes">Appendix F: Release Notes</a>
170 <ul class="sectlevel2">
171 <li><a href="#_release_notes_for_version_1_9_4">F.1. Release Notes for Version 1.9.4</a></li>
172 <li><a href="#_release_notes_for_version_1_9_3">F.2. Release Notes for Version 1.9.3</a></li>
173 <li><a href="#_release_notes_for_version_1_9_2">F.3. Release Notes for Version 1.9.2</a></li>
174 <li><a href="#_release_notes_for_version_1_9_1">F.4. Release Notes for Version 1.9.1</a></li>
175 <li><a href="#_release_notes_for_version_1_9">F.5. Release Notes for Version 1.9</a></li>
176 <li><a href="#_release_notes_for_version_1_8_7">F.6. Release Notes for Version 1.8.7</a></li>
177 <li><a href="#_release_notes_for_version_1_8_6">F.7. Release Notes for Version 1.8.6</a></li>
178 <li><a href="#_release_notes_for_version_1_8_5">F.8. Release Notes for Version 1.8.5</a></li>
179 <li><a href="#_release_notes_for_version_1_8_4">F.9. Release Notes for Version 1.8.4</a></li>
180 <li><a href="#_release_notes_for_version_1_8_3">F.10. Release Notes for Version 1.8.3</a></li>
181 <li><a href="#_release_notes_for_version_1_8_2">F.11. Release Notes for Version 1.8.2</a></li>
182 <li><a href="#_release_notes_for_version_1_8_1">F.12. Release Notes for Version 1.8.1</a></li>
183 <li><a href="#_release_notes_for_version_1_8">F.13. Release Notes for Version 1.8</a></li>
184 <li><a href="#_release_notes_for_version_1_7">F.14. Release Notes for Version 1.7</a></li>
185 <li><a href="#_release_notes_for_version_1_6_8">F.15. Release Notes for Version 1.6.8</a></li>
186 <li><a href="#_release_notes_for_version_1_6_5">F.16. Release Notes for Version 1.6.5</a></li>
187 <li><a href="#_release_notes_for_version_1_6_4">F.17. Release Notes for Version 1.6.4</a></li>
188 <li><a href="#_release_notes_for_version_1_6_3">F.18. Release Notes for Version 1.6.3</a></li>
189 <li><a href="#_release_notes_for_version_1_6_2">F.19. Release Notes for Version 1.6.2</a></li>
190 <li><a href="#_release_notes_for_version_1_6_1">F.20. Release Notes for Version 1.6.1</a></li>
191 <li><a href="#_release_notes_for_version_1_6">F.21. Release Notes for Version 1.6</a></li>
192 <li><a href="#_release_notes_for_version_1_5">F.22. Release Notes for Version 1.5</a></li>
193 <li><a href="#_release_notes_for_version_1_4_2">F.23. Release Notes for Version 1.4.2</a></li>
194 <li><a href="#_release_notes_for_version_1_4_1">F.24. Release Notes for Version 1.4.1</a></li>
195 <li><a href="#_release_notes_for_version_1_4">F.25. Release Notes for Version 1.4</a></li>
196 <li><a href="#_release_notes_for_version_1_3_2">F.26. Release Notes for Version 1.3.2</a></li>
197 <li><a href="#_release_notes_for_version_1_3_1">F.27. Release Notes for Version 1.3.1</a></li>
198 <li><a href="#_release_notes_for_version_1_3">F.28. Release Notes for Version 1.3</a></li>
199 <li><a href="#_release_notes_for_version_1_2_1">F.29. Release Notes for Version 1.2.1</a></li>
200 <li><a href="#_release_notes_for_version_1_2">F.30. Release Notes for Version 1.2</a></li>
201 <li><a href="#_release_notes_for_version_1_1">F.31. Release Notes for Version 1.1</a></li>
202 <li><a href="#_release_notes_for_version_1_1_2">F.32. Release Notes for Version 1.1</a></li>
203 <li><a href="#_release_notes_for_version_1_0_1">F.33. Release Notes for Version 1.0.1</a></li>
204 <li><a href="#_release_notes_for_version_0_9_2">F.34. Release Notes for Version 0.9.2</a></li>
205 <li><a href="#_release_notes_for_version_0_9">F.35. Release Notes for Version 0.9</a></li>
206 <li><a href="#_release_notes_for_version_0_8">F.36. Release Notes for Version 0.8</a></li>
207 <li><a href="#_release_notes_for_version_0_7_1">F.37. Release Notes for Version 0.7.1</a></li>
208 </ul>
209 </li>
210 </ul>
211 </div>
212 </div>
213 <div id="content">
214 <div id="preamble">
215 <div class="sectionbody">
216 <div id="logo" class="imageblock">
217 <div class="content">
218 <a class="image" href="https://altusmetrum.org"><img src="altusmetrum-oneline.svg" alt="Altus Metrum"></a>
219 </div>
220 </div>
221 </div>
222 </div>
223 <div class="sect1">
224 <h2 id="_license">License</h2>
225 <div class="sectionbody">
226 <div class="paragraph">
227 <p>Copyright © 2018 Bdale Garbee and Keith Packard</p>
228 </div>
229 <div class="paragraph">
230 <p>This document is released under the terms of the <a href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons ShareAlike 3.0 License</a></p>
231 </div>
232 </div>
233 </div>
234 <div class="sect1">
235 <h2 id="_acknowledgments">Acknowledgments</h2>
236 <div class="sectionbody">
237 <div class="paragraph">
238 <p>Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing “The
239 Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter
240 Kit” which formed the basis of the original Getting Started chapter
241 in this manual.  Bob was one of our first customers for a production
242 TeleMetrum, and his continued enthusiasm and contributions
243 are immensely gratifying and highly appreciated!</p>
244 </div>
245 <div class="paragraph">
246 <p>And thanks to Anthony (AJ) Towns for major contributions including
247 the AltosUI graphing and site map code and associated documentation.
248 Free software means that our customers and friends can become our
249 collaborators, and we certainly appreciate this level of
250 contribution!</p>
251 </div>
252 <div class="paragraph">
253 <p>Have fun using these products, and we hope to meet all of you
254 out on the rocket flight line somewhere.</p>
255 </div>
256 <div class="verseblock">
257 <pre class="content">Bdale Garbee, KB0G
258 NAR #87103, TRA #12201</pre>
259 </div>
260 <div class="verseblock">
261 <pre class="content">Keith Packard, KD7SQG
262 NAR #88757, TRA #12200</pre>
263 </div>
264 </div>
265 </div>
266 <div class="sect1">
267 <h2 id="_introduction_and_overview">1. Introduction and Overview</h2>
268 <div class="sectionbody">
269 <div class="paragraph">
270 <p>Welcome to the Altus Metrum community!  Our circuits and software reflect
271 our passion for both hobby rocketry and Free Software.  We hope their
272 capabilities and performance will delight you in every way, but by
273 releasing all of our hardware and software designs under open licenses,
274 we also hope to empower you to take as active a role in our collective
275 future as you wish!</p>
276 </div>
277 <div class="paragraph">
278 <p>Our goal is to include in this document all of the information required
279 to successfully configure and use Altus Metrum products.  But
280 documentation is a lot like software in that it can contain "bugs",
281 and can probably always be improved!  If you have questions that
282 aren&#8217;t answered in this manual, or just need a little help figuring
283 things out, we strongly suggest joining the Altus Metrum user email
284 list, which you can do by visiting
285 <a href="https://lists.gag.com/mailman/listinfo/altusmetrum" class="bare">https://lists.gag.com/mailman/listinfo/altusmetrum</a>.  There&#8217;s a lot
286 of useful information in the mailing list archives!</p>
287 </div>
288 <div class="paragraph">
289 <p>The first device created for our community was TeleMetrum, a dual
290 deploy altimeter with fully integrated GPS and radio telemetry
291 as standard features, and a “companion interface” that will
292 support optional capabilities in the future. The later versions
293 of TeleMetrum, v2 and newer, have all of the same features but with
294 improved sensors and radio to offer increased performance.</p>
295 </div>
296 <div class="paragraph">
297 <p>Our second device was TeleMini, a dual deploy altimeter with
298 radio telemetry and radio direction finding. The first version
299 of this device was only 13mm by 38mm (½ inch by 1½ inches) and
300 could fit easily in an 18mm air-frame. The latest version, v3.0,
301 includes a beeper, higher power radio, extended on-board
302 flight logging and an improved barometric sensor.</p>
303 </div>
304 <div class="paragraph">
305 <p>TeleMega is our most sophisticated device, including six pyro
306 channels (four of which are fully programmable), integrated GPS,
307 integrated gyroscopes for staging/air-start inhibit and high
308 performance telemetry.</p>
309 </div>
310 <div class="paragraph">
311 <p>EasyMini is a dual-deploy altimeter with logging and built-in
312 USB data download.</p>
313 </div>
314 <div class="paragraph">
315 <p>EasyMega is essentially a TeleMega board with the GPS receiver
316 and telemetry transmitter removed. It offers the same 6 pyro
317 channels and integrated gyroscopes for staging/air-start inhibit.</p>
318 </div>
319 <div class="paragraph">
320 <p>TeleDongle v0.2 was our first ground station, providing a USB to RF
321 interfaces for communicating with the altimeters. Combined with
322 your choice of antenna and notebook computer, TeleDongle and our
323 associated user interface software form a complete ground
324 station capable of logging and displaying in-flight telemetry,
325 aiding rocket recovery, then processing and archiving flight
326 data for analysis and review. The latest version, TeleDongle
327 v3, has all new electronics with a higher performance radio
328 for improved range.</p>
329 </div>
330 <div class="paragraph">
331 <p>For a slightly more portable ground station experience that also
332 provides direct rocket recovery support, TeleBT offers flight
333 monitoring and data logging using a  Bluetooth™ connection between
334 the receiver and an Android device that has the AltosDroid
335 application installed from the Google Play store.</p>
336 </div>
337 <div class="paragraph">
338 <p>More products will be added to the Altus Metrum family over time, and
339 we currently envision that this will be a single, comprehensive manual
340 for the entire product family.</p>
341 </div>
342 </div>
343 </div>
344 <div class="sect1">
345 <h2 id="_getting_started">2. Getting Started</h2>
346 <div class="sectionbody">
347 <div class="paragraph">
348 <p>The first thing to do after you open the box is to hook up a
349 battery and charge it if necessary.</p>
350 </div>
351 <div class="sect2">
352 <h3 id="_batteries">2.1. Batteries</h3>
353 <div class="paragraph">
354 <p>For TeleMetrum, TeleMega and EasyMega, the battery can be charged by plugging it into the
355 corresponding socket of the device and then using the USB
356 cable to plug the flight computer into your computer&#8217;s USB socket. The
357 on-board circuitry will charge the battery whenever it is plugged
358 in, because the on-off switch does NOT control the
359 charging circuitry.
360 The Lithium Polymer
361 EasyTimer,
362 TeleMini and
363 EasyMini battery can be charged by disconnecting it
364 from the board and plugging it into a standalone
365 battery charger such as <a href="http://altusmetrum.org/LipoCharger">LipoCharger</a>, and
366 connecting that via a USB cable to a laptop or other
367 USB power source.</p>
368 </div>
369 <div class="paragraph">
370 <p>You can also choose to use another battery with
371 EasyTimer and
372 EasyMini, anything supplying between 4 and 12 volts should
373 work fine (like a standard 9V battery), but if you are planning
374 to fire pyro charges, ground testing is required to verify that
375 the battery supplies enough current to fire your chosen e-matches.</p>
376 </div>
377 <div class="admonitionblock note">
378 <table>
379 <tr>
380 <td class="icon">
381 <img src="./images/icons/note.svg" alt="Note">
382 </td>
383 <td class="content">
384 <div class="paragraph">
385 <p>On TeleMetrum v1 boards, when the GPS chip is initially
386 searching for satellites, TeleMetrum will consume more current
387 than it pulls from the USB port, so the battery must be
388 attached in order to get satellite lock.  Once GPS is locked,
389 the current consumption goes back down enough to enable charging
390 while running. So it&#8217;s a good idea to fully charge the battery
391 as your first item of business so there is no issue getting and
392 maintaining satellite lock.  The yellow charge indicator led
393 will go out when the battery is nearly full and the charger goes
394 to trickle charge. It can take several hours to fully recharge a
395 deeply discharged battery.</p>
396 </div>
397 <div class="paragraph">
398 <p>TeleMetrum v2 or newer, TeleMega and EasyMega use a
399 higher power battery charger, allowing them to charge
400 the battery while running the board at maximum
401 power. When the battery is charging, or when the board
402 is consuming a lot of power, the red LED will be
403 lit. When the battery is fully charged, the green LED
404 will be lit. When the battery is damaged or missing,
405 both LEDs will be lit, which appears yellow.</p>
406 </div>
407 </td>
408 </tr>
409 </table>
410 </div>
411 </div>
412 <div class="sect2">
413 <h3 id="_ground_station_hardware">2.2. Ground Station Hardware</h3>
414 <div class="paragraph">
415 <p>There are two ground stations available, the TeleDongle USB to
416 RF interface and the TeleBT Bluetooth/USB to RF interface.  If
417 you plug either of these in to your Mac or Linux computer it should
418 “just work”, showing up as a serial port device.  Windows systems need
419 driver information that is part of the AltOS download to know that the
420 existing USB modem driver will work.  We therefore recommend installing
421 our software before plugging in TeleDongle if you are using a Windows
422 computer.  If you are using an older version of Linux and are having
423 problems, try moving to a fresher kernel (2.6.33 or
424 newer).</p>
425 </div>
426 </div>
427 <div class="sect2">
428 <h3 id="_linuxmacwindows_ground_station_software">2.3. Linux/Mac/Windows Ground Station Software</h3>
429 <div class="paragraph">
430 <p>Next you should obtain and install the AltOS software.
431 The AltOS distribution includes the AltosUI ground
432 station program, current firmware images for all of
433 the hardware, and a number of standalone utilities
434 that are rarely needed.  Pre-built binary packages are
435 available for Linux, Microsoft Windows, Mac OSX. Full
436 source code and build instructions are also
437 available. The latest version may always be downloaded
438 from <a href="http://altusmetrum.org/AltOS" class="bare">http://altusmetrum.org/AltOS</a></p>
439 </div>
440 </div>
441 <div class="sect2">
442 <h3 id="_android_ground_station_software">2.4. Android Ground Station Software</h3>
443 <div class="paragraph">
444 <p>TeleBT can also connect to an Android device over
445 BlueTooth or USB. The
446 <a href="https://play.google.com/store/apps/details?id=org.altusmetrum.AltosDroid">AltosDroid
447 Android application</a> is available from the
448 <a href="https://play.google.com">Google Play system</a>.</p>
449 </div>
450 <div class="paragraph">
451 <p>You don&#8217;t need a data plan to use AltosDroid, but
452 without network access, you&#8217;ll want to download
453 offline map data before wandering away from the
454 network.</p>
455 </div>
456 </div>
457 </div>
458 </div>
459 <div class="sect1">
460 <h2 id="_using_altus_metrum_hardware">3. Using Altus Metrum Hardware</h2>
461 <div class="sectionbody">
462 <div class="paragraph">
463 <p>Here are general instructions for hooking up an Altus Metrum
464 flight computer. Instructions specific to each model will be
465 found in the section devoted to that model below.</p>
466 </div>
467 <div class="sect2">
468 <h3 id="_wiring_and_electrical_interference">3.1. Wiring and Electrical Interference</h3>
469 <div class="paragraph">
470 <p>To prevent electrical interference from affecting the
471 operation of the flight computer, it&#8217;s important to always
472 twist pairs of wires connected to the board. Twist the switch
473 leads, the pyro leads and the battery leads. This reduces
474 interference through a mechanism called common mode rejection.</p>
475 </div>
476 </div>
477 <div class="sect2">
478 <h3 id="_hooking_up_lithium_polymer_batteries">3.2. Hooking Up Lithium Polymer Batteries</h3>
479 <div class="paragraph">
480 <p>All Altus Metrum flight computers have a two pin JST PH
481 series connector to connect up a single-cell Lithium Polymer
482 cell (3.7V nominal). You can purchase matching batteries
483 from the Altus Metrum store, or other vendors, or you can
484 make your own. Pin 1 of the connector is positive, pin 2 is
485 negative. Spark Fun sells a cable with the connector
486 attached, which they call a
487 <a href="https://www.sparkfun.com/products/9914">JST Jumper 2 Wire Assembly</a></p>
488 </div>
489 <div class="admonitionblock warning">
490 <table>
491 <tr>
492 <td class="icon">
493 <img src="./images/icons/warning.svg" alt="Warning">
494 </td>
495 <td class="content">
496 Many RC vendors also sell lithium polymer batteries with
497 this same connector. All that we have found use the opposite
498 polarity, and if you use them that way, you will damage or
499 destroy the flight computer.
500 </td>
501 </tr>
502 </table>
503 </div>
504 </div>
505 <div class="sect2">
506 <h3 id="_hooking_up_pyro_charges">3.3. Hooking Up Pyro Charges</h3>
507 <div class="paragraph">
508 <p>Altus Metrum flight computers always have two screws for
509 each pyro charge. This means you shouldn&#8217;t need to put two
510 wires into a screw terminal or connect leads from pyro
511 charges together externally.</p>
512 </div>
513 <div class="paragraph">
514 <p>On the flight computer, one lead from each charge is hooked
515 to the positive battery terminal through the power switch.
516 The other lead is connected through the pyro circuit, which
517 is connected to the negative battery terminal when the pyro
518 circuit is fired.</p>
519 </div>
520 </div>
521 <div class="sect2">
522 <h3 id="_hooking_up_a_power_switch">3.4. Hooking Up a Power Switch</h3>
523 <div class="paragraph">
524 <p>Altus Metrum flight computers need an external power switch
525 to turn them on. This disconnects both the computer and the
526 pyro charges from the battery, preventing the charges from
527 firing when in the Off position. The switch is in-line with
528 the positive battery terminal.</p>
529 </div>
530 </div>
531 <div class="sect2">
532 <h3 id="_understanding_beeps">3.5. Understanding Beeps</h3>
533 <div class="paragraph">
534 <p>Altus Metrum flight computers include a beeper to
535 provide information about the state of the system.
536 TeleMini doesn&#8217;t have room for a beeper, so instead it
537 uses an LED, which works the same, except for every
538 beep is replaced with the flash of the LED.</p>
539 </div>
540 <div class="paragraph">
541 <p>Here&#8217;s a short summary of all of the modes and the
542 beeping
543 (or flashing, in the case of TeleMini v1)
544 that accompanies each mode. In the description of the
545 beeping pattern, “dit” means a short beep while "dah"
546 means a long beep (three times as long). “Brap” means
547 a long dissonant tone.</p>
548 </div>
549 <table class="tableblock frame-all grid-all stretch">
550 <caption class="title">Table 1. AltOS Modes</caption>
551 <colgroup>
552 <col style="width: 16.6666%;">
553 <col style="width: 16.6666%;">
554 <col style="width: 33.3333%;">
555 <col style="width: 33.3335%;">
556 </colgroup>
557 <tbody>
558 <tr>
559 <td class="tableblock halign-left valign-top"><p class="tableblock">Mode Name</p></td>
560 <td class="tableblock halign-left valign-top"><p class="tableblock">Abbreviation</p></td>
561 <td class="tableblock halign-left valign-top"><p class="tableblock">Beeps</p></td>
562 <td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
563 </tr>
564 <tr>
565 <td class="tableblock halign-left valign-top"><p class="tableblock">Startup</p></td>
566 <td class="tableblock halign-left valign-top"><p class="tableblock">S</p></td>
567 <td class="tableblock halign-left valign-top"><p class="tableblock">battery voltage in decivolts</p></td>
568 <td class="tableblock halign-left valign-top"><p class="tableblock">Calibrating sensors, detecting orientation.</p></td>
569 </tr>
570 <tr>
571 <td class="tableblock halign-left valign-top"><p class="tableblock">Idle</p></td>
572 <td class="tableblock halign-left valign-top"><p class="tableblock">I</p></td>
573 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit</p></td>
574 <td class="tableblock halign-left valign-top"><p class="tableblock">Ready to accept commands over USB
575 or radio link.</p></td>
576 </tr>
577 <tr>
578 <td class="tableblock halign-left valign-top"><p class="tableblock">Pad</p></td>
579 <td class="tableblock halign-left valign-top"><p class="tableblock">P</p></td>
580 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dah dah dit</p></td>
581 <td class="tableblock halign-left valign-top"><p class="tableblock">Waiting for launch. Not listening for commands.</p></td>
582 </tr>
583 <tr>
584 <td class="tableblock halign-left valign-top"><p class="tableblock">Boost</p></td>
585 <td class="tableblock halign-left valign-top"><p class="tableblock">B</p></td>
586 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dit dit</p></td>
587 <td class="tableblock halign-left valign-top"><p class="tableblock">Accelerating upwards.</p></td>
588 </tr>
589 <tr>
590 <td class="tableblock halign-left valign-top"><p class="tableblock">Fast</p></td>
591 <td class="tableblock halign-left valign-top"><p class="tableblock">F</p></td>
592 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit dah dit</p></td>
593 <td class="tableblock halign-left valign-top"><p class="tableblock">Decelerating, but moving faster than 200m/s.</p></td>
594 </tr>
595 <tr>
596 <td class="tableblock halign-left valign-top"><p class="tableblock">Coast</p></td>
597 <td class="tableblock halign-left valign-top"><p class="tableblock">C</p></td>
598 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dah dit</p></td>
599 <td class="tableblock halign-left valign-top"><p class="tableblock">Decelerating, moving slower than 200m/s</p></td>
600 </tr>
601 <tr>
602 <td class="tableblock halign-left valign-top"><p class="tableblock">Drogue</p></td>
603 <td class="tableblock halign-left valign-top"><p class="tableblock">D</p></td>
604 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dit</p></td>
605 <td class="tableblock halign-left valign-top"><p class="tableblock">Descending after apogee. Above main height.</p></td>
606 </tr>
607 <tr>
608 <td class="tableblock halign-left valign-top"><p class="tableblock">Main</p></td>
609 <td class="tableblock halign-left valign-top"><p class="tableblock">M</p></td>
610 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dah</p></td>
611 <td class="tableblock halign-left valign-top"><p class="tableblock">Descending. Below main height.</p></td>
612 </tr>
613 <tr>
614 <td class="tableblock halign-left valign-top"><p class="tableblock">Landed</p></td>
615 <td class="tableblock halign-left valign-top"><p class="tableblock">L</p></td>
616 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dah dit dit</p></td>
617 <td class="tableblock halign-left valign-top"><p class="tableblock">Stable altitude for at least ten seconds.</p></td>
618 </tr>
619 <tr>
620 <td class="tableblock halign-left valign-top"><p class="tableblock">Sensor error</p></td>
621 <td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
622 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dit dah</p></td>
623 <td class="tableblock halign-left valign-top"><p class="tableblock">Error detected during sensor calibration.</p></td>
624 </tr>
625 </tbody>
626 </table>
627 <div class="paragraph">
628 <p>Here&#8217;s a summary of all of the Pad and Idle mode
629 indications. In Idle mode, you&#8217;ll hear one of these
630 just once after the two short dits indicating idle
631 mode. In Pad mode, after the dit dah dah dit
632 indicating Pad mode, you&#8217;ll hear these once every five
633 seconds.</p>
634 </div>
635 <table class="tableblock frame-all grid-all stretch">
636 <caption class="title">Table 2. Pad/Idle Indications</caption>
637 <colgroup>
638 <col style="width: 20%;">
639 <col style="width: 20%;">
640 <col style="width: 60%;">
641 </colgroup>
642 <thead>
643 <tr>
644 <th class="tableblock halign-left valign-top">Name</th>
645 <th class="tableblock halign-left valign-top">Beeps</th>
646 <th class="tableblock halign-left valign-top">Description</th>
647 </tr>
648 </thead>
649 <tbody>
650 <tr>
651 <td class="tableblock halign-left valign-top"><p class="tableblock">Neither</p></td>
652 <td class="tableblock halign-left valign-top"><p class="tableblock">brap</p></td>
653 <td class="tableblock halign-left valign-top"><p class="tableblock">No continuity detected on either apogee or main igniters.</p></td>
654 </tr>
655 <tr>
656 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee</p></td>
657 <td class="tableblock halign-left valign-top"><p class="tableblock">dit</p></td>
658 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on apogee igniter.</p></td>
659 </tr>
660 <tr>
661 <td class="tableblock halign-left valign-top"><p class="tableblock">Main</p></td>
662 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit</p></td>
663 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on main igniter.</p></td>
664 </tr>
665 <tr>
666 <td class="tableblock halign-left valign-top"><p class="tableblock">Both</p></td>
667 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit dit</p></td>
668 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected on both igniters.</p></td>
669 </tr>
670 <tr>
671 <td class="tableblock halign-left valign-top"><p class="tableblock">Storage Full</p></td>
672 <td class="tableblock halign-left valign-top"><p class="tableblock">warble</p></td>
673 <td class="tableblock halign-left valign-top"><p class="tableblock">On-board data logging storage is full. This will
674 not prevent the flight computer from safely
675 controlling the flight or transmitting telemetry
676 signals, but no record of the flight will be
677 stored in on-board flash.</p></td>
678 </tr>
679 <tr>
680 <td class="tableblock halign-left valign-top"><p class="tableblock">Additional Igniters</p></td>
681 <td class="tableblock halign-left valign-top"><p class="tableblock">four very short beeps</p></td>
682 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity indication for the additional pyro
683 channels on TeleMega, EasyMega and EasyTimer. One high tone for
684 no continuity, one low tone for continuity. On TeleMega and EasyMegay, these are
685 produced after the continuity indicators for the two
686 primary igniter channels.</p></td>
687 </tr>
688 </tbody>
689 </table>
690 <div class="paragraph">
691 <p>For devices with a radio transmitter, in addition to
692 the digital and APRS telemetry signals, you can also
693 receive audio tones with a standard amateur
694 70cm FM receiver. While on the pad, you will hear
695 igniter status once every five seconds.</p>
696 </div>
697 <table class="tableblock frame-all grid-all stretch">
698 <caption class="title">Table 3. Pad Radio Indications</caption>
699 <colgroup>
700 <col style="width: 20%;">
701 <col style="width: 20%;">
702 <col style="width: 60%;">
703 </colgroup>
704 <thead>
705 <tr>
706 <th class="tableblock halign-left valign-top">Name</th>
707 <th class="tableblock halign-left valign-top">Beeps</th>
708 <th class="tableblock halign-left valign-top">Description</th>
709 </tr>
710 </thead>
711 <tbody>
712 <tr>
713 <td class="tableblock halign-left valign-top"><p class="tableblock">Neither</p></td>
714 <td class="tableblock halign-left valign-top"><p class="tableblock">½ second tone</p></td>
715 <td class="tableblock halign-left valign-top"><p class="tableblock">No continuity detected on either apogee or main igniters.</p></td>
716 </tr>
717 <tr>
718 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee</p></td>
719 <td class="tableblock halign-left valign-top"><p class="tableblock">dit</p></td>
720 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on apogee igniter.</p></td>
721 </tr>
722 <tr>
723 <td class="tableblock halign-left valign-top"><p class="tableblock">Main</p></td>
724 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit</p></td>
725 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on main igniter.</p></td>
726 </tr>
727 <tr>
728 <td class="tableblock halign-left valign-top"><p class="tableblock">Both</p></td>
729 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit dit</p></td>
730 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected on both igniters.</p></td>
731 </tr>
732 </tbody>
733 </table>
734 <div class="paragraph">
735 <p>During ascent, the tones will be muted to allow the
736 telemetry data to consume the full radio bandwidth.</p>
737 </div>
738 <div class="paragraph">
739 <p>During descent and after landing, a ½ second tone will
740 be transmitted every five seconds. This can be used to
741 find the rocket using RDF techniques when the signal
742 is too weak to receive GPS information via telemetry
743 or APRS.</p>
744 </div>
745 </div>
746 <div class="sect2">
747 <h3 id="_turning_on_the_power">3.6. Turning On the Power</h3>
748 <div class="paragraph">
749 <p>Connect a battery and power switch and turn the switch
750 to "on". The flight computer will signal power on by
751 reporting the battery voltage and then perform an internal self
752 test and sensor calibration.</p>
753 </div>
754 <div class="paragraph">
755 <p>Once the self test and calibration are complete, there
756 are two modes that an Altus Metrum flight computer can
757 operate in:</p>
758 </div>
759 <div class="dlist">
760 <dl>
761 <dt class="hdlist1">Flight/Pad</dt>
762 <dd>
763 <p>The flight computer is waiting to detect
764 launch and then fly the rocket. In this mode, the USB
765 link is
766 disabled, and the radio goes into transmit-only mode.
767 The only way to get out of this
768 mode is to power the flight computer down. See below for how to get the flight
769 computer to come up in Flight/Pad mode at power on.</p>
770 </dd>
771 <dt class="hdlist1">Idle</dt>
772 <dd>
773 <p>The flight computer is ready to communicate over USB
774 and in packet mode over the radio.
775 You can configure
776 the flight computer, download data or display
777 the current state. See below for how to get the flight
778 computer to come up in Idle mode at power on.</p>
779 </dd>
780 </dl>
781 </div>
782 <div class="paragraph">
783 <p>For flight computers with accelerometers (TeleMetrum,
784 EasyMega, TeleMega and EasyTimer), the mode is selected by the
785 orientation of the board during the self test
786 interval. If the board is pointing upwards as if ready
787 to fly, it will enter Flight/Pad mode. Otherwise, it will
788 enter Idle mode.</p>
789 </div>
790 <div class="paragraph">
791 <p>For EasyMini, if the USB cable is connected to a
792 computer, it will enter Idle mode. Otherwise, it will
793 enter Flight/Pad mode.</p>
794 </div>
795 <div class="paragraph">
796 <p>For TeleMini v1.0, if a packet link is waiting to
797 connect when the device is powered on, it will enter
798 Idle mode, otherwise it will enter Flight/Pad mode.</p>
799 </div>
800 <div class="paragraph">
801 <p>You can see in <a href="#_understanding_beeps">Understanding Beeps</a>
802 how to tell which mode the flight computer is in.</p>
803 </div>
804 </div>
805 <div class="sect2">
806 <h3 id="_using_an_external_active_switch_circuit">3.7. Using an External Active Switch Circuit</h3>
807 <div class="paragraph">
808 <p>You can use an active switch circuit, such as the
809 Featherweight Magnetic Switch, with any Altus Metrum
810 flight computer. These require three connections, one to
811 the battery, one to the positive power input on the flight
812 computer and one to ground. Find instructions on how to
813 hook these up for each flight computer below. Then follow
814 the instructions that come with your active switch to
815 connect it up.</p>
816 </div>
817 </div>
818 <div class="sect2">
819 <h3 id="_using_a_separate_pyro_battery">3.8. Using a Separate Pyro Battery</h3>
820 <div class="paragraph">
821 <p>As mentioned above in <a href="#_hooking_up_pyro_charges">Hooking Up Pyro Charges</a>, one
822 lead for each of the pyro charges is connected through
823 the power switch directly to the positive battery
824 terminal. The other lead is connected to the pyro
825 circuit, which connects it to the negative battery
826 terminal when the pyro circuit is fired. The pyro
827 circuit on all of the flight computers is designed to
828 handle up to 16V.</p>
829 </div>
830 <div class="paragraph">
831 <p>To use a separate pyro battery, connect the negative pyro
832 battery terminal to the flight computer ground terminal,
833 the the switched positive battery terminal to the igniter
834 and the other
835 igniter lead to the negative pyro terminal on the flight
836 computer. When the pyro channel fires, it will complete the
837 circuit between the negative pyro terminal and the ground
838 terminal, firing the igniter. Specific instructions on how
839 to hook this up for each flight computer will be found
840 in the section below for that flight computer.</p>
841 </div>
842 <div class="paragraph">
843 <p>Note that you must include a switch in the positive lead of
844 the pyro battery for safety, as the on-board power switch
845 circuit on our product only controls current flow from the
846 the primary or system battery!</p>
847 </div>
848 </div>
849 <div class="sect2">
850 <h3 id="_using_a_different_kind_of_battery">3.9. Using a Different Kind of Battery</h3>
851 <div class="paragraph">
852 <p>EasyMini
853 and EasyTimer are
854 designed to use either a
855 lithium polymer battery or any other battery producing
856 between 4 and 12 volts, such as a rectangular 9V
857 battery.</p>
858 </div>
859 <div class="admonitionblock warning">
860 <table>
861 <tr>
862 <td class="icon">
863 <img src="./images/icons/warning.svg" alt="Warning">
864 </td>
865 <td class="content">
866 TeleMini,
867 TeleMega, EasyMega and TeleMetrum are only designed to
868 operate off a single-cell Lithium Polymer battery and
869 cannot be used with any other kind. Connecting a
870 different kind of battery to any of these will destroy
871 the board.
872 </td>
873 </tr>
874 </table>
875 </div>
876 </div>
877 <div class="sect2">
878 <h3 id="_using_packet_link_mode">3.10. Using Packet Link Mode</h3>
879 <div class="paragraph">
880 <p>All AltusMetrum flight computers that have a radio can
881 communicate with the ground station software for
882 configuration and other operations using the Packet
883 Link mode. This uses radio communication instead of a
884 USB cable. To set this up, the ground station software
885 must be configured to the correct data rate, frequency
886 and callsign.</p>
887 </div>
888 <div class="paragraph">
889 <p>You can monitor Packet Link mode from TeleBT or
890 TeleDongle by watching the LEDs. Each time the device
891 transmits, the red LED will flash. When the link is
892 busy, or when the link is not working, the device will
893 transmit 10 times per second, so the LED will flash
894 rapidly. When the link is working and there is no data
895 to send, the link will flash once per second, and the
896 LED will flash more slowly.</p>
897 </div>
898 </div>
899 </div>
900 </div>
901 <div class="sect1">
902 <h2 id="_telemetrum">4. TeleMetrum</h2>
903 <div class="sectionbody">
904 <div class="imageblock">
905 <div class="content">
906 <img src="telemetrum-v2.0-th.jpg" alt="telemetrum v2.0 th" width="400">
907 </div>
908 <div class="title">Figure 1. TeleMetrum v2 Board</div>
909 </div>
910 <div class="imageblock">
911 <div class="content">
912 <img src="telemetrum-v1.1-thside.jpg" alt="telemetrum v1.1 thside" width="400">
913 </div>
914 <div class="title">Figure 2. TeleMetrum v1 Board</div>
915 </div>
916 <div class="paragraph">
917 <p>TeleMetrum is a 1 inch by 2¾ inch circuit board.  It was designed to
918 fit inside coupler for 29mm air-frame tubing, but using it in a tube that
919 small in diameter may require some creativity in mounting and wiring
920 to succeed!  The presence of an accelerometer means TeleMetrum should
921 be aligned along the flight axis of the airframe, and by default the ¼
922 wave UHF wire antenna should be on the nose-cone end of the board.  The
923 antenna wire is about 7 inches long, and wiring for a power switch and
924 the e-matches for apogee and main ejection charges depart from the
925 fin can end of the board, meaning an ideal “simple” avionics
926 bay for TeleMetrum should have at least 10 inches of interior length.</p>
927 </div>
928 <div class="paragraph">
929 <p>There are two generations of the TeleMetrum design. The
930 major changes after v1 generation are:</p>
931 </div>
932 <div class="ulist">
933 <ul>
934 <li>
935 <p>uBlox GPS chip certified for altitude records</p>
936 </li>
937 <li>
938 <p>Higher power radio (40mW vs 10mW)</p>
939 </li>
940 <li>
941 <p>APRS support</p>
942 </li>
943 </ul>
944 </div>
945 <div class="paragraph">
946 <p>Otherwise, they&#8217;re the same size, with mounting holes and
947 screw terminals in the same position.</p>
948 </div>
949 <div class="sect2">
950 <h3 id="_telemetrum_screw_terminals">4.1. TeleMetrum Screw Terminals</h3>
951 <div class="paragraph">
952 <p>TeleMetrum has six screw terminals on the end of the board
953 opposite the telemetry antenna. Two are for the power
954 switch, and two each for the apogee and main igniter
955 circuits. Using the picture above and starting from the top,
956 the terminals are as follows:</p>
957 </div>
958 <table class="tableblock frame-all grid-all stretch">
959 <caption class="title">Table 4. TeleMetrum Screw Terminals</caption>
960 <colgroup>
961 <col style="width: 13.3333%;">
962 <col style="width: 20%;">
963 <col style="width: 66.6667%;">
964 </colgroup>
965 <thead>
966 <tr>
967 <th class="tableblock halign-left valign-top">Terminal #</th>
968 <th class="tableblock halign-left valign-top">Terminal Name</th>
969 <th class="tableblock halign-left valign-top">Description</th>
970 </tr>
971 </thead>
972 <tbody>
973 <tr>
974 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
975 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
976 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
977 </tr>
978 <tr>
979 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
980 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
981 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
982 </tr>
983 <tr>
984 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
985 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
986 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
987 </tr>
988 <tr>
989 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
990 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
991 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
992 </tr>
993 <tr>
994 <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
995 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
996 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
997 </tr>
998 <tr>
999 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
1000 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1001 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1002 </tr>
1003 </tbody>
1004 </table>
1005 </div>
1006 <div class="sect2">
1007 <h3 id="_using_a_separate_pyro_battery_with_telemetrum">4.2. Using a Separate Pyro Battery with TeleMetrum</h3>
1008 <div class="paragraph">
1009 <p>As described above, using an external pyro battery involves
1010 connecting the negative battery terminal to the flight
1011 computer ground, connecting the positive battery terminal to
1012 one of the igniter leads and connecting the other igniter
1013 lead to the per-channel pyro circuit connection.</p>
1014 </div>
1015 <div class="paragraph">
1016 <p>To connect the negative battery terminal to the TeleMetrum
1017 ground, insert a small piece of wire, 24 to 28 gauge
1018 stranded, into the GND hole just above the screw terminal
1019 strip and solder it in place.</p>
1020 </div>
1021 <div class="paragraph">
1022 <p>Connecting the switched positive battery terminal to the pyro
1023 charges must be done separate from TeleMetrum, by soldering
1024 them together or using some other connector. Note that you
1025 must include a switch in the positive lead from the pyro
1026 battery for safety!</p>
1027 </div>
1028 <div class="paragraph">
1029 <p>The other lead from each pyro charge is then inserted into
1030 the appropriate per-pyro channel screw terminal (terminal 4
1031 for the Main charge, terminal 6 for the Apogee charge).</p>
1032 </div>
1033 </div>
1034 <div class="sect2">
1035 <h3 id="_using_an_active_switch_with_telemetrum">4.3. Using an Active Switch with TeleMetrum</h3>
1036 <div class="paragraph">
1037 <p>As explained above, an external active switch requires three
1038 connections, one to the positive battery terminal, one to
1039 the flight computer positive input and one to ground.</p>
1040 </div>
1041 <div class="paragraph">
1042 <p>The positive battery terminal is available on screw terminal
1043 2, the positive flight computer input is on terminal 1. To
1044 hook a lead to ground, solder a piece of wire, 24 to 28
1045 gauge stranded, to the GND hole just above terminal 1.</p>
1046 </div>
1047 </div>
1048 </div>
1049 </div>
1050 <div class="sect1">
1051 <h2 id="_telemini">5. TeleMini</h2>
1052 <div class="sectionbody">
1053 <div class="imageblock">
1054 <div class="content">
1055 <img src="telemini-v3.0-top.jpg" alt="telemini v3.0 top" width="400">
1056 </div>
1057 <div class="title">Figure 3. TeleMini v3 Board</div>
1058 </div>
1059 <div class="imageblock">
1060 <div class="content">
1061 <img src="telemini-v3.0-bottom.jpg" alt="telemini v3.0 bottom" width="400">
1062 </div>
1063 </div>
1064 <div class="paragraph">
1065 <p>TeleMini v3 is 0.5 inches by 1.67 inches.  It was
1066 designed to fit inside an 18mm air-frame tube, but using it in
1067 a tube that small in diameter may require some creativity in
1068 mounting and wiring to succeed!  Since there is no
1069 accelerometer, TeleMini can be mounted in any convenient
1070 orientation.  The default ¼ wave UHF wire antenna attached to
1071 the center of one end of the board is about 7 inches long. Screw
1072 terminals for the power switch are located in the
1073 middle of the board. Screw terminals for the e-matches for
1074 apogee and main ejection charges depart from the other end of
1075 the board, meaning an ideal “simple” avionics bay for TeleMini
1076 should have at least 9 inches of interior length.</p>
1077 </div>
1078 <div class="sect2">
1079 <h3 id="_telemini_v3_screw_terminals">5.1. TeleMini v3 Screw Terminals</h3>
1080 <div class="paragraph">
1081 <p>TeleMini v3 has four screw terminals on the end of the
1082 board opposite the telemetry antenna. Two are for the apogee
1083 and two are for main igniter circuits. Another two
1084 screw terminals are located in the middle of the board
1085 for the power switch.  Using the
1086 picture above and starting from the top for the pyro terminals
1087 and from the left for the power switch terminals, the
1088 connections are as follows:</p>
1089 </div>
1090 <table class="tableblock frame-all grid-all stretch">
1091 <caption class="title">Table 5. TeleMini v3 Screw Terminals</caption>
1092 <colgroup>
1093 <col style="width: 13.3333%;">
1094 <col style="width: 20%;">
1095 <col style="width: 66.6667%;">
1096 </colgroup>
1097 <thead>
1098 <tr>
1099 <th class="tableblock halign-left valign-top">Terminal #</th>
1100 <th class="tableblock halign-left valign-top">Terminal Name</th>
1101 <th class="tableblock halign-left valign-top">Description</th>
1102 </tr>
1103 </thead>
1104 <tbody>
1105 <tr>
1106 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
1107 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1108 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1109 </tr>
1110 <tr>
1111 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
1112 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1113 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1114 </tr>
1115 <tr>
1116 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
1117 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1118 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1119 </tr>
1120 <tr>
1121 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
1122 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1123 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1124 </tr>
1125 <tr>
1126 <td class="tableblock halign-left valign-top"><p class="tableblock">Left</p></td>
1127 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1128 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1129 </tr>
1130 <tr>
1131 <td class="tableblock halign-left valign-top"><p class="tableblock">Right</p></td>
1132 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1133 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1134 </tr>
1135 </tbody>
1136 </table>
1137 </div>
1138 <div class="sect2">
1139 <h3 id="_using_a_separate_pyro_battery_with_telemini_v3">5.2. Using a Separate Pyro Battery with TeleMini v3</h3>
1140 <div class="paragraph">
1141 <p>As described above, using an external pyro battery involves
1142 connecting the negative battery terminal to the flight
1143 computer ground, connecting the switched positive battery
1144 terminal to one of the igniter leads and connecting the other
1145 igniter lead to the per-channel pyro circuit connection.
1146 Because there is no solid ground connection to use on
1147 TeleMini, this is not recommended.</p>
1148 </div>
1149 <div class="paragraph">
1150 <p>The only available ground connection on TeleMini v3 are
1151 the two mounting holes next to the telemetry
1152 antenna. Somehow connect a small piece of wire to one of
1153 those holes and hook it to the negative pyro battery terminal.</p>
1154 </div>
1155 <div class="paragraph">
1156 <p>Connecting the positive battery terminal to the pyro
1157 charges must be done separate from TeleMini v3, by soldering
1158 them together or using some other connector.  Note that you
1159 must include a switch in the pyro battery positive lead for
1160 safety!</p>
1161 </div>
1162 <div class="paragraph">
1163 <p>The other lead from each pyro charge is then inserted into
1164 the appropriate per-pyro channel screw terminal (terminal 3 for the
1165 Main charge, terminal 1 for the Apogee charge).</p>
1166 </div>
1167 </div>
1168 <div class="sect2">
1169 <h3 id="_using_an_active_switch_with_telemini_v3">5.3. Using an Active Switch with TeleMini v3</h3>
1170 <div class="paragraph">
1171 <p>As explained above, an external active switch requires three
1172 connections, one to the positive battery terminal, one to
1173 the flight computer positive input and one to ground. Again,
1174 because TeleMini doesn&#8217;t have any good ground connection,
1175 this is not recommended.</p>
1176 </div>
1177 <div class="paragraph">
1178 <p>The positive battery terminal is available on the Right
1179 power switch wire, the positive flight computer input is on
1180 the left power switch wire. Hook a lead to either of the
1181 mounting holes for a ground connection.</p>
1182 </div>
1183 </div>
1184 <div class="sect2">
1185 <h3 id="_using_packet_link_mode_with_telemini">5.4. Using Packet Link Mode with TeleMini</h3>
1186 <div class="paragraph">
1187 <p>After TeleMini powers up, it will check to see if some
1188 device is attempting to communicate with it using
1189 Packet Link Mode. If so, it will switch to idle mode
1190 and start communicating. To switch to flight mode,
1191 reboot the device either over the radio link or by
1192 powering it off and back on.</p>
1193 </div>
1194 <div class="paragraph">
1195 <p>If no ground station is attempting to communicate
1196 using Packet Link Mode, TeleMini will enter pad mode
1197 and prepare for flight.</p>
1198 </div>
1199 <div class="paragraph">
1200 <p>The sequence of operations to use Packet Link Mode
1201 with TeleMini is:</p>
1202 </div>
1203 <div class="olist arabic">
1204 <ol class="arabic">
1205 <li>
1206 <p>Configure the ground station data rate, frequency
1207 and callsign to match the TeleMini settings.</p>
1208 </li>
1209 <li>
1210 <p>Start Packet Link Mode in the ground station by
1211 selecting the desired operation (Safe Flight Data,
1212 Configure Altimeter, Fire Igniter or Monitor
1213 Idle). Select the TeleBT or TeleDongle device. The
1214 red LED should begin flashing rapidly.</p>
1215 </li>
1216 <li>
1217 <p>Turn on TeleMini. You should see the red LED flash
1218 very rapidly during the initial communication burst,
1219 but it should then slow down when the link is idle.</p>
1220 </li>
1221 </ol>
1222 </div>
1223 <div class="paragraph">
1224 <p>Once TeleMini is in Idle mode, it will stay in that
1225 mode until rebooted. That means you can stop one
1226 Packet Link operation, wait a while and start another
1227 Packet Link operation.</p>
1228 </div>
1229 </div>
1230 <div class="sect2">
1231 <h3 id="_forcing_telemini_radio_parameters_to_known_defaults">5.5. Forcing TeleMini radio parameters to known defaults</h3>
1232 <div class="paragraph">
1233 <p>If you don&#8217;t know what the TeleMini frequency and
1234 callsign settings are, you can temporarily force it
1235 back to the original default values (frequency
1236 434.550MHz, callsign N0CALL) by connecting a wire
1237 between hole 3 and hole 7 on the debug connector. Hole
1238 3 has the square pad around it, hole 7 is the one
1239 nearest the MS5607 baro sensor, which is a rectangular
1240 component with a metal cap that has two holes in it.</p>
1241 </div>
1242 <div class="paragraph">
1243 <p>Once TeleMini has been powered up with this wire
1244 connected, the wire may be removed. The radio
1245 parameters will stay set to these default values until
1246 changed by the user or when the device is rebooted.</p>
1247 </div>
1248 </div>
1249 <div class="sect2">
1250 <h3 id="_telemini_v1">5.6. TeleMini v1</h3>
1251 <div class="paragraph">
1252 <p>TeleMini v1 is the earlier version of this product. It
1253 has a lower-power radio, less storage, no beeper and
1254 soldered-in wires instead of screw terminals for the
1255 power switch.</p>
1256 </div>
1257 <div class="imageblock">
1258 <div class="content">
1259 <img src="telemini-v1-top.jpg" alt="telemini v1 top" width="400">
1260 </div>
1261 <div class="title">Figure 4. TeleMini v1 Board</div>
1262 </div>
1263 </div>
1264 </div>
1265 </div>
1266 <div class="sect1">
1267 <h2 id="_easymini">6. EasyMini</h2>
1268 <div class="sectionbody">
1269 <div class="imageblock">
1270 <div class="content">
1271 <img src="easymini-top.jpg" alt="easymini top" width="400">
1272 </div>
1273 <div class="title">Figure 5. EasyMini Board</div>
1274 </div>
1275 <div class="paragraph">
1276 <p>EasyMini is built on a 0.8 inch by 1½ inch circuit board. It&#8217;s
1277 designed to fit in a 24mm coupler tube.</p>
1278 </div>
1279 <div class="paragraph">
1280 <p>You usually don&#8217;t need to configure EasyMini at all; it&#8217;s set
1281 up to do dual-deployment with an event at apogee to separate
1282 the airframe and deploy a drogue and another event at 250m
1283 (820ft) to deploy the main. Install EasyMini in your airframe,
1284 hook up a battery, igniters and a power switch and you&#8217;re
1285 ready to fly.</p>
1286 </div>
1287 <div class="sect2">
1288 <h3 id="_easymini_screw_terminals">6.1. EasyMini Screw Terminals</h3>
1289 <div class="paragraph">
1290 <p>EasyMini has two sets of four screw terminals near one end of the
1291 board. Using the picture
1292 above, the top four have connections for the main pyro
1293 circuit and an external battery and the bottom four have
1294 connections for the apogee pyro circuit and the power
1295 switch. Counting from the left, the connections are as follows:</p>
1296 </div>
1297 <table class="tableblock frame-all grid-all stretch">
1298 <caption class="title">Table 6. EasyMini Screw Terminals</caption>
1299 <colgroup>
1300 <col style="width: 13.3333%;">
1301 <col style="width: 20%;">
1302 <col style="width: 66.6667%;">
1303 </colgroup>
1304 <thead>
1305 <tr>
1306 <th class="tableblock halign-left valign-top">Terminal #</th>
1307 <th class="tableblock halign-left valign-top">Terminal Name</th>
1308 <th class="tableblock halign-left valign-top">Description</th>
1309 </tr>
1310 </thead>
1311 <tbody>
1312 <tr>
1313 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1314 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1315 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1316 </tr>
1317 <tr>
1318 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1319 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1320 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1321 </tr>
1322 <tr>
1323 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1324 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery +</p></td>
1325 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive external battery terminal</p></td>
1326 </tr>
1327 <tr>
1328 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1329 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery -</p></td>
1330 <td class="tableblock halign-left valign-top"><p class="tableblock">Negative external battery terminal</p></td>
1331 </tr>
1332 <tr>
1333 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1334 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1335 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1336 </tr>
1337 <tr>
1338 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1339 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1340 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1341 </tr>
1342 <tr>
1343 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1344 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1345 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1346 </tr>
1347 <tr>
1348 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1349 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1350 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1351 </tr>
1352 </tbody>
1353 </table>
1354 </div>
1355 <div class="sect2">
1356 <h3 id="_connecting_a_battery_to_easymini">6.2. Connecting A Battery To EasyMini</h3>
1357 <div class="paragraph">
1358 <p>There are two possible battery connections on
1359 EasyMini. You can use either method; both feed
1360 through the power switch terminals.</p>
1361 </div>
1362 <div class="paragraph">
1363 <p>One battery connection is the standard Altus Metrum
1364 white JST plug. This mates with single-cell Lithium
1365 Polymer batteries sold by Altus Metrum.</p>
1366 </div>
1367 <div class="paragraph">
1368 <p>The other is a pair of screw terminals marked 'Battery
1369 +' and 'Battery -'. Connect a battery from 4 to 12
1370 volts to these terminals, being careful to match polarity.</p>
1371 </div>
1372 </div>
1373 <div class="sect2">
1374 <h3 id="_charging_lithium_batteries">6.3. Charging Lithium Batteries</h3>
1375 <div class="paragraph">
1376 <p>Because EasyMini allows for batteries other than the
1377 standard Altus Metrum Lithium Polymer cells, it cannot
1378 incorporate a battery charger circuit. Therefore, when
1379 using a Litium Polymer cell, you&#8217;ll need an external
1380 charger. These are available from Altus Metrum, or
1381 from Spark Fun.</p>
1382 </div>
1383 </div>
1384 <div class="sect2">
1385 <h3 id="_using_a_separate_pyro_battery_with_easymini">6.4. Using a Separate Pyro Battery with EasyMini</h3>
1386 <div class="paragraph">
1387 <p>As described above, using an external pyro battery involves
1388 connecting the negative battery terminal to the flight
1389 computer ground, connecting the positive battery terminal to
1390 one of the igniter leads and connecting the other igniter
1391 lead to the per-channel pyro circuit connection.</p>
1392 </div>
1393 <div class="paragraph">
1394 <p>To connect the negative pyro battery terminal to EasyMini
1395 ground, connect it to the negative external battery
1396 connection, top terminal 4.</p>
1397 </div>
1398 <div class="paragraph">
1399 <p>Connecting the switched positive battery terminal to the pyro
1400 charges must be done separate from EasyMini, by soldering
1401 them together or using some other connector.  Note that for
1402 safety, you must put a switch between the pyro battery and
1403 the rest of the circuit!</p>
1404 </div>
1405 <div class="paragraph">
1406 <p>The other lead from each pyro charge is then inserted into
1407 the appropriate per-pyro channel screw terminal (top
1408 terminal 1 for the Main charge, bottom terminal 1 for the
1409 Apogee charge).</p>
1410 </div>
1411 </div>
1412 <div class="sect2">
1413 <h3 id="_using_an_active_switch_with_easymini">6.5. Using an Active Switch with EasyMini</h3>
1414 <div class="paragraph">
1415 <p>As explained above, an external active switch requires three
1416 connections, one to the positive battery terminal, one to
1417 the flight computer positive input and one to ground. Use
1418 the negative external battery connection, top terminal 4 for
1419 ground.</p>
1420 </div>
1421 <div class="paragraph">
1422 <p>The positive battery terminal is available on bottom
1423 terminal 4, the positive flight computer input is on the
1424 bottom terminal 3.</p>
1425 </div>
1426 </div>
1427 </div>
1428 </div>
1429 <div class="sect1">
1430 <h2 id="_telemega">7. TeleMega</h2>
1431 <div class="sectionbody">
1432 <div class="imageblock">
1433 <div class="content">
1434 <img src="telemega-v1.0-top.jpg" alt="telemega v1.0 top" width="400">
1435 </div>
1436 <div class="title">Figure 6. TeleMega Board</div>
1437 </div>
1438 <div class="paragraph">
1439 <p>TeleMega is a 1¼ inch by 3¼ inch circuit board. It was
1440 designed to easily fit in a 38mm coupler. Like TeleMetrum,
1441 TeleMega has an accelerometer and so it must be mounted so that
1442 the board is aligned with the flight axis. It can be mounted
1443 either antenna up or down.</p>
1444 </div>
1445 <div class="paragraph">
1446 <p>TeleMega v2.0 has a few minor changes from v1.0:</p>
1447 </div>
1448 <div class="ulist">
1449 <ul>
1450 <li>
1451 <p>Companion connector matches EasyMega functions</p>
1452 </li>
1453 <li>
1454 <p>Serial port connector replaced with servo connector with
1455 support for up to 4 PWM channels.</p>
1456 </li>
1457 <li>
1458 <p>Radio switched from cc1120 to cc1200.</p>
1459 </li>
1460 </ul>
1461 </div>
1462 <div class="paragraph">
1463 <p>None of these affect operation using the stock firmware, but
1464 they do mean that the device needs different firmware to
1465 operate correctly, so make sure you load the right firmware
1466 when reflashing the device.</p>
1467 </div>
1468 <div class="sect2">
1469 <h3 id="_telemega_screw_terminals">7.1. TeleMega Screw Terminals</h3>
1470 <div class="paragraph">
1471 <p>TeleMega has two sets of nine screw terminals on the end of
1472 the board opposite the telemetry antenna. They are as follows:</p>
1473 </div>
1474 <table class="tableblock frame-all grid-all stretch">
1475 <caption class="title">Table 7. TeleMega Screw Terminals</caption>
1476 <colgroup>
1477 <col style="width: 13.3333%;">
1478 <col style="width: 20%;">
1479 <col style="width: 66.6667%;">
1480 </colgroup>
1481 <thead>
1482 <tr>
1483 <th class="tableblock halign-left valign-top">Terminal #</th>
1484 <th class="tableblock halign-left valign-top">Terminal Name</th>
1485 <th class="tableblock halign-left valign-top">Description</th>
1486 </tr>
1487 </thead>
1488 <tbody>
1489 <tr>
1490 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1491 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1492 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1493 </tr>
1494 <tr>
1495 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1496 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1497 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1498 </tr>
1499 <tr>
1500 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1501 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1502 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for use with external active switch</p></td>
1503 </tr>
1504 <tr>
1505 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1506 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1507 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1508 </tr>
1509 <tr>
1510 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 5</p></td>
1511 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1512 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1513 </tr>
1514 <tr>
1515 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 6</p></td>
1516 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1517 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1518 </tr>
1519 <tr>
1520 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 7</p></td>
1521 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1522 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1523 </tr>
1524 <tr>
1525 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 8</p></td>
1526 <td class="tableblock halign-left valign-top"><p class="tableblock">D -</p></td>
1527 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel connection to pyro circuit</p></td>
1528 </tr>
1529 <tr>
1530 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 9</p></td>
1531 <td class="tableblock halign-left valign-top"><p class="tableblock">D +</p></td>
1532 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel common connection to battery +</p></td>
1533 </tr>
1534 <tr>
1535 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1536 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1537 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for negative pyro battery terminal</p></td>
1538 </tr>
1539 <tr>
1540 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1541 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro</p></td>
1542 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive pyro battery terminal</p></td>
1543 </tr>
1544 <tr>
1545 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1546 <td class="tableblock halign-left valign-top"><p class="tableblock">Lipo</p></td>
1547 <td class="tableblock halign-left valign-top"><p class="tableblock">Power switch output. Use to connect main battery to pyro battery input</p></td>
1548 </tr>
1549 <tr>
1550 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1551 <td class="tableblock halign-left valign-top"><p class="tableblock">A -</p></td>
1552 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel connection to pyro circuit</p></td>
1553 </tr>
1554 <tr>
1555 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 5</p></td>
1556 <td class="tableblock halign-left valign-top"><p class="tableblock">A +</p></td>
1557 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel common connection to battery +</p></td>
1558 </tr>
1559 <tr>
1560 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 6</p></td>
1561 <td class="tableblock halign-left valign-top"><p class="tableblock">B -</p></td>
1562 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel connection to pyro circuit</p></td>
1563 </tr>
1564 <tr>
1565 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 7</p></td>
1566 <td class="tableblock halign-left valign-top"><p class="tableblock">B +</p></td>
1567 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel common connection to battery +</p></td>
1568 </tr>
1569 <tr>
1570 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 8</p></td>
1571 <td class="tableblock halign-left valign-top"><p class="tableblock">C -</p></td>
1572 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel connection to pyro circuit</p></td>
1573 </tr>
1574 <tr>
1575 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 9</p></td>
1576 <td class="tableblock halign-left valign-top"><p class="tableblock">C +</p></td>
1577 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel common connection to battery +</p></td>
1578 </tr>
1579 </tbody>
1580 </table>
1581 </div>
1582 <div class="sect2">
1583 <h3 id="_using_a_separate_pyro_battery_with_telemega">7.2. Using a Separate Pyro Battery with TeleMega</h3>
1584 <div class="paragraph">
1585 <p>TeleMega provides explicit support for an external pyro
1586 battery. All that is required is to remove the jumper
1587 between the lipo terminal (Bottom 3) and the pyro terminal
1588 (Bottom 2). Then hook the negative pyro battery terminal to
1589 ground (Bottom 1) and the switched positive pyro battery to
1590 the pyro battery input (Bottom 2). Note that you must include
1591 a switch between the pyro battery and the board for safety,
1592 as the on-board power switch circuit only supports the primary
1593 battery!  You can then use the existing pyro screw
1594 terminals to hook up all of the pyro charges.</p>
1595 </div>
1596 </div>
1597 <div class="sect2">
1598 <h3 id="_using_only_one_battery_with_telemega">7.3. Using Only One Battery With TeleMega</h3>
1599 <div class="paragraph">
1600 <p>Because TeleMega has built-in support for a separate pyro
1601 battery, if you want to fly with just one battery running
1602 both the computer and firing the charges, you need to
1603 connect the flight computer battery to the pyro
1604 circuit. TeleMega has two screw terminals for this—hook a
1605 wire from the Lipo terminal (Bottom 3) to the Pyro terminal
1606 (Bottom 2).</p>
1607 </div>
1608 </div>
1609 <div class="sect2">
1610 <h3 id="_using_an_active_switch_with_telemega">7.4. Using an Active Switch with TeleMega</h3>
1611 <div class="paragraph">
1612 <p>As explained above, an external active switch requires three
1613 connections, one to the positive battery terminal, one to
1614 the flight computer positive input and one to ground.</p>
1615 </div>
1616 <div class="paragraph">
1617 <p>The positive battery terminal is available on Top terminal
1618 1, the positive flight computer input is on Top terminal
1619 2. Ground is on Top terminal 3.</p>
1620 </div>
1621 </div>
1622 </div>
1623 </div>
1624 <div class="sect1">
1625 <h2 id="_easymega">8. EasyMega</h2>
1626 <div class="sectionbody">
1627 <div class="imageblock">
1628 <div class="content">
1629 <img src="easymega-v1.0-top.jpg" alt="easymega v1.0 top" width="400">
1630 </div>
1631 <div class="title">Figure 7. EasyMega Board</div>
1632 </div>
1633 <div class="paragraph">
1634 <p>EasyMega is a 1¼ inch by 2¼ inch circuit board. It was
1635 designed to easily fit in a 38mm coupler. Like TeleMetrum,
1636 EasyMega has an accelerometer and so it must be mounted so that
1637 the board is aligned with the flight axis. It can be mounted
1638 either antenna up or down.</p>
1639 </div>
1640 <div class="sect2">
1641 <h3 id="_easymega_screw_terminals">8.1. EasyMega Screw Terminals</h3>
1642 <div class="paragraph">
1643 <p>EasyMega has two sets of nine screw terminals on the end of
1644 the board opposite the telemetry antenna. They are as follows:</p>
1645 </div>
1646 <table class="tableblock frame-all grid-all stretch">
1647 <caption class="title">Table 8. EasyMega Screw Terminals</caption>
1648 <colgroup>
1649 <col style="width: 13.3333%;">
1650 <col style="width: 20%;">
1651 <col style="width: 66.6667%;">
1652 </colgroup>
1653 <thead>
1654 <tr>
1655 <th class="tableblock halign-left valign-top">Terminal #</th>
1656 <th class="tableblock halign-left valign-top">Terminal Name</th>
1657 <th class="tableblock halign-left valign-top">Description</th>
1658 </tr>
1659 </thead>
1660 <tbody>
1661 <tr>
1662 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1663 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1664 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1665 </tr>
1666 <tr>
1667 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1668 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1669 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1670 </tr>
1671 <tr>
1672 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1673 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1674 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for use with external active switch</p></td>
1675 </tr>
1676 <tr>
1677 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1678 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1679 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1680 </tr>
1681 <tr>
1682 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 5</p></td>
1683 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1684 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1685 </tr>
1686 <tr>
1687 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 6</p></td>
1688 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1689 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1690 </tr>
1691 <tr>
1692 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 7</p></td>
1693 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1694 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1695 </tr>
1696 <tr>
1697 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 8</p></td>
1698 <td class="tableblock halign-left valign-top"><p class="tableblock">D -</p></td>
1699 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel connection to pyro circuit</p></td>
1700 </tr>
1701 <tr>
1702 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 9</p></td>
1703 <td class="tableblock halign-left valign-top"><p class="tableblock">D +</p></td>
1704 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel common connection to battery +</p></td>
1705 </tr>
1706 <tr>
1707 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1708 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1709 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for negative pyro battery terminal</p></td>
1710 </tr>
1711 <tr>
1712 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1713 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro</p></td>
1714 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive pyro battery terminal</p></td>
1715 </tr>
1716 <tr>
1717 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1718 <td class="tableblock halign-left valign-top"><p class="tableblock">Lipo</p></td>
1719 <td class="tableblock halign-left valign-top"><p class="tableblock">Power switch output. Use to connect main battery to pyro battery input</p></td>
1720 </tr>
1721 <tr>
1722 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1723 <td class="tableblock halign-left valign-top"><p class="tableblock">A -</p></td>
1724 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel connection to pyro circuit</p></td>
1725 </tr>
1726 <tr>
1727 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 5</p></td>
1728 <td class="tableblock halign-left valign-top"><p class="tableblock">A +</p></td>
1729 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel common connection to battery +</p></td>
1730 </tr>
1731 <tr>
1732 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 6</p></td>
1733 <td class="tableblock halign-left valign-top"><p class="tableblock">B -</p></td>
1734 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel connection to pyro circuit</p></td>
1735 </tr>
1736 <tr>
1737 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 7</p></td>
1738 <td class="tableblock halign-left valign-top"><p class="tableblock">B +</p></td>
1739 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel common connection to battery +</p></td>
1740 </tr>
1741 <tr>
1742 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 8</p></td>
1743 <td class="tableblock halign-left valign-top"><p class="tableblock">C -</p></td>
1744 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel connection to pyro circuit</p></td>
1745 </tr>
1746 <tr>
1747 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 9</p></td>
1748 <td class="tableblock halign-left valign-top"><p class="tableblock">C +</p></td>
1749 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel common connection to battery +</p></td>
1750 </tr>
1751 </tbody>
1752 </table>
1753 </div>
1754 <div class="sect2">
1755 <h3 id="_using_a_separate_pyro_battery_with_easymega">8.2. Using a Separate Pyro Battery with EasyMega</h3>
1756 <div class="paragraph">
1757 <p>EasyMega provides explicit support for an external pyro
1758 battery. All that is required is to remove the jumper
1759 between the lipo terminal (Bottom 3) and the pyro terminal
1760 (Bottom 2). Then hook the negative pyro battery terminal to
1761 ground (Bottom 1) and the switched positive pyro battery to
1762 the pyro battery input (Bottom 2). Note that you must include
1763 a switch between the pyro battery and the board for safety,
1764 as the on-board power switch circuit only supports the primary
1765 battery!  You can then use the existing pyro screw
1766 terminals to hook up all of the pyro charges.</p>
1767 </div>
1768 </div>
1769 <div class="sect2">
1770 <h3 id="_using_only_one_battery_with_easymega">8.3. Using Only One Battery With EasyMega</h3>
1771 <div class="paragraph">
1772 <p>Because EasyMega has built-in support for a separate pyro
1773 battery, if you want to fly with just one battery running
1774 both the computer and firing the charges, you need to
1775 connect the flight computer battery to the pyro
1776 circuit. EasyMega has two screw terminals for this—hook a
1777 wire from the Lipo terminal (Bottom 3) to the Pyro terminal
1778 (Bottom 2).</p>
1779 </div>
1780 </div>
1781 <div class="sect2">
1782 <h3 id="_using_an_active_switch_with_easymega">8.4. Using an Active Switch with EasyMega</h3>
1783 <div class="paragraph">
1784 <p>As explained above, an external active switch requires three
1785 connections, one to the positive battery terminal, one to
1786 the flight computer positive input and one to ground.</p>
1787 </div>
1788 <div class="paragraph">
1789 <p>The positive battery terminal is available on Top terminal
1790 1, the positive flight computer input is on Top terminal
1791 2. Ground is on Top terminal 3.</p>
1792 </div>
1793 </div>
1794 </div>
1795 </div>
1796 <div class="sect1">
1797 <h2 id="_easytimer">9. EasyTimer</h2>
1798 <div class="sectionbody">
1799 <div class="imageblock">
1800 <div class="content">
1801 <img src="easytimer.jpg" alt="easytimer" width="400">
1802 </div>
1803 <div class="title">Figure 8. EasyTimer Board</div>
1804 </div>
1805 <div class="paragraph">
1806 <p>EasyTimer is built on a 0.8 inch by 1½ inch circuit board. It&#8217;s
1807 designed to fit in a 24mm coupler tube.</p>
1808 </div>
1809 <div class="paragraph">
1810 <p>EasyTimer is designed to control events during ascent. It has
1811 an accelerometer and gyroscope that can measure acceleration
1812 and rotation and compute speed and tilt angle. EasyTimer has
1813 two pyro channels which can be configured to fire at various
1814 points during flight. Because EasyTimer has no barometric
1815 sensor, it cannot be used to fire recovery charges at apogee
1816 or during descent. EasyTimer is configured using the AltosUI
1817 application which is available for Linux, Mac OS X and Windows.</p>
1818 </div>
1819 <div class="sect2">
1820 <h3 id="_easytimer_screw_terminals">9.1. EasyTimer Screw Terminals</h3>
1821 <div class="paragraph">
1822 <p>EasyTimer has two sets of four screw terminals near
1823 one end of the board. Using the picture above, the top
1824 four have connections for pyro channel B and an
1825 external battery and the bottom four have connections
1826 for pyro circuit A and the power switch. Counting from
1827 the left, the connections are as follows:</p>
1828 </div>
1829 <table class="tableblock frame-all grid-all stretch">
1830 <caption class="title">Table 9. EasyTimer Screw Terminals</caption>
1831 <colgroup>
1832 <col style="width: 13.3333%;">
1833 <col style="width: 20%;">
1834 <col style="width: 66.6667%;">
1835 </colgroup>
1836 <thead>
1837 <tr>
1838 <th class="tableblock halign-left valign-top">Terminal #</th>
1839 <th class="tableblock halign-left valign-top">Terminal Name</th>
1840 <th class="tableblock halign-left valign-top">Description</th>
1841 </tr>
1842 </thead>
1843 <tbody>
1844 <tr>
1845 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1846 <td class="tableblock halign-left valign-top"><p class="tableblock">B -</p></td>
1847 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel B connection to pyro circuit</p></td>
1848 </tr>
1849 <tr>
1850 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1851 <td class="tableblock halign-left valign-top"><p class="tableblock">B +</p></td>
1852 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel B common connection to battery +</p></td>
1853 </tr>
1854 <tr>
1855 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1856 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery +</p></td>
1857 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive external battery terminal</p></td>
1858 </tr>
1859 <tr>
1860 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1861 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery -</p></td>
1862 <td class="tableblock halign-left valign-top"><p class="tableblock">Negative external battery terminal</p></td>
1863 </tr>
1864 <tr>
1865 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1866 <td class="tableblock halign-left valign-top"><p class="tableblock">A -</p></td>
1867 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel A connection to pyro circuit</p></td>
1868 </tr>
1869 <tr>
1870 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1871 <td class="tableblock halign-left valign-top"><p class="tableblock">A +</p></td>
1872 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel A common connection to battery +</p></td>
1873 </tr>
1874 <tr>
1875 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1876 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1877 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1878 </tr>
1879 <tr>
1880 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1881 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1882 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1883 </tr>
1884 </tbody>
1885 </table>
1886 </div>
1887 <div class="sect2">
1888 <h3 id="_connecting_a_battery_to_easytimer">9.2. Connecting A Battery To EasyTimer</h3>
1889 <div class="paragraph">
1890 <p>There are two possible battery connections on
1891 EasyTimer. You can use either method; both feed
1892 through the power switch terminals.</p>
1893 </div>
1894 <div class="paragraph">
1895 <p>One battery connection is the standard Altus Metrum
1896 white JST plug. This mates with single-cell Lithium
1897 Polymer batteries sold by Altus Metrum.</p>
1898 </div>
1899 <div class="paragraph">
1900 <p>The other is a pair of screw terminals marked 'Battery
1901 +' and 'Battery -'. Connect a battery from 4 to 12
1902 volts to these terminals, being careful to match polarity.</p>
1903 </div>
1904 </div>
1905 <div class="sect2">
1906 <h3 id="_charging_lithium_batteries_2">9.3. Charging Lithium Batteries</h3>
1907 <div class="paragraph">
1908 <p>Because EasyTimer allows for batteries other than the
1909 standard Altus Metrum Lithium Polymer cells, it cannot
1910 incorporate a battery charger circuit. Therefore, when
1911 using a Litium Polymer cell, you&#8217;ll need an external
1912 charger. These are available from Altus Metrum, or
1913 from Spark Fun.</p>
1914 </div>
1915 </div>
1916 <div class="sect2">
1917 <h3 id="_using_a_separate_pyro_battery_with_easytimer">9.4. Using a Separate Pyro Battery with EasyTimer</h3>
1918 <div class="paragraph">
1919 <p>As described above, using an external pyro battery involves
1920 connecting the negative battery terminal to the flight
1921 computer ground, connecting the positive battery terminal to
1922 one of the igniter leads and connecting the other igniter
1923 lead to the per-channel pyro circuit connection.</p>
1924 </div>
1925 <div class="paragraph">
1926 <p>To connect the negative pyro battery terminal to EasyTimer
1927 ground, connect it to the negative external battery
1928 connection, top terminal 4.</p>
1929 </div>
1930 <div class="paragraph">
1931 <p>Connecting the switched positive battery terminal to the pyro
1932 charges must be done separate from EasyTimer, by soldering
1933 them together or using some other connector.  Note that for
1934 safety, you must put a switch between the pyro battery and
1935 the rest of the circuit!</p>
1936 </div>
1937 <div class="paragraph">
1938 <p>The other lead from each pyro charge is then inserted into
1939 the appropriate per-pyro channel screw terminal (top
1940 terminal 1 for pyro channel A charge, bottom terminal 1 for
1941 pyro channel B charge).</p>
1942 </div>
1943 </div>
1944 <div class="sect2">
1945 <h3 id="_using_an_active_switch_with_easytimer">9.5. Using an Active Switch with EasyTimer</h3>
1946 <div class="paragraph">
1947 <p>As explained above, an external active switch requires three
1948 connections, one to the positive battery terminal, one to
1949 the flight computer positive input and one to ground. Use
1950 the negative external battery connection, top terminal 4 for
1951 ground.</p>
1952 </div>
1953 <div class="paragraph">
1954 <p>The positive battery terminal is available on bottom
1955 terminal 4, the positive flight computer input is on the
1956 bottom terminal 3.</p>
1957 </div>
1958 </div>
1959 </div>
1960 </div>
1961 <div class="sect1">
1962 <h2 id="_installation">10. Installation</h2>
1963 <div class="sectionbody">
1964 <div class="paragraph">
1965 <p>A typical installation involves attaching
1966 only a suitable battery, a single pole switch for
1967 power on/off, and two pairs of wires connecting e-matches for the
1968 apogee and main ejection charges.  All Altus Metrum products are
1969 designed for use with single-cell batteries with 3.7 volts
1970 nominal.
1971 EasyMini may also be used with other
1972 batteries as long as they supply between 4 and 12 volts.</p>
1973 </div>
1974 <div class="paragraph">
1975 <p>The battery connectors are a standard 2-pin JST connector; you
1976 can purchase suitable batteries from the any vendor selling
1977 Altus Metrum products. These batteries are
1978 single-cell Lithium Polymer batteries that nominally provide 3.7
1979 volts.  Other vendors sell similar batteries for RC aircraft
1980 using mating connectors, however the polarity for those is
1981 generally reversed from the batteries used by Altus Metrum
1982 products. In particular, the Tenergy batteries supplied for use
1983 in Featherweight flight computers are not compatible with Altus
1984 Metrum flight computers or battery chargers.</p>
1985 </div>
1986 <div class="admonitionblock warning">
1987 <table>
1988 <tr>
1989 <td class="icon">
1990 <img src="./images/icons/warning.svg" alt="Warning">
1991 </td>
1992 <td class="content">
1993 Check polarity and voltage before connecting any battery not
1994 purchased from Altus Metrum.
1995 </td>
1996 </tr>
1997 </table>
1998 </div>
1999 <div class="admonitionblock warning">
2000 <table>
2001 <tr>
2002 <td class="icon">
2003 <img src="./images/icons/warning.svg" alt="Warning">
2004 </td>
2005 <td class="content">
2006 Spark Fun sells batteries that have a matching connector with
2007 the correct polarity. However, these batteries include an
2008 integrated current limiting circuit. That circuit will cause
2009 the battery to shut down when firing the igniter circuit. Do
2010 not use these batteries unless you remove the current limiting
2011 circuit.
2012 </td>
2013 </tr>
2014 </table>
2015 </div>
2016 <div class="paragraph">
2017 <p>By default, we use the unregulated output of the battery
2018 directly to fire ejection charges.  This works marvelously
2019 with standard low-current e-matches like the J-Tek from MJG
2020 Technologies, and with Quest Q2G2 igniters.  However, if you
2021 want or need to use a separate pyro battery, check out
2022 <a href="#_using_a_separate_pyro_battery">Using a Separate Pyro Battery</a> for instructions on how to wire
2023 that up. The altimeters are designed to work with an external
2024 pyro battery of no more than 15 volts.</p>
2025 </div>
2026 <div class="paragraph">
2027 <p>Ejection charges are wired directly to the screw terminal block
2028 at the aft end of the altimeter.  You&#8217;ll need a very small straight
2029 blade screwdriver for these screws, such as you might find in a
2030 jeweler&#8217;s screwdriver set.</p>
2031 </div>
2032 <div class="paragraph">
2033 <p>Except for TeleMini v1.0, the flight computers also use the
2034 screw terminal block for the power switch leads. On TeleMini v1.0,
2035 the power switch leads are soldered directly to the board and
2036 can be connected directly to a switch.</p>
2037 </div>
2038 <div class="paragraph">
2039 <p>For most air-frames, the integrated antennas are more than
2040 adequate.   However, if you are installing in a carbon-fiber or
2041 metal electronics bay which is opaque to RF signals, you may need to
2042 use off-board external antennas instead.  In this case, you can
2043 replace the stock UHF antenna wire with an edge-launched SMA connector,
2044 and, on TeleMetrum v1, you can unplug the integrated GPS
2045 antenna and select an appropriate off-board GPS antenna with
2046 cable terminating in a U.FL connector.</p>
2047 </div>
2048 </div>
2049 </div>
2050 <div class="sect1">
2051 <h2 id="_using_altus_metrum_products">11. Using Altus Metrum Products</h2>
2052 <div class="sectionbody">
2053 <div class="sect2">
2054 <h3 id="_being_legal">11.1. Being Legal</h3>
2055 <div class="paragraph">
2056 <p>In the US, you need an
2057 <a href="http://www.altusmetrum.org/Radio/">amateur radio license</a>
2058 or other authorization to legally operate the radio
2059 transmitters that are part of our products.</p>
2060 </div>
2061 </div>
2062 <div class="sect2">
2063 <h3 id="_in_the_rocket">11.2. In the Rocket</h3>
2064 <div class="paragraph">
2065 <p>In the rocket itself, you just need a flight computer
2066 and a single-cell, 3.7 volt nominal Li-Po rechargeable
2067 battery.
2068 An 850mAh battery weighs less than a 9V
2069 alkaline battery, and will run a TeleMetrum, TeleMega,
2070 EasyMega or EasyTimer for hours.
2071 A 110mAh battery weighs less
2072 than a triple A battery and is a good choice for use
2073 with
2074 TeleMini or
2075 EasyMini.</p>
2076 </div>
2077 <div class="paragraph">
2078 <p>By default, we ship TeleMini, TeleMetrum and TeleMega
2079 flight computers with a simple wire antenna.  If your
2080 electronics bay or the air-frame it resides within is
2081 made of carbon fiber, which is opaque to RF signals,
2082 you may prefer to install an SMA connector so that you
2083 can run a coaxial cable to an antenna mounted
2084 elsewhere in the rocket.  However, note that the GPS
2085 antenna is fixed on all current products, so you
2086 really want to install the flight computer in a bay
2087 made of RF-transparent materials if at all possible.</p>
2088 </div>
2089 </div>
2090 <div class="sect2">
2091 <h3 id="_on_the_ground">11.3. On the Ground</h3>
2092 <div class="paragraph">
2093 <p>To receive the data stream from the rocket, you need
2094 an antenna and short feed-line connected to one of our
2095 <a href="http://www.altusmetrum.org/TeleDongle/">TeleDongle</a>
2096 units.  If possible, use an SMA to BNC adapter instead
2097 of feedline between the antenna feedpoint and
2098 TeleDongle, as this will give you the best
2099 performance.  The TeleDongle in turn plugs directly
2100 into the USB port on a notebook computer.  Because
2101 TeleDongle looks like a simple serial port, your
2102 computer does not require special device
2103 drivers&#8230;&#8203; just plug it in.</p>
2104 </div>
2105 <div class="paragraph">
2106 <p>The GUI tool, AltosUI, is written in Java and runs
2107 across Linux, Mac OS and Windows. There&#8217;s also a suite
2108 of C tools for Linux which can perform most of the
2109 same tasks.</p>
2110 </div>
2111 <div class="paragraph">
2112 <p>Alternatively, a TeleBT attached with an SMA to BNC
2113 adapter at the feed point of a hand-held yagi used in
2114 conjunction with an Android device running AltosDroid
2115 makes an outstanding ground station.</p>
2116 </div>
2117 <div class="paragraph">
2118 <p>After the flight,
2119 you can use the radio link to
2120 extract the more detailed data logged in either
2121 TeleMetrum or TeleMini devices, or
2122 you can use a
2123 USB cable to plug into the flight computer board directly.
2124 A USB cable is also how you
2125 charge the Li-Po battery, so you&#8217;ll want one of those
2126 anyway. The same cable used by lots of digital
2127 cameras and other modern electronic stuff will work
2128 fine.</p>
2129 </div>
2130 <div class="paragraph">
2131 <p>If your rocket lands out of sight, you may enjoy
2132 having a hand-held GPS receiver, so that you can put
2133 in a way-point for the last reported rocket position
2134 before touch-down.  This makes looking for your rocket
2135 a lot like Geo-Caching&#8230;&#8203; just go to the way-point and
2136 look around starting from there.  AltosDroid on an
2137 Android device with GPS receiver works great for this,
2138 too!</p>
2139 </div>
2140 <div class="paragraph">
2141 <p>You may also enjoy having a ham radio “HT” that covers
2142 the 70cm band&#8230;&#8203; you can use that with your antenna to
2143 direction-find the rocket on the ground the same way
2144 you can use a Walston or Beeline tracker.  This can be
2145 handy if the rocket is hiding in sage brush or a tree,
2146 or if the last GPS position doesn&#8217;t get you close
2147 enough because the rocket dropped into a canyon, or
2148 the wind is blowing it across a dry lake bed, or
2149 something like that&#8230;&#8203;  Keith currently uses a Yaesu
2150 FT1D, Bdale has a Yaesu VX-7R, which is a nicer radio
2151 in most ways but doesn&#8217;t support APRS.</p>
2152 </div>
2153 <div class="paragraph">
2154 <p>So, to recap, on the ground the hardware you&#8217;ll need includes:</p>
2155 </div>
2156 <div class="olist arabic">
2157 <ol class="arabic">
2158 <li>
2159 <p>an antenna and feed-line or adapter</p>
2160 </li>
2161 <li>
2162 <p>a TeleDongle</p>
2163 </li>
2164 <li>
2165 <p>a notebook computer</p>
2166 </li>
2167 <li>
2168 <p>optionally, a hand-held GPS receiver</p>
2169 </li>
2170 <li>
2171 <p>optionally, an HT or receiver covering 435 MHz</p>
2172 </li>
2173 </ol>
2174 </div>
2175 <div class="paragraph">
2176 <p>The best hand-held commercial directional antennas we&#8217;ve found for radio
2177 direction finding rockets are from
2178 <a href="http://www.arrowantennas.com/">Arrow Antennas</a>.</p>
2179 </div>
2180 <div class="paragraph">
2181 <p>The 440-3 and 440-5 are both good choices for finding
2182 a TeleMetrum- or TeleMini- equipped rocket when used
2183 with a suitable 70cm HT.  TeleDongle and an SMA to BNC
2184 adapter fit perfectly between the driven element and
2185 reflector of Arrow antennas.</p>
2186 </div>
2187 </div>
2188 <div class="sect2">
2189 <h3 id="_data_analysis">11.4. Data Analysis</h3>
2190 <div class="paragraph">
2191 <p>Our software makes it easy to log the data from each
2192 flight, both the telemetry received during the flight
2193 itself, and the more complete data log recorded in the
2194 flash memory on the altimeter board.  Once this data
2195 is on your computer, our post-flight tools make it
2196 easy to quickly get to the numbers everyone wants,
2197 like apogee altitude, max acceleration, and max
2198 velocity.  You can also generate and view a standard
2199 set of plots showing the altitude, acceleration, and
2200 velocity of the rocket during flight.  And you can
2201 even export a flight log in a format usable with Google
2202 Maps and Google Earth for visualizing the flight path
2203 in two or three dimensions!</p>
2204 </div>
2205 <div class="paragraph">
2206 <p>Our ultimate goal is to emit a set of files for each
2207 flight that can be published as a web page per flight,
2208 or just viewed on your local disk with a web browser.</p>
2209 </div>
2210 </div>
2211 <div class="sect2">
2212 <h3 id="_future_plans">11.5. Future Plans</h3>
2213 <div class="paragraph">
2214 <p>We have designed and prototyped several “companion
2215 boards” that can attach to the companion connector on
2216 TeleMetrum, TeleMega and EasyMega flight computers to
2217 collect more data, provide more pyro channels, and so
2218 forth.  We do not yet know if or when any of these
2219 boards will be produced in enough quantity to sell.
2220 If you have specific interests for data collection or
2221 control of events in your rockets beyond the
2222 capabilities of our existing productions, please let
2223 us know!</p>
2224 </div>
2225 <div class="paragraph">
2226 <p>Because all of our work is open, both the hardware
2227 designs and the software, if you have some great idea
2228 for an addition to the current Altus Metrum family,
2229 feel free to dive in and help!  Or let us know what
2230 you&#8217;d like to see that we aren&#8217;t already working on,
2231 and maybe we&#8217;ll get excited about it too&#8230;&#8203;</p>
2232 </div>
2233 <div class="paragraph">
2234 <p>Watch our <a href="http://altusmetrum.org/">web site</a> for
2235 more news and information as our family of products
2236 evolves!</p>
2237 </div>
2238 </div>
2239 </div>
2240 </div>
2241 <div class="sect1">
2242 <h2 id="_altosui">12. AltosUI</h2>
2243 <div class="sectionbody">
2244 <div class="imageblock">
2245 <div class="content">
2246 <img src="altosui.png" alt="altosui" width="450">
2247 </div>
2248 <div class="title">Figure 9. AltosUI Main Window</div>
2249 </div>
2250 <div class="paragraph">
2251 <p>The AltosUI program provides a graphical user interface for
2252 interacting with the Altus Metrum product family. AltosUI can
2253 monitor telemetry data, configure devices and many other
2254 tasks. The primary interface window provides a selection of
2255 buttons, one for each major activity in the system.  This
2256 chapter is split into sections, each of which documents one of
2257 the tasks provided from the top-level toolbar.</p>
2258 </div>
2259 <div class="sect2">
2260 <h3 id="_monitor_flight">12.1. Monitor Flight</h3>
2261 <div class="paragraph">
2262 <p>Selecting this item brings up a dialog box listing all
2263 of the connected TeleDongle devices. When you choose
2264 one of these, AltosUI will create a window to display
2265 telemetry data as received by the selected TeleDongle
2266 device.</p>
2267 </div>
2268 <div class="imageblock">
2269 <div class="content">
2270 <img src="device-selection.png" alt="device selection" width="300">
2271 </div>
2272 <div class="title">Figure 10. Device Selection Dialog</div>
2273 </div>
2274 <div class="paragraph">
2275 <p>All telemetry data received are automatically recorded
2276 in suitable log files. The name of the files includes
2277 the current date and rocket serial and flight numbers.</p>
2278 </div>
2279 <div class="paragraph">
2280 <p>The radio frequency being monitored by the TeleDongle
2281 device is displayed at the top of the window. You can
2282 configure the frequency by clicking on the frequency
2283 box and selecting the desired frequency. AltosUI
2284 remembers the last frequency selected for each
2285 TeleDongle and selects that automatically the next
2286 time you use that device.</p>
2287 </div>
2288 <div class="paragraph">
2289 <p>Below the TeleDongle frequency selector, the window
2290 contains a few significant pieces of information about
2291 the altimeter providing the telemetry data stream:</p>
2292 </div>
2293 <div class="ulist">
2294 <ul>
2295 <li>
2296 <p>The configured call-sign</p>
2297 </li>
2298 <li>
2299 <p>The device serial number</p>
2300 </li>
2301 <li>
2302 <p>The flight number. Each altimeter remembers how
2303 many times it has flown.</p>
2304 </li>
2305 <li>
2306 <p>The rocket flight state. Each flight passes through
2307 several states including Pad, Boost, Fast, Coast,
2308 Drogue, Main and Landed.</p>
2309 </li>
2310 <li>
2311 <p>The Received Signal Strength Indicator value. This
2312 lets you know how strong a signal TeleDongle is
2313 receiving. At the default data rate, 38400 bps, in
2314 bench testing, the radio inside TeleDongle v0.2
2315 operates down to about -106dBm, while the v3 radio
2316 works down to about -111dBm.  Weaker signals, or an
2317 environment with radio noise may cause the data to
2318 not be received. The packet link uses error
2319 detection and correction techniques which prevent
2320 incorrect data from being reported.</p>
2321 </li>
2322 <li>
2323 <p>The age of the displayed data, in seconds since the
2324 last successfully received telemetry packet.  In
2325 normal operation this will stay in the low single
2326 digits.  If the number starts counting up, then you
2327 are no longer receiving data over the radio link
2328 from the flight computer.</p>
2329 </li>
2330 </ul>
2331 </div>
2332 <div class="paragraph">
2333 <p>Finally, the largest portion of the window contains a
2334 set of tabs, each of which contain some information
2335 about the rocket.  They&#8217;re arranged in 'flight order'
2336 so that as the flight progresses, the selected tab
2337 automatically switches to display data relevant to the
2338 current state of the flight. You can select other tabs
2339 at any time. The final 'table' tab displays all of the
2340 raw telemetry values in one place in a
2341 spreadsheet-like format.</p>
2342 </div>
2343 <div class="sect3">
2344 <h4 id="_launch_pad">12.1.1. Launch Pad</h4>
2345 <div class="imageblock">
2346 <div class="content">
2347 <img src="launch-pad.png" alt="launch pad" width="400">
2348 </div>
2349 <div class="title">Figure 11. Monitor Flight Launch Pad View</div>
2350 </div>
2351 <div class="paragraph">
2352 <p>The 'Launch Pad' tab shows information used to decide when the
2353 rocket is ready for flight. The first elements include red/green
2354 indicators, if any of these is red, you&#8217;ll want to evaluate
2355 whether the rocket is ready to launch:</p>
2356 </div>
2357 <div class="dlist">
2358 <dl>
2359 <dt class="hdlist1">Battery Voltage</dt>
2360 <dd>
2361 <p>This indicates whether the Li-Po battery powering the
2362 flight computer has sufficient charge to last for
2363 the duration of the flight. A value of more than
2364 3.8V is required for a 'GO' status.</p>
2365 </dd>
2366 <dt class="hdlist1">Apogee Igniter Voltage</dt>
2367 <dd>
2368 <p>This indicates whether the apogee
2369 igniter has continuity. If the igniter has a low
2370 resistance, then the voltage measured here will be close
2371 to the Li-Po battery voltage. A value greater than 3.2V is
2372 required for a 'GO' status.</p>
2373 </dd>
2374 <dt class="hdlist1">Main Igniter Voltage</dt>
2375 <dd>
2376 <p>This indicates whether the main
2377 igniter has continuity. If the igniter has a low
2378 resistance, then the voltage measured here will be close
2379 to the Li-Po battery voltage. A value greater than 3.2V is
2380 required for a 'GO' status.</p>
2381 </dd>
2382 <dt class="hdlist1">On-board Data Logging</dt>
2383 <dd>
2384 <p>This indicates whether there is space remaining
2385 on-board to store flight data for the upcoming
2386 flight. If you&#8217;ve downloaded data, but failed to erase
2387 flights, there may not be any space left. Most of our
2388 flight computers can store multiple flights, depending
2389 on the configured maximum flight log size. TeleMini
2390 v1.0 stores only a single flight, so it will need to
2391 be downloaded and erased after each flight to capture
2392 data. This only affects on-board flight logging; the
2393 altimeter will still transmit telemetry and fire
2394 ejection charges at the proper times even if the
2395 flight data storage is full.</p>
2396 </dd>
2397 <dt class="hdlist1">GPS Locked</dt>
2398 <dd>
2399 <p>For a TeleMetrum or TeleMega device, this indicates
2400 whether the GPS receiver is currently able to compute
2401 position information. GPS requires at least 4
2402 satellites to compute an accurate position.</p>
2403 </dd>
2404 <dt class="hdlist1">GPS Ready</dt>
2405 <dd>
2406 <p>For a TeleMetrum or TeleMega device, this indicates
2407 whether GPS has reported at least 10 consecutive
2408 positions without losing lock. This ensures that the
2409 GPS receiver has reliable reception from the
2410 satellites.</p>
2411 </dd>
2412 </dl>
2413 </div>
2414 <div class="paragraph">
2415 <p>The Launchpad tab also shows the computed launch pad
2416 position and altitude, averaging many reported
2417 positions to improve the accuracy of the fix.</p>
2418 </div>
2419 </div>
2420 <div class="sect3">
2421 <h4 id="_ascent">12.1.2. Ascent</h4>
2422 <div class="imageblock">
2423 <div class="content">
2424 <img src="ascent.png" alt="ascent" width="400">
2425 </div>
2426 <div class="title">Figure 12. Monitor Flight Ascent View</div>
2427 </div>
2428 <div class="paragraph">
2429 <p>This tab is shown during Boost, Fast and Coast
2430 phases. The information displayed here helps monitor the
2431 rocket as it heads towards apogee.</p>
2432 </div>
2433 <div class="paragraph">
2434 <p>The height, speed, acceleration and tilt are shown along
2435 with the maximum values for each of them. This allows you to
2436 quickly answer the most commonly asked questions you&#8217;ll hear
2437 during flight.</p>
2438 </div>
2439 <div class="paragraph">
2440 <p>The current latitude and longitude reported by the GPS are
2441 also shown. Note that under high acceleration, these values
2442 may not get updated as the GPS receiver loses position
2443 fix. Once the rocket starts coasting, the receiver should
2444 start reporting position again.</p>
2445 </div>
2446 <div class="paragraph">
2447 <p>Finally, the current igniter voltages are reported as in the
2448 Launch Pad tab. This can help diagnose deployment failures
2449 caused by wiring which comes loose under high acceleration.</p>
2450 </div>
2451 </div>
2452 <div class="sect3">
2453 <h4 id="_descent">12.1.3. Descent</h4>
2454 <div class="imageblock">
2455 <div class="content">
2456 <img src="descent.png" alt="descent" width="400">
2457 </div>
2458 <div class="title">Figure 13. Monitor Flight Descent View</div>
2459 </div>
2460 <div class="paragraph">
2461 <p>Once the rocket has reached apogee and (we hope)
2462 activated the apogee charge, attention switches to
2463 tracking the rocket on the way back to the ground, and
2464 for dual-deploy flights, waiting for the main charge
2465 to fire.</p>
2466 </div>
2467 <div class="paragraph">
2468 <p>To monitor whether the apogee charge operated
2469 correctly, the current descent rate is reported along
2470 with the current height. Good descent rates vary based
2471 on the choice of recovery components, but generally
2472 range from 15-30m/s on drogue and should be below
2473 10m/s when under the main parachute in a dual-deploy
2474 flight.</p>
2475 </div>
2476 <div class="paragraph">
2477 <p>With GPS-equipped flight computers, you can locate the
2478 rocket in the sky using the elevation and bearing
2479 information to figure out where to look. Elevation is
2480 in degrees above the horizon. Bearing is reported in
2481 degrees relative to true north. Range can help figure
2482 out how big the rocket will appear. Ground Distance
2483 shows how far it is to a point directly under the
2484 rocket and can help figure out where the rocket is
2485 likely to land. Note that all of these values are
2486 relative to the pad location. If the elevation is near
2487 90°, the rocket is over the pad, not over you.</p>
2488 </div>
2489 <div class="paragraph">
2490 <p>Finally, the igniter voltages are reported in this tab
2491 as well, both to monitor the main charge as well as to
2492 see what the status of the apogee charge is.  Note
2493 that some commercial e-matches are designed to retain
2494 continuity even after being fired, and will continue
2495 to show as green or return from red to green after
2496 firing.</p>
2497 </div>
2498 </div>
2499 <div class="sect3">
2500 <h4 id="_landed">12.1.4. Landed</h4>
2501 <div class="imageblock">
2502 <div class="content">
2503 <img src="landed.png" alt="landed" width="400">
2504 </div>
2505 <div class="title">Figure 14. Monitor Flight Landed View</div>
2506 </div>
2507 <div class="paragraph">
2508 <p>Once the rocket is on the ground, attention switches
2509 to recovery. While the radio signal is often lost once
2510 the rocket is on the ground, the last reported GPS
2511 position is generally within a short distance of the
2512 actual landing location.</p>
2513 </div>
2514 <div class="paragraph">
2515 <p>The last reported GPS position is reported both by
2516 latitude and longitude as well as a bearing and
2517 distance from the launch pad. The distance should give
2518 you a good idea of whether to walk or hitch a ride.
2519 Take the reported latitude and longitude and enter
2520 them into your hand-held GPS unit and have that
2521 compute a track to the landing location.</p>
2522 </div>
2523 <div class="paragraph">
2524 <p>Our flight computers will continue to transmit RDF
2525 tones after landing, allowing you to locate the rocket
2526 by following the radio signal if necessary. You may
2527 need to get away from the clutter of the flight line,
2528 or even get up on a hill (or your neighbor&#8217;s RV roof)
2529 to receive the RDF signal.</p>
2530 </div>
2531 <div class="paragraph">
2532 <p>The maximum height, speed and acceleration reported
2533 during the flight are displayed for your admiring
2534 observers.  The accuracy of these immediate values
2535 depends on the quality of your radio link and how many
2536 packets were received.  Recovering the on-board data
2537 after flight may yield more precise results.</p>
2538 </div>
2539 <div class="paragraph">
2540 <p>To get more detailed information about the flight, you
2541 can click on the 'Graph Flight' button which will
2542 bring up a graph window for the current flight.</p>
2543 </div>
2544 </div>
2545 <div class="sect3">
2546 <h4 id="_table">12.1.5. Table</h4>
2547 <div class="imageblock">
2548 <div class="content">
2549 <img src="table.png" alt="table" width="400">
2550 </div>
2551 <div class="title">Figure 15. Monitor Flight Table View</div>
2552 </div>
2553 <div class="paragraph">
2554 <p>The table view shows all of the data available from the
2555 flight computer. Probably the most useful data on
2556 this tab is the detailed GPS information, which includes
2557 horizontal dilution of precision information, and
2558 information about the signal being received from the satellites.</p>
2559 </div>
2560 </div>
2561 <div class="sect3">
2562 <h4 id="_site_map">12.1.6. Site Map</h4>
2563 <div class="imageblock">
2564 <div class="content">
2565 <img src="site-map.png" alt="site map" width="400">
2566 </div>
2567 <div class="title">Figure 16. Monitor Flight Site Map View</div>
2568 </div>
2569 <div class="paragraph">
2570 <p>When the TeleMetrum has a GPS fix, the Site Map tab
2571 will map the rocket&#8217;s position to make it easier for
2572 you to locate the rocket, both while it is in the air,
2573 and when it has landed. The rocket&#8217;s state is
2574 indicated by color: white for pad, red for boost, pink
2575 for fast, yellow for coast, light blue for drogue,
2576 dark blue for main, and black for landed.</p>
2577 </div>
2578 <div class="paragraph">
2579 <p>The map&#8217;s default scale is approximately 3m (10ft) per
2580 pixel. The map can be dragged using the left mouse
2581 button. The map will attempt to keep the rocket
2582 roughly centered while data is being received.</p>
2583 </div>
2584 <div class="paragraph">
2585 <p>You can adjust the style of map and the zoom level
2586 with buttons on the right side of the map window. You
2587 can draw a line on the map by moving the mouse over
2588 the map with a button other than the left one pressed,
2589 or by pressing the left button while also holding down
2590 the shift key. The length of the line in real-world
2591 units will be shown at the start of the line.</p>
2592 </div>
2593 <div class="paragraph">
2594 <p>Images are fetched automatically via the Google Maps
2595 Static API, and cached on disk for reuse. If map
2596 images cannot be downloaded, the rocket&#8217;s path will be
2597 traced on a dark gray background instead.</p>
2598 </div>
2599 <div class="paragraph">
2600 <p>You can pre-load images for your favorite launch sites
2601 before you leave home; check out <a href="#_load_maps">Load Maps</a>.</p>
2602 </div>
2603 </div>
2604 <div class="sect3">
2605 <h4 id="_igniter">12.1.7. Igniter</h4>
2606 <div class="imageblock">
2607 <div class="content">
2608 <img src="ignitor.png" alt="ignitor" width="400">
2609 </div>
2610 <div class="title">Figure 17. Monitor Flight Additional Igniter View</div>
2611 </div>
2612 <div class="paragraph">
2613 <p>TeleMega includes four additional programmable pyro
2614 channels. The Ignitor tab shows whether each of them has
2615 continuity. If an ignitor has a low resistance, then the
2616 voltage measured here will be close to the pyro battery
2617 voltage. A value greater than 3.2V is required for a 'GO'
2618 status.</p>
2619 </div>
2620 </div>
2621 </div>
2622 <div class="sect2">
2623 <h3 id="_save_flight_data">12.2. Save Flight Data</h3>
2624 <div class="paragraph">
2625 <p>The altimeter records flight data to its internal
2626 flash memory.
2627 Data logged on board is recorded at a much
2628 higher rate than the telemetry system can handle, and
2629 is not subject to radio drop-outs. As such, it
2630 provides a more complete and precise record of the
2631 flight.
2632 The 'Save Flight Data' button allows you to
2633 read the flash memory and write it to disk.</p>
2634 </div>
2635 <div class="paragraph">
2636 <p>Clicking on the 'Save Flight Data' button brings up a
2637 list of connected flight computers and TeleDongle
2638 devices. If you select a flight computer, the flight
2639 data will be downloaded from that device directly.
2640 If you select a TeleDongle device, flight data will be
2641 downloaded from a flight computer over radio link via
2642 the specified TeleDongle. See
2643 <a href="#_controlling_an_altimeter_over_the_radio_link">Controlling An Altimeter Over The Radio Link</a> for
2644 more information.</p>
2645 </div>
2646 <div class="paragraph">
2647 <p>After the device has been selected, a dialog showing
2648 the flight data saved in the device will be shown
2649 allowing you to select which flights to download and
2650 which to delete. With version 0.9 or newer firmware,
2651 you must erase flights in order for the space they
2652 consume to be reused by another flight. This prevents
2653 accidentally losing flight data if you neglect to
2654 download data before flying again. Note that if there
2655 is no more space available in the device, then no data
2656 will be recorded during the next flight.</p>
2657 </div>
2658 <div class="paragraph">
2659 <p>The file name for each flight log is computed
2660 automatically from the recorded flight date, altimeter
2661 serial number and flight number information.</p>
2662 </div>
2663 </div>
2664 <div class="sect2">
2665 <h3 id="_replay_flight">12.3. Replay Flight</h3>
2666 <div class="paragraph">
2667 <p>Select this button and you are prompted to select a flight
2668 record file, either a .telem file recording telemetry data or a
2669 .eeprom file containing flight data saved from the altimeter
2670 flash memory.</p>
2671 </div>
2672 <div class="paragraph">
2673 <p>Once a flight record is selected, the flight monitor interface
2674 is displayed and the flight is re-enacted in real
2675 time.
2676 Check
2677 <a href="#_monitor_flight">Monitor Flight</a> to learn how this window operates.</p>
2678 </div>
2679 </div>
2680 <div class="sect2">
2681 <h3 id="_graph_data">12.4. Graph Data</h3>
2682 <div class="paragraph">
2683 <p>Select this button and you are prompted to select a flight
2684 record file, either a .telem file recording telemetry data or a
2685 .eeprom file containing flight data saved from
2686 flash memory.</p>
2687 </div>
2688 <div class="paragraph">
2689 <p>Note that telemetry files will generally produce poor graphs
2690 due to the lower sampling rate and missed telemetry packets.
2691 Use saved flight data in .eeprom files for graphing where possible.</p>
2692 </div>
2693 <div class="paragraph">
2694 <p>Once a flight record is selected, a window with multiple tabs is
2695 opened.</p>
2696 </div>
2697 <div class="sect3">
2698 <h4 id="_flight_graph">12.4.1. Flight Graph</h4>
2699 <div class="imageblock">
2700 <div class="content">
2701 <img src="graph.png" alt="graph" width="400">
2702 </div>
2703 <div class="title">Figure 18. Flight Data Graph</div>
2704 </div>
2705 <div class="paragraph">
2706 <p>By default, the graph contains acceleration (blue),
2707 velocity (green) and altitude (red).</p>
2708 </div>
2709 <div class="paragraph">
2710 <p>The graph can be zoomed into a particular area by
2711 clicking and dragging down and to the right. Once
2712 zoomed, the graph can be reset by clicking and
2713 dragging up and to the left. Holding down control and
2714 clicking and dragging allows the graph to be panned.
2715 The right mouse button causes a pop-up menu to be
2716 displayed, giving you the option save or print the
2717 plot.</p>
2718 </div>
2719 </div>
2720 <div class="sect3">
2721 <h4 id="_configure_graph">12.4.2. Configure Graph</h4>
2722 <div class="imageblock">
2723 <div class="content">
2724 <img src="graph-configure.png" alt="graph configure" width="400">
2725 </div>
2726 <div class="title">Figure 19. Flight Graph Configuration</div>
2727 </div>
2728 <div class="paragraph">
2729 <p>This selects which graph elements to show, and, at the
2730 very bottom. It also lets you configure how
2731 the graph is drawn:</p>
2732 </div>
2733 <div class="ulist">
2734 <ul>
2735 <li>
2736 <p>Whether to use metric or imperial units</p>
2737 </li>
2738 <li>
2739 <p>Whether to show a marker at each data
2740 point. When displaying a small section of
2741 the graph, these can be useful to know what
2742 data values were recorded.</p>
2743 </li>
2744 <li>
2745 <p>How wide to draw the lines in the graph</p>
2746 </li>
2747 <li>
2748 <p>How to filter speed and acceleration data
2749 computed from barometric data. Flight
2750 computers with accelerometers never display
2751 computed acceleration data, and only use
2752 barometric data to compute speed during
2753 descent. Flight computers without
2754 accelerometers always compute both speed and
2755 acceleration from barometric data. A larger
2756 value smooths the data more.</p>
2757 </li>
2758 </ul>
2759 </div>
2760 </div>
2761 <div class="sect3">
2762 <h4 id="_flight_statistics">12.4.3. Flight Statistics</h4>
2763 <div class="imageblock">
2764 <div class="content">
2765 <img src="graph-stats.png" alt="graph stats" width="400">
2766 </div>
2767 <div class="title">Figure 20. Flight Statistics</div>
2768 </div>
2769 <div class="paragraph">
2770 <p>Shows overall data computed from the flight.</p>
2771 </div>
2772 </div>
2773 <div class="sect3">
2774 <h4 id="_map">12.4.4. Map</h4>
2775 <div class="imageblock">
2776 <div class="content">
2777 <img src="graph-map.png" alt="graph map" width="400">
2778 </div>
2779 <div class="title">Figure 21. Flight Map</div>
2780 </div>
2781 <div class="paragraph">
2782 <p>Shows a satellite image of the flight area
2783 overlaid with the path of the flight. The
2784 flight path will have different colored
2785 sections for each state of the flight (just
2786 like the Site Map in Monitor Flight mode):
2787 white for pad, red for boost, pink for fast,
2788 yellow for coast, light blue for drogue, dark
2789 blue for main, and black for landed.</p>
2790 </div>
2791 <div class="paragraph">
2792 <p>The red concentric circles mark the launch
2793 pad, the black concentric circles mark the
2794 landing location. Data for the point along the
2795 along the flight path nearest the cursor will
2796 be displayed at the bottom of the window. This
2797 data includes flight time (so you can
2798 correlate data in the graph window), latitude,
2799 longitude, height above ground and vertical
2800 speed. The selected point will be highlighted
2801 with concentric circles in the same color as
2802 the flight path at that point.</p>
2803 </div>
2804 </div>
2805 </div>
2806 <div class="sect2">
2807 <h3 id="_export_data">12.5. Export Data</h3>
2808 <div class="paragraph">
2809 <p>This tool takes the raw data files and makes them
2810 available for external analysis. When you select this
2811 button, you are prompted to select a flight data file,
2812 which can be either a .eeprom or .telem.  The .eeprom
2813 files contain higher resolution and more continuous
2814 data, while .telem files contain receiver signal
2815 strength information.  Next, a second dialog appears
2816 which is used to select where to write the resulting
2817 file.
2818 It has a selector to choose between CSV and KML
2819 file formats.</p>
2820 </div>
2821 <div class="sect3">
2822 <h4 id="_comma_separated_value_format">12.5.1. Comma Separated Value Format</h4>
2823 <div class="paragraph">
2824 <p>This is a text file containing the data in a form
2825 suitable for import into a spreadsheet or other
2826 external data analysis tool. The first few lines of
2827 the file contain the version and configuration
2828 information from the altimeter, then there is a single
2829 header line which labels all of the fields. All of
2830 these lines start with a '#' character which many
2831 tools can be configured to skip over.</p>
2832 </div>
2833 <div class="paragraph">
2834 <p>The remaining lines of the file contain the data, with
2835 each field separated by a comma and at least one
2836 space. All of the sensor values are converted to
2837 standard units, with the barometric data reported in
2838 both pressure, altitude and height above pad units.</p>
2839 </div>
2840 </div>
2841 <div class="sect3">
2842 <h4 id="_keyhole_markup_language_for_google_earth">12.5.2. Keyhole Markup Language (for Google Earth)</h4>
2843 <div class="paragraph">
2844 <p>This is the format used by Google Earth to provide an
2845 overlay within that application. With this, you can
2846 use Google Earth to see the whole flight path
2847 in 3D.</p>
2848 </div>
2849 </div>
2850 </div>
2851 <div class="sect2">
2852 <h3 id="_configure_altimeter">12.6. Configure Altimeter</h3>
2853 <div class="imageblock">
2854 <div class="content">
2855 <img src="configure-altimeter.png" alt="configure altimeter" width="350">
2856 </div>
2857 <div class="title">Figure 22. Altimeter Configuration</div>
2858 </div>
2859 <div class="paragraph">
2860 <p>Select this button and then select either an altimeter or
2861 TeleDongle Device from the list provided. Selecting a TeleDongle
2862 device will use the radio link to configure a remote
2863 altimeter.</p>
2864 </div>
2865 <div class="paragraph">
2866 <p>The first few lines of the dialog provide information about the
2867 connected device, including the product name,
2868 software version and hardware serial number. Below that are the
2869 individual configuration entries.</p>
2870 </div>
2871 <div class="paragraph">
2872 <p>At the bottom of the dialog, there are four buttons:</p>
2873 </div>
2874 <div class="dlist">
2875 <dl>
2876 <dt class="hdlist1">Save</dt>
2877 <dd>
2878 <p>This writes any changes to the configuration parameter
2879 block in flash memory. If you don&#8217;t press this button,
2880 any changes you make will be lost.</p>
2881 </dd>
2882 <dt class="hdlist1">Reset</dt>
2883 <dd>
2884 <p>This resets the dialog to the most recently saved
2885 values, erasing any changes you have made.</p>
2886 </dd>
2887 <dt class="hdlist1">Reboot</dt>
2888 <dd>
2889 <p>This reboots the device. Use this to switch from idle
2890 to pad mode by rebooting once the rocket is oriented
2891 for flight, or to confirm changes you think you saved
2892 are really saved.</p>
2893 </dd>
2894 <dt class="hdlist1">Close</dt>
2895 <dd>
2896 <p>This closes the dialog. Any unsaved changes will be
2897 lost.</p>
2898 </dd>
2899 </dl>
2900 </div>
2901 <div class="paragraph">
2902 <p>The rest of the dialog contains the parameters to be configured.</p>
2903 </div>
2904 <div class="sect3">
2905 <h4 id="_main_deploy_altitude">12.6.1. Main Deploy Altitude</h4>
2906 <div class="paragraph">
2907 <p>This sets the altitude (above the recorded pad
2908 altitude) at which the 'main' igniter will fire. The
2909 drop-down menu shows some common values, but you can
2910 edit the text directly and choose whatever you
2911 like. If the apogee charge fires below this altitude,
2912 then the main charge will fire two seconds after the
2913 apogee charge fires.</p>
2914 </div>
2915 </div>
2916 <div class="sect3">
2917 <h4 id="_apogee_delay">12.6.2. Apogee Delay</h4>
2918 <div class="paragraph">
2919 <p>When flying redundant electronics, it&#8217;s often
2920 important to ensure that multiple apogee charges don&#8217;t
2921 fire at precisely the same time, as that can over
2922 pressurize the apogee deployment bay and cause a
2923 structural failure of the air-frame. The Apogee Delay
2924 parameter tells the flight computer to fire the apogee
2925 charge a certain number of seconds after apogee has
2926 been detected.</p>
2927 </div>
2928 </div>
2929 <div class="sect3">
2930 <h4 id="_apogee_lockout">12.6.3. Apogee Lockout</h4>
2931 <div class="paragraph">
2932 <p>Apogee lockout is the number of seconds after launch
2933 where the flight computer will not fire the apogee
2934 charge, even if the rocket appears to be at
2935 apogee. This is often called 'Mach Delay', as it is
2936 intended to prevent a flight computer from
2937 unintentionally firing apogee charges due to the
2938 pressure spike that occurrs across a mach
2939 transition. Altus Metrum flight computers include a
2940 Kalman filter which is not fooled by this sharp
2941 pressure increase, and so this setting should be left
2942 at the default value of zero to disable it.</p>
2943 </div>
2944 <div class="admonitionblock warning">
2945 <table>
2946 <tr>
2947 <td class="icon">
2948 <img src="./images/icons/warning.svg" alt="Warning">
2949 </td>
2950 <td class="content">
2951 Firmware versions older than 1.8.6 have a
2952 bug which resets the time since launch to zero each
2953 time a motor starts burning. Update firmware to get
2954 the correct behavior.
2955 </td>
2956 </tr>
2957 </table>
2958 </div>
2959 </div>
2960 <div class="sect3">
2961 <h4 id="_frequency">12.6.4. Frequency</h4>
2962 <div class="paragraph">
2963 <p>This configures which of the frequencies to use for
2964 both telemetry and packet command mode. Note that if
2965 you set this value via packet command mode, the
2966 TeleDongle frequency will also be automatically
2967 reconfigured to match so that communication will
2968 continue afterwards.</p>
2969 </div>
2970 </div>
2971 <div class="sect3">
2972 <h4 id="_rf_calibration">12.6.5. RF Calibration</h4>
2973 <div class="paragraph">
2974 <p>The radios in every Altus Metrum device are calibrated
2975 at the factory to ensure that they transmit and
2976 receive on the specified frequency.  If you need to
2977 you can adjust the calibration by changing this value.
2978 Do not do this without understanding what the value
2979 means, read the appendix on calibration and/or the
2980 source code for more information.  To change a
2981 TeleDongle&#8217;s calibration, you must reprogram the unit
2982 completely.</p>
2983 </div>
2984 </div>
2985 <div class="sect3">
2986 <h4 id="_telemetryrdfaprs_enable">12.6.6. Telemetry/RDF/APRS Enable</h4>
2987 <div class="paragraph">
2988 <p>Enables the radio for transmission during
2989 flight. When disabled, the radio will not
2990 transmit anything during flight at all.</p>
2991 </div>
2992 </div>
2993 <div class="sect3">
2994 <h4 id="_telemetry_baud_rate">12.6.7. Telemetry baud rate</h4>
2995 <div class="paragraph">
2996 <p>This sets the modulation bit rate for data
2997 transmission for both telemetry and packet
2998 link mode. Lower bit rates will increase range
2999 while reducing the amount of data that can be
3000 sent and increasing battery consumption. All
3001 telemetry is done using a rate 1/2 constraint
3002 4 convolution code, so the actual data
3003 transmission rate is 1/2 of the modulation bit
3004 rate specified here.</p>
3005 </div>
3006 </div>
3007 <div class="sect3">
3008 <h4 id="_aprs_interval">12.6.8. APRS Interval</h4>
3009 <div class="paragraph">
3010 <p>How often to transmit GPS information via APRS
3011 (in seconds). When set to zero, APRS
3012 transmission is disabled.
3013 This option is
3014 available on TeleMetrum v2 or newer and TeleMega
3015 boards. TeleMetrum v1 boards cannot transmit
3016 APRS packets.
3017 Note that a single APRS packet
3018 takes nearly a full second to transmit, so
3019 enabling this option will prevent sending any
3020 other telemetry during that time.</p>
3021 </div>
3022 </div>
3023 <div class="sect3">
3024 <h4 id="_aprs_ssid">12.6.9. APRS SSID</h4>
3025 <div class="paragraph">
3026 <p>Which SSID to report in APRS packets. By
3027 default, this is set to the last digit of the
3028 serial number, but can be configured to any
3029 value from 0 to 9.</p>
3030 </div>
3031 </div>
3032 <div class="sect3">
3033 <h4 id="_aprs_format">12.6.10. APRS Format</h4>
3034 <div class="paragraph">
3035 <p>Whether to send APRS data in Compressed or
3036 Uncompressed format. Compressed format is
3037 smaller and more precise. Uncompressed
3038 format is older, but may work better with your
3039 device. The Kenwood TH-D72 only displays
3040 altitude information with Uncompressed
3041 format, while the Yaesu FT1D only displays
3042 altitude with Compressed format. Test before
3043 you fly to see which to use.</p>
3044 </div>
3045 </div>
3046 <div class="sect3">
3047 <h4 id="_aprs_offset">12.6.11. APRS Offset</h4>
3048 <div class="paragraph">
3049 <p>The delay from the top of the minute before sending
3050 the first APRS packet of the minute. Coordinating
3051 values for this parameter between multiple devices can
3052 allow a single receiver to reliably receive APRS
3053 packets from multiple devices. Note that this offset only
3054 takes effect while the GPS signal is locked so that the
3055 transmitting device knows the current time.</p>
3056 </div>
3057 </div>
3058 <div class="sect3">
3059 <h4 id="_callsign">12.6.12. Callsign</h4>
3060 <div class="paragraph">
3061 <p>This sets the call sign included in each
3062 telemetry packet. Set this as needed to
3063 conform to your local radio regulations.</p>
3064 </div>
3065 </div>
3066 <div class="sect3">
3067 <h4 id="_maximum_flight_log_size">12.6.13. Maximum Flight Log Size</h4>
3068 <div class="paragraph">
3069 <p>This sets the space (in kilobytes) allocated
3070 for each flight log. The available space will
3071 be divided into chunks of this size. A smaller
3072 value will allow more flights to be stored, a
3073 larger value will record data from longer
3074 flights.</p>
3075 </div>
3076 </div>
3077 <div class="sect3">
3078 <h4 id="_ignitor_firing_mode">12.6.14. Ignitor Firing Mode</h4>
3079 <div class="paragraph">
3080 <p>This configuration parameter allows the two standard ignitor
3081 channels (Apogee and Main) to be used in different
3082 configurations.</p>
3083 </div>
3084 <div class="dlist">
3085 <dl>
3086 <dt class="hdlist1">Dual Deploy</dt>
3087 <dd>
3088 <p>This is the usual mode of operation; the
3089 'apogee' channel is fired at apogee and the
3090 'main' channel at the height above ground
3091 specified by the 'Main Deploy Altitude' during
3092 descent.</p>
3093 </dd>
3094 <dt class="hdlist1">Redundant Apogee</dt>
3095 <dd>
3096 <p>This fires both channels at apogee, the
3097 'apogee' channel first followed after a two
3098 second delay by the 'main' channel.</p>
3099 </dd>
3100 <dt class="hdlist1">Redundant Main</dt>
3101 <dd>
3102 <p>This fires both channels at the height above
3103 ground specified by the Main Deploy Altitude
3104 setting during descent. The 'apogee' channel
3105 is fired first, followed after a two second
3106 delay by the 'main' channel.</p>
3107 </dd>
3108 </dl>
3109 </div>
3110 </div>
3111 <div class="sect3">
3112 <h4 id="_pad_orientation">12.6.15. Pad Orientation</h4>
3113 <div class="paragraph">
3114 <p>Because they include accelerometers,
3115 TeleMetrum, TeleMega and EasyMega are
3116 sensitive to the orientation of the board. By
3117 default, they expect the antenna end to point
3118 forward. This parameter allows that default to
3119 be changed, permitting the board to be mounted
3120 with the antenna pointing aft instead.</p>
3121 </div>
3122 <div class="dlist">
3123 <dl>
3124 <dt class="hdlist1">Antenna Up</dt>
3125 <dd>
3126 <p>In this mode, the antenna (or beeper, for devices
3127 without an antenna) of the flight computer must point
3128 forward, in line with the expected flight path.</p>
3129 </dd>
3130 <dt class="hdlist1">Antenna Down</dt>
3131 <dd>
3132 <p>In this mode, the antenna (or beeper, for devices
3133 without an antenna) end of the flight computer must
3134 point aft, in line with the expected flight path.</p>
3135 </dd>
3136 </dl>
3137 </div>
3138 </div>
3139 <div class="sect3">
3140 <h4 id="_beeper_frequency">12.6.16. Beeper Frequency</h4>
3141 <div class="paragraph">
3142 <p>The beeper on all Altus Metrum flight
3143 computers works best at 4000Hz, however if you
3144 have more than one flight computer in a single
3145 airframe, having all of them sound at the same
3146 frequency can be confusing. This parameter
3147 lets you adjust the base beeper frequency
3148 value.</p>
3149 </div>
3150 </div>
3151 <div class="sect3">
3152 <h4 id="_logging_trigger_motion">12.6.17. Logging Trigger Motion</h4>
3153 <div class="paragraph">
3154 <p>This sets the amount of motion that TeleGPS
3155 needs to see before logging the new
3156 position. Motions smaller than this are
3157 skipped, which saves storage space.</p>
3158 </div>
3159 </div>
3160 <div class="sect3">
3161 <h4 id="_position_reporting_interval">12.6.18. Position Reporting Interval</h4>
3162 <div class="paragraph">
3163 <p>The interval between TeleGPS position reports,
3164 both over the air and in the log. Increase
3165 this to reduce the frequency of radio
3166 transmissions and the length of time available
3167 in the log.</p>
3168 </div>
3169 </div>
3170 <div class="sect3">
3171 <h4 id="_calibrate_accelerometer">12.6.19. Calibrate Accelerometer</h4>
3172 <div class="paragraph">
3173 <p>This opens a separate window to recalibrate the
3174 accelerometers. Follow the instructions, orienting the
3175 flight computer with the antenna end, or end opposite
3176 the screw terminals, in the case of EasyMega, first up
3177 and then down.</p>
3178 </div>
3179 <div class="paragraph">
3180 <p>When the calibration is complete, return to the
3181 Configure Altimeter window and save the new
3182 calibration values.</p>
3183 </div>
3184 </div>
3185 <div class="sect3">
3186 <h4 id="_configure_pyro_channels">12.6.20. Configure Pyro Channels</h4>
3187 <div class="imageblock">
3188 <div class="content">
3189 <img src="configure-pyro.png" alt="configure pyro" width="400">
3190 </div>
3191 <div class="title">Figure 23. Additional Pyro Channel Configuration</div>
3192 </div>
3193 <div class="paragraph">
3194 <p>This opens a separate window to configure the
3195 additional pyro channels available on TeleMega,
3196 EasyMega and EasyTimer.  One column is presented for
3197 each channel. Each row represents a single
3198 parameter, if enabled the parameter must meet
3199 the specified test for the pyro channel to be
3200 fired.</p>
3201 </div>
3202 <div class="paragraph">
3203 <p>Select conditions and set the related value;
3204 the pyro channel will be activated when <strong>all</strong>
3205 of the conditions are met. Each pyro channel
3206 has a separate set of configuration values, so
3207 you can use different values for the same
3208 condition with different channels.</p>
3209 </div>
3210 <div class="paragraph">
3211 <p>At the bottom of the window, the 'Pyro Firing
3212 Time' configuration sets the length of time
3213 (in seconds) which each of these pyro channels
3214 will fire for.</p>
3215 </div>
3216 <div class="paragraph">
3217 <p>Once you have selected the appropriate
3218 configuration for all of the necessary pyro
3219 channels, you can save the pyro configuration
3220 along with the rest of the flight computer
3221 configuration by pressing the 'Save' button in
3222 the main Configure Flight Computer window.</p>
3223 </div>
3224 <div class="dlist">
3225 <dl>
3226 <dt class="hdlist1">Vertical Acceleration</dt>
3227 <dd>
3228 <p>Select a value, and then choose whether
3229 acceleration away from the ground should be above or below that
3230 value. Acceleration is positive upwards, so accelerating towards the
3231 ground would produce negative numbers. Acceleration during descent is
3232 noisy and inaccurate, so be careful when using it during these phases
3233 of the flight.</p>
3234 </dd>
3235 <dt class="hdlist1">Ascent rate</dt>
3236 <dd>
3237 <p>Select a value, and then choose whether ascent rate
3238 should be above or below that value. Ascent rate is positive upwards,
3239 so moving towards the ground would produce negative numbers. Ascent
3240 rate during descent is a bit noisy and so be careful when using it
3241 during these phases of the flight.</p>
3242 </dd>
3243 <dt class="hdlist1">Height above pad</dt>
3244 <dd>
3245 <p>Select a value, and then choose whether the height
3246 above the launch pad should be above or below that value. Note that
3247 because EasyTimer has only a low-range accelerometer and no barometer,
3248 this value will not be very reliable on that device.</p>
3249 </dd>
3250 <dt class="hdlist1">Orientation</dt>
3251 <dd>
3252 <p>TeleMega, EasyMega and EasyTimer contain a 3-axis
3253 gyroscope and accelerometer which is used to compute the orientation
3254 of the rocket. A record of orientations over the last 0.64 seconds is
3255 kept and the largest value within this period is compared with the
3256 specified value. Note that the tilt angle is not the change in angle
3257 from the launch pad, but rather absolute relative to gravity—the
3258 3-axis accelerometer is used to compute the angle of the rocket on the
3259 launch pad and initialize the system.</p>
3260 </dd>
3261 </dl>
3262 </div>
3263 <div class="admonitionblock note">
3264 <table>
3265 <tr>
3266 <td class="icon">
3267 <img src="./images/icons/note.svg" alt="Note">
3268 </td>
3269 <td class="content">
3270 <div class="paragraph">
3271 <p>Because this value is computed by integrating
3272 rate gyros, it gets progressively less
3273 accurate as the flight goes on. It should have
3274 an accumulated error of less than 0.2°/second
3275 (after 10 seconds of flight, the error should
3276 be less than 2°).</p>
3277 </div>
3278 <div class="paragraph">
3279 <p>The usual use of the orientation configuration
3280 is to ensure that the rocket is traveling
3281 mostly upwards when deciding whether to ignite
3282 air starts or additional stages. For that,
3283 choose a reasonable maximum angle (like 20°)
3284 and set the motor igniter to require an angle
3285 of less than that value.</p>
3286 </div>
3287 </td>
3288 </tr>
3289 </table>
3290 </div>
3291 <div class="dlist">
3292 <dl>
3293 <dt class="hdlist1">Flight Time</dt>
3294 <dd>
3295 <p>Time since launch. Select a value and choose whether to
3296 activate the pyro channel before or after that amount of time.</p>
3297 </dd>
3298 </dl>
3299 </div>
3300 <div class="admonitionblock warning">
3301 <table>
3302 <tr>
3303 <td class="icon">
3304 <img src="./images/icons/warning.svg" alt="Warning">
3305 </td>
3306 <td class="content">
3307 Firmware versions older than 1.8.6 have a bug which resets the time
3308 since launch to zero each time a motor starts burning. Update firmware
3309 to get the correct behavior.
3310 </td>
3311 </tr>
3312 </table>
3313 </div>
3314 <div class="dlist">
3315 <dl>
3316 <dt class="hdlist1">Ascending</dt>
3317 <dd>
3318 <p>A deprecated configuration value which was the same as
3319 setting Ascent rate &gt; 0. Existing configurations using this will be
3320 cleared and must be reconfigured by the user.</p>
3321 </dd>
3322 <dt class="hdlist1">Descending</dt>
3323 <dd>
3324 <p>A deprecated configuration value which was the same as
3325 setting Ascent rate &lt; 0. Existing configurations using this will be
3326 cleared and must be reconfigured by the user.</p>
3327 </dd>
3328 <dt class="hdlist1">After Motor</dt>
3329 <dd>
3330 <p>The flight software counts each time the rocket starts
3331 accelerating and then decelerating (presumably due to a motor or
3332 motors burning). Use this value for multi-staged or multi-airstart
3333 launches. As of version 1.8.6 firmware, this checks to make sure at
3334 least this many motors have burned. Before version 1.8.6, this checked
3335 to make sure that exactly this many motors had burned.</p>
3336 </dd>
3337 <dt class="hdlist1">Delay</dt>
3338 <dd>
3339 <p>Once the other parameters all become true, a timer is
3340 started for the specified amount of time. While the timer is running,
3341 the other parameters are checked repeatedly and if any of them become
3342 false, then the pyro channel is disabled and will not fire. If the
3343 timer expires and all of the other parameters have remained true for
3344 the entire time, then the pyro channel is fired.</p>
3345 </dd>
3346 <dt class="hdlist1">Flight State</dt>
3347 <dd>
3348 <p>The flight software tracks the flight
3349 through a sequence of states:</p>
3350 <div class="ulist">
3351 <ul>
3352 <li>
3353 <p>Boost. The motor has lit and the rocket is
3354 accelerating upwards. Ascent rate will be greater than zero.
3355 Vertical acceleration will be greater than zero.</p>
3356 </li>
3357 <li>
3358 <p>Fast. The motor has burned out and the
3359 rocket is decelerating, but it is going
3360 faster than 200m/s. Ascent rate will be greater than zero. Vertical
3361 acceleration will be less than zero.</p>
3362 </li>
3363 <li>
3364 <p>Coast. The rocket is still moving upwards
3365 and decelerating, but the Ascent rate is less
3366 than 200m/s. Ascent rate will greater than zero. Vertical
3367 acceleration will be less than zero.</p>
3368 </li>
3369 <li>
3370 <p>Drogue. The rocket has reached apogee and is heading back down, but
3371 is above the configured Main altitude. Ascent rate will be less
3372 than zero during this state. Vertical acceleration will be negative
3373 until the rocket reaches a terminal descent rate, at which point
3374 Vertical acceleration will be zero. Both Ascent rate and Vertical
3375 acceleration are very noisy in this state, so be careful when
3376 trying to use them to control pyro channels. This state selection
3377 is not available on EasyTimer.</p>
3378 </li>
3379 <li>
3380 <p>Main. The rocket is still descending, and
3381 is below the Main altitude. Ascent rate will be less than zero
3382 during this state. Vertical acceleration may be briefly less than
3383 zero as the rocket slows from drogue descent to main descent, but
3384 it will settle down to a zero value once the rocket has reached the
3385 terminal velocity under the main chute. Ascent rate and Vertical
3386 acceleration should be much less noisy once the main chute has
3387 deployed. This state selection is not available on EasyTimer.</p>
3388 </li>
3389 <li>
3390 <p>Landed. The rocket is no longer moving.</p>
3391 </li>
3392 </ul>
3393 </div>
3394 </dd>
3395 </dl>
3396 </div>
3397 <div class="paragraph">
3398 <p>You can select a state to limit when the pyro channel may activate;
3399 note that the check is based on when the rocket transitions <strong>into</strong> the
3400 state, and so checking for “greater than Boost” means that the rocket
3401 is currently in boost or some later state.</p>
3402 </div>
3403 <div class="paragraph">
3404 <p>When a motor burns out, the rocket enters either Fast or Coast state
3405 (depending on how fast it is moving). If the computer detects upwards
3406 acceleration again, it will move back to Boost state.</p>
3407 </div>
3408 </div>
3409 </div>
3410 <div class="sect2">
3411 <h3 id="_configure_altosui">12.7. Configure AltosUI</h3>
3412 <div class="imageblock">
3413 <div class="content">
3414 <img src="configure-altosui.png" alt="configure altosui" width="230">
3415 </div>
3416 <div class="title">Figure 24. Configure AltosUI Dialog</div>
3417 </div>
3418 <div class="paragraph">
3419 <p>This button presents a dialog so that you can
3420 configure the AltosUI global settings.</p>
3421 </div>
3422 <div class="sect3">
3423 <h4 id="_voice_settings">12.7.1. Voice Settings</h4>
3424 <div class="paragraph">
3425 <p>AltosUI provides voice announcements during
3426 flight so that you can keep your eyes on the
3427 sky and still get information about the
3428 current flight status. However, sometimes you
3429 don&#8217;t want to hear them.</p>
3430 </div>
3431 <div class="dlist">
3432 <dl>
3433 <dt class="hdlist1">Enable</dt>
3434 <dd>
3435 <p>Turns all voice announcements on and off</p>
3436 </dd>
3437 <dt class="hdlist1">Test Voice</dt>
3438 <dd>
3439 <p>Plays a short message allowing you to verify
3440 that the audio system is working and the volume settings
3441 are reasonable</p>
3442 </dd>
3443 </dl>
3444 </div>
3445 </div>
3446 <div class="sect3">
3447 <h4 id="_log_directory">12.7.2. Log Directory</h4>
3448 <div class="paragraph">
3449 <p>AltosUI logs all telemetry data and saves all
3450 flash data to this directory. This
3451 directory is also used as the staring point
3452 when selecting data files for display or
3453 export.</p>
3454 </div>
3455 <div class="paragraph">
3456 <p>Click on the directory name to bring up a
3457 directory choosing dialog, select a new
3458 directory and click 'Select Directory' to
3459 change where AltosUI reads and writes data
3460 files.</p>
3461 </div>
3462 </div>
3463 <div class="sect3">
3464 <h4 id="_callsign_2">12.7.3. Callsign</h4>
3465 <div class="paragraph">
3466 <p>This value is transmitted in each command
3467 packet sent from TeleDongle and received from
3468 an altimeter.  It is not used in telemetry
3469 mode, as the callsign configured in the
3470 altimeter board is included in all telemetry
3471 packets.  Configure this with the AltosUI
3472 operators call sign as needed to comply with
3473 your local radio regulations.</p>
3474 </div>
3475 <div class="paragraph">
3476 <p>Note that to successfully command a flight
3477 computer over the radio (to configure the
3478 altimeter, monitor idle, or fire pyro
3479 charges), the callsign configured here must
3480 exactly match the callsign configured in the
3481 flight computer.  This matching is case
3482 sensitive.</p>
3483 </div>
3484 </div>
3485 <div class="sect3">
3486 <h4 id="_imperial_units">12.7.4. Imperial Units</h4>
3487 <div class="paragraph">
3488 <p>This switches between metric units (meters)
3489 and imperial units (feet and miles). This
3490 affects the display of values use during
3491 flight monitoring, configuration, data
3492 graphing and all of the voice
3493 announcements. It does not change the units
3494 used when exporting to CSV files, those are
3495 always produced in metric units.</p>
3496 </div>
3497 </div>
3498 <div class="sect3">
3499 <h4 id="_serial_debug">12.7.5. Serial Debug</h4>
3500 <div class="paragraph">
3501 <p>This causes all communication with a connected
3502 device to be dumped to the console from which
3503 AltosUI was started. If you&#8217;ve started it from
3504 an icon or menu entry, the output will simply
3505 be discarded. This mode can be useful to debug
3506 various serial communication issues.</p>
3507 </div>
3508 </div>
3509 <div class="sect3">
3510 <h4 id="_font_size">12.7.6. Font size</h4>
3511 <div class="paragraph">
3512 <p>Selects the set of fonts used in the flight
3513 monitor window. Choose between the small,
3514 medium and large sets.</p>
3515 </div>
3516 </div>
3517 <div class="sect3">
3518 <h4 id="_look_feel">12.7.7. Look &amp; feel</h4>
3519 <div class="paragraph">
3520 <p>Switches between the available Java user
3521 interface appearances. The default selection
3522 is supposed to match the native window system
3523 appearance for the target platform.</p>
3524 </div>
3525 </div>
3526 <div class="sect3">
3527 <h4 id="_menu_position">12.7.8. Menu position</h4>
3528 <div class="paragraph">
3529 <p>Selects the initial position for the main
3530 AltosUI window that includes all of the
3531 command buttons.</p>
3532 </div>
3533 </div>
3534 <div class="sect3">
3535 <h4 id="_map_cache_size">12.7.9. Map Cache Size</h4>
3536 <div class="paragraph">
3537 <p>Sets the number of map 'tiles' kept in memory
3538 while the application is running. More tiles
3539 consume more memory, but will make panning
3540 around the map faster.</p>
3541 </div>
3542 </div>
3543 <div class="sect3">
3544 <h4 id="_manage_frequencies">12.7.10. Manage Frequencies</h4>
3545 <div class="paragraph">
3546 <p>This brings up a dialog where you can
3547 configure the set of frequencies shown in the
3548 various frequency menus. You can add as many
3549 as you like, or even reconfigure the default
3550 set. Changing this list does not affect the
3551 frequency settings of any devices, it only
3552 changes the set of frequencies shown in the
3553 menus.</p>
3554 </div>
3555 </div>
3556 </div>
3557 <div class="sect2">
3558 <h3 id="_configure_groundstation">12.8. Configure Groundstation</h3>
3559 <div class="imageblock">
3560 <div class="content">
3561 <img src="configure-groundstation.png" alt="configure groundstation" width="300">
3562 </div>
3563 <div class="title">Figure 25. Configure Groundstation Dialog</div>
3564 </div>
3565 <div class="paragraph">
3566 <p>Select this button and then select a TeleDongle or
3567 TeleBT Device from the list provided.</p>
3568 </div>
3569 <div class="paragraph">
3570 <p>The first few lines of the dialog provide information
3571 about the connected device, including the product
3572 name, software version and hardware serial
3573 number. Below that are the individual configuration
3574 entries.</p>
3575 </div>
3576 <div class="paragraph">
3577 <p>Note that TeleDongle and TeleBT don&#8217;t save any
3578 configuration data, the settings here are recorded on
3579 the local machine in the Java preferences
3580 database. Moving the device to another machine, or
3581 using a different user account on the same machine
3582 will cause settings made here to have no effect.</p>
3583 </div>
3584 <div class="paragraph">
3585 <p>At the bottom of the dialog, there are three
3586 buttons:</p>
3587 </div>
3588 <div class="dlist">
3589 <dl>
3590 <dt class="hdlist1">Save</dt>
3591 <dd>
3592 <p>This writes any changes to the local Java
3593 preferences file. If you don&#8217;t press this
3594 button, any changes you make will be lost.</p>
3595 </dd>
3596 <dt class="hdlist1">Reset</dt>
3597 <dd>
3598 <p>This resets the dialog to the most recently
3599 saved values, erasing any changes you have
3600 made.</p>
3601 </dd>
3602 <dt class="hdlist1">Close</dt>
3603 <dd>
3604 <p>This closes the dialog. Any unsaved changes
3605 will be lost.</p>
3606 </dd>
3607 </dl>
3608 </div>
3609 <div class="paragraph">
3610 <p>The rest of the dialog contains the parameters
3611 to be configured.</p>
3612 </div>
3613 <div class="sect3">
3614 <h4 id="_frequency_2">12.8.1. Frequency</h4>
3615 <div class="paragraph">
3616 <p>This configures the frequency to use for both
3617 telemetry and packet command mode. Set this
3618 before starting any operation involving packet
3619 command mode so that it will use the right
3620 frequency. Telemetry monitoring mode also
3621 provides a menu to change the frequency, and
3622 that menu also sets the same Java preference
3623 value used here.</p>
3624 </div>
3625 </div>
3626 <div class="sect3">
3627 <h4 id="_rf_calibration_2">12.8.2. RF Calibration</h4>
3628 <div class="paragraph">
3629 <p>The radios in every Altus Metrum device are
3630 calibrated at the factory to ensure that they
3631 transmit and receive on the specified
3632 frequency.  To change a TeleDongle or TeleBT&#8217;s
3633 calibration, you must reprogram the unit
3634 completely, so this entry simply shows the
3635 current value and doesn&#8217;t allow any changes.</p>
3636 </div>
3637 </div>
3638 <div class="sect3">
3639 <h4 id="_telemetry_rate">12.8.3. Telemetry Rate</h4>
3640 <div class="paragraph">
3641 <p>This lets you match the telemetry and packet
3642 link rate from the transmitter. If they don&#8217;t
3643 match, the device won&#8217;t receive any data.</p>
3644 </div>
3645 </div>
3646 </div>
3647 <div class="sect2">
3648 <h3 id="_flash_image">12.9. Flash Image</h3>
3649 <div class="paragraph">
3650 <p>This reprograms Altus Metrum devices with new
3651 firmware.
3652 TeleMetrum v1.x, TeleDongle v0.2, TeleMini v1.0
3653 and TeleBT v1.0 are all reprogrammed by using another
3654 similar unit as a programming dongle (pair
3655 programming).
3656 TeleMega, EasyMega, TeleMetrum v2 or newer,
3657 EasyMini, EasyTimer, TeleBT v3 or newer and TeleDongle v3
3658 or newer are all
3659 programmed directly
3660 over USB (self programming). Please read
3661 the directions for flashing devices in
3662 <a href="#_updating_device_firmware">Updating Device Firmware</a>.</p>
3663 </div>
3664 </div>
3665 <div class="sect2">
3666 <h3 id="_fire_igniter">12.10. Fire Igniter</h3>
3667 <div class="imageblock">
3668 <div class="content">
3669 <img src="fire-igniter.png" alt="fire igniter" width="120">
3670 </div>
3671 <div class="title">Figure 26. Fire Igniter Window</div>
3672 </div>
3673 <div class="paragraph">
3674 <p>This activates the igniter circuits in the flight
3675 computer to help test recovery systems
3676 deployment.
3677 Because this command can operate over the
3678 Packet Command Link, you can prepare the rocket as for
3679 flight and then test the recovery system without
3680 needing to snake wires inside the air-frame.</p>
3681 </div>
3682 <div class="paragraph">
3683 <p>Selecting the 'Fire Igniter' button brings up the
3684 usual device selection dialog. Pick the desired
3685 device. This brings up another window which shows the
3686 current continuity test status for all of the pyro
3687 channels.</p>
3688 </div>
3689 <div class="paragraph">
3690 <p>Next, select the desired igniter to fire. This will
3691 enable the 'Arm' button.</p>
3692 </div>
3693 <div class="paragraph">
3694 <p>Select the 'Arm' button. This enables the 'Fire'
3695 button. The word 'Arm' is replaced by a countdown
3696 timer indicating that you have 10 seconds to press the
3697 'Fire' button or the system will deactivate, at which
3698 point you start over again at selecting the desired
3699 igniter.</p>
3700 </div>
3701 </div>
3702 <div class="sect2">
3703 <h3 id="_scan_channels">12.11. Scan Channels</h3>
3704 <div class="imageblock">
3705 <div class="content">
3706 <img src="scan-channels.png" alt="scan channels" width="300">
3707 </div>
3708 <div class="title">Figure 27. Scan Channels Window</div>
3709 </div>
3710 <div class="paragraph">
3711 <p>This listens for telemetry packets on all of the
3712 configured frequencies, displaying information about
3713 each device it receives a packet from. You can select
3714 which of the baud rates and telemetry formats should
3715 be tried; by default, it only listens at 38400 baud
3716 with the standard telemetry format used in v1.0 and
3717 later firmware.</p>
3718 </div>
3719 </div>
3720 <div class="sect2">
3721 <h3 id="_load_maps">12.12. Load Maps</h3>
3722 <div class="imageblock">
3723 <div class="content">
3724 <img src="load-maps.png" alt="load maps" width="500">
3725 </div>
3726 <div class="title">Figure 28. Load Maps Window</div>
3727 </div>
3728 <div class="paragraph">
3729 <p>Before heading out to a new launch site, you can use
3730 this to load satellite images in case you don&#8217;t have
3731 internet connectivity at the site.  Try not to wait
3732 until the last minute, though, particularly if you&#8217;re
3733 heading to a major launch.  If too many people are
3734 all trying to download map data at once, Google may
3735 limit access until the next day.</p>
3736 </div>
3737 <div class="paragraph">
3738 <p>There&#8217;s a drop-down menu of launch sites we know
3739 about; if your favorites aren&#8217;t there, please let us
3740 know the lat/lon and name of the site. The contents of
3741 this list are actually downloaded from our server at
3742 run-time, so as new sites are sent in, they&#8217;ll get
3743 automatically added to this list.  If the launch site
3744 isn&#8217;t in the list, you can manually enter the lat/lon
3745 values</p>
3746 </div>
3747 <div class="paragraph">
3748 <p>There are four different kinds of maps you can view;
3749 you can select which to download by selecting as many
3750 as you like from the available types:</p>
3751 </div>
3752 <div class="dlist">
3753 <dl>
3754 <dt class="hdlist1">Hybrid</dt>
3755 <dd>
3756 <p>A combination of satellite imagery and road data. This
3757 is the default view.</p>
3758 </dd>
3759 <dt class="hdlist1">Satellite</dt>
3760 <dd>
3761 <p>Just the satellite imagery without any annotation.</p>
3762 </dd>
3763 <dt class="hdlist1">Roadmap</dt>
3764 <dd>
3765 <p>Roads, political boundaries and a few geographic
3766 features.</p>
3767 </dd>
3768 <dt class="hdlist1">Terrain</dt>
3769 <dd>
3770 <p>Contour intervals and shading that show hills and
3771 valleys.</p>
3772 </dd>
3773 </dl>
3774 </div>
3775 <div class="paragraph">
3776 <p>You can specify the range of zoom levels to download;
3777 smaller numbers show more area with less
3778 resolution. The default level, 0, shows about
3779 3m/pixel. One zoom level change doubles or halves that
3780 number. Larger zoom levels show more detail, smaller
3781 zoom levels less.</p>
3782 </div>
3783 <div class="paragraph">
3784 <p>The Map Radius value sets how large an area around the
3785 center point to download. Select a value large enough
3786 to cover any plausible flight from that site. Be aware
3787 that loading a large area with a high maximum zoom
3788 level can attempt to download a lot of data. Loading
3789 hybrid maps with a 10km radius at a minimum zoom of -2
3790 and a maximum zoom of 2 consumes about 120MB of
3791 space. Terrain and road maps consume about 1/10 as
3792 much space as satellite or hybrid maps.</p>
3793 </div>
3794 <div class="paragraph">
3795 <p>Clicking the 'Load Map' button will fetch images from
3796 Google Maps; note that Google limits how many images
3797 you can fetch at once, so if you load more than one
3798 launch site, you may get some gray areas in the map
3799 which indicate that Google is tired of sending data to
3800 you. Try again later.</p>
3801 </div>
3802 </div>
3803 <div class="sect2">
3804 <h3 id="_monitor_idle">12.13. Monitor Idle</h3>
3805 <div class="imageblock">
3806 <div class="content">
3807 <img src="monitor-idle.png" alt="monitor idle" width="500">
3808 </div>
3809 <div class="title">Figure 29. Monitor Idle Window</div>
3810 </div>
3811 <div class="paragraph">
3812 <p>This brings up a dialog similar to the Monitor Flight
3813 UI, except it works with the altimeter in “idle” mode
3814 by sending query commands to discover the current
3815 state rather than listening for telemetry
3816 packets. Because this uses command mode, it needs to
3817 have the TeleDongle and flight computer callsigns
3818 match exactly. If you can receive telemetry, but
3819 cannot manage to run Monitor Idle, then it&#8217;s very
3820 likely that your callsigns are different in some way.</p>
3821 </div>
3822 <div class="paragraph">
3823 <p>You can change the frequency and callsign used to
3824 communicate with the flight computer; they must both
3825 match the configuration in the flight computer
3826 exactly.</p>
3827 </div>
3828 </div>
3829 </div>
3830 </div>
3831 <div class="sect1">
3832 <h2 id="_altosdroid">13. AltosDroid</h2>
3833 <div class="sectionbody">
3834 <div class="paragraph">
3835 <p>AltosDroid provides the same flight monitoring capabilities as
3836 AltosUI, but runs on Android devices. AltosDroid is designed
3837 to connect to a TeleBT receiver over Bluetooth™ and (on
3838 Android devices supporting USB On-the-go) TeleDongle and
3839 TeleBT devices over USB. AltosDroid monitors telemetry data,
3840 logging it to internal storage in the Android device, and
3841 presents that data in a UI similar to the 'Monitor Flight'
3842 window in AltosUI.</p>
3843 </div>
3844 <div class="paragraph">
3845 <p>This manual will explain how to configure AltosDroid, connect
3846 to TeleBT or TeleDongle, operate the flight monitoring
3847 interface and describe what the displayed data means.</p>
3848 </div>
3849 <div class="sect2">
3850 <h3 id="_installing_altosdroid">13.1. Installing AltosDroid</h3>
3851 <div class="paragraph">
3852 <p>AltosDroid is available from the Google Play store. To
3853 install it on your Android device, open the Google
3854 Play Store application and search for
3855 “altosdroid”. Make sure you don&#8217;t have a space between
3856 “altos” and “droid” or you probably won&#8217;t find what
3857 you want. That should bring you to the right page from
3858 which you can download and install the application.</p>
3859 </div>
3860 </div>
3861 <div class="sect2">
3862 <h3 id="_charging_telebt_battery">13.2. Charging TeleBT Battery</h3>
3863 <div class="paragraph">
3864 <p>Before using TeleBT with AltosDroid, make sure the
3865 internal TeleBT battery is charged.  To do this,
3866 attach a micro USB cable from a computer or other USB
3867 power source to TeleBT.  A dual LED on the circuit
3868 board should illuminate, showing red while the battery
3869 is charging, green when charging is completed, and
3870 both red and green on at the same time if there is a
3871 battery fault.</p>
3872 </div>
3873 </div>
3874 <div class="sect2">
3875 <h3 id="_connecting_to_telebt_over_bluetooth">13.3. Connecting to TeleBT over Bluetooth™</h3>
3876 <div class="paragraph">
3877 <p>Press the Android 'Menu' button or soft-key to see the
3878 configuration options available. Select the 'Connect a
3879 device' option and then the 'Scan for devices' entry
3880 at the bottom to look for your TeleBT device. Select
3881 your device, and when it asks for the code, enter
3882 '1234'.</p>
3883 </div>
3884 <div class="paragraph">
3885 <p>Subsequent connections will not require you to enter
3886 that code, and your 'paired' device will appear in the
3887 list without scanning.</p>
3888 </div>
3889 </div>
3890 <div class="sect2">
3891 <h3 id="_connecting_to_teledongle_or_telebt_over_usb">13.4. Connecting to TeleDongle or TeleBT over USB</h3>
3892 <div class="paragraph">
3893 <p>Get a special USB On-the-go adapter cable. These
3894 cables have a USB micro-B male connector on one end
3895 and a standard A female connector on the other
3896 end. Plug in your TeleDongle or TeleBT device to the
3897 adapter cable and the adapter cable into your phone
3898 and AltosDroid should automatically start up. If it
3899 doesn&#8217;t, the most likely reason is that your Android
3900 device doesn&#8217;t support USB On-the-go.</p>
3901 </div>
3902 </div>
3903 <div class="sect2">
3904 <h3 id="_altosdroid_menu">13.5. AltosDroid Menu</h3>
3905 <div class="paragraph">
3906 <p>The main AltosDroid menu has a selection of operation
3907 and configuration options.</p>
3908 </div>
3909 <div class="dlist">
3910 <dl>
3911 <dt class="hdlist1">Connect a device</dt>
3912 <dd>
3913 <p>Offers a menu of available TeleBT devices, and an
3914 option to scan for additional devices.</p>
3915 </dd>
3916 <dt class="hdlist1">Disconnect device</dt>
3917 <dd>
3918 <p>Disconnects the current TeleBT or TeleDongle
3919 device. You can reconnect TeleBT over bluetooth by
3920 using Connect a Device. You can reconnect a USB device
3921 by unplugging it and then plugging it back in.</p>
3922 </dd>
3923 <dt class="hdlist1">Select radio frequency</dt>
3924 <dd>
3925 <p>This selects which frequency to listen on by bringing
3926 up a menu of pre-set radio frequencies. Pick the one
3927 which matches your altimeter.</p>
3928 </dd>
3929 <dt class="hdlist1">Select Tracker</dt>
3930 <dd>
3931 <p>Switches the information displays to show data for a
3932 different transmitting device. The map will always
3933 show all of the devices in view. Trackers are shown
3934 and selected by serial number, so make sure you note
3935 the serial number of devices in each airframe.</p>
3936 </dd>
3937 <dt class="hdlist1">Delete Track</dt>
3938 <dd>
3939 <p>Deletes all information about a transmitting device.</p>
3940 </dd>
3941 <dt class="hdlist1">Setup</dt>
3942 <dd>
3943 <p>Offers additional configuration operations. See
3944 <a href="#_setup">Setup</a>.</p>
3945 </dd>
3946 <dt class="hdlist1">Idle Mode</dt>
3947 <dd>
3948 <p>Communicate with an altimeter in Idle mode. See <a href="#_idle_mode">Idle Mode</a></p>
3949 </dd>
3950 <dt class="hdlist1">Quit</dt>
3951 <dd>
3952 <p>Shuts down AltosDroid.</p>
3953 </dd>
3954 </dl>
3955 </div>
3956 </div>
3957 <div class="sect2">
3958 <h3 id="_setup">13.6. Setup</h3>
3959 <div class="dlist">
3960 <dl>
3961 <dt class="hdlist1">Telemetry Rate</dt>
3962 <dd>
3963 <p>Altus Metrum transmitters can be configured to operate
3964 at lower data rates to improve transmission range. If
3965 you have configured your device to do this, this menu
3966 item allows you to change the receiver to match.</p>
3967 </dd>
3968 <dt class="hdlist1">Units</dt>
3969 <dd>
3970 <p>Selects which units used to report values.</p>
3971 </dd>
3972 <dt class="hdlist1">Map Type</dt>
3973 <dd>
3974 <p>Displays a menu of map types and lets you select
3975 one. Hybrid maps include satellite images with a
3976 roadmap overlaid. Satellite maps dispense with the
3977 roadmap overlay. Roadmap shows just the roads. Terrain
3978 includes roads along with shadows indicating changes
3979 in elevation, and other geographical features.</p>
3980 </dd>
3981 <dt class="hdlist1">Map Source</dt>
3982 <dd>
3983 <p>Select between online and offline maps. Online maps
3984 will show a 'move to current position' icon in the
3985 upper right corner, while offline maps will have
3986 copyright information all over the map. Otherwise,
3987 they&#8217;re pretty similar.</p>
3988 </dd>
3989 <dt class="hdlist1">Preload Maps</dt>
3990 <dd>
3991 <p>Brings up a dialog allowing you to download offline
3992 map tiles so that you can have maps available even if
3993 you have no network connectivity at the launch site.</p>
3994 </dd>
3995 <dt class="hdlist1">Manage Frequencies</dt>
3996 <dd>
3997 <p>This presents a dialog containing the current list of
3998 frequencies that will be show in the 'Select radio
3999 frequency' menu. You can change the label for existing
4000 frequencies, delete or add new frequencies.</p>
4001 </dd>
4002 </dl>
4003 </div>
4004 </div>
4005 <div class="sect2">
4006 <h3 id="_idle_mode">13.7. Idle Mode</h3>
4007 <div class="dlist">
4008 <dl>
4009 <dt class="hdlist1">Callsign</dt>
4010 <dd>
4011 <p>Lets you configure the callsign used by AltosDroid to
4012 communicate with the flight computer. The callsign on
4013 the two devices must match or the communication will
4014 fail. This provides a modest amount of protection
4015 against accidentally controlling another persons
4016 flight computer.</p>
4017 </dd>
4018 <dt class="hdlist1">Monitor</dt>
4019 <dd>
4020 <p>This provides similar information to monitoring the
4021 telemetry stream from a flight computer in flight
4022 mode. The title of the application will change to
4023 include (idle) so you can tell this mode is active.</p>
4024 </dd>
4025 <dt class="hdlist1">Reboot</dt>
4026 <dd>
4027 <p>Remotely reboots the flight computer. This is useful
4028 when the flight computers turned on while the airframe
4029 is horizontal and you want to restart the flight
4030 computers in pad mode after raising the airframe to
4031 vertical.</p>
4032 </dd>
4033 <dt class="hdlist1">Fire Igniters</dt>
4034 <dd>
4035 <p>Remotely control igniters for ground testing recovery
4036 systems.</p>
4037 </dd>
4038 </dl>
4039 </div>
4040 </div>
4041 <div class="sect2">
4042 <h3 id="_altosdroid_flight_monitoring">13.8. AltosDroid Flight Monitoring</h3>
4043 <div class="paragraph">
4044 <p>AltosDroid is designed to mimic the AltosUI flight
4045 monitoring display, providing separate tabs for each
4046 stage of your rocket flight along with a tab
4047 containing a map of the local area with icons marking
4048 the current location of the altimeter and the Android
4049 device.</p>
4050 </div>
4051 </div>
4052 <div class="sect2">
4053 <h3 id="_pad">13.9. Pad</h3>
4054 <div class="paragraph">
4055 <p>The 'Pad' tab shows information used to decide when
4056 the rocket is ready for flight. The first elements
4057 include red/green indicators, if any of these is red,
4058 you&#8217;ll want to evaluate whether the rocket is ready to
4059 launch.</p>
4060 </div>
4061 <div class="paragraph">
4062 <p>When the pad tab is selected, the voice responses will
4063 include status changes to the igniters and GPS
4064 reception, letting you know if the rocket is still
4065 ready for launch.</p>
4066 </div>
4067 <div class="dlist">
4068 <dl>
4069 <dt class="hdlist1">Battery</dt>
4070 <dd>
4071 <p>This indicates whether the Li-Po battery powering the
4072 transmitter has sufficient charge to last for the
4073 duration of the flight. A value of more than 3.8V is
4074 required for a 'GO' status.</p>
4075 </dd>
4076 <dt class="hdlist1">Receiver Battery</dt>
4077 <dd>
4078 <p>This indicates whether the Li-Po battery powering the
4079 TeleBT has sufficient charge to last for the duration
4080 of the flight. A value of more than 3.8V is required
4081 for a 'GO' status.</p>
4082 </dd>
4083 <dt class="hdlist1">Data Logging</dt>
4084 <dd>
4085 <p>This indicates whether there is space remaining
4086 on-board to store flight data for the upcoming
4087 flight. If you&#8217;ve downloaded data, but failed to erase
4088 flights, there may not be any space left. TeleMetrum
4089 and TeleMega can store multiple flights, depending on
4090 the configured maximum flight log size. TeleGPS logs
4091 data continuously. TeleMini v1.0 stores only a single
4092 flight, so it will need to be downloaded and erased
4093 after each flight to capture data. This only affects
4094 on-board flight logging; the altimeter will still
4095 transmit telemetry and fire ejection charges at the
4096 proper times.</p>
4097 </dd>
4098 <dt class="hdlist1">GPS Locked</dt>
4099 <dd>
4100 <p>For a TeleMetrum or TeleMega device, this indicates
4101 whether the GPS receiver is currently able to compute
4102 position information. GPS requires at least 4
4103 satellites to compute an accurate position.</p>
4104 </dd>
4105 <dt class="hdlist1">GPS Ready</dt>
4106 <dd>
4107 <p>For a TeleMetrum or TeleMega device, this indicates
4108 whether GPS has reported at least 10 consecutive
4109 positions without losing lock. This ensures that the
4110 GPS receiver has reliable reception from the
4111 satellites.</p>
4112 </dd>
4113 <dt class="hdlist1">Apogee Igniter</dt>
4114 <dd>
4115 <p>This indicates whether the apogee igniter has
4116 continuity. If the igniter has a low resistance, then
4117 the voltage measured here will be close to the Li-Po
4118 battery voltage. A value greater than 3.2V is required
4119 for a 'GO' status.</p>
4120 </dd>
4121 <dt class="hdlist1">Main Igniter</dt>
4122 <dd>
4123 <p>This indicates whether the main igniter has
4124 continuity. If the igniter has a low resistance, then
4125 the voltage measured here will be close to the Li-Po
4126 battery voltage. A value greater than 3.2V is required
4127 for a 'GO' status.</p>
4128 </dd>
4129 <dt class="hdlist1">Igniter A-D</dt>
4130 <dd>
4131 <p>This indicates whether the indicated additional pyro
4132 channel igniter has continuity. If the igniter has a
4133 low resistance, then the voltage measured here will be
4134 close to the Li-Po battery voltage. A value greater
4135 than 3.2V is required for a 'GO' status.</p>
4136 </dd>
4137 </dl>
4138 </div>
4139 <div class="paragraph">
4140 <p>The Pad tab also shows the location of the Android
4141 device.</p>
4142 </div>
4143 </div>
4144 <div class="sect2">
4145 <h3 id="_flight">13.10. Flight</h3>
4146 <div class="paragraph">
4147 <p>The 'Flight' tab shows information used to evaluate
4148 and spot a rocket while in flight. It displays speed
4149 and height data to monitor the health of the rocket,
4150 along with elevation, range and bearing to help locate
4151 the rocket in the sky.</p>
4152 </div>
4153 <div class="paragraph">
4154 <p>While the Flight tab is displayed, the voice
4155 announcements will include current speed, height,
4156 elevation and bearing information.</p>
4157 </div>
4158 <div class="dlist">
4159 <dl>
4160 <dt class="hdlist1">Speed</dt>
4161 <dd>
4162 <p>Shows current vertical speed. During descent, the
4163 speed values are averaged over a fairly long time to
4164 try and make them steadier.</p>
4165 </dd>
4166 <dt class="hdlist1">Height</dt>
4167 <dd>
4168 <p>Shows the current height above the launch pad.</p>
4169 </dd>
4170 <dt class="hdlist1">Max Speed</dt>
4171 <dd>
4172 <p>Shows the maximum vertical speed seen during the
4173 flight.</p>
4174 </dd>
4175 <dt class="hdlist1">Max Height</dt>
4176 <dd>
4177 <p>Shows the maximum height above launch pad.</p>
4178 </dd>
4179 <dt class="hdlist1">Elevation</dt>
4180 <dd>
4181 <p>This is the angle above the horizon from the android
4182 devices current position.</p>
4183 </dd>
4184 <dt class="hdlist1">Range</dt>
4185 <dd>
4186 <p>The total distance from the android device to the
4187 rocket, including both ground distance and difference
4188 in altitude. Use this to gauge how large the rocket is
4189 likely to appear in the sky.</p>
4190 </dd>
4191 <dt class="hdlist1">Bearing</dt>
4192 <dd>
4193 <p>This is the azimuth from true north for the rocket
4194 from the android device. Use this in combination with
4195 the Elevation value to help locate the rocket in the
4196 sky, or at least to help point the antenna in the
4197 general direction. This is provided in both degrees
4198 and a compass point (like West South West). You&#8217;ll
4199 want to know which direction is true north before
4200 launching your rocket.</p>
4201 </dd>
4202 <dt class="hdlist1">Ground Distance</dt>
4203 <dd>
4204 <p>This shows the distance across the ground to the
4205 lat/lon where the rocket is located. Use this to
4206 estimate what is currently under the rocket.</p>
4207 </dd>
4208 <dt class="hdlist1">Latitude/Longitude</dt>
4209 <dd>
4210 <p>Displays the last known location of the rocket.</p>
4211 </dd>
4212 <dt class="hdlist1">Apogee Igniter</dt>
4213 <dd>
4214 <p>This indicates whether the apogee igniter has
4215 continuity. If the igniter has a low resistance, then
4216 the voltage measured here will be close to the Li-Po
4217 battery voltage. A value greater than 3.2V is required
4218 for a 'GO' status.</p>
4219 </dd>
4220 <dt class="hdlist1">Main Igniter</dt>
4221 <dd>
4222 <p>This indicates whether the main igniter has
4223 continuity. If the igniter has a low resistance, then
4224 the voltage measured here will be close to the Li-Po
4225 battery voltage. A value greater than 3.2V is required
4226 for a 'GO' status.</p>
4227 </dd>
4228 </dl>
4229 </div>
4230 </div>
4231 <div class="sect2">
4232 <h3 id="_recover">13.11. Recover</h3>
4233 <div class="paragraph">
4234 <p>The 'Recover' tab shows information used while
4235 recovering the rocket on the ground after flight.</p>
4236 </div>
4237 <div class="paragraph">
4238 <p>While the Recover tab is displayed, the voice
4239 announcements will include distance along with either
4240 bearing or direction, depending on whether you are
4241 moving.</p>
4242 </div>
4243 <div class="dlist">
4244 <dl>
4245 <dt class="hdlist1">Bearing</dt>
4246 <dd>
4247 <p>This is the azimuth from true north for the rocket
4248 from the android device. Use this in combination with
4249 the Elevation value to help locate the rocket in the
4250 sky, or at least to help point the antenna in the
4251 general direction. This is provided in both degrees
4252 and a compass point (like West South West). You&#8217;ll
4253 want to know which direction is true north before
4254 launching your rocket.</p>
4255 </dd>
4256 <dt class="hdlist1">Direction</dt>
4257 <dd>
4258 <p>When you are in motion, this provides the angle from
4259 your current direction of motion towards the rocket.</p>
4260 </dd>
4261 <dt class="hdlist1">Distance</dt>
4262 <dd>
4263 <p>Distance over the ground to the rocket.</p>
4264 </dd>
4265 <dt class="hdlist1">Tar Lat/Tar Lon</dt>
4266 <dd>
4267 <p>Displays the last known location of the rocket.</p>
4268 </dd>
4269 <dt class="hdlist1">My Lat/My Lon</dt>
4270 <dd>
4271 <p>Displays the location of the Android device.</p>
4272 </dd>
4273 <dt class="hdlist1">Max Height</dt>
4274 <dd>
4275 <p>Shows the maximum height above launch pad seen during
4276 the flight.</p>
4277 </dd>
4278 <dt class="hdlist1">Max Speed</dt>
4279 <dd>
4280 <p>Shows the maximum vertical speed seen during the
4281 flight.</p>
4282 </dd>
4283 <dt class="hdlist1">Max Accel</dt>
4284 <dd>
4285 <p>Shows the maximum vertical acceleration seen during
4286 the flight.</p>
4287 </dd>
4288 </dl>
4289 </div>
4290 </div>
4291 <div class="sect2">
4292 <h3 id="_map_2">13.12. Map</h3>
4293 <div class="paragraph">
4294 <p>The 'Map' tab shows a map of the area around the
4295 rocket being tracked along with information needed to
4296 recover it.</p>
4297 </div>
4298 <div class="paragraph">
4299 <p>On the map itself, icons showing the location of the
4300 android device along with the last known location of
4301 each tracker. A blue line is drawn from the android
4302 device location to the currently selected tracker.</p>
4303 </div>
4304 <div class="paragraph">
4305 <p>Below the map, the distance and either bearing or
4306 direction along with the lat/lon of the target and the
4307 android device are shown</p>
4308 </div>
4309 <div class="paragraph">
4310 <p>The Map tab provides the same voice announcements as
4311 the Recover tab.</p>
4312 </div>
4313 </div>
4314 <div class="sect2">
4315 <h3 id="_downloading_flight_logs">13.13. Downloading Flight Logs</h3>
4316 <div class="paragraph">
4317 <p>AltosDroid always saves every bit of telemetry data it
4318 receives. To download that to a computer for use with
4319 AltosUI, remove the SD card from your Android device,
4320 or connect your device to your computer&#8217;s USB port and
4321 browse the files on that device. You will find
4322 '.telem' files in the TeleMetrum directory that will
4323 work with AltosUI directly.</p>
4324 </div>
4325 </div>
4326 </div>
4327 </div>
4328 <div class="sect1">
4329 <h2 id="_system_operation">Appendix A: System Operation</h2>
4330 <div class="sectionbody">
4331 <div class="sect2">
4332 <h3 id="_firmware_modes">A.1. Firmware Modes</h3>
4333 <div class="paragraph">
4334 <p>The AltOS firmware build for the altimeters has two
4335 fundamental modes, “idle” and “flight”.  Which of these modes
4336 the firmware operates in is determined at start up
4337 time.
4338 For
4339 TeleMetrum, TeleMega, EasyMega and EasyTimer, which have accelerometers, the mode is
4340 controlled by the orientation of the
4341 rocket (well, actually the board, of course&#8230;&#8203;) at the time
4342 power is switched on.  If the rocket is “nose up”, then
4343 the flight computer assumes it&#8217;s on a rail or rod being prepared for
4344 launch, so the firmware chooses flight mode.  However, if the
4345 rocket is more or less horizontal, the firmware instead enters
4346 idle mode.
4347 Since
4348 EasyMini doesn&#8217;t
4349 have an
4350 accelerometer we can use to determine orientation, “idle” mode
4351 is selected if the board is connected via USB to a computer,
4352 otherwise the board enters “flight” mode.
4353 TeleMini
4354 selects “idle” mode if it receives a command packet
4355 within the
4356 first five seconds of operation.</p>
4357 </div>
4358 <div class="paragraph">
4359 <p>At power on, the altimeter will beep out the battery voltage
4360 to the nearest tenth of a volt.  Each digit is represented by
4361 a sequence of short “dit” beeps, with a pause between
4362 digits. A zero digit is represented with one long “dah”
4363 beep. Then there will be a short pause while the altimeter
4364 completes initialization and self test, and decides which mode
4365 to enter next.</p>
4366 </div>
4367 <div class="paragraph">
4368 <p>In flight or “pad” mode, the altimeter engages the flight
4369 state machine, goes into transmit-only mode to send telemetry,
4370 and waits for launch to be detected.  Flight mode is indicated
4371 by an “di-dah-dah-dit” (“P” for pad) on the beeper or lights,
4372 followed by beeps or flashes indicating the state of the
4373 pyrotechnic igniter continuity.  One beep/flash indicates
4374 apogee continuity, two beeps/flashes indicate main continuity,
4375 three beeps/flashes indicate both apogee and main continuity,
4376 and one longer “brap” sound which is made by rapidly
4377 alternating between two tones indicates no continuity.  For a
4378 dual deploy flight, make sure you&#8217;re getting three beeps or
4379 flashes before launching!  For apogee-only or motor eject
4380 flights, do what makes sense.</p>
4381 </div>
4382 <div class="paragraph">
4383 <p>If idle mode is entered, you will hear an audible “di-dit” or
4384 see two short flashes (“I” for idle), and the flight state
4385 machine is disengaged, thus no ejection charges will fire.
4386 The altimeters also listen for the radio link when in idle
4387 mode for requests sent via TeleDongle.  Commands can be issued
4388 in idle mode over either USB or the radio link
4389 equivalently.
4390 TeleMini only has the radio link.
4391 Idle mode is useful for configuring the altimeter, for
4392 extracting data from the on-board storage chip after
4393 flight, and for ground testing pyro charges.</p>
4394 </div>
4395 <div class="paragraph">
4396 <p>In “Idle” and “Pad” modes, once the mode indication
4397 beeps/flashes and continuity indication has been sent, if
4398 there is no space available to log the flight in on-board
4399 memory, the flight computer will emit a warbling tone (much
4400 slower than the “no continuity tone”)</p>
4401 </div>
4402 <div class="paragraph">
4403 <p>See <a href="#_understanding_beeps">Understanding Beeps</a> for a summary of all of
4404 the audio signals used.</p>
4405 </div>
4406 <div class="paragraph">
4407 <p>Once landed, the flight computer will signal that by emitting
4408 the “Landed” sound described above, after which it will beep
4409 out the apogee height (in meters). Each digit is represented
4410 by a sequence of short “dit” beeps, with a pause between
4411 digits. A zero digit is represented with one long “dah”
4412 beep. The flight computer will continue to report landed mode
4413 and beep out the maximum height until turned off.</p>
4414 </div>
4415 <div class="paragraph">
4416 <p>One “neat trick” of particular value when TeleMetrum, TeleMega
4417 or EasyMega are used with
4418 very large air-frames, is that you can power the board up while the
4419 rocket is horizontal, such that it comes up in idle mode.  Then you can
4420 raise the air-frame to launch position, and issue a 'reset' command
4421 via TeleDongle over the radio link to cause the altimeter to reboot and
4422 come up in flight mode.  This is much safer than standing on the top
4423 step of a rickety step-ladder or hanging off the side of a launch
4424 tower with a screw-driver trying to turn on your avionics before
4425 installing igniters!</p>
4426 </div>
4427 <div class="paragraph">
4428 <p>TeleMini is configured solely via the radio link. Of course, that
4429 means you need to know the TeleMini radio configuration values
4430 or you won&#8217;t be able to communicate with it. For situations
4431 when you don&#8217;t have the radio configuration values,
4432 TeleMini v1.0
4433 offers an 'emergency recovery' mode. In this mode,
4434 TeleMini v1.0 is
4435 configured as follows:</p>
4436 </div>
4437 <div class="ulist">
4438 <ul>
4439 <li>
4440 <p>Sets the radio frequency to 434.550MHz</p>
4441 </li>
4442 <li>
4443 <p>Sets the radio calibration back to the factory value.</p>
4444 </li>
4445 <li>
4446 <p>Sets the callsign to N0CALL</p>
4447 </li>
4448 <li>
4449 <p>Does not go to 'pad' mode after five seconds.</p>
4450 </li>
4451 </ul>
4452 </div>
4453 <div class="paragraph">
4454 <p>To get into 'emergency recovery' mode, first find the row of
4455 four small holes opposite the switch wiring. Using a short
4456 piece of small gauge wire, connect the outer two holes
4457 together, then power TeleMini up. Once the red LED is lit,
4458 disconnect the wire and the board should signal that it&#8217;s in
4459 'idle' mode after the initial five second startup
4460 period.</p>
4461 </div>
4462 </div>
4463 <div class="sect2">
4464 <h3 id="_gps">A.2. GPS</h3>
4465 <div class="paragraph">
4466 <p>TeleMetrum and TeleMega include a complete GPS receiver.  A
4467 complete explanation of how GPS works is beyond the scope of
4468 this manual, but the bottom line is that the GPS receiver
4469 needs to lock onto at least four satellites to obtain a solid
4470 3 dimensional position fix and know what time it is.</p>
4471 </div>
4472 <div class="paragraph">
4473 <p>The flight computers provide backup power to the GPS chip any time a
4474 battery is connected.  This allows the receiver to “warm start” on
4475 the launch rail much faster than if every power-on were a GPS
4476 “cold start”.  In typical operations, powering up
4477 on the flight line in idle mode while performing final air-frame
4478 preparation will be sufficient to allow the GPS receiver to cold
4479 start and acquire lock.  Then the board can be powered down during
4480 RSO review and installation on a launch rod or rail.  When the board
4481 is turned back on, the GPS system should lock very quickly, typically
4482 long before igniter installation and return to the flight line are
4483 complete.</p>
4484 </div>
4485 </div>
4486 <div class="sect2">
4487 <h3 id="_controlling_an_altimeter_over_the_radio_link">A.3. Controlling An Altimeter Over The Radio Link</h3>
4488 <div class="paragraph">
4489 <p>One of the unique features of the Altus Metrum system is the
4490 ability to create a two way command link between TeleDongle
4491 and an altimeter using the digital radio transceivers
4492 built into each device. This allows you to interact with the
4493 altimeter from afar, as if it were directly connected to the
4494 computer.</p>
4495 </div>
4496 <div class="paragraph">
4497 <p>Any operation which can be performed with a flight computer can
4498 either be done with the device directly connected to the
4499 computer via the USB cable, or through the radio
4500 link. TeleMini doesn&#8217;t provide a USB connector and so it is
4501 always communicated with over radio.  Select the appropriate
4502 TeleDongle device when the list of devices is presented and
4503 AltosUI will interact with an altimeter over the radio link.</p>
4504 </div>
4505 <div class="paragraph">
4506 <p>One oddity in the current interface is how AltosUI selects the
4507 frequency for radio communications. Instead of providing
4508 an interface to specifically configure the frequency, it uses
4509 whatever frequency was most recently selected for the target
4510 TeleDongle device in Monitor Flight mode. If you haven&#8217;t ever
4511 used that mode with the TeleDongle in question, select the
4512 Monitor Flight button from the top level UI, and pick the
4513 appropriate TeleDongle device.  Once the flight monitoring
4514 window is open, select the desired frequency and then close it
4515 down again. All radio communications will now use that frequency.</p>
4516 </div>
4517 <div class="ulist">
4518 <ul>
4519 <li>
4520 <p>Save Flight Data—Recover flight data from the
4521 rocket without opening it up.</p>
4522 </li>
4523 <li>
4524 <p>Configure altimeter apogee delays, main deploy
4525 heights and additional pyro event conditions to
4526 respond to changing launch conditions. You can also
4527 'reboot' the altimeter. Use this to remotely enable
4528 the flight computer by turning TeleMetrum or
4529 TeleMega on in “idle” mode, then once the air-frame
4530 is oriented for launch, you can reboot the
4531 altimeter and have it restart in pad mode without
4532 having to climb the scary ladder.</p>
4533 </li>
4534 <li>
4535 <p>Fire Igniters—Test your deployment charges without snaking
4536 wires out through holes in the air-frame. Simply assemble the
4537 rocket as if for flight with the apogee and main charges
4538 loaded, then remotely command the altimeter to fire the
4539 igniters.</p>
4540 </li>
4541 </ul>
4542 </div>
4543 <div class="paragraph">
4544 <p>Operation over the radio link for configuring an
4545 altimeter, ground testing igniters, and so forth uses
4546 the same RF frequencies as flight telemetry.  To
4547 configure the desired TeleDongle frequency, select the
4548 monitor flight tab, then use the frequency selector
4549 and close the window before performing other desired
4550 radio operations.</p>
4551 </div>
4552 <div class="paragraph">
4553 <p>The flight computers only enable radio commanding in
4554 'idle' mode.  TeleMetrum and TeleMega use the
4555 accelerometer to detect which orientation they start
4556 up in, so make sure you have the flight computer lying
4557 horizontally when you turn it on. Otherwise, it will
4558 start in 'pad' mode ready for flight, and will not be
4559 listening for command packets from TeleDongle.</p>
4560 </div>
4561 <div class="paragraph">
4562 <p>TeleMini listens for a command packet for five seconds
4563 after first being turned on, if it doesn&#8217;t hear
4564 anything, it enters 'pad' mode, ready for flight and
4565 will no longer listen for command packets. The easiest
4566 way to connect to TeleMini is to initiate the command
4567 and select the TeleDongle device. At this point, the
4568 TeleDongle will be attempting to communicate with the
4569 TeleMini. Now turn TeleMini on, and it should
4570 immediately start communicating with the TeleDongle
4571 and the desired operation can be performed.</p>
4572 </div>
4573 <div class="paragraph">
4574 <p>You can monitor the operation of the radio link by watching the
4575 lights on the devices. The red LED will flash each time a packet
4576 is transmitted, while the green LED will light up on TeleDongle when
4577 it is waiting to receive a packet from the altimeter.</p>
4578 </div>
4579 </div>
4580 <div class="sect2">
4581 <h3 id="_ground_testing">A.4. Ground Testing</h3>
4582 <div class="paragraph">
4583 <p>An important aspect of preparing a rocket using electronic deployment
4584 for flight is ground testing the recovery system.
4585 Thanks
4586 to the bi-directional radio link central to the Altus Metrum system,
4587 this can be accomplished in a TeleMega, TeleMetrum or TeleMini equipped rocket
4588 with less work than you may be accustomed to with other systems.  It
4589 can even be fun!</p>
4590 </div>
4591 <div class="paragraph">
4592 <p>Just prep the rocket for flight, then power up the altimeter
4593 in “idle”
4594 mode (placing air-frame horizontal for TeleMetrum or TeleMega, or
4595 selecting the Configure Altimeter tab for TeleMini).
4596 This will cause
4597 the firmware to go into “idle” mode, in which the normal flight
4598 state machine is disabled and charges will not fire without
4599 manual command.
4600 You can now command the altimeter to fire the apogee
4601 or main charges from a safe distance using your
4602 computer and the Fire Igniter tab to complete ejection testing.</p>
4603 </div>
4604 </div>
4605 <div class="sect2">
4606 <h3 id="_radio_link">A.5. Radio Link</h3>
4607 <div class="paragraph">
4608 <p>TeleMetrum, TeleMini and TeleMega all incorporate an
4609 RF transceiver, but it&#8217;s not a full duplex system;
4610 each end can only be transmitting or receiving at any
4611 given moment. So we had to decide how to manage the
4612 link.</p>
4613 </div>
4614 <div class="paragraph">
4615 <p>By design, the altimeter firmware listens for the
4616 radio link when it&#8217;s in “idle mode”, which allows us
4617 to use the radio link to configure the rocket, do
4618 things like ejection tests, and extract data after a
4619 flight without having to crack open the air-frame.
4620 However, when the board is in “flight mode”, the
4621 altimeter only transmits and doesn&#8217;t listen at all.
4622 That&#8217;s because we want to put ultimate priority on
4623 event detection and getting telemetry out of the
4624 rocket through the radio in case the rocket crashes
4625 and we aren&#8217;t able to extract data later.</p>
4626 </div>
4627 <div class="paragraph">
4628 <p>We don&#8217;t generally use a 'normal packet radio' mode
4629 like APRS because they&#8217;re just too inefficient.  The
4630 GFSK modulation we use is FSK with the base-band
4631 pulses passed through a Gaussian filter before they go
4632 into the modulator to limit the transmitted bandwidth.
4633 When combined with forward error correction and
4634 interleaving, this allows us to have a very robust
4635 19.2 kilobit data link with only 10-40 milliwatts of
4636 transmit power, a whip antenna in the rocket, and a
4637 hand-held Yagi on the ground.  We&#8217;ve had flights to
4638 above 21k feet AGL with great reception, and
4639 calculations suggest we should be good to well over
4640 40k feet AGL with a 5-element yagi on the ground with
4641 our 10mW units and over 100k feet AGL with the 40mW
4642 devices.  We hope to fly boards to higher altitudes
4643 over time, and would of course appreciate customer
4644 feedback on performance in higher altitude flights!</p>
4645 </div>
4646 </div>
4647 <div class="sect2">
4648 <h3 id="_aprs">A.6. APRS</h3>
4649 <div class="paragraph">
4650 <p>TeleMetrum v2 and newer and TeleMega can send APRS if desired, and the
4651 interval between APRS packets can be configured. As
4652 each APRS packet takes a full second to transmit, we
4653 recommend an interval of at least 5 seconds to avoid
4654 consuming too much battery power or radio channel
4655 bandwidth. You can configure the time within each
4656 minute that APRS transmits by changing the APRS offset
4657 value. When the GPS signal is locked and knows the
4658 current time, the APRS offset selects the time with
4659 each minute for the first APRS transmission;
4660 subsequent transmissions occur each APRS interval
4661 seconds thereafter.  You can configure the APRS
4662 interval and APRS offset using AltosUI; that
4663 process is described in <a href="#_configure_altimeter">Configure Altimeter</a>.</p>
4664 </div>
4665 <div class="paragraph">
4666 <p>AltOS supports both compressed and uncompressed APRS
4667 position report data formats. The compressed format
4668 provides for higher position precision and shorter
4669 packets than the uncompressed APRS format. We&#8217;ve found
4670 some older APRS receivers that do not handle the
4671 compressed format. The Kenwood TH-72A requires the use
4672 of uncompressed format to display altitude information
4673 correctly. The Yaesu FT1D requires the use of
4674 compressed format to display altitude information.</p>
4675 </div>
4676 <div class="paragraph">
4677 <p>APRS packets include an SSID (Secondary Station Identifier)
4678 field that allows one operator to have multiple
4679 transmitters. AltOS allows you to set this to a single digit
4680 from 0 to 9, allowing you to fly multiple transmitters at the
4681 same time while keeping the identify of each one separate in
4682 the receiver. By default, the SSID is set to the last digit of
4683 the device serial number.</p>
4684 </div>
4685 <div class="paragraph">
4686 <p>The APRS packet format includes a comment field that
4687 can have arbitrary text in it. AltOS uses this to send
4688 status information as shown in the following table.</p>
4689 </div>
4690 <table class="tableblock frame-all grid-all stretch">
4691 <caption class="title">Table 10. Altus Metrum APRS Comments</caption>
4692 <colgroup>
4693 <col style="width: 20%;">
4694 <col style="width: 20%;">
4695 <col style="width: 60%;">
4696 </colgroup>
4697 <thead>
4698 <tr>
4699 <th class="tableblock halign-left valign-top">Field</th>
4700 <th class="tableblock halign-left valign-top">Example</th>
4701 <th class="tableblock halign-left valign-top">Description</th>
4702 </tr>
4703 </thead>
4704 <tbody>
4705 <tr>
4706 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
4707 <td class="tableblock halign-left valign-top"><p class="tableblock">L</p></td>
4708 <td class="tableblock halign-left valign-top"><p class="tableblock">GPS Status U for unlocked, L for locked</p></td>
4709 </tr>
4710 <tr>
4711 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
4712 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
4713 <td class="tableblock halign-left valign-top"><p class="tableblock">Number of Satellites in View</p></td>
4714 </tr>
4715 <tr>
4716 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
4717 <td class="tableblock halign-left valign-top"><p class="tableblock">B4.0</p></td>
4718 <td class="tableblock halign-left valign-top"><p class="tableblock">Altimeter Battery Voltage</p></td>
4719 </tr>
4720 <tr>
4721 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
4722 <td class="tableblock halign-left valign-top"><p class="tableblock">A3.7</p></td>
4723 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee Igniter Voltage</p></td>
4724 </tr>
4725 <tr>
4726 <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
4727 <td class="tableblock halign-left valign-top"><p class="tableblock">M3.7</p></td>
4728 <td class="tableblock halign-left valign-top"><p class="tableblock">Main Igniter Voltage</p></td>
4729 </tr>
4730 <tr>
4731 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
4732 <td class="tableblock halign-left valign-top"><p class="tableblock">1286</p></td>
4733 <td class="tableblock halign-left valign-top"><p class="tableblock">Device Serial Number</p></td>
4734 </tr>
4735 <tr>
4736 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
4737 <td class="tableblock halign-left valign-top"><p class="tableblock">1286</p></td>
4738 <td class="tableblock halign-left valign-top"><p class="tableblock">Device Serial Number</p></td>
4739 </tr>
4740 </tbody>
4741 </table>
4742 <div class="paragraph">
4743 <p>Here&#8217;s an example of an APRS comment showing GPS lock with 6
4744 satellites in view, a primary battery at 4.0V, and
4745 apogee and main igniters both at 3.7V from device 1286.</p>
4746 </div>
4747 <div class="literalblock">
4748 <div class="content">
4749 <pre>L6 B4.0 A3.7 M3.7 1286</pre>
4750 </div>
4751 </div>
4752 <div class="paragraph">
4753 <p>Here&#8217;s an example of an APRS comment showing GPS lock with 6
4754 satellites in view and a primary battery at 4.0V from device 1876.</p>
4755 </div>
4756 <div class="literalblock">
4757 <div class="content">
4758 <pre>L6 B4.0 1876</pre>
4759 </div>
4760 </div>
4761 <div class="paragraph">
4762 <p>Make sure your primary battery is above 3.8V
4763 any connected igniters are above 3.5V
4764 and GPS is locked with at least 5 or 6 satellites in
4765 view before flying. If GPS is switching between L and
4766 U regularly, then it doesn&#8217;t have a good lock and you
4767 should wait until it becomes stable.</p>
4768 </div>
4769 <div class="paragraph">
4770 <p>If the GPS receiver loses lock, the APRS data
4771 transmitted will contain the last position for which
4772 GPS lock was available. You can tell that this has
4773 happened by noticing that the GPS status character
4774 switches from 'L' to 'U'. Before GPS has locked, APRS
4775 will transmit zero for latitude, longitude and
4776 altitude.</p>
4777 </div>
4778 </div>
4779 <div class="sect2">
4780 <h3 id="_configurable_parameters">A.7. Configurable Parameters</h3>
4781 <div class="paragraph">
4782 <p>Configuring an Altus Metrum altimeter for flight is
4783 very simple.  Even on our baro-only TeleMini and
4784 EasyMini boards, the use of a Kalman filter means
4785 there is no need to set a “mach delay”.  All of the
4786 configurable parameters can be set using AltosUI. Read
4787 <a href="#_configure_altimeter">Configure Altimeter</a> for more information.</p>
4788 </div>
4789 </div>
4790 </div>
4791 </div>
4792 <div class="sect1">
4793 <h2 id="_handling_precautions">Appendix B: Handling Precautions</h2>
4794 <div class="sectionbody">
4795 <div class="paragraph">
4796 <p>All Altus Metrum products are sophisticated electronic devices.
4797 When handled gently and properly installed in an air-frame, they
4798 will deliver impressive results.  However, as with all electronic
4799 devices, there are some precautions you must take.</p>
4800 </div>
4801 <div class="admonitionblock warning">
4802 <table>
4803 <tr>
4804 <td class="icon">
4805 <img src="./images/icons/warning.svg" alt="Warning">
4806 </td>
4807 <td class="content">
4808 The Lithium Polymer rechargeable batteries have an
4809 extraordinary power density.  This is great because we can fly with
4810 much less battery mass than if we used alkaline batteries or previous
4811 generation rechargeable batteries&#8230;&#8203; but if they are punctured
4812 or their leads are allowed to short, they can and will release their
4813 energy very rapidly!
4814 Thus we recommend that you take some care when handling our batteries
4815 and consider giving them some extra protection in your air-frame.  We
4816 often wrap them in suitable scraps of closed-cell packing foam before
4817 strapping them down, for example.
4818 </td>
4819 </tr>
4820 </table>
4821 </div>
4822 <div class="paragraph">
4823 <p>The barometric sensors used on all of our flight computers are
4824 sensitive to sunlight.  In normal mounting situations, the baro sensor
4825 and all of the other surface mount components
4826 are “down” towards whatever the underlying mounting surface is, so
4827 this is not normally a problem.  Please consider this when designing an
4828 installation in an air-frame with a see-through plastic payload bay.  It
4829 is particularly important to
4830 consider this with TeleMini v1.0, both because the baro sensor is on the
4831 “top” of the board, and because many model rockets with payload bays
4832 use clear plastic for the payload bay!  Replacing these with an opaque
4833 cardboard tube, painting them, or wrapping them with a layer of masking
4834 tape are all reasonable approaches to keep the sensor out of direct
4835 sunlight.</p>
4836 </div>
4837 <div class="paragraph">
4838 <p>The barometric sensor sampling port must be able to “breathe”,
4839 both by not being covered by foam or tape or other materials that might
4840 directly block the hole on the top of the sensor, and also by having a
4841 suitable static vent to outside air.</p>
4842 </div>
4843 <div class="paragraph">
4844 <p>As with all other rocketry electronics, Altus Metrum altimeters must
4845 be protected from exposure to corrosive motor exhaust and ejection
4846 charge gasses.</p>
4847 </div>
4848 </div>
4849 </div>
4850 <div class="sect1">
4851 <h2 id="_updating_device_firmware">Appendix C: Updating Device Firmware</h2>
4852 <div class="sectionbody">
4853 <div class="paragraph">
4854 <p>TeleMega, TeleMetrum v2 and newer, EasyMega, EasyMini and TeleDongle v3
4855 are all
4856 programmed directly over their USB connectors (self
4857 programming).
4858 TeleMetrum v1, TeleMini v1.0 and TeleDongle v0.2 are
4859 all programmed by using another device as a programmer (pair
4860 programming). It&#8217;s important to recognize which kind of devices
4861 you have before trying to reprogram them.</p>
4862 </div>
4863 <div class="paragraph">
4864 <p>You may wish to begin by ensuring you have current firmware
4865 images.  These are distributed as part of the AltOS software
4866 bundle that also includes the AltosUI ground station program.
4867 Newer ground station versions typically work fine with older
4868 firmware versions, so you don&#8217;t need to update your devices
4869 just to try out new software features.  You can always
4870 download the most recent version from
4871 <a href="http://www.altusmetrum.org/AltOS/" class="bare">http://www.altusmetrum.org/AltOS/</a></p>
4872 </div>
4873 <div class="sect2">
4874 <h3 id="_updating_telemega_telemetrum_v2_or_newer_easymega_easymini_teledongle_v3_or_telebt_v3_firmware">C.1. Updating TeleMega, TeleMetrum v2 or newer, EasyMega, EasyMini, TeleDongle v3 or TeleBT v3 Firmware</h3>
4875 <div class="paragraph">
4876 <p>Self-programmable devices are reprogrammed by
4877 connecting them to your computer over USB.</p>
4878 </div>
4879 <div class="olist arabic">
4880 <ol class="arabic">
4881 <li>
4882 <p>Attach a battery if necessary and power switch to
4883 the target device. Power up the device.</p>
4884 </li>
4885 <li>
4886 <p>Using a Micro USB cable, connect the target device to your
4887 computer&#8217;s USB socket.</p>
4888 </li>
4889 <li>
4890 <p>Run AltosUI, and select 'Flash Image' from the File menu.</p>
4891 </li>
4892 <li>
4893 <p>Select the target device in the Device Selection dialog.</p>
4894 </li>
4895 <li>
4896 <p>Select the image you want to flash to the device,
4897 which should have a name in the form
4898 &lt;product&gt;-v&lt;product-version&gt;-&lt;software-version&gt;.ihx,
4899 such as EasyMini-v1.0-1.6.0.ihx.</p>
4900 </li>
4901 <li>
4902 <p>Make sure the configuration parameters are
4903 reasonable looking. If the serial number and/or RF
4904 configuration values aren&#8217;t right, you&#8217;ll need to
4905 change them.</p>
4906 </li>
4907 <li>
4908 <p>Hit the 'OK' button and the software should proceed
4909 to flash the device with new firmware, showing a
4910 progress bar.</p>
4911 </li>
4912 <li>
4913 <p>Verify that the device is working by using the
4914 'Configure Altimeter' or 'Configure Groundstation'
4915 item to check over the configuration.</p>
4916 </li>
4917 </ol>
4918 </div>
4919 <div class="sect3">
4920 <h4 id="_recovering_from_self_flashing_failure">C.1.1. Recovering From Self-Flashing Failure</h4>
4921 <div class="paragraph">
4922 <p>If the firmware loading fails, it can leave the device
4923 unable to boot. Not to worry, you can force the device to
4924 start the boot loader instead, which will let you try to
4925 flash the device again.</p>
4926 </div>
4927 <div class="paragraph">
4928 <p>On each device, connecting two pins from one of the exposed
4929 connectors will force the boot loader to start, even if the
4930 regular operating system has been corrupted in some way.</p>
4931 </div>
4932 <div class="dlist">
4933 <dl>
4934 <dt class="hdlist1">TeleMega</dt>
4935 <dd>
4936 <p>Connect pin 6 and pin 1 of the companion
4937 connector. Pin 1 can be identified by the square pad
4938 around it, and then the pins could sequentially across
4939 the board. Be very careful to <strong>not</strong> short pin 8 to
4940 anything as that is connected directly to the
4941 battery. Pin 7 carries 3.3V and the board will crash
4942 if that is connected to pin 1, but shouldn&#8217;t damage
4943 the board.</p>
4944 </dd>
4945 <dt class="hdlist1">EasyMega</dt>
4946 <dd>
4947 <p>Connect pin 6 and pin 1 of the companion
4948 connector. Pin 1 can be identified by the square pad
4949 around it, and then the pins could sequentially across
4950 the board. Be very careful to <strong>not</strong> short pin 8 to
4951 anything as that is connected directly to the
4952 battery. Pin 7 carries 3.3V and the board will crash
4953 if that is connected to pin 1, but shouldn&#8217;t damage
4954 the board.</p>
4955 </dd>
4956 <dt class="hdlist1">EasyTimer</dt>
4957 <dd>
4958 <p>Connect pin 5 and pin 1 of the debug connector, which
4959 is the six holes next to the beeper. Pin 1 can be
4960 identified by the square pad around it, and then the
4961 pins could sequentially across the board, making Pin 5
4962 the one on the other end of the row.</p>
4963 </dd>
4964 <dt class="hdlist1">TeleMetrum v2 and newer</dt>
4965 <dd>
4966 <p>Connect pin 6 and pin 1 of the companion
4967 connector. Pin 1 can be identified by the square pad
4968 around it, and then the pins could sequentially across
4969 the board. Be very careful to <strong>not</strong> short pin 8 to
4970 anything as that is connected directly to the
4971 battery. Pin 7 carries 3.3V and the board will crash
4972 if that is connected to pin 1, but shouldn&#8217;t damage
4973 the board.</p>
4974 </dd>
4975 <dt class="hdlist1">EasyMini</dt>
4976 <dd>
4977 <p>Connect pin 6 and pin 1 of the debug connector, which
4978 is the six holes next to the beeper. Pin 1 can be
4979 identified by the square pad around it, and then the
4980 pins could sequentially across the board, making Pin 6
4981 the one on the other end of the row.</p>
4982 </dd>
4983 <dt class="hdlist1">TeleGPS v1</dt>
4984 <dd>
4985 <p>Connect pin 32 on the CPU to ground.  Pin 32 is the
4986 right-most pin on the bottom edge of the CPU when the
4987 board is oriented with the USB and battery connectors
4988 to the right.</p>
4989 </dd>
4990 <dt class="hdlist1">TeleGPS v2</dt>
4991 <dd>
4992 <p>Connect together pins 1 and 5 of the Debug connector.
4993 Pin 1 is the pin with the square pad around the hole.</p>
4994 </dd>
4995 <dt class="hdlist1">TeleDongle v3</dt>
4996 <dd>
4997 <p>Connect pin 32 on the CPU to ground. Pin 32 is closest
4998 to the USB wires on the row of pins towards the center
4999 of the board. Ground is available on the capacitor
5000 next to it, on the end towards the USB wires.</p>
5001 </dd>
5002 <dt class="hdlist1">TeleBT v3</dt>
5003 <dd>
5004 <p>Connect pin 4 on the CPU to 3.3V, which can be done by
5005 connecting pin 1 to pin 4.  Pin 1 is the left pin on
5006 the lower edge of the chip when the unit is oriented
5007 such that the SMA is at the top.</p>
5008 </dd>
5009 <dt class="hdlist1">TeleBT v4</dt>
5010 <dd>
5011 <p>Connect pin 30 on the CPU to ground. Pin 30 is the 6th
5012 pin from the right on the top when the unit is oriented
5013 such that the SMA is at the top.</p>
5014 </dd>
5015 </dl>
5016 </div>
5017 <div class="paragraph">
5018 <p>Once you&#8217;ve located the right pins:</p>
5019 </div>
5020 <div class="olist arabic">
5021 <ol class="arabic">
5022 <li>
5023 <p>Turn the altimeter power off.</p>
5024 </li>
5025 <li>
5026 <p>Connect a battery.</p>
5027 </li>
5028 <li>
5029 <p>Connect the indicated terminals together with a
5030 short piece of wire. Take care not to accidentally
5031 connect anything else.</p>
5032 </li>
5033 <li>
5034 <p>Connect USB</p>
5035 </li>
5036 <li>
5037 <p>Turn the board power on.</p>
5038 </li>
5039 </ol>
5040 </div>
5041 <div class="paragraph">
5042 <p>The board should now be visible over USB as
5043 'AltosFlash' and be ready to receive firmware.  Once
5044 the board has been powered up, you can remove the
5045 piece of wire.</p>
5046 </div>
5047 </div>
5048 </div>
5049 <div class="sect2">
5050 <h3 id="_pair_programming">C.2. Pair Programming</h3>
5051 <div class="paragraph">
5052 <p>The big concept to understand is that you have to use
5053 a TeleMetrum v1.0, TeleBT v1.0 or TeleDongle v0.2 as a
5054 programmer to update a pair programmed device. Due to
5055 limited memory resources in the cc1111, we don&#8217;t
5056 support programming directly over USB for these
5057 devices.</p>
5058 </div>
5059 <div class="paragraph">
5060 <p>If you need to update the firmware on a TeleDongle
5061 v0.2, we recommend updating the altimeter first,
5062 before updating TeleDongle.  However, note that
5063 TeleDongle rarely need to be updated.  Any firmware
5064 version 1.0.1 or later will work, version 1.2.1 may
5065 have improved receiver performance slightly.</p>
5066 </div>
5067 <div class="sect3">
5068 <h4 id="_updating_telemetrum_v1_x_firmware">C.2.1. Updating TeleMetrum v1.x Firmware</h4>
5069 <div class="olist arabic">
5070 <ol class="arabic">
5071 <li>
5072 <p>Find the 'programming cable' that you got as
5073 part of the starter kit, that has a red
5074 8-pin MicroMaTch connector on one end and a
5075 red 4-pin MicroMaTch connector on the other
5076 end.</p>
5077 </li>
5078 <li>
5079 <p>Take the 2 screws out of the TeleDongle v0.2
5080 or TeleBT v1.0 case to get access to the
5081 circuit board.</p>
5082 </li>
5083 <li>
5084 <p>Plug the 8-pin end of the programming cable
5085 to the matching connector on the TeleDongle
5086 v0.2 or TeleBT v1.0, and the 4-pin end to
5087 the matching connector on the TeleMetrum.
5088 Note that each MicroMaTch connector has an
5089 alignment pin that goes through a hole in
5090 the PC board when you have the cable
5091 oriented correctly.</p>
5092 </li>
5093 <li>
5094 <p>Attach a battery to the TeleMetrum board.</p>
5095 </li>
5096 <li>
5097 <p>Plug the TeleDongle v0.2 or TeleBT v1.0 into
5098 your computer&#8217;s USB port, and power up the
5099 TeleMetrum.</p>
5100 </li>
5101 <li>
5102 <p>Run AltosUI, and select 'Flash Image' from
5103 the File menu.</p>
5104 </li>
5105 <li>
5106 <p>Pick the TeleDongle v0.2 or TeleBT v1.0
5107 device from the list, identifying it as the
5108 programming device.</p>
5109 </li>
5110 <li>
5111 <p>Select the image you want put on the
5112 TeleMetrum, which should have a name in the
5113 form telemetrum-v1.2-1.0.0.ihx.  It should
5114 be visible in the default directory, if not
5115 you may have to poke around your system to
5116 find it.</p>
5117 </li>
5118 <li>
5119 <p>Make sure the configuration parameters are
5120 reasonable looking. If the serial number
5121 and/or RF configuration values aren&#8217;t right,
5122 you&#8217;ll need to change them.</p>
5123 </li>
5124 <li>
5125 <p>Hit the 'OK' button and the software should
5126 proceed to flash the TeleMetrum with new
5127 firmware, showing a progress bar.</p>
5128 </li>
5129 <li>
5130 <p>Confirm that the TeleMetrum board seems to
5131 have updated OK, which you can do by
5132 plugging in to it over USB and using a
5133 terminal program to connect to the board and
5134 issue the 'v' command to check the version,
5135 etc.</p>
5136 </li>
5137 </ol>
5138 </div>
5139 <div class="paragraph">
5140 <p>If something goes wrong, give it another try.</p>
5141 </div>
5142 </div>
5143 <div class="sect3">
5144 <h4 id="_updating_telemini_v1_0_firmware">C.2.2. Updating TeleMini v1.0 Firmware</h4>
5145 <div class="paragraph">
5146 <p>You&#8217;ll need a special 'programming cable' to
5147 reprogram the TeleMini v1.0.  You can make your own
5148 using an 8-pin MicroMaTch connector on one end
5149 and a set of four pins on the other.</p>
5150 </div>
5151 <div class="olist arabic">
5152 <ol class="arabic">
5153 <li>
5154 <p>Take the 2 screws out of the TeleDongle v0.2
5155 or TeleBT v1.0 case to get access to the
5156 circuit board.</p>
5157 </li>
5158 <li>
5159 <p>Plug the 8-pin end of the programming cable
5160 to the matching connector on the TeleDongle
5161 v0.2 or TeleBT v1.0, and the 4-pins into the
5162 holes in the TeleMini v1.0 circuit board.  Note
5163 that the MicroMaTch connector has an
5164 alignment pin that goes through a hole in
5165 the PC board when you have the cable
5166 oriented correctly, and that pin 1 on the
5167 TeleMini v1.0 board is marked with a square pad
5168 while the other pins have round pads.</p>
5169 </li>
5170 <li>
5171 <p>Attach a battery to the TeleMini v1.0 board.</p>
5172 </li>
5173 <li>
5174 <p>Plug the TeleDongle v0.2 or TeleBT v1.0 into
5175 your computer&#8217;s USB port, and power up the
5176 TeleMini v1.0</p>
5177 </li>
5178 <li>
5179 <p>Run AltosUI, and select 'Flash Image' from
5180 the File menu.</p>
5181 </li>
5182 <li>
5183 <p>Pick the TeleDongle v0.2 or TeleBT v1.0
5184 device from the list, identifying it as the
5185 programming device.</p>
5186 </li>
5187 <li>
5188 <p>Select the image you want put on the
5189 TeleMini v1.0, which should have a name in the
5190 form telemini-v1.0-1.0.0.ihx.  It should be
5191 visible in the default directory, if not you
5192 may have to poke around your system to find
5193 it.</p>
5194 </li>
5195 <li>
5196 <p>Make sure the configuration parameters are
5197 reasonable looking. If the serial number
5198 and/or RF configuration values aren&#8217;t right,
5199 you&#8217;ll need to change them.</p>
5200 </li>
5201 <li>
5202 <p>Hit the 'OK' button and the software should
5203 proceed to flash the TeleMini v1.0 with new
5204 firmware, showing a progress bar.</p>
5205 </li>
5206 <li>
5207 <p>Confirm that the TeleMini v1.0 board seems to
5208 have updated OK, which you can do by
5209 configuring it over the radio link through
5210 the TeleDongle, or letting it come up in
5211 “flight” mode and listening for telemetry.</p>
5212 </li>
5213 </ol>
5214 </div>
5215 <div class="paragraph">
5216 <p>If something goes wrong, give it another try.</p>
5217 </div>
5218 </div>
5219 <div class="sect3">
5220 <h4 id="_updating_teledongle_v0_2_firmware">C.2.3. Updating TeleDongle v0.2 Firmware</h4>
5221 <div class="paragraph">
5222 <p>Updating TeleDongle v0.2 firmware is just like
5223 updating TeleMetrum v1.x or TeleMini v1.0 firmware, but you
5224 use either a TeleMetrum v1.x, TeleDongle v0.2 or
5225 TeleBT v1.0 as the programmer.</p>
5226 </div>
5227 <div class="olist arabic">
5228 <ol class="arabic">
5229 <li>
5230 <p>Find the 'programming cable' that you got as part of
5231 the starter kit, that has a red 8-pin MicroMaTch
5232 connector on one end and a red 4-pin MicroMaTch
5233 connector on the other end.</p>
5234 </li>
5235 <li>
5236 <p>Find the USB cable that you got as part of the
5237 starter kit, and plug the “mini” end in to the
5238 mating connector on TeleMetrum v1.x, TeleDongle v0.2
5239 or TeleBT v1.0.</p>
5240 </li>
5241 <li>
5242 <p>Take the 2 screws out of the TeleDongle v0.2 or
5243 TeleBT v1.0 case to get access to the circuit board.</p>
5244 </li>
5245 <li>
5246 <p>Plug the 8-pin end of the programming cable to the
5247 matching connector on the programmer, and the 4-pin
5248 end to the matching connector on the TeleDongle
5249 v0.2.  Note that each MicroMaTch connector has an
5250 alignment pin that goes through a hole in the PC
5251 board when you have the cable oriented correctly.</p>
5252 </li>
5253 <li>
5254 <p>Attach a battery to the TeleMetrum v1.x board if
5255 you&#8217;re using one.</p>
5256 </li>
5257 <li>
5258 <p>Plug both the programmer and the TeleDongle into
5259 your computer&#8217;s USB ports, and power up the
5260 programmer.</p>
5261 </li>
5262 <li>
5263 <p>Run AltosUI, and select 'Flash Image' from the File
5264 menu.</p>
5265 </li>
5266 <li>
5267 <p>Pick the programmer device from the list,
5268 identifying it as the programming device.</p>
5269 </li>
5270 <li>
5271 <p>Select the image you want put on the TeleDongle
5272 v0.2, which should have a name in the form
5273 teledongle-v0.2-1.0.0.ihx.  It should be visible in
5274 the default directory, if not you may have to poke
5275 around your system to find it.</p>
5276 </li>
5277 <li>
5278 <p>Make sure the configuration parameters are
5279 reasonable looking. If the serial number and/or RF
5280 configuration values aren&#8217;t right, you&#8217;ll need to
5281 change them.  The TeleDongle v0.2 serial number is
5282 on the “bottom” of the circuit board, and can
5283 usually be read through the translucent blue plastic
5284 case without needing to remove the board from the
5285 case.</p>
5286 </li>
5287 <li>
5288 <p>Hit the 'OK' button and the software should proceed
5289 to flash the TeleDongle v0.2 with new firmware,
5290 showing a progress bar.</p>
5291 </li>
5292 <li>
5293 <p>Confirm that the TeleDongle v0.2 board seems to have
5294 updated OK, which you can do by plugging in to it
5295 over USB and using a terminal program to connect to
5296 the board and issue the 'v' command to check the
5297 version, etc.  Once you&#8217;re happy, remove the
5298 programming cable and put the cover back on the
5299 TeleDongle v0.2.</p>
5300 </li>
5301 </ol>
5302 </div>
5303 <div class="paragraph">
5304 <p>If something goes wrong, give it another try.</p>
5305 </div>
5306 <div class="paragraph">
5307 <p>Be careful removing the programming cable from the
5308 locking 8-pin connector on TeleMetrum.  You&#8217;ll need a
5309 fingernail or perhaps a thin screwdriver or knife
5310 blade to gently pry the locking ears out slightly to
5311 extract the connector.  We used a locking connector on
5312 TeleMetrum to help ensure that the cabling to
5313 companion boards used in a rocket don&#8217;t ever come
5314 loose accidentally in flight.</p>
5315 </div>
5316 </div>
5317 </div>
5318 </div>
5319 </div>
5320 <div class="sect1">
5321 <h2 id="_flight_data_recording">Appendix D: Flight Data Recording</h2>
5322 <div class="sectionbody">
5323 <div class="paragraph">
5324 <p>Each flight computer logs data at 100 samples per second
5325 during ascent and 10 samples per second during
5326 descent, except for TeleMini v1.0, which records ascent at 10 samples
5327 per second and descent at 1 sample per second.
5328 Data are logged to
5329 an on-board flash memory part, which can be partitioned into
5330 several equal-sized blocks, one for each flight.</p>
5331 </div>
5332 <table class="tableblock frame-all grid-all stretch">
5333 <caption class="title">Table 11. Data Storage on Altus Metrum altimeters</caption>
5334 <colgroup>
5335 <col style="width: 25%;">
5336 <col style="width: 25%;">
5337 <col style="width: 25%;">
5338 <col style="width: 25%;">
5339 </colgroup>
5340 <thead>
5341 <tr>
5342 <th class="tableblock halign-left valign-top">Device</th>
5343 <th class="tableblock halign-left valign-top">Bytes per Sample</th>
5344 <th class="tableblock halign-left valign-top">Total Storage</th>
5345 <th class="tableblock halign-left valign-top">Minutes at Full Rate</th>
5346 </tr>
5347 </thead>
5348 <tbody>
5349 <tr>
5350 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.0</p></td>
5351 <td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
5352 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5353 <td class="tableblock halign-left valign-top"><p class="tableblock">20</p></td>
5354 </tr>
5355 <tr>
5356 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.1 v1.2</p></td>
5357 <td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
5358 <td class="tableblock halign-left valign-top"><p class="tableblock">2MB</p></td>
5359 <td class="tableblock halign-left valign-top"><p class="tableblock">40</p></td>
5360 </tr>
5361 <tr>
5362 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v2.0</p></td>
5363 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5364 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5365 <td class="tableblock halign-left valign-top"><p class="tableblock">80</p></td>
5366 </tr>
5367 <tr>
5368 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v3.0</p></td>
5369 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5370 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5371 <td class="tableblock halign-left valign-top"><p class="tableblock">80</p></td>
5372 </tr>
5373 <tr>
5374 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v1.0</p></td>
5375 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
5376 <td class="tableblock halign-left valign-top"><p class="tableblock">5kB</p></td>
5377 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
5378 </tr>
5379 <tr>
5380 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v3.0</p></td>
5381 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5382 <td class="tableblock halign-left valign-top"><p class="tableblock">512kB</p></td>
5383 <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
5384 </tr>
5385 <tr>
5386 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini</p></td>
5387 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5388 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5389 <td class="tableblock halign-left valign-top"><p class="tableblock">10</p></td>
5390 </tr>
5391 <tr>
5392 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega</p></td>
5393 <td class="tableblock halign-left valign-top"><p class="tableblock">32</p></td>
5394 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5395 <td class="tableblock halign-left valign-top"><p class="tableblock">40</p></td>
5396 </tr>
5397 <tr>
5398 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega</p></td>
5399 <td class="tableblock halign-left valign-top"><p class="tableblock">32</p></td>
5400 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5401 <td class="tableblock halign-left valign-top"><p class="tableblock">40</p></td>
5402 </tr>
5403 </tbody>
5404 </table>
5405 <div class="paragraph">
5406 <p>The on-board flash is partitioned into separate flight logs,
5407 each of a fixed maximum size. Increase the maximum size of
5408 each log and you reduce the number of flights that can be
5409 stored. Decrease the size and you can store more flights.</p>
5410 </div>
5411 <div class="paragraph">
5412 <p>Configuration data is also stored in the flash memory on
5413 TeleMetrum v1.x,
5414 TeleMini v3.0 and
5415 EasyMini.
5416 This consumes 64kB
5417 of flash space.  This configuration space is not available
5418 for storing flight log data.</p>
5419 </div>
5420 <div class="paragraph">
5421 <p>TeleMetrum v2 or newer, TeleMega and EasyMega
5422 store configuration data in a bit of eeprom available within
5423 the processor chip, leaving that space available in flash for
5424 more flight data.</p>
5425 </div>
5426 <div class="paragraph">
5427 <p>To compute the amount of space needed for a single flight, you
5428 can multiply the expected ascent time (in seconds) by 100
5429 times bytes-per-sample, multiply the expected descent time (in
5430 seconds) by 10 times the bytes per sample and add the two
5431 together. That will slightly under-estimate the storage (in
5432 bytes) needed for the flight.
5433 For instance, a TeleMetrum v2 or newer flight spending
5434 20 seconds in ascent and 150 seconds in descent will take
5435 about (20 * 1600) + (150 * 160) = 56000 bytes of storage. You
5436 could store dozens of these flights in the on-board flash.</p>
5437 </div>
5438 <div class="paragraph">
5439 <p>The default size allows for several flights on each flight
5440 computer, except for TeleMini v1.0, which
5441 only holds data for a single flight.
5442 You can adjust the size.</p>
5443 </div>
5444 <div class="paragraph">
5445 <p>Altus Metrum flight computers will not overwrite existing
5446 flight data, so be sure to download flight data and erase it
5447 from the flight computer before it fills up. The flight
5448 computer will still successfully control the flight even if it
5449 cannot log data, so the only thing you will lose is the data.</p>
5450 </div>
5451 </div>
5452 </div>
5453 <div class="sect1">
5454 <h2 id="_altus_metrum_hardware_specifications">Appendix E: Altus Metrum Hardware Specifications</h2>
5455 <div class="sectionbody">
5456 <div class="paragraph">
5457 <p>Here&#8217;s the full set of Altus Metrum products, both in
5458 production and retired.</p>
5459 </div>
5460 <table class="tableblock frame-all grid-all stretch">
5461 <caption class="title">Table 12. Altus Metrum Flight Computer Electronics</caption>
5462 <colgroup>
5463 <col style="width: 12.5%;">
5464 <col style="width: 12.5%;">
5465 <col style="width: 12.5%;">
5466 <col style="width: 12.5%;">
5467 <col style="width: 12.5%;">
5468 <col style="width: 12.5%;">
5469 <col style="width: 12.5%;">
5470 <col style="width: 12.5%;">
5471 </colgroup>
5472 <thead>
5473 <tr>
5474 <th class="tableblock halign-left valign-top">Device</th>
5475 <th class="tableblock halign-left valign-top">Barometer</th>
5476 <th class="tableblock halign-left valign-top">Z-axis accel</th>
5477 <th class="tableblock halign-left valign-top">GPS</th>
5478 <th class="tableblock halign-left valign-top">3D sensors</th>
5479 <th class="tableblock halign-left valign-top">Storage</th>
5480 <th class="tableblock halign-left valign-top">RF Output</th>
5481 <th class="tableblock halign-left valign-top">Battery</th>
5482 </tr>
5483 </thead>
5484 <tbody>
5485 <tr>
5486 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.0</p></td>
5487 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5488 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA2202 50g</p></td>
5489 <td class="tableblock halign-left valign-top"><p class="tableblock">SkyTraq</p></td>
5490 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5491 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5492 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5493 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5494 </tr>
5495 <tr>
5496 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.1</p></td>
5497 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5498 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA2202 50g</p></td>
5499 <td class="tableblock halign-left valign-top"><p class="tableblock">SkyTraq</p></td>
5500 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5501 <td class="tableblock halign-left valign-top"><p class="tableblock">2MB</p></td>
5502 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5503 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5504 </tr>
5505 <tr>
5506 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.2</p></td>
5507 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5508 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL78 70g</p></td>
5509 <td class="tableblock halign-left valign-top"><p class="tableblock">SkyTraq</p></td>
5510 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5511 <td class="tableblock halign-left valign-top"><p class="tableblock">2MB</p></td>
5512 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5513 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5514 </tr>
5515 <tr>
5516 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v2.0</p></td>
5517 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5518 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
5519 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
5520 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5521 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5522 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5523 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5524 </tr>
5525 <tr>
5526 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v3.0</p></td>
5527 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5528 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
5529 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-8Q</p></td>
5530 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5531 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5532 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5533 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5534 </tr>
5535 <tr>
5536 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v1.0</p></td>
5537 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5538 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5539 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5540 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5541 <td class="tableblock halign-left valign-top"><p class="tableblock">5kB</p></td>
5542 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5543 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5544 </tr>
5545 <tr>
5546 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v3.0</p></td>
5547 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5548 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5549 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5550 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5551 <td class="tableblock halign-left valign-top"><p class="tableblock">512kB</p></td>
5552 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5553 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5554 </tr>
5555 <tr>
5556 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini v1.0</p></td>
5557 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5558 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5559 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5560 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5561 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5562 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5563 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7-12V</p></td>
5564 </tr>
5565 <tr>
5566 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini v2.0</p></td>
5567 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5568 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5569 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5570 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5571 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5572 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5573 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7-12V</p></td>
5574 </tr>
5575 <tr>
5576 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v1.0</p></td>
5577 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5578 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
5579 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
5580 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 HMC5883</p></td>
5581 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5582 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5583 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5584 </tr>
5585 <tr>
5586 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v2.0</p></td>
5587 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5588 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
5589 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
5590 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 HMC5883</p></td>
5591 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5592 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5593 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5594 </tr>
5595 <tr>
5596 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v3.0</p></td>
5597 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5598 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
5599 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
5600 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU9250</p></td>
5601 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5602 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5603 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5604 </tr>
5605 <tr>
5606 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v4.0</p></td>
5607 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5608 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
5609 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-8Q</p></td>
5610 <td class="tableblock halign-left valign-top"><p class="tableblock">BMX160</p></td>
5611 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5612 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5613 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5614 </tr>
5615 <tr>
5616 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega v1.0</p></td>
5617 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5618 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
5619 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5620 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 HMC5883</p></td>
5621 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5622 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5623 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5624 </tr>
5625 <tr>
5626 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega v2.0</p></td>
5627 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5628 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
5629 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5630 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU9250</p></td>
5631 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5632 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5633 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5634 </tr>
5635 <tr>
5636 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyTimer v1.0</p></td>
5637 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5638 <td class="tableblock halign-left valign-top"><p class="tableblock">16g</p></td>
5639 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5640 <td class="tableblock halign-left valign-top"><p class="tableblock">BMX160</p></td>
5641 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5642 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5643 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7-12V</p></td>
5644 </tr>
5645 </tbody>
5646 </table>
5647 <div style="page-break-after: always;"></div>
5648 <table class="tableblock frame-all grid-all stretch">
5649 <caption class="title">Table 13. Altus Metrum Flight Computer Mechanical Components</caption>
5650 <colgroup>
5651 <col style="width: 16.6666%;">
5652 <col style="width: 16.6666%;">
5653 <col style="width: 16.6666%;">
5654 <col style="width: 16.6666%;">
5655 <col style="width: 16.6666%;">
5656 <col style="width: 16.667%;">
5657 </colgroup>
5658 <thead>
5659 <tr>
5660 <th class="tableblock halign-left valign-top">Device</th>
5661 <th class="tableblock halign-left valign-top">Connectors</th>
5662 <th class="tableblock halign-left valign-top">Screw Terminals</th>
5663 <th class="tableblock halign-left valign-top">Width</th>
5664 <th class="tableblock halign-left valign-top">Length</th>
5665 <th class="tableblock halign-left valign-top">Tube Size</th>
5666 </tr>
5667 </thead>
5668 <tbody>
5669 <tr>
5670 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum</p></td>
5671 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug Companion USB Battery</p></td>
5672 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Switch</p></td>
5673 <td class="tableblock halign-left valign-top"><p class="tableblock">1 inch (2.54cm)</p></td>
5674 <td class="tableblock halign-left valign-top"><p class="tableblock">2 ¾ inch (6.99cm)</p></td>
5675 <td class="tableblock halign-left valign-top"><p class="tableblock">29mm coupler</p></td>
5676 </tr>
5677 <tr>
5678 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v1.0</p></td>
5679 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug Battery</p></td>
5680 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro</p></td>
5681 <td class="tableblock halign-left valign-top"><p class="tableblock">½ inch (1.27cm)</p></td>
5682 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
5683 <td class="tableblock halign-left valign-top"><p class="tableblock">18mm coupler</p></td>
5684 </tr>
5685 <tr>
5686 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v2.0</p></td>
5687 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug USB Battery</p></td>
5688 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Battery Switch</p></td>
5689 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
5690 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
5691 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
5692 </tr>
5693 <tr>
5694 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini</p></td>
5695 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug USB Battery</p></td>
5696 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Battery</p></td>
5697 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
5698 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
5699 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
5700 </tr>
5701 <tr>
5702 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega</p></td>
5703 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug Companion USB Battery</p></td>
5704 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Pyro A-D Switch Pyro battery</p></td>
5705 <td class="tableblock halign-left valign-top"><p class="tableblock">1¼ inch (3.18cm)</p></td>
5706 <td class="tableblock halign-left valign-top"><p class="tableblock">3¼ inch (8.26cm)</p></td>
5707 <td class="tableblock halign-left valign-top"><p class="tableblock">38mm coupler</p></td>
5708 </tr>
5709 <tr>
5710 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega</p></td>
5711 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug Companion USB Battery</p></td>
5712 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Pyro A-D Switch Pyro battery</p></td>
5713 <td class="tableblock halign-left valign-top"><p class="tableblock">1¼ inch (3.18cm)</p></td>
5714 <td class="tableblock halign-left valign-top"><p class="tableblock">2¼ inch (5.62cm)</p></td>
5715 <td class="tableblock halign-left valign-top"><p class="tableblock">38mm coupler</p></td>
5716 </tr>
5717 <tr>
5718 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini</p></td>
5719 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug USB Battery</p></td>
5720 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro A Pyro B Battery</p></td>
5721 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
5722 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
5723 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
5724 </tr>
5725 </tbody>
5726 </table>
5727 </div>
5728 </div>
5729 <div class="sect1">
5730 <h2 id="_release_notes">Appendix F: Release Notes</h2>
5731 <div class="sectionbody">
5732 <div class="sect2">
5733 <h3 id="_release_notes_for_version_1_9_4">F.1. Release Notes for Version 1.9.4</h3>
5734 <div class="paragraph">
5735 <p>Version 1.9.4</p>
5736 </div>
5737 <div class="sect3">
5738 <h4 id="_altos">F.1.1. AltOS</h4>
5739 <div class="ulist">
5740 <ul>
5741 <li>
5742 <p>Fixed firmware for TeleDongle v3.0 and TeleBT v4.0. Version 1.9.3 bricked those
5743 devices requiring them to be opened up to get them working again.</p>
5744 </li>
5745 <li>
5746 <p>Fixed firmware for EasyMini v1.0. Changes in the storage
5747 code caused it to use significantly more RAM which made the
5748 interrupt stack smash into other data structures and cause
5749 the device to panic at startup time.</p>
5750 </li>
5751 </ul>
5752 </div>
5753 </div>
5754 <div class="sect3">
5755 <h4 id="_altosui_2">F.1.2. AltosUI</h4>
5756 <div class="ulist">
5757 <ul>
5758 <li>
5759 <p>Add TeleMetrum v3.0 firmware to the Linux and Mac OSX
5760 AltosUI packages.</p>
5761 </li>
5762 </ul>
5763 </div>
5764 <div style="page-break-after: always;"></div>
5765 </div>
5766 </div>
5767 <div class="sect2">
5768 <h3 id="_release_notes_for_version_1_9_3">F.2. Release Notes for Version 1.9.3</h3>
5769 <div class="paragraph">
5770 <p>Version 1.9.3</p>
5771 </div>
5772 <div class="sect3">
5773 <h4 id="_altos_2">F.2.1. AltOS</h4>
5774 <div class="ulist">
5775 <ul>
5776 <li>
5777 <p>Add APRS offset. Allows multiple APRS transmitters to coordinate when
5778 transmission occurs to allow them to share a frequency.</p>
5779 </li>
5780 <li>
5781 <p>Fix max log size. Flight computer storage is erased in 64kB chunks. Adjust max
5782 log size to be a multiple of this size.</p>
5783 </li>
5784 <li>
5785 <p>Check flight erasing more carefully. Handle interrupting erasing in the
5786 middle.</p>
5787 </li>
5788 <li>
5789 <p>Add EasyTimer support.</p>
5790 </li>
5791 </ul>
5792 </div>
5793 </div>
5794 <div class="sect3">
5795 <h4 id="_altosui_telegps_micropeak">F.2.2. AltosUI, TeleGPS, MicroPeak</h4>
5796 <div class="ulist">
5797 <ul>
5798 <li>
5799 <p>Add configuration support for APRS offset.</p>
5800 </li>
5801 <li>
5802 <p>Adjust flight log sizes to be a multiple of the flight
5803 computer erase block size.</p>
5804 </li>
5805 <li>
5806 <p>Report barometric pad altitude in Pad tab for TeleMini.</p>
5807 </li>
5808 </ul>
5809 </div>
5810 <div style="page-break-after: always;"></div>
5811 </div>
5812 </div>
5813 <div class="sect2">
5814 <h3 id="_release_notes_for_version_1_9_2">F.3. Release Notes for Version 1.9.2</h3>
5815 <div class="paragraph">
5816 <p>Version 1.9.2</p>
5817 </div>
5818 <div class="sect3">
5819 <h4 id="_altos_3">F.3.1. AltOS</h4>
5820 <div class="ulist">
5821 <ul>
5822 <li>
5823 <p>Add support for TeleMega v4.0</p>
5824 </li>
5825 <li>
5826 <p>Fix time wrapping issue with TeleLCO and TeleFire</p>
5827 </li>
5828 </ul>
5829 </div>
5830 </div>
5831 <div class="sect3">
5832 <h4 id="_altosui_telegps_micropeak_2">F.3.2. AltosUI, TeleGPS, MicroPeak</h4>
5833 <div class="ulist">
5834 <ul>
5835 <li>
5836 <p>Add column in AltosUI for IMU data from TeleMega and EasyMega</p>
5837 </li>
5838 </ul>
5839 </div>
5840 </div>
5841 <div class="sect3">
5842 <h4 id="_altosdroid_2">F.3.3. AltosDroid</h4>
5843 <div class="ulist">
5844 <ul>
5845 <li>
5846 <p>Allow sorting of trackers by call, serial, frequency or age</p>
5847 </li>
5848 <li>
5849 <p>Offer selection of font sizes</p>
5850 </li>
5851 <li>
5852 <p>Various bug fixes for older Android versions</p>
5853 </li>
5854 </ul>
5855 </div>
5856 <div style="page-break-after: always;"></div>
5857 </div>
5858 </div>
5859 <div class="sect2">
5860 <h3 id="_release_notes_for_version_1_9_1">F.4. Release Notes for Version 1.9.1</h3>
5861 <div class="paragraph">
5862 <p>Version 1.9.1</p>
5863 </div>
5864 <div class="sect3">
5865 <h4 id="_altos_4">F.4.1. AltOS</h4>
5866 <div class="ulist">
5867 <ul>
5868 <li>
5869 <p>Add support for TeleMetrum v3.0</p>
5870 </li>
5871 <li>
5872 <p>Fix accel cal value when changing EasyMega v2.0 pad orientation</p>
5873 </li>
5874 <li>
5875 <p>Correct EasyMega v2.0 magnetometer data axes</p>
5876 </li>
5877 <li>
5878 <p>Fix EasyMega v2.0 idle monitor display of IMU data</p>
5879 </li>
5880 <li>
5881 <p>Report all sensor failures at power-up time.</p>
5882 </li>
5883 </ul>
5884 </div>
5885 </div>
5886 <div class="sect3">
5887 <h4 id="_altosui_telegps_micropeak_3">F.4.2. AltosUI, TeleGPS, MicroPeak</h4>
5888 <div class="ulist">
5889 <ul>
5890 <li>
5891 <p>Display error message when attempting to graph unknown format file.</p>
5892 </li>
5893 <li>
5894 <p>Make it possible to disable APRS once enabled.</p>
5895 </li>
5896 <li>
5897 <p>Display some data for point near cursor in map tab.</p>
5898 </li>
5899 <li>
5900 <p>Support upgrading devices from pre-1.8 firmware</p>
5901 </li>
5902 <li>
5903 <p>Wait for Windows to prepare new devices during firmware
5904 upgrade. This should avoid the “COMxx: open failed” message.</p>
5905 </li>
5906 </ul>
5907 </div>
5908 <div style="page-break-after: always;"></div>
5909 </div>
5910 </div>
5911 <div class="sect2">
5912 <h3 id="_release_notes_for_version_1_9">F.5. Release Notes for Version 1.9</h3>
5913 <div class="paragraph">
5914 <p>Version 1.9</p>
5915 </div>
5916 <div class="sect3">
5917 <h4 id="_altos_5">F.5.1. AltOS</h4>
5918 <div class="ulist">
5919 <ul>
5920 <li>
5921 <p>Add support for EasyMega v2.0</p>
5922 </li>
5923 <li>
5924 <p>Replace C library for ARM devices</p>
5925 </li>
5926 <li>
5927 <p>Remove support for 8051-based devices and SDCC compiler</p>
5928 </li>
5929 </ul>
5930 </div>
5931 </div>
5932 <div class="sect3">
5933 <h4 id="_altosui_telegps_micropeak_4">F.5.2. AltosUI, TeleGPS, MicroPeak</h4>
5934 <div class="ulist">
5935 <ul>
5936 <li>
5937 <p>Select ROM images based on product name when reflashing</p>
5938 </li>
5939 <li>
5940 <p>Fix TeleGPS v2 battery voltage display</p>
5941 </li>
5942 </ul>
5943 </div>
5944 <div style="page-break-after: always;"></div>
5945 </div>
5946 </div>
5947 <div class="sect2">
5948 <h3 id="_release_notes_for_version_1_8_7">F.6. Release Notes for Version 1.8.7</h3>
5949 <div class="paragraph">
5950 <p>Version 1.8.7</p>
5951 </div>
5952 <div class="sect3">
5953 <h4 id="_altos_6">F.6.1. AltOS</h4>
5954 <div class="ulist">
5955 <ul>
5956 <li>
5957 <p>Include TeleMega v3.0 firmware</p>
5958 </li>
5959 </ul>
5960 </div>
5961 </div>
5962 <div class="sect3">
5963 <h4 id="_altosui_telegps_micropeak_5">F.6.2. AltosUI, TeleGPS, MicroPeak</h4>
5964 <div class="ulist">
5965 <ul>
5966 <li>
5967 <p>Poll for new devices while Device dialog is displayed</p>
5968 </li>
5969 <li>
5970 <p>Wait for device to re-appear when flashing new firmware</p>
5971 </li>
5972 <li>
5973 <p>Fetch correct TeleBT v4.0 RF calibration values from web
5974 site when reflashing.</p>
5975 </li>
5976 <li>
5977 <p>Change gyro headings in .csv files from x/y/z to
5978 roll/pitch/yaw</p>
5979 </li>
5980 <li>
5981 <p>Add documentation about Packet Link mode</p>
5982 </li>
5983 <li>
5984 <p>Add documentation about forcing TeleMini RF parameters to
5985 known values.</p>
5986 </li>
5987 <li>
5988 <p>Create a proxy server for Google Maps to re-enable map
5989 images</p>
5990 </li>
5991 <li>
5992 <p>Fix Java version info in all distributed jar files so that
5993 applications will run with standard Mac OS X Java.</p>
5994 </li>
5995 <li>
5996 <p>Replace JavaApplicationStub for Mac OS X so that
5997 applications will run with Oracle Java.</p>
5998 </li>
5999 </ul>
6000 </div>
6001 <div style="page-break-after: always;"></div>
6002 </div>
6003 </div>
6004 <div class="sect2">
6005 <h3 id="_release_notes_for_version_1_8_6">F.7. Release Notes for Version 1.8.6</h3>
6006 <div class="paragraph">
6007 <p>Version 1.8.6</p>
6008 </div>
6009 <div class="sect3">
6010 <h4 id="_altos_7">F.7.1. AltOS</h4>
6011 <div class="ulist">
6012 <ul>
6013 <li>
6014 <p>Use maximum of 64 previous tilt values in pyro tilt tests</p>
6015 </li>
6016 <li>
6017 <p>Eliminate 100m height requirement for coast detection</p>
6018 </li>
6019 <li>
6020 <p>Change After Motor pyro check to be &gt;= instead of ==</p>
6021 </li>
6022 <li>
6023 <p>Change Time since Boost to be Time since launch.</p>
6024 </li>
6025 </ul>
6026 </div>
6027 </div>
6028 <div class="sect3">
6029 <h4 id="_altosui_telegps">F.7.2. AltosUI, TeleGPS</h4>
6030 <div class="ulist">
6031 <ul>
6032 <li>
6033 <p>Clarify pyro test phrasing</p>
6034 </li>
6035 <li>
6036 <p>Remove ascending/descending from pyro config UI</p>
6037 </li>
6038 <li>
6039 <p>Fix accel calibration in Antenna Down mode</p>
6040 </li>
6041 <li>
6042 <p>Add mag sensor reporting for TeleMega v3 idle monitoring.</p>
6043 </li>
6044 <li>
6045 <p>Fix radio parameter saving at 2400 bps telmetry rate.</p>
6046 </li>
6047 </ul>
6048 </div>
6049 </div>
6050 <div class="sect3">
6051 <h4 id="_micropeak">F.7.3. MicroPeak</h4>
6052 <div class="ulist">
6053 <ul>
6054 <li>
6055 <p>Report altimeter-recorded maximum height value</p>
6056 </li>
6057 </ul>
6058 </div>
6059 <div style="page-break-after: always;"></div>
6060 </div>
6061 </div>
6062 <div class="sect2">
6063 <h3 id="_release_notes_for_version_1_8_5">F.8. Release Notes for Version 1.8.5</h3>
6064 <div class="paragraph">
6065 <p>Version 1.8.5 includes fixes to the ground software support
6066 for TeleBT v4, along with a few other minor updates.</p>
6067 </div>
6068 <div class="sect3">
6069 <h4 id="_altos_8">F.8.1. AltOS</h4>
6070 <div class="ulist">
6071 <ul>
6072 <li>
6073 <p>Fix startup beeps that indicate sensor failures.</p>
6074 </li>
6075 </ul>
6076 </div>
6077 </div>
6078 <div class="sect3">
6079 <h4 id="_altosui_telegps_2">F.8.2. AltosUI, TeleGPS</h4>
6080 <div class="ulist">
6081 <ul>
6082 <li>
6083 <p>When updating device firmware, make sure selected firmware
6084 matches target device.</p>
6085 </li>
6086 <li>
6087 <p>Correct Bluetooth device matching when looking for TeleBT
6088 devices.</p>
6089 </li>
6090 </ul>
6091 </div>
6092 <div style="page-break-after: always;"></div>
6093 </div>
6094 </div>
6095 <div class="sect2">
6096 <h3 id="_release_notes_for_version_1_8_4">F.9. Release Notes for Version 1.8.4</h3>
6097 <div class="paragraph">
6098 <p>Version 1.8.4 includes support for EasyMini version 2.0</p>
6099 </div>
6100 <div class="sect3">
6101 <h4 id="_altos_9">F.9.1. AltOS</h4>
6102 <div class="ulist">
6103 <ul>
6104 <li>
6105 <p>Support for EasyMini version 2.0 hardware.</p>
6106 </li>
6107 </ul>
6108 </div>
6109 <div style="page-break-after: always;"></div>
6110 </div>
6111 </div>
6112 <div class="sect2">
6113 <h3 id="_release_notes_for_version_1_8_3">F.10. Release Notes for Version 1.8.3</h3>
6114 <div class="paragraph">
6115 <p>Version 1.8.3 includes support for TeleMega version 3.0 along
6116 with two important flight computer fixes. This version also
6117 changes KML export data to make Tripoli Record reporting
6118 better and some updates to graph presentation and data
6119 downloading.</p>
6120 </div>
6121 <div class="sect3">
6122 <h4 id="_altos_10">F.10.1. AltOS</h4>
6123 <div class="sect4">
6124 <h5 id="_altos_new_features">AltOS New Features</h5>
6125 <div class="ulist">
6126 <ul>
6127 <li>
6128 <p>Support for TeleMega version 3.0 hardware.</p>
6129 </li>
6130 </ul>
6131 </div>
6132 </div>
6133 <div class="sect4">
6134 <h5 id="_altos_bug_fixes">AltOS Bug Fixes</h5>
6135 <div class="ulist">
6136 <ul>
6137 <li>
6138 <p>Ground testing EasyMega and TeleMega additional pyro
6139 channels could result in a sticky 'fired' status which would
6140 prevent these channels from firing on future flights.</p>
6141 </li>
6142 <li>
6143 <p>Corrupted flight log records could prevent future flights
6144 from capturing log data.</p>
6145 </li>
6146 <li>
6147 <p>Fixed saving of pyro configuration that ended with
6148 'Descending'.</p>
6149 </li>
6150 </ul>
6151 </div>
6152 </div>
6153 </div>
6154 <div class="sect3">
6155 <h4 id="_altosui_and_telegps_applications">F.10.2. AltosUI and TeleGPS Applications</h4>
6156 <div class="sect4">
6157 <h5 id="_altosui_new_features">AltosUI New Features</h5>
6158 <div class="ulist">
6159 <ul>
6160 <li>
6161 <p>Support for TeleMega version 3.0.</p>
6162 </li>
6163 <li>
6164 <p>Graph lines have improved appearance to make them easier to
6165 distinguish. Markers may be placed at data points to show
6166 captured recorded data values.</p>
6167 </li>
6168 <li>
6169 <p>Graphing offers the ability to adjust the smoothing of
6170 computed speed and acceleration data.</p>
6171 </li>
6172 <li>
6173 <p>The download dialog now offers to graph new flights, checks
6174 for existing files to avoid overwriting data and reports if
6175 there are checksum errors in the downloaded data.</p>
6176 </li>
6177 </ul>
6178 </div>
6179 </div>
6180 <div class="sect4">
6181 <h5 id="_altosuitelegps_bug_fixes">AltosUI/TeleGPS Bug Fixes</h5>
6182 <div class="ulist">
6183 <ul>
6184 <li>
6185 <p>Restore TeleGPS tracking behavior.</p>
6186 </li>
6187 <li>
6188 <p>Display flight computer call sign and serial number in
6189 Monitor Idle mode instead of ground station values.</p>
6190 </li>
6191 </ul>
6192 </div>
6193 </div>
6194 <div class="sect4">
6195 <h5 id="_altosui_and_telegps_changes">AltosUI and TeleGPS Changes</h5>
6196 <div class="ulist">
6197 <ul>
6198 <li>
6199 <p>KML export now reports both barometric and GPS altitude data
6200 to make it more useful for Tripoli record reporting.</p>
6201 </li>
6202 <li>
6203 <p>CSV export now includes TeleMega/EasyMega pyro voltages and
6204 tilt angle.</p>
6205 </li>
6206 </ul>
6207 </div>
6208 <div style="page-break-after: always;"></div>
6209 </div>
6210 </div>
6211 </div>
6212 <div class="sect2">
6213 <h3 id="_release_notes_for_version_1_8_2">F.11. Release Notes for Version 1.8.2</h3>
6214 <div class="paragraph">
6215 <p>Version 1.8.2 includes support for TeleGPS version 2.0 along
6216 with accelerometer recalibration support in AltosUI.</p>
6217 </div>
6218 <div class="paragraph">
6219 <p>1.8.2 also contains a couple of minor fixes for AltosUI when
6220 analyzing saved data files.</p>
6221 </div>
6222 <div class="sect3">
6223 <h4 id="_altos_11">F.11.1. AltOS</h4>
6224 <div class="paragraph">
6225 <p>AltOS New Features</p>
6226 </div>
6227 <div class="ulist">
6228 <ul>
6229 <li>
6230 <p>Support for TeleGPS version 2.0 hardware.</p>
6231 </li>
6232 </ul>
6233 </div>
6234 </div>
6235 <div class="sect3">
6236 <h4 id="_altosui_and_telegps_applications_2">F.11.2. AltosUI and TeleGPS Applications</h4>
6237 <div class="paragraph">
6238 <p>AltosUI and TeleGPS New Features</p>
6239 </div>
6240 <div class="ulist">
6241 <ul>
6242 <li>
6243 <p>Support for TeleGPS version 2.0.</p>
6244 </li>
6245 <li>
6246 <p>Accelerometer re-calibration user interface.</p>
6247 </li>
6248 </ul>
6249 </div>
6250 <div class="paragraph">
6251 <p>AltosUI and TeleGPS Bug Fixes</p>
6252 </div>
6253 <div class="ulist">
6254 <ul>
6255 <li>
6256 <p>Prevent some crashes when reading older saved flight data
6257 for graphing or KML export.</p>
6258 </li>
6259 </ul>
6260 </div>
6261 <div style="page-break-after: always;"></div>
6262 </div>
6263 </div>
6264 <div class="sect2">
6265 <h3 id="_release_notes_for_version_1_8_1">F.12. Release Notes for Version 1.8.1</h3>
6266 <div class="paragraph">
6267 <p>Version 1.8.1 includes an important bug fix for Apogee Lockout
6268 operation in all flight computers. Anyone using this option
6269 must update firmware.</p>
6270 </div>
6271 <div class="paragraph">
6272 <p>This release also contains a change in how flight computers
6273 with accelerometers deal with speeds around and above Mach
6274 1. In previous versions, the flight computer would completely
6275 disregard the barometric sensor above 330m/s (around Mach
6276 1). Now, the data from the barometric sensor is reduced in
6277 effect without ever going away entirely. This prevents early
6278 drogue deployment for flights which spend considerable time
6279 above Mach 1.</p>
6280 </div>
6281 <div class="paragraph">
6282 <p>1.8.1 also contains a couple of minor fixes for AltosUI when
6283 analyzing saved data files.</p>
6284 </div>
6285 <div class="sect3">
6286 <h4 id="_altos_12">F.12.1. AltOS</h4>
6287 <div class="paragraph">
6288 <p>AltOS Bug Fixes</p>
6289 </div>
6290 <div class="ulist">
6291 <ul>
6292 <li>
6293 <p>Handle time value wrapping in Apogee Lockout
6294 correctly. Without this, apogee lockout would sometimes
6295 prevent any drogue charge from firing.</p>
6296 </li>
6297 <li>
6298 <p>Change Kalman filter on flight computers with accelerometer
6299 to continue using the barometric sensor even at high speeds
6300 to avoid unintentional drogue deployment during
6301 deceleration.</p>
6302 </li>
6303 </ul>
6304 </div>
6305 </div>
6306 <div class="sect3">
6307 <h4 id="_altosui_and_telegps_applications_3">F.12.2. AltosUI and TeleGPS Applications</h4>
6308 <div class="paragraph">
6309 <p>AltosUI New Features</p>
6310 </div>
6311 <div class="ulist">
6312 <ul>
6313 <li>
6314 <p>Add new 'Huge' font size to make text even bigger on high
6315 resolution monitors.</p>
6316 </li>
6317 </ul>
6318 </div>
6319 <div class="paragraph">
6320 <p>AltosUI Bug Fixes</p>
6321 </div>
6322 <div class="ulist">
6323 <ul>
6324 <li>
6325 <p>Prevent some crashes when reading older saved flight data
6326 for graphing or KML export.</p>
6327 </li>
6328 <li>
6329 <p>Load frequency preference at startup. The loading code was
6330 broken, so you&#8217;d see only the default frequencies.</p>
6331 </li>
6332 </ul>
6333 </div>
6334 <div style="page-break-after: always;"></div>
6335 </div>
6336 </div>
6337 <div class="sect2">
6338 <h3 id="_release_notes_for_version_1_8">F.13. Release Notes for Version 1.8</h3>
6339 <div class="paragraph">
6340 <p>Version 1.8 includes support for our new TeleBT v4.0 ground
6341 station, updates for data analysis in our ground station
6342 software and bug fixes in in the flight software for all our
6343 boards and ground station interfaces.</p>
6344 </div>
6345 <div class="sect3">
6346 <h4 id="_altos_13">F.13.1. AltOS</h4>
6347 <div class="paragraph">
6348 <p>AltOS New Features</p>
6349 </div>
6350 <div class="ulist">
6351 <ul>
6352 <li>
6353 <p>Add support for TeleBT v4.0 boards.</p>
6354 </li>
6355 </ul>
6356 </div>
6357 </div>
6358 <div class="sect3">
6359 <h4 id="_altosui_and_telegps_applications_4">F.13.2. AltosUI and TeleGPS Applications</h4>
6360 <div class="paragraph">
6361 <p>AltosUI New Features</p>
6362 </div>
6363 <div class="ulist">
6364 <ul>
6365 <li>
6366 <p>Add support for TeleBT v4.0 hardware</p>
6367 </li>
6368 <li>
6369 <p>Rewrite graphing and export functions. This code now handles
6370 each data series separately so that graphs are drawn
6371 correctly. Smoothing now uses a filter that looks both
6372 forward and backwards in time to make computed speed and
6373 acceleration data more accurate.</p>
6374 </li>
6375 </ul>
6376 </div>
6377 <div class="paragraph">
6378 <p>AltosUI Bug Fixes</p>
6379 </div>
6380 <div class="ulist">
6381 <ul>
6382 <li>
6383 <p>Correct axis labeling of magnetic sensor in TeleMega and
6384 EasyMega. The Y and Z axes were flipped.</p>
6385 </li>
6386 </ul>
6387 </div>
6388 <div style="page-break-after: always;"></div>
6389 </div>
6390 </div>
6391 <div class="sect2">
6392 <h3 id="_release_notes_for_version_1_7">F.14. Release Notes for Version 1.7</h3>
6393 <div class="paragraph">
6394 <p>Version 1.7 includes support for our new TeleMini v3.0
6395 flight computer and bug fixes in in the flight software for all our boards
6396 and ground station interfaces.</p>
6397 </div>
6398 <div class="sect3">
6399 <h4 id="_altos_14">F.14.1. AltOS</h4>
6400 <div class="paragraph">
6401 <p>AltOS New Features</p>
6402 </div>
6403 <div class="ulist">
6404 <ul>
6405 <li>
6406 <p>Add support for TeleMini v3.0 boards.</p>
6407 </li>
6408 </ul>
6409 </div>
6410 <div class="paragraph">
6411 <p>AltOS Fixes</p>
6412 </div>
6413 <div class="ulist">
6414 <ul>
6415 <li>
6416 <p>Fix interrupt priorities on STM32L processors. Run timer
6417 interrupt at lowest priority so that device interrupts get
6418 serviced first.</p>
6419 </li>
6420 </ul>
6421 </div>
6422 </div>
6423 <div class="sect3">
6424 <h4 id="_altosui_and_telegps_applications_5">F.14.2. AltosUI and TeleGPS Applications</h4>
6425 <div class="paragraph">
6426 <p>AltosUI New Features</p>
6427 </div>
6428 <div class="ulist">
6429 <ul>
6430 <li>
6431 <p>Add support for TeleMini v3.0 hardware</p>
6432 </li>
6433 </ul>
6434 </div>
6435 <div style="page-break-after: always;"></div>
6436 </div>
6437 </div>
6438 <div class="sect2">
6439 <h3 id="_release_notes_for_version_1_6_8">F.15. Release Notes for Version 1.6.8</h3>
6440 <div class="paragraph">
6441 <p>Version 1.6.8 fixes a TeleMega and TeleMetrum v2.0 bug where
6442 the device could stop logging data and transmitting
6443 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
6444 v2.0 users should update their flight firmware.</p>
6445 </div>
6446 <div class="sect3">
6447 <h4 id="_altos_15">F.15.1. AltOS</h4>
6448 <div class="paragraph">
6449 <p>AltOS fixes:</p>
6450 </div>
6451 <div class="ulist">
6452 <ul>
6453 <li>
6454 <p>Fix STM32L DMA driver to work around STM32L SoC DMA priority
6455 issue t lock-up in the logging or radio code, either of
6456 which could stop data logging and telemetry.</p>
6457 </li>
6458 <li>
6459 <p>Avoid having TeleBT battery status values smash telemetry
6460 packet data by holding a lock during both operations.</p>
6461 </li>
6462 <li>
6463 <p>Don&#8217;t start reporting 'flight 0' when the log fills in
6464 flight.</p>
6465 </li>
6466 </ul>
6467 </div>
6468 <div class="paragraph">
6469 <p>AltOS changes:</p>
6470 </div>
6471 <div class="ulist">
6472 <ul>
6473 <li>
6474 <p>Flash LEDS on all products briefly during power up so that
6475 they can be tested during production.</p>
6476 </li>
6477 </ul>
6478 </div>
6479 </div>
6480 <div class="sect3">
6481 <h4 id="_altosui_telegps_and_altosdroid_applications">F.15.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
6482 <div class="paragraph">
6483 <p>AltosUI fixes:</p>
6484 </div>
6485 <div class="ulist">
6486 <ul>
6487 <li>
6488 <p>Re-enable go/no-go entries after they&#8217;ve been disabled due
6489 to lack of data. If telemetry information is delayed when
6490 the Ui starts up, sometimes important fields would get
6491 disabled to never re-appear.</p>
6492 </li>
6493 <li>
6494 <p>Deal with ground station failure better during Configure
6495 Ground Station operation by cleaning up pending operations.</p>
6496 </li>
6497 </ul>
6498 </div>
6499 <div style="page-break-after: always;"></div>
6500 </div>
6501 </div>
6502 <div class="sect2">
6503 <h3 id="_release_notes_for_version_1_6_5">F.16. Release Notes for Version 1.6.5</h3>
6504 <div class="paragraph">
6505 <p>Version 1.6.5 fixes a TeleMega and TeleMetrum v2.0 bug where
6506 the device would often stop logging data and transmitting
6507 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
6508 v2.0 users should update their flight firmware.</p>
6509 </div>
6510 <div class="sect3">
6511 <h4 id="_altos_16">F.16.1. AltOS</h4>
6512 <div class="paragraph">
6513 <p>AltOS fixes:</p>
6514 </div>
6515 <div class="ulist">
6516 <ul>
6517 <li>
6518 <p>Fix STM32L SPI driver to prevent lock-up in the logging or
6519 radio code, either of which could stop data logging and
6520 telemetry. Found and characterized by Chuck Haskin, who also
6521 tested the new firmware before release.</p>
6522 </li>
6523 </ul>
6524 </div>
6525 </div>
6526 <div class="sect3">
6527 <h4 id="_altosui_telegps_and_altosdroid_applications_2">F.16.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
6528 <div class="paragraph">
6529 <p>AltosUI fixes:</p>
6530 </div>
6531 <div class="ulist">
6532 <ul>
6533 <li>
6534 <p>Deliver firmward for TeleMega v2.0 and TeleBT v3.0 with
6535 Windows package.</p>
6536 </li>
6537 </ul>
6538 </div>
6539 <div style="page-break-after: always;"></div>
6540 </div>
6541 </div>
6542 <div class="sect2">
6543 <h3 id="_release_notes_for_version_1_6_4">F.17. Release Notes for Version 1.6.4</h3>
6544 <div class="paragraph">
6545 <p>Version 1.6.4 fixes a bluetooth communication problem with
6546 TeleBT v1.0 devices, along with some altosui and altosdroid
6547 minor nits. It also now ships firmware for some newer devices.</p>
6548 </div>
6549 <div class="sect3">
6550 <h4 id="_altos_17">F.17.1. AltOS</h4>
6551 <div class="paragraph">
6552 <p>AltOS fixes:</p>
6553 </div>
6554 <div class="ulist">
6555 <ul>
6556 <li>
6557 <p>Fix hardware flow control on TeleBT v1.0. Hardware RTS/CTS
6558 doesn&#8217;t seem to work, switch from using the hardware to
6559 driving these pins with software.</p>
6560 </li>
6561 <li>
6562 <p>Fix ARM USB drivers to deal with OS restarts. Needed to
6563 reset all USB-related state when the USB bus is reset. These
6564 fixes affect all STM32L, STM32F0 and LPC11U14 based devices.</p>
6565 </li>
6566 </ul>
6567 </div>
6568 </div>
6569 <div class="sect3">
6570 <h4 id="_altosui_telegps_and_altosdroid_applications_3">F.17.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
6571 <div class="paragraph">
6572 <p>AltosUI, TeleGPS and AltosDroid New Features:</p>
6573 </div>
6574 <div class="ulist">
6575 <ul>
6576 <li>
6577 <p>Automatically switch from meters or feet to kilometers or
6578 miles for distance units.</p>
6579 </li>
6580 <li>
6581 <p>Add Monitor Idle mode to TeleGPS application.</p>
6582 </li>
6583 </ul>
6584 </div>
6585 <div class="paragraph">
6586 <p>AltosUI, TeleGPS and AltosDroid Fixes:</p>
6587 </div>
6588 <div class="ulist">
6589 <ul>
6590 <li>
6591 <p>Abort map preloading when the preload map dialog is closed.</p>
6592 </li>
6593 <li>
6594 <p>In AltosDroid, Don&#8217;t reconnect to last device if the user
6595 had disconnected it the last time the application was
6596 active.</p>
6597 </li>
6598 </ul>
6599 </div>
6600 </div>
6601 <div class="sect3">
6602 <h4 id="_documentation">F.17.3. Documentation</h4>
6603 <div class="ulist">
6604 <ul>
6605 <li>
6606 <p>Mention TeleMega v2.0 in hardware specs table.</p>
6607 </li>
6608 <li>
6609 <p>Document TeleGPS RF output in telegps manual.</p>
6610 </li>
6611 </ul>
6612 </div>
6613 <div style="page-break-after: always;"></div>
6614 </div>
6615 </div>
6616 <div class="sect2">
6617 <h3 id="_release_notes_for_version_1_6_3">F.18. Release Notes for Version 1.6.3</h3>
6618 <div class="paragraph">
6619 <p>Version 1.6.3 adds idle mode to AltosDroid and has bug fixes
6620 for our host software on desktops, laptops an android devices
6621 along with BlueTooth support for Windows.</p>
6622 </div>
6623 <div class="sect3">
6624 <h4 id="_altos_18">F.18.1. AltOS</h4>
6625 <div class="paragraph">
6626 <p>AltOS fixes:</p>
6627 </div>
6628 <div class="ulist">
6629 <ul>
6630 <li>
6631 <p>Fix hardware flow control on TeleBT v3.0. RTS/CTS is
6632 wired backwards on this board, switch from using the
6633 hardware to driving these pins with software.</p>
6634 </li>
6635 </ul>
6636 </div>
6637 </div>
6638 <div class="sect3">
6639 <h4 id="_altosui_and_telegps_applications_6">F.18.2. AltosUI and TeleGPS Applications</h4>
6640 <div class="paragraph">
6641 <p>AltosUI and TeleGPS New Features:</p>
6642 </div>
6643 <div class="ulist">
6644 <ul>
6645 <li>
6646 <p>Add BlueTooth support for Windows operating system. This
6647 supports connections to TeleBT over BlueTooth rather than
6648 just USB.</p>
6649 </li>
6650 </ul>
6651 </div>
6652 <div class="paragraph">
6653 <p>AltosUI and TeleGPS Fixes:</p>
6654 </div>
6655 <div class="ulist">
6656 <ul>
6657 <li>
6658 <p>Change Java detection and install on Windows. Detection is
6659 now done by looking for the 'javaw.exe' program, and
6660 installation by opening a browser on the java.com web site.</p>
6661 </li>
6662 <li>
6663 <p>Delay polling while the Fire Igniters is visible to allow
6664 for TeleMega to report back complete status over the radio.</p>
6665 </li>
6666 <li>
6667 <p>Disallow changing RF calibration numbers in the
6668 configuration UI. There&#8217;s no good reason to change this from
6669 the field, and recovering is really hard if you haven&#8217;t
6670 written down the right number.</p>
6671 </li>
6672 <li>
6673 <p>Fix USB device discovery on Mac OS X El Capitan. This makes
6674 the connected Altus Metrum USB devices appear again.</p>
6675 </li>
6676 <li>
6677 <p>Fix acceleration data presented in MonitorIdle mode for
6678 TeleMetrum v2.0 flight computers.</p>
6679 </li>
6680 </ul>
6681 </div>
6682 </div>
6683 <div class="sect3">
6684 <h4 id="_altosdroid_3">F.18.3. AltosDroid</h4>
6685 <div class="paragraph">
6686 <p>AltosDroid new features:</p>
6687 </div>
6688 <div class="ulist">
6689 <ul>
6690 <li>
6691 <p>Monitor Idle mode. Check state of flight computer while in
6692 idle mode over the radio link</p>
6693 </li>
6694 <li>
6695 <p>Fire Igniters. Remotely fire ignires for recovery system
6696 ground tests.</p>
6697 </li>
6698 <li>
6699 <p>Remote reboot. Cause the flight computer to reboot over the
6700 radio link. This provides a method for switching the flight
6701 computer from idle to flight mode without needing to reach
6702 the power switch.</p>
6703 </li>
6704 <li>
6705 <p>Configurable frequency menu. Change the set of available
6706 frequencies and provide more descriptive names.</p>
6707 </li>
6708 </ul>
6709 </div>
6710 <div class="paragraph">
6711 <p>AltosDroid bug fixes:</p>
6712 </div>
6713 <div class="ulist">
6714 <ul>
6715 <li>
6716 <p>Don&#8217;t set target location if GPS hasn&#8217;t locked yet.</p>
6717 </li>
6718 <li>
6719 <p>Fix saving target states so they can be reloaded when the
6720 application restarts. When the application is shut down and
6721 restarted, all previous target state information will be
6722 restored (including GPS position if available).</p>
6723 </li>
6724 <li>
6725 <p>Fix crash on some Android devices for offline maps when
6726 changing the map scale or location.</p>
6727 </li>
6728 <li>
6729 <p>Don&#8217;t require USB OTG support. This kept the latest
6730 AltosDroid from being offered on devices without USB device
6731 support, although it can work without that just fine using
6732 BlueTooth.</p>
6733 </li>
6734 <li>
6735 <p>Don&#8217;t require bluetooth to be enabled. This allows the
6736 application to operate with USB devices or just show old
6737 data without turning on the bluetooth radio.</p>
6738 </li>
6739 <li>
6740 <p>Recover old tracker positions when restarting
6741 application. This finally allows you to safely stop and
6742 restart the application without losing the last known
6743 location of any tracker.</p>
6744 </li>
6745 </ul>
6746 </div>
6747 </div>
6748 <div class="sect3">
6749 <h4 id="_documentation_2">F.18.4. Documentation</h4>
6750 <div class="ulist">
6751 <ul>
6752 <li>
6753 <p>Document TeleMega and EasyMega additional pyro channel
6754 continuity audio alert pattern.</p>
6755 </li>
6756 </ul>
6757 </div>
6758 <div style="page-break-after: always;"></div>
6759 </div>
6760 </div>
6761 <div class="sect2">
6762 <h3 id="_release_notes_for_version_1_6_2">F.19. Release Notes for Version 1.6.2</h3>
6763 <div class="paragraph">
6764 <p>Version 1.6.2 includes support for our updated TeleMega v2.0
6765 product and bug fixes in in the flight software for all our boards
6766 and ground station interfaces.</p>
6767 </div>
6768 <div class="sect3">
6769 <h4 id="_altos_19">F.19.1. AltOS</h4>
6770 <div class="paragraph">
6771 <p>AltOS New Features:</p>
6772 </div>
6773 <div class="ulist">
6774 <ul>
6775 <li>
6776 <p>Add support for TeleMega v2.0 boards.</p>
6777 </li>
6778 <li>
6779 <p>Add PWM servo driver. There&#8217;s no higher level code using
6780 this yet, but the driver allows testing of the TeleMega v2.0
6781 servo output connector.</p>
6782 </li>
6783 </ul>
6784 </div>
6785 <div class="paragraph">
6786 <p>AltOS Fixes:</p>
6787 </div>
6788 <div class="ulist">
6789 <ul>
6790 <li>
6791 <p>Slow down telemetry packets to allow receiver to keep
6792 up.</p>
6793 </li>
6794 </ul>
6795 </div>
6796 </div>
6797 <div class="sect3">
6798 <h4 id="_altosui_and_telegps_applications_7">F.19.2. AltosUI and TeleGPS Applications</h4>
6799 <div class="paragraph">
6800 <p>AltosUI and TeleGPS Fixes:</p>
6801 </div>
6802 <div class="ulist">
6803 <ul>
6804 <li>
6805 <p>Fix post-flight orientation computation when processing
6806 TeleMega and EasyMega eeprom data files.</p>
6807 </li>
6808 <li>
6809 <p>Capture complete eeprom data even when there are invalid
6810 entries in the data. This keeps reading eeprom contents and
6811 writing the associated .eeprom file when an error is detected.</p>
6812 </li>
6813 </ul>
6814 </div>
6815 </div>
6816 <div class="sect3">
6817 <h4 id="_documentation_3">F.19.3. Documentation</h4>
6818 <div class="paragraph">
6819 <p>We spent a bunch of time trying to improve our documentation</p>
6820 </div>
6821 <div class="ulist">
6822 <ul>
6823 <li>
6824 <p>HTML versions now have a table of contents on the left side.</p>
6825 </li>
6826 <li>
6827 <p>EasyMini now has its own shorter manual.</p>
6828 </li>
6829 <li>
6830 <p>Provide links between sections in each document.</p>
6831 </li>
6832 <li>
6833 <p>Lots of minor rewriting and restructuring to avoid
6834 duplication of information</p>
6835 </li>
6836 </ul>
6837 </div>
6838 <div style="page-break-after: always;"></div>
6839 </div>
6840 </div>
6841 <div class="sect2">
6842 <h3 id="_release_notes_for_version_1_6_1">F.20. Release Notes for Version 1.6.1</h3>
6843 <div class="paragraph">
6844 <p>Version 1.6.1 includes support for our updated TeleBT v3.0
6845 product and bug fixes in in the flight software for all our boards
6846 and ground station interfaces.</p>
6847 </div>
6848 <div class="sect3">
6849 <h4 id="_altos_20">F.20.1. AltOS</h4>
6850 <div class="paragraph">
6851 <p>AltOS New Features:</p>
6852 </div>
6853 <div class="ulist">
6854 <ul>
6855 <li>
6856 <p>Add support for TeleBT v3.0 boards.</p>
6857 </li>
6858 <li>
6859 <p>Add support for uncompressed APRS data, providing support
6860 for older APRS receivers. Uncompressed APRS data is less
6861 precise, takes more bandwidth and doesn&#8217;t have integrated
6862 altitude data.</p>
6863 </li>
6864 </ul>
6865 </div>
6866 <div class="paragraph">
6867 <p>AltOS Fixes:</p>
6868 </div>
6869 <div class="ulist">
6870 <ul>
6871 <li>
6872 <p>Make TeleDongle and TeleBT more tolerant of data rate
6873 variations from transmitting devices.</p>
6874 </li>
6875 </ul>
6876 </div>
6877 </div>
6878 <div class="sect3">
6879 <h4 id="_altosui_and_telegps_applications_8">F.20.2. AltosUI and TeleGPS Applications</h4>
6880 <div class="paragraph">
6881 <p>AltosUI and TeleGPS New Features:</p>
6882 </div>
6883 <div class="ulist">
6884 <ul>
6885 <li>
6886 <p>Add map to Monitor Idle display. It&#8217;s nice to be able to
6887 verify that maps are working, instead of needing to use
6888 Monitor Flight.</p>
6889 </li>
6890 </ul>
6891 </div>
6892 <div class="paragraph">
6893 <p>AltosUI and TeleGPS Fixes:</p>
6894 </div>
6895 <div class="ulist">
6896 <ul>
6897 <li>
6898 <p>Fix frequency configuration to round values instead of
6899 truncate them, avoiding a common 1kHz error in the setting.</p>
6900 </li>
6901 <li>
6902 <p>Turn the Windows stub into a more useful program that can
6903 launch the application with parameters so that file manager
6904 icons work more reliably.</p>
6905 </li>
6906 <li>
6907 <p>Force KML export to use a C locale so that numbers are
6908 formatted with '.' instead of ',' for a decimal separator in
6909 non-US locales.</p>
6910 </li>
6911 <li>
6912 <p>Preload map tiles based on distance rather than number of
6913 tiles; this means you get the same resolution covering the
6914 entire area, rather than having high resolution near the
6915 center and low resolution further away.</p>
6916 </li>
6917 <li>
6918 <p>Allow configuration of frequency and callsign in Monitor
6919 Idle mode.</p>
6920 </li>
6921 <li>
6922 <p>Fix layout weirdness when resizing windows on
6923 Windows. Windows shouldn&#8217;t have giant blank spaces around
6924 the useful content anymore.</p>
6925 </li>
6926 <li>
6927 <p>Fix layout weirdness when resizing windows on
6928 Windows. Windows shouldn&#8217;t have giant blank spaces around
6929 the useful content anymore.</p>
6930 </li>
6931 <li>
6932 <p>Use a longer filter for descent speed values. This should
6933 provide something more useful on the display, although it
6934 will take longer to respond to changes now.</p>
6935 </li>
6936 <li>
6937 <p>Make Replay Flight run in realtime again. It had been set to
6938 run at 10x speed by mistake.</p>
6939 </li>
6940 </ul>
6941 </div>
6942 </div>
6943 <div class="sect3">
6944 <h4 id="_altosdroid_4">F.20.3. AltosDroid</h4>
6945 <div class="paragraph">
6946 <p>AltosDroid New Features:</p>
6947 </div>
6948 <div class="ulist">
6949 <ul>
6950 <li>
6951 <p>Add offline map support using mapping code from AltosUI.</p>
6952 </li>
6953 <li>
6954 <p>Support TeleDongle (and TeleBT via USB) on devices
6955 supporting USB On-The-Go.</p>
6956 </li>
6957 <li>
6958 <p>Display additional TeleMega pyro channel status in Pad tab.</p>
6959 </li>
6960 <li>
6961 <p>Switch between metric and imperial units.</p>
6962 </li>
6963 <li>
6964 <p>Monitor TeleBT battery voltage.</p>
6965 </li>
6966 <li>
6967 <p>Track multiple devices at the same time, selecting between
6968 them with a menu or using the map.</p>
6969 </li>
6970 <li>
6971 <p>Add hybrid, satellite and terrain map types.</p>
6972 </li>
6973 </ul>
6974 </div>
6975 <div class="paragraph">
6976 <p>AltosDroid Fixes:</p>
6977 </div>
6978 <div class="ulist">
6979 <ul>
6980 <li>
6981 <p>Use standard Android display conventions so that a menu
6982 button is available in the application title bar.</p>
6983 </li>
6984 <li>
6985 <p>Adjust layout to work on large and small screens; shrinking
6986 the go/no-go lights in smaller environments to try and make
6987 everything visible.</p>
6988 </li>
6989 <li>
6990 <p>Make voice announcements depend on current tab.</p>
6991 </li>
6992 <li>
6993 <p>Compute adjustment to current travel direction while in
6994 motion towards rocket.</p>
6995 </li>
6996 </ul>
6997 </div>
6998 <div style="page-break-after: always;"></div>
6999 </div>
7000 </div>
7001 <div class="sect2">
7002 <h3 id="_release_notes_for_version_1_6">F.21. Release Notes for Version 1.6</h3>
7003 <div class="paragraph">
7004 <p>Version 1.6 includes support for our updated TeleDongle v3.0
7005 product and bug fixes in in the flight software for all our boards
7006 and ground station interfaces.</p>
7007 </div>
7008 <div class="sect3">
7009 <h4 id="_altos_21">F.21.1. AltOS</h4>
7010 <div class="paragraph">
7011 <p>AltOS New Features</p>
7012 </div>
7013 <div class="ulist">
7014 <ul>
7015 <li>
7016 <p>Add support for TeleDongle v3.0 boards.</p>
7017 </li>
7018 </ul>
7019 </div>
7020 <div class="paragraph">
7021 <p>AltOS Fixes</p>
7022 </div>
7023 <div class="ulist">
7024 <ul>
7025 <li>
7026 <p>Don&#8217;t beep out the continuity twice by accident in idle mode.
7027 If the battery voltage report takes longer than the initialiation
7028 sequence, the igniter continuity would get reported twice.</p>
7029 </li>
7030 <li>
7031 <p>Record all 32 bits of gyro calibration data in TeleMega and
7032 EasyMega log files. This fixes computation of the gyro rates
7033 in AltosUI.</p>
7034 </li>
7035 <li>
7036 <p>Change TeleDongle LED usage. Green LED flashes when valid
7037 packet is received. Red LED flashes when invalid packet is
7038 received.</p>
7039 </li>
7040 <li>
7041 <p>Replace LPC11U14 SPI driver with non-interrupt version. The
7042 interrupt code would occasionally wedge on long transfers
7043 if interrupts were blocked for too long. This affects all
7044 released TeleGPS products; if you have a TeleGPS device,
7045 you&#8217;ll want to reflash the firmware.</p>
7046 </li>
7047 </ul>
7048 </div>
7049 </div>
7050 <div class="sect3">
7051 <h4 id="_altosui_and_telegps_applications_9">F.21.2. AltosUI and TeleGPS Applications</h4>
7052 <div class="paragraph">
7053 <p>AltosUI and TeleGPS New Features</p>
7054 </div>
7055 <div class="ulist">
7056 <ul>
7057 <li>
7058 <p>Compute tilt angle from TeleMega and EasyMega log
7059 files. This duplicates the quaternion-based angle tracking
7060 code from the flight firmware inside the ground station
7061 software so that post-flight analysis can include evaluation
7062 of the tilt angle.</p>
7063 </li>
7064 <li>
7065 <p>Shows the tool button window when starting with a data file
7066 specified. This means that opening a data file from the file
7067 manager will now bring up the main window to let you operate
7068 the whole application.</p>
7069 </li>
7070 </ul>
7071 </div>
7072 <div class="paragraph">
7073 <p>AltosUI Fixes</p>
7074 </div>
7075 <div class="ulist">
7076 <ul>
7077 <li>
7078 <p>Show the 'Connecting' dialog when using Monitor Idle. Lets
7079 you cancel the Monitor Idle startup when connecting over the
7080 radio link.</p>
7081 </li>
7082 <li>
7083 <p>Make 'Monitor Idle' work for TeleGPS devices when connected
7084 over USB. It&#8217;s nice for testing without needing to broadcast
7085 over the radio.</p>
7086 </li>
7087 <li>
7088 <p>Use different Windows API to discover USB devices. This
7089 works better on my Windows 7 box, and will be used if the
7090 older API fails to provide the necessary information.</p>
7091 </li>
7092 <li>
7093 <p>Look in more places in the registry to try and identify the
7094 installed Java version on Windows. If you install the
7095 default 32-bit version of Windows on a 64-bit OS, the Java
7096 registry information is hiding \SOFTWARE\Wow6432Node for
7097 some reason.</p>
7098 </li>
7099 <li>
7100 <p>Fix file association on Windows by searching for the
7101 javaw.exe program instead of assuming it is in
7102 %SYSTEMROOT%. This makes double-clicking on Altus Metrum
7103 data files in the file manager work correctly.</p>
7104 </li>
7105 <li>
7106 <p>When replaying a file, put 'done' in the Age field when we
7107 reach the end of the file, instead of continuing to count forever.</p>
7108 </li>
7109 <li>
7110 <p>In the Scan Channels code, wait for five seconds if we see
7111 any packet. This is needed because AltOS now sends the
7112 callsign, serial number and flight number only once every
7113 five seconds these days.</p>
7114 </li>
7115 <li>
7116 <p>In the Scan Channels code, reset pending flight state
7117 information each time we change channels. This avoids having
7118 flight computers appear on multiple frequencies by accident.</p>
7119 </li>
7120 </ul>
7121 </div>
7122 <div style="page-break-after: always;"></div>
7123 </div>
7124 </div>
7125 <div class="sect2">
7126 <h3 id="_release_notes_for_version_1_5">F.22. Release Notes for Version 1.5</h3>
7127 <div class="paragraph">
7128 <p>Version 1.5 is a major release. It includes support for our new
7129 EasyMega product, new features and bug fixes in in the flight
7130 software for all our boards and the AltosUI ground station</p>
7131 </div>
7132 <div class="sect3">
7133 <h4 id="_altos_22">F.22.1. AltOS</h4>
7134 <div class="paragraph">
7135 <p>AltOS New Features</p>
7136 </div>
7137 <div class="ulist">
7138 <ul>
7139 <li>
7140 <p>Add support for EasyMega boards.</p>
7141 </li>
7142 <li>
7143 <p>Make the APRS SSID be configurable. This lets you track
7144 different rockets on the same receiver without getting
7145 things mixed up.</p>
7146 </li>
7147 <li>
7148 <p>Report extra pyro channel continuity state on EasyMega and
7149 TeleMega via the beeper. This lets you easily verify flight
7150 readiness on these boards after powering up the electronics
7151 on the rail.</p>
7152 </li>
7153 <li>
7154 <p>Add lower telemetry data rates (2400 and 9600 bps) to
7155 increase telemetry radio range. This reduces the amount of
7156 data received as well as increasing battery consumption in
7157 the transmitter.</p>
7158 </li>
7159 <li>
7160 <p>Change TeleGPS to have only a single log, and append new
7161 data to it rather than using seperate per-flight logs. This
7162 avoids accidentally filling up log storage by turning
7163 TeleGPS on/off several times.</p>
7164 </li>
7165 </ul>
7166 </div>
7167 <div class="paragraph">
7168 <p>AltOS Fixes</p>
7169 </div>
7170 <div class="ulist">
7171 <ul>
7172 <li>
7173 <p>Increase the maximum range for altitude values from +/-32767m
7174 to +/-2147483647m, allowing the flight computers to function
7175 correctly above the 32km level.</p>
7176 </li>
7177 <li>
7178 <p>Continuously test pyro firing conditions during delay stage,
7179 inhibiting the pyro channel if the test fails. This prevents
7180 firing pyro charges where the conditions were good before
7181 the delay, but become bad before the delay expires.</p>
7182 </li>
7183 <li>
7184 <p>Allow negative numbers in pyro configuration values. This
7185 lets you specify things like descending speed or
7186 deceleration.</p>
7187 </li>
7188 </ul>
7189 </div>
7190 </div>
7191 <div class="sect3">
7192 <h4 id="_altosui_and_telegps_applications_10">F.22.2. AltosUI and TeleGPS Applications</h4>
7193 <div class="paragraph">
7194 <p>AltosUI and TeleGPS New Features</p>
7195 </div>
7196 <div class="ulist">
7197 <ul>
7198 <li>
7199 <p>Support telemetry baud rate selection. Adds menus to
7200 the flight monitoring and configuration for baud rate
7201 selection.</p>
7202 </li>
7203 <li>
7204 <p>Support APRS SSID configuration.</p>
7205 </li>
7206 <li>
7207 <p>Integrate with file managers. This provides icons for all of
7208 our file types and associates our application with the files
7209 so that using a file manager to open a AltOS data file
7210 results in launching our application.</p>
7211 </li>
7212 </ul>
7213 </div>
7214 <div class="paragraph">
7215 <p>AltosUI Fixes</p>
7216 </div>
7217 <div class="ulist">
7218 <ul>
7219 <li>
7220 <p>Make the 'Graph' button on the landed tab work again.</p>
7221 </li>
7222 <li>
7223 <p>Make tests for Java on Windows a bit smarter, and also
7224 provide the user with the option to skip installing Java for
7225 cases where we just can&#8217;t figure out what version is installed.</p>
7226 </li>
7227 </ul>
7228 </div>
7229 <div style="page-break-after: always;"></div>
7230 </div>
7231 </div>
7232 <div class="sect2">
7233 <h3 id="_release_notes_for_version_1_4_2">F.23. Release Notes for Version 1.4.2</h3>
7234 <div class="paragraph">
7235 <p>Version 1.4.2 is a minor release. It fixes Java-related install issues on
7236 Windows</p>
7237 </div>
7238 <div class="sect3">
7239 <h4 id="_altosui_and_telegps_applications_11">F.23.1. AltosUI and TeleGPS Applications</h4>
7240 <div class="paragraph">
7241 <p>Windows Install Fixes</p>
7242 </div>
7243 <div class="ulist">
7244 <ul>
7245 <li>
7246 <p>Checks for Java installation data in more registry locations.</p>
7247 </li>
7248 <li>
7249 <p>Allows user to bypass Java installation in case the
7250 detection fails.</p>
7251 </li>
7252 </ul>
7253 </div>
7254 <div style="page-break-after: always;"></div>
7255 </div>
7256 </div>
7257 <div class="sect2">
7258 <h3 id="_release_notes_for_version_1_4_1">F.24. Release Notes for Version 1.4.1</h3>
7259 <div class="paragraph">
7260 <p>Version 1.4.1 is a minor release. It fixes install issues on
7261 Windows and provides the missing TeleMetrum V2.0 firmware. There
7262 aren&#8217;t any changes to the firmware or host applications at
7263 all. All Windows users will want to upgrade to get the signed
7264 driver, but Mac and Linux users who do not need the TeleMetrum
7265 V2.0 firmware image will not need to upgrade.</p>
7266 </div>
7267 <div class="sect3">
7268 <h4 id="_altosui_and_telegps_applications_12">F.24.1. AltosUI and TeleGPS Applications:</h4>
7269 <div class="paragraph">
7270 <p>Windows Install Fixes</p>
7271 </div>
7272 <div class="ulist">
7273 <ul>
7274 <li>
7275 <p>Provide signed Windows driver files. This should avoid any need to
7276 disable driver signature checking on Windows 7 or 8.</p>
7277 </li>
7278 <li>
7279 <p>Fix Java version detection and download. Previously, the
7280 installer would only look for Java 6 or 7 and insist on
7281 downloading its own Java bits if there was something else
7282 installed. Furthermore, the 64-bit Java link provided didn&#8217;t
7283 work for anyone other than Keith, making it impossible to
7284 install AltOS on any machine with Java SE 8 installed.</p>
7285 </li>
7286 </ul>
7287 </div>
7288 <div class="paragraph">
7289 <p>Other Fixes</p>
7290 </div>
7291 <div class="ulist">
7292 <ul>
7293 <li>
7294 <p>Include 1.4 firmware for TeleMetrum V2.0. None of the
7295 installers shipped this file. Now it&#8217;s included in the AltOS
7296 packages for Linux, Mac and Windows.</p>
7297 </li>
7298 <li>
7299 <p>Include Google Application Key for map downloading. The 1.4
7300 release didn&#8217;t have this key in the released version of the
7301 software, making map downloading fail for most people.</p>
7302 </li>
7303 </ul>
7304 </div>
7305 <div style="page-break-after: always;"></div>
7306 </div>
7307 </div>
7308 <div class="sect2">
7309 <h3 id="_release_notes_for_version_1_4">F.25. Release Notes for Version 1.4</h3>
7310 <div class="paragraph">
7311 <p>Version 1.4 is a major release. It includes support for our new
7312 TeleGPS product, new features and bug fixes in in the flight
7313 software for all our boards and the AltosUI ground station</p>
7314 </div>
7315 <div class="sect3">
7316 <h4 id="_altos_23">F.25.1. AltOS</h4>
7317 <div class="paragraph">
7318 <p>AltOS new features:</p>
7319 </div>
7320 <div class="ulist">
7321 <ul>
7322 <li>
7323 <p>Add support for TeleGPS boards.</p>
7324 </li>
7325 <li>
7326 <p>Make the beeper tone configurable, making it
7327 possible to distinguish between two Altus Metrum
7328 products in the same ebay.</p>
7329 </li>
7330 <li>
7331 <p>Make the firing time for extra pyro channels
7332 configurable, allowing longer (or shorter) than the
7333 default 50ms.  Only relevant for TeleMega at this
7334 time.</p>
7335 </li>
7336 </ul>
7337 </div>
7338 <div class="paragraph">
7339 <p>AltOS fixes:</p>
7340 </div>
7341 <div class="ulist">
7342 <ul>
7343 <li>
7344 <p>Replace the 'dit dit dit' tones at startup with the
7345 current battery voltage, measured in tenths of a
7346 volt. This lets you check the battery voltage
7347 without needing telemetry, which is especially
7348 useful on EasyMini.</p>
7349 </li>
7350 <li>
7351 <p>Change state beeping to "Farnsworth spacing", which
7352 means they&#8217;re quite a bit faster than before, and so
7353 they take less time to send.</p>
7354 </li>
7355 <li>
7356 <p>Fix bug preventing the selection of the 'Flight
7357 State After' mode in pyro configuration.</p>
7358 </li>
7359 <li>
7360 <p>Fix bug where erasing flights would reset the flight
7361 number to 2 on TeleMega and TeleMetrum v2.</p>
7362 </li>
7363 <li>
7364 <p>Fix u-Blox GPS driver to mark course and speed data
7365 as being present.</p>
7366 </li>
7367 </ul>
7368 </div>
7369 </div>
7370 <div class="sect3">
7371 <h4 id="_altosui_application">F.25.2. AltosUI Application</h4>
7372 <div class="paragraph">
7373 <p>AltosUI new features:</p>
7374 </div>
7375 <div class="ulist">
7376 <ul>
7377 <li>
7378 <p>Add zooming and new content types (terrain and road
7379 maps) to map view. Change map storage format from
7380 PNG to Jpeg, which saves a huge amount of disk
7381 space. You will need to re-download all of your
7382 pre-loaded map images.</p>
7383 </li>
7384 <li>
7385 <p>Add a distance measuring device to the maps
7386 view. Select this by using any button other than the
7387 left one, or by pressing shift or control on the
7388 keyboard while using the left button.</p>
7389 </li>
7390 <li>
7391 <p>Add new 'Ignitor' tab to the flight monitor display
7392 for TeleMega&#8217;s extra ignitors.</p>
7393 </li>
7394 <li>
7395 <p>Add additional ignitor firing marks and voltages to
7396 the graph so you can see when the ignitors fired,
7397 along with the ignitor voltages.</p>
7398 </li>
7399 <li>
7400 <p>Add GPS course, ground speed and climb rate as
7401 optional graph elements.</p>
7402 </li>
7403 </ul>
7404 </div>
7405 <div class="paragraph">
7406 <p>AltosUI fixes:</p>
7407 </div>
7408 <div class="ulist">
7409 <ul>
7410 <li>
7411 <p>When flashing new firmware, re-try opening the
7412 device as sometimes it takes a while for the
7413 underlying operating system to recognize that the
7414 device has rebooted in preparation for the flashing
7415 operation.</p>
7416 </li>
7417 <li>
7418 <p>Hide Tilt Angle in ascent tab for devices that don&#8217;t
7419 have a gyro.</p>
7420 </li>
7421 <li>
7422 <p>Increase the width of data lines in the graphs to
7423 make them easier to read.</p>
7424 </li>
7425 <li>
7426 <p>Filter out speed and acceleration spikes caused by
7427 ejection charge firing when computing the maximum
7428 values. This provides a more accurate reading of
7429 those maximums.</p>
7430 </li>
7431 <li>
7432 <p>Fix EasyMini voltage displays. Early EasyMini
7433 prototypes used a 3.0V regulator, and AltosUI still
7434 used that value as the basis of the
7435 computation. Production EasyMini boards have always
7436 shipped with a 3.3V regulator. Also, purple EasyMini
7437 boards sensed the battery voltage past the blocking
7438 diode, resulting in a drop of about 150mV from the
7439 true battery voltage. Compensate for that when
7440 displaying the value.</p>
7441 </li>
7442 <li>
7443 <p>Display error message when trying to configure
7444 maximum flight log size while the flight computer
7445 still has flight data stored.</p>
7446 </li>
7447 <li>
7448 <p>Handle TeleMetrum and TeleMini eeprom files
7449 generated with pre-1.0 firmware. Those ancient
7450 versions didn&#8217;t report the log format, so just use
7451 the product name instead.</p>
7452 </li>
7453 </ul>
7454 </div>
7455 </div>
7456 <div class="sect3">
7457 <h4 id="_telegps_application">F.25.3. TeleGPS Application</h4>
7458 <div class="ulist">
7459 <ul>
7460 <li>
7461 <p>New application designed for use with TeleGPS boards.</p>
7462 </li>
7463 <li>
7464 <p>Shares code with AltosUI, mostly just trimmed down
7465 to focus on TeleGPS-related functions.</p>
7466 </li>
7467 </ul>
7468 </div>
7469 </div>
7470 <div class="sect3">
7471 <h4 id="_documentation_4">F.25.4. Documentation</h4>
7472 <div class="paragraph">
7473 <p>Documentation changes:</p>
7474 </div>
7475 <div class="ulist">
7476 <ul>
7477 <li>
7478 <p>Re-create the drill template images; they should
7479 print correctly from Firefox at least. Ship these as
7480 individual PDF files so they&#8217;re easy to print.</p>
7481 </li>
7482 <li>
7483 <p>Add a description of the 'Apogee Lockout' setting,
7484 which prevents the apogee charge from firing for a
7485 configurable amount of time after boost.</p>
7486 </li>
7487 </ul>
7488 </div>
7489 <div style="page-break-after: always;"></div>
7490 </div>
7491 </div>
7492 <div class="sect2">
7493 <h3 id="_release_notes_for_version_1_3_2">F.26. Release Notes for Version 1.3.2</h3>
7494 <div class="paragraph">
7495 <p>Version 1.3.2 is a minor release. It includes small bug fixes for
7496 the TeleMega flight software and AltosUI ground station</p>
7497 </div>
7498 <div class="sect3">
7499 <h4 id="_altos_24">F.26.1. AltOS</h4>
7500 <div class="paragraph">
7501 <p>AltOS fixes:</p>
7502 </div>
7503 <div class="ulist">
7504 <ul>
7505 <li>
7506 <p>On TeleMega, limit number of logged GPS status
7507 information to 12 satellites. That&#8217;s all there is
7508 room for in the log structure.</p>
7509 </li>
7510 <li>
7511 <p>Improve APRS behavior. Remembers last known GPS
7512 position and keeps sending that if we lose GPS
7513 lock. Marks locked/unlocked by sending L/U in the
7514 APRS comment field along with the number of sats in
7515 view and voltages.</p>
7516 </li>
7517 </ul>
7518 </div>
7519 </div>
7520 <div class="sect3">
7521 <h4 id="_altosui_application_2">F.26.2. AltosUI Application</h4>
7522 <div class="paragraph">
7523 <p>AltosUI fixes:</p>
7524 </div>
7525 <div class="ulist">
7526 <ul>
7527 <li>
7528 <p>If the TeleMega flight firmware reports that it has
7529 logged information about more than 12 satellites,
7530 don&#8217;t believe it as the log only holds 12 satellite
7531 records.</p>
7532 </li>
7533 <li>
7534 <p>Track the maximum height as computed from GPS
7535 altitude data and report that in the flight summary
7536 data.</p>
7537 </li>
7538 <li>
7539 <p>Use letters (A, B, C, D) for alternate pyro channel
7540 names instead of numbers (0, 1, 2, 3) in the Fire
7541 Igniter dialog.</p>
7542 </li>
7543 </ul>
7544 </div>
7545 <div style="page-break-after: always;"></div>
7546 </div>
7547 </div>
7548 <div class="sect2">
7549 <h3 id="_release_notes_for_version_1_3_1">F.27. Release Notes for Version 1.3.1</h3>
7550 <div class="paragraph">
7551 <p>Version 1.3.1 is a minor release. It improves support for
7552 TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini.</p>
7553 </div>
7554 <div class="sect3">
7555 <h4 id="_altos_25">F.27.1. AltOS</h4>
7556 <div class="paragraph">
7557 <p>AltOS new features:</p>
7558 </div>
7559 <div class="ulist">
7560 <ul>
7561 <li>
7562 <p>Improved APRS mode. Now uses compressed position
7563 format for smaller data size, improved precision and
7564 to include altitude data as well as latitude and
7565 longitude. Also added battery and pyro voltage
7566 reports in the APRS comment field so you can confirm
7567 that the unit is ready for launch.</p>
7568 </li>
7569 </ul>
7570 </div>
7571 <div class="paragraph">
7572 <p>AltOS fixes:</p>
7573 </div>
7574 <div class="ulist">
7575 <ul>
7576 <li>
7577 <p>Improve sensor boot code. If sensors fail to
7578 self-test, the device will still boot up and check
7579 for pad/idle modes. If in idle mode, the device will
7580 warn the user with a distinct beep, if in Pad mode,
7581 the unit will operate as best it can. Also, the
7582 Z-axis accelerometer now uses the factory
7583 calibration values instead of re-calibrating on the
7584 pad each time. This avoids accidental boost detect
7585 when moving the device around while in Pad mode.</p>
7586 </li>
7587 <li>
7588 <p>Fix antenna-down mode accelerometer
7589 configuration. Antenna down mode wasn&#8217;t working
7590 because the accelerometer calibration values were
7591 getting re-computed incorrectly in inverted mode.</p>
7592 </li>
7593 </ul>
7594 </div>
7595 </div>
7596 <div class="sect3">
7597 <h4 id="_altosui_application_3">F.27.2. AltosUI Application</h4>
7598 <div class="paragraph">
7599 <p>AltosUI new features:</p>
7600 </div>
7601 <div class="ulist">
7602 <ul>
7603 <li>
7604 <p>Display additional TeleMega sensor values in real
7605 units. Make all of these values available for
7606 plotting. Display TeleMega orientation value in the
7607 Ascent and Table tabs.</p>
7608 </li>
7609 <li>
7610 <p>Support additional TeleMega pyro channels in the
7611 Fire Igniter dialog. This lets you do remote testing
7612 of all of the channels, rather than just Apogee and
7613 Main.</p>
7614 </li>
7615 </ul>
7616 </div>
7617 <div class="paragraph">
7618 <p>AltosUI fixes:</p>
7619 </div>
7620 <div class="ulist">
7621 <ul>
7622 <li>
7623 <p>Limit data rate when downloading satellite images
7624 from Google to make sure we stay within their limits
7625 so that all of the map tiles download successfully.</p>
7626 </li>
7627 </ul>
7628 </div>
7629 <div style="page-break-after: always;"></div>
7630 </div>
7631 </div>
7632 <div class="sect2">
7633 <h3 id="_release_notes_for_version_1_3">F.28. Release Notes for Version 1.3</h3>
7634 <div class="paragraph">
7635 <p>Version 1.3 is a major release. It adds support for TeleMega,
7636 TeleMetrum v2.0, TeleMini v2.0 and EasyMini.</p>
7637 </div>
7638 <div class="sect3">
7639 <h4 id="_altos_26">F.28.1. AltOS</h4>
7640 <div class="paragraph">
7641 <p>AltOS new features:</p>
7642 </div>
7643 <div class="ulist">
7644 <ul>
7645 <li>
7646 <p>Add STM32L processor support. This includes
7647 enhancements to the scheduler to support products
7648 with many threads.</p>
7649 </li>
7650 <li>
7651 <p>Add NXP LPC11U14 processor support.</p>
7652 </li>
7653 <li>
7654 <p>Support additional pyro channels. These are
7655 configurable through the UI to handle air starts,
7656 staging, additional recovery events and external
7657 devices such as cameras.</p>
7658 </li>
7659 <li>
7660 <p>Add 3-axis gyro support for orientation
7661 tracking. This integrates the gyros to compute the
7662 angle from vertical during flight, allowing the
7663 additional pyro events to be controlled by this
7664 value.</p>
7665 </li>
7666 <li>
7667 <p>Many more device drivers, including u-Blox Max 7Q
7668 GPS, Freescale MMA6555 digital single-axis
7669 accelerometer, Invensense MPU6000 3-axis
7670 accelerometer + 3 axis gyro, Honeywell HMC5883
7671 3-axis magnetic sensor and the TI CC1120 and CC115L
7672 digital FM transceivers</p>
7673 </li>
7674 </ul>
7675 </div>
7676 </div>
7677 <div class="sect3">
7678 <h4 id="_altosui_application_4">F.28.2. AltosUI Application</h4>
7679 <div class="paragraph">
7680 <p>AltosUI new features:</p>
7681 </div>
7682 <div class="ulist">
7683 <ul>
7684 <li>
7685 <p>Support TeleMega, TeleMetrum v2.0, TeleMini v2.0 and
7686 EasyMini telemetry and log formats.</p>
7687 </li>
7688 </ul>
7689 </div>
7690 <div class="paragraph">
7691 <p>AltosUI fixes:</p>
7692 </div>
7693 <div class="ulist">
7694 <ul>
7695 <li>
7696 <p>Use preferred units for main deployment height
7697 configuration, instead of always doing configuration in
7698 meters.
7699 == MicroPeak Application</p>
7700 </li>
7701 <li>
7702 <p>Add 'Download' button to menu bar.</p>
7703 </li>
7704 <li>
7705 <p>Save the last log directory and offer that as the
7706 default for new downloads</p>
7707 </li>
7708 </ul>
7709 </div>
7710 <div style="page-break-after: always;"></div>
7711 </div>
7712 </div>
7713 <div class="sect2">
7714 <h3 id="_release_notes_for_version_1_2_1">F.29. Release Notes for Version 1.2.1</h3>
7715 <div class="paragraph">
7716 <p>Version 1.2.1 is a minor release. It adds support for TeleBT and
7717 the AltosDroid application, provides several new features in
7718 AltosUI and fixes some bugs in the AltOS firmware.</p>
7719 </div>
7720 <div class="sect3">
7721 <h4 id="_altos_27">F.29.1. AltOS</h4>
7722 <div class="paragraph">
7723 <p>AltOS new features:</p>
7724 </div>
7725 <div class="ulist">
7726 <ul>
7727 <li>
7728 <p>Add support for TeleBT</p>
7729 </li>
7730 </ul>
7731 </div>
7732 <div class="paragraph">
7733 <p>AltOS fixes:</p>
7734 </div>
7735 <div class="ulist">
7736 <ul>
7737 <li>
7738 <p>In TeleMini recovery mode (when booted with the
7739 outer two debug pins connected together), the radio
7740 parameters are also set back to defaults
7741 (434.550MHz, N0CALL, factory radio cal).</p>
7742 </li>
7743 <li>
7744 <p>Correct Kalman filter model error covariance
7745 matrix. The values used previously assumed
7746 continuous measurements instead of discrete
7747 measurements.</p>
7748 </li>
7749 <li>
7750 <p>Fix some bugs in the USB driver for TeleMetrum and
7751 TeleDongle that affected Windows users.</p>
7752 </li>
7753 <li>
7754 <p>Adjusted the automatic gain control parameters that
7755 affect receive performance for TeleDongle. Field
7756 tests indicate that this may improve receive
7757 performance somewhat.</p>
7758 </li>
7759 </ul>
7760 </div>
7761 </div>
7762 <div class="sect3">
7763 <h4 id="_altosui_application_5">F.29.2. AltosUI Application</h4>
7764 <div class="paragraph">
7765 <p>AltosUI application new features:</p>
7766 </div>
7767 <div class="ulist">
7768 <ul>
7769 <li>
7770 <p>Make the initial position of the AltosUI top level
7771 window configurable. Along with this change, the
7772 other windows will pop up at 'sensible' places now,
7773 instead of on top of one another.</p>
7774 </li>
7775 <li>
7776 <p>Add GPS data and a map to the graph window. This
7777 lets you see a complete summary of the flight
7778 without needing to 'replay' the whole thing.</p>
7779 </li>
7780 </ul>
7781 </div>
7782 <div class="paragraph">
7783 <p>AltosUI application fixes:</p>
7784 </div>
7785 <div class="ulist">
7786 <ul>
7787 <li>
7788 <p>Handle missing GPS lock in 'Descent'
7789 tab. Previously, if the GPS position of the pad was
7790 unknown, an exception would be raised, breaking the
7791 Descent tab contents.</p>
7792 </li>
7793 <li>
7794 <p>Improve the graph, adding tool-tips to show values
7795 near the cursor and making the displayed set of
7796 values configurable, adding all of the flight data
7797 as options while leaving the default settings alone
7798 so that the graph starts by showing height, speed
7799 and acceleration.</p>
7800 </li>
7801 <li>
7802 <p>Add callsign to Monitor idle window and connecting
7803 dialogs. This makes it clear which callsign is being
7804 used so that the operator will be aware that it must
7805 match the flight computer value or no communication
7806 will work.</p>
7807 </li>
7808 <li>
7809 <p>When downloading flight data, display the block
7810 number so that the user has some sense of
7811 progress. Unfortunately, we don&#8217;t know how many
7812 blocks will need to be downloaded, but at least it
7813 isn&#8217;t just sitting there doing nothing for a long
7814 time.</p>
7815 </li>
7816 </ul>
7817 </div>
7818 </div>
7819 <div class="sect3">
7820 <h4 id="_altosdroid_5">F.29.3. AltosDroid</h4>
7821 <div class="ulist">
7822 <ul>
7823 <li>
7824 <p>First version of this application</p>
7825 </li>
7826 </ul>
7827 </div>
7828 <div style="page-break-after: always;"></div>
7829 </div>
7830 </div>
7831 <div class="sect2">
7832 <h3 id="_release_notes_for_version_1_2">F.30. Release Notes for Version 1.2</h3>
7833 <div class="paragraph">
7834 <p>Version 1.2 is a major release. It adds support for MicroPeak
7835 and the MicroPeak USB adapter.</p>
7836 </div>
7837 <div class="sect3">
7838 <h4 id="_altos_28">F.30.1. AltOS</h4>
7839 <div class="paragraph">
7840 <p>AltOS New Features:</p>
7841 </div>
7842 <div class="ulist">
7843 <ul>
7844 <li>
7845 <p>Add MicroPeak support. This includes support for the
7846 ATtiny85 processor and adaptations to the core code
7847 to allow for devices too small to run the
7848 multi-tasking scheduler.</p>
7849 </li>
7850 </ul>
7851 </div>
7852 </div>
7853 <div class="sect3">
7854 <h4 id="_altosui_and_micropeak_application">F.30.2. AltosUI and MicroPeak Application</h4>
7855 <div class="paragraph">
7856 <p>New Features:</p>
7857 </div>
7858 <div class="ulist">
7859 <ul>
7860 <li>
7861 <p>Added MicroPeak application</p>
7862 </li>
7863 </ul>
7864 </div>
7865 <div class="paragraph">
7866 <p>AltosUI and MicroPeak fixes:</p>
7867 </div>
7868 <div class="ulist">
7869 <ul>
7870 <li>
7871 <p>Distribute Mac OS X packages in disk image ('.dmg')
7872 format to greatly simplify installation.</p>
7873 </li>
7874 <li>
7875 <p>Provide version numbers for the shared Java
7876 libraries to ensure that upgrades work properly, and
7877 to allow for multiple Altus Metrum software packages
7878 to be installed in the same directory at the same
7879 time.</p>
7880 </li>
7881 </ul>
7882 </div>
7883 <div style="page-break-after: always;"></div>
7884 </div>
7885 </div>
7886 <div class="sect2">
7887 <h3 id="_release_notes_for_version_1_1">F.31. Release Notes for Version 1.1</h3>
7888 <div class="paragraph">
7889 <p>Version 1.1.1 is a bug-fix release. It fixes a couple of bugs
7890 in AltosUI and one firmware bug that affects TeleMetrum
7891 version 1.0 boards. Thanks to Bob Brown for help diagnosing
7892 the Google Earth file export issue, and for suggesting the
7893 addition of the Ground Distance value in the Descent tab.</p>
7894 </div>
7895 <div class="sect3">
7896 <h4 id="_altos_29">F.31.1. AltOS</h4>
7897 <div class="paragraph">
7898 <p>AltOS fixes:</p>
7899 </div>
7900 <div class="ulist">
7901 <ul>
7902 <li>
7903 <p>TeleMetrum v1.0 boards use the AT45DB081D flash
7904 memory part to store flight data, which is different
7905 from later TeleMetrum boards. The AltOS v1.1 driver
7906 for this chip couldn&#8217;t erase memory, leaving it
7907 impossible to delete flight data or update
7908 configuration values. This bug doesn&#8217;t affect newer
7909 TeleMetrum boards, and it doesn&#8217;t affect the safety
7910 of rockets flying version 1.1 firmware.</p>
7911 </li>
7912 </ul>
7913 </div>
7914 </div>
7915 <div class="sect3">
7916 <h4 id="_altosui_3">F.31.2. AltosUI</h4>
7917 <div class="paragraph">
7918 <p>AltosUI new features:</p>
7919 </div>
7920 <div class="ulist">
7921 <ul>
7922 <li>
7923 <p>The “Descent” tab displays the range to the rocket,
7924 which is a combination of the over-the-ground
7925 distance to the rockets current latitude/longitude
7926 and the height of the rocket. As such, it&#8217;s useful
7927 for knowing how far away the rocket is, but
7928 difficult to use when estimating where the rocket
7929 might eventually land. A new “Ground Distance” field
7930 has been added which displays the distance to a spot
7931 right underneath the rocket.</p>
7932 </li>
7933 </ul>
7934 </div>
7935 <div class="paragraph">
7936 <p>AltosUI fixes:</p>
7937 </div>
7938 <div class="ulist">
7939 <ul>
7940 <li>
7941 <p>Creating a Google Earth file (KML) from on-board
7942 flight data (EEPROM) would generate an empty
7943 file. The code responsible for reading the EEPROM
7944 file wasn&#8217;t ever setting the GPS valid bits, and so
7945 the KML export code thought there was no GPS data in
7946 the file.</p>
7947 </li>
7948 <li>
7949 <p>The “Landed” tab was displaying all values in metric
7950 units, even when AltosUI was configured to display
7951 imperial units. Somehow I just missed this tab when
7952 doing the units stuff.</p>
7953 </li>
7954 <li>
7955 <p>Sensor data wasn&#8217;t being displayed for TeleMini
7956 flight computers in Monitor Idle mode, including
7957 things like battery voltage. The code that picked
7958 which kinds of data to fetch from the flight
7959 computer was missing a check for TeleMini when
7960 deciding whether to fetch the analog sensor data.</p>
7961 </li>
7962 </ul>
7963 </div>
7964 <div style="page-break-after: always;"></div>
7965 </div>
7966 </div>
7967 <div class="sect2">
7968 <h3 id="_release_notes_for_version_1_1_2">F.32. Release Notes for Version 1.1</h3>
7969 <div class="paragraph">
7970 <p>Version 1.1 is a minor release. It provides a few new features
7971 in AltosUI and the AltOS firmware and fixes bugs.</p>
7972 </div>
7973 <div class="sect3">
7974 <h4 id="_altos_30">F.32.1. AltOS</h4>
7975 <div class="paragraph">
7976 <p>AltOS Firmware New Features:</p>
7977 </div>
7978 <div class="ulist">
7979 <ul>
7980 <li>
7981 <p>Add apogee-lockout value. Overrides the apogee
7982 detection logic to prevent incorrect apogee charge
7983 firing.</p>
7984 </li>
7985 <li>
7986 <p>Force the radio frequency to 434.550MHz when the
7987 debug clock pin is connected to ground at boot
7988 time. This provides a way to talk to a TeleMini
7989 which is configured to some unknown frequency.</p>
7990 </li>
7991 <li>
7992 <p>Provide RSSI values for Monitor Idle mode. This
7993 makes it easy to check radio range without needing
7994 to go to flight mode.</p>
7995 </li>
7996 </ul>
7997 </div>
7998 <div class="paragraph">
7999 <p>AltOS Fixes:</p>
8000 </div>
8001 <div class="ulist">
8002 <ul>
8003 <li>
8004 <p>Fix a bug where the data reported in telemetry
8005 packets was from 320ms ago.</p>
8006 </li>
8007 <li>
8008 <p>Fix a bug which caused the old received telemetry
8009 packets to be retransmitted over the USB link when
8010 the radio was turned off and back on.</p>
8011 </li>
8012 </ul>
8013 </div>
8014 </div>
8015 <div class="sect3">
8016 <h4 id="_altosui_4">F.32.2. AltosUI</h4>
8017 <div class="paragraph">
8018 <p>AltosUI New Features:</p>
8019 </div>
8020 <div class="ulist">
8021 <ul>
8022 <li>
8023 <p>Make the look-n-feel configurable, providing a choice from
8024 the available options.</p>
8025 </li>
8026 <li>
8027 <p>Add an 'Age' element to mark how long since a
8028 telemetry packet has been received. Useful to
8029 quickly gauge whether communications with the rocket
8030 are still active.</p>
8031 </li>
8032 <li>
8033 <p>Add 'Configure Ground Station' dialog to set the
8034 radio frequency used by a particular TeleDongle
8035 without having to go through the flight monitor UI.</p>
8036 </li>
8037 <li>
8038 <p>Add configuration for the new apogee-lockout
8039 value. A menu provides a list of reasonable values,
8040 or the value can be set by hand.</p>
8041 </li>
8042 <li>
8043 <p>Add Imperial units mode to present data in feet
8044 instead of meters.</p>
8045 </li>
8046 </ul>
8047 </div>
8048 <div class="paragraph">
8049 <p>AltosUI Fixes:</p>
8050 </div>
8051 <div class="ulist">
8052 <ul>
8053 <li>
8054 <p>Fix a bug that caused GPS ready to happen too
8055 quickly. The software was using every telemetry
8056 packet to signal new GPS data, which caused GPS
8057 ready to be signalled after 10 packets instead of 10
8058 GPS updates.</p>
8059 </li>
8060 <li>
8061 <p>Fix Google Earth data export to work with recent
8062 versions. The google earth file loading code got a
8063 lot pickier, requiring some minor white space
8064 changes in the export code.</p>
8065 </li>
8066 <li>
8067 <p>Changed how flight data are downloaded. Now there&#8217;s
8068 an initial dialog asking which flights to download,
8069 and after that finishes, a second dialog comes up
8070 asking which flights to delete.</p>
8071 </li>
8072 <li>
8073 <p>Re-compute time spent in each state for the flight
8074 graph; this figures out the actual boost and landing
8075 times instead of using the conservative values
8076 provide by the flight electronics. This improves the
8077 accuracy of the boost acceleration and main descent
8078 rate computations.</p>
8079 </li>
8080 <li>
8081 <p>Make AltosUI run on Mac OS Lion. The default Java
8082 heap space was dramatically reduced for this release
8083 causing much of the UI to fail randomly. This most
8084 often affected the satellite mapping download and
8085 displays.</p>
8086 </li>
8087 <li>
8088 <p>Change how data are displayed in the 'table' tab of
8089 the flight monitoring window. This eliminates
8090 entries duplicated from the header and adds both
8091 current altitude and pad altitude, which are useful
8092 in 'Monitor Idle' mode.</p>
8093 </li>
8094 </ul>
8095 </div>
8096 <div style="page-break-after: always;"></div>
8097 </div>
8098 </div>
8099 <div class="sect2">
8100 <h3 id="_release_notes_for_version_1_0_1">F.33. Release Notes for Version 1.0.1</h3>
8101 <div class="paragraph">
8102 <p>Version 1.0.1 is a major release, adding support for the
8103 TeleMini device and lots of new AltosUI features</p>
8104 </div>
8105 <div class="sect3">
8106 <h4 id="_altos_31">F.33.1. AltOS</h4>
8107 <div class="paragraph">
8108 <p>AltOS New Features</p>
8109 </div>
8110 <div class="ulist">
8111 <ul>
8112 <li>
8113 <p>Add TeleMini v1.0 support.</p>
8114 </li>
8115 <li>
8116 <p>Support operation of TeleMetrum with the antenna pointing
8117 aft. Previous firmware versions required the antenna to be
8118 pointing upwards, now there is a configuration option
8119 allowing the antenna to point aft, to aid installation in
8120 some airframes.</p>
8121 </li>
8122 <li>
8123 <p>Ability to disable telemetry. For airframes where an antenna
8124 just isn&#8217;t possible, or where radio transmissions might
8125 cause trouble with other electronics, there&#8217;s a
8126 configuration option to disable all telemetry. Note that the
8127 board will still enable the radio link in idle mode.</p>
8128 </li>
8129 <li>
8130 <p>Arbitrary frequency selection. The radios in Altus Metrum
8131 devices can be programmed to a wide range of frequencies, so
8132 instead of limiting devices to 10 pre-selected 'channels',
8133 the new firmware allows the user to choose any frequency in
8134 the 70cm band. Note that the RF matching circuit on the
8135 boards is tuned for around 435MHz, so frequencies far from
8136 that may reduce the available range.</p>
8137 </li>
8138 </ul>
8139 </div>
8140 <div class="paragraph">
8141 <p>AltOS Fixes</p>
8142 </div>
8143 <div class="ulist">
8144 <ul>
8145 <li>
8146 <p>Change telemetry to be encoded in multiple 32-byte
8147 packets. This enables support for TeleMini and other devices
8148 without requiring further updates to the TeleDongle
8149 firmware.</p>
8150 </li>
8151 <li>
8152 <p>Kalman-filter based flight-tracking. The model based sensor
8153 fusion approach of a Kalman filter means that AltOS now
8154 computes apogee much more accurately than before, generally
8155 within a fraction of a second. In addition, this approach
8156 allows the baro-only TeleMini device to correctly identify
8157 Mach transitions, avoiding the error-prone selection of a
8158 Mach delay.</p>
8159 </li>
8160 </ul>
8161 </div>
8162 </div>
8163 <div class="sect3">
8164 <h4 id="_altosui_application_6">F.33.2. AltosUI Application</h4>
8165 <div class="paragraph">
8166 <p>AltosUI New Features</p>
8167 </div>
8168 <div class="ulist">
8169 <ul>
8170 <li>
8171 <p>Add main/apogee voltage graphs to the data
8172 plot. This provides a visual indication if the
8173 igniters fail before being fired.</p>
8174 </li>
8175 <li>
8176 <p>Scan for altimeter devices by watching the defined
8177 telemetry frequencies. This avoids the problem of
8178 remembering what frequency a device was configured
8179 to use, which is especially important with TeleMini
8180 which does not include a USB connection.</p>
8181 </li>
8182 <li>
8183 <p>Monitor altimeter state in "Idle" mode. This
8184 provides much of the information presented in the
8185 "Pad" dialog from the Monitor Flight command,
8186 monitoring the igniters, battery and GPS status
8187 withing requiring the flight computer to be armed
8188 and ready for flight.</p>
8189 </li>
8190 <li>
8191 <p>Pre-load map images from home. For those launch
8192 sites which don&#8217;t provide free Wi-Fi, this allows
8193 you to download the necessary satellite images
8194 given the location of the launch site. A list of
8195 known launch sites is maintained at altusmetrum.org
8196 which AltosUI downloads to populate a menu; if
8197 you&#8217;ve got a launch site not on that list, please
8198 send the name of it, latitude and longitude along
8199 with a link to the web site of the controlling club
8200 to the altusmetrum mailing list.</p>
8201 </li>
8202 <li>
8203 <p>Flight statistics are now displayed in the Graph
8204 data window. These include max height/speed/accel,
8205 average descent rates and a few other bits of
8206 information. The Graph Data window can now be
8207 reached from the 'Landed' tab in the Monitor Flight
8208 window so you can immediately see the results of a
8209 flight.</p>
8210 </li>
8211 </ul>
8212 </div>
8213 <div class="paragraph">
8214 <p>AltosUI Changes</p>
8215 </div>
8216 <div class="ulist">
8217 <ul>
8218 <li>
8219 <p>Wait for altimeter when using packet mode. Instead
8220 of quicly timing out when trying to initialize a
8221 packet mode configuration connection, AltosUI now
8222 waits indefinitely for the remote device to appear,
8223 providing a cancel button should the user get
8224 bored. This is necessary as the TeleMini can only be
8225 placed in "Idle" mode if AltosUI is polling it.</p>
8226 </li>
8227 </ul>
8228 </div>
8229 <div style="page-break-after: always;"></div>
8230 </div>
8231 </div>
8232 <div class="sect2">
8233 <h3 id="_release_notes_for_version_0_9_2">F.34. Release Notes for Version 0.9.2</h3>
8234 <div class="paragraph">
8235 <p>Version 0.9.2 is an AltosUI bug-fix release, with no firmware
8236 changes.</p>
8237 </div>
8238 <div class="sect3">
8239 <h4 id="_altosui_5">F.34.1. AltosUI</h4>
8240 <div class="paragraph">
8241 <p>AltosUI fixes:</p>
8242 </div>
8243 <div class="ulist">
8244 <ul>
8245 <li>
8246 <p>Fix plotting problems due to missing file in the Mac
8247 OS install image.</p>
8248 </li>
8249 <li>
8250 <p>Always read whole eeprom blocks, mark empty records
8251 invalid, display parsing errors to user.</p>
8252 </li>
8253 <li>
8254 <p>Add software version to Configure AltosUI dialog</p>
8255 </li>
8256 </ul>
8257 </div>
8258 <div style="page-break-after: always;"></div>
8259 </div>
8260 </div>
8261 <div class="sect2">
8262 <h3 id="_release_notes_for_version_0_9">F.35. Release Notes for Version 0.9</h3>
8263 <div class="paragraph">
8264 <p>Version 0.9 adds a few new firmware features and accompanying
8265 AltosUI changes, along with new hardware support.</p>
8266 </div>
8267 <div class="sect3">
8268 <h4 id="_altos_32">F.35.1. AltOS</h4>
8269 <div class="ulist">
8270 <ul>
8271 <li>
8272 <p>Support for TeleMetrum v1.1 hardware. Sources for the flash
8273 memory part used in v1.0 dried up, so v1.1 uses a different
8274 part which required a new driver and support for explicit
8275 flight log erasing.</p>
8276 </li>
8277 <li>
8278 <p>Multiple flight log support. This stores more than one
8279 flight log in the on-board flash memory. It also requires
8280 the user to explicitly erase flights so that you won&#8217;t lose
8281 flight logs just because you fly the same board twice in one
8282 day.</p>
8283 </li>
8284 <li>
8285 <p>Telemetry support for devices with serial number &gt;= 256.
8286 Previous versions used a telemetry packet format that
8287 provided only 8 bits for the device serial number. This
8288 change requires that both ends of the telemetry link be
8289 running the 0.9 firmware or they will not communicate.</p>
8290 </li>
8291 </ul>
8292 </div>
8293 </div>
8294 <div class="sect3">
8295 <h4 id="_altosui_application_7">F.35.2. AltosUI Application</h4>
8296 <div class="ulist">
8297 <ul>
8298 <li>
8299 <p>Support for telemetry format changes.</p>
8300 </li>
8301 <li>
8302 <p>Support for multiple flight logs.</p>
8303 </li>
8304 </ul>
8305 </div>
8306 <div style="page-break-after: always;"></div>
8307 </div>
8308 </div>
8309 <div class="sect2">
8310 <h3 id="_release_notes_for_version_0_8">F.36. Release Notes for Version 0.8</h3>
8311 <div class="paragraph">
8312 <p>Version 0.8 offers a major upgrade in the AltosUI
8313 interface.</p>
8314 </div>
8315 <div class="sect3">
8316 <h4 id="_altosui_application_8">F.36.1. AltosUI Application:</h4>
8317 <div class="ulist">
8318 <ul>
8319 <li>
8320 <p>Post-flight graphing tool. This lets you explore the
8321 behaviour of your rocket after flight with a scroll-able and
8322 zoom-able chart showing the altitude, speed and acceleration
8323 of the airframe along with events recorded by the flight
8324 computer. You can export graphs to PNG files, or print them
8325 directly.</p>
8326 </li>
8327 <li>
8328 <p>Real-time moving map which overlays the in-progress flight
8329 on satellite imagery fetched from Google Maps. This lets you
8330 see in pictures where your rocket has landed, allowing you
8331 to plan recovery activities more accurately.</p>
8332 </li>
8333 <li>
8334 <p>Wireless recovery system testing. Prep your rocket for
8335 flight and test fire the deployment charges to make sure
8336 things work as expected. All without threading wires through
8337 holes in your airframe.</p>
8338 </li>
8339 <li>
8340 <p>Optimized flight status displays. Each flight state now has
8341 it&#8217;s own custom 'tab' in the flight monitoring window so you
8342 can focus on the most important details. Pre-flight, the
8343 system shows a set of red/green status indicators for
8344 battery voltage, apogee/main igniter continutity and GPS
8345 reception. Wait until they&#8217;re all green and your rocket is
8346 ready for flight. There are also tabs for ascent, descent
8347 and landing along with the original tabular view of the
8348 data.</p>
8349 </li>
8350 <li>
8351 <p>Monitor multiple flights simultaneously. If you have more
8352 than one TeleDongle, you can monitor a flight with each one
8353 on the same computer.</p>
8354 </li>
8355 <li>
8356 <p>Automatic flight monitoring at startup. Plug TeleDongle into
8357 the machine before starting AltosUI and it will
8358 automatically connect to it and prepare to monitor a flight.</p>
8359 </li>
8360 <li>
8361 <p>Exports Google Earth flight tracks. Using the Keyhole Markup
8362 Language (.kml) file format, this provides a 3D view of your
8363 rocket flight through the Google Earth program.</p>
8364 </li>
8365 </ul>
8366 </div>
8367 <div style="page-break-after: always;"></div>
8368 </div>
8369 </div>
8370 <div class="sect2">
8371 <h3 id="_release_notes_for_version_0_7_1">F.37. Release Notes for Version 0.7.1</h3>
8372 <div class="paragraph">
8373 <p>Version 0.7.1 is the first release containing our new
8374 cross-platform Java-based user interface.</p>
8375 </div>
8376 <div class="sect3">
8377 <h4 id="_altosui_application_9">F.37.1. AltosUI Application</h4>
8378 <div class="ulist">
8379 <ul>
8380 <li>
8381 <p>Receive and log telemetry from a connected TeleDongle
8382 device. All data received is saved to log files named with
8383 the current date and the connected rocket serial and flight
8384 numbers. There is no mode in which telemetry data will not
8385 be saved.</p>
8386 </li>
8387 <li>
8388 <p>Download logged data from TeleMetrum devices, either through
8389 a direct USB connection or over the air through a TeleDongle
8390 device.</p>
8391 </li>
8392 <li>
8393 <p>Configure a TeleMetrum device, setting the radio channel,
8394 callsign, apogee delay and main deploy height. This can be
8395 done through either a USB connection or over a radio link
8396 via a TeleDongle device.</p>
8397 </li>
8398 <li>
8399 <p>Replay a flight in real-time. This takes a saved telemetry
8400 log or eeprom download and replays it through the user
8401 interface so you can relive your favorite rocket flights.</p>
8402 </li>
8403 <li>
8404 <p>Reprogram Altus Metrum devices. Using an Altus Metrum device
8405 connected via USB, another Altus Metrum device can be
8406 reprogrammed using the supplied programming cable between
8407 the two devices.</p>
8408 </li>
8409 <li>
8410 <p>Export Flight data to a comma-separated-values file. This
8411 takes either telemetry or on-board flight data and generates
8412 data suitable for use in external applications. All data is
8413 exported using standard units so that no device-specific
8414 knowledge is needed to handle the data.</p>
8415 </li>
8416 <li>
8417 <p>Speak to you during the flight. Instead of spending the
8418 flight hunched over your laptop looking at the screen, enjoy
8419 the view while the computer tells you what’s going on up
8420 there. During ascent, you hear the current flight state and
8421 altitude information. During descent, you get azimuth,
8422 elevation and range information to try and help you find
8423 your rocket in the air. Once on the ground, the direction
8424 and distance are reported.</p>
8425 </li>
8426 </ul>
8427 </div>
8428 </div>
8429 </div>
8430 </div>
8431 </div>
8432 </div>
8433 <div id="footer">
8434 <div id="footer-text">
8435 Version v1.9.4<br>
8436 Last updated 2020-07-02 20:34:30 -0600
8437 </div>
8438 </div>
8439 </body>
8440 </html>