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