git.gag.com Git - web/altusmetrum/blob - AltOS/doc/altusmetrum.html

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