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 <meta http-equiv="X-UA-Compatible" content="IE=edge">
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
   7 <meta name="generator" content="Asciidoctor 2.0.18">
   8 <meta name="author" content="Keith Packard, Bdale Garbee, Bob Finch, Anthony Towns">
   9 <meta name="copyright" content="Bdale Garbee and Keith Packard 2023">
  10 <title>The Altus Metrum System: An Owner&#8217;s Manual for Altus Metrum Rocketry Electronics</title>
  11 <link rel="stylesheet" href="./am.css">
  12 </head>
  13 <body class="book">
  14 <div id="header">
  15 <h1>The Altus Metrum System: An Owner&#8217;s Manual for Altus Metrum Rocketry Electronics</h1>
  16 <div class="details">
  17 <span id="author" class="author">Keith Packard</span><br>
  18 <span id="email" class="email"><a href="mailto:keithp@keithp.com">keithp@keithp.com</a></span><br>
  19 <span id="author2" class="author">Bdale Garbee</span><br>
  20 <span id="email2" class="email"><a href="mailto:bdale@gag.com">bdale@gag.com</a></span><br>
  21 <span id="author3" class="author">Bob Finch</span><br>
  22 <span id="author4" class="author">Anthony Towns</span><br>
  23 <span id="revnumber">version v1.9.13,</span>
  24 <span id="revdate">19 Jan 2023</span>
  25 </div>
  26 <div id="toc" class="toc">
  27 <div id="toctitle">Table of Contents</div>
  28 <ul class="sectlevel1">
  29 <li><a href="#_license">License</a></li>
  30 <li><a href="#_acknowledgments">Acknowledgments</a></li>
  31 <li><a href="#_introduction_and_overview">1. Introduction and Overview</a></li>
  32 <li><a href="#_getting_started">2. Getting Started</a>
  33 <ul class="sectlevel2">
  34 <li><a href="#_batteries">2.1. Batteries</a></li>
  35 <li><a href="#_ground_station_hardware">2.2. Ground Station Hardware</a></li>
  36 <li><a href="#_linuxmacwindows_ground_station_software">2.3. Linux/Mac/Windows Ground Station Software</a></li>
  37 <li><a href="#_android_ground_station_software">2.4. Android Ground Station Software</a></li>
  38 </ul>
  39 </li>
  40 <li><a href="#_using_altus_metrum_hardware">3. Using Altus Metrum Hardware</a>
  41 <ul class="sectlevel2">
  42 <li><a href="#_wiring_and_electrical_interference">3.1. Wiring and Electrical Interference</a></li>
  43 <li><a href="#_hooking_up_lithium_polymer_batteries">3.2. Hooking Up Lithium Polymer Batteries</a></li>
  44 <li><a href="#_hooking_up_pyro_charges">3.3. Hooking Up Pyro Charges</a></li>
  45 <li><a href="#_hooking_up_a_power_switch">3.4. Hooking Up a Power Switch</a></li>
  46 <li><a href="#_understanding_beeps">3.5. Understanding Beeps</a></li>
  47 <li><a href="#_turning_on_the_power">3.6. Turning On the Power</a></li>
  48 <li><a href="#_using_an_external_active_switch_circuit">3.7. Using an External Active Switch Circuit</a></li>
  49 <li><a href="#_using_a_separate_pyro_battery">3.8. Using a Separate Pyro Battery</a></li>
  50 <li><a href="#_using_a_different_kind_of_battery">3.9. Using a Different Kind of Battery</a></li>
  51 <li><a href="#_using_packet_link_mode">3.10. Using Packet Link Mode</a></li>
  52 </ul>
  53 </li>
  54 <li><a href="#_telemetrum">4. TeleMetrum</a>
  55 <ul class="sectlevel2">
  56 <li><a href="#_telemetrum_screw_terminals">4.1. TeleMetrum Screw Terminals</a></li>
  57 <li><a href="#_using_a_separate_pyro_battery_with_telemetrum">4.2. Using a Separate Pyro Battery with TeleMetrum</a></li>
  58 <li><a href="#_using_an_active_switch_with_telemetrum">4.3. Using an Active Switch with TeleMetrum</a></li>
  59 </ul>
  60 </li>
  61 <li><a href="#_telemini">5. TeleMini</a>
  62 <ul class="sectlevel2">
  63 <li><a href="#_telemini_v3_screw_terminals">5.1. TeleMini v3 Screw Terminals</a></li>
  64 <li><a href="#_using_a_separate_pyro_battery_with_telemini_v3">5.2. Using a Separate Pyro Battery with TeleMini v3</a></li>
  65 <li><a href="#_using_an_active_switch_with_telemini_v3">5.3. Using an Active Switch with TeleMini v3</a></li>
  66 <li><a href="#_using_packet_link_mode_with_telemini">5.4. Using Packet Link Mode with TeleMini</a></li>
  67 <li><a href="#_forcing_telemini_radio_parameters_to_known_defaults">5.5. Forcing TeleMini radio parameters to known defaults</a></li>
  68 <li><a href="#_telemini_v1">5.6. TeleMini v1</a></li>
  69 </ul>
  70 </li>
  71 <li><a href="#_easymini">6. EasyMini</a>
  72 <ul class="sectlevel2">
  73 <li><a href="#_easymini_screw_terminals">6.1. EasyMini Screw Terminals</a></li>
  74 <li><a href="#_connecting_a_battery_to_easymini">6.2. Connecting A Battery To EasyMini</a></li>
  75 <li><a href="#_charging_lithium_batteries">6.3. Charging Lithium Batteries</a></li>
  76 <li><a href="#_using_a_separate_pyro_battery_with_easymini">6.4. Using a Separate Pyro Battery with EasyMini</a></li>
  77 <li><a href="#_using_an_active_switch_with_easymini">6.5. Using an Active Switch with EasyMini</a></li>
  78 </ul>
  79 </li>
  80 <li><a href="#_telemega">7. TeleMega</a>
  81 <ul class="sectlevel2">
  82 <li><a href="#_telemega_screw_terminals">7.1. TeleMega Screw Terminals</a></li>
  83 <li><a href="#_using_a_separate_pyro_battery_with_telemega">7.2. Using a Separate Pyro Battery with TeleMega</a></li>
  84 <li><a href="#_using_only_one_battery_with_telemega">7.3. Using Only One Battery With TeleMega</a></li>
  85 <li><a href="#_using_an_active_switch_with_telemega">7.4. Using an Active Switch with TeleMega</a></li>
  86 </ul>
  87 </li>
  88 <li><a href="#_easymega">8. EasyMega</a>
  89 <ul class="sectlevel2">
  90 <li><a href="#_easymega_screw_terminals">8.1. EasyMega Screw Terminals</a></li>
  91 <li><a href="#_using_a_separate_pyro_battery_with_easymega">8.2. Using a Separate Pyro Battery with EasyMega</a></li>
  92 <li><a href="#_using_only_one_battery_with_easymega">8.3. Using Only One Battery With EasyMega</a></li>
  93 <li><a href="#_using_an_active_switch_with_easymega">8.4. Using an Active Switch with EasyMega</a></li>
  94 </ul>
  95 </li>
  96 <li><a href="#_easytimer">9. EasyTimer</a>
  97 <ul class="sectlevel2">
  98 <li><a href="#_easytimer_screw_terminals">9.1. EasyTimer Screw Terminals</a></li>
  99 <li><a href="#_connecting_a_battery_to_easytimer">9.2. Connecting A Battery To EasyTimer</a></li>
 100 <li><a href="#_charging_lithium_batteries_2">9.3. Charging Lithium Batteries</a></li>
 101 <li><a href="#_using_a_separate_pyro_battery_with_easytimer">9.4. Using a Separate Pyro Battery with EasyTimer</a></li>
 102 <li><a href="#_using_an_active_switch_with_easytimer">9.5. Using an Active Switch with EasyTimer</a></li>
 103 </ul>
 104 </li>
 105 <li><a href="#_installation">10. Installation</a></li>
 106 <li><a href="#_using_altus_metrum_products">11. Using Altus Metrum Products</a>
 107 <ul class="sectlevel2">
 108 <li><a href="#_being_legal">11.1. Being Legal</a></li>
 109 <li><a href="#_in_the_rocket">11.2. In the Rocket</a></li>
 110 <li><a href="#_on_the_ground">11.3. On the Ground</a></li>
 111 <li><a href="#_data_analysis">11.4. Data Analysis</a></li>
 112 <li><a href="#_future_plans">11.5. Future Plans</a></li>
 113 </ul>
 114 </li>
 115 <li><a href="#_altosui">12. AltosUI</a>
 116 <ul class="sectlevel2">
 117 <li><a href="#_monitor_flight">12.1. Monitor Flight</a></li>
 118 <li><a href="#_save_flight_data">12.2. Save Flight Data</a></li>
 119 <li><a href="#_replay_flight">12.3. Replay Flight</a></li>
 120 <li><a href="#_graph_data">12.4. Graph Data</a></li>
 121 <li><a href="#_export_data">12.5. Export Data</a></li>
 122 <li><a href="#_configure_altimeter">12.6. Configure Altimeter</a></li>
 123 <li><a href="#_configure_altosui">12.7. Configure AltosUI</a></li>
 124 <li><a href="#_configure_groundstation">12.8. Configure Groundstation</a></li>
 125 <li><a href="#_flash_image">12.9. Flash Image</a></li>
 126 <li><a href="#_fire_igniter">12.10. Fire Igniter</a></li>
 127 <li><a href="#_scan_channels">12.11. Scan Channels</a></li>
 128 <li><a href="#_load_maps">12.12. Load Maps</a></li>
 129 <li><a href="#_monitor_idle">12.13. Monitor Idle</a></li>
 130 </ul>
 131 </li>
 132 <li><a href="#_altosdroid">13. AltosDroid</a>
 133 <ul class="sectlevel2">
 134 <li><a href="#_installing_altosdroid">13.1. Installing AltosDroid</a></li>
 135 <li><a href="#_charging_telebt_battery">13.2. Charging TeleBT Battery</a></li>
 136 <li><a href="#_connecting_to_telebt_over_bluetooth">13.3. Connecting to TeleBT over Bluetooth™</a></li>
 137 <li><a href="#_connecting_to_teledongle_or_telebt_over_usb">13.4. Connecting to TeleDongle or TeleBT over USB</a></li>
 138 <li><a href="#_altosdroid_menu">13.5. AltosDroid Menu</a></li>
 139 <li><a href="#_setup">13.6. Setup</a></li>
 140 <li><a href="#_idle_mode">13.7. Idle Mode</a></li>
 141 <li><a href="#_altosdroid_flight_monitoring">13.8. AltosDroid Flight Monitoring</a></li>
 142 <li><a href="#_pad">13.9. Pad</a></li>
 143 <li><a href="#_flight">13.10. Flight</a></li>
 144 <li><a href="#_recover">13.11. Recover</a></li>
 145 <li><a href="#_map_2">13.12. Map</a></li>
 146 <li><a href="#_downloading_flight_logs">13.13. Downloading Flight Logs</a></li>
 147 </ul>
 148 </li>
 149 <li><a href="#_system_operation">Appendix A: System Operation</a>
 150 <ul class="sectlevel2">
 151 <li><a href="#_firmware_modes">A.1. Firmware Modes</a></li>
 152 <li><a href="#_gps">A.2. GPS</a></li>
 153 <li><a href="#_controlling_an_altimeter_over_the_radio_link">A.3. Controlling An Altimeter Over The Radio Link</a></li>
 154 <li><a href="#_ground_testing">A.4. Ground Testing</a></li>
 155 <li><a href="#_radio_link">A.5. Radio Link</a></li>
 156 <li><a href="#_aprs">A.6. APRS</a></li>
 157 <li><a href="#_configurable_parameters">A.7. Configurable Parameters</a></li>
 158 </ul>
 159 </li>
 160 <li><a href="#_example_pyro_channel_configurations">Appendix B: Example Pyro Channel Configurations</a>
 161 <ul class="sectlevel2">
 162 <li><a href="#_two_stage_flights">B.1. Two-Stage Flights</a></li>
 163 <li><a href="#_triggered_clusters_and_air_starts">B.2. Triggered Clusters and Air Starts</a></li>
 164 <li><a href="#_redundant_apogee">B.3. Redundant Apogee</a></li>
 165 <li><a href="#_redundant_main">B.4. Redundant Main</a></li>
 166 <li><a href="#_apogee_above_baro_sensor_limit">B.5. Apogee Above Baro Sensor Limit</a></li>
 167 </ul>
 168 </li>
 169 <li><a href="#_handling_precautions">Appendix C: Handling Precautions</a></li>
 170 <li><a href="#_updating_device_firmware">Appendix D: Updating Device Firmware</a>
 171 <ul class="sectlevel2">
 172 <li><a href="#_updating_telemega_telemetrum_v2_or_newer_telemini_v3_easymega_easymini_teledongle_v3_or_telebt_v3_firmware">D.1. Updating TeleMega, TeleMetrum v2 or newer, TeleMini v3, EasyMega, EasyMini, TeleDongle v3 or TeleBT v3 Firmware</a></li>
 173 <li><a href="#_pair_programming">D.2. Pair Programming</a></li>
 174 </ul>
 175 </li>
 176 <li><a href="#_frequency_calibration">Appendix E: Frequency Calibration</a>
 177 <ul class="sectlevel2">
 178 <li><a href="#_background_information">E.1. Background Information</a></li>
 179 <li><a href="#_required_equipment">E.2. Required Equipment</a></li>
 180 <li><a href="#_rf_calibration_procedure">E.3. RF Calibration Procedure</a></li>
 181 </ul>
 182 </li>
 183 <li><a href="#_flight_data_recording">Appendix F: Flight Data Recording</a></li>
 184 <li><a href="#_altus_metrum_hardware_specifications">Appendix G: Altus Metrum Hardware Specifications</a></li>
 185 <li><a href="#_release_notes">Appendix H: Release Notes</a>
 186 <ul class="sectlevel2">
 187 <li><a href="#_release_notes_for_version_1_9_13">H.1. Release Notes for Version 1.9.13</a></li>
 188 <li><a href="#_release_notes_for_version_1_9_12">H.2. Release Notes for Version 1.9.12</a></li>
 189 <li><a href="#_release_notes_for_version_1_9_11">H.3. Release Notes for Version 1.9.11</a></li>
 190 <li><a href="#_release_notes_for_version_1_9_10">H.4. Release Notes for Version 1.9.10</a></li>
 191 <li><a href="#_release_notes_for_version_1_9_9">H.5. Release Notes for Version 1.9.9</a></li>
 192 <li><a href="#_release_notes_for_version_1_9_8">H.6. Release Notes for Version 1.9.8</a></li>
 193 <li><a href="#_release_notes_for_version_1_9_7">H.7. Release Notes for Version 1.9.7</a></li>
 194 <li><a href="#_release_notes_for_version_1_9_6">H.8. Release Notes for Version 1.9.6</a></li>
 195 <li><a href="#_release_notes_for_version_1_9_5">H.9. Release Notes for Version 1.9.5</a></li>
 196 <li><a href="#_release_notes_for_version_1_9_4">H.10. Release Notes for Version 1.9.4</a></li>
 197 <li><a href="#_release_notes_for_version_1_9_3">H.11. Release Notes for Version 1.9.3</a></li>
 198 <li><a href="#_release_notes_for_version_1_9_2">H.12. Release Notes for Version 1.9.2</a></li>
 199 <li><a href="#_release_notes_for_version_1_9_1">H.13. Release Notes for Version 1.9.1</a></li>
 200 <li><a href="#_release_notes_for_version_1_9">H.14. Release Notes for Version 1.9</a></li>
 201 <li><a href="#_release_notes_for_version_1_8_7">H.15. Release Notes for Version 1.8.7</a></li>
 202 <li><a href="#_release_notes_for_version_1_8_6">H.16. Release Notes for Version 1.8.6</a></li>
 203 <li><a href="#_release_notes_for_version_1_8_5">H.17. Release Notes for Version 1.8.5</a></li>
 204 <li><a href="#_release_notes_for_version_1_8_4">H.18. Release Notes for Version 1.8.4</a></li>
 205 <li><a href="#_release_notes_for_version_1_8_3">H.19. Release Notes for Version 1.8.3</a></li>
 206 <li><a href="#_release_notes_for_version_1_8_2">H.20. Release Notes for Version 1.8.2</a></li>
 207 <li><a href="#_release_notes_for_version_1_8_1">H.21. Release Notes for Version 1.8.1</a></li>
 208 <li><a href="#_release_notes_for_version_1_8">H.22. Release Notes for Version 1.8</a></li>
 209 <li><a href="#_release_notes_for_version_1_7">H.23. Release Notes for Version 1.7</a></li>
 210 <li><a href="#_release_notes_for_version_1_6_8">H.24. Release Notes for Version 1.6.8</a></li>
 211 <li><a href="#_release_notes_for_version_1_6_5">H.25. Release Notes for Version 1.6.5</a></li>
 212 <li><a href="#_release_notes_for_version_1_6_4">H.26. Release Notes for Version 1.6.4</a></li>
 213 <li><a href="#_release_notes_for_version_1_6_3">H.27. Release Notes for Version 1.6.3</a></li>
 214 <li><a href="#_release_notes_for_version_1_6_2">H.28. Release Notes for Version 1.6.2</a></li>
 215 <li><a href="#_release_notes_for_version_1_6_1">H.29. Release Notes for Version 1.6.1</a></li>
 216 <li><a href="#_release_notes_for_version_1_6">H.30. Release Notes for Version 1.6</a></li>
 217 <li><a href="#_release_notes_for_version_1_5">H.31. Release Notes for Version 1.5</a></li>
 218 <li><a href="#_release_notes_for_version_1_4_2">H.32. Release Notes for Version 1.4.2</a></li>
 219 <li><a href="#_release_notes_for_version_1_4_1">H.33. Release Notes for Version 1.4.1</a></li>
 220 <li><a href="#_release_notes_for_version_1_4">H.34. Release Notes for Version 1.4</a></li>
 221 <li><a href="#_release_notes_for_version_1_3_2">H.35. Release Notes for Version 1.3.2</a></li>
 222 <li><a href="#_release_notes_for_version_1_3_1">H.36. Release Notes for Version 1.3.1</a></li>
 223 <li><a href="#_release_notes_for_version_1_3">H.37. Release Notes for Version 1.3</a></li>
 224 <li><a href="#_release_notes_for_version_1_2_1">H.38. Release Notes for Version 1.2.1</a></li>
 225 <li><a href="#_release_notes_for_version_1_2">H.39. Release Notes for Version 1.2</a></li>
 226 <li><a href="#_release_notes_for_version_1_1">H.40. Release Notes for Version 1.1</a></li>
 227 <li><a href="#_release_notes_for_version_1_1_2">H.41. Release Notes for Version 1.1</a></li>
 228 <li><a href="#_release_notes_for_version_1_0_1">H.42. Release Notes for Version 1.0.1</a></li>
 229 <li><a href="#_release_notes_for_version_0_9_2">H.43. Release Notes for Version 0.9.2</a></li>
 230 <li><a href="#_release_notes_for_version_0_9">H.44. Release Notes for Version 0.9</a></li>
 231 <li><a href="#_release_notes_for_version_0_8">H.45. Release Notes for Version 0.8</a></li>
 232 <li><a href="#_release_notes_for_version_0_7_1">H.46. Release Notes for Version 0.7.1</a></li>
 233 </ul>
 234 </li>
 235 </ul>
 236 </div>
 237 </div>
 238 <div id="content">
 239 <div id="preamble">
 240 <div class="sectionbody">
 241 <div id="logo" class="imageblock">
 242 <div class="content">
 243 <a class="image" href="https://altusmetrum.org"><img src="altusmetrum-oneline.svg" alt="Altus Metrum"></a>
 244 </div>
 245 </div>
 246 </div>
 247 </div>
 248 <div class="sect1">
 249 <h2 id="_license">License</h2>
 250 <div class="sectionbody">
 251 <div class="paragraph">
 252 <p>Copyright © 2023 Bdale Garbee and Keith Packard</p>
 253 </div>
 254 <div class="paragraph">
 255 <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>
 256 </div>
 257 </div>
 258 </div>
 259 <div class="sect1">
 260 <h2 id="_acknowledgments">Acknowledgments</h2>
 261 <div class="sectionbody">
 262 <div class="paragraph">
 263 <p>Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing “The
 264 Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter
 265 Kit” which formed the basis of the original Getting Started chapter
 266 in this manual.  Bob was one of our first customers for a production
 267 TeleMetrum, and his continued enthusiasm and contributions
 268 are immensely gratifying and highly appreciated!</p>
 269 </div>
 270 <div class="paragraph">
 271 <p>And thanks to Anthony (AJ) Towns for major contributions including
 272 the AltosUI graphing and site map code and associated documentation.
 273 Free software means that our customers and friends can become our
 274 collaborators, and we certainly appreciate this level of
 275 contribution!</p>
 276 </div>
 277 <div class="paragraph">
 278 <p>Have fun using these products, and we hope to meet all of you
 279 out on the rocket flight line somewhere.</p>
 280 </div>
 281 <div class="verseblock">
 282 <pre class="content">Bdale Garbee, KB0G
 283 NAR #87103, TRA #12201</pre>
 284 </div>
 285 <div class="verseblock">
 286 <pre class="content">Keith Packard, K7WQ
 287 NAR #88757, TRA #12200</pre>
 288 </div>
 289 </div>
 290 </div>
 291 <div class="sect1">
 292 <h2 id="_introduction_and_overview">1. Introduction and Overview</h2>
 293 <div class="sectionbody">
 294 <div class="paragraph">
 295 <p>Welcome to the Altus Metrum community!  Our circuits and software reflect
 296 our passion for both hobby rocketry and Free Software.  We hope their
 297 capabilities and performance will delight you in every way, but by
 298 releasing all of our hardware and software designs under open licenses,
 299 we also hope to empower you to take as active a role in our collective
 300 future as you wish!</p>
 301 </div>
 302 <div class="paragraph">
 303 <p>Our goal is to include in this document all of the information required
 304 to successfully configure and use Altus Metrum products.  But
 305 documentation is a lot like software in that it can contain "bugs",
 306 and can probably always be improved!  If you have questions that
 307 aren&#8217;t answered in this manual, or just need a little help figuring
 308 things out, we strongly suggest joining the Altus Metrum user email
 309 list, which you can do by visiting
 310 <a href="https://lists.gag.com/mailman/listinfo/altusmetrum" class="bare">https://lists.gag.com/mailman/listinfo/altusmetrum</a>.  There&#8217;s a lot
 311 of useful information in the mailing list archives!</p>
 312 </div>
 313 <div class="paragraph">
 314 <p>The first device created for our community was TeleMetrum, a dual
 315 deploy altimeter with fully integrated GPS and radio telemetry
 316 as standard features, and a “companion interface” that will
 317 support optional capabilities in the future. The later versions
 318 of TeleMetrum, v2 and newer, have all of the same features but with
 319 improved sensors and radio to offer increased performance.</p>
 320 </div>
 321 <div class="paragraph">
 322 <p>Our second device was TeleMini, a dual deploy altimeter with
 323 radio telemetry and radio direction finding. The first version
 324 of this device was only 13mm by 38mm (½ inch by 1½ inches) and
 325 could fit easily in an 18mm air-frame. The latest version, v3.0,
 326 includes a beeper, higher power radio, extended on-board
 327 flight logging and an improved barometric sensor.</p>
 328 </div>
 329 <div class="paragraph">
 330 <p>TeleMega is our most sophisticated device, including six pyro
 331 channels (four of which are fully programmable), integrated GPS,
 332 integrated gyroscopes for staging/air-start inhibit and high
 333 performance telemetry.</p>
 334 </div>
 335 <div class="paragraph">
 336 <p>EasyMini is a dual-deploy altimeter with logging and built-in
 337 USB data download.</p>
 338 </div>
 339 <div class="paragraph">
 340 <p>EasyMega is essentially a TeleMega board with the GPS receiver
 341 and telemetry transmitter removed. It offers the same 6 pyro
 342 channels and integrated gyroscopes for staging/air-start inhibit.</p>
 343 </div>
 344 <div class="paragraph">
 345 <p>TeleDongle v0.2 was our first ground station, providing a USB to RF
 346 interfaces for communicating with the altimeters. Combined with
 347 your choice of antenna and notebook computer, TeleDongle and our
 348 associated user interface software form a complete ground
 349 station capable of logging and displaying in-flight telemetry,
 350 aiding rocket recovery, then processing and archiving flight
 351 data for analysis and review. The latest version, TeleDongle
 352 v3, has all new electronics with a higher performance radio
 353 for improved range.</p>
 354 </div>
 355 <div class="paragraph">
 356 <p>For a slightly more portable ground station experience that also
 357 provides direct rocket recovery support, TeleBT offers flight
 358 monitoring and data logging using a  Bluetooth™ connection between
 359 the receiver and an Android device that has the AltosDroid
 360 application installed from the Google Play store.</p>
 361 </div>
 362 <div class="paragraph">
 363 <p>More products will be added to the Altus Metrum family over time, and
 364 we currently envision that this will be a single, comprehensive manual
 365 for the entire product family.</p>
 366 </div>
 367 </div>
 368 </div>
 369 <div class="sect1">
 370 <h2 id="_getting_started">2. Getting Started</h2>
 371 <div class="sectionbody">
 372 <div class="paragraph">
 373 <p>The first thing to do after you open the box is to hook up a
 374 battery and charge it if necessary.</p>
 375 </div>
 376 <div class="sect2">
 377 <h3 id="_batteries">2.1. Batteries</h3>
 378 <div class="paragraph">
 379 <p>For TeleMetrum, TeleMega and EasyMega, the battery can be charged by plugging it into the
 380 corresponding socket of the device and then using the USB
 381 cable to plug the flight computer into your computer&#8217;s USB socket. The
 382 on-board circuitry will charge the battery whenever it is plugged
 383 in, because the on-off switch does NOT control the
 384 charging circuitry.
 385 The Lithium Polymer
 386 EasyTimer,
 387 TeleMini and
 388 EasyMini battery can be charged by disconnecting it
 389 from the board and plugging it into a standalone
 390 battery charger such as <a href="http://altusmetrum.org/LipoCharger">LipoCharger</a>, and
 391 connecting that via a USB cable to a laptop or other
 392 USB power source.</p>
 393 </div>
 394 <div class="paragraph">
 395 <p>You can also choose to use another battery with
 396 EasyTimer and
 397 EasyMini, anything supplying between 4 and 12 volts should
 398 work fine (like a standard 9V battery), but if you are planning
 399 to fire pyro charges, ground testing is required to verify that
 400 the battery supplies enough current to fire your chosen e-matches.</p>
 401 </div>
 402 <div class="admonitionblock note">
 403 <table>
 404 <tr>
 405 <td class="icon">
 406 <img src="./images/icons/note.svg" alt="Note">
 407 </td>
 408 <td class="content">
 409 <div class="paragraph">
 410 <p>On TeleMetrum v1 boards, when the GPS chip is initially
 411 searching for satellites, TeleMetrum will consume more current
 412 than it pulls from the USB port, so the battery must be
 413 attached in order to get satellite lock.  Once GPS is locked,
 414 the current consumption goes back down enough to enable charging
 415 while running. So it&#8217;s a good idea to fully charge the battery
 416 as your first item of business so there is no issue getting and
 417 maintaining satellite lock.  The yellow charge indicator led
 418 will go out when the battery is nearly full and the charger goes
 419 to trickle charge. It can take several hours to fully recharge a
 420 deeply discharged battery.</p>
 421 </div>
 422 <div class="paragraph">
 423 <p>TeleMetrum v2 or newer, TeleMega and EasyMega use a
 424 higher power battery charger, allowing them to charge
 425 the battery while running the board at maximum
 426 power. When the battery is charging, or when the board
 427 is consuming a lot of power, the red LED will be
 428 lit. When the battery is fully charged, the green LED
 429 will be lit. When the battery is damaged or missing,
 430 both LEDs will be lit, which appears yellow.</p>
 431 </div>
 432 </td>
 433 </tr>
 434 </table>
 435 </div>
 436 </div>
 437 <div class="sect2">
 438 <h3 id="_ground_station_hardware">2.2. Ground Station Hardware</h3>
 439 <div class="paragraph">
 440 <p>There are two ground stations available, the TeleDongle USB to
 441 RF interface and the TeleBT Bluetooth/USB to RF interface.  If
 442 you plug either of these in to your Mac or Linux computer it should
 443 “just work”, showing up as a serial port device.  Windows systems need
 444 driver information that is part of the AltOS download to know that the
 445 existing USB modem driver will work.  We therefore recommend installing
 446 our software before plugging in TeleDongle if you are using a Windows
 447 computer.  If you are using an older version of Linux and are having
 448 problems, try moving to a fresher kernel (2.6.33 or
 449 newer).</p>
 450 </div>
 451 </div>
 452 <div class="sect2">
 453 <h3 id="_linuxmacwindows_ground_station_software">2.3. Linux/Mac/Windows Ground Station Software</h3>
 454 <div class="paragraph">
 455 <p>Next you should obtain and install the AltOS software.
 456 The AltOS distribution includes the AltosUI ground
 457 station program, current firmware images for all of
 458 the hardware, and a number of standalone utilities
 459 that are rarely needed.  Pre-built binary packages are
 460 available for Linux, Microsoft Windows, Mac OSX. Full
 461 source code and build instructions are also
 462 available. The latest version may always be downloaded
 463 from <a href="http://altusmetrum.org/AltOS" class="bare">http://altusmetrum.org/AltOS</a></p>
 464 </div>
 465 </div>
 466 <div class="sect2">
 467 <h3 id="_android_ground_station_software">2.4. Android Ground Station Software</h3>
 468 <div class="paragraph">
 469 <p>TeleBT can also connect to an Android device over
 470 BlueTooth or USB. The
 471 <a href="https://play.google.com/store/apps/details?id=org.altusmetrum.AltosDroid">AltosDroid
 472 Android application</a> is available from the
 473 <a href="https://play.google.com">Google Play system</a>.</p>
 474 </div>
 475 <div class="paragraph">
 476 <p>You don&#8217;t need a data plan to use AltosDroid, but
 477 without network access, you&#8217;ll want to download
 478 offline map data before wandering away from the
 479 network.</p>
 480 </div>
 481 </div>
 482 </div>
 483 </div>
 484 <div class="sect1">
 485 <h2 id="_using_altus_metrum_hardware">3. Using Altus Metrum Hardware</h2>
 486 <div class="sectionbody">
 487 <div class="paragraph">
 488 <p>Here are general instructions for hooking up an Altus Metrum
 489 flight computer. Instructions specific to each model will be
 490 found in the section devoted to that model below.</p>
 491 </div>
 492 <div class="sect2">
 493 <h3 id="_wiring_and_electrical_interference">3.1. Wiring and Electrical Interference</h3>
 494 <div class="paragraph">
 495 <p>To prevent electrical interference from affecting the
 496 operation of the flight computer, it&#8217;s important to always
 497 twist pairs of wires connected to the board. Twist the switch
 498 leads, the pyro leads and the battery leads. This reduces
 499 interference through a mechanism called common mode rejection.</p>
 500 </div>
 501 </div>
 502 <div class="sect2">
 503 <h3 id="_hooking_up_lithium_polymer_batteries">3.2. Hooking Up Lithium Polymer Batteries</h3>
 504 <div class="paragraph">
 505 <p>All Altus Metrum flight computers have a two pin JST PH
 506 series connector to connect up a single-cell Lithium Polymer
 507 cell (3.7V nominal). You can purchase matching batteries
 508 from the Altus Metrum store, or other vendors, or you can
 509 make your own. Pin 1 of the connector is positive, pin 2 is
 510 negative. Spark Fun sells a cable with the connector
 511 attached, which they call a
 512 <a href="https://www.sparkfun.com/products/9914">JST Jumper 2 Wire Assembly</a></p>
 513 </div>
 514 <div class="admonitionblock warning">
 515 <table>
 516 <tr>
 517 <td class="icon">
 518 <img src="./images/icons/warning.svg" alt="Warning">
 519 </td>
 520 <td class="content">
 521 Many RC vendors also sell lithium polymer batteries with
 522 this same connector. All that we have found use the opposite
 523 polarity, and if you use them that way, you will damage or
 524 destroy the flight computer.
 525 </td>
 526 </tr>
 527 </table>
 528 </div>
 529 </div>
 530 <div class="sect2">
 531 <h3 id="_hooking_up_pyro_charges">3.3. Hooking Up Pyro Charges</h3>
 532 <div class="paragraph">
 533 <p>Altus Metrum flight computers always have two screws for
 534 each pyro charge. This means you shouldn&#8217;t need to put two
 535 wires into a screw terminal or connect leads from pyro
 536 charges together externally.</p>
 537 </div>
 538 <div class="paragraph">
 539 <p>On the flight computer, one lead from each charge is hooked
 540 to the positive battery terminal through the power switch.
 541 The other lead is connected through the pyro circuit, which
 542 is connected to the negative battery terminal when the pyro
 543 circuit is fired.</p>
 544 </div>
 545 </div>
 546 <div class="sect2">
 547 <h3 id="_hooking_up_a_power_switch">3.4. Hooking Up a Power Switch</h3>
 548 <div class="paragraph">
 549 <p>Altus Metrum flight computers need an external power switch
 550 to turn them on. This disconnects both the computer and the
 551 pyro charges from the battery, preventing the charges from
 552 firing when in the Off position. The switch is in-line with
 553 the positive battery terminal.</p>
 554 </div>
 555 </div>
 556 <div class="sect2">
 557 <h3 id="_understanding_beeps">3.5. Understanding Beeps</h3>
 558 <div class="paragraph">
 559 <p>Altus Metrum flight computers include a beeper to
 560 provide information about the state of the system.
 561 TeleMini doesn&#8217;t have room for a beeper, so instead it
 562 uses an LED, which works the same, except for every
 563 beep is replaced with the flash of the LED.</p>
 564 </div>
 565 <div class="paragraph">
 566 <p>Here&#8217;s a short summary of all of the modes and the
 567 beeping
 568 (or flashing, in the case of TeleMini v1)
 569 that accompanies each mode. In the description of the
 570 beeping pattern, “dit” means a short beep while "dah"
 571 means a long beep (three times as long). “Brap” means
 572 a long dissonant tone.</p>
 573 </div>
 574 <table class="tableblock frame-all grid-all stretch">
 575 <caption class="title">Table 1. AltOS Modes</caption>
 576 <colgroup>
 577 <col style="width: 16.6666%;">
 578 <col style="width: 16.6666%;">
 579 <col style="width: 33.3333%;">
 580 <col style="width: 33.3335%;">
 581 </colgroup>
 582 <tbody>
 583 <tr>
 584 <td class="tableblock halign-left valign-top"><p class="tableblock">Mode Name</p></td>
 585 <td class="tableblock halign-left valign-top"><p class="tableblock">Abbreviation</p></td>
 586 <td class="tableblock halign-left valign-top"><p class="tableblock">Beeps</p></td>
 587 <td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
 588 </tr>
 589 <tr>
 590 <td class="tableblock halign-left valign-top"><p class="tableblock">Startup</p></td>
 591 <td class="tableblock halign-left valign-top"><p class="tableblock">S</p></td>
 592 <td class="tableblock halign-left valign-top"><p class="tableblock">battery voltage in decivolts</p></td>
 593 <td class="tableblock halign-left valign-top"><p class="tableblock">Calibrating sensors, detecting orientation.</p></td>
 594 </tr>
 595 <tr>
 596 <td class="tableblock halign-left valign-top"><p class="tableblock">Idle</p></td>
 597 <td class="tableblock halign-left valign-top"><p class="tableblock">I</p></td>
 598 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit</p></td>
 599 <td class="tableblock halign-left valign-top"><p class="tableblock">Ready to accept commands over USB
 600 or radio link.</p></td>
 601 </tr>
 602 <tr>
 603 <td class="tableblock halign-left valign-top"><p class="tableblock">Pad</p></td>
 604 <td class="tableblock halign-left valign-top"><p class="tableblock">P</p></td>
 605 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dah dah dit</p></td>
 606 <td class="tableblock halign-left valign-top"><p class="tableblock">Waiting for launch. Not listening for commands.</p></td>
 607 </tr>
 608 <tr>
 609 <td class="tableblock halign-left valign-top"><p class="tableblock">Boost</p></td>
 610 <td class="tableblock halign-left valign-top"><p class="tableblock">B</p></td>
 611 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dit dit</p></td>
 612 <td class="tableblock halign-left valign-top"><p class="tableblock">Accelerating upwards.</p></td>
 613 </tr>
 614 <tr>
 615 <td class="tableblock halign-left valign-top"><p class="tableblock">Fast</p></td>
 616 <td class="tableblock halign-left valign-top"><p class="tableblock">F</p></td>
 617 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit dah dit</p></td>
 618 <td class="tableblock halign-left valign-top"><p class="tableblock">Decelerating, but moving faster than 200m/s.</p></td>
 619 </tr>
 620 <tr>
 621 <td class="tableblock halign-left valign-top"><p class="tableblock">Coast</p></td>
 622 <td class="tableblock halign-left valign-top"><p class="tableblock">C</p></td>
 623 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dah dit</p></td>
 624 <td class="tableblock halign-left valign-top"><p class="tableblock">Decelerating, moving slower than 200m/s</p></td>
 625 </tr>
 626 <tr>
 627 <td class="tableblock halign-left valign-top"><p class="tableblock">Drogue</p></td>
 628 <td class="tableblock halign-left valign-top"><p class="tableblock">D</p></td>
 629 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dit</p></td>
 630 <td class="tableblock halign-left valign-top"><p class="tableblock">Descending after apogee. Above main height.</p></td>
 631 </tr>
 632 <tr>
 633 <td class="tableblock halign-left valign-top"><p class="tableblock">Main</p></td>
 634 <td class="tableblock halign-left valign-top"><p class="tableblock">M</p></td>
 635 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dah</p></td>
 636 <td class="tableblock halign-left valign-top"><p class="tableblock">Descending. Below main height.</p></td>
 637 </tr>
 638 <tr>
 639 <td class="tableblock halign-left valign-top"><p class="tableblock">Landed</p></td>
 640 <td class="tableblock halign-left valign-top"><p class="tableblock">L</p></td>
 641 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dah dit dit</p></td>
 642 <td class="tableblock halign-left valign-top"><p class="tableblock">Stable altitude for at least ten seconds.</p></td>
 643 </tr>
 644 <tr>
 645 <td class="tableblock halign-left valign-top"><p class="tableblock">Sensor error</p></td>
 646 <td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
 647 <td class="tableblock halign-left valign-top"><p class="tableblock">dah dit dit dah</p></td>
 648 <td class="tableblock halign-left valign-top"><p class="tableblock">Error detected during sensor calibration.</p></td>
 649 </tr>
 650 </tbody>
 651 </table>
 652 <div class="paragraph">
 653 <p>Here&#8217;s a summary of all of the Pad and Idle mode
 654 indications. In Idle mode, you&#8217;ll hear one of these
 655 just once after the two short dits indicating idle
 656 mode. In Pad mode, after the dit dah dah dit
 657 indicating Pad mode, you&#8217;ll hear these once every five
 658 seconds.</p>
 659 </div>
 660 <table class="tableblock frame-all grid-all stretch">
 661 <caption class="title">Table 2. Pad/Idle Indications</caption>
 662 <colgroup>
 663 <col style="width: 20%;">
 664 <col style="width: 20%;">
 665 <col style="width: 60%;">
 666 </colgroup>
 667 <thead>
 668 <tr>
 669 <th class="tableblock halign-left valign-top">Name</th>
 670 <th class="tableblock halign-left valign-top">Beeps</th>
 671 <th class="tableblock halign-left valign-top">Description</th>
 672 </tr>
 673 </thead>
 674 <tbody>
 675 <tr>
 676 <td class="tableblock halign-left valign-top"><p class="tableblock">Neither</p></td>
 677 <td class="tableblock halign-left valign-top"><p class="tableblock">brap</p></td>
 678 <td class="tableblock halign-left valign-top"><p class="tableblock">No continuity detected on either apogee or main igniters.</p></td>
 679 </tr>
 680 <tr>
 681 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee</p></td>
 682 <td class="tableblock halign-left valign-top"><p class="tableblock">dit</p></td>
 683 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on apogee igniter.</p></td>
 684 </tr>
 685 <tr>
 686 <td class="tableblock halign-left valign-top"><p class="tableblock">Main</p></td>
 687 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit</p></td>
 688 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on main igniter.</p></td>
 689 </tr>
 690 <tr>
 691 <td class="tableblock halign-left valign-top"><p class="tableblock">Both</p></td>
 692 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit dit</p></td>
 693 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected on both igniters.</p></td>
 694 </tr>
 695 <tr>
 696 <td class="tableblock halign-left valign-top"><p class="tableblock">Storage Full</p></td>
 697 <td class="tableblock halign-left valign-top"><p class="tableblock">warble</p></td>
 698 <td class="tableblock halign-left valign-top"><p class="tableblock">On-board data logging storage is full. This will
 699 not prevent the flight computer from safely
 700 controlling the flight or transmitting telemetry
 701 signals, but no record of the flight will be
 702 stored in on-board flash.</p></td>
 703 </tr>
 704 <tr>
 705 <td class="tableblock halign-left valign-top"><p class="tableblock">Additional Igniters</p></td>
 706 <td class="tableblock halign-left valign-top"><p class="tableblock">four very short beeps</p></td>
 707 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity indication for the additional pyro
 708 channels on TeleMega, EasyMega and EasyTimer. One high tone for
 709 no continuity, one low tone for continuity. On TeleMega and EasyMegay, these are
 710 produced after the continuity indicators for the two
 711 primary igniter channels.</p></td>
 712 </tr>
 713 </tbody>
 714 </table>
 715 <div class="paragraph">
 716 <p>For devices with a radio transmitter, in addition to
 717 the digital and APRS telemetry signals, you can also
 718 receive audio tones with a standard amateur
 719 70cm FM receiver. While on the pad, you will hear
 720 igniter status once every five seconds.</p>
 721 </div>
 722 <table class="tableblock frame-all grid-all stretch">
 723 <caption class="title">Table 3. Pad Radio Indications</caption>
 724 <colgroup>
 725 <col style="width: 20%;">
 726 <col style="width: 20%;">
 727 <col style="width: 60%;">
 728 </colgroup>
 729 <thead>
 730 <tr>
 731 <th class="tableblock halign-left valign-top">Name</th>
 732 <th class="tableblock halign-left valign-top">Beeps</th>
 733 <th class="tableblock halign-left valign-top">Description</th>
 734 </tr>
 735 </thead>
 736 <tbody>
 737 <tr>
 738 <td class="tableblock halign-left valign-top"><p class="tableblock">Neither</p></td>
 739 <td class="tableblock halign-left valign-top"><p class="tableblock">½ second tone</p></td>
 740 <td class="tableblock halign-left valign-top"><p class="tableblock">No continuity detected on either apogee or main igniters.</p></td>
 741 </tr>
 742 <tr>
 743 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee</p></td>
 744 <td class="tableblock halign-left valign-top"><p class="tableblock">dit</p></td>
 745 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on apogee igniter.</p></td>
 746 </tr>
 747 <tr>
 748 <td class="tableblock halign-left valign-top"><p class="tableblock">Main</p></td>
 749 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit</p></td>
 750 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected only on main igniter.</p></td>
 751 </tr>
 752 <tr>
 753 <td class="tableblock halign-left valign-top"><p class="tableblock">Both</p></td>
 754 <td class="tableblock halign-left valign-top"><p class="tableblock">dit dit dit</p></td>
 755 <td class="tableblock halign-left valign-top"><p class="tableblock">Continuity detected on both igniters.</p></td>
 756 </tr>
 757 </tbody>
 758 </table>
 759 <div class="paragraph">
 760 <p>During ascent, the tones will be muted to allow the
 761 telemetry data to consume the full radio bandwidth.</p>
 762 </div>
 763 <div class="paragraph">
 764 <p>During descent and after landing, a ½ second tone will
 765 be transmitted every five seconds. This can be used to
 766 find the rocket using RDF techniques when the signal
 767 is too weak to receive GPS information via telemetry
 768 or APRS.</p>
 769 </div>
 770 </div>
 771 <div class="sect2">
 772 <h3 id="_turning_on_the_power">3.6. Turning On the Power</h3>
 773 <div class="paragraph">
 774 <p>Connect a battery and power switch and turn the switch
 775 to "on". The flight computer will signal power on by
 776 reporting the battery voltage and then perform an internal self
 777 test and sensor calibration.</p>
 778 </div>
 779 <div class="paragraph">
 780 <p>Once the self test and calibration are complete, there
 781 are two modes that an Altus Metrum flight computer can
 782 operate in:</p>
 783 </div>
 784 <div class="dlist">
 785 <dl>
 786 <dt class="hdlist1">Flight/Pad</dt>
 787 <dd>
 788 <p>The flight computer is waiting to detect
 789 launch and then fly the rocket. In this mode, the USB
 790 link is
 791 disabled, and the radio goes into transmit-only mode.
 792 The only way to get out of this
 793 mode is to power the flight computer down. See below for how to get the flight
 794 computer to come up in Flight/Pad mode at power on.</p>
 795 </dd>
 796 <dt class="hdlist1">Idle</dt>
 797 <dd>
 798 <p>The flight computer is ready to communicate over USB
 799 and in packet mode over the radio.
 800 You can configure
 801 the flight computer, download data or display
 802 the current state. See below for how to get the flight
 803 computer to come up in Idle mode at power on.</p>
 804 </dd>
 805 </dl>
 806 </div>
 807 <div class="paragraph">
 808 <p>For flight computers with accelerometers (TeleMetrum,
 809 EasyMega, TeleMega and EasyTimer), the mode is selected by the
 810 orientation of the board during the self test
 811 interval. If the board is pointing upwards as if ready
 812 to fly, it will enter Flight/Pad mode. Otherwise, it will
 813 enter Idle mode.</p>
 814 </div>
 815 <div class="paragraph">
 816 <p>For EasyMini, if the USB cable is connected to a
 817 computer, it will enter Idle mode. Otherwise, it will
 818 enter Flight/Pad mode.</p>
 819 </div>
 820 <div class="paragraph">
 821 <p>For TeleMini v1.0, if a packet link is waiting to
 822 connect when the device is powered on, it will enter
 823 Idle mode, otherwise it will enter Flight/Pad mode.</p>
 824 </div>
 825 <div class="paragraph">
 826 <p>You can see in <a href="#_understanding_beeps">Understanding Beeps</a>
 827 how to tell which mode the flight computer is in.</p>
 828 </div>
 829 </div>
 830 <div class="sect2">
 831 <h3 id="_using_an_external_active_switch_circuit">3.7. Using an External Active Switch Circuit</h3>
 832 <div class="paragraph">
 833 <p>You can use an active switch circuit, such as the
 834 Featherweight Magnetic Switch, with any Altus Metrum
 835 flight computer. These require three connections, one to
 836 the battery, one to the positive power input on the flight
 837 computer and one to ground. Find instructions on how to
 838 hook these up for each flight computer below. Then follow
 839 the instructions that come with your active switch to
 840 connect it up.</p>
 841 </div>
 842 </div>
 843 <div class="sect2">
 844 <h3 id="_using_a_separate_pyro_battery">3.8. Using a Separate Pyro Battery</h3>
 845 <div class="paragraph">
 846 <p>As mentioned above in <a href="#_hooking_up_pyro_charges">Hooking Up Pyro Charges</a>, one
 847 lead for each of the pyro charges is connected through
 848 the power switch directly to the positive battery
 849 terminal. The other lead is connected to the pyro
 850 circuit, which connects it to the negative battery
 851 terminal when the pyro circuit is fired. The pyro
 852 circuit on all of the flight computers is designed to
 853 handle up to 16V.</p>
 854 </div>
 855 <div class="paragraph">
 856 <p>To use a separate pyro battery, connect the negative pyro
 857 battery terminal to the flight computer ground terminal,
 858 the the switched positive battery terminal to the igniter
 859 and the other
 860 igniter lead to the negative pyro terminal on the flight
 861 computer. When the pyro channel fires, it will complete the
 862 circuit between the negative pyro terminal and the ground
 863 terminal, firing the igniter. Specific instructions on how
 864 to hook this up for each flight computer will be found
 865 in the section below for that flight computer.</p>
 866 </div>
 867 <div class="paragraph">
 868 <p>Note that you must include a switch in the positive lead of
 869 the pyro battery for safety, as the on-board power switch
 870 circuit on our product only controls current flow from the
 871 the primary or system battery!</p>
 872 </div>
 873 </div>
 874 <div class="sect2">
 875 <h3 id="_using_a_different_kind_of_battery">3.9. Using a Different Kind of Battery</h3>
 876 <div class="paragraph">
 877 <p>EasyMini
 878 and EasyTimer are
 879 designed to use either a
 880 lithium polymer battery or any other battery producing
 881 between 4 and 12 volts, such as a rectangular 9V
 882 battery.</p>
 883 </div>
 884 <div class="admonitionblock warning">
 885 <table>
 886 <tr>
 887 <td class="icon">
 888 <img src="./images/icons/warning.svg" alt="Warning">
 889 </td>
 890 <td class="content">
 891 TeleMini,
 892 TeleMega, EasyMega and TeleMetrum are only designed to
 893 operate off a single-cell Lithium Polymer battery and
 894 cannot be used with any other kind. Connecting a
 895 different kind of battery to any of these will destroy
 896 the board.
 897 </td>
 898 </tr>
 899 </table>
 900 </div>
 901 </div>
 902 <div class="sect2">
 903 <h3 id="_using_packet_link_mode">3.10. Using Packet Link Mode</h3>
 904 <div class="paragraph">
 905 <p>All AltusMetrum flight computers that have a radio can
 906 communicate with the ground station software for
 907 configuration and other operations using the Packet
 908 Link mode. This uses radio communication instead of a
 909 USB cable. To set this up, the ground station software
 910 must be configured to the correct data rate, frequency
 911 and callsign.</p>
 912 </div>
 913 <div class="paragraph">
 914 <p>You can monitor Packet Link mode from TeleBT or
 915 TeleDongle by watching the LEDs. Each time the device
 916 transmits, the red LED will flash. When the link is
 917 busy, or when the link is not working, the device will
 918 transmit 10 times per second, so the LED will flash
 919 rapidly. When the link is working and there is no data
 920 to send, the link will flash once per second, and the
 921 LED will flash more slowly.</p>
 922 </div>
 923 </div>
 924 </div>
 925 </div>
 926 <div class="sect1">
 927 <h2 id="_telemetrum">4. TeleMetrum</h2>
 928 <div class="sectionbody">
 929 <div class="imageblock">
 930 <div class="content">
 931 <img src="telemetrum-v2.0-th.jpg" alt="telemetrum v2.0 th" width="400">
 932 </div>
 933 <div class="title">Figure 1. TeleMetrum v2 Board</div>
 934 </div>
 935 <div class="imageblock">
 936 <div class="content">
 937 <img src="telemetrum-v1.1-thside.jpg" alt="telemetrum v1.1 thside" width="400">
 938 </div>
 939 <div class="title">Figure 2. TeleMetrum v1 Board</div>
 940 </div>
 941 <div class="paragraph">
 942 <p>TeleMetrum is a 1 inch by 2¾ inch circuit board.  It was designed to
 943 fit inside coupler for 29mm air-frame tubing, but using it in a tube that
 944 small in diameter may require some creativity in mounting and wiring
 945 to succeed!  The presence of an accelerometer means TeleMetrum should
 946 be aligned along the flight axis of the airframe, and by default the ¼
 947 wave UHF wire antenna should be on the nose-cone end of the board.  The
 948 antenna wire is about 7 inches long, and wiring for a power switch and
 949 the e-matches for apogee and main ejection charges depart from the
 950 fin can end of the board, meaning an ideal “simple” avionics
 951 bay for TeleMetrum should have at least 10 inches of interior length.</p>
 952 </div>
 953 <div class="paragraph">
 954 <p>There are two generations of the TeleMetrum design. The
 955 major changes after v1 generation are:</p>
 956 </div>
 957 <div class="ulist">
 958 <ul>
 959 <li>
 960 <p>uBlox GPS chip certified for altitude records</p>
 961 </li>
 962 <li>
 963 <p>Higher power radio (40mW vs 10mW)</p>
 964 </li>
 965 <li>
 966 <p>APRS support</p>
 967 </li>
 968 </ul>
 969 </div>
 970 <div class="paragraph">
 971 <p>Otherwise, they&#8217;re the same size, with mounting holes and
 972 screw terminals in the same position.</p>
 973 </div>
 974 <div class="sect2">
 975 <h3 id="_telemetrum_screw_terminals">4.1. TeleMetrum Screw Terminals</h3>
 976 <div class="paragraph">
 977 <p>TeleMetrum has six screw terminals on the end of the board
 978 opposite the telemetry antenna. Two are for the power
 979 switch, and two each for the apogee and main igniter
 980 circuits. Using the picture above and starting from the top,
 981 the terminals are as follows:</p>
 982 </div>
 983 <table class="tableblock frame-all grid-all stretch">
 984 <caption class="title">Table 4. TeleMetrum Screw Terminals</caption>
 985 <colgroup>
 986 <col style="width: 13.3333%;">
 987 <col style="width: 20%;">
 988 <col style="width: 66.6667%;">
 989 </colgroup>
 990 <thead>
 991 <tr>
 992 <th class="tableblock halign-left valign-top">Terminal #</th>
 993 <th class="tableblock halign-left valign-top">Terminal Name</th>
 994 <th class="tableblock halign-left valign-top">Description</th>
 995 </tr>
 996 </thead>
 997 <tbody>
 998 <tr>
 999 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
1000 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1001 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1002 </tr>
1003 <tr>
1004 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
1005 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1006 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1007 </tr>
1008 <tr>
1009 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
1010 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1011 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1012 </tr>
1013 <tr>
1014 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
1015 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1016 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1017 </tr>
1018 <tr>
1019 <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
1020 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1021 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1022 </tr>
1023 <tr>
1024 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
1025 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1026 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1027 </tr>
1028 </tbody>
1029 </table>
1030 </div>
1031 <div class="sect2">
1032 <h3 id="_using_a_separate_pyro_battery_with_telemetrum">4.2. Using a Separate Pyro Battery with TeleMetrum</h3>
1033 <div class="paragraph">
1034 <p>As described above, using an external pyro battery involves
1035 connecting the negative battery terminal to the flight
1036 computer ground, connecting the positive battery terminal to
1037 one of the igniter leads and connecting the other igniter
1038 lead to the per-channel pyro circuit connection.</p>
1039 </div>
1040 <div class="paragraph">
1041 <p>To connect the negative battery terminal to the TeleMetrum
1042 ground, insert a small piece of wire, 24 to 28 gauge
1043 stranded, into the GND hole just above the screw terminal
1044 strip and solder it in place.</p>
1045 </div>
1046 <div class="paragraph">
1047 <p>Connecting the switched positive battery terminal to the pyro
1048 charges must be done separate from TeleMetrum, by soldering
1049 them together or using some other connector. Note that you
1050 must include a switch in the positive lead from the pyro
1051 battery for safety!</p>
1052 </div>
1053 <div class="paragraph">
1054 <p>The other lead from each pyro charge is then inserted into
1055 the appropriate per-pyro channel screw terminal (terminal 4
1056 for the Main charge, terminal 6 for the Apogee charge).</p>
1057 </div>
1058 </div>
1059 <div class="sect2">
1060 <h3 id="_using_an_active_switch_with_telemetrum">4.3. Using an Active Switch with TeleMetrum</h3>
1061 <div class="paragraph">
1062 <p>As explained above, an external active switch requires three
1063 connections, one to the positive battery terminal, one to
1064 the flight computer positive input and one to ground.</p>
1065 </div>
1066 <div class="paragraph">
1067 <p>The positive battery terminal is available on screw terminal
1068 2, the positive flight computer input is on terminal 1. To
1069 hook a lead to ground, solder a piece of wire, 24 to 28
1070 gauge stranded, to the GND hole just above terminal 1.</p>
1071 </div>
1072 </div>
1073 </div>
1074 </div>
1075 <div class="sect1">
1076 <h2 id="_telemini">5. TeleMini</h2>
1077 <div class="sectionbody">
1078 <div class="imageblock">
1079 <div class="content">
1080 <img src="telemini-v3.0-top.jpg" alt="telemini v3.0 top" width="400">
1081 </div>
1082 <div class="title">Figure 3. TeleMini v3 Board</div>
1083 </div>
1084 <div class="imageblock">
1085 <div class="content">
1086 <img src="telemini-v3.0-bottom.jpg" alt="telemini v3.0 bottom" width="400">
1087 </div>
1088 </div>
1089 <div class="paragraph">
1090 <p>TeleMini v3 is 0.5 inches by 1.67 inches.  It was
1091 designed to fit inside an 18mm air-frame tube, but using it in
1092 a tube that small in diameter may require some creativity in
1093 mounting and wiring to succeed!  Since there is no
1094 accelerometer, TeleMini can be mounted in any convenient
1095 orientation.  The default ¼ wave UHF wire antenna attached to
1096 the center of one end of the board is about 7 inches long. Screw
1097 terminals for the power switch are located in the
1098 middle of the board. Screw terminals for the e-matches for
1099 apogee and main ejection charges depart from the other end of
1100 the board, meaning an ideal “simple” avionics bay for TeleMini
1101 should have at least 9 inches of interior length.</p>
1102 </div>
1103 <div class="sect2">
1104 <h3 id="_telemini_v3_screw_terminals">5.1. TeleMini v3 Screw Terminals</h3>
1105 <div class="paragraph">
1106 <p>TeleMini v3 has four screw terminals on the end of the
1107 board opposite the telemetry antenna. Two are for the apogee
1108 and two are for main igniter circuits. Another two
1109 screw terminals are located in the middle of the board
1110 for the power switch.  Using the
1111 picture above and starting from the top for the pyro terminals
1112 and from the left for the power switch terminals, the
1113 connections are as follows:</p>
1114 </div>
1115 <table class="tableblock frame-all grid-all stretch">
1116 <caption class="title">Table 5. TeleMini v3 Screw Terminals</caption>
1117 <colgroup>
1118 <col style="width: 13.3333%;">
1119 <col style="width: 20%;">
1120 <col style="width: 66.6667%;">
1121 </colgroup>
1122 <thead>
1123 <tr>
1124 <th class="tableblock halign-left valign-top">Terminal #</th>
1125 <th class="tableblock halign-left valign-top">Terminal Name</th>
1126 <th class="tableblock halign-left valign-top">Description</th>
1127 </tr>
1128 </thead>
1129 <tbody>
1130 <tr>
1131 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
1132 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1133 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1134 </tr>
1135 <tr>
1136 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
1137 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1138 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1139 </tr>
1140 <tr>
1141 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
1142 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1143 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1144 </tr>
1145 <tr>
1146 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
1147 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1148 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1149 </tr>
1150 <tr>
1151 <td class="tableblock halign-left valign-top"><p class="tableblock">Left</p></td>
1152 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1153 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1154 </tr>
1155 <tr>
1156 <td class="tableblock halign-left valign-top"><p class="tableblock">Right</p></td>
1157 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1158 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1159 </tr>
1160 </tbody>
1161 </table>
1162 </div>
1163 <div class="sect2">
1164 <h3 id="_using_a_separate_pyro_battery_with_telemini_v3">5.2. Using a Separate Pyro Battery with TeleMini v3</h3>
1165 <div class="paragraph">
1166 <p>As described above, using an external pyro battery involves
1167 connecting the negative battery terminal to the flight
1168 computer ground, connecting the switched positive battery
1169 terminal to one of the igniter leads and connecting the other
1170 igniter lead to the per-channel pyro circuit connection.
1171 Because there is no solid ground connection to use on
1172 TeleMini, this is not recommended.</p>
1173 </div>
1174 <div class="paragraph">
1175 <p>The only available ground connection on TeleMini v3 are
1176 the two mounting holes next to the telemetry
1177 antenna. Somehow connect a small piece of wire to one of
1178 those holes and hook it to the negative pyro battery terminal.</p>
1179 </div>
1180 <div class="paragraph">
1181 <p>Connecting the positive battery terminal to the pyro
1182 charges must be done separate from TeleMini v3, by soldering
1183 them together or using some other connector.  Note that you
1184 must include a switch in the pyro battery positive lead for
1185 safety!</p>
1186 </div>
1187 <div class="paragraph">
1188 <p>The other lead from each pyro charge is then inserted into
1189 the appropriate per-pyro channel screw terminal (terminal 3 for the
1190 Main charge, terminal 1 for the Apogee charge).</p>
1191 </div>
1192 </div>
1193 <div class="sect2">
1194 <h3 id="_using_an_active_switch_with_telemini_v3">5.3. Using an Active Switch with TeleMini v3</h3>
1195 <div class="paragraph">
1196 <p>As explained above, an external active switch requires three
1197 connections, one to the positive battery terminal, one to
1198 the flight computer positive input and one to ground. Again,
1199 because TeleMini doesn&#8217;t have any good ground connection,
1200 this is not recommended.</p>
1201 </div>
1202 <div class="paragraph">
1203 <p>The positive battery terminal is available on the Right
1204 power switch wire, the positive flight computer input is on
1205 the left power switch wire. Hook a lead to either of the
1206 mounting holes for a ground connection.</p>
1207 </div>
1208 </div>
1209 <div class="sect2">
1210 <h3 id="_using_packet_link_mode_with_telemini">5.4. Using Packet Link Mode with TeleMini</h3>
1211 <div class="paragraph">
1212 <p>After TeleMini powers up, it will check to see if some
1213 device is attempting to communicate with it using
1214 Packet Link Mode. If so, it will switch to idle mode
1215 and start communicating. To switch to flight mode,
1216 reboot the device either over the radio link or by
1217 powering it off and back on.</p>
1218 </div>
1219 <div class="paragraph">
1220 <p>If no ground station is attempting to communicate
1221 using Packet Link Mode, TeleMini will enter pad mode
1222 and prepare for flight.</p>
1223 </div>
1224 <div class="paragraph">
1225 <p>The sequence of operations to use Packet Link Mode
1226 with TeleMini is:</p>
1227 </div>
1228 <div class="olist arabic">
1229 <ol class="arabic">
1230 <li>
1231 <p>Configure the ground station data rate, frequency
1232 and callsign to match the TeleMini settings.</p>
1233 </li>
1234 <li>
1235 <p>Start Packet Link Mode in the ground station by
1236 selecting the desired operation (Safe Flight Data,
1237 Configure Altimeter, Fire Igniter or Monitor
1238 Idle). Select the TeleBT or TeleDongle device. The
1239 red LED should begin flashing rapidly.</p>
1240 </li>
1241 <li>
1242 <p>Turn on TeleMini. You should see the red LED flash
1243 very rapidly during the initial communication burst,
1244 but it should then slow down when the link is idle.</p>
1245 </li>
1246 </ol>
1247 </div>
1248 <div class="paragraph">
1249 <p>Once TeleMini is in Idle mode, it will stay in that
1250 mode until rebooted. That means you can stop one
1251 Packet Link operation, wait a while and start another
1252 Packet Link operation.</p>
1253 </div>
1254 </div>
1255 <div class="sect2">
1256 <h3 id="_forcing_telemini_radio_parameters_to_known_defaults">5.5. Forcing TeleMini radio parameters to known defaults</h3>
1257 <div class="paragraph">
1258 <p>If you don&#8217;t know what the TeleMini frequency and
1259 callsign settings are, you can temporarily force it
1260 back to the original default values (frequency
1261 434.550MHz, callsign N0CALL) by connecting a wire
1262 between hole 3 and hole 6 on the debug connector. Hole
1263 3 has the square pad around it, hole 6 is the one
1264 nearest the MS5607 baro sensor, which is a rectangular
1265 component with a metal cap that has two holes in it.</p>
1266 </div>
1267 <div class="paragraph">
1268 <p>Once TeleMini has been powered up with this wire
1269 connected, the wire may be removed. The radio
1270 parameters will stay set to these default values until
1271 changed by the user or when the device is rebooted.</p>
1272 </div>
1273 </div>
1274 <div class="sect2">
1275 <h3 id="_telemini_v1">5.6. TeleMini v1</h3>
1276 <div class="paragraph">
1277 <p>TeleMini v1 is the earlier version of this product. It
1278 has a lower-power radio, less storage, no beeper and
1279 soldered-in wires instead of screw terminals for the
1280 power switch.</p>
1281 </div>
1282 <div class="imageblock">
1283 <div class="content">
1284 <img src="telemini-v1-top.jpg" alt="telemini v1 top" width="400">
1285 </div>
1286 <div class="title">Figure 4. TeleMini v1 Board</div>
1287 </div>
1288 </div>
1289 </div>
1290 </div>
1291 <div class="sect1">
1292 <h2 id="_easymini">6. EasyMini</h2>
1293 <div class="sectionbody">
1294 <div class="imageblock">
1295 <div class="content">
1296 <img src="easymini-top.jpg" alt="easymini top" width="400">
1297 </div>
1298 <div class="title">Figure 5. EasyMini Board</div>
1299 </div>
1300 <div class="paragraph">
1301 <p>EasyMini is built on a 0.8 inch by 1½ inch circuit board. It&#8217;s
1302 designed to fit in a 24mm coupler tube.</p>
1303 </div>
1304 <div class="paragraph">
1305 <p>You usually don&#8217;t need to configure EasyMini at all; it&#8217;s set
1306 up to do dual-deployment with an event at apogee to separate
1307 the airframe and deploy a drogue and another event at 250m
1308 (820ft) to deploy the main. Install EasyMini in your airframe,
1309 hook up a battery, igniters and a power switch and you&#8217;re
1310 ready to fly.</p>
1311 </div>
1312 <div class="sect2">
1313 <h3 id="_easymini_screw_terminals">6.1. EasyMini Screw Terminals</h3>
1314 <div class="paragraph">
1315 <p>EasyMini has two sets of four screw terminals near one end of the
1316 board. Using the picture
1317 above, the top four have connections for the main pyro
1318 circuit and an external battery and the bottom four have
1319 connections for the apogee pyro circuit and the power
1320 switch. Counting from the left, the connections are as follows:</p>
1321 </div>
1322 <table class="tableblock frame-all grid-all stretch">
1323 <caption class="title">Table 6. EasyMini Screw Terminals</caption>
1324 <colgroup>
1325 <col style="width: 13.3333%;">
1326 <col style="width: 20%;">
1327 <col style="width: 66.6667%;">
1328 </colgroup>
1329 <thead>
1330 <tr>
1331 <th class="tableblock halign-left valign-top">Terminal #</th>
1332 <th class="tableblock halign-left valign-top">Terminal Name</th>
1333 <th class="tableblock halign-left valign-top">Description</th>
1334 </tr>
1335 </thead>
1336 <tbody>
1337 <tr>
1338 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1339 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1340 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1341 </tr>
1342 <tr>
1343 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1344 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1345 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1346 </tr>
1347 <tr>
1348 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1349 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery +</p></td>
1350 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive external battery terminal</p></td>
1351 </tr>
1352 <tr>
1353 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1354 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery -</p></td>
1355 <td class="tableblock halign-left valign-top"><p class="tableblock">Negative external battery terminal</p></td>
1356 </tr>
1357 <tr>
1358 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1359 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1360 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1361 </tr>
1362 <tr>
1363 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1364 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1365 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1366 </tr>
1367 <tr>
1368 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1369 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1370 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1371 </tr>
1372 <tr>
1373 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1374 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1375 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1376 </tr>
1377 </tbody>
1378 </table>
1379 </div>
1380 <div class="sect2">
1381 <h3 id="_connecting_a_battery_to_easymini">6.2. Connecting A Battery To EasyMini</h3>
1382 <div class="paragraph">
1383 <p>There are two possible battery connections on
1384 EasyMini. You can use either method; both feed
1385 through the power switch terminals.</p>
1386 </div>
1387 <div class="paragraph">
1388 <p>One battery connection is the standard Altus Metrum
1389 white JST plug. This mates with single-cell Lithium
1390 Polymer batteries sold by Altus Metrum.</p>
1391 </div>
1392 <div class="paragraph">
1393 <p>The other is a pair of screw terminals marked 'Battery
1394 +' and 'Battery -'. Connect a battery from 4 to 12
1395 volts to these terminals, being careful to match polarity.</p>
1396 </div>
1397 </div>
1398 <div class="sect2">
1399 <h3 id="_charging_lithium_batteries">6.3. Charging Lithium Batteries</h3>
1400 <div class="paragraph">
1401 <p>Because EasyMini allows for batteries other than the
1402 standard Altus Metrum Lithium Polymer cells, it cannot
1403 incorporate a battery charger circuit. Therefore, when
1404 using a Litium Polymer cell, you&#8217;ll need an external
1405 charger. These are available from Altus Metrum, or
1406 from Spark Fun.</p>
1407 </div>
1408 </div>
1409 <div class="sect2">
1410 <h3 id="_using_a_separate_pyro_battery_with_easymini">6.4. Using a Separate Pyro Battery with EasyMini</h3>
1411 <div class="paragraph">
1412 <p>As described above, using an external pyro battery involves
1413 connecting the negative battery terminal to the flight
1414 computer ground, connecting the positive battery terminal to
1415 one of the igniter leads and connecting the other igniter
1416 lead to the per-channel pyro circuit connection.</p>
1417 </div>
1418 <div class="paragraph">
1419 <p>To connect the negative pyro battery terminal to EasyMini
1420 ground, connect it to the negative external battery
1421 connection, top terminal 4.</p>
1422 </div>
1423 <div class="paragraph">
1424 <p>Connecting the switched positive battery terminal to the pyro
1425 charges must be done separate from EasyMini, by soldering
1426 them together or using some other connector.  Note that for
1427 safety, you must put a switch between the pyro battery and
1428 the rest of the circuit!</p>
1429 </div>
1430 <div class="paragraph">
1431 <p>The other lead from each pyro charge is then inserted into
1432 the appropriate per-pyro channel screw terminal (top
1433 terminal 1 for the Main charge, bottom terminal 1 for the
1434 Apogee charge).</p>
1435 </div>
1436 </div>
1437 <div class="sect2">
1438 <h3 id="_using_an_active_switch_with_easymini">6.5. Using an Active Switch with EasyMini</h3>
1439 <div class="paragraph">
1440 <p>As explained above, an external active switch requires three
1441 connections, one to the positive battery terminal, one to
1442 the flight computer positive input and one to ground. Use
1443 the negative external battery connection, top terminal 4 for
1444 ground.</p>
1445 </div>
1446 <div class="paragraph">
1447 <p>The positive battery terminal is available on bottom
1448 terminal 4, the positive flight computer input is on the
1449 bottom terminal 3.</p>
1450 </div>
1451 </div>
1452 </div>
1453 </div>
1454 <div class="sect1">
1455 <h2 id="_telemega">7. TeleMega</h2>
1456 <div class="sectionbody">
1457 <div class="imageblock">
1458 <div class="content">
1459 <img src="telemega-v1.0-top.jpg" alt="telemega v1.0 top" width="400">
1460 </div>
1461 <div class="title">Figure 6. TeleMega Board</div>
1462 </div>
1463 <div class="paragraph">
1464 <p>TeleMega is a 1¼ inch by 3¼ inch circuit board. It was
1465 designed to easily fit in a 38mm coupler. Like TeleMetrum,
1466 TeleMega has an accelerometer and so it must be mounted so that
1467 the board is aligned with the flight axis. It can be mounted
1468 either antenna up or down.</p>
1469 </div>
1470 <div class="paragraph">
1471 <p>TeleMega v2.0 has a few minor changes from v1.0:</p>
1472 </div>
1473 <div class="ulist">
1474 <ul>
1475 <li>
1476 <p>Companion connector matches EasyMega functions</p>
1477 </li>
1478 <li>
1479 <p>Serial port connector replaced with servo connector with
1480 support for up to 4 PWM channels.</p>
1481 </li>
1482 <li>
1483 <p>Radio switched from cc1120 to cc1200.</p>
1484 </li>
1485 </ul>
1486 </div>
1487 <div class="paragraph">
1488 <p>None of these affect operation using the stock firmware, but
1489 they do mean that the device needs different firmware to
1490 operate correctly, so make sure you load the right firmware
1491 when reflashing the device.</p>
1492 </div>
1493 <div class="sect2">
1494 <h3 id="_telemega_screw_terminals">7.1. TeleMega Screw Terminals</h3>
1495 <div class="paragraph">
1496 <p>TeleMega has two sets of nine screw terminals on the end of
1497 the board opposite the telemetry antenna. They are as follows:</p>
1498 </div>
1499 <table class="tableblock frame-all grid-all stretch">
1500 <caption class="title">Table 7. TeleMega Screw Terminals</caption>
1501 <colgroup>
1502 <col style="width: 13.3333%;">
1503 <col style="width: 20%;">
1504 <col style="width: 66.6667%;">
1505 </colgroup>
1506 <thead>
1507 <tr>
1508 <th class="tableblock halign-left valign-top">Terminal #</th>
1509 <th class="tableblock halign-left valign-top">Terminal Name</th>
1510 <th class="tableblock halign-left valign-top">Description</th>
1511 </tr>
1512 </thead>
1513 <tbody>
1514 <tr>
1515 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1516 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1517 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1518 </tr>
1519 <tr>
1520 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1521 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1522 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1523 </tr>
1524 <tr>
1525 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1526 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1527 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for use with external active switch</p></td>
1528 </tr>
1529 <tr>
1530 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1531 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1532 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1533 </tr>
1534 <tr>
1535 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 5</p></td>
1536 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1537 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1538 </tr>
1539 <tr>
1540 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 6</p></td>
1541 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1542 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1543 </tr>
1544 <tr>
1545 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 7</p></td>
1546 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1547 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1548 </tr>
1549 <tr>
1550 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 8</p></td>
1551 <td class="tableblock halign-left valign-top"><p class="tableblock">D -</p></td>
1552 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel connection to pyro circuit</p></td>
1553 </tr>
1554 <tr>
1555 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 9</p></td>
1556 <td class="tableblock halign-left valign-top"><p class="tableblock">D +</p></td>
1557 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel common connection to battery +</p></td>
1558 </tr>
1559 <tr>
1560 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1561 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1562 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for negative pyro battery terminal</p></td>
1563 </tr>
1564 <tr>
1565 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1566 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro</p></td>
1567 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive pyro battery terminal</p></td>
1568 </tr>
1569 <tr>
1570 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1571 <td class="tableblock halign-left valign-top"><p class="tableblock">Lipo</p></td>
1572 <td class="tableblock halign-left valign-top"><p class="tableblock">Power switch output. Use to connect main battery to pyro battery input</p></td>
1573 </tr>
1574 <tr>
1575 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1576 <td class="tableblock halign-left valign-top"><p class="tableblock">A -</p></td>
1577 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel connection to pyro circuit</p></td>
1578 </tr>
1579 <tr>
1580 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 5</p></td>
1581 <td class="tableblock halign-left valign-top"><p class="tableblock">A +</p></td>
1582 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel common connection to battery +</p></td>
1583 </tr>
1584 <tr>
1585 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 6</p></td>
1586 <td class="tableblock halign-left valign-top"><p class="tableblock">B -</p></td>
1587 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel connection to pyro circuit</p></td>
1588 </tr>
1589 <tr>
1590 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 7</p></td>
1591 <td class="tableblock halign-left valign-top"><p class="tableblock">B +</p></td>
1592 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel common connection to battery +</p></td>
1593 </tr>
1594 <tr>
1595 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 8</p></td>
1596 <td class="tableblock halign-left valign-top"><p class="tableblock">C -</p></td>
1597 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel connection to pyro circuit</p></td>
1598 </tr>
1599 <tr>
1600 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 9</p></td>
1601 <td class="tableblock halign-left valign-top"><p class="tableblock">C +</p></td>
1602 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel common connection to battery +</p></td>
1603 </tr>
1604 </tbody>
1605 </table>
1606 </div>
1607 <div class="sect2">
1608 <h3 id="_using_a_separate_pyro_battery_with_telemega">7.2. Using a Separate Pyro Battery with TeleMega</h3>
1609 <div class="paragraph">
1610 <p>TeleMega provides explicit support for an external pyro
1611 battery. All that is required is to remove the jumper
1612 between the lipo terminal (Bottom 3) and the pyro terminal
1613 (Bottom 2). Then hook the negative pyro battery terminal to
1614 ground (Bottom 1) and the switched positive pyro battery to
1615 the pyro battery input (Bottom 2). Note that you must include
1616 a switch between the pyro battery and the board for safety,
1617 as the on-board power switch circuit only supports the primary
1618 battery!  You can then use the existing pyro screw
1619 terminals to hook up all of the pyro charges.</p>
1620 </div>
1621 </div>
1622 <div class="sect2">
1623 <h3 id="_using_only_one_battery_with_telemega">7.3. Using Only One Battery With TeleMega</h3>
1624 <div class="paragraph">
1625 <p>Because TeleMega has built-in support for a separate pyro
1626 battery, if you want to fly with just one battery running
1627 both the computer and firing the charges, you need to
1628 connect the flight computer battery to the pyro
1629 circuit. TeleMega has two screw terminals for this—hook a
1630 wire from the Lipo terminal (Bottom 3) to the Pyro terminal
1631 (Bottom 2).</p>
1632 </div>
1633 </div>
1634 <div class="sect2">
1635 <h3 id="_using_an_active_switch_with_telemega">7.4. Using an Active Switch with TeleMega</h3>
1636 <div class="paragraph">
1637 <p>As explained above, an external active switch requires three
1638 connections, one to the positive battery terminal, one to
1639 the flight computer positive input and one to ground.</p>
1640 </div>
1641 <div class="paragraph">
1642 <p>The positive battery terminal is available on Top terminal
1643 1, the positive flight computer input is on Top terminal
1644 2. Ground is on Top terminal 3.</p>
1645 </div>
1646 </div>
1647 </div>
1648 </div>
1649 <div class="sect1">
1650 <h2 id="_easymega">8. EasyMega</h2>
1651 <div class="sectionbody">
1652 <div class="imageblock">
1653 <div class="content">
1654 <img src="easymega-v1.0-top.jpg" alt="easymega v1.0 top" width="400">
1655 </div>
1656 <div class="title">Figure 7. EasyMega Board</div>
1657 </div>
1658 <div class="paragraph">
1659 <p>EasyMega is a 1¼ inch by 2¼ inch circuit board. It was
1660 designed to easily fit in a 38mm coupler. Like TeleMetrum,
1661 EasyMega has an accelerometer and so it must be mounted so that
1662 the board is aligned with the flight axis. It can be mounted
1663 either antenna up or down.</p>
1664 </div>
1665 <div class="sect2">
1666 <h3 id="_easymega_screw_terminals">8.1. EasyMega Screw Terminals</h3>
1667 <div class="paragraph">
1668 <p>EasyMega has two sets of nine screw terminals on the end of
1669 the board opposite the telemetry antenna. They are as follows:</p>
1670 </div>
1671 <table class="tableblock frame-all grid-all stretch">
1672 <caption class="title">Table 8. EasyMega Screw Terminals</caption>
1673 <colgroup>
1674 <col style="width: 13.3333%;">
1675 <col style="width: 20%;">
1676 <col style="width: 66.6667%;">
1677 </colgroup>
1678 <thead>
1679 <tr>
1680 <th class="tableblock halign-left valign-top">Terminal #</th>
1681 <th class="tableblock halign-left valign-top">Terminal Name</th>
1682 <th class="tableblock halign-left valign-top">Description</th>
1683 </tr>
1684 </thead>
1685 <tbody>
1686 <tr>
1687 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1688 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1689 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1690 </tr>
1691 <tr>
1692 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1693 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1694 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1695 </tr>
1696 <tr>
1697 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1698 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1699 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for use with external active switch</p></td>
1700 </tr>
1701 <tr>
1702 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1703 <td class="tableblock halign-left valign-top"><p class="tableblock">Main -</p></td>
1704 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel connection to pyro circuit</p></td>
1705 </tr>
1706 <tr>
1707 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 5</p></td>
1708 <td class="tableblock halign-left valign-top"><p class="tableblock">Main +</p></td>
1709 <td class="tableblock halign-left valign-top"><p class="tableblock">Main pyro channel common connection to battery +</p></td>
1710 </tr>
1711 <tr>
1712 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 6</p></td>
1713 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee -</p></td>
1714 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel connection to pyro circuit</p></td>
1715 </tr>
1716 <tr>
1717 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 7</p></td>
1718 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee +</p></td>
1719 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro channel common connection to battery +</p></td>
1720 </tr>
1721 <tr>
1722 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 8</p></td>
1723 <td class="tableblock halign-left valign-top"><p class="tableblock">D -</p></td>
1724 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel connection to pyro circuit</p></td>
1725 </tr>
1726 <tr>
1727 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 9</p></td>
1728 <td class="tableblock halign-left valign-top"><p class="tableblock">D +</p></td>
1729 <td class="tableblock halign-left valign-top"><p class="tableblock">D pyro channel common connection to battery +</p></td>
1730 </tr>
1731 <tr>
1732 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1733 <td class="tableblock halign-left valign-top"><p class="tableblock">GND</p></td>
1734 <td class="tableblock halign-left valign-top"><p class="tableblock">Ground connection for negative pyro battery terminal</p></td>
1735 </tr>
1736 <tr>
1737 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1738 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro</p></td>
1739 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive pyro battery terminal</p></td>
1740 </tr>
1741 <tr>
1742 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1743 <td class="tableblock halign-left valign-top"><p class="tableblock">Lipo</p></td>
1744 <td class="tableblock halign-left valign-top"><p class="tableblock">Power switch output. Use to connect main battery to pyro battery input</p></td>
1745 </tr>
1746 <tr>
1747 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1748 <td class="tableblock halign-left valign-top"><p class="tableblock">A -</p></td>
1749 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel connection to pyro circuit</p></td>
1750 </tr>
1751 <tr>
1752 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 5</p></td>
1753 <td class="tableblock halign-left valign-top"><p class="tableblock">A +</p></td>
1754 <td class="tableblock halign-left valign-top"><p class="tableblock">A pyro channel common connection to battery +</p></td>
1755 </tr>
1756 <tr>
1757 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 6</p></td>
1758 <td class="tableblock halign-left valign-top"><p class="tableblock">B -</p></td>
1759 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel connection to pyro circuit</p></td>
1760 </tr>
1761 <tr>
1762 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 7</p></td>
1763 <td class="tableblock halign-left valign-top"><p class="tableblock">B +</p></td>
1764 <td class="tableblock halign-left valign-top"><p class="tableblock">B pyro channel common connection to battery +</p></td>
1765 </tr>
1766 <tr>
1767 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 8</p></td>
1768 <td class="tableblock halign-left valign-top"><p class="tableblock">C -</p></td>
1769 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel connection to pyro circuit</p></td>
1770 </tr>
1771 <tr>
1772 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 9</p></td>
1773 <td class="tableblock halign-left valign-top"><p class="tableblock">C +</p></td>
1774 <td class="tableblock halign-left valign-top"><p class="tableblock">C pyro channel common connection to battery +</p></td>
1775 </tr>
1776 </tbody>
1777 </table>
1778 </div>
1779 <div class="sect2">
1780 <h3 id="_using_a_separate_pyro_battery_with_easymega">8.2. Using a Separate Pyro Battery with EasyMega</h3>
1781 <div class="paragraph">
1782 <p>EasyMega provides explicit support for an external pyro
1783 battery. All that is required is to remove the jumper
1784 between the lipo terminal (Bottom 3) and the pyro terminal
1785 (Bottom 2). Then hook the negative pyro battery terminal to
1786 ground (Bottom 1) and the switched positive pyro battery to
1787 the pyro battery input (Bottom 2). Note that you must include
1788 a switch between the pyro battery and the board for safety,
1789 as the on-board power switch circuit only supports the primary
1790 battery!  You can then use the existing pyro screw
1791 terminals to hook up all of the pyro charges.</p>
1792 </div>
1793 </div>
1794 <div class="sect2">
1795 <h3 id="_using_only_one_battery_with_easymega">8.3. Using Only One Battery With EasyMega</h3>
1796 <div class="paragraph">
1797 <p>Because EasyMega has built-in support for a separate pyro
1798 battery, if you want to fly with just one battery running
1799 both the computer and firing the charges, you need to
1800 connect the flight computer battery to the pyro
1801 circuit. EasyMega has two screw terminals for this—hook a
1802 wire from the Lipo terminal (Bottom 3) to the Pyro terminal
1803 (Bottom 2).</p>
1804 </div>
1805 </div>
1806 <div class="sect2">
1807 <h3 id="_using_an_active_switch_with_easymega">8.4. Using an Active Switch with EasyMega</h3>
1808 <div class="paragraph">
1809 <p>As explained above, an external active switch requires three
1810 connections, one to the positive battery terminal, one to
1811 the flight computer positive input and one to ground.</p>
1812 </div>
1813 <div class="paragraph">
1814 <p>The positive battery terminal is available on Top terminal
1815 1, the positive flight computer input is on Top terminal
1816 2. Ground is on Top terminal 3.</p>
1817 </div>
1818 </div>
1819 </div>
1820 </div>
1821 <div class="sect1">
1822 <h2 id="_easytimer">9. EasyTimer</h2>
1823 <div class="sectionbody">
1824 <div class="imageblock">
1825 <div class="content">
1826 <img src="easytimer.jpg" alt="easytimer" width="400">
1827 </div>
1828 <div class="title">Figure 8. EasyTimer Board</div>
1829 </div>
1830 <div class="paragraph">
1831 <p>EasyTimer is built on a 0.8 inch by 1½ inch circuit board. It&#8217;s
1832 designed to fit in a 24mm coupler tube.</p>
1833 </div>
1834 <div class="paragraph">
1835 <p>EasyTimer is designed to control events during ascent. It has
1836 an accelerometer and gyroscope that can measure acceleration
1837 and rotation and compute speed and tilt angle. EasyTimer has
1838 two pyro channels which can be configured to fire at various
1839 points during flight. Because EasyTimer has no barometric
1840 sensor, it cannot be used to fire recovery charges at apogee
1841 or during descent. EasyTimer is configured using the AltosUI
1842 application which is available for Linux, Mac OS X and Windows.</p>
1843 </div>
1844 <div class="sect2">
1845 <h3 id="_easytimer_screw_terminals">9.1. EasyTimer Screw Terminals</h3>
1846 <div class="paragraph">
1847 <p>EasyTimer has two sets of four screw terminals near
1848 one end of the board. Using the picture above, the top
1849 four have connections for pyro channel B and an
1850 external battery and the bottom four have connections
1851 for pyro circuit A and the power switch. Counting from
1852 the left, the connections are as follows:</p>
1853 </div>
1854 <table class="tableblock frame-all grid-all stretch">
1855 <caption class="title">Table 9. EasyTimer Screw Terminals</caption>
1856 <colgroup>
1857 <col style="width: 13.3333%;">
1858 <col style="width: 20%;">
1859 <col style="width: 66.6667%;">
1860 </colgroup>
1861 <thead>
1862 <tr>
1863 <th class="tableblock halign-left valign-top">Terminal #</th>
1864 <th class="tableblock halign-left valign-top">Terminal Name</th>
1865 <th class="tableblock halign-left valign-top">Description</th>
1866 </tr>
1867 </thead>
1868 <tbody>
1869 <tr>
1870 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 1</p></td>
1871 <td class="tableblock halign-left valign-top"><p class="tableblock">B -</p></td>
1872 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel B connection to pyro circuit</p></td>
1873 </tr>
1874 <tr>
1875 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 2</p></td>
1876 <td class="tableblock halign-left valign-top"><p class="tableblock">B +</p></td>
1877 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel B common connection to battery +</p></td>
1878 </tr>
1879 <tr>
1880 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 3</p></td>
1881 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery +</p></td>
1882 <td class="tableblock halign-left valign-top"><p class="tableblock">Positive external battery terminal</p></td>
1883 </tr>
1884 <tr>
1885 <td class="tableblock halign-left valign-top"><p class="tableblock">Top 4</p></td>
1886 <td class="tableblock halign-left valign-top"><p class="tableblock">Battery -</p></td>
1887 <td class="tableblock halign-left valign-top"><p class="tableblock">Negative external battery terminal</p></td>
1888 </tr>
1889 <tr>
1890 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 1</p></td>
1891 <td class="tableblock halign-left valign-top"><p class="tableblock">A -</p></td>
1892 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel A connection to pyro circuit</p></td>
1893 </tr>
1894 <tr>
1895 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 2</p></td>
1896 <td class="tableblock halign-left valign-top"><p class="tableblock">A +</p></td>
1897 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro channel A common connection to battery +</p></td>
1898 </tr>
1899 <tr>
1900 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 3</p></td>
1901 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Output</p></td>
1902 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to flight computer</p></td>
1903 </tr>
1904 <tr>
1905 <td class="tableblock halign-left valign-top"><p class="tableblock">Bottom 4</p></td>
1906 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch Input</p></td>
1907 <td class="tableblock halign-left valign-top"><p class="tableblock">Switch connection to positive battery terminal</p></td>
1908 </tr>
1909 </tbody>
1910 </table>
1911 </div>
1912 <div class="sect2">
1913 <h3 id="_connecting_a_battery_to_easytimer">9.2. Connecting A Battery To EasyTimer</h3>
1914 <div class="paragraph">
1915 <p>There are two possible battery connections on
1916 EasyTimer. You can use either method; both feed
1917 through the power switch terminals.</p>
1918 </div>
1919 <div class="paragraph">
1920 <p>One battery connection is the standard Altus Metrum
1921 white JST plug. This mates with single-cell Lithium
1922 Polymer batteries sold by Altus Metrum.</p>
1923 </div>
1924 <div class="paragraph">
1925 <p>The other is a pair of screw terminals marked 'Battery
1926 +' and 'Battery -'. Connect a battery from 4 to 12
1927 volts to these terminals, being careful to match polarity.</p>
1928 </div>
1929 </div>
1930 <div class="sect2">
1931 <h3 id="_charging_lithium_batteries_2">9.3. Charging Lithium Batteries</h3>
1932 <div class="paragraph">
1933 <p>Because EasyTimer allows for batteries other than the
1934 standard Altus Metrum Lithium Polymer cells, it cannot
1935 incorporate a battery charger circuit. Therefore, when
1936 using a Litium Polymer cell, you&#8217;ll need an external
1937 charger. These are available from Altus Metrum, or
1938 from Spark Fun.</p>
1939 </div>
1940 </div>
1941 <div class="sect2">
1942 <h3 id="_using_a_separate_pyro_battery_with_easytimer">9.4. Using a Separate Pyro Battery with EasyTimer</h3>
1943 <div class="paragraph">
1944 <p>As described above, using an external pyro battery involves
1945 connecting the negative battery terminal to the flight
1946 computer ground, connecting the positive battery terminal to
1947 one of the igniter leads and connecting the other igniter
1948 lead to the per-channel pyro circuit connection.</p>
1949 </div>
1950 <div class="paragraph">
1951 <p>To connect the negative pyro battery terminal to EasyTimer
1952 ground, connect it to the negative external battery
1953 connection, top terminal 4.</p>
1954 </div>
1955 <div class="paragraph">
1956 <p>Connecting the switched positive battery terminal to the pyro
1957 charges must be done separate from EasyTimer, by soldering
1958 them together or using some other connector.  Note that for
1959 safety, you must put a switch between the pyro battery and
1960 the rest of the circuit!</p>
1961 </div>
1962 <div class="paragraph">
1963 <p>The other lead from each pyro charge is then inserted into
1964 the appropriate per-pyro channel screw terminal (top
1965 terminal 1 for pyro channel A charge, bottom terminal 1 for
1966 pyro channel B charge).</p>
1967 </div>
1968 </div>
1969 <div class="sect2">
1970 <h3 id="_using_an_active_switch_with_easytimer">9.5. Using an Active Switch with EasyTimer</h3>
1971 <div class="paragraph">
1972 <p>As explained above, an external active switch requires three
1973 connections, one to the positive battery terminal, one to
1974 the flight computer positive input and one to ground. Use
1975 the negative external battery connection, top terminal 4 for
1976 ground.</p>
1977 </div>
1978 <div class="paragraph">
1979 <p>The positive battery terminal is available on bottom
1980 terminal 4, the positive flight computer input is on the
1981 bottom terminal 3.</p>
1982 </div>
1983 </div>
1984 </div>
1985 </div>
1986 <div class="sect1">
1987 <h2 id="_installation">10. Installation</h2>
1988 <div class="sectionbody">
1989 <div class="paragraph">
1990 <p>A typical installation involves attaching
1991 only a suitable battery, a single pole switch for
1992 power on/off, and two pairs of wires connecting e-matches for the
1993 apogee and main ejection charges.  All Altus Metrum products are
1994 designed for use with single-cell batteries with 3.7 volts
1995 nominal.
1996 EasyMini may also be used with other
1997 batteries as long as they supply between 4 and 12 volts.</p>
1998 </div>
1999 <div class="paragraph">
2000 <p>The battery connectors are a standard 2-pin JST connector; you
2001 can purchase suitable batteries from the any vendor selling
2002 Altus Metrum products. These batteries are
2003 single-cell Lithium Polymer batteries that nominally provide 3.7
2004 volts.  Other vendors sell similar batteries for RC aircraft
2005 using mating connectors, however the polarity for those is
2006 generally reversed from the batteries used by Altus Metrum
2007 products. In particular, the Tenergy batteries supplied for use
2008 in Featherweight flight computers are not compatible with Altus
2009 Metrum flight computers or battery chargers.</p>
2010 </div>
2011 <div class="admonitionblock warning">
2012 <table>
2013 <tr>
2014 <td class="icon">
2015 <img src="./images/icons/warning.svg" alt="Warning">
2016 </td>
2017 <td class="content">
2018 Check polarity and voltage before connecting any battery not
2019 purchased from Altus Metrum.
2020 </td>
2021 </tr>
2022 </table>
2023 </div>
2024 <div class="admonitionblock warning">
2025 <table>
2026 <tr>
2027 <td class="icon">
2028 <img src="./images/icons/warning.svg" alt="Warning">
2029 </td>
2030 <td class="content">
2031 Spark Fun sells batteries that have a matching connector with
2032 the correct polarity. However, these batteries include an
2033 integrated current limiting circuit. That circuit will cause
2034 the battery to shut down when firing the igniter circuit. Do
2035 not use these batteries unless you remove the current limiting
2036 circuit.
2037 </td>
2038 </tr>
2039 </table>
2040 </div>
2041 <div class="paragraph">
2042 <p>By default, we use the unregulated output of the battery
2043 directly to fire ejection charges.  This works marvelously
2044 with standard low-current e-matches like the J-Tek from MJG
2045 Technologies, and with Quest Q2G2 igniters.  However, if you
2046 want or need to use a separate pyro battery, check out
2047 <a href="#_using_a_separate_pyro_battery">Using a Separate Pyro Battery</a> for instructions on how to wire
2048 that up. The altimeters are designed to work with an external
2049 pyro battery of no more than 15 volts.</p>
2050 </div>
2051 <div class="paragraph">
2052 <p>Ejection charges are wired directly to the screw terminal block
2053 at the aft end of the altimeter.  You&#8217;ll need a very small straight
2054 blade screwdriver for these screws, such as you might find in a
2055 jeweler&#8217;s screwdriver set.</p>
2056 </div>
2057 <div class="paragraph">
2058 <p>Except for TeleMini v1.0, the flight computers also use the
2059 screw terminal block for the power switch leads. On TeleMini v1.0,
2060 the power switch leads are soldered directly to the board and
2061 can be connected directly to a switch.</p>
2062 </div>
2063 <div class="paragraph">
2064 <p>For most air-frames, the integrated antennas are more than
2065 adequate.   However, if you are installing in a carbon-fiber or
2066 metal electronics bay which is opaque to RF signals, you may need to
2067 use off-board external antennas instead.  In this case, you can
2068 replace the stock UHF antenna wire with an edge-launched SMA connector,
2069 and, on TeleMetrum v1, you can unplug the integrated GPS
2070 antenna and select an appropriate off-board GPS antenna with
2071 cable terminating in a U.FL connector.</p>
2072 </div>
2073 </div>
2074 </div>
2075 <div class="sect1">
2076 <h2 id="_using_altus_metrum_products">11. Using Altus Metrum Products</h2>
2077 <div class="sectionbody">
2078 <div class="sect2">
2079 <h3 id="_being_legal">11.1. Being Legal</h3>
2080 <div class="paragraph">
2081 <p>In the US, you need an
2082 <a href="http://www.altusmetrum.org/Radio/">amateur radio license</a>
2083 or other authorization to legally operate the radio
2084 transmitters that are part of our products.</p>
2085 </div>
2086 </div>
2087 <div class="sect2">
2088 <h3 id="_in_the_rocket">11.2. In the Rocket</h3>
2089 <div class="paragraph">
2090 <p>In the rocket itself, you just need a flight computer
2091 and a single-cell, 3.7 volt nominal Li-Po rechargeable
2092 battery.
2093 An 850mAh battery weighs less than a 9V
2094 alkaline battery, and will run a TeleMetrum, TeleMega,
2095 EasyMega or EasyTimer for hours.
2096 A 110mAh battery weighs less
2097 than a triple A battery and is a good choice for use
2098 with
2099 TeleMini or
2100 EasyMini.</p>
2101 </div>
2102 <div class="paragraph">
2103 <p>By default, we ship TeleMini, TeleMetrum and TeleMega
2104 flight computers with a simple wire antenna.  If your
2105 electronics bay or the air-frame it resides within is
2106 made of carbon fiber, which is opaque to RF signals,
2107 you may prefer to install an SMA connector so that you
2108 can run a coaxial cable to an antenna mounted
2109 elsewhere in the rocket.  However, note that the GPS
2110 antenna is fixed on all current products, so you
2111 really want to install the flight computer in a bay
2112 made of RF-transparent materials if at all possible.</p>
2113 </div>
2114 </div>
2115 <div class="sect2">
2116 <h3 id="_on_the_ground">11.3. On the Ground</h3>
2117 <div class="paragraph">
2118 <p>To receive the data stream from the rocket, you need
2119 an antenna and short feed-line connected to one of our
2120 <a href="http://www.altusmetrum.org/TeleDongle/">TeleDongle</a>
2121 units.  If possible, use an SMA to BNC adapter instead
2122 of feedline between the antenna feedpoint and
2123 TeleDongle, as this will give you the best
2124 performance.  The TeleDongle in turn plugs directly
2125 into the USB port on a notebook computer.  Because
2126 TeleDongle looks like a simple serial port, your
2127 computer does not require special device
2128 drivers&#8230;&#8203; just plug it in.</p>
2129 </div>
2130 <div class="paragraph">
2131 <p>The GUI tool, AltosUI, is written in Java and runs
2132 across Linux, Mac OS and Windows. There&#8217;s also a suite
2133 of C tools for Linux which can perform most of the
2134 same tasks.</p>
2135 </div>
2136 <div class="paragraph">
2137 <p>Alternatively, a TeleBT attached with an SMA to BNC
2138 adapter at the feed point of a hand-held yagi used in
2139 conjunction with an Android device running AltosDroid
2140 makes an outstanding ground station.</p>
2141 </div>
2142 <div class="paragraph">
2143 <p>After the flight,
2144 you can use the radio link to
2145 extract the more detailed data logged in either
2146 TeleMetrum or TeleMini devices, or
2147 you can use a
2148 USB cable to plug into the flight computer board directly.
2149 A USB cable is also how you
2150 charge the Li-Po battery, so you&#8217;ll want one of those
2151 anyway. The same cable used by lots of digital
2152 cameras and other modern electronic stuff will work
2153 fine.</p>
2154 </div>
2155 <div class="paragraph">
2156 <p>If your rocket lands out of sight, you may enjoy
2157 having a hand-held GPS receiver, so that you can put
2158 in a way-point for the last reported rocket position
2159 before touch-down.  This makes looking for your rocket
2160 a lot like Geo-Caching&#8230;&#8203; just go to the way-point and
2161 look around starting from there.  AltosDroid on an
2162 Android device with GPS receiver works great for this,
2163 too!</p>
2164 </div>
2165 <div class="paragraph">
2166 <p>You may also enjoy having a ham radio “HT” that covers
2167 the 70cm band&#8230;&#8203; you can use that with your antenna to
2168 direction-find the rocket on the ground the same way
2169 you can use a Walston or Beeline tracker.  This can be
2170 handy if the rocket is hiding in sage brush or a tree,
2171 or if the last GPS position doesn&#8217;t get you close
2172 enough because the rocket dropped into a canyon, or
2173 the wind is blowing it across a dry lake bed, or
2174 something like that&#8230;&#8203;  Keith currently uses a Yaesu
2175 FT1D, Bdale has a Yaesu VX-7R, which is a nicer radio
2176 in most ways but doesn&#8217;t support APRS.</p>
2177 </div>
2178 <div class="paragraph">
2179 <p>So, to recap, on the ground the hardware you&#8217;ll need includes:</p>
2180 </div>
2181 <div class="olist arabic">
2182 <ol class="arabic">
2183 <li>
2184 <p>an antenna and feed-line or adapter</p>
2185 </li>
2186 <li>
2187 <p>a TeleDongle</p>
2188 </li>
2189 <li>
2190 <p>a notebook computer</p>
2191 </li>
2192 <li>
2193 <p>optionally, a hand-held GPS receiver</p>
2194 </li>
2195 <li>
2196 <p>optionally, an HT or receiver covering 435 MHz</p>
2197 </li>
2198 </ol>
2199 </div>
2200 <div class="paragraph">
2201 <p>The best hand-held commercial directional antennas we&#8217;ve found for radio
2202 direction finding rockets are from
2203 <a href="http://www.arrowantennas.com/">Arrow Antennas</a>.</p>
2204 </div>
2205 <div class="paragraph">
2206 <p>The 440-3 and 440-5 are both good choices for finding
2207 a TeleMetrum- or TeleMini- equipped rocket when used
2208 with a suitable 70cm HT.  TeleDongle and an SMA to BNC
2209 adapter fit perfectly between the driven element and
2210 reflector of Arrow antennas.</p>
2211 </div>
2212 </div>
2213 <div class="sect2">
2214 <h3 id="_data_analysis">11.4. Data Analysis</h3>
2215 <div class="paragraph">
2216 <p>Our software makes it easy to log the data from each
2217 flight, both the telemetry received during the flight
2218 itself, and the more complete data log recorded in the
2219 flash memory on the altimeter board.  Once this data
2220 is on your computer, our post-flight tools make it
2221 easy to quickly get to the numbers everyone wants,
2222 like apogee altitude, max acceleration, and max
2223 velocity.  You can also generate and view a standard
2224 set of plots showing the altitude, acceleration, and
2225 velocity of the rocket during flight.  And you can
2226 even export a flight log in a format usable with Google
2227 Maps and Google Earth for visualizing the flight path
2228 in two or three dimensions!</p>
2229 </div>
2230 <div class="paragraph">
2231 <p>Our ultimate goal is to emit a set of files for each
2232 flight that can be published as a web page per flight,
2233 or just viewed on your local disk with a web browser.</p>
2234 </div>
2235 </div>
2236 <div class="sect2">
2237 <h3 id="_future_plans">11.5. Future Plans</h3>
2238 <div class="paragraph">
2239 <p>We have designed and prototyped several “companion
2240 boards” that can attach to the companion connector on
2241 TeleMetrum, TeleMega and EasyMega flight computers to
2242 collect more data, provide more pyro channels, and so
2243 forth.  We do not yet know if or when any of these
2244 boards will be produced in enough quantity to sell.
2245 If you have specific interests for data collection or
2246 control of events in your rockets beyond the
2247 capabilities of our existing productions, please let
2248 us know!</p>
2249 </div>
2250 <div class="paragraph">
2251 <p>Because all of our work is open, both the hardware
2252 designs and the software, if you have some great idea
2253 for an addition to the current Altus Metrum family,
2254 feel free to dive in and help!  Or let us know what
2255 you&#8217;d like to see that we aren&#8217;t already working on,
2256 and maybe we&#8217;ll get excited about it too&#8230;&#8203;</p>
2257 </div>
2258 <div class="paragraph">
2259 <p>Watch our <a href="http://altusmetrum.org/">web site</a> for
2260 more news and information as our family of products
2261 evolves!</p>
2262 </div>
2263 </div>
2264 </div>
2265 </div>
2266 <div class="sect1">
2267 <h2 id="_altosui">12. AltosUI</h2>
2268 <div class="sectionbody">
2269 <div class="imageblock">
2270 <div class="content">
2271 <img src="altosui.png" alt="altosui" width="450">
2272 </div>
2273 <div class="title">Figure 9. AltosUI Main Window</div>
2274 </div>
2275 <div class="paragraph">
2276 <p>The AltosUI program provides a graphical user interface for
2277 interacting with the Altus Metrum product family. AltosUI can
2278 monitor telemetry data, configure devices and many other
2279 tasks. The primary interface window provides a selection of
2280 buttons, one for each major activity in the system.  This
2281 chapter is split into sections, each of which documents one of
2282 the tasks provided from the top-level toolbar.</p>
2283 </div>
2284 <div class="sect2">
2285 <h3 id="_monitor_flight">12.1. Monitor Flight</h3>
2286 <div class="paragraph">
2287 <p>Selecting this item brings up a dialog box listing all
2288 of the connected TeleDongle devices. When you choose
2289 one of these, AltosUI will create a window to display
2290 telemetry data as received by the selected TeleDongle
2291 device.</p>
2292 </div>
2293 <div class="imageblock">
2294 <div class="content">
2295 <img src="device-selection.png" alt="device selection" width="300">
2296 </div>
2297 <div class="title">Figure 10. Device Selection Dialog</div>
2298 </div>
2299 <div class="paragraph">
2300 <p>All telemetry data received are automatically recorded
2301 in suitable log files. The name of the files includes
2302 the current date and rocket serial and flight numbers.</p>
2303 </div>
2304 <div class="paragraph">
2305 <p>The radio frequency being monitored by the TeleDongle
2306 device is displayed at the top of the window. You can
2307 configure the frequency by clicking on the frequency
2308 box and selecting the desired frequency. AltosUI
2309 remembers the last frequency selected for each
2310 TeleDongle and selects that automatically the next
2311 time you use that device.</p>
2312 </div>
2313 <div class="paragraph">
2314 <p>Below the TeleDongle frequency selector, the window
2315 contains a few significant pieces of information about
2316 the altimeter providing the telemetry data stream:</p>
2317 </div>
2318 <div class="ulist">
2319 <ul>
2320 <li>
2321 <p>The configured call-sign</p>
2322 </li>
2323 <li>
2324 <p>The device serial number</p>
2325 </li>
2326 <li>
2327 <p>The flight number. Each altimeter remembers how
2328 many times it has flown.</p>
2329 </li>
2330 <li>
2331 <p>The rocket flight state. Each flight passes through
2332 several states including Pad, Boost, Fast, Coast,
2333 Drogue, Main and Landed.</p>
2334 </li>
2335 <li>
2336 <p>The Received Signal Strength Indicator value. This
2337 lets you know how strong a signal TeleDongle is
2338 receiving. At the default data rate, 38400 bps, in
2339 bench testing, the radio inside TeleDongle v0.2
2340 operates down to about -106dBm, while the v3 radio
2341 works down to about -111dBm.  Weaker signals, or an
2342 environment with radio noise may cause the data to
2343 not be received. The packet link uses error
2344 detection and correction techniques which prevent
2345 incorrect data from being reported.</p>
2346 </li>
2347 <li>
2348 <p>The age of the displayed data, in seconds since the
2349 last successfully received telemetry packet.  In
2350 normal operation this will stay in the low single
2351 digits.  If the number starts counting up, then you
2352 are no longer receiving data over the radio link
2353 from the flight computer.</p>
2354 </li>
2355 </ul>
2356 </div>
2357 <div class="paragraph">
2358 <p>Finally, the largest portion of the window contains a
2359 set of tabs, each of which contain some information
2360 about the rocket.  They&#8217;re arranged in 'flight order'
2361 so that as the flight progresses, the selected tab
2362 automatically switches to display data relevant to the
2363 current state of the flight. You can select other tabs
2364 at any time. The final 'table' tab displays all of the
2365 raw telemetry values in one place in a
2366 spreadsheet-like format.</p>
2367 </div>
2368 <div class="sect3">
2369 <h4 id="_launch_pad">12.1.1. Launch Pad</h4>
2370 <div class="imageblock">
2371 <div class="content">
2372 <img src="launch-pad.png" alt="launch pad" width="400">
2373 </div>
2374 <div class="title">Figure 11. Monitor Flight Launch Pad View</div>
2375 </div>
2376 <div class="paragraph">
2377 <p>The 'Launch Pad' tab shows information used to decide when the
2378 rocket is ready for flight. The first elements include red/green
2379 indicators, if any of these is red, you&#8217;ll want to evaluate
2380 whether the rocket is ready to launch:</p>
2381 </div>
2382 <div class="dlist">
2383 <dl>
2384 <dt class="hdlist1">Battery Voltage</dt>
2385 <dd>
2386 <p>This indicates whether the Li-Po battery powering the
2387 flight computer has sufficient charge to last for
2388 the duration of the flight. A value of more than
2389 3.8V is required for a 'GO' status.</p>
2390 </dd>
2391 <dt class="hdlist1">Apogee Igniter Voltage</dt>
2392 <dd>
2393 <p>This indicates whether the apogee
2394 igniter has continuity. If the igniter has a low
2395 resistance, then the voltage measured here will be close
2396 to the Li-Po battery voltage. A value greater than 3.2V is
2397 required for a 'GO' status.</p>
2398 </dd>
2399 <dt class="hdlist1">Main Igniter Voltage</dt>
2400 <dd>
2401 <p>This indicates whether the main
2402 igniter has continuity. If the igniter has a low
2403 resistance, then the voltage measured here will be close
2404 to the Li-Po battery voltage. A value greater than 3.2V is
2405 required for a 'GO' status.</p>
2406 </dd>
2407 <dt class="hdlist1">On-board Data Logging</dt>
2408 <dd>
2409 <p>This indicates whether there is space remaining
2410 on-board to store flight data for the upcoming
2411 flight. If you&#8217;ve downloaded data, but failed to erase
2412 flights, there may not be any space left. Most of our
2413 flight computers can store multiple flights, depending
2414 on the configured maximum flight log size. TeleMini
2415 v1.0 stores only a single flight, so it will need to
2416 be downloaded and erased after each flight to capture
2417 data. This only affects on-board flight logging; the
2418 altimeter will still transmit telemetry and fire
2419 ejection charges at the proper times even if the
2420 flight data storage is full.</p>
2421 </dd>
2422 <dt class="hdlist1">GPS Locked</dt>
2423 <dd>
2424 <p>For a TeleMetrum or TeleMega device, this indicates
2425 whether the GPS receiver is currently able to compute
2426 position information. GPS requires at least 4
2427 satellites to compute an accurate position.</p>
2428 </dd>
2429 <dt class="hdlist1">GPS Ready</dt>
2430 <dd>
2431 <p>For a TeleMetrum or TeleMega device, this indicates
2432 whether GPS has reported at least 10 consecutive
2433 positions without losing lock. This ensures that the
2434 GPS receiver has reliable reception from the
2435 satellites.</p>
2436 </dd>
2437 </dl>
2438 </div>
2439 <div class="paragraph">
2440 <p>The Launchpad tab also shows the computed launch pad
2441 position and altitude, averaging many reported
2442 positions to improve the accuracy of the fix.</p>
2443 </div>
2444 </div>
2445 <div class="sect3">
2446 <h4 id="_ascent">12.1.2. Ascent</h4>
2447 <div class="imageblock">
2448 <div class="content">
2449 <img src="ascent.png" alt="ascent" width="400">
2450 </div>
2451 <div class="title">Figure 12. Monitor Flight Ascent View</div>
2452 </div>
2453 <div class="paragraph">
2454 <p>This tab is shown during Boost, Fast and Coast
2455 phases. The information displayed here helps monitor the
2456 rocket as it heads towards apogee.</p>
2457 </div>
2458 <div class="paragraph">
2459 <p>The height, speed, acceleration and tilt are shown along
2460 with the maximum values for each of them. This allows you to
2461 quickly answer the most commonly asked questions you&#8217;ll hear
2462 during flight.</p>
2463 </div>
2464 <div class="paragraph">
2465 <p>The current latitude and longitude reported by the GPS are
2466 also shown. Note that under high acceleration, these values
2467 may not get updated as the GPS receiver loses position
2468 fix. Once the rocket starts coasting, the receiver should
2469 start reporting position again.</p>
2470 </div>
2471 <div class="paragraph">
2472 <p>Finally, the current igniter voltages are reported as in the
2473 Launch Pad tab. This can help diagnose deployment failures
2474 caused by wiring which comes loose under high acceleration.</p>
2475 </div>
2476 </div>
2477 <div class="sect3">
2478 <h4 id="_descent">12.1.3. Descent</h4>
2479 <div class="imageblock">
2480 <div class="content">
2481 <img src="descent.png" alt="descent" width="400">
2482 </div>
2483 <div class="title">Figure 13. Monitor Flight Descent View</div>
2484 </div>
2485 <div class="paragraph">
2486 <p>Once the rocket has reached apogee and (we hope)
2487 activated the apogee charge, attention switches to
2488 tracking the rocket on the way back to the ground, and
2489 for dual-deploy flights, waiting for the main charge
2490 to fire.</p>
2491 </div>
2492 <div class="paragraph">
2493 <p>To monitor whether the apogee charge operated
2494 correctly, the current descent rate is reported along
2495 with the current height. Good descent rates vary based
2496 on the choice of recovery components, but generally
2497 range from 15-30m/s on drogue and should be below
2498 10m/s when under the main parachute in a dual-deploy
2499 flight.</p>
2500 </div>
2501 <div class="paragraph">
2502 <p>With GPS-equipped flight computers, you can locate the
2503 rocket in the sky using the elevation and bearing
2504 information to figure out where to look. Elevation is
2505 in degrees above the horizon. Bearing is reported in
2506 degrees relative to true north. Range can help figure
2507 out how big the rocket will appear. Ground Distance
2508 shows how far it is to a point directly under the
2509 rocket and can help figure out where the rocket is
2510 likely to land. Note that all of these values are
2511 relative to the pad location. If the elevation is near
2512 90°, the rocket is over the pad, not over you.</p>
2513 </div>
2514 <div class="paragraph">
2515 <p>Finally, the igniter voltages are reported in this tab
2516 as well, both to monitor the main charge as well as to
2517 see what the status of the apogee charge is.  Note
2518 that some commercial e-matches are designed to retain
2519 continuity even after being fired, and will continue
2520 to show as green or return from red to green after
2521 firing.</p>
2522 </div>
2523 </div>
2524 <div class="sect3">
2525 <h4 id="_landed">12.1.4. Landed</h4>
2526 <div class="imageblock">
2527 <div class="content">
2528 <img src="landed.png" alt="landed" width="400">
2529 </div>
2530 <div class="title">Figure 14. Monitor Flight Landed View</div>
2531 </div>
2532 <div class="paragraph">
2533 <p>Once the rocket is on the ground, attention switches
2534 to recovery. While the radio signal is often lost once
2535 the rocket is on the ground, the last reported GPS
2536 position is generally within a short distance of the
2537 actual landing location.</p>
2538 </div>
2539 <div class="paragraph">
2540 <p>The last reported GPS position is reported both by
2541 latitude and longitude as well as a bearing and
2542 distance from the launch pad. The distance should give
2543 you a good idea of whether to walk or hitch a ride.
2544 Take the reported latitude and longitude and enter
2545 them into your hand-held GPS unit and have that
2546 compute a track to the landing location.</p>
2547 </div>
2548 <div class="paragraph">
2549 <p>Our flight computers will continue to transmit RDF
2550 tones after landing, allowing you to locate the rocket
2551 by following the radio signal if necessary. You may
2552 need to get away from the clutter of the flight line,
2553 or even get up on a hill (or your neighbor&#8217;s RV roof)
2554 to receive the RDF signal.</p>
2555 </div>
2556 <div class="paragraph">
2557 <p>The maximum height, speed and acceleration reported
2558 during the flight are displayed for your admiring
2559 observers.  The accuracy of these immediate values
2560 depends on the quality of your radio link and how many
2561 packets were received.  Recovering the on-board data
2562 after flight may yield more precise results.</p>
2563 </div>
2564 <div class="paragraph">
2565 <p>To get more detailed information about the flight, you
2566 can click on the 'Graph Flight' button which will
2567 bring up a graph window for the current flight.</p>
2568 </div>
2569 </div>
2570 <div class="sect3">
2571 <h4 id="_table">12.1.5. Table</h4>
2572 <div class="imageblock">
2573 <div class="content">
2574 <img src="table.png" alt="table" width="400">
2575 </div>
2576 <div class="title">Figure 15. Monitor Flight Table View</div>
2577 </div>
2578 <div class="paragraph">
2579 <p>The table view shows all of the data available from the
2580 flight computer. Probably the most useful data on
2581 this tab is the detailed GPS information, which includes
2582 horizontal dilution of precision information, and
2583 information about the signal being received from the satellites.</p>
2584 </div>
2585 </div>
2586 <div class="sect3">
2587 <h4 id="_site_map">12.1.6. Site Map</h4>
2588 <div class="imageblock">
2589 <div class="content">
2590 <img src="site-map.png" alt="site map" width="400">
2591 </div>
2592 <div class="title">Figure 16. Monitor Flight Site Map View</div>
2593 </div>
2594 <div class="paragraph">
2595 <p>When the TeleMetrum has a GPS fix, the Site Map tab
2596 will map the rocket&#8217;s position to make it easier for
2597 you to locate the rocket, both while it is in the air,
2598 and when it has landed. The rocket&#8217;s state is
2599 indicated by color: white for pad, red for boost, pink
2600 for fast, yellow for coast, light blue for drogue,
2601 dark blue for main, and black for landed.</p>
2602 </div>
2603 <div class="paragraph">
2604 <p>The map&#8217;s default scale is approximately 3m (10ft) per
2605 pixel. The map can be dragged using the left mouse
2606 button. The map will attempt to keep the rocket
2607 roughly centered while data is being received.</p>
2608 </div>
2609 <div class="paragraph">
2610 <p>You can adjust the style of map and the zoom level
2611 with buttons on the right side of the map window. You
2612 can draw a line on the map by moving the mouse over
2613 the map with a button other than the left one pressed,
2614 or by pressing the left button while also holding down
2615 the shift key. The length of the line in real-world
2616 units will be shown at the start of the line.</p>
2617 </div>
2618 <div class="paragraph">
2619 <p>Images are fetched automatically via the Google Maps
2620 Static API, and cached on disk for reuse. If map
2621 images cannot be downloaded, the rocket&#8217;s path will be
2622 traced on a dark gray background instead.</p>
2623 </div>
2624 <div class="paragraph">
2625 <p>You can pre-load images for your favorite launch sites
2626 before you leave home; check out <a href="#_load_maps">Load Maps</a>.</p>
2627 </div>
2628 </div>
2629 <div class="sect3">
2630 <h4 id="_igniter">12.1.7. Igniter</h4>
2631 <div class="imageblock">
2632 <div class="content">
2633 <img src="ignitor.png" alt="ignitor" width="400">
2634 </div>
2635 <div class="title">Figure 17. Monitor Flight Additional Igniter View</div>
2636 </div>
2637 <div class="paragraph">
2638 <p>TeleMega includes four additional programmable pyro
2639 channels. The Ignitor tab shows whether each of them has
2640 continuity. If an ignitor has a low resistance, then the
2641 voltage measured here will be close to the pyro battery
2642 voltage. A value greater than 3.2V is required for a 'GO'
2643 status.</p>
2644 </div>
2645 </div>
2646 </div>
2647 <div class="sect2">
2648 <h3 id="_save_flight_data">12.2. Save Flight Data</h3>
2649 <div class="paragraph">
2650 <p>The altimeter records flight data to its internal
2651 flash memory.
2652 Data logged on board is recorded at a much
2653 higher rate than the telemetry system can handle, and
2654 is not subject to radio drop-outs. As such, it
2655 provides a more complete and precise record of the
2656 flight.
2657 The 'Save Flight Data' button allows you to
2658 read the flash memory and write it to disk.</p>
2659 </div>
2660 <div class="paragraph">
2661 <p>Clicking on the 'Save Flight Data' button brings up a
2662 list of connected flight computers and TeleDongle
2663 devices. If you select a flight computer, the flight
2664 data will be downloaded from that device directly.
2665 If you select a TeleDongle device, flight data will be
2666 downloaded from a flight computer over radio link via
2667 the specified TeleDongle. See
2668 <a href="#_controlling_an_altimeter_over_the_radio_link">Controlling An Altimeter Over The Radio Link</a> for
2669 more information.</p>
2670 </div>
2671 <div class="paragraph">
2672 <p>After the device has been selected, a dialog showing
2673 the flight data saved in the device will be shown
2674 allowing you to select which flights to download and
2675 which to delete. With version 0.9 or newer firmware,
2676 you must erase flights in order for the space they
2677 consume to be reused by another flight. This prevents
2678 accidentally losing flight data if you neglect to
2679 download data before flying again. Note that if there
2680 is no more space available in the device, then no data
2681 will be recorded during the next flight.</p>
2682 </div>
2683 <div class="paragraph">
2684 <p>The file name for each flight log is computed
2685 automatically from the recorded flight date, altimeter
2686 serial number and flight number information.</p>
2687 </div>
2688 </div>
2689 <div class="sect2">
2690 <h3 id="_replay_flight">12.3. Replay Flight</h3>
2691 <div class="paragraph">
2692 <p>Select this button and you are prompted to select a flight
2693 record file, either a .telem file recording telemetry data or a
2694 .eeprom file containing flight data saved from the altimeter
2695 flash memory.</p>
2696 </div>
2697 <div class="paragraph">
2698 <p>Once a flight record is selected, the flight monitor interface
2699 is displayed and the flight is re-enacted in real
2700 time.
2701 Check
2702 <a href="#_monitor_flight">Monitor Flight</a> to learn how this window operates.</p>
2703 </div>
2704 </div>
2705 <div class="sect2">
2706 <h3 id="_graph_data">12.4. Graph Data</h3>
2707 <div class="paragraph">
2708 <p>Select this button and you are prompted to select a flight
2709 record file, either a .telem file recording telemetry data or a
2710 .eeprom file containing flight data saved from
2711 flash memory.</p>
2712 </div>
2713 <div class="paragraph">
2714 <p>Note that telemetry files will generally produce poor graphs
2715 due to the lower sampling rate and missed telemetry packets.
2716 Use saved flight data in .eeprom files for graphing where possible.</p>
2717 </div>
2718 <div class="paragraph">
2719 <p>Once a flight record is selected, a window with multiple tabs is
2720 opened.</p>
2721 </div>
2722 <div class="sect3">
2723 <h4 id="_flight_graph">12.4.1. Flight Graph</h4>
2724 <div class="imageblock">
2725 <div class="content">
2726 <img src="graph.png" alt="graph" width="400">
2727 </div>
2728 <div class="title">Figure 18. Flight Data Graph</div>
2729 </div>
2730 <div class="paragraph">
2731 <p>By default, the graph contains acceleration (blue),
2732 velocity (green) and altitude (red).</p>
2733 </div>
2734 <div class="paragraph">
2735 <p>The graph can be zoomed into a particular area by
2736 clicking and dragging down and to the right. Once
2737 zoomed, the graph can be reset by clicking and
2738 dragging up and to the left. Holding down control and
2739 clicking and dragging allows the graph to be panned.
2740 The right mouse button causes a pop-up menu to be
2741 displayed, giving you the option save or print the
2742 plot.</p>
2743 </div>
2744 </div>
2745 <div class="sect3">
2746 <h4 id="_configure_graph">12.4.2. Configure Graph</h4>
2747 <div class="imageblock">
2748 <div class="content">
2749 <img src="graph-configure.png" alt="graph configure" width="400">
2750 </div>
2751 <div class="title">Figure 19. Flight Graph Configuration</div>
2752 </div>
2753 <div class="paragraph">
2754 <p>This selects which graph elements to show, and, at the
2755 very bottom. It also lets you configure how
2756 the graph is drawn:</p>
2757 </div>
2758 <div class="ulist">
2759 <ul>
2760 <li>
2761 <p>Whether to use metric or imperial units</p>
2762 </li>
2763 <li>
2764 <p>Whether to show a marker at each data
2765 point. When displaying a small section of
2766 the graph, these can be useful to know what
2767 data values were recorded.</p>
2768 </li>
2769 <li>
2770 <p>How wide to draw the lines in the graph</p>
2771 </li>
2772 <li>
2773 <p>How to filter speed and acceleration data
2774 computed from barometric data. Flight
2775 computers with accelerometers never display
2776 computed acceleration data, and only use
2777 barometric data to compute speed during
2778 descent. Flight computers without
2779 accelerometers always compute both speed and
2780 acceleration from barometric data. A larger
2781 value smooths the data more.</p>
2782 </li>
2783 </ul>
2784 </div>
2785 </div>
2786 <div class="sect3">
2787 <h4 id="_flight_statistics">12.4.3. Flight Statistics</h4>
2788 <div class="imageblock">
2789 <div class="content">
2790 <img src="graph-stats.png" alt="graph stats" width="400">
2791 </div>
2792 <div class="title">Figure 20. Flight Statistics</div>
2793 </div>
2794 <div class="paragraph">
2795 <p>Shows overall data computed from the flight.</p>
2796 </div>
2797 </div>
2798 <div class="sect3">
2799 <h4 id="_map">12.4.4. Map</h4>
2800 <div class="imageblock">
2801 <div class="content">
2802 <img src="graph-map.png" alt="graph map" width="400">
2803 </div>
2804 <div class="title">Figure 21. Flight Map</div>
2805 </div>
2806 <div class="paragraph">
2807 <p>Shows a satellite image of the flight area
2808 overlaid with the path of the flight. The
2809 flight path will have different colored
2810 sections for each state of the flight (just
2811 like the Site Map in Monitor Flight mode):
2812 white for pad, red for boost, pink for fast,
2813 yellow for coast, light blue for drogue, dark
2814 blue for main, and black for landed.</p>
2815 </div>
2816 <div class="paragraph">
2817 <p>The red concentric circles mark the launch
2818 pad, the black concentric circles mark the
2819 landing location. Data for the point along the
2820 along the flight path nearest the cursor will
2821 be displayed at the bottom of the window. This
2822 data includes flight time (so you can
2823 correlate data in the graph window), latitude,
2824 longitude, height above ground and vertical
2825 speed. The selected point will be highlighted
2826 with concentric circles in the same color as
2827 the flight path at that point.</p>
2828 </div>
2829 </div>
2830 </div>
2831 <div class="sect2">
2832 <h3 id="_export_data">12.5. Export Data</h3>
2833 <div class="paragraph">
2834 <p>This tool takes the raw data files and makes them
2835 available for external analysis. When you select this
2836 button, you are prompted to select a flight data file,
2837 which can be either a .eeprom or .telem.  The .eeprom
2838 files contain higher resolution and more continuous
2839 data, while .telem files contain receiver signal
2840 strength information.  Next, a second dialog appears
2841 which is used to select where to write the resulting
2842 file.
2843 It has a selector to choose between CSV and KML
2844 file formats.</p>
2845 </div>
2846 <div class="sect3">
2847 <h4 id="_comma_separated_value_format">12.5.1. Comma Separated Value Format</h4>
2848 <div class="paragraph">
2849 <p>This is a text file containing the data in a form
2850 suitable for import into a spreadsheet or other
2851 external data analysis tool. The first few lines of
2852 the file contain the version and configuration
2853 information from the altimeter, then there is a single
2854 header line which labels all of the fields. All of
2855 these lines start with a '#' character which many
2856 tools can be configured to skip over.</p>
2857 </div>
2858 <div class="paragraph">
2859 <p>The remaining lines of the file contain the data, with
2860 each field separated by a comma and at least one
2861 space. All of the sensor values are converted to
2862 standard units, with the barometric data reported in
2863 both pressure, altitude and height above pad units.</p>
2864 </div>
2865 </div>
2866 <div class="sect3">
2867 <h4 id="_keyhole_markup_language_for_google_earth">12.5.2. Keyhole Markup Language (for Google Earth)</h4>
2868 <div class="paragraph">
2869 <p>This is the format used by Google Earth to provide an
2870 overlay within that application. With this, you can
2871 use Google Earth to see the whole flight path
2872 in 3D.</p>
2873 </div>
2874 </div>
2875 </div>
2876 <div class="sect2">
2877 <h3 id="_configure_altimeter">12.6. Configure Altimeter</h3>
2878 <div class="imageblock">
2879 <div class="content">
2880 <img src="configure-altimeter.png" alt="configure altimeter" width="350">
2881 </div>
2882 <div class="title">Figure 22. Altimeter Configuration</div>
2883 </div>
2884 <div class="paragraph">
2885 <p>Select this button and then select either an altimeter or
2886 TeleDongle Device from the list provided. Selecting a TeleDongle
2887 device will use the radio link to configure a remote
2888 altimeter.</p>
2889 </div>
2890 <div class="paragraph">
2891 <p>The first few lines of the dialog provide information about the
2892 connected device, including the product name,
2893 software version and hardware serial number. Below that are the
2894 individual configuration entries.</p>
2895 </div>
2896 <div class="paragraph">
2897 <p>At the bottom of the dialog, there are four buttons:</p>
2898 </div>
2899 <div class="dlist">
2900 <dl>
2901 <dt class="hdlist1">Save</dt>
2902 <dd>
2903 <p>This writes any changes to the configuration parameter
2904 block in flash memory. If you don&#8217;t press this button,
2905 any changes you make will be lost.</p>
2906 </dd>
2907 <dt class="hdlist1">Reset</dt>
2908 <dd>
2909 <p>This resets the dialog to the most recently saved
2910 values, erasing any changes you have made.</p>
2911 </dd>
2912 <dt class="hdlist1">Reboot</dt>
2913 <dd>
2914 <p>This reboots the device. Use this to switch from idle
2915 to pad mode by rebooting once the rocket is oriented
2916 for flight, or to confirm changes you think you saved
2917 are really saved.</p>
2918 </dd>
2919 <dt class="hdlist1">Close</dt>
2920 <dd>
2921 <p>This closes the dialog. Any unsaved changes will be
2922 lost.</p>
2923 </dd>
2924 </dl>
2925 </div>
2926 <div class="paragraph">
2927 <p>The rest of the dialog contains the parameters to be configured.</p>
2928 </div>
2929 <div class="sect3">
2930 <h4 id="_main_deploy_altitude">12.6.1. Main Deploy Altitude</h4>
2931 <div class="paragraph">
2932 <p>This sets the altitude (above the recorded pad
2933 altitude) at which the 'main' igniter will fire. The
2934 drop-down menu shows some common values, but you can
2935 edit the text directly and choose whatever you
2936 like. If the apogee charge fires below this altitude,
2937 then the main charge will fire two seconds after the
2938 apogee charge fires.</p>
2939 </div>
2940 </div>
2941 <div class="sect3">
2942 <h4 id="_apogee_delay">12.6.2. Apogee Delay</h4>
2943 <div class="paragraph">
2944 <p>When flying redundant electronics, it&#8217;s often
2945 important to ensure that multiple apogee charges don&#8217;t
2946 fire at precisely the same time, as that can over
2947 pressurize the apogee deployment bay and cause a
2948 structural failure of the air-frame. The Apogee Delay
2949 parameter tells the flight computer to fire the apogee
2950 charge a certain number of seconds after apogee has
2951 been detected.</p>
2952 </div>
2953 </div>
2954 <div class="sect3">
2955 <h4 id="_apogee_lockout">12.6.3. Apogee Lockout</h4>
2956 <div class="paragraph">
2957 <p>Apogee lockout is the number of seconds after launch
2958 where the flight computer will not fire the apogee
2959 charge, even if the rocket appears to be at
2960 apogee. This is often called 'Mach Delay', as it is
2961 intended to prevent a flight computer from
2962 unintentionally firing apogee charges due to the
2963 pressure spike that occurrs across a mach
2964 transition. Altus Metrum flight computers include a
2965 Kalman filter which is not fooled by this sharp
2966 pressure increase, and so this setting should be left
2967 at the default value of zero to disable it.</p>
2968 </div>
2969 <div class="admonitionblock warning">
2970 <table>
2971 <tr>
2972 <td class="icon">
2973 <img src="./images/icons/warning.svg" alt="Warning">
2974 </td>
2975 <td class="content">
2976 Firmware versions older than 1.8.6 have a
2977 bug which resets the time since launch to zero each
2978 time a motor starts burning. Update firmware to get
2979 the correct behavior.
2980 </td>
2981 </tr>
2982 </table>
2983 </div>
2984 </div>
2985 <div class="sect3">
2986 <h4 id="_frequency">12.6.4. Frequency</h4>
2987 <div class="paragraph">
2988 <p>This configures which of the frequencies to use for
2989 both telemetry and packet command mode. Note that if
2990 you set this value via packet command mode, the
2991 TeleDongle frequency will also be automatically
2992 reconfigured to match so that communication will
2993 continue afterwards.</p>
2994 </div>
2995 </div>
2996 <div class="sect3">
2997 <h4 id="_rf_calibration">12.6.5. RF Calibration</h4>
2998 <div class="paragraph">
2999 <p>The radios in every Altus Metrum device are calibrated
3000 at the factory to ensure that they transmit and
3001 receive on the specified frequency.  If you need to
3002 you can adjust the calibration by changing this value.
3003 Do not do this without understanding what the value
3004 means, read the appendix on calibration and/or the
3005 source code for more information.  To change a
3006 TeleDongle&#8217;s calibration, you must reprogram the unit
3007 completely.</p>
3008 </div>
3009 </div>
3010 <div class="sect3">
3011 <h4 id="_telemetryrdfaprs_enable">12.6.6. Telemetry/RDF/APRS Enable</h4>
3012 <div class="paragraph">
3013 <p>Enables the radio for transmission during
3014 flight. When disabled, the radio will not
3015 transmit anything during flight at all.</p>
3016 </div>
3017 </div>
3018 <div class="sect3">
3019 <h4 id="_limit_transmit_to_10mw">12.6.7. Limit transmit to 10mW</h4>
3020 <div class="paragraph">
3021 <p>Reduces transmit power to no more than 10mW. This is
3022 useful when operating under some UK radio regulations.</p>
3023 </div>
3024 </div>
3025 <div class="sect3">
3026 <h4 id="_telemetry_baud_rate">12.6.8. Telemetry baud rate</h4>
3027 <div class="paragraph">
3028 <p>This sets the modulation bit rate for data
3029 transmission for both telemetry and packet
3030 link mode. Lower bit rates will increase range
3031 while reducing the amount of data that can be
3032 sent and increasing battery consumption. All
3033 telemetry is done using a rate 1/2 constraint
3034 4 convolution code, so the actual data
3035 transmission rate is 1/2 of the modulation bit
3036 rate specified here.</p>
3037 </div>
3038 </div>
3039 <div class="sect3">
3040 <h4 id="_aprs_interval">12.6.9. APRS Interval</h4>
3041 <div class="paragraph">
3042 <p>How often to transmit GPS information via APRS
3043 (in seconds). When set to zero, APRS
3044 transmission is disabled.
3045 This option is
3046 available on TeleMetrum v2 or newer and TeleMega
3047 boards. TeleMetrum v1 boards cannot transmit
3048 APRS packets.
3049 Note that a single APRS packet
3050 takes nearly a full second to transmit, so
3051 enabling this option will prevent sending any
3052 other telemetry during that time.</p>
3053 </div>
3054 </div>
3055 <div class="sect3">
3056 <h4 id="_aprs_ssid">12.6.10. APRS SSID</h4>
3057 <div class="paragraph">
3058 <p>Which SSID to report in APRS packets. By
3059 default, this is set to the last digit of the
3060 serial number, but can be configured to any
3061 value from 0 to 9.</p>
3062 </div>
3063 </div>
3064 <div class="sect3">
3065 <h4 id="_aprs_format">12.6.11. APRS Format</h4>
3066 <div class="paragraph">
3067 <p>Whether to send APRS data in Compressed or
3068 Uncompressed format. Compressed format is
3069 smaller and more precise. Uncompressed
3070 format is older, but may work better with your
3071 device. The Kenwood TH-D72 only displays
3072 altitude information with Uncompressed
3073 format, while the Yaesu FT1D only displays
3074 altitude with Compressed format. Test before
3075 you fly to see which to use.</p>
3076 </div>
3077 </div>
3078 <div class="sect3">
3079 <h4 id="_aprs_offset">12.6.12. APRS Offset</h4>
3080 <div class="paragraph">
3081 <p>The delay from the top of the minute before sending
3082 the first APRS packet of the minute. Coordinating
3083 values for this parameter between multiple devices can
3084 allow a single receiver to reliably receive APRS
3085 packets from multiple devices. Note that this offset only
3086 takes effect while the GPS signal is locked so that the
3087 transmitting device knows the current time.</p>
3088 </div>
3089 </div>
3090 <div class="sect3">
3091 <h4 id="_callsign">12.6.13. Callsign</h4>
3092 <div class="paragraph">
3093 <p>This sets the call sign included in each
3094 telemetry packet. Set this as needed to
3095 conform to your local radio regulations.</p>
3096 </div>
3097 </div>
3098 <div class="sect3">
3099 <h4 id="_maximum_flight_log_size">12.6.14. Maximum Flight Log Size</h4>
3100 <div class="paragraph">
3101 <p>This sets the space (in kilobytes) allocated
3102 for each flight log. The available space will
3103 be divided into chunks of this size. A smaller
3104 value will allow more flights to be stored, a
3105 larger value will record data from longer
3106 flights.</p>
3107 </div>
3108 </div>
3109 <div class="sect3">
3110 <h4 id="_ignitor_firing_mode">12.6.15. Ignitor Firing Mode</h4>
3111 <div class="paragraph">
3112 <p>This configuration parameter allows the two standard ignitor
3113 channels (Apogee and Main) to be used in different
3114 configurations.</p>
3115 </div>
3116 <div class="dlist">
3117 <dl>
3118 <dt class="hdlist1">Dual Deploy</dt>
3119 <dd>
3120 <p>This is the usual mode of operation; the
3121 'apogee' channel is fired at apogee and the
3122 'main' channel at the height above ground
3123 specified by the 'Main Deploy Altitude' during
3124 descent.</p>
3125 </dd>
3126 <dt class="hdlist1">Redundant Apogee</dt>
3127 <dd>
3128 <p>This fires both channels at apogee, the
3129 'apogee' channel first followed after a two
3130 second delay by the 'main' channel.</p>
3131 </dd>
3132 <dt class="hdlist1">Redundant Main</dt>
3133 <dd>
3134 <p>This fires both channels at the height above
3135 ground specified by the Main Deploy Altitude
3136 setting during descent. The 'apogee' channel
3137 is fired first, followed after a two second
3138 delay by the 'main' channel.</p>
3139 </dd>
3140 <dt class="hdlist1">Separation &amp; Apogee</dt>
3141 <dd>
3142 <p>This fires the 'main' channel when the first motor
3143 burns out and fires the 'apogee' charge at apogee.</p>
3144 </dd>
3145 </dl>
3146 </div>
3147 </div>
3148 <div class="sect3">
3149 <h4 id="_pad_orientation">12.6.16. Pad Orientation</h4>
3150 <div class="paragraph">
3151 <p>Because they include accelerometers,
3152 TeleMetrum, TeleMega and EasyMega are
3153 sensitive to the orientation of the board. By
3154 default, they expect the antenna end to point
3155 forward. This parameter allows that default to
3156 be changed, permitting the board to be mounted
3157 with the antenna pointing aft instead.</p>
3158 </div>
3159 <div class="dlist">
3160 <dl>
3161 <dt class="hdlist1">Antenna Up</dt>
3162 <dd>
3163 <p>In this mode, the antenna (or beeper, for devices
3164 without an antenna) of the flight computer must point
3165 forward, in line with the expected flight path.</p>
3166 </dd>
3167 <dt class="hdlist1">Antenna Down</dt>
3168 <dd>
3169 <p>In this mode, the antenna (or beeper, for devices
3170 without an antenna) end of the flight computer must
3171 point aft, in line with the expected flight path.</p>
3172 </dd>
3173 </dl>
3174 </div>
3175 </div>
3176 <div class="sect3">
3177 <h4 id="_beeper_frequency">12.6.17. Beeper Frequency</h4>
3178 <div class="paragraph">
3179 <p>The beeper on all Altus Metrum flight
3180 computers works best at 4000Hz, however if you
3181 have more than one flight computer in a single
3182 airframe, having all of them sound at the same
3183 frequency can be confusing. This parameter
3184 lets you adjust the base beeper frequency
3185 value.</p>
3186 </div>
3187 </div>
3188 <div class="sect3">
3189 <h4 id="_logging_trigger_motion">12.6.18. Logging Trigger Motion</h4>
3190 <div class="paragraph">
3191 <p>This sets the amount of motion that TeleGPS
3192 needs to see before logging the new
3193 position. Motions smaller than this are
3194 skipped, which saves storage space.</p>
3195 </div>
3196 </div>
3197 <div class="sect3">
3198 <h4 id="_position_reporting_interval">12.6.19. Position Reporting Interval</h4>
3199 <div class="paragraph">
3200 <p>The interval between TeleGPS position reports,
3201 both over the air and in the log. Increase
3202 this to reduce the frequency of radio
3203 transmissions and the length of time available
3204 in the log.</p>
3205 </div>
3206 </div>
3207 <div class="sect3">
3208 <h4 id="_calibrate_accelerometer">12.6.20. Calibrate Accelerometer</h4>
3209 <div class="paragraph">
3210 <p>This opens a separate window to recalibrate the
3211 accelerometers. Follow the instructions, orienting the
3212 flight computer with the antenna end, or end opposite
3213 the screw terminals, in the case of EasyMega, first up
3214 and then down.</p>
3215 </div>
3216 <div class="paragraph">
3217 <p>When the calibration is complete, return to the
3218 Configure Altimeter window and save the new
3219 calibration values.</p>
3220 </div>
3221 </div>
3222 <div class="sect3">
3223 <h4 id="_configure_pyro_channels">12.6.21. Configure Pyro Channels</h4>
3224 <div class="imageblock">
3225 <div class="content">
3226 <img src="configure-pyro.png" alt="configure pyro" width="400">
3227 </div>
3228 <div class="title">Figure 23. Additional Pyro Channel Configuration</div>
3229 </div>
3230 <div class="paragraph">
3231 <p>This opens a separate window to configure the
3232 additional pyro channels available on TeleMega,
3233 EasyMega and EasyTimer.  One column is presented for
3234 each channel. Each row represents a single
3235 parameter, if enabled the parameter must meet
3236 the specified test for the pyro channel to be
3237 fired.</p>
3238 </div>
3239 <div class="paragraph">
3240 <p>Select conditions and set the related value;
3241 the pyro channel will be activated when <strong>all</strong>
3242 of the conditions are met. Each pyro channel
3243 has a separate set of configuration values, so
3244 you can use different values for the same
3245 condition with different channels.</p>
3246 </div>
3247 <div class="paragraph">
3248 <p>At the bottom of the window, the 'Pyro Firing
3249 Time' configuration sets the length of time
3250 (in seconds) which each of these pyro channels
3251 will fire for.</p>
3252 </div>
3253 <div class="paragraph">
3254 <p>Once you have selected the appropriate
3255 configuration for all of the necessary pyro
3256 channels, you can save the pyro configuration
3257 along with the rest of the flight computer
3258 configuration by pressing the 'Save' button in
3259 the main Configure Flight Computer window.</p>
3260 </div>
3261 <div class="dlist">
3262 <dl>
3263 <dt class="hdlist1">Vertical Acceleration</dt>
3264 <dd>
3265 <p>Select a value, and then choose whether
3266 acceleration away from the ground should be above or below that
3267 value. Acceleration is positive upwards, so accelerating towards the
3268 ground would produce negative numbers. Acceleration during descent is
3269 noisy and inaccurate, so be careful when using it during these phases
3270 of the flight.</p>
3271 </dd>
3272 <dt class="hdlist1">Ascent rate</dt>
3273 <dd>
3274 <p>Select a value, and then choose whether ascent rate
3275 should be above or below that value. Ascent rate is positive upwards,
3276 so moving towards the ground would produce negative numbers. Ascent
3277 rate during descent is a bit noisy and so be careful when using it
3278 during these phases of the flight.</p>
3279 </dd>
3280 <dt class="hdlist1">Height above pad</dt>
3281 <dd>
3282 <p>Select a value, and then choose whether the height
3283 above the launch pad should be above or below that value. Note that
3284 because EasyTimer has only a low-range accelerometer and no barometer,
3285 this value will not be very reliable on that device.</p>
3286 </dd>
3287 <dt class="hdlist1">Orientation</dt>
3288 <dd>
3289 <p>TeleMega, EasyMega and EasyTimer contain a 3-axis
3290 gyroscope and accelerometer which is used to compute the orientation
3291 of the rocket. A record of orientations over the last 0.64 seconds is
3292 kept and the largest value within this period is compared with the
3293 specified value. Note that the tilt angle is not the change in angle
3294 from the launch pad, but rather absolute relative to gravity—the
3295 3-axis accelerometer is used to compute the angle of the rocket on the
3296 launch pad and initialize the system.</p>
3297 </dd>
3298 </dl>
3299 </div>
3300 <div class="admonitionblock note">
3301 <table>
3302 <tr>
3303 <td class="icon">
3304 <img src="./images/icons/note.svg" alt="Note">
3305 </td>
3306 <td class="content">
3307 <div class="paragraph">
3308 <p>Because this value is computed by integrating
3309 rate gyros, it gets progressively less
3310 accurate as the flight goes on. It should have
3311 an accumulated error of less than 0.2°/second
3312 (after 10 seconds of flight, the error should
3313 be less than 2°).</p>
3314 </div>
3315 <div class="paragraph">
3316 <p>The usual use of the orientation configuration
3317 is to ensure that the rocket is traveling
3318 mostly upwards when deciding whether to ignite
3319 air starts or additional stages. For that,
3320 choose a reasonable maximum angle (like 20°)
3321 and set the motor igniter to require an angle
3322 of less than that value.</p>
3323 </div>
3324 </td>
3325 </tr>
3326 </table>
3327 </div>
3328 <div class="dlist">
3329 <dl>
3330 <dt class="hdlist1">Flight Time</dt>
3331 <dd>
3332 <p>Time since launch. Select a value and choose whether to
3333 activate the pyro channel before or after that amount of time.</p>
3334 </dd>
3335 </dl>
3336 </div>
3337 <div class="admonitionblock warning">
3338 <table>
3339 <tr>
3340 <td class="icon">
3341 <img src="./images/icons/warning.svg" alt="Warning">
3342 </td>
3343 <td class="content">
3344 Firmware versions older than 1.8.6 have a bug which resets the time
3345 since launch to zero each time a motor starts burning. Update firmware
3346 to get the correct behavior.
3347 </td>
3348 </tr>
3349 </table>
3350 </div>
3351 <div class="admonitionblock warning">
3352 <table>
3353 <tr>
3354 <td class="icon">
3355 <img src="./images/icons/warning.svg" alt="Warning">
3356 </td>
3357 <td class="content">
3358 Firmware versions older than 1.9.8 cannot use times longer
3359 than 327.67 seconds. Update firmware if you need a longer time.
3360 </td>
3361 </tr>
3362 </table>
3363 </div>
3364 <div class="dlist">
3365 <dl>
3366 <dt class="hdlist1">Ascending</dt>
3367 <dd>
3368 <p>A deprecated configuration value which was the same as
3369 setting Ascent rate &gt; 0. Existing configurations using this will be
3370 cleared and must be reconfigured by the user.</p>
3371 </dd>
3372 <dt class="hdlist1">Descending</dt>
3373 <dd>
3374 <p>A deprecated configuration value which was the same as
3375 setting Ascent rate &lt; 0. Existing configurations using this will be
3376 cleared and must be reconfigured by the user.</p>
3377 </dd>
3378 <dt class="hdlist1">After Motor</dt>
3379 <dd>
3380 <p>The flight software counts each time the rocket starts
3381 accelerating and then decelerating (presumably due to a motor or
3382 motors burning). Use this value for multi-staged or multi-airstart
3383 launches. As of version 1.8.6 firmware, this checks to make sure at
3384 least this many motors have burned. Before version 1.8.6, this checked
3385 to make sure that exactly this many motors had burned.</p>
3386 </dd>
3387 <dt class="hdlist1">Delay</dt>
3388 <dd>
3389 <p>Once the other parameters all become true, a timer is
3390 started for the specified amount of time. While the timer is running,
3391 the other parameters are checked repeatedly and if any of them become
3392 false, then the pyro channel is disabled and will not fire. If the
3393 timer expires and all of the other parameters have remained true for
3394 the entire time, then the pyro channel is fired.</p>
3395 </dd>
3396 </dl>
3397 </div>
3398 <div class="admonitionblock warning">
3399 <table>
3400 <tr>
3401 <td class="icon">
3402 <img src="./images/icons/warning.svg" alt="Warning">
3403 </td>
3404 <td class="content">
3405 Firmware versions older than 1.9.8 cannot use delays longer
3406 than 327.67 seconds. Update firmware if you need a longer delay.
3407 </td>
3408 </tr>
3409 </table>
3410 </div>
3411 <div class="dlist">
3412 <dl>
3413 <dt class="hdlist1">Flight State</dt>
3414 <dd>
3415 <p>The flight software tracks the flight
3416 through a sequence of states:</p>
3417 <div class="ulist">
3418 <ul>
3419 <li>
3420 <p>Boost. The motor has lit and the rocket is
3421 accelerating upwards. Ascent rate will be greater than zero.
3422 Vertical acceleration will be greater than zero.</p>
3423 </li>
3424 <li>
3425 <p>Fast. The motor has burned out and the
3426 rocket is decelerating, but it is going
3427 faster than 200m/s. Ascent rate will be greater than zero. Vertical
3428 acceleration will be less than zero.</p>
3429 </li>
3430 <li>
3431 <p>Coast. The rocket is still moving upwards
3432 and decelerating, but the Ascent rate is less
3433 than 200m/s. Ascent rate will greater than zero. Vertical
3434 acceleration will be less than zero.</p>
3435 </li>
3436 <li>
3437 <p>Drogue. The rocket has reached apogee and is heading back down, but
3438 is above the configured Main altitude. Ascent rate will be less
3439 than zero during this state. Vertical acceleration will be negative
3440 until the rocket reaches a terminal descent rate, at which point
3441 Vertical acceleration will be zero. Both Ascent rate and Vertical
3442 acceleration are very noisy in this state, so be careful when
3443 trying to use them to control pyro channels. This state selection
3444 is not available on EasyTimer.</p>
3445 </li>
3446 <li>
3447 <p>Main. The rocket is still descending, and
3448 is below the Main altitude. Ascent rate will be less than zero
3449 during this state. Vertical acceleration may be briefly less than
3450 zero as the rocket slows from drogue descent to main descent, but
3451 it will settle down to a zero value once the rocket has reached the
3452 terminal velocity under the main chute. Ascent rate and Vertical
3453 acceleration should be much less noisy once the main chute has
3454 deployed. This state selection is not available on EasyTimer.</p>
3455 </li>
3456 <li>
3457 <p>Landed. The rocket is no longer moving.</p>
3458 </li>
3459 </ul>
3460 </div>
3461 </dd>
3462 </dl>
3463 </div>
3464 <div class="paragraph">
3465 <p>You can select a state to limit when the pyro channel may activate;
3466 note that the check is based on when the rocket transitions <strong>into</strong> the
3467 state, and so checking for “greater than Boost” means that the rocket
3468 is currently in boost or some later state.</p>
3469 </div>
3470 <div class="paragraph">
3471 <p>When a motor burns out, the rocket enters either Fast or Coast state
3472 (depending on how fast it is moving). If the computer detects upwards
3473 acceleration again, it will move back to Boost state.</p>
3474 </div>
3475 </div>
3476 </div>
3477 <div class="sect2">
3478 <h3 id="_configure_altosui">12.7. Configure AltosUI</h3>
3479 <div class="imageblock">
3480 <div class="content">
3481 <img src="configure-altosui.png" alt="configure altosui" width="230">
3482 </div>
3483 <div class="title">Figure 24. Configure AltosUI Dialog</div>
3484 </div>
3485 <div class="paragraph">
3486 <p>This button presents a dialog so that you can
3487 configure the AltosUI global settings.</p>
3488 </div>
3489 <div class="sect3">
3490 <h4 id="_voice_settings">12.7.1. Voice Settings</h4>
3491 <div class="paragraph">
3492 <p>AltosUI provides voice announcements during
3493 flight so that you can keep your eyes on the
3494 sky and still get information about the
3495 current flight status. However, sometimes you
3496 don&#8217;t want to hear them.</p>
3497 </div>
3498 <div class="dlist">
3499 <dl>
3500 <dt class="hdlist1">Enable</dt>
3501 <dd>
3502 <p>Turns all voice announcements on and off</p>
3503 </dd>
3504 <dt class="hdlist1">Test Voice</dt>
3505 <dd>
3506 <p>Plays a short message allowing you to verify
3507 that the audio system is working and the volume settings
3508 are reasonable</p>
3509 </dd>
3510 </dl>
3511 </div>
3512 </div>
3513 <div class="sect3">
3514 <h4 id="_log_directory">12.7.2. Log Directory</h4>
3515 <div class="paragraph">
3516 <p>AltosUI logs all telemetry data and saves all
3517 flash data to this directory. This
3518 directory is also used as the staring point
3519 when selecting data files for display or
3520 export.</p>
3521 </div>
3522 <div class="paragraph">
3523 <p>Click on the directory name to bring up a
3524 directory choosing dialog, select a new
3525 directory and click 'Select Directory' to
3526 change where AltosUI reads and writes data
3527 files.</p>
3528 </div>
3529 </div>
3530 <div class="sect3">
3531 <h4 id="_callsign_2">12.7.3. Callsign</h4>
3532 <div class="paragraph">
3533 <p>This value is transmitted in each command
3534 packet sent from TeleDongle and received from
3535 an altimeter.  It is not used in telemetry
3536 mode, as the callsign configured in the
3537 altimeter board is included in all telemetry
3538 packets.  Configure this with the AltosUI
3539 operators call sign as needed to comply with
3540 your local radio regulations.</p>
3541 </div>
3542 <div class="paragraph">
3543 <p>Note that to successfully command a flight
3544 computer over the radio (to configure the
3545 altimeter, monitor idle, or fire pyro
3546 charges), the callsign configured here must
3547 exactly match the callsign configured in the
3548 flight computer.  This matching is case
3549 sensitive.</p>
3550 </div>
3551 </div>
3552 <div class="sect3">
3553 <h4 id="_imperial_units">12.7.4. Imperial Units</h4>
3554 <div class="paragraph">
3555 <p>This switches between metric units (meters)
3556 and imperial units (feet and miles). This
3557 affects the display of values use during
3558 flight monitoring, configuration, data
3559 graphing and all of the voice
3560 announcements. It does not change the units
3561 used when exporting to CSV files, those are
3562 always produced in metric units.</p>
3563 </div>
3564 </div>
3565 <div class="sect3">
3566 <h4 id="_serial_debug">12.7.5. Serial Debug</h4>
3567 <div class="paragraph">
3568 <p>This causes all communication with a connected
3569 device to be dumped to the console from which
3570 AltosUI was started. If you&#8217;ve started it from
3571 an icon or menu entry, the output will simply
3572 be discarded. This mode can be useful to debug
3573 various serial communication issues.</p>
3574 </div>
3575 </div>
3576 <div class="sect3">
3577 <h4 id="_font_size">12.7.6. Font size</h4>
3578 <div class="paragraph">
3579 <p>Selects the set of fonts used in the flight
3580 monitor window. Choose between the small,
3581 medium and large sets.</p>
3582 </div>
3583 </div>
3584 <div class="sect3">
3585 <h4 id="_look_feel">12.7.7. Look &amp; feel</h4>
3586 <div class="paragraph">
3587 <p>Switches between the available Java user
3588 interface appearances. The default selection
3589 is supposed to match the native window system
3590 appearance for the target platform.</p>
3591 </div>
3592 </div>
3593 <div class="sect3">
3594 <h4 id="_menu_position">12.7.8. Menu position</h4>
3595 <div class="paragraph">
3596 <p>Selects the initial position for the main
3597 AltosUI window that includes all of the
3598 command buttons.</p>
3599 </div>
3600 </div>
3601 <div class="sect3">
3602 <h4 id="_map_cache_size">12.7.9. Map Cache Size</h4>
3603 <div class="paragraph">
3604 <p>Sets the number of map 'tiles' kept in memory
3605 while the application is running. More tiles
3606 consume more memory, but will make panning
3607 around the map faster.</p>
3608 </div>
3609 </div>
3610 <div class="sect3">
3611 <h4 id="_manage_frequencies">12.7.10. Manage Frequencies</h4>
3612 <div class="paragraph">
3613 <p>This brings up a dialog where you can
3614 configure the set of frequencies shown in the
3615 various frequency menus. You can add as many
3616 as you like, or even reconfigure the default
3617 set. Changing this list does not affect the
3618 frequency settings of any devices, it only
3619 changes the set of frequencies shown in the
3620 menus.</p>
3621 </div>
3622 </div>
3623 </div>
3624 <div class="sect2">
3625 <h3 id="_configure_groundstation">12.8. Configure Groundstation</h3>
3626 <div class="imageblock">
3627 <div class="content">
3628 <img src="configure-groundstation.png" alt="configure groundstation" width="300">
3629 </div>
3630 <div class="title">Figure 25. Configure Groundstation Dialog</div>
3631 </div>
3632 <div class="paragraph">
3633 <p>Select this button and then select a TeleDongle or
3634 TeleBT Device from the list provided.</p>
3635 </div>
3636 <div class="paragraph">
3637 <p>The first few lines of the dialog provide information
3638 about the connected device, including the product
3639 name, software version and hardware serial
3640 number. Below that are the individual configuration
3641 entries.</p>
3642 </div>
3643 <div class="paragraph">
3644 <p>Note that TeleDongle and TeleBT don&#8217;t save any
3645 configuration data, the settings here are recorded on
3646 the local machine in the Java preferences
3647 database. Moving the device to another machine, or
3648 using a different user account on the same machine
3649 will cause settings made here to have no effect.</p>
3650 </div>
3651 <div class="paragraph">
3652 <p>At the bottom of the dialog, there are three
3653 buttons:</p>
3654 </div>
3655 <div class="dlist">
3656 <dl>
3657 <dt class="hdlist1">Save</dt>
3658 <dd>
3659 <p>This writes any changes to the local Java
3660 preferences file. If you don&#8217;t press this
3661 button, any changes you make will be lost.</p>
3662 </dd>
3663 <dt class="hdlist1">Reset</dt>
3664 <dd>
3665 <p>This resets the dialog to the most recently
3666 saved values, erasing any changes you have
3667 made.</p>
3668 </dd>
3669 <dt class="hdlist1">Close</dt>
3670 <dd>
3671 <p>This closes the dialog. Any unsaved changes
3672 will be lost.</p>
3673 </dd>
3674 </dl>
3675 </div>
3676 <div class="paragraph">
3677 <p>The rest of the dialog contains the parameters
3678 to be configured.</p>
3679 </div>
3680 <div class="sect3">
3681 <h4 id="_frequency_2">12.8.1. Frequency</h4>
3682 <div class="paragraph">
3683 <p>This configures the frequency to use for both
3684 telemetry and packet command mode. Set this
3685 before starting any operation involving packet
3686 command mode so that it will use the right
3687 frequency. Telemetry monitoring mode also
3688 provides a menu to change the frequency, and
3689 that menu also sets the same Java preference
3690 value used here.</p>
3691 </div>
3692 </div>
3693 <div class="sect3">
3694 <h4 id="_rf_calibration_2">12.8.2. RF Calibration</h4>
3695 <div class="paragraph">
3696 <p>The radios in every Altus Metrum device are
3697 calibrated at the factory to ensure that they
3698 transmit and receive on the specified
3699 frequency.  To change a TeleDongle or TeleBT&#8217;s
3700 calibration, you must reprogram the unit
3701 completely, so this entry simply shows the
3702 current value and doesn&#8217;t allow any changes.</p>
3703 </div>
3704 </div>
3705 <div class="sect3">
3706 <h4 id="_telemetry_rate">12.8.3. Telemetry Rate</h4>
3707 <div class="paragraph">
3708 <p>This lets you match the telemetry and packet
3709 link rate from the transmitter. If they don&#8217;t
3710 match, the device won&#8217;t receive any data.</p>
3711 </div>
3712 </div>
3713 </div>
3714 <div class="sect2">
3715 <h3 id="_flash_image">12.9. Flash Image</h3>
3716 <div class="paragraph">
3717 <p>This reprograms Altus Metrum devices with new
3718 firmware.
3719 TeleMetrum v1.x, TeleDongle v0.2, TeleMini v1.0
3720 and TeleBT v1.0 are all reprogrammed by using another
3721 similar unit as a programming dongle (pair
3722 programming).
3723 TeleMega, EasyMega, TeleMetrum v2 or newer,
3724 EasyMini, EasyTimer, TeleBT v3 or newer and TeleDongle v3
3725 or newer are all
3726 programmed directly
3727 over USB (self programming). Please read
3728 the directions for flashing devices in
3729 <a href="#_updating_device_firmware">Updating Device Firmware</a>.</p>
3730 </div>
3731 </div>
3732 <div class="sect2">
3733 <h3 id="_fire_igniter">12.10. Fire Igniter</h3>
3734 <div class="imageblock">
3735 <div class="content">
3736 <img src="fire-igniter.png" alt="fire igniter" width="120">
3737 </div>
3738 <div class="title">Figure 26. Fire Igniter Window</div>
3739 </div>
3740 <div class="paragraph">
3741 <p>This activates the igniter circuits in the flight
3742 computer to help test recovery systems
3743 deployment.
3744 Because this command can operate over the
3745 Packet Command Link, you can prepare the rocket as for
3746 flight and then test the recovery system without
3747 needing to snake wires inside the air-frame.</p>
3748 </div>
3749 <div class="paragraph">
3750 <p>Selecting the 'Fire Igniter' button brings up the
3751 usual device selection dialog. Pick the desired
3752 device. This brings up another window which shows the
3753 current continuity test status for all of the pyro
3754 channels.</p>
3755 </div>
3756 <div class="paragraph">
3757 <p>Next, select the desired igniter to fire. This will
3758 enable the 'Arm' button.</p>
3759 </div>
3760 <div class="paragraph">
3761 <p>Select the 'Arm' button. This enables the 'Fire'
3762 button. The word 'Arm' is replaced by a countdown
3763 timer indicating that you have 10 seconds to press the
3764 'Fire' button or the system will deactivate, at which
3765 point you start over again at selecting the desired
3766 igniter.</p>
3767 </div>
3768 </div>
3769 <div class="sect2">
3770 <h3 id="_scan_channels">12.11. Scan Channels</h3>
3771 <div class="imageblock">
3772 <div class="content">
3773 <img src="scan-channels.png" alt="scan channels" width="300">
3774 </div>
3775 <div class="title">Figure 27. Scan Channels Window</div>
3776 </div>
3777 <div class="paragraph">
3778 <p>This listens for telemetry packets on all of the
3779 configured frequencies, displaying information about
3780 each device it receives a packet from. You can select
3781 which of the baud rates and telemetry formats should
3782 be tried; by default, it only listens at 38400 baud
3783 with the standard telemetry format used in v1.0 and
3784 later firmware.</p>
3785 </div>
3786 </div>
3787 <div class="sect2">
3788 <h3 id="_load_maps">12.12. Load Maps</h3>
3789 <div class="imageblock">
3790 <div class="content">
3791 <img src="load-maps.png" alt="load maps" width="500">
3792 </div>
3793 <div class="title">Figure 28. Load Maps Window</div>
3794 </div>
3795 <div class="paragraph">
3796 <p>Before heading out to a new launch site, you can use
3797 this to load satellite images in case you don&#8217;t have
3798 internet connectivity at the site.  Try not to wait
3799 until the last minute, though, particularly if you&#8217;re
3800 heading to a major launch.  If too many people are
3801 all trying to download map data at once, Google may
3802 limit access until the next day.</p>
3803 </div>
3804 <div class="paragraph">
3805 <p>There&#8217;s a drop-down menu of launch sites we know
3806 about; if your favorites aren&#8217;t there, please let us
3807 know the lat/lon and name of the site. The contents of
3808 this list are actually downloaded from our server at
3809 run-time, so as new sites are sent in, they&#8217;ll get
3810 automatically added to this list.  If the launch site
3811 isn&#8217;t in the list, you can manually enter the lat/lon
3812 values</p>
3813 </div>
3814 <div class="paragraph">
3815 <p>There are four different kinds of maps you can view;
3816 you can select which to download by selecting as many
3817 as you like from the available types:</p>
3818 </div>
3819 <div class="dlist">
3820 <dl>
3821 <dt class="hdlist1">Hybrid</dt>
3822 <dd>
3823 <p>A combination of satellite imagery and road data. This
3824 is the default view.</p>
3825 </dd>
3826 <dt class="hdlist1">Satellite</dt>
3827 <dd>
3828 <p>Just the satellite imagery without any annotation.</p>
3829 </dd>
3830 <dt class="hdlist1">Roadmap</dt>
3831 <dd>
3832 <p>Roads, political boundaries and a few geographic
3833 features.</p>
3834 </dd>
3835 <dt class="hdlist1">Terrain</dt>
3836 <dd>
3837 <p>Contour intervals and shading that show hills and
3838 valleys.</p>
3839 </dd>
3840 </dl>
3841 </div>
3842 <div class="paragraph">
3843 <p>You can specify the range of zoom levels to download;
3844 smaller numbers show more area with less
3845 resolution. The default level, 0, shows about
3846 3m/pixel. One zoom level change doubles or halves that
3847 number. Larger zoom levels show more detail, smaller
3848 zoom levels less.</p>
3849 </div>
3850 <div class="paragraph">
3851 <p>The Map Radius value sets how large an area around the
3852 center point to download. Select a value large enough
3853 to cover any plausible flight from that site. Be aware
3854 that loading a large area with a high maximum zoom
3855 level can attempt to download a lot of data. Loading
3856 hybrid maps with a 10km radius at a minimum zoom of -2
3857 and a maximum zoom of 2 consumes about 120MB of
3858 space. Terrain and road maps consume about 1/10 as
3859 much space as satellite or hybrid maps.</p>
3860 </div>
3861 <div class="paragraph">
3862 <p>Clicking the 'Load Map' button will fetch images from
3863 Google Maps; note that Google limits how many images
3864 you can fetch at once, so if you load more than one
3865 launch site, you may get some gray areas in the map
3866 which indicate that Google is tired of sending data to
3867 you. Try again later.</p>
3868 </div>
3869 </div>
3870 <div class="sect2">
3871 <h3 id="_monitor_idle">12.13. Monitor Idle</h3>
3872 <div class="imageblock">
3873 <div class="content">
3874 <img src="monitor-idle.png" alt="monitor idle" width="500">
3875 </div>
3876 <div class="title">Figure 29. Monitor Idle Window</div>
3877 </div>
3878 <div class="paragraph">
3879 <p>This brings up a dialog similar to the Monitor Flight
3880 UI, except it works with the altimeter in “idle” mode
3881 by sending query commands to discover the current
3882 state rather than listening for telemetry
3883 packets. Because this uses command mode, it needs to
3884 have the TeleDongle and flight computer callsigns
3885 match exactly. If you can receive telemetry, but
3886 cannot manage to run Monitor Idle, then it&#8217;s very
3887 likely that your callsigns are different in some way.</p>
3888 </div>
3889 <div class="paragraph">
3890 <p>You can change the frequency and callsign used to
3891 communicate with the flight computer; they must both
3892 match the configuration in the flight computer
3893 exactly.</p>
3894 </div>
3895 </div>
3896 </div>
3897 </div>
3898 <div class="sect1">
3899 <h2 id="_altosdroid">13. AltosDroid</h2>
3900 <div class="sectionbody">
3901 <div class="paragraph">
3902 <p>AltosDroid provides the same flight monitoring capabilities as
3903 AltosUI, but runs on Android devices. AltosDroid is designed
3904 to connect to a TeleBT receiver over Bluetooth™ and (on
3905 Android devices supporting USB On-the-go) TeleDongle and
3906 TeleBT devices over USB. AltosDroid monitors telemetry data,
3907 logging it to internal storage in the Android device, and
3908 presents that data in a UI similar to the 'Monitor Flight'
3909 window in AltosUI.</p>
3910 </div>
3911 <div class="paragraph">
3912 <p>This manual will explain how to configure AltosDroid, connect
3913 to TeleBT or TeleDongle, operate the flight monitoring
3914 interface and describe what the displayed data means.</p>
3915 </div>
3916 <div class="sect2">
3917 <h3 id="_installing_altosdroid">13.1. Installing AltosDroid</h3>
3918 <div class="paragraph">
3919 <p>AltosDroid is available from the Google Play store. To
3920 install it on your Android device, open the Google
3921 Play Store application and search for
3922 “altosdroid”. Make sure you don&#8217;t have a space between
3923 “altos” and “droid” or you probably won&#8217;t find what
3924 you want. That should bring you to the right page from
3925 which you can download and install the application.</p>
3926 </div>
3927 </div>
3928 <div class="sect2">
3929 <h3 id="_charging_telebt_battery">13.2. Charging TeleBT Battery</h3>
3930 <div class="paragraph">
3931 <p>Before using TeleBT with AltosDroid, make sure the
3932 internal TeleBT battery is charged.  To do this,
3933 attach a micro USB cable from a computer or other USB
3934 power source to TeleBT.  A dual LED on the circuit
3935 board should illuminate, showing red while the battery
3936 is charging, green when charging is completed, and
3937 both red and green on at the same time if there is a
3938 battery fault.</p>
3939 </div>
3940 </div>
3941 <div class="sect2">
3942 <h3 id="_connecting_to_telebt_over_bluetooth">13.3. Connecting to TeleBT over Bluetooth™</h3>
3943 <div class="paragraph">
3944 <p>Note that when turning TeleBT on, you may see a brief LED
3945 flash, but there will be no "activity" indicated until you
3946 pair with the device from AltosDroid.</p>
3947 </div>
3948 <div class="paragraph">
3949 <p>Press the Android 'Menu' button or soft-key to see the
3950 configuration options available. Select the 'Connect a
3951 device' option and then the 'Scan for devices' entry
3952 at the bottom to look for your TeleBT device. Select
3953 your device, and when it asks for the code, enter
3954 '1234'.</p>
3955 </div>
3956 <div class="paragraph">
3957 <p>Subsequent connections will not require you to enter
3958 that code, and your 'paired' device will appear in the
3959 list without scanning.</p>
3960 </div>
3961 </div>
3962 <div class="sect2">
3963 <h3 id="_connecting_to_teledongle_or_telebt_over_usb">13.4. Connecting to TeleDongle or TeleBT over USB</h3>
3964 <div class="paragraph">
3965 <p>Get a special USB On-the-go adapter cable. These
3966 cables have a USB micro-B male connector on one end
3967 and a standard A female connector on the other
3968 end. Plug in your TeleDongle or TeleBT device to the
3969 adapter cable and the adapter cable into your phone
3970 and AltosDroid should automatically start up. If it
3971 doesn&#8217;t, the most likely reason is that your Android
3972 device doesn&#8217;t support USB On-the-go.</p>
3973 </div>
3974 </div>
3975 <div class="sect2">
3976 <h3 id="_altosdroid_menu">13.5. AltosDroid Menu</h3>
3977 <div class="paragraph">
3978 <p>The main AltosDroid menu has a selection of operation
3979 and configuration options.</p>
3980 </div>
3981 <div class="dlist">
3982 <dl>
3983 <dt class="hdlist1">Connect a device</dt>
3984 <dd>
3985 <p>Offers a menu of available TeleBT devices, and an
3986 option to scan for additional devices.</p>
3987 </dd>
3988 <dt class="hdlist1">Disconnect device</dt>
3989 <dd>
3990 <p>Disconnects the current TeleBT or TeleDongle
3991 device. You can reconnect TeleBT over bluetooth by
3992 using Connect a Device. You can reconnect a USB device
3993 by unplugging it and then plugging it back in.</p>
3994 </dd>
3995 <dt class="hdlist1">Select radio frequency</dt>
3996 <dd>
3997 <p>This selects which frequency to listen on by bringing
3998 up a menu of pre-set radio frequencies. Pick the one
3999 which matches your altimeter.</p>
4000 </dd>
4001 <dt class="hdlist1">Select Tracker</dt>
4002 <dd>
4003 <p>Switches the information displays to show data for a
4004 different transmitting device. The map will always
4005 show all of the devices in view. Trackers are shown
4006 and selected by serial number, so make sure you note
4007 the serial number of devices in each airframe.</p>
4008 </dd>
4009 <dt class="hdlist1">Delete Track</dt>
4010 <dd>
4011 <p>Deletes all information about a transmitting device.</p>
4012 </dd>
4013 <dt class="hdlist1">Setup</dt>
4014 <dd>
4015 <p>Offers additional configuration operations. See
4016 <a href="#_setup">Setup</a>.</p>
4017 </dd>
4018 <dt class="hdlist1">Idle Mode</dt>
4019 <dd>
4020 <p>Communicate with an altimeter in Idle mode. See <a href="#_idle_mode">Idle Mode</a></p>
4021 </dd>
4022 <dt class="hdlist1">Quit</dt>
4023 <dd>
4024 <p>Shuts down AltosDroid.</p>
4025 </dd>
4026 </dl>
4027 </div>
4028 </div>
4029 <div class="sect2">
4030 <h3 id="_setup">13.6. Setup</h3>
4031 <div class="dlist">
4032 <dl>
4033 <dt class="hdlist1">Telemetry Rate</dt>
4034 <dd>
4035 <p>Altus Metrum transmitters can be configured to operate
4036 at lower data rates to improve transmission range. If
4037 you have configured your device to do this, this menu
4038 item allows you to change the receiver to match.</p>
4039 </dd>
4040 <dt class="hdlist1">Units</dt>
4041 <dd>
4042 <p>Selects which units used to report values.</p>
4043 </dd>
4044 <dt class="hdlist1">Map Type</dt>
4045 <dd>
4046 <p>Displays a menu of map types and lets you select
4047 one. Hybrid maps include satellite images with a
4048 roadmap overlaid. Satellite maps dispense with the
4049 roadmap overlay. Roadmap shows just the roads. Terrain
4050 includes roads along with shadows indicating changes
4051 in elevation, and other geographical features.</p>
4052 </dd>
4053 <dt class="hdlist1">Map Source</dt>
4054 <dd>
4055 <p>Select between online and offline maps. Online maps
4056 will show a 'move to current position' icon in the
4057 upper right corner, while offline maps will have
4058 copyright information all over the map. Otherwise,
4059 they&#8217;re pretty similar.</p>
4060 </dd>
4061 <dt class="hdlist1">Preload Maps</dt>
4062 <dd>
4063 <p>Brings up a dialog allowing you to download offline
4064 map tiles so that you can have maps available even if
4065 you have no network connectivity at the launch site.</p>
4066 </dd>
4067 <dt class="hdlist1">Manage Frequencies</dt>
4068 <dd>
4069 <p>This presents a dialog containing the current list of
4070 frequencies that will be show in the 'Select radio
4071 frequency' menu. You can change the label for existing
4072 frequencies, delete or add new frequencies.</p>
4073 </dd>
4074 </dl>
4075 </div>
4076 </div>
4077 <div class="sect2">
4078 <h3 id="_idle_mode">13.7. Idle Mode</h3>
4079 <div class="dlist">
4080 <dl>
4081 <dt class="hdlist1">Callsign</dt>
4082 <dd>
4083 <p>Lets you configure the callsign used by AltosDroid to
4084 communicate with the flight computer. The callsign on
4085 the two devices must match or the communication will
4086 fail. This provides a modest amount of protection
4087 against accidentally controlling another persons
4088 flight computer.</p>
4089 </dd>
4090 <dt class="hdlist1">Monitor</dt>
4091 <dd>
4092 <p>This provides similar information to monitoring the
4093 telemetry stream from a flight computer in flight
4094 mode. The title of the application will change to
4095 include (idle) so you can tell this mode is active.</p>
4096 </dd>
4097 <dt class="hdlist1">Reboot</dt>
4098 <dd>
4099 <p>Remotely reboots the flight computer. This is useful
4100 when the flight computers turned on while the airframe
4101 is horizontal and you want to restart the flight
4102 computers in pad mode after raising the airframe to
4103 vertical.</p>
4104 </dd>
4105 <dt class="hdlist1">Fire Igniters</dt>
4106 <dd>
4107 <p>Remotely control igniters for ground testing recovery
4108 systems.</p>
4109 </dd>
4110 </dl>
4111 </div>
4112 </div>
4113 <div class="sect2">
4114 <h3 id="_altosdroid_flight_monitoring">13.8. AltosDroid Flight Monitoring</h3>
4115 <div class="paragraph">
4116 <p>AltosDroid is designed to mimic the AltosUI flight
4117 monitoring display, providing separate tabs for each
4118 stage of your rocket flight along with a tab
4119 containing a map of the local area with icons marking
4120 the current location of the altimeter and the Android
4121 device.</p>
4122 </div>
4123 </div>
4124 <div class="sect2">
4125 <h3 id="_pad">13.9. Pad</h3>
4126 <div class="paragraph">
4127 <p>The 'Pad' tab shows information used to decide when
4128 the rocket is ready for flight. The first elements
4129 include red/green indicators, if any of these is red,
4130 you&#8217;ll want to evaluate whether the rocket is ready to
4131 launch.</p>
4132 </div>
4133 <div class="paragraph">
4134 <p>When the pad tab is selected, the voice responses will
4135 include status changes to the igniters and GPS
4136 reception, letting you know if the rocket is still
4137 ready for launch.</p>
4138 </div>
4139 <div class="dlist">
4140 <dl>
4141 <dt class="hdlist1">Battery</dt>
4142 <dd>
4143 <p>This indicates whether the Li-Po battery powering the
4144 transmitter has sufficient charge to last for the
4145 duration of the flight. A value of more than 3.8V is
4146 required for a 'GO' status.</p>
4147 </dd>
4148 <dt class="hdlist1">Receiver Battery</dt>
4149 <dd>
4150 <p>This indicates whether the Li-Po battery powering the
4151 TeleBT has sufficient charge to last for the duration
4152 of the flight. A value of more than 3.8V is required
4153 for a 'GO' status.</p>
4154 </dd>
4155 <dt class="hdlist1">Data Logging</dt>
4156 <dd>
4157 <p>This indicates whether there is space remaining
4158 on-board to store flight data for the upcoming
4159 flight. If you&#8217;ve downloaded data, but failed to erase
4160 flights, there may not be any space left. TeleMetrum
4161 and TeleMega can store multiple flights, depending on
4162 the configured maximum flight log size. TeleGPS logs
4163 data continuously. TeleMini v1.0 stores only a single
4164 flight, so it will need to be downloaded and erased
4165 after each flight to capture data. This only affects
4166 on-board flight logging; the altimeter will still
4167 transmit telemetry and fire ejection charges at the
4168 proper times.</p>
4169 </dd>
4170 <dt class="hdlist1">GPS Locked</dt>
4171 <dd>
4172 <p>For a TeleMetrum or TeleMega device, this indicates
4173 whether the GPS receiver is currently able to compute
4174 position information. GPS requires at least 4
4175 satellites to compute an accurate position.</p>
4176 </dd>
4177 <dt class="hdlist1">GPS Ready</dt>
4178 <dd>
4179 <p>For a TeleMetrum or TeleMega device, this indicates
4180 whether GPS has reported at least 10 consecutive
4181 positions without losing lock. This ensures that the
4182 GPS receiver has reliable reception from the
4183 satellites.</p>
4184 </dd>
4185 <dt class="hdlist1">Apogee Igniter</dt>
4186 <dd>
4187 <p>This indicates whether the apogee igniter has
4188 continuity. If the igniter has a low resistance, then
4189 the voltage measured here will be close to the Li-Po
4190 battery voltage. A value greater than 3.2V is required
4191 for a 'GO' status.</p>
4192 </dd>
4193 <dt class="hdlist1">Main Igniter</dt>
4194 <dd>
4195 <p>This indicates whether the main igniter has
4196 continuity. If the igniter has a low resistance, then
4197 the voltage measured here will be close to the Li-Po
4198 battery voltage. A value greater than 3.2V is required
4199 for a 'GO' status.</p>
4200 </dd>
4201 <dt class="hdlist1">Igniter A-D</dt>
4202 <dd>
4203 <p>This indicates whether the indicated additional pyro
4204 channel igniter has continuity. If the igniter has a
4205 low resistance, then the voltage measured here will be
4206 close to the Li-Po battery voltage. A value greater
4207 than 3.2V is required for a 'GO' status.</p>
4208 </dd>
4209 </dl>
4210 </div>
4211 <div class="paragraph">
4212 <p>The Pad tab also shows the location of the Android
4213 device.</p>
4214 </div>
4215 </div>
4216 <div class="sect2">
4217 <h3 id="_flight">13.10. Flight</h3>
4218 <div class="paragraph">
4219 <p>The 'Flight' tab shows information used to evaluate
4220 and spot a rocket while in flight. It displays speed
4221 and height data to monitor the health of the rocket,
4222 along with elevation, range and bearing to help locate
4223 the rocket in the sky.</p>
4224 </div>
4225 <div class="paragraph">
4226 <p>While the Flight tab is displayed, the voice
4227 announcements will include current speed, height,
4228 elevation and bearing information.</p>
4229 </div>
4230 <div class="dlist">
4231 <dl>
4232 <dt class="hdlist1">Speed</dt>
4233 <dd>
4234 <p>Shows current vertical speed. During descent, the
4235 speed values are averaged over a fairly long time to
4236 try and make them steadier.</p>
4237 </dd>
4238 <dt class="hdlist1">Height</dt>
4239 <dd>
4240 <p>Shows the current height above the launch pad.</p>
4241 </dd>
4242 <dt class="hdlist1">Max Speed</dt>
4243 <dd>
4244 <p>Shows the maximum vertical speed seen during the
4245 flight.</p>
4246 </dd>
4247 <dt class="hdlist1">Max Height</dt>
4248 <dd>
4249 <p>Shows the maximum height above launch pad.</p>
4250 </dd>
4251 <dt class="hdlist1">Elevation</dt>
4252 <dd>
4253 <p>This is the angle above the horizon from the android
4254 devices current position.</p>
4255 </dd>
4256 <dt class="hdlist1">Range</dt>
4257 <dd>
4258 <p>The total distance from the android device to the
4259 rocket, including both ground distance and difference
4260 in altitude. Use this to gauge how large the rocket is
4261 likely to appear in the sky.</p>
4262 </dd>
4263 <dt class="hdlist1">Bearing</dt>
4264 <dd>
4265 <p>This is the azimuth from true north for the rocket
4266 from the android device. Use this in combination with
4267 the Elevation value to help locate the rocket in the
4268 sky, or at least to help point the antenna in the
4269 general direction. This is provided in both degrees
4270 and a compass point (like West South West). You&#8217;ll
4271 want to know which direction is true north before
4272 launching your rocket.</p>
4273 </dd>
4274 <dt class="hdlist1">Ground Distance</dt>
4275 <dd>
4276 <p>This shows the distance across the ground to the
4277 lat/lon where the rocket is located. Use this to
4278 estimate what is currently under the rocket.</p>
4279 </dd>
4280 <dt class="hdlist1">Latitude/Longitude</dt>
4281 <dd>
4282 <p>Displays the last known location of the rocket.</p>
4283 </dd>
4284 <dt class="hdlist1">Apogee Igniter</dt>
4285 <dd>
4286 <p>This indicates whether the apogee igniter has
4287 continuity. If the igniter has a low resistance, then
4288 the voltage measured here will be close to the Li-Po
4289 battery voltage. A value greater than 3.2V is required
4290 for a 'GO' status.</p>
4291 </dd>
4292 <dt class="hdlist1">Main Igniter</dt>
4293 <dd>
4294 <p>This indicates whether the main igniter has
4295 continuity. If the igniter has a low resistance, then
4296 the voltage measured here will be close to the Li-Po
4297 battery voltage. A value greater than 3.2V is required
4298 for a 'GO' status.</p>
4299 </dd>
4300 </dl>
4301 </div>
4302 </div>
4303 <div class="sect2">
4304 <h3 id="_recover">13.11. Recover</h3>
4305 <div class="paragraph">
4306 <p>The 'Recover' tab shows information used while
4307 recovering the rocket on the ground after flight.</p>
4308 </div>
4309 <div class="paragraph">
4310 <p>While the Recover tab is displayed, the voice
4311 announcements will include distance along with either
4312 bearing or direction, depending on whether you are
4313 moving.</p>
4314 </div>
4315 <div class="dlist">
4316 <dl>
4317 <dt class="hdlist1">Bearing</dt>
4318 <dd>
4319 <p>This is the azimuth from true north for the rocket
4320 from the android device. Use this in combination with
4321 the Elevation value to help locate the rocket in the
4322 sky, or at least to help point the antenna in the
4323 general direction. This is provided in both degrees
4324 and a compass point (like West South West). You&#8217;ll
4325 want to know which direction is true north before
4326 launching your rocket.</p>
4327 </dd>
4328 <dt class="hdlist1">Direction</dt>
4329 <dd>
4330 <p>When you are in motion, this provides the angle from
4331 your current direction of motion towards the rocket.</p>
4332 </dd>
4333 <dt class="hdlist1">Distance</dt>
4334 <dd>
4335 <p>Distance over the ground to the rocket.</p>
4336 </dd>
4337 <dt class="hdlist1">Tar Lat/Tar Lon</dt>
4338 <dd>
4339 <p>Displays the last known location of the rocket.</p>
4340 </dd>
4341 <dt class="hdlist1">My Lat/My Lon</dt>
4342 <dd>
4343 <p>Displays the location of the Android device.</p>
4344 </dd>
4345 <dt class="hdlist1">Max Height</dt>
4346 <dd>
4347 <p>Shows the maximum height above launch pad seen during
4348 the flight.</p>
4349 </dd>
4350 <dt class="hdlist1">Max Speed</dt>
4351 <dd>
4352 <p>Shows the maximum vertical speed seen during the
4353 flight.</p>
4354 </dd>
4355 <dt class="hdlist1">Max Accel</dt>
4356 <dd>
4357 <p>Shows the maximum vertical acceleration seen during
4358 the flight.</p>
4359 </dd>
4360 </dl>
4361 </div>
4362 </div>
4363 <div class="sect2">
4364 <h3 id="_map_2">13.12. Map</h3>
4365 <div class="paragraph">
4366 <p>The 'Map' tab shows a map of the area around the
4367 rocket being tracked along with information needed to
4368 recover it.</p>
4369 </div>
4370 <div class="paragraph">
4371 <p>On the map itself, icons showing the location of the
4372 android device along with the last known location of
4373 each tracker. A blue line is drawn from the android
4374 device location to the currently selected tracker.</p>
4375 </div>
4376 <div class="paragraph">
4377 <p>Below the map, the distance and either bearing or
4378 direction along with the lat/lon of the target and the
4379 android device are shown</p>
4380 </div>
4381 <div class="paragraph">
4382 <p>The Map tab provides the same voice announcements as
4383 the Recover tab.</p>
4384 </div>
4385 </div>
4386 <div class="sect2">
4387 <h3 id="_downloading_flight_logs">13.13. Downloading Flight Logs</h3>
4388 <div class="paragraph">
4389 <p>AltosDroid always saves every bit of telemetry data it
4390 receives. To download that to a computer for use with
4391 AltosUI, remove the SD card from your Android device,
4392 or connect your device to your computer&#8217;s USB port and
4393 browse the files on that device. You will find
4394 '.telem' files in the TeleMetrum directory that will
4395 work with AltosUI directly.</p>
4396 </div>
4397 </div>
4398 </div>
4399 </div>
4400 <div class="sect1">
4401 <h2 id="_system_operation">Appendix A: System Operation</h2>
4402 <div class="sectionbody">
4403 <div class="sect2">
4404 <h3 id="_firmware_modes">A.1. Firmware Modes</h3>
4405 <div class="paragraph">
4406 <p>The AltOS firmware build for the altimeters has two
4407 fundamental modes, “idle” and “flight”.  Which of these modes
4408 the firmware operates in is determined at start up
4409 time.
4410 For
4411 TeleMetrum, TeleMega, EasyMega and EasyTimer, which have accelerometers, the mode is
4412 controlled by the orientation of the
4413 rocket (well, actually the board, of course&#8230;&#8203;) at the time
4414 power is switched on.  If the rocket is “nose up”, then
4415 the flight computer assumes it&#8217;s on a rail or rod being prepared for
4416 launch, so the firmware chooses flight mode.  However, if the
4417 rocket is more or less horizontal, the firmware instead enters
4418 idle mode.
4419 Since
4420 EasyMini doesn&#8217;t
4421 have an
4422 accelerometer we can use to determine orientation, “idle” mode
4423 is selected if the board is connected via USB to a computer,
4424 otherwise the board enters “flight” mode.
4425 TeleMini
4426 selects “idle” mode if it receives a command packet
4427 within the
4428 first five seconds of operation.</p>
4429 </div>
4430 <div class="paragraph">
4431 <p>At power on, the altimeter will beep out the battery voltage
4432 to the nearest tenth of a volt.  Each digit is represented by
4433 a sequence of short “dit” beeps, with a pause between
4434 digits. A zero digit is represented with one long “dah”
4435 beep. Then there will be a short pause while the altimeter
4436 completes initialization and self test, and decides which mode
4437 to enter next.</p>
4438 </div>
4439 <div class="paragraph">
4440 <p>In flight or “pad” mode, the altimeter engages the flight
4441 state machine, goes into transmit-only mode to send telemetry,
4442 and waits for launch to be detected.  Flight mode is indicated
4443 by an “di-dah-dah-dit” (“P” for pad) on the beeper or lights,
4444 followed by beeps or flashes indicating the state of the
4445 pyrotechnic igniter continuity.  One beep/flash indicates
4446 apogee continuity, two beeps/flashes indicate main continuity,
4447 three beeps/flashes indicate both apogee and main continuity,
4448 and one longer “brap” sound which is made by rapidly
4449 alternating between two tones indicates no continuity.  For a
4450 dual deploy flight, make sure you&#8217;re getting three beeps or
4451 flashes before launching!  For apogee-only or motor eject
4452 flights, do what makes sense.</p>
4453 </div>
4454 <div class="paragraph">
4455 <p>If idle mode is entered, you will hear an audible “di-dit” or
4456 see two short flashes (“I” for idle), and the flight state
4457 machine is disengaged, thus no ejection charges will fire.
4458 The altimeters also listen for the radio link when in idle
4459 mode for requests sent via TeleDongle.  Commands can be issued
4460 in idle mode over either USB or the radio link
4461 equivalently.
4462 TeleMini only has the radio link.
4463 Idle mode is useful for configuring the altimeter, for
4464 extracting data from the on-board storage chip after
4465 flight, and for ground testing pyro charges.</p>
4466 </div>
4467 <div class="paragraph">
4468 <p>In “Idle” and “Pad” modes, once the mode indication
4469 beeps/flashes and continuity indication has been sent, if
4470 there is no space available to log the flight in on-board
4471 memory, the flight computer will emit a warbling tone (much
4472 slower than the “no continuity tone”)</p>
4473 </div>
4474 <div class="paragraph">
4475 <p>See <a href="#_understanding_beeps">Understanding Beeps</a> for a summary of all of
4476 the audio signals used.</p>
4477 </div>
4478 <div class="paragraph">
4479 <p>Once landed, the flight computer will signal that by emitting
4480 the “Landed” sound described above, after which it will beep
4481 out the apogee height (in meters). Each digit is represented
4482 by a sequence of short “dit” beeps, with a pause between
4483 digits. A zero digit is represented with one long “dah”
4484 beep. The flight computer will continue to report landed mode
4485 and beep out the maximum height until turned off.</p>
4486 </div>
4487 <div class="paragraph">
4488 <p>One “neat trick” of particular value when TeleMetrum, TeleMega
4489 or EasyMega are used with
4490 very large air-frames, is that you can power the board up while the
4491 rocket is horizontal, such that it comes up in idle mode.  Then you can
4492 raise the air-frame to launch position, and issue a 'reset' command
4493 via TeleDongle over the radio link to cause the altimeter to reboot and
4494 come up in flight mode.  This is much safer than standing on the top
4495 step of a rickety step-ladder or hanging off the side of a launch
4496 tower with a screw-driver trying to turn on your avionics before
4497 installing igniters!</p>
4498 </div>
4499 <div class="paragraph">
4500 <p>TeleMini is configured solely via the radio link. Of course, that
4501 means you need to know the TeleMini radio configuration values
4502 or you won&#8217;t be able to communicate with it. For situations
4503 when you don&#8217;t have the radio configuration values,
4504 TeleMini v1.0
4505 offers an 'emergency recovery' mode. In this mode,
4506 TeleMini v1.0 is
4507 configured as follows:</p>
4508 </div>
4509 <div class="ulist">
4510 <ul>
4511 <li>
4512 <p>Sets the radio frequency to 434.550MHz</p>
4513 </li>
4514 <li>
4515 <p>Sets the radio calibration back to the factory value.</p>
4516 </li>
4517 <li>
4518 <p>Sets the callsign to N0CALL</p>
4519 </li>
4520 <li>
4521 <p>Does not go to 'pad' mode after five seconds.</p>
4522 </li>
4523 </ul>
4524 </div>
4525 <div class="paragraph">
4526 <p>To get into 'emergency recovery' mode, first find the row of
4527 four small holes opposite the switch wiring. Using a short
4528 piece of small gauge wire, connect the outer two holes
4529 together, then power TeleMini up. Once the red LED is lit,
4530 disconnect the wire and the board should signal that it&#8217;s in
4531 'idle' mode after the initial five second startup
4532 period.</p>
4533 </div>
4534 </div>
4535 <div class="sect2">
4536 <h3 id="_gps">A.2. GPS</h3>
4537 <div class="paragraph">
4538 <p>TeleMetrum and TeleMega include a complete GPS receiver.  A
4539 complete explanation of how GPS works is beyond the scope of
4540 this manual, but the bottom line is that the GPS receiver
4541 needs to lock onto at least four satellites to obtain a solid
4542 3 dimensional position fix and know what time it is.</p>
4543 </div>
4544 <div class="paragraph">
4545 <p>The flight computers provide backup power to the GPS chip any time a
4546 battery is connected.  This allows the receiver to “warm start” on
4547 the launch rail much faster than if every power-on were a GPS
4548 “cold start”.  In typical operations, powering up
4549 on the flight line in idle mode while performing final air-frame
4550 preparation will be sufficient to allow the GPS receiver to cold
4551 start and acquire lock.  Then the board can be powered down during
4552 RSO review and installation on a launch rod or rail.  When the board
4553 is turned back on, the GPS system should lock very quickly, typically
4554 long before igniter installation and return to the flight line are
4555 complete.</p>
4556 </div>
4557 </div>
4558 <div class="sect2">
4559 <h3 id="_controlling_an_altimeter_over_the_radio_link">A.3. Controlling An Altimeter Over The Radio Link</h3>
4560 <div class="paragraph">
4561 <p>One of the unique features of the Altus Metrum system is the
4562 ability to create a two way command link between TeleDongle
4563 and an altimeter using the digital radio transceivers
4564 built into each device. This allows you to interact with the
4565 altimeter from afar, as if it were directly connected to the
4566 computer.</p>
4567 </div>
4568 <div class="paragraph">
4569 <p>Any operation which can be performed with a flight computer can
4570 either be done with the device directly connected to the
4571 computer via the USB cable, or through the radio
4572 link. TeleMini doesn&#8217;t provide a USB connector and so it is
4573 always communicated with over radio.  Select the appropriate
4574 TeleDongle device when the list of devices is presented and
4575 AltosUI will interact with an altimeter over the radio link.</p>
4576 </div>
4577 <div class="paragraph">
4578 <p>One oddity in the current interface is how AltosUI selects the
4579 frequency for radio communications. Instead of providing
4580 an interface to specifically configure the frequency, it uses
4581 whatever frequency was most recently selected for the target
4582 TeleDongle device in Monitor Flight mode. If you haven&#8217;t ever
4583 used that mode with the TeleDongle in question, select the
4584 Monitor Flight button from the top level UI, and pick the
4585 appropriate TeleDongle device.  Once the flight monitoring
4586 window is open, select the desired frequency and then close it
4587 down again. All radio communications will now use that frequency.</p>
4588 </div>
4589 <div class="ulist">
4590 <ul>
4591 <li>
4592 <p>Save Flight Data—Recover flight data from the
4593 rocket without opening it up.</p>
4594 </li>
4595 <li>
4596 <p>Configure altimeter apogee delays, main deploy
4597 heights and additional pyro event conditions to
4598 respond to changing launch conditions. You can also
4599 'reboot' the altimeter. Use this to remotely enable
4600 the flight computer by turning TeleMetrum or
4601 TeleMega on in “idle” mode, then once the air-frame
4602 is oriented for launch, you can reboot the
4603 altimeter and have it restart in pad mode without
4604 having to climb the scary ladder.</p>
4605 </li>
4606 <li>
4607 <p>Fire Igniters—Test your deployment charges without snaking
4608 wires out through holes in the air-frame. Simply assemble the
4609 rocket as if for flight with the apogee and main charges
4610 loaded, then remotely command the altimeter to fire the
4611 igniters.</p>
4612 </li>
4613 </ul>
4614 </div>
4615 <div class="paragraph">
4616 <p>Operation over the radio link for configuring an
4617 altimeter, ground testing igniters, and so forth uses
4618 the same RF frequencies as flight telemetry.  To
4619 configure the desired TeleDongle frequency, select the
4620 monitor flight tab, then use the frequency selector
4621 and close the window before performing other desired
4622 radio operations.</p>
4623 </div>
4624 <div class="paragraph">
4625 <p>The flight computers only enable radio commanding in
4626 'idle' mode.  TeleMetrum and TeleMega use the
4627 accelerometer to detect which orientation they start
4628 up in, so make sure you have the flight computer lying
4629 horizontally when you turn it on. Otherwise, it will
4630 start in 'pad' mode ready for flight, and will not be
4631 listening for command packets from TeleDongle.</p>
4632 </div>
4633 <div class="paragraph">
4634 <p>TeleMini listens for a command packet for five seconds
4635 after first being turned on, if it doesn&#8217;t hear
4636 anything, it enters 'pad' mode, ready for flight and
4637 will no longer listen for command packets. The easiest
4638 way to connect to TeleMini is to initiate the command
4639 and select the TeleDongle device. At this point, the
4640 TeleDongle will be attempting to communicate with the
4641 TeleMini. Now turn TeleMini on, and it should
4642 immediately start communicating with the TeleDongle
4643 and the desired operation can be performed.</p>
4644 </div>
4645 <div class="paragraph">
4646 <p>You can monitor the operation of the radio link by watching the
4647 lights on the devices. The red LED will flash each time a packet
4648 is transmitted, while the green LED will light up on TeleDongle when
4649 it is waiting to receive a packet from the altimeter.</p>
4650 </div>
4651 </div>
4652 <div class="sect2">
4653 <h3 id="_ground_testing">A.4. Ground Testing</h3>
4654 <div class="paragraph">
4655 <p>An important aspect of preparing a rocket using electronic deployment
4656 for flight is ground testing the recovery system.
4657 Thanks
4658 to the bi-directional radio link central to the Altus Metrum system,
4659 this can be accomplished in a TeleMega, TeleMetrum or TeleMini equipped rocket
4660 with less work than you may be accustomed to with other systems.  It
4661 can even be fun!</p>
4662 </div>
4663 <div class="paragraph">
4664 <p>Just prep the rocket for flight, then power up the altimeter
4665 in “idle”
4666 mode (placing air-frame horizontal for TeleMetrum or TeleMega, or
4667 selecting the Configure Altimeter tab for TeleMini).
4668 This will cause
4669 the firmware to go into “idle” mode, in which the normal flight
4670 state machine is disabled and charges will not fire without
4671 manual command.
4672 You can now command the altimeter to fire the apogee
4673 or main charges from a safe distance using your
4674 computer and the Fire Igniter tab to complete ejection testing.</p>
4675 </div>
4676 </div>
4677 <div class="sect2">
4678 <h3 id="_radio_link">A.5. Radio Link</h3>
4679 <div class="paragraph">
4680 <p>TeleMetrum, TeleMini and TeleMega all incorporate an
4681 RF transceiver, but it&#8217;s not a full duplex system;
4682 each end can only be transmitting or receiving at any
4683 given moment. So we had to decide how to manage the
4684 link.</p>
4685 </div>
4686 <div class="paragraph">
4687 <p>By design, the altimeter firmware listens for the
4688 radio link when it&#8217;s in “idle mode”, which allows us
4689 to use the radio link to configure the rocket, do
4690 things like ejection tests, and extract data after a
4691 flight without having to crack open the air-frame.
4692 However, when the board is in “flight mode”, the
4693 altimeter only transmits and doesn&#8217;t listen at all.
4694 That&#8217;s because we want to put ultimate priority on
4695 event detection and getting telemetry out of the
4696 rocket through the radio in case the rocket crashes
4697 and we aren&#8217;t able to extract data later.</p>
4698 </div>
4699 <div class="paragraph">
4700 <p>We don&#8217;t generally use a 'normal packet radio' mode
4701 like APRS because they&#8217;re just too inefficient.  The
4702 GFSK modulation we use is FSK with the base-band
4703 pulses passed through a Gaussian filter before they go
4704 into the modulator to limit the transmitted bandwidth.
4705 When combined with forward error correction and
4706 interleaving, this allows us to have a very robust
4707 19.2 kilobit data link with only 10-40 milliwatts of
4708 transmit power, a whip antenna in the rocket, and a
4709 hand-held Yagi on the ground.  We&#8217;ve had flights to
4710 above 21k feet AGL with great reception, and
4711 calculations suggest we should be good to well over
4712 40k feet AGL with a 5-element yagi on the ground with
4713 our 10mW units and over 100k feet AGL with the 40mW
4714 devices.  We hope to fly boards to higher altitudes
4715 over time, and would of course appreciate customer
4716 feedback on performance in higher altitude flights!</p>
4717 </div>
4718 </div>
4719 <div class="sect2">
4720 <h3 id="_aprs">A.6. APRS</h3>
4721 <div class="paragraph">
4722 <p>TeleMetrum v2 and newer and TeleMega can send APRS if desired, and the
4723 interval between APRS packets can be configured. As
4724 each APRS packet takes a full second to transmit, we
4725 recommend an interval of at least 5 seconds to avoid
4726 consuming too much battery power or radio channel
4727 bandwidth. You can configure the time within each
4728 minute that APRS transmits by changing the APRS offset
4729 value. When the GPS signal is locked and knows the
4730 current time, the APRS offset selects the time with
4731 each minute for the first APRS transmission;
4732 subsequent transmissions occur each APRS interval
4733 seconds thereafter.  You can configure the APRS
4734 interval and APRS offset using AltosUI; that
4735 process is described in <a href="#_configure_altimeter">Configure Altimeter</a>.</p>
4736 </div>
4737 <div class="paragraph">
4738 <p>AltOS supports both compressed and uncompressed APRS
4739 position report data formats. The compressed format
4740 provides for higher position precision and shorter
4741 packets than the uncompressed APRS format. We&#8217;ve found
4742 some older APRS receivers that do not handle the
4743 compressed format. The Kenwood TH-72A requires the use
4744 of uncompressed format to display altitude information
4745 correctly. The Yaesu FT1D requires the use of
4746 compressed format to display altitude information.</p>
4747 </div>
4748 <div class="paragraph">
4749 <p>APRS packets include an SSID (Secondary Station Identifier)
4750 field that allows one operator to have multiple
4751 transmitters. AltOS allows you to set this to a single digit
4752 from 0 to 9, allowing you to fly multiple transmitters at the
4753 same time while keeping the identify of each one separate in
4754 the receiver. By default, the SSID is set to the last digit of
4755 the device serial number.</p>
4756 </div>
4757 <div class="paragraph">
4758 <p>The APRS packet format includes a comment field that
4759 can have arbitrary text in it. AltOS uses this to send
4760 status information as shown in the following table.</p>
4761 </div>
4762 <table class="tableblock frame-all grid-all stretch">
4763 <caption class="title">Table 10. Altus Metrum APRS Comments</caption>
4764 <colgroup>
4765 <col style="width: 20%;">
4766 <col style="width: 20%;">
4767 <col style="width: 60%;">
4768 </colgroup>
4769 <thead>
4770 <tr>
4771 <th class="tableblock halign-left valign-top">Field</th>
4772 <th class="tableblock halign-left valign-top">Example</th>
4773 <th class="tableblock halign-left valign-top">Description</th>
4774 </tr>
4775 </thead>
4776 <tbody>
4777 <tr>
4778 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
4779 <td class="tableblock halign-left valign-top"><p class="tableblock">L</p></td>
4780 <td class="tableblock halign-left valign-top"><p class="tableblock">GPS Status U for unlocked, L for locked</p></td>
4781 </tr>
4782 <tr>
4783 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
4784 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
4785 <td class="tableblock halign-left valign-top"><p class="tableblock">Number of Satellites in View</p></td>
4786 </tr>
4787 <tr>
4788 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
4789 <td class="tableblock halign-left valign-top"><p class="tableblock">B4.0</p></td>
4790 <td class="tableblock halign-left valign-top"><p class="tableblock">Altimeter Battery Voltage</p></td>
4791 </tr>
4792 <tr>
4793 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
4794 <td class="tableblock halign-left valign-top"><p class="tableblock">A3.7</p></td>
4795 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee Igniter Voltage</p></td>
4796 </tr>
4797 <tr>
4798 <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
4799 <td class="tableblock halign-left valign-top"><p class="tableblock">M3.7</p></td>
4800 <td class="tableblock halign-left valign-top"><p class="tableblock">Main Igniter Voltage</p></td>
4801 </tr>
4802 <tr>
4803 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
4804 <td class="tableblock halign-left valign-top"><p class="tableblock">1286</p></td>
4805 <td class="tableblock halign-left valign-top"><p class="tableblock">Device Serial Number</p></td>
4806 </tr>
4807 <tr>
4808 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
4809 <td class="tableblock halign-left valign-top"><p class="tableblock">1286</p></td>
4810 <td class="tableblock halign-left valign-top"><p class="tableblock">Device Serial Number</p></td>
4811 </tr>
4812 </tbody>
4813 </table>
4814 <div class="paragraph">
4815 <p>Here&#8217;s an example of an APRS comment showing GPS lock with 6
4816 satellites in view, a primary battery at 4.0V, and
4817 apogee and main igniters both at 3.7V from device 1286.</p>
4818 </div>
4819 <div class="literalblock">
4820 <div class="content">
4821 <pre>L6 B4.0 A3.7 M3.7 1286</pre>
4822 </div>
4823 </div>
4824 <div class="paragraph">
4825 <p>Here&#8217;s an example of an APRS comment showing GPS lock with 6
4826 satellites in view and a primary battery at 4.0V from device 1876.</p>
4827 </div>
4828 <div class="literalblock">
4829 <div class="content">
4830 <pre>L6 B4.0 1876</pre>
4831 </div>
4832 </div>
4833 <div class="paragraph">
4834 <p>Make sure your primary battery is above 3.8V
4835 any connected igniters are above 3.5V
4836 and GPS is locked with at least 5 or 6 satellites in
4837 view before flying. If GPS is switching between L and
4838 U regularly, then it doesn&#8217;t have a good lock and you
4839 should wait until it becomes stable.</p>
4840 </div>
4841 <div class="paragraph">
4842 <p>If the GPS receiver loses lock, the APRS data
4843 transmitted will contain the last position for which
4844 GPS lock was available. You can tell that this has
4845 happened by noticing that the GPS status character
4846 switches from 'L' to 'U'. Before GPS has locked, APRS
4847 will transmit zero for latitude, longitude and
4848 altitude.</p>
4849 </div>
4850 </div>
4851 <div class="sect2">
4852 <h3 id="_configurable_parameters">A.7. Configurable Parameters</h3>
4853 <div class="paragraph">
4854 <p>Configuring an Altus Metrum altimeter for flight is
4855 very simple.  Even on our baro-only TeleMini and
4856 EasyMini boards, the use of a Kalman filter means
4857 there is no need to set a “mach delay”.  All of the
4858 configurable parameters can be set using AltosUI. Read
4859 <a href="#_configure_altimeter">Configure Altimeter</a> for more information.</p>
4860 </div>
4861 </div>
4862 </div>
4863 </div>
4864 <div class="sect1">
4865 <h2 id="_example_pyro_channel_configurations">Appendix B: Example Pyro Channel Configurations</h2>
4866 <div class="sectionbody">
4867 <div class="paragraph">
4868 <p>Programming configurable pyro channels on Altus Metrum products that
4869 include them isn&#8217;t difficult, but in an attempt to aid understanding
4870 of the configuration interface and help "keep simple things simple",
4871 we offer the following examples of the simplest configurations for
4872 common situations, along with some hints on avoiding unexpected
4873 results.</p>
4874 </div>
4875 <div class="paragraph">
4876 <p>The rich set of conditions provided can be used to configure almost
4877 any pyro event you can imagine, for a wide variety of objectives.
4878 But don&#8217;t be fooled!  Typical events need only one or a few simple
4879 conditions to be configured for success.  A key thing to remember is
4880 that <strong>all</strong> configured conditions must be true to allow a pyro channel
4881 to fire.  Trying to include too many conditions often results in
4882 conflicting rules that never allow a channel to fire.  The most
4883 important advice we can offer is, therefore, to try and find the
4884 simplest set of conditions that will do what you need for a given
4885 project.</p>
4886 </div>
4887 <div class="sect2">
4888 <h3 id="_two_stage_flights">B.1. Two-Stage Flights</h3>
4889 <div class="paragraph">
4890 <p>Successful completion of a two-stage flight often involves
4891 programming of two events.  The first is firing a separation
4892 charge, the second is igniting the sustainer&#8217;s (primary)
4893 motor.</p>
4894 </div>
4895 <div class="paragraph">
4896 <p>Separation charges are best fired as soon as possible after
4897 the previous stage has completed providing acceleration, to
4898 minimize drag of the sustainer&#8217;s coast phase before ignition.
4899 Recovery, whether the remainder of the flight is nominal or
4900 not, usually works best when the states are separated.  So,
4901 the "best" way to configure a pyro channel for a separation
4902 charge is to just set "after motor number".  For a 2-stage
4903 project, set this to "1".  This will cause the pyro channel
4904 to fire as soon as the firmware&#8217;s flight state machine
4905 determines the first motor has burned out.</p>
4906 </div>
4907 <div class="paragraph">
4908 <p>Safe ignition of a sustainer (primary) motor requires that
4909 it happen after the previous stage burns out, while the
4910 airframe remains mostly vertical, and typically after the
4911 sustainer has coasted away from the booster a bit.  A good
4912 starting point is thus "after motor number" set the same as
4913 the separation charge, which is "1" for a 2-stage rocket.
4914 Then "angle from vertical less than" set to some
4915 reasonably vertical amount, perhaps 20 degrees.  Then "delay
4916 after other conditions" set for the desired duration of coast.
4917 Use simulations to figure out what a reasonable value here is,
4918 but for typical high power rocketry sport flights that aren&#8217;t
4919 trying to set records, something like 2 seconds is usually a
4920 good place to start.</p>
4921 </div>
4922 </div>
4923 <div class="sect2">
4924 <h3 id="_triggered_clusters_and_air_starts">B.2. Triggered Clusters and Air Starts</h3>
4925 <div class="paragraph">
4926 <p>When an airframe has a cluster of motors, one of which is
4927 "primary" and centered, surrounding by a ring of "secondary"
4928 motors, you may want to use the launch control system to                        fire the primary motor and use onboard electronics to light
4929 the rest of the cluster as soon as launch is detected.  This
4930 is particularly true if the primary motor is significantly
4931 different in geometry and may take longer to come up to
4932 pressure than the secondary motors.  In this case, a simple
4933 configuration to light secondary motors is is "time since
4934 boost greater than" enabled and set to "0".  There&#8217;s
4935 really no point in setting an angle limit since no time has
4936 transpired for the airframe to change orientation.</p>
4937 </div>
4938 <div class="paragraph">
4939 <p>Air starts can use the same simple configuration, but with
4940 the time set to a non-zero value.  However, if air starts
4941 are going to light after the airframe leaves the launch rail
4942 or tower, add an "angle from vertical less than"
4943 condition just you would for a 2-stage sustainer to stay safe.</p>
4944 </div>
4945 </div>
4946 <div class="sect2">
4947 <h3 id="_redundant_apogee">B.3. Redundant Apogee</h3>
4948 <div class="paragraph">
4949 <p>When flying a board like TeleMega or EasyMega, it&#8217;s easy to
4950 configure a programmable channel to fire a redundant apogee
4951 charge.  This is of course not <strong>fully</strong> redundant, since it&#8217;s
4952 always possible that the board itself or its battery could
4953 the the failure source, but far more often, pyro events fail
4954 due to broken wires, bad connectors, or bad e-matches&#8230;&#8203; so
4955 firing two charges from one board can add useful redundancy.</p>
4956 </div>
4957 <div class="paragraph">
4958 <p>The simplest configuration for redundant apogee is "flight
4959 state after" set to "drogue", and then "delay after other
4960 conditions" set to a second or two.</p>
4961 </div>
4962 </div>
4963 <div class="sect2">
4964 <h3 id="_redundant_main">B.4. Redundant Main</h3>
4965 <div class="paragraph">
4966 <p>Similarly to apogee, configuring a redundant main charge can
4967 provide useful redundancy.  What we want is to configure an
4968 altitude for deployment lower than the primary main deploy
4969 altitude, and then ensure we only trigger on that condition
4970 while descending.</p>
4971 </div>
4972 <div class="paragraph">
4973 <p>The simplest configuration for redundant main is "flight
4974 state after" set to "drogue", which will ensure we&#8217;re in to
4975 the descent phase, then "height less than" set to a number
4976 lower than you&#8217;ve chosen for the primary main channel
4977 deployment height.</p>
4978 </div>
4979 </div>
4980 <div class="sect2">
4981 <h3 id="_apogee_above_baro_sensor_limit">B.5. Apogee Above Baro Sensor Limit</h3>
4982 <div class="paragraph">
4983 <p>A question we&#8217;ve seen increasingly often is "How does the
4984 Telemega/Easymega detect apogee for flights above 100,000
4985 feet?"  Flights above that height are a bit outside
4986 our original design envelope, but can be made to work&#8230;&#8203;
4987 This is <strong>not</strong> a simple flight, and the configuration for it
4988 is also not simple, but we think including this information
4989 is important for anyone contemplating such a project with our
4990 electronics!</p>
4991 </div>
4992 <div class="paragraph">
4993 <p>Our flight computers use a Kalman sensor-fusing filter to
4994 estimate the flight state, which consists of three values:</p>
4995 </div>
4996 <div class="olist arabic">
4997 <ol class="arabic">
4998 <li>
4999 <p>Height above ground</p>
5000 </li>
5001 <li>
5002 <p>Vertical speed</p>
5003 </li>
5004 <li>
5005 <p>Vertical acceleration</p>
5006 </li>
5007 </ol>
5008 </div>
5009 <div class="paragraph">
5010 <p>Apogee is assumed to be where vertical speed crosses zero.</p>
5011 </div>
5012 <div class="paragraph">
5013 <p>Below 30km altitude (about 100k'), we use both the barometer
5014 and the accelerometer to update the flight state, along with
5015 a basic Newtonian model of motion. That works well, pegging
5016 apogee within a few sensor samples essentially every time.</p>
5017 </div>
5018 <div class="paragraph">
5019 <p>Above 30km, the barometric sensor doesn&#8217;t provide useful data,
5020 so we can&#8217;t use it to update the flight state. Instead, the
5021 Kalman filter falls back to a single sensor mode, using only
5022 the accelerometer.</p>
5023 </div>
5024 <div class="paragraph">
5025 <p>At all altitudes, we de-sense the barometric data when we
5026 estimate the speed is near or above mach as the sensor is
5027 often subjected to significant transients, which would
5028 otherwise push the flight state estimates too fast and could
5029 trigger a false apogee event.</p>
5030 </div>
5031 <div class="paragraph">
5032 <p>That means the filter is no longer getting the benefit of two
5033 sensors, and relies on just the accelerometer. The trouble
5034 with accelerometers is they&#8217;re measuring the derivative of
5035 speed, so you have to integrate their values to compute speed.
5036 Any offset error in acceleration measurement gets constantly
5037 added to that speed.</p>
5038 </div>
5039 <div class="paragraph">
5040 <p>In addition, we assume the axial acceleration is actually
5041 vertical acceleration; our tilt measurements have enough
5042 integration error during coast that we can&#8217;t usefully use
5043 that to get vertical acceleration. Because we don&#8217;t live in
5044 an inertial frame, that means we&#8217;re mis-computing the total
5045 acceleration acting on the airframe as we have to add gravity
5046 into the mix, and simply adding that to the axial acceleration
5047 value doesn&#8217;t generate the right value.</p>
5048 </div>
5049 <div class="paragraph">
5050 <p>The effect of this is to under-estimate apogee when you base
5051 the computation purely on acceleration as the rocket flies a
5052 parabolic path.</p>
5053 </div>
5054 <div class="paragraph">
5055 <p>For flights <strong>near</strong> 100k', all of this works pretty well -
5056 you&#8217;ve got the flight state estimates adjusted using the
5057 barometric sensor up to 30km, then you&#8217;re flying on inertial
5058 data to apogee.</p>
5059 </div>
5060 <div class="paragraph">
5061 <p>For flights well above 100k', it&#8217;s not great; you&#8217;re usually
5062 going fast enough through 100k' that the baro sensor is still
5063 de-sensed through the end of its useful range, so the flight
5064 state estimates are not as close. After that, as you&#8217;re flying
5065 purely on accelerometer data, there&#8217;s no way to re-correct the
5066 state, so the apogee estimates can be off by quite a bit.</p>
5067 </div>
5068 <div class="paragraph">
5069 <p>In the worst cases we have seen, the baro sensor data was
5070 wildly incorrect above mach due to poor static port design,
5071 leaving the state estimate of speed across the 30km boundary
5072 way off and causing the apogee detection to happen far from
5073 the correct time.</p>
5074 </div>
5075 <div class="paragraph">
5076 <p>The good news is that correctly determining apogee is not
5077 really all that important at high altitudes; there&#8217;s so little
5078 density that a drogue will have almost no drag anyways.  Data
5079 from customer flights shows a very parabolic path down to
5080 about 50-60k feet, even with a recovery system deployed.</p>
5081 </div>
5082 <div class="paragraph">
5083 <p>So, what we recommend is to set up two apogee plans:</p>
5084 </div>
5085 <div class="olist arabic">
5086 <ol class="arabic">
5087 <li>
5088 <p>Use the built-in apogee detection, but add a
5089 significant delay (as much as 30 seconds). This
5090 will probably fire near enough to apogee to not
5091 have a significant impact on the maximum height
5092 achieved.</p>
5093 </li>
5094 <li>
5095 <p>Add a back-up apogee which fires after apogee
5096 <strong>when the height is below about 20-25km</strong>. This
5097 way, if the flight isn&#8217;t nominal, and the sustainer
5098 ends up reaching apogee in dense air, you aren&#8217;t
5099 hoping the chutes come out before it gets going
5100 too fast. And, you get a second pyro channel firing
5101 at that altitude even if it reached a higher
5102 altitude before.</p>
5103 </li>
5104 </ol>
5105 </div>
5106 <div class="paragraph">
5107 <p>You can wire these two pyro channels to the same pyro device;
5108 you just need to make sure they&#8217;re wired + to + and - to -
5109 (the manual shows which screw terminals are which).</p>
5110 </div>
5111 <div class="paragraph">
5112 <p>The bottom line is that flights to altitudes modestly above
5113 the range of the baro sensor with Altus Metrum products can
5114 be accomplished safely, but flying "way high" (like 300k')
5115 demands a deployment mechanism which doesn&#8217;t solely rely on
5116 altimeters (like ours) which are designed for modest altitude
5117 rocketry.  Flights to those altitudes also probably need
5118 active stabilization to make sure they follow the prescribed
5119 trajectory and stay inside their waiver.</p>
5120 </div>
5121 </div>
5122 </div>
5123 </div>
5124 <div class="sect1">
5125 <h2 id="_handling_precautions">Appendix C: Handling Precautions</h2>
5126 <div class="sectionbody">
5127 <div class="paragraph">
5128 <p>All Altus Metrum products are sophisticated electronic devices.
5129 When handled gently and properly installed in an air-frame, they
5130 will deliver impressive results.  However, as with all electronic
5131 devices, there are some precautions you must take.</p>
5132 </div>
5133 <div class="admonitionblock warning">
5134 <table>
5135 <tr>
5136 <td class="icon">
5137 <img src="./images/icons/warning.svg" alt="Warning">
5138 </td>
5139 <td class="content">
5140 The Lithium Polymer rechargeable batteries have an
5141 extraordinary power density.  This is great because we can fly with
5142 much less battery mass than if we used alkaline batteries or previous
5143 generation rechargeable batteries&#8230;&#8203; but if they are punctured
5144 or their leads are allowed to short, they can and will release their
5145 energy very rapidly!
5146 Thus we recommend that you take some care when handling our batteries
5147 and consider giving them some extra protection in your air-frame.  We
5148 often wrap them in suitable scraps of closed-cell packing foam before
5149 strapping them down, for example.
5150 </td>
5151 </tr>
5152 </table>
5153 </div>
5154 <div class="paragraph">
5155 <p>The barometric sensors used on all of our flight computers are
5156 sensitive to sunlight.  In normal mounting situations, the baro sensor
5157 and all of the other surface mount components
5158 are “down” towards whatever the underlying mounting surface is, so
5159 this is not normally a problem.  Please consider this when designing an
5160 installation in an air-frame with a see-through plastic payload bay.  It
5161 is particularly important to
5162 consider this with TeleMini v1.0, both because the baro sensor is on the
5163 “top” of the board, and because many model rockets with payload bays
5164 use clear plastic for the payload bay!  Replacing these with an opaque
5165 cardboard tube, painting them, or wrapping them with a layer of masking
5166 tape are all reasonable approaches to keep the sensor out of direct
5167 sunlight.</p>
5168 </div>
5169 <div class="paragraph">
5170 <p>The barometric sensor sampling port must be able to “breathe”,
5171 both by not being covered by foam or tape or other materials that might
5172 directly block the hole on the top of the sensor, and also by having a
5173 suitable static vent to outside air.</p>
5174 </div>
5175 <div class="paragraph">
5176 <p>As with all other rocketry electronics, Altus Metrum altimeters must
5177 be protected from exposure to corrosive motor exhaust and ejection
5178 charge gasses.</p>
5179 </div>
5180 </div>
5181 </div>
5182 <div class="sect1">
5183 <h2 id="_updating_device_firmware">Appendix D: Updating Device Firmware</h2>
5184 <div class="sectionbody">
5185 <div class="paragraph">
5186 <p>TeleMega, TeleMetrum v2 and newer, EasyMega, EasyMini and TeleDongle v3
5187 are all
5188 programmed directly over their USB connectors (self
5189 programming).
5190 TeleMetrum v1, TeleMini v1.0 and TeleDongle v0.2 are
5191 all programmed by using another device as a programmer (pair
5192 programming). It&#8217;s important to recognize which kind of devices
5193 you have before trying to reprogram them.</p>
5194 </div>
5195 <div class="paragraph">
5196 <p>TeleMini v3 can be updated directly over USB, but has no USB connector
5197 on the board.  Instead, the USB signals are present on a row of 6
5198 holes adjacent to the copyright assertion in the silk screen.  Thus,
5199 updating firmware on TeleMini v3 requires making up a special cable,
5200 after which you can treat it just like TeleMetrum or TeleMega.  Many
5201 USB cables seem to follow the color code of red is +5V, black is GND,
5202 green is USB +, and white is USB -.  On TeleMini v3, pin 3 which has
5203 a square copper pad is ground, pin 1 is USB -, and pin 2 is USB +.</p>
5204 </div>
5205 <div class="paragraph">
5206 <p>You may wish to begin by ensuring you have current firmware
5207 images.  These are distributed as part of the AltOS software
5208 bundle that also includes the AltosUI ground station program.
5209 Newer ground station versions typically work fine with older
5210 firmware versions, so you don&#8217;t need to update your devices
5211 just to try out new software features.  You can always
5212 download the most recent version from
5213 <a href="http://www.altusmetrum.org/AltOS/" class="bare">http://www.altusmetrum.org/AltOS/</a></p>
5214 </div>
5215 <div class="sect2">
5216 <h3 id="_updating_telemega_telemetrum_v2_or_newer_telemini_v3_easymega_easymini_teledongle_v3_or_telebt_v3_firmware">D.1. Updating TeleMega, TeleMetrum v2 or newer, TeleMini v3, EasyMega, EasyMini, TeleDongle v3 or TeleBT v3 Firmware</h3>
5217 <div class="paragraph">
5218 <p>Self-programmable devices are reprogrammed by
5219 connecting them to your computer over USB.</p>
5220 </div>
5221 <div class="olist arabic">
5222 <ol class="arabic">
5223 <li>
5224 <p>Attach a battery if necessary and power switch to
5225 the target device. Power up the device.</p>
5226 </li>
5227 <li>
5228 <p>Using a Micro USB cable, connect the target device to your
5229 computer&#8217;s USB socket.  If the target is a TeleMini v3,
5230 make up and attach a special USB cable.</p>
5231 </li>
5232 <li>
5233 <p>Run AltosUI, and select 'Flash Image' from the File menu.</p>
5234 </li>
5235 <li>
5236 <p>Select the target device in the Device Selection dialog.</p>
5237 </li>
5238 <li>
5239 <p>Select the image you want to flash to the device,
5240 which should have a name in the form
5241 &lt;product&gt;-v&lt;product-version&gt;-&lt;software-version&gt;.ihx,
5242 such as EasyMini-v1.0-1.6.0.ihx.</p>
5243 </li>
5244 <li>
5245 <p>Make sure the configuration parameters are
5246 reasonable looking. If the serial number and/or RF
5247 configuration values aren&#8217;t right, you&#8217;ll need to
5248 change them.</p>
5249 </li>
5250 <li>
5251 <p>Hit the 'OK' button and the software should proceed
5252 to flash the device with new firmware, showing a
5253 progress bar.</p>
5254 </li>
5255 <li>
5256 <p>Verify that the device is working by using the
5257 'Configure Altimeter' or 'Configure Groundstation'
5258 item to check over the configuration.</p>
5259 </li>
5260 </ol>
5261 </div>
5262 <div class="sect3">
5263 <h4 id="_recovering_from_self_flashing_failure">D.1.1. Recovering From Self-Flashing Failure</h4>
5264 <div class="paragraph">
5265 <p>If the firmware loading fails, it can leave the device
5266 unable to boot. Not to worry, you can force the device to
5267 start the boot loader instead, which will let you try to
5268 flash the device again.</p>
5269 </div>
5270 <div class="paragraph">
5271 <p>On each device, connecting two pins from one of the exposed
5272 connectors will force the boot loader to start, even if the
5273 regular operating system has been corrupted in some way.</p>
5274 </div>
5275 <div class="dlist">
5276 <dl>
5277 <dt class="hdlist1">TeleMega</dt>
5278 <dd>
5279 <p>Connect pin 6 and pin 1 of the companion
5280 connector. Pin 1 can be identified by the square pad
5281 around it, and then the pins count sequentially across
5282 the board. Be very careful to <strong>not</strong> short pin 8 to
5283 anything as that is connected directly to the
5284 battery. Pin 7 carries 3.3V and the board will crash
5285 if that is connected to pin 1, but shouldn&#8217;t damage
5286 the board.</p>
5287 </dd>
5288 <dt class="hdlist1">EasyMega</dt>
5289 <dd>
5290 <p>Connect pin 6 and pin 1 of the companion
5291 connector. Pin 1 can be identified by the square pad
5292 around it, and then the pins count sequentially across
5293 the board. Be very careful to <strong>not</strong> short pin 8 to
5294 anything as that is connected directly to the
5295 battery. Pin 7 carries 3.3V and the board will crash
5296 if that is connected to pin 1, but shouldn&#8217;t damage
5297 the board.</p>
5298 </dd>
5299 <dt class="hdlist1">EasyTimer</dt>
5300 <dd>
5301 <p>Connect pin 5 and pin 1 of the debug connector, which
5302 is the six holes next to the beeper. Pin 1 can be
5303 identified by the square pad around it, and then the
5304 pins count sequentially across the board, making Pin 5
5305 the one on the other end of the row.</p>
5306 </dd>
5307 <dt class="hdlist1">TeleMetrum v2 and newer</dt>
5308 <dd>
5309 <p>Connect pin 6 and pin 1 of the companion
5310 connector. Pin 1 can be identified by the square pad
5311 around it, and then the pins count sequentially across
5312 the board. Be very careful to <strong>not</strong> short pin 8 to
5313 anything as that is connected directly to the
5314 battery. Pin 7 carries 3.3V and the board will crash
5315 if that is connected to pin 1, but shouldn&#8217;t damage
5316 the board.</p>
5317 </dd>
5318 <dt class="hdlist1">EasyMini</dt>
5319 <dd>
5320 <p>Connect pin 6 and pin 1 of the debug connector, which
5321 is the six holes next to the beeper. Pin 1 can be
5322 identified by the square pad around it, and then the
5323 pins count sequentially across the board, making Pin 6
5324 the one on the other end of the row.</p>
5325 </dd>
5326 <dt class="hdlist1">TeleGPS v1</dt>
5327 <dd>
5328 <p>Connect pin 32 on the CPU to ground.  Pin 32 is the
5329 right-most pin on the bottom edge of the CPU when the
5330 board is oriented with the USB and battery connectors
5331 to the right.</p>
5332 </dd>
5333 <dt class="hdlist1">TeleGPS v2</dt>
5334 <dd>
5335 <p>Connect together pins 1 and 5 of the Debug connector.
5336 Pin 1 is the pin with the square pad around the hole.</p>
5337 </dd>
5338 <dt class="hdlist1">TeleDongle v3</dt>
5339 <dd>
5340 <p>Connect pin 32 on the CPU to ground. Pin 32 is closest
5341 to the USB wires on the row of pins towards the center
5342 of the board. Ground is available on the capacitor
5343 next to it, on the end towards the USB wires.</p>
5344 </dd>
5345 <dt class="hdlist1">TeleBT v3</dt>
5346 <dd>
5347 <p>Connect pin 4 on the CPU to 3.3V, which can be done by
5348 connecting pin 1 to pin 4.  Pin 1 is the left pin on
5349 the lower edge of the chip when the unit is oriented
5350 such that the SMA is at the top.</p>
5351 </dd>
5352 <dt class="hdlist1">TeleBT v4</dt>
5353 <dd>
5354 <p>Connect pin 30 on the CPU to ground. Pin 30 is the 6th
5355 pin from the right on the top when the unit is oriented
5356 such that the SMA is at the top.</p>
5357 </dd>
5358 </dl>
5359 </div>
5360 <div class="paragraph">
5361 <p>Once you&#8217;ve located the right pins:</p>
5362 </div>
5363 <div class="olist arabic">
5364 <ol class="arabic">
5365 <li>
5366 <p>Turn the altimeter power off.</p>
5367 </li>
5368 <li>
5369 <p>Connect a battery.</p>
5370 </li>
5371 <li>
5372 <p>Connect the indicated terminals together with a
5373 short piece of wire. Take care not to accidentally
5374 connect anything else.</p>
5375 </li>
5376 <li>
5377 <p>Connect USB</p>
5378 </li>
5379 <li>
5380 <p>Turn the board power on.</p>
5381 </li>
5382 </ol>
5383 </div>
5384 <div class="paragraph">
5385 <p>The board should now be visible over USB as
5386 'AltosFlash' and be ready to receive firmware.  Once
5387 the board has been powered up, you can remove the
5388 piece of wire.</p>
5389 </div>
5390 </div>
5391 </div>
5392 <div class="sect2">
5393 <h3 id="_pair_programming">D.2. Pair Programming</h3>
5394 <div class="paragraph">
5395 <p>The big concept to understand is that you have to use
5396 a TeleMetrum v1.0, TeleBT v1.0 or TeleDongle v0.2 as a
5397 programmer to update a pair programmed device. Due to
5398 limited memory resources in the cc1111, we don&#8217;t
5399 support programming directly over USB for these
5400 devices.</p>
5401 </div>
5402 <div class="paragraph">
5403 <p>If you need to update the firmware on a TeleDongle
5404 v0.2, we recommend updating the altimeter first,
5405 before updating TeleDongle.  However, note that
5406 TeleDongle rarely need to be updated.  Any firmware
5407 version 1.0.1 or later will work, version 1.2.1 may
5408 have improved receiver performance slightly.</p>
5409 </div>
5410 <div class="sect3">
5411 <h4 id="_updating_telemetrum_v1_x_firmware">D.2.1. Updating TeleMetrum v1.x Firmware</h4>
5412 <div class="olist arabic">
5413 <ol class="arabic">
5414 <li>
5415 <p>Find the 'programming cable' that you got as
5416 part of the starter kit, that has a red
5417 8-pin MicroMaTch connector on one end and a
5418 red 4-pin MicroMaTch connector on the other
5419 end.</p>
5420 </li>
5421 <li>
5422 <p>Take the 2 screws out of the TeleDongle v0.2
5423 or TeleBT v1.0 case to get access to the
5424 circuit board.</p>
5425 </li>
5426 <li>
5427 <p>Plug the 8-pin end of the programming cable
5428 to the matching connector on the TeleDongle
5429 v0.2 or TeleBT v1.0, and the 4-pin end to
5430 the matching connector on the TeleMetrum.
5431 Note that each MicroMaTch connector has an
5432 alignment pin that goes through a hole in
5433 the PC board when you have the cable
5434 oriented correctly.</p>
5435 </li>
5436 <li>
5437 <p>Attach a battery to the TeleMetrum board.</p>
5438 </li>
5439 <li>
5440 <p>Plug the TeleDongle v0.2 or TeleBT v1.0 into
5441 your computer&#8217;s USB port, and power up the
5442 TeleMetrum.</p>
5443 </li>
5444 <li>
5445 <p>Run AltosUI, and select 'Flash Image' from
5446 the File menu.</p>
5447 </li>
5448 <li>
5449 <p>Pick the TeleDongle v0.2 or TeleBT v1.0
5450 device from the list, identifying it as the
5451 programming device.</p>
5452 </li>
5453 <li>
5454 <p>Select the image you want put on the
5455 TeleMetrum, which should have a name in the
5456 form telemetrum-v1.2-1.0.0.ihx.  It should
5457 be visible in the default directory, if not
5458 you may have to poke around your system to
5459 find it.</p>
5460 </li>
5461 <li>
5462 <p>Make sure the configuration parameters are
5463 reasonable looking. If the serial number
5464 and/or RF configuration values aren&#8217;t right,
5465 you&#8217;ll need to change them.</p>
5466 </li>
5467 <li>
5468 <p>Hit the 'OK' button and the software should
5469 proceed to flash the TeleMetrum with new
5470 firmware, showing a progress bar.</p>
5471 </li>
5472 <li>
5473 <p>Confirm that the TeleMetrum board seems to
5474 have updated OK, which you can do by
5475 plugging in to it over USB and using a
5476 terminal program to connect to the board and
5477 issue the 'v' command to check the version,
5478 etc.</p>
5479 </li>
5480 </ol>
5481 </div>
5482 <div class="paragraph">
5483 <p>If something goes wrong, give it another try.</p>
5484 </div>
5485 </div>
5486 <div class="sect3">
5487 <h4 id="_updating_telemini_v1_0_firmware">D.2.2. Updating TeleMini v1.0 Firmware</h4>
5488 <div class="paragraph">
5489 <p>You&#8217;ll need a special 'programming cable' to
5490 reprogram the TeleMini v1.0.  You can make your own
5491 using an 8-pin MicroMaTch connector on one end
5492 and a set of four pins on the other.</p>
5493 </div>
5494 <div class="olist arabic">
5495 <ol class="arabic">
5496 <li>
5497 <p>Take the 2 screws out of the TeleDongle v0.2
5498 or TeleBT v1.0 case to get access to the
5499 circuit board.</p>
5500 </li>
5501 <li>
5502 <p>Plug the 8-pin end of the programming cable
5503 to the matching connector on the TeleDongle
5504 v0.2 or TeleBT v1.0, and the 4-pins into the
5505 holes in the TeleMini v1.0 circuit board.  Note
5506 that the MicroMaTch connector has an
5507 alignment pin that goes through a hole in
5508 the PC board when you have the cable
5509 oriented correctly, and that pin 1 on the
5510 TeleMini v1.0 board is marked with a square pad
5511 while the other pins have round pads.</p>
5512 </li>
5513 <li>
5514 <p>Attach a battery to the TeleMini v1.0 board.</p>
5515 </li>
5516 <li>
5517 <p>Plug the TeleDongle v0.2 or TeleBT v1.0 into
5518 your computer&#8217;s USB port, and power up the
5519 TeleMini v1.0</p>
5520 </li>
5521 <li>
5522 <p>Run AltosUI, and select 'Flash Image' from
5523 the File menu.</p>
5524 </li>
5525 <li>
5526 <p>Pick the TeleDongle v0.2 or TeleBT v1.0
5527 device from the list, identifying it as the
5528 programming device.</p>
5529 </li>
5530 <li>
5531 <p>Select the image you want put on the
5532 TeleMini v1.0, which should have a name in the
5533 form telemini-v1.0-1.0.0.ihx.  It should be
5534 visible in the default directory, if not you
5535 may have to poke around your system to find
5536 it.</p>
5537 </li>
5538 <li>
5539 <p>Make sure the configuration parameters are
5540 reasonable looking. If the serial number
5541 and/or RF configuration values aren&#8217;t right,
5542 you&#8217;ll need to change them.</p>
5543 </li>
5544 <li>
5545 <p>Hit the 'OK' button and the software should
5546 proceed to flash the TeleMini v1.0 with new
5547 firmware, showing a progress bar.</p>
5548 </li>
5549 <li>
5550 <p>Confirm that the TeleMini v1.0 board seems to
5551 have updated OK, which you can do by
5552 configuring it over the radio link through
5553 the TeleDongle, or letting it come up in
5554 “flight” mode and listening for telemetry.</p>
5555 </li>
5556 </ol>
5557 </div>
5558 <div class="paragraph">
5559 <p>If something goes wrong, give it another try.</p>
5560 </div>
5561 </div>
5562 <div class="sect3">
5563 <h4 id="_updating_teledongle_v0_2_firmware">D.2.3. Updating TeleDongle v0.2 Firmware</h4>
5564 <div class="paragraph">
5565 <p>Updating TeleDongle v0.2 firmware is just like
5566 updating TeleMetrum v1.x or TeleMini v1.0 firmware, but you
5567 use either a TeleMetrum v1.x, TeleDongle v0.2 or
5568 TeleBT v1.0 as the programmer.</p>
5569 </div>
5570 <div class="olist arabic">
5571 <ol class="arabic">
5572 <li>
5573 <p>Find the 'programming cable' that you got as part of
5574 the starter kit, that has a red 8-pin MicroMaTch
5575 connector on one end and a red 4-pin MicroMaTch
5576 connector on the other end.</p>
5577 </li>
5578 <li>
5579 <p>Find the USB cable that you got as part of the
5580 starter kit, and plug the “mini” end in to the
5581 mating connector on TeleMetrum v1.x, TeleDongle v0.2
5582 or TeleBT v1.0.</p>
5583 </li>
5584 <li>
5585 <p>Take the 2 screws out of the TeleDongle v0.2 or
5586 TeleBT v1.0 case to get access to the circuit board.</p>
5587 </li>
5588 <li>
5589 <p>Plug the 8-pin end of the programming cable to the
5590 matching connector on the programmer, and the 4-pin
5591 end to the matching connector on the TeleDongle
5592 v0.2.  Note that each MicroMaTch connector has an
5593 alignment pin that goes through a hole in the PC
5594 board when you have the cable oriented correctly.</p>
5595 </li>
5596 <li>
5597 <p>Attach a battery to the TeleMetrum v1.x board if
5598 you&#8217;re using one.</p>
5599 </li>
5600 <li>
5601 <p>Plug both the programmer and the TeleDongle into
5602 your computer&#8217;s USB ports, and power up the
5603 programmer.</p>
5604 </li>
5605 <li>
5606 <p>Run AltosUI, and select 'Flash Image' from the File
5607 menu.</p>
5608 </li>
5609 <li>
5610 <p>Pick the programmer device from the list,
5611 identifying it as the programming device.</p>
5612 </li>
5613 <li>
5614 <p>Select the image you want put on the TeleDongle
5615 v0.2, which should have a name in the form
5616 teledongle-v0.2-1.0.0.ihx.  It should be visible in
5617 the default directory, if not you may have to poke
5618 around your system to find it.</p>
5619 </li>
5620 <li>
5621 <p>Make sure the configuration parameters are
5622 reasonable looking. If the serial number and/or RF
5623 configuration values aren&#8217;t right, you&#8217;ll need to
5624 change them.  The TeleDongle v0.2 serial number is
5625 on the “bottom” of the circuit board, and can
5626 usually be read through the translucent blue plastic
5627 case without needing to remove the board from the
5628 case.</p>
5629 </li>
5630 <li>
5631 <p>Hit the 'OK' button and the software should proceed
5632 to flash the TeleDongle v0.2 with new firmware,
5633 showing a progress bar.</p>
5634 </li>
5635 <li>
5636 <p>Confirm that the TeleDongle v0.2 board seems to have
5637 updated OK, which you can do by plugging in to it
5638 over USB and using a terminal program to connect to
5639 the board and issue the 'v' command to check the
5640 version, etc.  Once you&#8217;re happy, remove the
5641 programming cable and put the cover back on the
5642 TeleDongle v0.2.</p>
5643 </li>
5644 </ol>
5645 </div>
5646 <div class="paragraph">
5647 <p>If something goes wrong, give it another try.</p>
5648 </div>
5649 <div class="paragraph">
5650 <p>Be careful removing the programming cable from the
5651 locking 8-pin connector on TeleMetrum.  You&#8217;ll need a
5652 fingernail or perhaps a thin screwdriver or knife
5653 blade to gently pry the locking ears out slightly to
5654 extract the connector.  We used a locking connector on
5655 TeleMetrum to help ensure that the cabling to
5656 companion boards used in a rocket don&#8217;t ever come
5657 loose accidentally in flight.</p>
5658 </div>
5659 </div>
5660 </div>
5661 </div>
5662 </div>
5663 <div class="sect1">
5664 <h2 id="_frequency_calibration">Appendix E: Frequency Calibration</h2>
5665 <div class="sectionbody">
5666 <div class="paragraph">
5667 <p>All products that have radio interfaces require calibration of the radio
5668 frequency.  Normally, this calibration is done once during the production
5669 process and the resulting cal value is saved into non-volatile memory.  The
5670 procedure decribed here should only be used outside of the factory if you
5671 are really convinced the radio calibration is bad, and you have access to
5672 the required tools to do the calibration.</p>
5673 </div>
5674 <div class="paragraph">
5675 <p>Because this procedure is only rarely needed in the field, we have not
5676 written any fancy user interface for doing it .. some interaction with
5677 and careful typing in a command-like style interface are required!</p>
5678 </div>
5679 <div class="sect2">
5680 <h3 id="_background_information">E.1. Background Information</h3>
5681 <div class="paragraph">
5682 <p>The radio system on each board uses a quartz crystal to control
5683 a frequency synthesizer that can be programmed to a range of operating
5684 frequencies.  While these crystals are very stable, they have an accuracy
5685 specification that means once the base frequency they set is multiplied up
5686 to the typical operating range of our products, any variation also gets
5687 multiplied.  The objective of the calibration process is, indirectly, to
5688 measure the actual operating frequency of the crystal and adjust the way
5689 the frequency synthesizer is programmed to account for this variation.</p>
5690 </div>
5691 <div class="paragraph">
5692 <p>The frequency may shift a few tens of Hz over the full operating temperature
5693 range, and it may also shift a bit over time as the crystal ages.  But once
5694 properly calibrated, none of those changes are likely to ever cause any
5695 operational problem, as the shift in operating frequency due to these factors
5696 is tiny compared to the bandwidth of our transmitted signal.</p>
5697 </div>
5698 </div>
5699 <div class="sect2">
5700 <h3 id="_required_equipment">E.2. Required Equipment</h3>
5701 <div class="paragraph">
5702 <p>The calibration process requires the ability to precisely measure the actual
5703 frequency of a steady CW carrier on or about the intended operating frequency
5704 in the vicinity of 435 MHz.</p>
5705 </div>
5706 <div class="paragraph">
5707 <p>In production, we use an HP 5385A that is locked to a 10 MHz reference that
5708 is in turn locked to GPS, which provides a highly accurate calibration.  Any
5709 reasonably accurate frequency counter is likely to be sufficient.</p>
5710 </div>
5711 <div class="paragraph">
5712 <p>You also need a computer with terminal program and USB cable to attach to
5713 the board in question, along with a battery and power switch suitable for
5714 powering the board up.</p>
5715 </div>
5716 </div>
5717 <div class="sect2">
5718 <h3 id="_rf_calibration_procedure">E.3. RF Calibration Procedure</h3>
5719 <div class="paragraph">
5720 <p>Using the terminal program, connect to the board over USB.  You will find
5721 that you are now interacting with a command interpreter on the board.  Using
5722 '?' will show the available commands.  Of interest for this process are the
5723 'C' command which turns on a steady transmitted carrier on the currently
5724 selected operating frequency, and the 'c' subcommands that allow interaction
5725 with the saved configuration.</p>
5726 </div>
5727 <div class="paragraph">
5728 <p>Use the 'c s' command to discover and note the current radio calibration
5729 value, and the operating frequency the board is configured for in kHz.</p>
5730 </div>
5731 <div class="paragraph">
5732 <p>Set up your frequency counter with a suitable antenna near the board&#8217;s
5733 antenna and use the 'C' command to turn on a steady carrier.  Let the
5734 frequency stabilize, and note what it is to as many digits as are steady
5735 on your counter&#8217;s display.</p>
5736 </div>
5737 <div class="paragraph">
5738 <p>To calculate the new calibration value, the equation is:</p>
5739 </div>
5740 <div class="olist arabic">
5741 <ol class="arabic">
5742 <li>
5743 <p>(intended_frequency / measured_frequency) * current_cal_value</p>
5744 </li>
5745 </ol>
5746 </div>
5747 <div class="paragraph">
5748 <p>Set the new calibration value using 'c f &lt;value&gt;', then use 'c w' to save
5749 that cal value into non-volatile memory.  You can use the 'C' command again
5750 to confirm the operating frequency is now within a few 10&#8217;s of Hz of the
5751 intended operating frequency.</p>
5752 </div>
5753 </div>
5754 </div>
5755 </div>
5756 <div class="sect1">
5757 <h2 id="_flight_data_recording">Appendix F: Flight Data Recording</h2>
5758 <div class="sectionbody">
5759 <div class="paragraph">
5760 <p>Each flight computer logs data at 100 samples per second
5761 during ascent and 10 samples per second during
5762 descent, except for TeleMini v1.0, which records ascent at 10 samples
5763 per second and descent at 1 sample per second.
5764 Data are logged to
5765 an on-board flash memory part, which can be partitioned into
5766 several equal-sized blocks, one for each flight.</p>
5767 </div>
5768 <table class="tableblock frame-all grid-all stretch">
5769 <caption class="title">Table 11. Data Storage on Altus Metrum altimeters</caption>
5770 <colgroup>
5771 <col style="width: 25%;">
5772 <col style="width: 25%;">
5773 <col style="width: 25%;">
5774 <col style="width: 25%;">
5775 </colgroup>
5776 <thead>
5777 <tr>
5778 <th class="tableblock halign-left valign-top">Device</th>
5779 <th class="tableblock halign-left valign-top">Bytes per Sample</th>
5780 <th class="tableblock halign-left valign-top">Total Storage</th>
5781 <th class="tableblock halign-left valign-top">Minutes at Full Rate</th>
5782 </tr>
5783 </thead>
5784 <tbody>
5785 <tr>
5786 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.0</p></td>
5787 <td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
5788 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5789 <td class="tableblock halign-left valign-top"><p class="tableblock">20</p></td>
5790 </tr>
5791 <tr>
5792 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.1 v1.2</p></td>
5793 <td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
5794 <td class="tableblock halign-left valign-top"><p class="tableblock">2MB</p></td>
5795 <td class="tableblock halign-left valign-top"><p class="tableblock">40</p></td>
5796 </tr>
5797 <tr>
5798 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v2.0</p></td>
5799 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5800 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5801 <td class="tableblock halign-left valign-top"><p class="tableblock">80</p></td>
5802 </tr>
5803 <tr>
5804 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v3.0</p></td>
5805 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5806 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5807 <td class="tableblock halign-left valign-top"><p class="tableblock">80</p></td>
5808 </tr>
5809 <tr>
5810 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v1.0</p></td>
5811 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
5812 <td class="tableblock halign-left valign-top"><p class="tableblock">5kB</p></td>
5813 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
5814 </tr>
5815 <tr>
5816 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v3.0</p></td>
5817 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5818 <td class="tableblock halign-left valign-top"><p class="tableblock">512kB</p></td>
5819 <td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
5820 </tr>
5821 <tr>
5822 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini</p></td>
5823 <td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
5824 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5825 <td class="tableblock halign-left valign-top"><p class="tableblock">10</p></td>
5826 </tr>
5827 <tr>
5828 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega</p></td>
5829 <td class="tableblock halign-left valign-top"><p class="tableblock">32</p></td>
5830 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5831 <td class="tableblock halign-left valign-top"><p class="tableblock">40</p></td>
5832 </tr>
5833 <tr>
5834 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega</p></td>
5835 <td class="tableblock halign-left valign-top"><p class="tableblock">32</p></td>
5836 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5837 <td class="tableblock halign-left valign-top"><p class="tableblock">40</p></td>
5838 </tr>
5839 </tbody>
5840 </table>
5841 <div class="paragraph">
5842 <p>The on-board flash is partitioned into separate flight logs,
5843 each of a fixed maximum size. Increase the maximum size of
5844 each log and you reduce the number of flights that can be
5845 stored. Decrease the size and you can store more flights.</p>
5846 </div>
5847 <div class="paragraph">
5848 <p>Configuration data is also stored in the flash memory on
5849 TeleMetrum v1.x,
5850 TeleMini v3.0 and
5851 EasyMini.
5852 This consumes 64kB
5853 of flash space.  This configuration space is not available
5854 for storing flight log data.</p>
5855 </div>
5856 <div class="paragraph">
5857 <p>TeleMetrum v2 or newer, TeleMega and EasyMega
5858 store configuration data in a bit of eeprom available within
5859 the processor chip, leaving that space available in flash for
5860 more flight data.</p>
5861 </div>
5862 <div class="paragraph">
5863 <p>To compute the amount of space needed for a single flight, you
5864 can multiply the expected ascent time (in seconds) by 100
5865 times bytes-per-sample, multiply the expected descent time (in
5866 seconds) by 10 times the bytes per sample and add the two
5867 together. That will slightly under-estimate the storage (in
5868 bytes) needed for the flight.
5869 For instance, a TeleMetrum v2 or newer flight spending
5870 20 seconds in ascent and 150 seconds in descent will take
5871 about (20 * 1600) + (150 * 160) = 56000 bytes of storage. You
5872 could store dozens of these flights in the on-board flash.</p>
5873 </div>
5874 <div class="paragraph">
5875 <p>The default size allows for several flights on each flight
5876 computer, except for TeleMini v1.0, which
5877 only holds data for a single flight.
5878 You can adjust the size.</p>
5879 </div>
5880 <div class="paragraph">
5881 <p>Altus Metrum flight computers will not overwrite existing
5882 flight data, so be sure to download flight data and erase it
5883 from the flight computer before it fills up. The flight
5884 computer will still successfully control the flight even if it
5885 cannot log data, so the only thing you will lose is the data.</p>
5886 </div>
5887 </div>
5888 </div>
5889 <div class="sect1">
5890 <h2 id="_altus_metrum_hardware_specifications">Appendix G: Altus Metrum Hardware Specifications</h2>
5891 <div class="sectionbody">
5892 <div class="paragraph">
5893 <p>Here&#8217;s the full set of Altus Metrum products, both in
5894 production and retired.</p>
5895 </div>
5896 <table class="tableblock frame-all grid-all stretch">
5897 <caption class="title">Table 12. Altus Metrum Flight Computer Electronics</caption>
5898 <colgroup>
5899 <col style="width: 12.5%;">
5900 <col style="width: 12.5%;">
5901 <col style="width: 12.5%;">
5902 <col style="width: 12.5%;">
5903 <col style="width: 12.5%;">
5904 <col style="width: 12.5%;">
5905 <col style="width: 12.5%;">
5906 <col style="width: 12.5%;">
5907 </colgroup>
5908 <thead>
5909 <tr>
5910 <th class="tableblock halign-left valign-top">Device</th>
5911 <th class="tableblock halign-left valign-top">Barometer</th>
5912 <th class="tableblock halign-left valign-top">Z-axis accel</th>
5913 <th class="tableblock halign-left valign-top">GPS</th>
5914 <th class="tableblock halign-left valign-top">3D sensors</th>
5915 <th class="tableblock halign-left valign-top">Storage</th>
5916 <th class="tableblock halign-left valign-top">RF Output</th>
5917 <th class="tableblock halign-left valign-top">Battery</th>
5918 </tr>
5919 </thead>
5920 <tbody>
5921 <tr>
5922 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.0</p></td>
5923 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5924 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA2202 50g</p></td>
5925 <td class="tableblock halign-left valign-top"><p class="tableblock">SkyTraq</p></td>
5926 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5927 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5928 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5929 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5930 </tr>
5931 <tr>
5932 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.1</p></td>
5933 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5934 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA2202 50g</p></td>
5935 <td class="tableblock halign-left valign-top"><p class="tableblock">SkyTraq</p></td>
5936 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5937 <td class="tableblock halign-left valign-top"><p class="tableblock">2MB</p></td>
5938 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5939 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5940 </tr>
5941 <tr>
5942 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v1.2</p></td>
5943 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5944 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL78 70g</p></td>
5945 <td class="tableblock halign-left valign-top"><p class="tableblock">SkyTraq</p></td>
5946 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5947 <td class="tableblock halign-left valign-top"><p class="tableblock">2MB</p></td>
5948 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5949 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5950 </tr>
5951 <tr>
5952 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v2.0</p></td>
5953 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5954 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
5955 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
5956 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5957 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5958 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5959 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5960 </tr>
5961 <tr>
5962 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum v3.0</p></td>
5963 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5964 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
5965 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-8Q</p></td>
5966 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5967 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
5968 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5969 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5970 </tr>
5971 <tr>
5972 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v1.0</p></td>
5973 <td class="tableblock halign-left valign-top"><p class="tableblock">MP3H6115 10km (33k')</p></td>
5974 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5975 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5976 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5977 <td class="tableblock halign-left valign-top"><p class="tableblock">5kB</p></td>
5978 <td class="tableblock halign-left valign-top"><p class="tableblock">10mW</p></td>
5979 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5980 </tr>
5981 <tr>
5982 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v3.0</p></td>
5983 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5984 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5985 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5986 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5987 <td class="tableblock halign-left valign-top"><p class="tableblock">512kB</p></td>
5988 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
5989 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
5990 </tr>
5991 <tr>
5992 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini v1.0-v3.0</p></td>
5993 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
5994 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5995 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5996 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5997 <td class="tableblock halign-left valign-top"><p class="tableblock">1MB</p></td>
5998 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
5999 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7-12V</p></td>
6000 </tr>
6001 <tr>
6002 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v1.0</p></td>
6003 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6004 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
6005 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
6006 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 HMC5883</p></td>
6007 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6008 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
6009 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6010 </tr>
6011 <tr>
6012 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v2.0</p></td>
6013 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6014 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
6015 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
6016 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 HMC5883</p></td>
6017 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6018 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
6019 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6020 </tr>
6021 <tr>
6022 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v3.0</p></td>
6023 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6024 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
6025 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-7Q</p></td>
6026 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU9250</p></td>
6027 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6028 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
6029 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6030 </tr>
6031 <tr>
6032 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v4.0</p></td>
6033 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6034 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
6035 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-8Q</p></td>
6036 <td class="tableblock halign-left valign-top"><p class="tableblock">BMX160</p></td>
6037 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6038 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
6039 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6040 </tr>
6041 <tr>
6042 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega v5.0</p></td>
6043 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6044 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
6045 <td class="tableblock halign-left valign-top"><p class="tableblock">uBlox Max-8Q</p></td>
6046 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 MMC5983</p></td>
6047 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6048 <td class="tableblock halign-left valign-top"><p class="tableblock">40mW</p></td>
6049 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6050 </tr>
6051 <tr>
6052 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega v1.0</p></td>
6053 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6054 <td class="tableblock halign-left valign-top"><p class="tableblock">MMA6555 102g</p></td>
6055 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6056 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU6000 HMC5883</p></td>
6057 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6058 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6059 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6060 </tr>
6061 <tr>
6062 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega v2.0</p></td>
6063 <td class="tableblock halign-left valign-top"><p class="tableblock">MS5607 30km (100k')</p></td>
6064 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
6065 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6066 <td class="tableblock halign-left valign-top"><p class="tableblock">MPU9250</p></td>
6067 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6068 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6069 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7V</p></td>
6070 </tr>
6071 <tr>
6072 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyTimer v1.0</p></td>
6073 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6074 <td class="tableblock halign-left valign-top"><p class="tableblock">16g</p></td>
6075 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6076 <td class="tableblock halign-left valign-top"><p class="tableblock">BMX160</p></td>
6077 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6078 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6079 <td class="tableblock halign-left valign-top"><p class="tableblock">3.7-12V</p></td>
6080 </tr>
6081 <tr>
6082 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMotor v3.0</p></td>
6083 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6084 <td class="tableblock halign-left valign-top"><p class="tableblock">ADXL375 200g</p></td>
6085 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6086 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6087 <td class="tableblock halign-left valign-top"><p class="tableblock">8MB</p></td>
6088 <td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
6089 <td class="tableblock halign-left valign-top"><p class="tableblock">6.5-15V</p></td>
6090 </tr>
6091 </tbody>
6092 </table>
6093 <div style="page-break-after: always;"></div>
6094 <table class="tableblock frame-all grid-all stretch">
6095 <caption class="title">Table 13. Altus Metrum Flight Computer Mechanical Components</caption>
6096 <colgroup>
6097 <col style="width: 16.6666%;">
6098 <col style="width: 16.6666%;">
6099 <col style="width: 16.6666%;">
6100 <col style="width: 16.6666%;">
6101 <col style="width: 16.6666%;">
6102 <col style="width: 16.667%;">
6103 </colgroup>
6104 <thead>
6105 <tr>
6106 <th class="tableblock halign-left valign-top">Device</th>
6107 <th class="tableblock halign-left valign-top">Connectors</th>
6108 <th class="tableblock halign-left valign-top">Screw Terminals</th>
6109 <th class="tableblock halign-left valign-top">Width</th>
6110 <th class="tableblock halign-left valign-top">Length</th>
6111 <th class="tableblock halign-left valign-top">Tube Size</th>
6112 </tr>
6113 </thead>
6114 <tbody>
6115 <tr>
6116 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMetrum</p></td>
6117 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug Companion USB Battery</p></td>
6118 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Switch</p></td>
6119 <td class="tableblock halign-left valign-top"><p class="tableblock">1 inch (2.54cm)</p></td>
6120 <td class="tableblock halign-left valign-top"><p class="tableblock">2 ¾ inch (6.99cm)</p></td>
6121 <td class="tableblock halign-left valign-top"><p class="tableblock">29mm coupler</p></td>
6122 </tr>
6123 <tr>
6124 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v1.0</p></td>
6125 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug Battery</p></td>
6126 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro</p></td>
6127 <td class="tableblock halign-left valign-top"><p class="tableblock">½ inch (1.27cm)</p></td>
6128 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
6129 <td class="tableblock halign-left valign-top"><p class="tableblock">18mm coupler</p></td>
6130 </tr>
6131 <tr>
6132 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMini v2.0</p></td>
6133 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug USB Battery</p></td>
6134 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Battery Switch</p></td>
6135 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
6136 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
6137 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
6138 </tr>
6139 <tr>
6140 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMini</p></td>
6141 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug USB Battery</p></td>
6142 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Battery</p></td>
6143 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
6144 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
6145 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
6146 </tr>
6147 <tr>
6148 <td class="tableblock halign-left valign-top"><p class="tableblock">TeleMega</p></td>
6149 <td class="tableblock halign-left valign-top"><p class="tableblock">Antenna Debug Companion USB Battery</p></td>
6150 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Pyro A-D Switch Pyro battery</p></td>
6151 <td class="tableblock halign-left valign-top"><p class="tableblock">1¼ inch (3.18cm)</p></td>
6152 <td class="tableblock halign-left valign-top"><p class="tableblock">3¼ inch (8.26cm)</p></td>
6153 <td class="tableblock halign-left valign-top"><p class="tableblock">38mm coupler</p></td>
6154 </tr>
6155 <tr>
6156 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMega</p></td>
6157 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug Companion USB Battery</p></td>
6158 <td class="tableblock halign-left valign-top"><p class="tableblock">Apogee pyro Main pyro Pyro A-D Switch Pyro battery</p></td>
6159 <td class="tableblock halign-left valign-top"><p class="tableblock">1¼ inch (3.18cm)</p></td>
6160 <td class="tableblock halign-left valign-top"><p class="tableblock">2¼ inch (5.62cm)</p></td>
6161 <td class="tableblock halign-left valign-top"><p class="tableblock">38mm coupler</p></td>
6162 </tr>
6163 <tr>
6164 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyTimer</p></td>
6165 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug USB Battery</p></td>
6166 <td class="tableblock halign-left valign-top"><p class="tableblock">Pyro A Pyro B Battery</p></td>
6167 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
6168 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
6169 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
6170 </tr>
6171 <tr>
6172 <td class="tableblock halign-left valign-top"><p class="tableblock">EasyMotor</p></td>
6173 <td class="tableblock halign-left valign-top"><p class="tableblock">Debug USB</p></td>
6174 <td class="tableblock halign-left valign-top"><p class="tableblock">+5V Pres GND Switch Battery</p></td>
6175 <td class="tableblock halign-left valign-top"><p class="tableblock">0.8 inch (2.03cm)</p></td>
6176 <td class="tableblock halign-left valign-top"><p class="tableblock">1½ inch (3.81cm)</p></td>
6177 <td class="tableblock halign-left valign-top"><p class="tableblock">24mm coupler</p></td>
6178 </tr>
6179 </tbody>
6180 </table>
6181 </div>
6182 </div>
6183 <div class="sect1">
6184 <h2 id="_release_notes">Appendix H: Release Notes</h2>
6185 <div class="sectionbody">
6186 <div class="sect2">
6187 <h3 id="_release_notes_for_version_1_9_13">H.1. Release Notes for Version 1.9.13</h3>
6188 <div class="paragraph">
6189 <p>Version 1.9.13</p>
6190 </div>
6191 <div class="sect3">
6192 <h4 id="_altos">H.1.1. AltOS</h4>
6193 <div class="ulist">
6194 <ul>
6195 <li>
6196 <p>Add option to beep max height in feet after landing</p>
6197 </li>
6198 <li>
6199 <p>Fix APRS reports to be sent at the correct time and spacing.</p>
6200 </li>
6201 <li>
6202 <p>Fix possible barometric sensor communication failure when
6203 the CPU is busy talking to the radio at the same time. This
6204 would cause loss of telemetry and failure to track the state
6205 of the rocket during flight. This was aggrevated by the APRS
6206 reports getting sent more often than they should.</p>
6207 </li>
6208 <li>
6209 <p>Change EasyMotor v3 code to base logging on motor pressure
6210 rather than the accelerometer. This allows use of EasyMotor
6211 v3 in a static test stand.</p>
6212 </li>
6213 </ul>
6214 </div>
6215 </div>
6216 <div class="sect3">
6217 <h4 id="_altosui_2">H.1.2. AltosUI</h4>
6218 <div class="ulist">
6219 <ul>
6220 <li>
6221 <p>Add support for configuring the units used to report height
6222 after landing on the beeper.</p>
6223 </li>
6224 </ul>
6225 </div>
6226 <div style="page-break-after: always;"></div>
6227 </div>
6228 </div>
6229 <div class="sect2">
6230 <h3 id="_release_notes_for_version_1_9_12">H.2. Release Notes for Version 1.9.12</h3>
6231 <div class="paragraph">
6232 <p>Version 1.9.12</p>
6233 </div>
6234 <div class="sect3">
6235 <h4 id="_altos_2">H.2.1. AltOS</h4>
6236 <div class="ulist">
6237 <ul>
6238 <li>
6239 <p>Add EasyMini v3.0 and EasyMotor v3.0 support</p>
6240 </li>
6241 <li>
6242 <p>Fix TeleMetrum v2.0 configuration. Saving config would
6243 crash the board.</p>
6244 </li>
6245 </ul>
6246 </div>
6247 </div>
6248 <div class="sect3">
6249 <h4 id="_altosui_3">H.2.2. AltosUI</h4>
6250 <div class="ulist">
6251 <ul>
6252 <li>
6253 <p>Add EasyMotor log parsing and graphing.</p>
6254 </li>
6255 </ul>
6256 </div>
6257 <div style="page-break-after: always;"></div>
6258 </div>
6259 </div>
6260 <div class="sect2">
6261 <h3 id="_release_notes_for_version_1_9_11">H.3. Release Notes for Version 1.9.11</h3>
6262 <div class="paragraph">
6263 <p>Version 1.9.11</p>
6264 </div>
6265 <div class="sect3">
6266 <h4 id="_altos_3">H.3.1. AltOS</h4>
6267 <div class="ulist">
6268 <ul>
6269 <li>
6270 <p>Make Apogee Delay work again.</p>
6271 </li>
6272 <li>
6273 <p>Allow TX power to be limited to 10mW for compliance with
6274 some uses under UK regulations.</p>
6275 </li>
6276 <li>
6277 <p>Fix numerous minor issues with 16- vs 32- bit time values.</p>
6278 </li>
6279 </ul>
6280 </div>
6281 </div>
6282 <div class="sect3">
6283 <h4 id="_altosui_4">H.3.2. AltosUI</h4>
6284 <div class="ulist">
6285 <ul>
6286 <li>
6287 <p>Support M1-based Macs, follow AdoptOpenJDK to Adoptium</p>
6288 </li>
6289 </ul>
6290 </div>
6291 </div>
6292 <div class="sect3">
6293 <h4 id="_altosdroid_2">H.3.3. AltosDroid</h4>
6294 <div class="ulist">
6295 <ul>
6296 <li>
6297 <p>Handle Bluetooth permissions reliably.</p>
6298 </li>
6299 <li>
6300 <p>Fix some screen rotation bugs.</p>
6301 </li>
6302 </ul>
6303 </div>
6304 <div style="page-break-after: always;"></div>
6305 </div>
6306 </div>
6307 <div class="sect2">
6308 <h3 id="_release_notes_for_version_1_9_10">H.4. Release Notes for Version 1.9.10</h3>
6309 <div class="paragraph">
6310 <p>Version 1.9.10</p>
6311 </div>
6312 <div class="paragraph">
6313 <p>This release contains a couple of bug fixes for ground station software.</p>
6314 </div>
6315 <div class="sect3">
6316 <h4 id="_altosui_5">H.4.1. AltosUI</h4>
6317 <div class="ulist">
6318 <ul>
6319 <li>
6320 <p>Rework the windows DLL build to make AltosUI run on more
6321 instances of Windows 10.</p>
6322 </li>
6323 </ul>
6324 </div>
6325 </div>
6326 <div class="sect3">
6327 <h4 id="_altosdroid_3">H.4.2. AltosDroid</h4>
6328 <div class="ulist">
6329 <ul>
6330 <li>
6331 <p>Adapt to Android security changes which prevent AltosDroid
6332 from storing flights in
6333 /storage/emulated/0/AltusMetrum. Now, flights are stored in
6334 /storage/emulated/0/media/org.altusmetrum.AltosDroid/AltusMetrum
6335 instead.  Also, AltosDroid will display an error message if
6336 flight data cannot be logged.</p>
6337 </li>
6338 </ul>
6339 </div>
6340 <div style="page-break-after: always;"></div>
6341 </div>
6342 </div>
6343 <div class="sect2">
6344 <h3 id="_release_notes_for_version_1_9_9">H.5. Release Notes for Version 1.9.9</h3>
6345 <div class="paragraph">
6346 <p>Version 1.9.9</p>
6347 </div>
6348 <div class="paragraph">
6349 <p>This release contains a critical bug fix for a problem
6350 introduced in version 1.9.8 for TeleMega and EasyMega
6351 boards. This problem occurs when using the stored
6352 configuration from 1.9.7 or earlier.</p>
6353 </div>
6354 <div class="paragraph">
6355 <p>If you are running 1.9.8 or are upgrading from 1.9.8 on any
6356 version of TeleMega or EasyMega, you must reconfigure all pyro
6357 channels, recalibrate accelerometers, reset the APRS interval,
6358 adjust the beep tone and reset the pyro time.</p>
6359 </div>
6360 <div class="sect3">
6361 <h4 id="_altos_4">H.5.1. AltOS</h4>
6362 <div class="ulist">
6363 <ul>
6364 <li>
6365 <p>Fix EasyMega and TeleMega upgrade process from 1.9.7 or
6366 earlier.  1.9.8 introduced larger delay values, which
6367 required modifying the configuration in-place, and the 1.9.8
6368 version had a flaw which broke the pyro channel config and
6369 all of the config values beyond that in memory, including
6370 APRS interval, IMU accel calibation, beep tone and pyro
6371 time.</p>
6372 </li>
6373 <li>
6374 <p>Fix TeleMega v5.0 mag sensor driver. This driver was quite
6375 broken due to developing it in the presence of the magnetic
6376 beeper on the board. Because of that beeper, the values this
6377 sensor records are not accurate. Fortunately, they are not
6378 used for controlling the flight.</p>
6379 </li>
6380 </ul>
6381 </div>
6382 </div>
6383 <div class="sect3">
6384 <h4 id="_altosui_6">H.5.2. AltosUI</h4>
6385 <div class="ulist">
6386 <ul>
6387 <li>
6388 <p>Parse TeleMega v5.0 log files. A missing check in the code
6389 meant that the TeleMega v5.0 log files would cause an error
6390 when attempting to load them. Logs saved with AltosUI
6391 1.9.8 were not affected, only the presentation of the data
6392 was broken.</p>
6393 </li>
6394 </ul>
6395 </div>
6396 <div style="page-break-after: always;"></div>
6397 </div>
6398 </div>
6399 <div class="sect2">
6400 <h3 id="_release_notes_for_version_1_9_8">H.6. Release Notes for Version 1.9.8</h3>
6401 <div class="paragraph">
6402 <p>Version 1.9.8</p>
6403 </div>
6404 <div class="sect3">
6405 <h4 id="_altos_5">H.6.1. AltOS</h4>
6406 <div class="ulist">
6407 <ul>
6408 <li>
6409 <p>Add support for TeleMega v5.0</p>
6410 </li>
6411 <li>
6412 <p>Extend extra pyro channel times to support delay &gt; 327 seconds</p>
6413 </li>
6414 </ul>
6415 </div>
6416 </div>
6417 <div class="sect3">
6418 <h4 id="_altosui_7">H.6.2. AltosUI</h4>
6419 <div class="ulist">
6420 <ul>
6421 <li>
6422 <p>Support ARM devices in Linux binary release</p>
6423 </li>
6424 <li>
6425 <p>Add support for TeleMega v5.0</p>
6426 </li>
6427 </ul>
6428 </div>
6429 </div>
6430 <div class="sect3">
6431 <h4 id="_altosdroid_4">H.6.3. AltosDroid</h4>
6432 <div class="ulist">
6433 <ul>
6434 <li>
6435 <p>Show tilt angle in pad and flight tabs</p>
6436 </li>
6437 <li>
6438 <p>Show altitude as well as height (useful for TeleGPS)</p>
6439 </li>
6440 <li>
6441 <p>Support devices without GPS receivers</p>
6442 </li>
6443 </ul>
6444 </div>
6445 </div>
6446 <div class="sect3">
6447 <h4 id="_micropeak_gui">H.6.4. MicroPeak GUI</h4>
6448 <div class="ulist">
6449 <ul>
6450 <li>
6451 <p>Show error dialog if device open fails</p>
6452 </li>
6453 </ul>
6454 </div>
6455 <div style="page-break-after: always;"></div>
6456 </div>
6457 </div>
6458 <div class="sect2">
6459 <h3 id="_release_notes_for_version_1_9_7">H.7. Release Notes for Version 1.9.7</h3>
6460 <div class="paragraph">
6461 <p>Version 1.9.7</p>
6462 </div>
6463 <div class="sect3">
6464 <h4 id="_altos_6">H.7.1. AltOS</h4>
6465 <div class="ulist">
6466 <ul>
6467 <li>
6468 <p>Fix TeleGPS logging so that new data are appended to an existing log correctly</p>
6469 </li>
6470 </ul>
6471 </div>
6472 </div>
6473 <div class="sect3">
6474 <h4 id="_altosui_8">H.7.2. AltosUI</h4>
6475 <div class="ulist">
6476 <ul>
6477 <li>
6478 <p>Support Mac OS X 11 (Big Sur)</p>
6479 </li>
6480 <li>
6481 <p>Support Monitor Idle on Easy Timer</p>
6482 </li>
6483 <li>
6484 <p>Fix TeleMega v4.0 and TeleMetrum v3.0 configuration in Antenna Down mode</p>
6485 </li>
6486 <li>
6487 <p>Show launch sites in Load Maps view</p>
6488 </li>
6489 <li>
6490 <p>Add IMU header names to CSV files</p>
6491 </li>
6492 <li>
6493 <p>Clean up TeleGPS log corruption due to firmware bugs during firmware update</p>
6494 </li>
6495 </ul>
6496 </div>
6497 </div>
6498 <div class="sect3">
6499 <h4 id="_altosdroid_5">H.7.3. AltosDroid</h4>
6500 <div class="ulist">
6501 <ul>
6502 <li>
6503 <p>Support older devices back to Android version 5.1</p>
6504 </li>
6505 <li>
6506 <p>Fix a number of issues that could result in app crashes</p>
6507 </li>
6508 </ul>
6509 </div>
6510 <div style="page-break-after: always;"></div>
6511 </div>
6512 </div>
6513 <div class="sect2">
6514 <h3 id="_release_notes_for_version_1_9_6">H.8. Release Notes for Version 1.9.6</h3>
6515 <div class="paragraph">
6516 <p>Version 1.9.6</p>
6517 </div>
6518 <div class="sect3">
6519 <h4 id="_altos_7">H.8.1. AltOS</h4>
6520 <div class="ulist">
6521 <ul>
6522 <li>
6523 <p>Fix EasyTimer bug where it might mis-detect boost (either
6524 detect it early or not at all) due to small errors in
6525 accelerometer calibration leading to large accumulated error
6526 in speed.</p>
6527 </li>
6528 <li>
6529 <p>Adjust self-test of new 9-axis IMU (BMX-160) so that it
6530 doesn&#8217;t think the part has a failure when tested sitting
6531 horizontally.</p>
6532 </li>
6533 </ul>
6534 </div>
6535 <div style="page-break-after: always;"></div>
6536 </div>
6537 </div>
6538 <div class="sect2">
6539 <h3 id="_release_notes_for_version_1_9_5">H.9. Release Notes for Version 1.9.5</h3>
6540 <div class="paragraph">
6541 <p>Version 1.9.5</p>
6542 </div>
6543 <div class="sect3">
6544 <h4 id="_altos_8">H.9.1. AltOS</h4>
6545 <div class="ulist">
6546 <ul>
6547 <li>
6548 <p>Add Booster mode for all dual-deploy altimeters. Select
6549 "Separation &amp; Apogee" mode in AltosUI to fire the 'main'
6550 channel at first motor burnout and the 'apogee' channel at
6551 apogee.</p>
6552 </li>
6553 <li>
6554 <p>Improve reliability of stm32l firmware under heavy
6555 load. This was found using Monitor Idle on TeleMega with all
6556 flash slots full of data which would occasionally lock up.</p>
6557 </li>
6558 <li>
6559 <p>Fix orientation label in AltosUI for devices with
6560 radios. This makes the orientation say 'Antenna up' and
6561 'Antenna Down' for TeleMetrum and TeleMega again.</p>
6562 </li>
6563 <li>
6564 <p>Fix log data for pyro channels which were inhibited (often
6565 because of a tilt limit). They used to report 'fired' as
6566 soon as they were inhibited, which was misleading. Now they
6567 never report as having been fired.</p>
6568 </li>
6569 <li>
6570 <p>Allow Igniter Test to fire each igniter more than once.</p>
6571 </li>
6572 </ul>
6573 </div>
6574 </div>
6575 <div class="sect3">
6576 <h4 id="_altosui_9">H.9.2. AltosUI</h4>
6577 <div class="ulist">
6578 <ul>
6579 <li>
6580 <p>Improve performance of Monitor Idle mode by sending less data for each
6581 update.</p>
6582 </li>
6583 <li>
6584 <p>Improve Mac OS X install scripts so that they work on
6585 Catalina. This involves sending the user to get Java from
6586 the AdoptOpenJDK project which provides a version that works
6587 with Java applications.</p>
6588 </li>
6589 <li>
6590 <p>Make larger dialogs scrollable for use on smaller screens.</p>
6591 </li>
6592 <li>
6593 <p>Fix troubles re-flashing EasyMega boards running older
6594 firmware.</p>
6595 </li>
6596 <li>
6597 <p>Add TeleMetrum v3.0 firmware to the Windows
6598 AltosUI packages.</p>
6599 </li>
6600 </ul>
6601 </div>
6602 <div style="page-break-after: always;"></div>
6603 </div>
6604 </div>
6605 <div class="sect2">
6606 <h3 id="_release_notes_for_version_1_9_4">H.10. Release Notes for Version 1.9.4</h3>
6607 <div class="paragraph">
6608 <p>Version 1.9.4</p>
6609 </div>
6610 <div class="sect3">
6611 <h4 id="_altos_9">H.10.1. AltOS</h4>
6612 <div class="ulist">
6613 <ul>
6614 <li>
6615 <p>Fixed firmware for TeleDongle v3.0 and TeleBT v4.0. Version 1.9.3 bricked those
6616 devices requiring them to be opened up to get them working again.</p>
6617 </li>
6618 <li>
6619 <p>Fixed firmware for EasyMini v1.0. Changes in the storage
6620 code caused it to use significantly more RAM which made the
6621 interrupt stack smash into other data structures and cause
6622 the device to panic at startup time.</p>
6623 </li>
6624 </ul>
6625 </div>
6626 </div>
6627 <div class="sect3">
6628 <h4 id="_altosui_10">H.10.2. AltosUI</h4>
6629 <div class="ulist">
6630 <ul>
6631 <li>
6632 <p>Add TeleMetrum v3.0 firmware to the Linux and Mac OSX
6633 AltosUI packages.</p>
6634 </li>
6635 </ul>
6636 </div>
6637 <div style="page-break-after: always;"></div>
6638 </div>
6639 </div>
6640 <div class="sect2">
6641 <h3 id="_release_notes_for_version_1_9_3">H.11. Release Notes for Version 1.9.3</h3>
6642 <div class="paragraph">
6643 <p>Version 1.9.3</p>
6644 </div>
6645 <div class="sect3">
6646 <h4 id="_altos_10">H.11.1. AltOS</h4>
6647 <div class="ulist">
6648 <ul>
6649 <li>
6650 <p>Add APRS offset. Allows multiple APRS transmitters to coordinate when
6651 transmission occurs to allow them to share a frequency.</p>
6652 </li>
6653 <li>
6654 <p>Fix max log size. Flight computer storage is erased in 64kB chunks. Adjust max
6655 log size to be a multiple of this size.</p>
6656 </li>
6657 <li>
6658 <p>Check flight erasing more carefully. Handle interrupting erasing in the
6659 middle.</p>
6660 </li>
6661 <li>
6662 <p>Add EasyTimer support.</p>
6663 </li>
6664 </ul>
6665 </div>
6666 </div>
6667 <div class="sect3">
6668 <h4 id="_altosui_telegps_micropeak">H.11.2. AltosUI, TeleGPS, MicroPeak</h4>
6669 <div class="ulist">
6670 <ul>
6671 <li>
6672 <p>Add configuration support for APRS offset.</p>
6673 </li>
6674 <li>
6675 <p>Adjust flight log sizes to be a multiple of the flight
6676 computer erase block size.</p>
6677 </li>
6678 <li>
6679 <p>Report barometric pad altitude in Pad tab for TeleMini.</p>
6680 </li>
6681 </ul>
6682 </div>
6683 <div style="page-break-after: always;"></div>
6684 </div>
6685 </div>
6686 <div class="sect2">
6687 <h3 id="_release_notes_for_version_1_9_2">H.12. Release Notes for Version 1.9.2</h3>
6688 <div class="paragraph">
6689 <p>Version 1.9.2</p>
6690 </div>
6691 <div class="sect3">
6692 <h4 id="_altos_11">H.12.1. AltOS</h4>
6693 <div class="ulist">
6694 <ul>
6695 <li>
6696 <p>Add support for TeleMega v4.0</p>
6697 </li>
6698 <li>
6699 <p>Fix time wrapping issue with TeleLCO and TeleFire</p>
6700 </li>
6701 </ul>
6702 </div>
6703 </div>
6704 <div class="sect3">
6705 <h4 id="_altosui_telegps_micropeak_2">H.12.2. AltosUI, TeleGPS, MicroPeak</h4>
6706 <div class="ulist">
6707 <ul>
6708 <li>
6709 <p>Add column in AltosUI for IMU data from TeleMega and EasyMega</p>
6710 </li>
6711 </ul>
6712 </div>
6713 </div>
6714 <div class="sect3">
6715 <h4 id="_altosdroid_6">H.12.3. AltosDroid</h4>
6716 <div class="ulist">
6717 <ul>
6718 <li>
6719 <p>Allow sorting of trackers by call, serial, frequency or age</p>
6720 </li>
6721 <li>
6722 <p>Offer selection of font sizes</p>
6723 </li>
6724 <li>
6725 <p>Various bug fixes for older Android versions</p>
6726 </li>
6727 </ul>
6728 </div>
6729 <div style="page-break-after: always;"></div>
6730 </div>
6731 </div>
6732 <div class="sect2">
6733 <h3 id="_release_notes_for_version_1_9_1">H.13. Release Notes for Version 1.9.1</h3>
6734 <div class="paragraph">
6735 <p>Version 1.9.1</p>
6736 </div>
6737 <div class="sect3">
6738 <h4 id="_altos_12">H.13.1. AltOS</h4>
6739 <div class="ulist">
6740 <ul>
6741 <li>
6742 <p>Add support for TeleMetrum v3.0</p>
6743 </li>
6744 <li>
6745 <p>Fix accel cal value when changing EasyMega v2.0 pad orientation</p>
6746 </li>
6747 <li>
6748 <p>Correct EasyMega v2.0 magnetometer data axes</p>
6749 </li>
6750 <li>
6751 <p>Fix EasyMega v2.0 idle monitor display of IMU data</p>
6752 </li>
6753 <li>
6754 <p>Report all sensor failures at power-up time.</p>
6755 </li>
6756 </ul>
6757 </div>
6758 </div>
6759 <div class="sect3">
6760 <h4 id="_altosui_telegps_micropeak_3">H.13.2. AltosUI, TeleGPS, MicroPeak</h4>
6761 <div class="ulist">
6762 <ul>
6763 <li>
6764 <p>Display error message when attempting to graph unknown format file.</p>
6765 </li>
6766 <li>
6767 <p>Make it possible to disable APRS once enabled.</p>
6768 </li>
6769 <li>
6770 <p>Display some data for point near cursor in map tab.</p>
6771 </li>
6772 <li>
6773 <p>Support upgrading devices from pre-1.8 firmware</p>
6774 </li>
6775 <li>
6776 <p>Wait for Windows to prepare new devices during firmware
6777 upgrade. This should avoid the “COMxx: open failed” message.</p>
6778 </li>
6779 </ul>
6780 </div>
6781 <div style="page-break-after: always;"></div>
6782 </div>
6783 </div>
6784 <div class="sect2">
6785 <h3 id="_release_notes_for_version_1_9">H.14. Release Notes for Version 1.9</h3>
6786 <div class="paragraph">
6787 <p>Version 1.9</p>
6788 </div>
6789 <div class="sect3">
6790 <h4 id="_altos_13">H.14.1. AltOS</h4>
6791 <div class="ulist">
6792 <ul>
6793 <li>
6794 <p>Add support for EasyMega v2.0</p>
6795 </li>
6796 <li>
6797 <p>Replace C library for ARM devices</p>
6798 </li>
6799 <li>
6800 <p>Remove support for 8051-based devices and SDCC compiler</p>
6801 </li>
6802 </ul>
6803 </div>
6804 </div>
6805 <div class="sect3">
6806 <h4 id="_altosui_telegps_micropeak_4">H.14.2. AltosUI, TeleGPS, MicroPeak</h4>
6807 <div class="ulist">
6808 <ul>
6809 <li>
6810 <p>Select ROM images based on product name when reflashing</p>
6811 </li>
6812 <li>
6813 <p>Fix TeleGPS v2 battery voltage display</p>
6814 </li>
6815 </ul>
6816 </div>
6817 <div style="page-break-after: always;"></div>
6818 </div>
6819 </div>
6820 <div class="sect2">
6821 <h3 id="_release_notes_for_version_1_8_7">H.15. Release Notes for Version 1.8.7</h3>
6822 <div class="paragraph">
6823 <p>Version 1.8.7</p>
6824 </div>
6825 <div class="sect3">
6826 <h4 id="_altos_14">H.15.1. AltOS</h4>
6827 <div class="ulist">
6828 <ul>
6829 <li>
6830 <p>Include TeleMega v3.0 firmware</p>
6831 </li>
6832 </ul>
6833 </div>
6834 </div>
6835 <div class="sect3">
6836 <h4 id="_altosui_telegps_micropeak_5">H.15.2. AltosUI, TeleGPS, MicroPeak</h4>
6837 <div class="ulist">
6838 <ul>
6839 <li>
6840 <p>Poll for new devices while Device dialog is displayed</p>
6841 </li>
6842 <li>
6843 <p>Wait for device to re-appear when flashing new firmware</p>
6844 </li>
6845 <li>
6846 <p>Fetch correct TeleBT v4.0 RF calibration values from web
6847 site when reflashing.</p>
6848 </li>
6849 <li>
6850 <p>Change gyro headings in .csv files from x/y/z to
6851 roll/pitch/yaw</p>
6852 </li>
6853 <li>
6854 <p>Add documentation about Packet Link mode</p>
6855 </li>
6856 <li>
6857 <p>Add documentation about forcing TeleMini RF parameters to
6858 known values.</p>
6859 </li>
6860 <li>
6861 <p>Create a proxy server for Google Maps to re-enable map
6862 images</p>
6863 </li>
6864 <li>
6865 <p>Fix Java version info in all distributed jar files so that
6866 applications will run with standard Mac OS X Java.</p>
6867 </li>
6868 <li>
6869 <p>Replace JavaApplicationStub for Mac OS X so that
6870 applications will run with Oracle Java.</p>
6871 </li>
6872 </ul>
6873 </div>
6874 <div style="page-break-after: always;"></div>
6875 </div>
6876 </div>
6877 <div class="sect2">
6878 <h3 id="_release_notes_for_version_1_8_6">H.16. Release Notes for Version 1.8.6</h3>
6879 <div class="paragraph">
6880 <p>Version 1.8.6</p>
6881 </div>
6882 <div class="sect3">
6883 <h4 id="_altos_15">H.16.1. AltOS</h4>
6884 <div class="ulist">
6885 <ul>
6886 <li>
6887 <p>Use maximum of 64 previous tilt values in pyro tilt tests</p>
6888 </li>
6889 <li>
6890 <p>Eliminate 100m height requirement for coast detection</p>
6891 </li>
6892 <li>
6893 <p>Change After Motor pyro check to be &gt;= instead of ==</p>
6894 </li>
6895 <li>
6896 <p>Change Time since Boost to be Time since launch.</p>
6897 </li>
6898 </ul>
6899 </div>
6900 </div>
6901 <div class="sect3">
6902 <h4 id="_altosui_telegps">H.16.2. AltosUI, TeleGPS</h4>
6903 <div class="ulist">
6904 <ul>
6905 <li>
6906 <p>Clarify pyro test phrasing</p>
6907 </li>
6908 <li>
6909 <p>Remove ascending/descending from pyro config UI</p>
6910 </li>
6911 <li>
6912 <p>Fix accel calibration in Antenna Down mode</p>
6913 </li>
6914 <li>
6915 <p>Add mag sensor reporting for TeleMega v3 idle monitoring.</p>
6916 </li>
6917 <li>
6918 <p>Fix radio parameter saving at 2400 bps telmetry rate.</p>
6919 </li>
6920 </ul>
6921 </div>
6922 </div>
6923 <div class="sect3">
6924 <h4 id="_micropeak">H.16.3. MicroPeak</h4>
6925 <div class="ulist">
6926 <ul>
6927 <li>
6928 <p>Report altimeter-recorded maximum height value</p>
6929 </li>
6930 </ul>
6931 </div>
6932 <div style="page-break-after: always;"></div>
6933 </div>
6934 </div>
6935 <div class="sect2">
6936 <h3 id="_release_notes_for_version_1_8_5">H.17. Release Notes for Version 1.8.5</h3>
6937 <div class="paragraph">
6938 <p>Version 1.8.5 includes fixes to the ground software support
6939 for TeleBT v4, along with a few other minor updates.</p>
6940 </div>
6941 <div class="sect3">
6942 <h4 id="_altos_16">H.17.1. AltOS</h4>
6943 <div class="ulist">
6944 <ul>
6945 <li>
6946 <p>Fix startup beeps that indicate sensor failures.</p>
6947 </li>
6948 </ul>
6949 </div>
6950 </div>
6951 <div class="sect3">
6952 <h4 id="_altosui_telegps_2">H.17.2. AltosUI, TeleGPS</h4>
6953 <div class="ulist">
6954 <ul>
6955 <li>
6956 <p>When updating device firmware, make sure selected firmware
6957 matches target device.</p>
6958 </li>
6959 <li>
6960 <p>Correct Bluetooth device matching when looking for TeleBT
6961 devices.</p>
6962 </li>
6963 </ul>
6964 </div>
6965 <div style="page-break-after: always;"></div>
6966 </div>
6967 </div>
6968 <div class="sect2">
6969 <h3 id="_release_notes_for_version_1_8_4">H.18. Release Notes for Version 1.8.4</h3>
6970 <div class="paragraph">
6971 <p>Version 1.8.4 includes support for EasyMini version 2.0</p>
6972 </div>
6973 <div class="sect3">
6974 <h4 id="_altos_17">H.18.1. AltOS</h4>
6975 <div class="ulist">
6976 <ul>
6977 <li>
6978 <p>Support for EasyMini version 2.0 hardware.</p>
6979 </li>
6980 </ul>
6981 </div>
6982 <div style="page-break-after: always;"></div>
6983 </div>
6984 </div>
6985 <div class="sect2">
6986 <h3 id="_release_notes_for_version_1_8_3">H.19. Release Notes for Version 1.8.3</h3>
6987 <div class="paragraph">
6988 <p>Version 1.8.3 includes support for TeleMega version 3.0 along
6989 with two important flight computer fixes. This version also
6990 changes KML export data to make Tripoli Record reporting
6991 better and some updates to graph presentation and data
6992 downloading.</p>
6993 </div>
6994 <div class="sect3">
6995 <h4 id="_altos_18">H.19.1. AltOS</h4>
6996 <div class="sect4">
6997 <h5 id="_altos_new_features">AltOS New Features</h5>
6998 <div class="ulist">
6999 <ul>
7000 <li>
7001 <p>Support for TeleMega version 3.0 hardware.</p>
7002 </li>
7003 </ul>
7004 </div>
7005 </div>
7006 <div class="sect4">
7007 <h5 id="_altos_bug_fixes">AltOS Bug Fixes</h5>
7008 <div class="ulist">
7009 <ul>
7010 <li>
7011 <p>Ground testing EasyMega and TeleMega additional pyro
7012 channels could result in a sticky 'fired' status which would
7013 prevent these channels from firing on future flights.</p>
7014 </li>
7015 <li>
7016 <p>Corrupted flight log records could prevent future flights
7017 from capturing log data.</p>
7018 </li>
7019 <li>
7020 <p>Fixed saving of pyro configuration that ended with
7021 'Descending'.</p>
7022 </li>
7023 </ul>
7024 </div>
7025 </div>
7026 </div>
7027 <div class="sect3">
7028 <h4 id="_altosui_and_telegps_applications">H.19.2. AltosUI and TeleGPS Applications</h4>
7029 <div class="sect4">
7030 <h5 id="_altosui_new_features">AltosUI New Features</h5>
7031 <div class="ulist">
7032 <ul>
7033 <li>
7034 <p>Support for TeleMega version 3.0.</p>
7035 </li>
7036 <li>
7037 <p>Graph lines have improved appearance to make them easier to
7038 distinguish. Markers may be placed at data points to show
7039 captured recorded data values.</p>
7040 </li>
7041 <li>
7042 <p>Graphing offers the ability to adjust the smoothing of
7043 computed speed and acceleration data.</p>
7044 </li>
7045 <li>
7046 <p>The download dialog now offers to graph new flights, checks
7047 for existing files to avoid overwriting data and reports if
7048 there are checksum errors in the downloaded data.</p>
7049 </li>
7050 </ul>
7051 </div>
7052 </div>
7053 <div class="sect4">
7054 <h5 id="_altosuitelegps_bug_fixes">AltosUI/TeleGPS Bug Fixes</h5>
7055 <div class="ulist">
7056 <ul>
7057 <li>
7058 <p>Restore TeleGPS tracking behavior.</p>
7059 </li>
7060 <li>
7061 <p>Display flight computer call sign and serial number in
7062 Monitor Idle mode instead of ground station values.</p>
7063 </li>
7064 </ul>
7065 </div>
7066 </div>
7067 <div class="sect4">
7068 <h5 id="_altosui_and_telegps_changes">AltosUI and TeleGPS Changes</h5>
7069 <div class="ulist">
7070 <ul>
7071 <li>
7072 <p>KML export now reports both barometric and GPS altitude data
7073 to make it more useful for Tripoli record reporting.</p>
7074 </li>
7075 <li>
7076 <p>CSV export now includes TeleMega/EasyMega pyro voltages and
7077 tilt angle.</p>
7078 </li>
7079 </ul>
7080 </div>
7081 <div style="page-break-after: always;"></div>
7082 </div>
7083 </div>
7084 </div>
7085 <div class="sect2">
7086 <h3 id="_release_notes_for_version_1_8_2">H.20. Release Notes for Version 1.8.2</h3>
7087 <div class="paragraph">
7088 <p>Version 1.8.2 includes support for TeleGPS version 2.0 along
7089 with accelerometer recalibration support in AltosUI.</p>
7090 </div>
7091 <div class="paragraph">
7092 <p>1.8.2 also contains a couple of minor fixes for AltosUI when
7093 analyzing saved data files.</p>
7094 </div>
7095 <div class="sect3">
7096 <h4 id="_altos_19">H.20.1. AltOS</h4>
7097 <div class="paragraph">
7098 <p>AltOS New Features</p>
7099 </div>
7100 <div class="ulist">
7101 <ul>
7102 <li>
7103 <p>Support for TeleGPS version 2.0 hardware.</p>
7104 </li>
7105 </ul>
7106 </div>
7107 </div>
7108 <div class="sect3">
7109 <h4 id="_altosui_and_telegps_applications_2">H.20.2. AltosUI and TeleGPS Applications</h4>
7110 <div class="paragraph">
7111 <p>AltosUI and TeleGPS New Features</p>
7112 </div>
7113 <div class="ulist">
7114 <ul>
7115 <li>
7116 <p>Support for TeleGPS version 2.0.</p>
7117 </li>
7118 <li>
7119 <p>Accelerometer re-calibration user interface.</p>
7120 </li>
7121 </ul>
7122 </div>
7123 <div class="paragraph">
7124 <p>AltosUI and TeleGPS Bug Fixes</p>
7125 </div>
7126 <div class="ulist">
7127 <ul>
7128 <li>
7129 <p>Prevent some crashes when reading older saved flight data
7130 for graphing or KML export.</p>
7131 </li>
7132 </ul>
7133 </div>
7134 <div style="page-break-after: always;"></div>
7135 </div>
7136 </div>
7137 <div class="sect2">
7138 <h3 id="_release_notes_for_version_1_8_1">H.21. Release Notes for Version 1.8.1</h3>
7139 <div class="paragraph">
7140 <p>Version 1.8.1 includes an important bug fix for Apogee Lockout
7141 operation in all flight computers. Anyone using this option
7142 must update firmware.</p>
7143 </div>
7144 <div class="paragraph">
7145 <p>This release also contains a change in how flight computers
7146 with accelerometers deal with speeds around and above Mach
7147 1. In previous versions, the flight computer would completely
7148 disregard the barometric sensor above 330m/s (around Mach
7149 1). Now, the data from the barometric sensor is reduced in
7150 effect without ever going away entirely. This prevents early
7151 drogue deployment for flights which spend considerable time
7152 above Mach 1.</p>
7153 </div>
7154 <div class="paragraph">
7155 <p>1.8.1 also contains a couple of minor fixes for AltosUI when
7156 analyzing saved data files.</p>
7157 </div>
7158 <div class="sect3">
7159 <h4 id="_altos_20">H.21.1. AltOS</h4>
7160 <div class="paragraph">
7161 <p>AltOS Bug Fixes</p>
7162 </div>
7163 <div class="ulist">
7164 <ul>
7165 <li>
7166 <p>Handle time value wrapping in Apogee Lockout
7167 correctly. Without this, apogee lockout would sometimes
7168 prevent any drogue charge from firing.</p>
7169 </li>
7170 <li>
7171 <p>Change Kalman filter on flight computers with accelerometer
7172 to continue using the barometric sensor even at high speeds
7173 to avoid unintentional drogue deployment during
7174 deceleration.</p>
7175 </li>
7176 </ul>
7177 </div>
7178 </div>
7179 <div class="sect3">
7180 <h4 id="_altosui_and_telegps_applications_3">H.21.2. AltosUI and TeleGPS Applications</h4>
7181 <div class="paragraph">
7182 <p>AltosUI New Features</p>
7183 </div>
7184 <div class="ulist">
7185 <ul>
7186 <li>
7187 <p>Add new 'Huge' font size to make text even bigger on high
7188 resolution monitors.</p>
7189 </li>
7190 </ul>
7191 </div>
7192 <div class="paragraph">
7193 <p>AltosUI Bug Fixes</p>
7194 </div>
7195 <div class="ulist">
7196 <ul>
7197 <li>
7198 <p>Prevent some crashes when reading older saved flight data
7199 for graphing or KML export.</p>
7200 </li>
7201 <li>
7202 <p>Load frequency preference at startup. The loading code was
7203 broken, so you&#8217;d see only the default frequencies.</p>
7204 </li>
7205 </ul>
7206 </div>
7207 <div style="page-break-after: always;"></div>
7208 </div>
7209 </div>
7210 <div class="sect2">
7211 <h3 id="_release_notes_for_version_1_8">H.22. Release Notes for Version 1.8</h3>
7212 <div class="paragraph">
7213 <p>Version 1.8 includes support for our new TeleBT v4.0 ground
7214 station, updates for data analysis in our ground station
7215 software and bug fixes in in the flight software for all our
7216 boards and ground station interfaces.</p>
7217 </div>
7218 <div class="sect3">
7219 <h4 id="_altos_21">H.22.1. AltOS</h4>
7220 <div class="paragraph">
7221 <p>AltOS New Features</p>
7222 </div>
7223 <div class="ulist">
7224 <ul>
7225 <li>
7226 <p>Add support for TeleBT v4.0 boards.</p>
7227 </li>
7228 </ul>
7229 </div>
7230 </div>
7231 <div class="sect3">
7232 <h4 id="_altosui_and_telegps_applications_4">H.22.2. AltosUI and TeleGPS Applications</h4>
7233 <div class="paragraph">
7234 <p>AltosUI New Features</p>
7235 </div>
7236 <div class="ulist">
7237 <ul>
7238 <li>
7239 <p>Add support for TeleBT v4.0 hardware</p>
7240 </li>
7241 <li>
7242 <p>Rewrite graphing and export functions. This code now handles
7243 each data series separately so that graphs are drawn
7244 correctly. Smoothing now uses a filter that looks both
7245 forward and backwards in time to make computed speed and
7246 acceleration data more accurate.</p>
7247 </li>
7248 </ul>
7249 </div>
7250 <div class="paragraph">
7251 <p>AltosUI Bug Fixes</p>
7252 </div>
7253 <div class="ulist">
7254 <ul>
7255 <li>
7256 <p>Correct axis labeling of magnetic sensor in TeleMega and
7257 EasyMega. The Y and Z axes were flipped.</p>
7258 </li>
7259 </ul>
7260 </div>
7261 <div style="page-break-after: always;"></div>
7262 </div>
7263 </div>
7264 <div class="sect2">
7265 <h3 id="_release_notes_for_version_1_7">H.23. Release Notes for Version 1.7</h3>
7266 <div class="paragraph">
7267 <p>Version 1.7 includes support for our new TeleMini v3.0
7268 flight computer and bug fixes in in the flight software for all our boards
7269 and ground station interfaces.</p>
7270 </div>
7271 <div class="sect3">
7272 <h4 id="_altos_22">H.23.1. AltOS</h4>
7273 <div class="paragraph">
7274 <p>AltOS New Features</p>
7275 </div>
7276 <div class="ulist">
7277 <ul>
7278 <li>
7279 <p>Add support for TeleMini v3.0 boards.</p>
7280 </li>
7281 </ul>
7282 </div>
7283 <div class="paragraph">
7284 <p>AltOS Fixes</p>
7285 </div>
7286 <div class="ulist">
7287 <ul>
7288 <li>
7289 <p>Fix interrupt priorities on STM32L processors. Run timer
7290 interrupt at lowest priority so that device interrupts get
7291 serviced first.</p>
7292 </li>
7293 </ul>
7294 </div>
7295 </div>
7296 <div class="sect3">
7297 <h4 id="_altosui_and_telegps_applications_5">H.23.2. AltosUI and TeleGPS Applications</h4>
7298 <div class="paragraph">
7299 <p>AltosUI New Features</p>
7300 </div>
7301 <div class="ulist">
7302 <ul>
7303 <li>
7304 <p>Add support for TeleMini v3.0 hardware</p>
7305 </li>
7306 </ul>
7307 </div>
7308 <div style="page-break-after: always;"></div>
7309 </div>
7310 </div>
7311 <div class="sect2">
7312 <h3 id="_release_notes_for_version_1_6_8">H.24. Release Notes for Version 1.6.8</h3>
7313 <div class="paragraph">
7314 <p>Version 1.6.8 fixes a TeleMega and TeleMetrum v2.0 bug where
7315 the device could stop logging data and transmitting
7316 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
7317 v2.0 users should update their flight firmware.</p>
7318 </div>
7319 <div class="sect3">
7320 <h4 id="_altos_23">H.24.1. AltOS</h4>
7321 <div class="paragraph">
7322 <p>AltOS fixes:</p>
7323 </div>
7324 <div class="ulist">
7325 <ul>
7326 <li>
7327 <p>Fix STM32L DMA driver to work around STM32L SoC DMA priority
7328 issue t lock-up in the logging or radio code, either of
7329 which could stop data logging and telemetry.</p>
7330 </li>
7331 <li>
7332 <p>Avoid having TeleBT battery status values smash telemetry
7333 packet data by holding a lock during both operations.</p>
7334 </li>
7335 <li>
7336 <p>Don&#8217;t start reporting 'flight 0' when the log fills in
7337 flight.</p>
7338 </li>
7339 </ul>
7340 </div>
7341 <div class="paragraph">
7342 <p>AltOS changes:</p>
7343 </div>
7344 <div class="ulist">
7345 <ul>
7346 <li>
7347 <p>Flash LEDS on all products briefly during power up so that
7348 they can be tested during production.</p>
7349 </li>
7350 </ul>
7351 </div>
7352 </div>
7353 <div class="sect3">
7354 <h4 id="_altosui_telegps_and_altosdroid_applications">H.24.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
7355 <div class="paragraph">
7356 <p>AltosUI fixes:</p>
7357 </div>
7358 <div class="ulist">
7359 <ul>
7360 <li>
7361 <p>Re-enable go/no-go entries after they&#8217;ve been disabled due
7362 to lack of data. If telemetry information is delayed when
7363 the Ui starts up, sometimes important fields would get
7364 disabled to never re-appear.</p>
7365 </li>
7366 <li>
7367 <p>Deal with ground station failure better during Configure
7368 Ground Station operation by cleaning up pending operations.</p>
7369 </li>
7370 </ul>
7371 </div>
7372 <div style="page-break-after: always;"></div>
7373 </div>
7374 </div>
7375 <div class="sect2">
7376 <h3 id="_release_notes_for_version_1_6_5">H.25. Release Notes for Version 1.6.5</h3>
7377 <div class="paragraph">
7378 <p>Version 1.6.5 fixes a TeleMega and TeleMetrum v2.0 bug where
7379 the device would often stop logging data and transmitting
7380 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
7381 v2.0 users should update their flight firmware.</p>
7382 </div>
7383 <div class="sect3">
7384 <h4 id="_altos_24">H.25.1. AltOS</h4>
7385 <div class="paragraph">
7386 <p>AltOS fixes:</p>
7387 </div>
7388 <div class="ulist">
7389 <ul>
7390 <li>
7391 <p>Fix STM32L SPI driver to prevent lock-up in the logging or
7392 radio code, either of which could stop data logging and
7393 telemetry. Found and characterized by Chuck Haskin, who also
7394 tested the new firmware before release.</p>
7395 </li>
7396 </ul>
7397 </div>
7398 </div>
7399 <div class="sect3">
7400 <h4 id="_altosui_telegps_and_altosdroid_applications_2">H.25.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
7401 <div class="paragraph">
7402 <p>AltosUI fixes:</p>
7403 </div>
7404 <div class="ulist">
7405 <ul>
7406 <li>
7407 <p>Deliver firmward for TeleMega v2.0 and TeleBT v3.0 with
7408 Windows package.</p>
7409 </li>
7410 </ul>
7411 </div>
7412 <div style="page-break-after: always;"></div>
7413 </div>
7414 </div>
7415 <div class="sect2">
7416 <h3 id="_release_notes_for_version_1_6_4">H.26. Release Notes for Version 1.6.4</h3>
7417 <div class="paragraph">
7418 <p>Version 1.6.4 fixes a bluetooth communication problem with
7419 TeleBT v1.0 devices, along with some altosui and altosdroid
7420 minor nits. It also now ships firmware for some newer devices.</p>
7421 </div>
7422 <div class="sect3">
7423 <h4 id="_altos_25">H.26.1. AltOS</h4>
7424 <div class="paragraph">
7425 <p>AltOS fixes:</p>
7426 </div>
7427 <div class="ulist">
7428 <ul>
7429 <li>
7430 <p>Fix hardware flow control on TeleBT v1.0. Hardware RTS/CTS
7431 doesn&#8217;t seem to work, switch from using the hardware to
7432 driving these pins with software.</p>
7433 </li>
7434 <li>
7435 <p>Fix ARM USB drivers to deal with OS restarts. Needed to
7436 reset all USB-related state when the USB bus is reset. These
7437 fixes affect all STM32L, STM32F0 and LPC11U14 based devices.</p>
7438 </li>
7439 </ul>
7440 </div>
7441 </div>
7442 <div class="sect3">
7443 <h4 id="_altosui_telegps_and_altosdroid_applications_3">H.26.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
7444 <div class="paragraph">
7445 <p>AltosUI, TeleGPS and AltosDroid New Features:</p>
7446 </div>
7447 <div class="ulist">
7448 <ul>
7449 <li>
7450 <p>Automatically switch from meters or feet to kilometers or
7451 miles for distance units.</p>
7452 </li>
7453 <li>
7454 <p>Add Monitor Idle mode to TeleGPS application.</p>
7455 </li>
7456 </ul>
7457 </div>
7458 <div class="paragraph">
7459 <p>AltosUI, TeleGPS and AltosDroid Fixes:</p>
7460 </div>
7461 <div class="ulist">
7462 <ul>
7463 <li>
7464 <p>Abort map preloading when the preload map dialog is closed.</p>
7465 </li>
7466 <li>
7467 <p>In AltosDroid, Don&#8217;t reconnect to last device if the user
7468 had disconnected it the last time the application was
7469 active.</p>
7470 </li>
7471 </ul>
7472 </div>
7473 </div>
7474 <div class="sect3">
7475 <h4 id="_documentation">H.26.3. Documentation</h4>
7476 <div class="ulist">
7477 <ul>
7478 <li>
7479 <p>Mention TeleMega v2.0 in hardware specs table.</p>
7480 </li>
7481 <li>
7482 <p>Document TeleGPS RF output in telegps manual.</p>
7483 </li>
7484 </ul>
7485 </div>
7486 <div style="page-break-after: always;"></div>
7487 </div>
7488 </div>
7489 <div class="sect2">
7490 <h3 id="_release_notes_for_version_1_6_3">H.27. Release Notes for Version 1.6.3</h3>
7491 <div class="paragraph">
7492 <p>Version 1.6.3 adds idle mode to AltosDroid and has bug fixes
7493 for our host software on desktops, laptops an android devices
7494 along with BlueTooth support for Windows.</p>
7495 </div>
7496 <div class="sect3">
7497 <h4 id="_altos_26">H.27.1. AltOS</h4>
7498 <div class="paragraph">
7499 <p>AltOS fixes:</p>
7500 </div>
7501 <div class="ulist">
7502 <ul>
7503 <li>
7504 <p>Fix hardware flow control on TeleBT v3.0. RTS/CTS is
7505 wired backwards on this board, switch from using the
7506 hardware to driving these pins with software.</p>
7507 </li>
7508 </ul>
7509 </div>
7510 </div>
7511 <div class="sect3">
7512 <h4 id="_altosui_and_telegps_applications_6">H.27.2. AltosUI and TeleGPS Applications</h4>
7513 <div class="paragraph">
7514 <p>AltosUI and TeleGPS New Features:</p>
7515 </div>
7516 <div class="ulist">
7517 <ul>
7518 <li>
7519 <p>Add BlueTooth support for Windows operating system. This
7520 supports connections to TeleBT over BlueTooth rather than
7521 just USB.</p>
7522 </li>
7523 </ul>
7524 </div>
7525 <div class="paragraph">
7526 <p>AltosUI and TeleGPS Fixes:</p>
7527 </div>
7528 <div class="ulist">
7529 <ul>
7530 <li>
7531 <p>Change Java detection and install on Windows. Detection is
7532 now done by looking for the 'javaw.exe' program, and
7533 installation by opening a browser on the java.com web site.</p>
7534 </li>
7535 <li>
7536 <p>Delay polling while the Fire Igniters is visible to allow
7537 for TeleMega to report back complete status over the radio.</p>
7538 </li>
7539 <li>
7540 <p>Disallow changing RF calibration numbers in the
7541 configuration UI. There&#8217;s no good reason to change this from
7542 the field, and recovering is really hard if you haven&#8217;t
7543 written down the right number.</p>
7544 </li>
7545 <li>
7546 <p>Fix USB device discovery on Mac OS X El Capitan. This makes
7547 the connected Altus Metrum USB devices appear again.</p>
7548 </li>
7549 <li>
7550 <p>Fix acceleration data presented in MonitorIdle mode for
7551 TeleMetrum v2.0 flight computers.</p>
7552 </li>
7553 </ul>
7554 </div>
7555 </div>
7556 <div class="sect3">
7557 <h4 id="_altosdroid_7">H.27.3. AltosDroid</h4>
7558 <div class="paragraph">
7559 <p>AltosDroid new features:</p>
7560 </div>
7561 <div class="ulist">
7562 <ul>
7563 <li>
7564 <p>Monitor Idle mode. Check state of flight computer while in
7565 idle mode over the radio link</p>
7566 </li>
7567 <li>
7568 <p>Fire Igniters. Remotely fire ignires for recovery system
7569 ground tests.</p>
7570 </li>
7571 <li>
7572 <p>Remote reboot. Cause the flight computer to reboot over the
7573 radio link. This provides a method for switching the flight
7574 computer from idle to flight mode without needing to reach
7575 the power switch.</p>
7576 </li>
7577 <li>
7578 <p>Configurable frequency menu. Change the set of available
7579 frequencies and provide more descriptive names.</p>
7580 </li>
7581 </ul>
7582 </div>
7583 <div class="paragraph">
7584 <p>AltosDroid bug fixes:</p>
7585 </div>
7586 <div class="ulist">
7587 <ul>
7588 <li>
7589 <p>Don&#8217;t set target location if GPS hasn&#8217;t locked yet.</p>
7590 </li>
7591 <li>
7592 <p>Fix saving target states so they can be reloaded when the
7593 application restarts. When the application is shut down and
7594 restarted, all previous target state information will be
7595 restored (including GPS position if available).</p>
7596 </li>
7597 <li>
7598 <p>Fix crash on some Android devices for offline maps when
7599 changing the map scale or location.</p>
7600 </li>
7601 <li>
7602 <p>Don&#8217;t require USB OTG support. This kept the latest
7603 AltosDroid from being offered on devices without USB device
7604 support, although it can work without that just fine using
7605 BlueTooth.</p>
7606 </li>
7607 <li>
7608 <p>Don&#8217;t require bluetooth to be enabled. This allows the
7609 application to operate with USB devices or just show old
7610 data without turning on the bluetooth radio.</p>
7611 </li>
7612 <li>
7613 <p>Recover old tracker positions when restarting
7614 application. This finally allows you to safely stop and
7615 restart the application without losing the last known
7616 location of any tracker.</p>
7617 </li>
7618 </ul>
7619 </div>
7620 </div>
7621 <div class="sect3">
7622 <h4 id="_documentation_2">H.27.4. Documentation</h4>
7623 <div class="ulist">
7624 <ul>
7625 <li>
7626 <p>Document TeleMega and EasyMega additional pyro channel
7627 continuity audio alert pattern.</p>
7628 </li>
7629 </ul>
7630 </div>
7631 <div style="page-break-after: always;"></div>
7632 </div>
7633 </div>
7634 <div class="sect2">
7635 <h3 id="_release_notes_for_version_1_6_2">H.28. Release Notes for Version 1.6.2</h3>
7636 <div class="paragraph">
7637 <p>Version 1.6.2 includes support for our updated TeleMega v2.0
7638 product and bug fixes in in the flight software for all our boards
7639 and ground station interfaces.</p>
7640 </div>
7641 <div class="sect3">
7642 <h4 id="_altos_27">H.28.1. AltOS</h4>
7643 <div class="paragraph">
7644 <p>AltOS New Features:</p>
7645 </div>
7646 <div class="ulist">
7647 <ul>
7648 <li>
7649 <p>Add support for TeleMega v2.0 boards.</p>
7650 </li>
7651 <li>
7652 <p>Add PWM servo driver. There&#8217;s no higher level code using
7653 this yet, but the driver allows testing of the TeleMega v2.0
7654 servo output connector.</p>
7655 </li>
7656 </ul>
7657 </div>
7658 <div class="paragraph">
7659 <p>AltOS Fixes:</p>
7660 </div>
7661 <div class="ulist">
7662 <ul>
7663 <li>
7664 <p>Slow down telemetry packets to allow receiver to keep
7665 up.</p>
7666 </li>
7667 </ul>
7668 </div>
7669 </div>
7670 <div class="sect3">
7671 <h4 id="_altosui_and_telegps_applications_7">H.28.2. AltosUI and TeleGPS Applications</h4>
7672 <div class="paragraph">
7673 <p>AltosUI and TeleGPS Fixes:</p>
7674 </div>
7675 <div class="ulist">
7676 <ul>
7677 <li>
7678 <p>Fix post-flight orientation computation when processing
7679 TeleMega and EasyMega eeprom data files.</p>
7680 </li>
7681 <li>
7682 <p>Capture complete eeprom data even when there are invalid
7683 entries in the data. This keeps reading eeprom contents and
7684 writing the associated .eeprom file when an error is detected.</p>
7685 </li>
7686 </ul>
7687 </div>
7688 </div>
7689 <div class="sect3">
7690 <h4 id="_documentation_3">H.28.3. Documentation</h4>
7691 <div class="paragraph">
7692 <p>We spent a bunch of time trying to improve our documentation</p>
7693 </div>
7694 <div class="ulist">
7695 <ul>
7696 <li>
7697 <p>HTML versions now have a table of contents on the left side.</p>
7698 </li>
7699 <li>
7700 <p>EasyMini now has its own shorter manual.</p>
7701 </li>
7702 <li>
7703 <p>Provide links between sections in each document.</p>
7704 </li>
7705 <li>
7706 <p>Lots of minor rewriting and restructuring to avoid
7707 duplication of information</p>
7708 </li>
7709 </ul>
7710 </div>
7711 <div style="page-break-after: always;"></div>
7712 </div>
7713 </div>
7714 <div class="sect2">
7715 <h3 id="_release_notes_for_version_1_6_1">H.29. Release Notes for Version 1.6.1</h3>
7716 <div class="paragraph">
7717 <p>Version 1.6.1 includes support for our updated TeleBT v3.0
7718 product and bug fixes in in the flight software for all our boards
7719 and ground station interfaces.</p>
7720 </div>
7721 <div class="sect3">
7722 <h4 id="_altos_28">H.29.1. AltOS</h4>
7723 <div class="paragraph">
7724 <p>AltOS New Features:</p>
7725 </div>
7726 <div class="ulist">
7727 <ul>
7728 <li>
7729 <p>Add support for TeleBT v3.0 boards.</p>
7730 </li>
7731 <li>
7732 <p>Add support for uncompressed APRS data, providing support
7733 for older APRS receivers. Uncompressed APRS data is less
7734 precise, takes more bandwidth and doesn&#8217;t have integrated
7735 altitude data.</p>
7736 </li>
7737 </ul>
7738 </div>
7739 <div class="paragraph">
7740 <p>AltOS Fixes:</p>
7741 </div>
7742 <div class="ulist">
7743 <ul>
7744 <li>
7745 <p>Make TeleDongle and TeleBT more tolerant of data rate
7746 variations from transmitting devices.</p>
7747 </li>
7748 </ul>
7749 </div>
7750 </div>
7751 <div class="sect3">
7752 <h4 id="_altosui_and_telegps_applications_8">H.29.2. AltosUI and TeleGPS Applications</h4>
7753 <div class="paragraph">
7754 <p>AltosUI and TeleGPS New Features:</p>
7755 </div>
7756 <div class="ulist">
7757 <ul>
7758 <li>
7759 <p>Add map to Monitor Idle display. It&#8217;s nice to be able to
7760 verify that maps are working, instead of needing to use
7761 Monitor Flight.</p>
7762 </li>
7763 </ul>
7764 </div>
7765 <div class="paragraph">
7766 <p>AltosUI and TeleGPS Fixes:</p>
7767 </div>
7768 <div class="ulist">
7769 <ul>
7770 <li>
7771 <p>Fix frequency configuration to round values instead of
7772 truncate them, avoiding a common 1kHz error in the setting.</p>
7773 </li>
7774 <li>
7775 <p>Turn the Windows stub into a more useful program that can
7776 launch the application with parameters so that file manager
7777 icons work more reliably.</p>
7778 </li>
7779 <li>
7780 <p>Force KML export to use a C locale so that numbers are
7781 formatted with '.' instead of ',' for a decimal separator in
7782 non-US locales.</p>
7783 </li>
7784 <li>
7785 <p>Preload map tiles based on distance rather than number of
7786 tiles; this means you get the same resolution covering the
7787 entire area, rather than having high resolution near the
7788 center and low resolution further away.</p>
7789 </li>
7790 <li>
7791 <p>Allow configuration of frequency and callsign in Monitor
7792 Idle mode.</p>
7793 </li>
7794 <li>
7795 <p>Fix layout weirdness when resizing windows on
7796 Windows. Windows shouldn&#8217;t have giant blank spaces around
7797 the useful content anymore.</p>
7798 </li>
7799 <li>
7800 <p>Fix layout weirdness when resizing windows on
7801 Windows. Windows shouldn&#8217;t have giant blank spaces around
7802 the useful content anymore.</p>
7803 </li>
7804 <li>
7805 <p>Use a longer filter for descent speed values. This should
7806 provide something more useful on the display, although it
7807 will take longer to respond to changes now.</p>
7808 </li>
7809 <li>
7810 <p>Make Replay Flight run in realtime again. It had been set to
7811 run at 10x speed by mistake.</p>
7812 </li>
7813 </ul>
7814 </div>
7815 </div>
7816 <div class="sect3">
7817 <h4 id="_altosdroid_8">H.29.3. AltosDroid</h4>
7818 <div class="paragraph">
7819 <p>AltosDroid New Features:</p>
7820 </div>
7821 <div class="ulist">
7822 <ul>
7823 <li>
7824 <p>Add offline map support using mapping code from AltosUI.</p>
7825 </li>
7826 <li>
7827 <p>Support TeleDongle (and TeleBT via USB) on devices
7828 supporting USB On-The-Go.</p>
7829 </li>
7830 <li>
7831 <p>Display additional TeleMega pyro channel status in Pad tab.</p>
7832 </li>
7833 <li>
7834 <p>Switch between metric and imperial units.</p>
7835 </li>
7836 <li>
7837 <p>Monitor TeleBT battery voltage.</p>
7838 </li>
7839 <li>
7840 <p>Track multiple devices at the same time, selecting between
7841 them with a menu or using the map.</p>
7842 </li>
7843 <li>
7844 <p>Add hybrid, satellite and terrain map types.</p>
7845 </li>
7846 </ul>
7847 </div>
7848 <div class="paragraph">
7849 <p>AltosDroid Fixes:</p>
7850 </div>
7851 <div class="ulist">
7852 <ul>
7853 <li>
7854 <p>Use standard Android display conventions so that a menu
7855 button is available in the application title bar.</p>
7856 </li>
7857 <li>
7858 <p>Adjust layout to work on large and small screens; shrinking
7859 the go/no-go lights in smaller environments to try and make
7860 everything visible.</p>
7861 </li>
7862 <li>
7863 <p>Make voice announcements depend on current tab.</p>
7864 </li>
7865 <li>
7866 <p>Compute adjustment to current travel direction while in
7867 motion towards rocket.</p>
7868 </li>
7869 </ul>
7870 </div>
7871 <div style="page-break-after: always;"></div>
7872 </div>
7873 </div>
7874 <div class="sect2">
7875 <h3 id="_release_notes_for_version_1_6">H.30. Release Notes for Version 1.6</h3>
7876 <div class="paragraph">
7877 <p>Version 1.6 includes support for our updated TeleDongle v3.0
7878 product and bug fixes in in the flight software for all our boards
7879 and ground station interfaces.</p>
7880 </div>
7881 <div class="sect3">
7882 <h4 id="_altos_29">H.30.1. AltOS</h4>
7883 <div class="paragraph">
7884 <p>AltOS New Features</p>
7885 </div>
7886 <div class="ulist">
7887 <ul>
7888 <li>
7889 <p>Add support for TeleDongle v3.0 boards.</p>
7890 </li>
7891 </ul>
7892 </div>
7893 <div class="paragraph">
7894 <p>AltOS Fixes</p>
7895 </div>
7896 <div class="ulist">
7897 <ul>
7898 <li>
7899 <p>Don&#8217;t beep out the continuity twice by accident in idle mode.
7900 If the battery voltage report takes longer than the initialiation
7901 sequence, the igniter continuity would get reported twice.</p>
7902 </li>
7903 <li>
7904 <p>Record all 32 bits of gyro calibration data in TeleMega and
7905 EasyMega log files. This fixes computation of the gyro rates
7906 in AltosUI.</p>
7907 </li>
7908 <li>
7909 <p>Change TeleDongle LED usage. Green LED flashes when valid
7910 packet is received. Red LED flashes when invalid packet is
7911 received.</p>
7912 </li>
7913 <li>
7914 <p>Replace LPC11U14 SPI driver with non-interrupt version. The
7915 interrupt code would occasionally wedge on long transfers
7916 if interrupts were blocked for too long. This affects all
7917 released TeleGPS products; if you have a TeleGPS device,
7918 you&#8217;ll want to reflash the firmware.</p>
7919 </li>
7920 </ul>
7921 </div>
7922 </div>
7923 <div class="sect3">
7924 <h4 id="_altosui_and_telegps_applications_9">H.30.2. AltosUI and TeleGPS Applications</h4>
7925 <div class="paragraph">
7926 <p>AltosUI and TeleGPS New Features</p>
7927 </div>
7928 <div class="ulist">
7929 <ul>
7930 <li>
7931 <p>Compute tilt angle from TeleMega and EasyMega log
7932 files. This duplicates the quaternion-based angle tracking
7933 code from the flight firmware inside the ground station
7934 software so that post-flight analysis can include evaluation
7935 of the tilt angle.</p>
7936 </li>
7937 <li>
7938 <p>Shows the tool button window when starting with a data file
7939 specified. This means that opening a data file from the file
7940 manager will now bring up the main window to let you operate
7941 the whole application.</p>
7942 </li>
7943 </ul>
7944 </div>
7945 <div class="paragraph">
7946 <p>AltosUI Fixes</p>
7947 </div>
7948 <div class="ulist">
7949 <ul>
7950 <li>
7951 <p>Show the 'Connecting' dialog when using Monitor Idle. Lets
7952 you cancel the Monitor Idle startup when connecting over the
7953 radio link.</p>
7954 </li>
7955 <li>
7956 <p>Make 'Monitor Idle' work for TeleGPS devices when connected
7957 over USB. It&#8217;s nice for testing without needing to broadcast
7958 over the radio.</p>
7959 </li>
7960 <li>
7961 <p>Use different Windows API to discover USB devices. This
7962 works better on my Windows 7 box, and will be used if the
7963 older API fails to provide the necessary information.</p>
7964 </li>
7965 <li>
7966 <p>Look in more places in the registry to try and identify the
7967 installed Java version on Windows. If you install the
7968 default 32-bit version of Windows on a 64-bit OS, the Java
7969 registry information is hiding \SOFTWARE\Wow6432Node for
7970 some reason.</p>
7971 </li>
7972 <li>
7973 <p>Fix file association on Windows by searching for the
7974 javaw.exe program instead of assuming it is in
7975 %SYSTEMROOT%. This makes double-clicking on Altus Metrum
7976 data files in the file manager work correctly.</p>
7977 </li>
7978 <li>
7979 <p>When replaying a file, put 'done' in the Age field when we
7980 reach the end of the file, instead of continuing to count forever.</p>
7981 </li>
7982 <li>
7983 <p>In the Scan Channels code, wait for five seconds if we see
7984 any packet. This is needed because AltOS now sends the
7985 callsign, serial number and flight number only once every
7986 five seconds these days.</p>
7987 </li>
7988 <li>
7989 <p>In the Scan Channels code, reset pending flight state
7990 information each time we change channels. This avoids having
7991 flight computers appear on multiple frequencies by accident.</p>
7992 </li>
7993 </ul>
7994 </div>
7995 <div style="page-break-after: always;"></div>
7996 </div>
7997 </div>
7998 <div class="sect2">
7999 <h3 id="_release_notes_for_version_1_5">H.31. Release Notes for Version 1.5</h3>
8000 <div class="paragraph">
8001 <p>Version 1.5 is a major release. It includes support for our new
8002 EasyMega product, new features and bug fixes in in the flight
8003 software for all our boards and the AltosUI ground station</p>
8004 </div>
8005 <div class="sect3">
8006 <h4 id="_altos_30">H.31.1. AltOS</h4>
8007 <div class="paragraph">
8008 <p>AltOS New Features</p>
8009 </div>
8010 <div class="ulist">
8011 <ul>
8012 <li>
8013 <p>Add support for EasyMega boards.</p>
8014 </li>
8015 <li>
8016 <p>Make the APRS SSID be configurable. This lets you track
8017 different rockets on the same receiver without getting
8018 things mixed up.</p>
8019 </li>
8020 <li>
8021 <p>Report extra pyro channel continuity state on EasyMega and
8022 TeleMega via the beeper. This lets you easily verify flight
8023 readiness on these boards after powering up the electronics
8024 on the rail.</p>
8025 </li>
8026 <li>
8027 <p>Add lower telemetry data rates (2400 and 9600 bps) to
8028 increase telemetry radio range. This reduces the amount of
8029 data received as well as increasing battery consumption in
8030 the transmitter.</p>
8031 </li>
8032 <li>
8033 <p>Change TeleGPS to have only a single log, and append new
8034 data to it rather than using seperate per-flight logs. This
8035 avoids accidentally filling up log storage by turning
8036 TeleGPS on/off several times.</p>
8037 </li>
8038 </ul>
8039 </div>
8040 <div class="paragraph">
8041 <p>AltOS Fixes</p>
8042 </div>
8043 <div class="ulist">
8044 <ul>
8045 <li>
8046 <p>Increase the maximum range for altitude values from +/-32767m
8047 to +/-2147483647m, allowing the flight computers to function
8048 correctly above the 32km level.</p>
8049 </li>
8050 <li>
8051 <p>Continuously test pyro firing conditions during delay stage,
8052 inhibiting the pyro channel if the test fails. This prevents
8053 firing pyro charges where the conditions were good before
8054 the delay, but become bad before the delay expires.</p>
8055 </li>
8056 <li>
8057 <p>Allow negative numbers in pyro configuration values. This
8058 lets you specify things like descending speed or
8059 deceleration.</p>
8060 </li>
8061 </ul>
8062 </div>
8063 </div>
8064 <div class="sect3">
8065 <h4 id="_altosui_and_telegps_applications_10">H.31.2. AltosUI and TeleGPS Applications</h4>
8066 <div class="paragraph">
8067 <p>AltosUI and TeleGPS New Features</p>
8068 </div>
8069 <div class="ulist">
8070 <ul>
8071 <li>
8072 <p>Support telemetry baud rate selection. Adds menus to
8073 the flight monitoring and configuration for baud rate
8074 selection.</p>
8075 </li>
8076 <li>
8077 <p>Support APRS SSID configuration.</p>
8078 </li>
8079 <li>
8080 <p>Integrate with file managers. This provides icons for all of
8081 our file types and associates our application with the files
8082 so that using a file manager to open a AltOS data file
8083 results in launching our application.</p>
8084 </li>
8085 </ul>
8086 </div>
8087 <div class="paragraph">
8088 <p>AltosUI Fixes</p>
8089 </div>
8090 <div class="ulist">
8091 <ul>
8092 <li>
8093 <p>Make the 'Graph' button on the landed tab work again.</p>
8094 </li>
8095 <li>
8096 <p>Make tests for Java on Windows a bit smarter, and also
8097 provide the user with the option to skip installing Java for
8098 cases where we just can&#8217;t figure out what version is installed.</p>
8099 </li>
8100 </ul>
8101 </div>
8102 <div style="page-break-after: always;"></div>
8103 </div>
8104 </div>
8105 <div class="sect2">
8106 <h3 id="_release_notes_for_version_1_4_2">H.32. Release Notes for Version 1.4.2</h3>
8107 <div class="paragraph">
8108 <p>Version 1.4.2 is a minor release. It fixes Java-related install issues on
8109 Windows</p>
8110 </div>
8111 <div class="sect3">
8112 <h4 id="_altosui_and_telegps_applications_11">H.32.1. AltosUI and TeleGPS Applications</h4>
8113 <div class="paragraph">
8114 <p>Windows Install Fixes</p>
8115 </div>
8116 <div class="ulist">
8117 <ul>
8118 <li>
8119 <p>Checks for Java installation data in more registry locations.</p>
8120 </li>
8121 <li>
8122 <p>Allows user to bypass Java installation in case the
8123 detection fails.</p>
8124 </li>
8125 </ul>
8126 </div>
8127 <div style="page-break-after: always;"></div>
8128 </div>
8129 </div>
8130 <div class="sect2">
8131 <h3 id="_release_notes_for_version_1_4_1">H.33. Release Notes for Version 1.4.1</h3>
8132 <div class="paragraph">
8133 <p>Version 1.4.1 is a minor release. It fixes install issues on
8134 Windows and provides the missing TeleMetrum V2.0 firmware. There
8135 aren&#8217;t any changes to the firmware or host applications at
8136 all. All Windows users will want to upgrade to get the signed
8137 driver, but Mac and Linux users who do not need the TeleMetrum
8138 V2.0 firmware image will not need to upgrade.</p>
8139 </div>
8140 <div class="sect3">
8141 <h4 id="_altosui_and_telegps_applications_12">H.33.1. AltosUI and TeleGPS Applications:</h4>
8142 <div class="paragraph">
8143 <p>Windows Install Fixes</p>
8144 </div>
8145 <div class="ulist">
8146 <ul>
8147 <li>
8148 <p>Provide signed Windows driver files. This should avoid any need to
8149 disable driver signature checking on Windows 7 or 8.</p>
8150 </li>
8151 <li>
8152 <p>Fix Java version detection and download. Previously, the
8153 installer would only look for Java 6 or 7 and insist on
8154 downloading its own Java bits if there was something else
8155 installed. Furthermore, the 64-bit Java link provided didn&#8217;t
8156 work for anyone other than Keith, making it impossible to
8157 install AltOS on any machine with Java SE 8 installed.</p>
8158 </li>
8159 </ul>
8160 </div>
8161 <div class="paragraph">
8162 <p>Other Fixes</p>
8163 </div>
8164 <div class="ulist">
8165 <ul>
8166 <li>
8167 <p>Include 1.4 firmware for TeleMetrum V2.0. None of the
8168 installers shipped this file. Now it&#8217;s included in the AltOS
8169 packages for Linux, Mac and Windows.</p>
8170 </li>
8171 <li>
8172 <p>Include Google Application Key for map downloading. The 1.4
8173 release didn&#8217;t have this key in the released version of the
8174 software, making map downloading fail for most people.</p>
8175 </li>
8176 </ul>
8177 </div>
8178 <div style="page-break-after: always;"></div>
8179 </div>
8180 </div>
8181 <div class="sect2">
8182 <h3 id="_release_notes_for_version_1_4">H.34. Release Notes for Version 1.4</h3>
8183 <div class="paragraph">
8184 <p>Version 1.4 is a major release. It includes support for our new
8185 TeleGPS product, new features and bug fixes in in the flight
8186 software for all our boards and the AltosUI ground station</p>
8187 </div>
8188 <div class="sect3">
8189 <h4 id="_altos_31">H.34.1. AltOS</h4>
8190 <div class="paragraph">
8191 <p>AltOS new features:</p>
8192 </div>
8193 <div class="ulist">
8194 <ul>
8195 <li>
8196 <p>Add support for TeleGPS boards.</p>
8197 </li>
8198 <li>
8199 <p>Make the beeper tone configurable, making it
8200 possible to distinguish between two Altus Metrum
8201 products in the same ebay.</p>
8202 </li>
8203 <li>
8204 <p>Make the firing time for extra pyro channels
8205 configurable, allowing longer (or shorter) than the
8206 default 50ms.  Only relevant for TeleMega at this
8207 time.</p>
8208 </li>
8209 </ul>
8210 </div>
8211 <div class="paragraph">
8212 <p>AltOS fixes:</p>
8213 </div>
8214 <div class="ulist">
8215 <ul>
8216 <li>
8217 <p>Replace the 'dit dit dit' tones at startup with the
8218 current battery voltage, measured in tenths of a
8219 volt. This lets you check the battery voltage
8220 without needing telemetry, which is especially
8221 useful on EasyMini.</p>
8222 </li>
8223 <li>
8224 <p>Change state beeping to "Farnsworth spacing", which
8225 means they&#8217;re quite a bit faster than before, and so
8226 they take less time to send.</p>
8227 </li>
8228 <li>
8229 <p>Fix bug preventing the selection of the 'Flight
8230 State After' mode in pyro configuration.</p>
8231 </li>
8232 <li>
8233 <p>Fix bug where erasing flights would reset the flight
8234 number to 2 on TeleMega and TeleMetrum v2.</p>
8235 </li>
8236 <li>
8237 <p>Fix u-Blox GPS driver to mark course and speed data
8238 as being present.</p>
8239 </li>
8240 </ul>
8241 </div>
8242 </div>
8243 <div class="sect3">
8244 <h4 id="_altosui_application">H.34.2. AltosUI Application</h4>
8245 <div class="paragraph">
8246 <p>AltosUI new features:</p>
8247 </div>
8248 <div class="ulist">
8249 <ul>
8250 <li>
8251 <p>Add zooming and new content types (terrain and road
8252 maps) to map view. Change map storage format from
8253 PNG to Jpeg, which saves a huge amount of disk
8254 space. You will need to re-download all of your
8255 pre-loaded map images.</p>
8256 </li>
8257 <li>
8258 <p>Add a distance measuring device to the maps
8259 view. Select this by using any button other than the
8260 left one, or by pressing shift or control on the
8261 keyboard while using the left button.</p>
8262 </li>
8263 <li>
8264 <p>Add new 'Ignitor' tab to the flight monitor display
8265 for TeleMega&#8217;s extra ignitors.</p>
8266 </li>
8267 <li>
8268 <p>Add additional ignitor firing marks and voltages to
8269 the graph so you can see when the ignitors fired,
8270 along with the ignitor voltages.</p>
8271 </li>
8272 <li>
8273 <p>Add GPS course, ground speed and climb rate as
8274 optional graph elements.</p>
8275 </li>
8276 </ul>
8277 </div>
8278 <div class="paragraph">
8279 <p>AltosUI fixes:</p>
8280 </div>
8281 <div class="ulist">
8282 <ul>
8283 <li>
8284 <p>When flashing new firmware, re-try opening the
8285 device as sometimes it takes a while for the
8286 underlying operating system to recognize that the
8287 device has rebooted in preparation for the flashing
8288 operation.</p>
8289 </li>
8290 <li>
8291 <p>Hide Tilt Angle in ascent tab for devices that don&#8217;t
8292 have a gyro.</p>
8293 </li>
8294 <li>
8295 <p>Increase the width of data lines in the graphs to
8296 make them easier to read.</p>
8297 </li>
8298 <li>
8299 <p>Filter out speed and acceleration spikes caused by
8300 ejection charge firing when computing the maximum
8301 values. This provides a more accurate reading of
8302 those maximums.</p>
8303 </li>
8304 <li>
8305 <p>Fix EasyMini voltage displays. Early EasyMini
8306 prototypes used a 3.0V regulator, and AltosUI still
8307 used that value as the basis of the
8308 computation. Production EasyMini boards have always
8309 shipped with a 3.3V regulator. Also, purple EasyMini
8310 boards sensed the battery voltage past the blocking
8311 diode, resulting in a drop of about 150mV from the
8312 true battery voltage. Compensate for that when
8313 displaying the value.</p>
8314 </li>
8315 <li>
8316 <p>Display error message when trying to configure
8317 maximum flight log size while the flight computer
8318 still has flight data stored.</p>
8319 </li>
8320 <li>
8321 <p>Handle TeleMetrum and TeleMini eeprom files
8322 generated with pre-1.0 firmware. Those ancient
8323 versions didn&#8217;t report the log format, so just use
8324 the product name instead.</p>
8325 </li>
8326 </ul>
8327 </div>
8328 </div>
8329 <div class="sect3">
8330 <h4 id="_telegps_application">H.34.3. TeleGPS Application</h4>
8331 <div class="ulist">
8332 <ul>
8333 <li>
8334 <p>New application designed for use with TeleGPS boards.</p>
8335 </li>
8336 <li>
8337 <p>Shares code with AltosUI, mostly just trimmed down
8338 to focus on TeleGPS-related functions.</p>
8339 </li>
8340 </ul>
8341 </div>
8342 </div>
8343 <div class="sect3">
8344 <h4 id="_documentation_4">H.34.4. Documentation</h4>
8345 <div class="paragraph">
8346 <p>Documentation changes:</p>
8347 </div>
8348 <div class="ulist">
8349 <ul>
8350 <li>
8351 <p>Re-create the drill template images; they should
8352 print correctly from Firefox at least. Ship these as
8353 individual PDF files so they&#8217;re easy to print.</p>
8354 </li>
8355 <li>
8356 <p>Add a description of the 'Apogee Lockout' setting,
8357 which prevents the apogee charge from firing for a
8358 configurable amount of time after boost.</p>
8359 </li>
8360 </ul>
8361 </div>
8362 <div style="page-break-after: always;"></div>
8363 </div>
8364 </div>
8365 <div class="sect2">
8366 <h3 id="_release_notes_for_version_1_3_2">H.35. Release Notes for Version 1.3.2</h3>
8367 <div class="paragraph">
8368 <p>Version 1.3.2 is a minor release. It includes small bug fixes for
8369 the TeleMega flight software and AltosUI ground station</p>
8370 </div>
8371 <div class="sect3">
8372 <h4 id="_altos_32">H.35.1. AltOS</h4>
8373 <div class="paragraph">
8374 <p>AltOS fixes:</p>
8375 </div>
8376 <div class="ulist">
8377 <ul>
8378 <li>
8379 <p>On TeleMega, limit number of logged GPS status
8380 information to 12 satellites. That&#8217;s all there is
8381 room for in the log structure.</p>
8382 </li>
8383 <li>
8384 <p>Improve APRS behavior. Remembers last known GPS
8385 position and keeps sending that if we lose GPS
8386 lock. Marks locked/unlocked by sending L/U in the
8387 APRS comment field along with the number of sats in
8388 view and voltages.</p>
8389 </li>
8390 </ul>
8391 </div>
8392 </div>
8393 <div class="sect3">
8394 <h4 id="_altosui_application_2">H.35.2. AltosUI Application</h4>
8395 <div class="paragraph">
8396 <p>AltosUI fixes:</p>
8397 </div>
8398 <div class="ulist">
8399 <ul>
8400 <li>
8401 <p>If the TeleMega flight firmware reports that it has
8402 logged information about more than 12 satellites,
8403 don&#8217;t believe it as the log only holds 12 satellite
8404 records.</p>
8405 </li>
8406 <li>
8407 <p>Track the maximum height as computed from GPS
8408 altitude data and report that in the flight summary
8409 data.</p>
8410 </li>
8411 <li>
8412 <p>Use letters (A, B, C, D) for alternate pyro channel
8413 names instead of numbers (0, 1, 2, 3) in the Fire
8414 Igniter dialog.</p>
8415 </li>
8416 </ul>
8417 </div>
8418 <div style="page-break-after: always;"></div>
8419 </div>
8420 </div>
8421 <div class="sect2">
8422 <h3 id="_release_notes_for_version_1_3_1">H.36. Release Notes for Version 1.3.1</h3>
8423 <div class="paragraph">
8424 <p>Version 1.3.1 is a minor release. It improves support for
8425 TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini.</p>
8426 </div>
8427 <div class="sect3">
8428 <h4 id="_altos_33">H.36.1. AltOS</h4>
8429 <div class="paragraph">
8430 <p>AltOS new features:</p>
8431 </div>
8432 <div class="ulist">
8433 <ul>
8434 <li>
8435 <p>Improved APRS mode. Now uses compressed position
8436 format for smaller data size, improved precision and
8437 to include altitude data as well as latitude and
8438 longitude. Also added battery and pyro voltage
8439 reports in the APRS comment field so you can confirm
8440 that the unit is ready for launch.</p>
8441 </li>
8442 </ul>
8443 </div>
8444 <div class="paragraph">
8445 <p>AltOS fixes:</p>
8446 </div>
8447 <div class="ulist">
8448 <ul>
8449 <li>
8450 <p>Improve sensor boot code. If sensors fail to
8451 self-test, the device will still boot up and check
8452 for pad/idle modes. If in idle mode, the device will
8453 warn the user with a distinct beep, if in Pad mode,
8454 the unit will operate as best it can. Also, the
8455 Z-axis accelerometer now uses the factory
8456 calibration values instead of re-calibrating on the
8457 pad each time. This avoids accidental boost detect
8458 when moving the device around while in Pad mode.</p>
8459 </li>
8460 <li>
8461 <p>Fix antenna-down mode accelerometer
8462 configuration. Antenna down mode wasn&#8217;t working
8463 because the accelerometer calibration values were
8464 getting re-computed incorrectly in inverted mode.</p>
8465 </li>
8466 </ul>
8467 </div>
8468 </div>
8469 <div class="sect3">
8470 <h4 id="_altosui_application_3">H.36.2. AltosUI Application</h4>
8471 <div class="paragraph">
8472 <p>AltosUI new features:</p>
8473 </div>
8474 <div class="ulist">
8475 <ul>
8476 <li>
8477 <p>Display additional TeleMega sensor values in real
8478 units. Make all of these values available for
8479 plotting. Display TeleMega orientation value in the
8480 Ascent and Table tabs.</p>
8481 </li>
8482 <li>
8483 <p>Support additional TeleMega pyro channels in the
8484 Fire Igniter dialog. This lets you do remote testing
8485 of all of the channels, rather than just Apogee and
8486 Main.</p>
8487 </li>
8488 </ul>
8489 </div>
8490 <div class="paragraph">
8491 <p>AltosUI fixes:</p>
8492 </div>
8493 <div class="ulist">
8494 <ul>
8495 <li>
8496 <p>Limit data rate when downloading satellite images
8497 from Google to make sure we stay within their limits
8498 so that all of the map tiles download successfully.</p>
8499 </li>
8500 </ul>
8501 </div>
8502 <div style="page-break-after: always;"></div>
8503 </div>
8504 </div>
8505 <div class="sect2">
8506 <h3 id="_release_notes_for_version_1_3">H.37. Release Notes for Version 1.3</h3>
8507 <div class="paragraph">
8508 <p>Version 1.3 is a major release. It adds support for TeleMega,
8509 TeleMetrum v2.0, TeleMini v2.0 and EasyMini.</p>
8510 </div>
8511 <div class="sect3">
8512 <h4 id="_altos_34">H.37.1. AltOS</h4>
8513 <div class="paragraph">
8514 <p>AltOS new features:</p>
8515 </div>
8516 <div class="ulist">
8517 <ul>
8518 <li>
8519 <p>Add STM32L processor support. This includes
8520 enhancements to the scheduler to support products
8521 with many threads.</p>
8522 </li>
8523 <li>
8524 <p>Add NXP LPC11U14 processor support.</p>
8525 </li>
8526 <li>
8527 <p>Support additional pyro channels. These are
8528 configurable through the UI to handle air starts,
8529 staging, additional recovery events and external
8530 devices such as cameras.</p>
8531 </li>
8532 <li>
8533 <p>Add 3-axis gyro support for orientation
8534 tracking. This integrates the gyros to compute the
8535 angle from vertical during flight, allowing the
8536 additional pyro events to be controlled by this
8537 value.</p>
8538 </li>
8539 <li>
8540 <p>Many more device drivers, including u-Blox Max 7Q
8541 GPS, Freescale MMA6555 digital single-axis
8542 accelerometer, Invensense MPU6000 3-axis
8543 accelerometer + 3 axis gyro, Honeywell HMC5883
8544 3-axis magnetic sensor and the TI CC1120 and CC115L
8545 digital FM transceivers</p>
8546 </li>
8547 </ul>
8548 </div>
8549 </div>
8550 <div class="sect3">
8551 <h4 id="_altosui_application_4">H.37.2. AltosUI Application</h4>
8552 <div class="paragraph">
8553 <p>AltosUI new features:</p>
8554 </div>
8555 <div class="ulist">
8556 <ul>
8557 <li>
8558 <p>Support TeleMega, TeleMetrum v2.0, TeleMini v2.0 and
8559 EasyMini telemetry and log formats.</p>
8560 </li>
8561 </ul>
8562 </div>
8563 <div class="paragraph">
8564 <p>AltosUI fixes:</p>
8565 </div>
8566 <div class="ulist">
8567 <ul>
8568 <li>
8569 <p>Use preferred units for main deployment height
8570 configuration, instead of always doing configuration in
8571 meters.
8572 == MicroPeak Application</p>
8573 </li>
8574 <li>
8575 <p>Add 'Download' button to menu bar.</p>
8576 </li>
8577 <li>
8578 <p>Save the last log directory and offer that as the
8579 default for new downloads</p>
8580 </li>
8581 </ul>
8582 </div>
8583 <div style="page-break-after: always;"></div>
8584 </div>
8585 </div>
8586 <div class="sect2">
8587 <h3 id="_release_notes_for_version_1_2_1">H.38. Release Notes for Version 1.2.1</h3>
8588 <div class="paragraph">
8589 <p>Version 1.2.1 is a minor release. It adds support for TeleBT and
8590 the AltosDroid application, provides several new features in
8591 AltosUI and fixes some bugs in the AltOS firmware.</p>
8592 </div>
8593 <div class="sect3">
8594 <h4 id="_altos_35">H.38.1. AltOS</h4>
8595 <div class="paragraph">
8596 <p>AltOS new features:</p>
8597 </div>
8598 <div class="ulist">
8599 <ul>
8600 <li>
8601 <p>Add support for TeleBT</p>
8602 </li>
8603 </ul>
8604 </div>
8605 <div class="paragraph">
8606 <p>AltOS fixes:</p>
8607 </div>
8608 <div class="ulist">
8609 <ul>
8610 <li>
8611 <p>In TeleMini recovery mode (when booted with the
8612 outer two debug pins connected together), the radio
8613 parameters are also set back to defaults
8614 (434.550MHz, N0CALL, factory radio cal).</p>
8615 </li>
8616 <li>
8617 <p>Correct Kalman filter model error covariance
8618 matrix. The values used previously assumed
8619 continuous measurements instead of discrete
8620 measurements.</p>
8621 </li>
8622 <li>
8623 <p>Fix some bugs in the USB driver for TeleMetrum and
8624 TeleDongle that affected Windows users.</p>
8625 </li>
8626 <li>
8627 <p>Adjusted the automatic gain control parameters that
8628 affect receive performance for TeleDongle. Field
8629 tests indicate that this may improve receive
8630 performance somewhat.</p>
8631 </li>
8632 </ul>
8633 </div>
8634 </div>
8635 <div class="sect3">
8636 <h4 id="_altosui_application_5">H.38.2. AltosUI Application</h4>
8637 <div class="paragraph">
8638 <p>AltosUI application new features:</p>
8639 </div>
8640 <div class="ulist">
8641 <ul>
8642 <li>
8643 <p>Make the initial position of the AltosUI top level
8644 window configurable. Along with this change, the
8645 other windows will pop up at 'sensible' places now,
8646 instead of on top of one another.</p>
8647 </li>
8648 <li>
8649 <p>Add GPS data and a map to the graph window. This
8650 lets you see a complete summary of the flight
8651 without needing to 'replay' the whole thing.</p>
8652 </li>
8653 </ul>
8654 </div>
8655 <div class="paragraph">
8656 <p>AltosUI application fixes:</p>
8657 </div>
8658 <div class="ulist">
8659 <ul>
8660 <li>
8661 <p>Handle missing GPS lock in 'Descent'
8662 tab. Previously, if the GPS position of the pad was
8663 unknown, an exception would be raised, breaking the
8664 Descent tab contents.</p>
8665 </li>
8666 <li>
8667 <p>Improve the graph, adding tool-tips to show values
8668 near the cursor and making the displayed set of
8669 values configurable, adding all of the flight data
8670 as options while leaving the default settings alone
8671 so that the graph starts by showing height, speed
8672 and acceleration.</p>
8673 </li>
8674 <li>
8675 <p>Add callsign to Monitor idle window and connecting
8676 dialogs. This makes it clear which callsign is being
8677 used so that the operator will be aware that it must
8678 match the flight computer value or no communication
8679 will work.</p>
8680 </li>
8681 <li>
8682 <p>When downloading flight data, display the block
8683 number so that the user has some sense of
8684 progress. Unfortunately, we don&#8217;t know how many
8685 blocks will need to be downloaded, but at least it
8686 isn&#8217;t just sitting there doing nothing for a long
8687 time.</p>
8688 </li>
8689 </ul>
8690 </div>
8691 </div>
8692 <div class="sect3">
8693 <h4 id="_altosdroid_9">H.38.3. AltosDroid</h4>
8694 <div class="ulist">
8695 <ul>
8696 <li>
8697 <p>First version of this application</p>
8698 </li>
8699 </ul>
8700 </div>
8701 <div style="page-break-after: always;"></div>
8702 </div>
8703 </div>
8704 <div class="sect2">
8705 <h3 id="_release_notes_for_version_1_2">H.39. Release Notes for Version 1.2</h3>
8706 <div class="paragraph">
8707 <p>Version 1.2 is a major release. It adds support for MicroPeak
8708 and the MicroPeak USB adapter.</p>
8709 </div>
8710 <div class="sect3">
8711 <h4 id="_altos_36">H.39.1. AltOS</h4>
8712 <div class="paragraph">
8713 <p>AltOS New Features:</p>
8714 </div>
8715 <div class="ulist">
8716 <ul>
8717 <li>
8718 <p>Add MicroPeak support. This includes support for the
8719 ATtiny85 processor and adaptations to the core code
8720 to allow for devices too small to run the
8721 multi-tasking scheduler.</p>
8722 </li>
8723 </ul>
8724 </div>
8725 </div>
8726 <div class="sect3">
8727 <h4 id="_altosui_and_micropeak_application">H.39.2. AltosUI and MicroPeak Application</h4>
8728 <div class="paragraph">
8729 <p>New Features:</p>
8730 </div>
8731 <div class="ulist">
8732 <ul>
8733 <li>
8734 <p>Added MicroPeak application</p>
8735 </li>
8736 </ul>
8737 </div>
8738 <div class="paragraph">
8739 <p>AltosUI and MicroPeak fixes:</p>
8740 </div>
8741 <div class="ulist">
8742 <ul>
8743 <li>
8744 <p>Distribute Mac OS X packages in disk image ('.dmg')
8745 format to greatly simplify installation.</p>
8746 </li>
8747 <li>
8748 <p>Provide version numbers for the shared Java
8749 libraries to ensure that upgrades work properly, and
8750 to allow for multiple Altus Metrum software packages
8751 to be installed in the same directory at the same
8752 time.</p>
8753 </li>
8754 </ul>
8755 </div>
8756 <div style="page-break-after: always;"></div>
8757 </div>
8758 </div>
8759 <div class="sect2">
8760 <h3 id="_release_notes_for_version_1_1">H.40. Release Notes for Version 1.1</h3>
8761 <div class="paragraph">
8762 <p>Version 1.1.1 is a bug-fix release. It fixes a couple of bugs
8763 in AltosUI and one firmware bug that affects TeleMetrum
8764 version 1.0 boards. Thanks to Bob Brown for help diagnosing
8765 the Google Earth file export issue, and for suggesting the
8766 addition of the Ground Distance value in the Descent tab.</p>
8767 </div>
8768 <div class="sect3">
8769 <h4 id="_altos_37">H.40.1. AltOS</h4>
8770 <div class="paragraph">
8771 <p>AltOS fixes:</p>
8772 </div>
8773 <div class="ulist">
8774 <ul>
8775 <li>
8776 <p>TeleMetrum v1.0 boards use the AT45DB081D flash
8777 memory part to store flight data, which is different
8778 from later TeleMetrum boards. The AltOS v1.1 driver
8779 for this chip couldn&#8217;t erase memory, leaving it
8780 impossible to delete flight data or update
8781 configuration values. This bug doesn&#8217;t affect newer
8782 TeleMetrum boards, and it doesn&#8217;t affect the safety
8783 of rockets flying version 1.1 firmware.</p>
8784 </li>
8785 </ul>
8786 </div>
8787 </div>
8788 <div class="sect3">
8789 <h4 id="_altosui_11">H.40.2. AltosUI</h4>
8790 <div class="paragraph">
8791 <p>AltosUI new features:</p>
8792 </div>
8793 <div class="ulist">
8794 <ul>
8795 <li>
8796 <p>The “Descent” tab displays the range to the rocket,
8797 which is a combination of the over-the-ground
8798 distance to the rockets current latitude/longitude
8799 and the height of the rocket. As such, it&#8217;s useful
8800 for knowing how far away the rocket is, but
8801 difficult to use when estimating where the rocket
8802 might eventually land. A new “Ground Distance” field
8803 has been added which displays the distance to a spot
8804 right underneath the rocket.</p>
8805 </li>
8806 </ul>
8807 </div>
8808 <div class="paragraph">
8809 <p>AltosUI fixes:</p>
8810 </div>
8811 <div class="ulist">
8812 <ul>
8813 <li>
8814 <p>Creating a Google Earth file (KML) from on-board
8815 flight data (EEPROM) would generate an empty
8816 file. The code responsible for reading the EEPROM
8817 file wasn&#8217;t ever setting the GPS valid bits, and so
8818 the KML export code thought there was no GPS data in
8819 the file.</p>
8820 </li>
8821 <li>
8822 <p>The “Landed” tab was displaying all values in metric
8823 units, even when AltosUI was configured to display
8824 imperial units. Somehow I just missed this tab when
8825 doing the units stuff.</p>
8826 </li>
8827 <li>
8828 <p>Sensor data wasn&#8217;t being displayed for TeleMini
8829 flight computers in Monitor Idle mode, including
8830 things like battery voltage. The code that picked
8831 which kinds of data to fetch from the flight
8832 computer was missing a check for TeleMini when
8833 deciding whether to fetch the analog sensor data.</p>
8834 </li>
8835 </ul>
8836 </div>
8837 <div style="page-break-after: always;"></div>
8838 </div>
8839 </div>
8840 <div class="sect2">
8841 <h3 id="_release_notes_for_version_1_1_2">H.41. Release Notes for Version 1.1</h3>
8842 <div class="paragraph">
8843 <p>Version 1.1 is a minor release. It provides a few new features
8844 in AltosUI and the AltOS firmware and fixes bugs.</p>
8845 </div>
8846 <div class="sect3">
8847 <h4 id="_altos_38">H.41.1. AltOS</h4>
8848 <div class="paragraph">
8849 <p>AltOS Firmware New Features:</p>
8850 </div>
8851 <div class="ulist">
8852 <ul>
8853 <li>
8854 <p>Add apogee-lockout value. Overrides the apogee
8855 detection logic to prevent incorrect apogee charge
8856 firing.</p>
8857 </li>
8858 <li>
8859 <p>Force the radio frequency to 434.550MHz when the
8860 debug clock pin is connected to ground at boot
8861 time. This provides a way to talk to a TeleMini
8862 which is configured to some unknown frequency.</p>
8863 </li>
8864 <li>
8865 <p>Provide RSSI values for Monitor Idle mode. This
8866 makes it easy to check radio range without needing
8867 to go to flight mode.</p>
8868 </li>
8869 </ul>
8870 </div>
8871 <div class="paragraph">
8872 <p>AltOS Fixes:</p>
8873 </div>
8874 <div class="ulist">
8875 <ul>
8876 <li>
8877 <p>Fix a bug where the data reported in telemetry
8878 packets was from 320ms ago.</p>
8879 </li>
8880 <li>
8881 <p>Fix a bug which caused the old received telemetry
8882 packets to be retransmitted over the USB link when
8883 the radio was turned off and back on.</p>
8884 </li>
8885 </ul>
8886 </div>
8887 </div>
8888 <div class="sect3">
8889 <h4 id="_altosui_12">H.41.2. AltosUI</h4>
8890 <div class="paragraph">
8891 <p>AltosUI New Features:</p>
8892 </div>
8893 <div class="ulist">
8894 <ul>
8895 <li>
8896 <p>Make the look-n-feel configurable, providing a choice from
8897 the available options.</p>
8898 </li>
8899 <li>
8900 <p>Add an 'Age' element to mark how long since a
8901 telemetry packet has been received. Useful to
8902 quickly gauge whether communications with the rocket
8903 are still active.</p>
8904 </li>
8905 <li>
8906 <p>Add 'Configure Ground Station' dialog to set the
8907 radio frequency used by a particular TeleDongle
8908 without having to go through the flight monitor UI.</p>
8909 </li>
8910 <li>
8911 <p>Add configuration for the new apogee-lockout
8912 value. A menu provides a list of reasonable values,
8913 or the value can be set by hand.</p>
8914 </li>
8915 <li>
8916 <p>Add Imperial units mode to present data in feet
8917 instead of meters.</p>
8918 </li>
8919 </ul>
8920 </div>
8921 <div class="paragraph">
8922 <p>AltosUI Fixes:</p>
8923 </div>
8924 <div class="ulist">
8925 <ul>
8926 <li>
8927 <p>Fix a bug that caused GPS ready to happen too
8928 quickly. The software was using every telemetry
8929 packet to signal new GPS data, which caused GPS
8930 ready to be signalled after 10 packets instead of 10
8931 GPS updates.</p>
8932 </li>
8933 <li>
8934 <p>Fix Google Earth data export to work with recent
8935 versions. The google earth file loading code got a
8936 lot pickier, requiring some minor white space
8937 changes in the export code.</p>
8938 </li>
8939 <li>
8940 <p>Changed how flight data are downloaded. Now there&#8217;s
8941 an initial dialog asking which flights to download,
8942 and after that finishes, a second dialog comes up
8943 asking which flights to delete.</p>
8944 </li>
8945 <li>
8946 <p>Re-compute time spent in each state for the flight
8947 graph; this figures out the actual boost and landing
8948 times instead of using the conservative values
8949 provide by the flight electronics. This improves the
8950 accuracy of the boost acceleration and main descent
8951 rate computations.</p>
8952 </li>
8953 <li>
8954 <p>Make AltosUI run on Mac OS Lion. The default Java
8955 heap space was dramatically reduced for this release
8956 causing much of the UI to fail randomly. This most
8957 often affected the satellite mapping download and
8958 displays.</p>
8959 </li>
8960 <li>
8961 <p>Change how data are displayed in the 'table' tab of
8962 the flight monitoring window. This eliminates
8963 entries duplicated from the header and adds both
8964 current altitude and pad altitude, which are useful
8965 in 'Monitor Idle' mode.</p>
8966 </li>
8967 </ul>
8968 </div>
8969 <div style="page-break-after: always;"></div>
8970 </div>
8971 </div>
8972 <div class="sect2">
8973 <h3 id="_release_notes_for_version_1_0_1">H.42. Release Notes for Version 1.0.1</h3>
8974 <div class="paragraph">
8975 <p>Version 1.0.1 is a major release, adding support for the
8976 TeleMini device and lots of new AltosUI features</p>
8977 </div>
8978 <div class="sect3">
8979 <h4 id="_altos_39">H.42.1. AltOS</h4>
8980 <div class="paragraph">
8981 <p>AltOS New Features</p>
8982 </div>
8983 <div class="ulist">
8984 <ul>
8985 <li>
8986 <p>Add TeleMini v1.0 support.</p>
8987 </li>
8988 <li>
8989 <p>Support operation of TeleMetrum with the antenna pointing
8990 aft. Previous firmware versions required the antenna to be
8991 pointing upwards, now there is a configuration option
8992 allowing the antenna to point aft, to aid installation in
8993 some airframes.</p>
8994 </li>
8995 <li>
8996 <p>Ability to disable telemetry. For airframes where an antenna
8997 just isn&#8217;t possible, or where radio transmissions might
8998 cause trouble with other electronics, there&#8217;s a
8999 configuration option to disable all telemetry. Note that the
9000 board will still enable the radio link in idle mode.</p>
9001 </li>
9002 <li>
9003 <p>Arbitrary frequency selection. The radios in Altus Metrum
9004 devices can be programmed to a wide range of frequencies, so
9005 instead of limiting devices to 10 pre-selected 'channels',
9006 the new firmware allows the user to choose any frequency in
9007 the 70cm band. Note that the RF matching circuit on the
9008 boards is tuned for around 435MHz, so frequencies far from
9009 that may reduce the available range.</p>
9010 </li>
9011 </ul>
9012 </div>
9013 <div class="paragraph">
9014 <p>AltOS Fixes</p>
9015 </div>
9016 <div class="ulist">
9017 <ul>
9018 <li>
9019 <p>Change telemetry to be encoded in multiple 32-byte
9020 packets. This enables support for TeleMini and other devices
9021 without requiring further updates to the TeleDongle
9022 firmware.</p>
9023 </li>
9024 <li>
9025 <p>Kalman-filter based flight-tracking. The model based sensor
9026 fusion approach of a Kalman filter means that AltOS now
9027 computes apogee much more accurately than before, generally
9028 within a fraction of a second. In addition, this approach
9029 allows the baro-only TeleMini device to correctly identify
9030 Mach transitions, avoiding the error-prone selection of a
9031 Mach delay.</p>
9032 </li>
9033 </ul>
9034 </div>
9035 </div>
9036 <div class="sect3">
9037 <h4 id="_altosui_application_6">H.42.2. AltosUI Application</h4>
9038 <div class="paragraph">
9039 <p>AltosUI New Features</p>
9040 </div>
9041 <div class="ulist">
9042 <ul>
9043 <li>
9044 <p>Add main/apogee voltage graphs to the data
9045 plot. This provides a visual indication if the
9046 igniters fail before being fired.</p>
9047 </li>
9048 <li>
9049 <p>Scan for altimeter devices by watching the defined
9050 telemetry frequencies. This avoids the problem of
9051 remembering what frequency a device was configured
9052 to use, which is especially important with TeleMini
9053 which does not include a USB connection.</p>
9054 </li>
9055 <li>
9056 <p>Monitor altimeter state in "Idle" mode. This
9057 provides much of the information presented in the
9058 "Pad" dialog from the Monitor Flight command,
9059 monitoring the igniters, battery and GPS status
9060 withing requiring the flight computer to be armed
9061 and ready for flight.</p>
9062 </li>
9063 <li>
9064 <p>Pre-load map images from home. For those launch
9065 sites which don&#8217;t provide free Wi-Fi, this allows
9066 you to download the necessary satellite images
9067 given the location of the launch site. A list of
9068 known launch sites is maintained at altusmetrum.org
9069 which AltosUI downloads to populate a menu; if
9070 you&#8217;ve got a launch site not on that list, please
9071 send the name of it, latitude and longitude along
9072 with a link to the web site of the controlling club
9073 to the altusmetrum mailing list.</p>
9074 </li>
9075 <li>
9076 <p>Flight statistics are now displayed in the Graph
9077 data window. These include max height/speed/accel,
9078 average descent rates and a few other bits of
9079 information. The Graph Data window can now be
9080 reached from the 'Landed' tab in the Monitor Flight
9081 window so you can immediately see the results of a
9082 flight.</p>
9083 </li>
9084 </ul>
9085 </div>
9086 <div class="paragraph">
9087 <p>AltosUI Changes</p>
9088 </div>
9089 <div class="ulist">
9090 <ul>
9091 <li>
9092 <p>Wait for altimeter when using packet mode. Instead
9093 of quicly timing out when trying to initialize a
9094 packet mode configuration connection, AltosUI now
9095 waits indefinitely for the remote device to appear,
9096 providing a cancel button should the user get
9097 bored. This is necessary as the TeleMini can only be
9098 placed in "Idle" mode if AltosUI is polling it.</p>
9099 </li>
9100 </ul>
9101 </div>
9102 <div style="page-break-after: always;"></div>
9103 </div>
9104 </div>
9105 <div class="sect2">
9106 <h3 id="_release_notes_for_version_0_9_2">H.43. Release Notes for Version 0.9.2</h3>
9107 <div class="paragraph">
9108 <p>Version 0.9.2 is an AltosUI bug-fix release, with no firmware
9109 changes.</p>
9110 </div>
9111 <div class="sect3">
9112 <h4 id="_altosui_13">H.43.1. AltosUI</h4>
9113 <div class="paragraph">
9114 <p>AltosUI fixes:</p>
9115 </div>
9116 <div class="ulist">
9117 <ul>
9118 <li>
9119 <p>Fix plotting problems due to missing file in the Mac
9120 OS install image.</p>
9121 </li>
9122 <li>
9123 <p>Always read whole eeprom blocks, mark empty records
9124 invalid, display parsing errors to user.</p>
9125 </li>
9126 <li>
9127 <p>Add software version to Configure AltosUI dialog</p>
9128 </li>
9129 </ul>
9130 </div>
9131 <div style="page-break-after: always;"></div>
9132 </div>
9133 </div>
9134 <div class="sect2">
9135 <h3 id="_release_notes_for_version_0_9">H.44. Release Notes for Version 0.9</h3>
9136 <div class="paragraph">
9137 <p>Version 0.9 adds a few new firmware features and accompanying
9138 AltosUI changes, along with new hardware support.</p>
9139 </div>
9140 <div class="sect3">
9141 <h4 id="_altos_40">H.44.1. AltOS</h4>
9142 <div class="ulist">
9143 <ul>
9144 <li>
9145 <p>Support for TeleMetrum v1.1 hardware. Sources for the flash
9146 memory part used in v1.0 dried up, so v1.1 uses a different
9147 part which required a new driver and support for explicit
9148 flight log erasing.</p>
9149 </li>
9150 <li>
9151 <p>Multiple flight log support. This stores more than one
9152 flight log in the on-board flash memory. It also requires
9153 the user to explicitly erase flights so that you won&#8217;t lose
9154 flight logs just because you fly the same board twice in one
9155 day.</p>
9156 </li>
9157 <li>
9158 <p>Telemetry support for devices with serial number &gt;= 256.
9159 Previous versions used a telemetry packet format that
9160 provided only 8 bits for the device serial number. This
9161 change requires that both ends of the telemetry link be
9162 running the 0.9 firmware or they will not communicate.</p>
9163 </li>
9164 </ul>
9165 </div>
9166 </div>
9167 <div class="sect3">
9168 <h4 id="_altosui_application_7">H.44.2. AltosUI Application</h4>
9169 <div class="ulist">
9170 <ul>
9171 <li>
9172 <p>Support for telemetry format changes.</p>
9173 </li>
9174 <li>
9175 <p>Support for multiple flight logs.</p>
9176 </li>
9177 </ul>
9178 </div>
9179 <div style="page-break-after: always;"></div>
9180 </div>
9181 </div>
9182 <div class="sect2">
9183 <h3 id="_release_notes_for_version_0_8">H.45. Release Notes for Version 0.8</h3>
9184 <div class="paragraph">
9185 <p>Version 0.8 offers a major upgrade in the AltosUI
9186 interface.</p>
9187 </div>
9188 <div class="sect3">
9189 <h4 id="_altosui_application_8">H.45.1. AltosUI Application:</h4>
9190 <div class="ulist">
9191 <ul>
9192 <li>
9193 <p>Post-flight graphing tool. This lets you explore the
9194 behaviour of your rocket after flight with a scroll-able and
9195 zoom-able chart showing the altitude, speed and acceleration
9196 of the airframe along with events recorded by the flight
9197 computer. You can export graphs to PNG files, or print them
9198 directly.</p>
9199 </li>
9200 <li>
9201 <p>Real-time moving map which overlays the in-progress flight
9202 on satellite imagery fetched from Google Maps. This lets you
9203 see in pictures where your rocket has landed, allowing you
9204 to plan recovery activities more accurately.</p>
9205 </li>
9206 <li>
9207 <p>Wireless recovery system testing. Prep your rocket for
9208 flight and test fire the deployment charges to make sure
9209 things work as expected. All without threading wires through
9210 holes in your airframe.</p>
9211 </li>
9212 <li>
9213 <p>Optimized flight status displays. Each flight state now has
9214 it&#8217;s own custom 'tab' in the flight monitoring window so you
9215 can focus on the most important details. Pre-flight, the
9216 system shows a set of red/green status indicators for
9217 battery voltage, apogee/main igniter continutity and GPS
9218 reception. Wait until they&#8217;re all green and your rocket is
9219 ready for flight. There are also tabs for ascent, descent
9220 and landing along with the original tabular view of the
9221 data.</p>
9222 </li>
9223 <li>
9224 <p>Monitor multiple flights simultaneously. If you have more
9225 than one TeleDongle, you can monitor a flight with each one
9226 on the same computer.</p>
9227 </li>
9228 <li>
9229 <p>Automatic flight monitoring at startup. Plug TeleDongle into
9230 the machine before starting AltosUI and it will
9231 automatically connect to it and prepare to monitor a flight.</p>
9232 </li>
9233 <li>
9234 <p>Exports Google Earth flight tracks. Using the Keyhole Markup
9235 Language (.kml) file format, this provides a 3D view of your
9236 rocket flight through the Google Earth program.</p>
9237 </li>
9238 </ul>
9239 </div>
9240 <div style="page-break-after: always;"></div>
9241 </div>
9242 </div>
9243 <div class="sect2">
9244 <h3 id="_release_notes_for_version_0_7_1">H.46. Release Notes for Version 0.7.1</h3>
9245 <div class="paragraph">
9246 <p>Version 0.7.1 is the first release containing our new
9247 cross-platform Java-based user interface.</p>
9248 </div>
9249 <div class="sect3">
9250 <h4 id="_altosui_application_9">H.46.1. AltosUI Application</h4>
9251 <div class="ulist">
9252 <ul>
9253 <li>
9254 <p>Receive and log telemetry from a connected TeleDongle
9255 device. All data received is saved to log files named with
9256 the current date and the connected rocket serial and flight
9257 numbers. There is no mode in which telemetry data will not
9258 be saved.</p>
9259 </li>
9260 <li>
9261 <p>Download logged data from TeleMetrum devices, either through
9262 a direct USB connection or over the air through a TeleDongle
9263 device.</p>
9264 </li>
9265 <li>
9266 <p>Configure a TeleMetrum device, setting the radio channel,
9267 callsign, apogee delay and main deploy height. This can be
9268 done through either a USB connection or over a radio link
9269 via a TeleDongle device.</p>
9270 </li>
9271 <li>
9272 <p>Replay a flight in real-time. This takes a saved telemetry
9273 log or eeprom download and replays it through the user
9274 interface so you can relive your favorite rocket flights.</p>
9275 </li>
9276 <li>
9277 <p>Reprogram Altus Metrum devices. Using an Altus Metrum device
9278 connected via USB, another Altus Metrum device can be
9279 reprogrammed using the supplied programming cable between
9280 the two devices.</p>
9281 </li>
9282 <li>
9283 <p>Export Flight data to a comma-separated-values file. This
9284 takes either telemetry or on-board flight data and generates
9285 data suitable for use in external applications. All data is
9286 exported using standard units so that no device-specific
9287 knowledge is needed to handle the data.</p>
9288 </li>
9289 <li>
9290 <p>Speak to you during the flight. Instead of spending the
9291 flight hunched over your laptop looking at the screen, enjoy
9292 the view while the computer tells you what’s going on up
9293 there. During ascent, you hear the current flight state and
9294 altitude information. During descent, you get azimuth,
9295 elevation and range information to try and help you find
9296 your rocket in the air. Once on the ground, the direction
9297 and distance are reported.</p>
9298 </li>
9299 </ul>
9300 </div>
9301 </div>
9302 </div>
9303 </div>
9304 </div>
9305 </div>
9306 <div id="footer">
9307 <div id="footer-text">
9308 Version v1.9.13<br>
9309 Last updated 2023-01-19 23:18:22 -0700
9310 </div>
9311 </div>
9312 </body>
9313 </html>