]> git.gag.com Git - web/altusmetrum/blob - AltOS/doc/telegps.html
trivial change to test updating
[web/altusmetrum] / AltOS / doc / telegps.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.23">
8 <meta name="author" content="Keith Packard, Bdale Garbee">
9 <meta name="copyright" content="Bdale Garbee and Keith Packard 2022">
10 <title>TeleGPS Owner&#8217;s Manual</title>
11 <link rel="stylesheet" href="./am.css">
12 </head>
13 <body class="book">
14 <div id="header">
15 <h1>TeleGPS Owner&#8217;s Manual</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="revnumber">version v1.9.21,</span>
22 <span id="revdate">28 Apr 2025</span>
23 </div>
24 <div id="toc" class="toc">
25 <div id="toctitle">Table of Contents</div>
26 <ul class="sectlevel1">
27 <li><a href="#_license">License</a></li>
28 <li><a href="#_acknowledgments">Acknowledgments</a></li>
29 <li><a href="#_telegps_quick_start_guide">1. TeleGPS Quick Start Guide</a></li>
30 <li><a href="#_using_telegps_hardware">2. Using TeleGPS Hardware</a>
31 <ul class="sectlevel2">
32 <li><a href="#_hooking_up_lithium_polymer_batteries">2.1. Hooking Up Lithium Polymer Batteries</a></li>
33 <li><a href="#_on_board_data_recording">2.2. On-board Data Recording</a></li>
34 <li><a href="#_leds">2.3. LEDs</a></li>
35 <li><a href="#_installation">2.4. Installation</a></li>
36 </ul>
37 </li>
38 <li><a href="#_telegps_application">3. TeleGPS Application</a>
39 <ul class="sectlevel2">
40 <li><a href="#_telemetry_monitoring">3.1. Telemetry Monitoring</a></li>
41 <li><a href="#_telegps_menus">3.2. TeleGPS Menus</a></li>
42 <li><a href="#_graph_data">3.3. Graph Data</a></li>
43 <li><a href="#_export_data">3.4. Export Data</a></li>
44 <li><a href="#_load_maps">3.5. Load Maps</a></li>
45 <li><a href="#_preferences">3.6. Preferences</a></li>
46 <li><a href="#_close">3.7. Close</a></li>
47 <li><a href="#_exit">3.8. Exit</a></li>
48 <li><a href="#_connect_device">3.9. Connect Device</a></li>
49 <li><a href="#_disconnect">3.10. Disconnect</a></li>
50 <li><a href="#_scan_channels">3.11. Scan Channels</a></li>
51 <li><a href="#_download_data">3.12. Download Data</a></li>
52 <li><a href="#_configure_device">3.13. Configure Device</a></li>
53 <li><a href="#_flash_device">3.14. Flash Device</a></li>
54 </ul>
55 </li>
56 <li><a href="#_telegps_system_operation">Appendix A: TeleGPS System Operation</a>
57 <ul class="sectlevel2">
58 <li><a href="#_gfsk_telemetry">A.1. GFSK Telemetry</a></li>
59 <li><a href="#_aprs">A.2. APRS</a></li>
60 <li><a href="#_configurable_parameters">A.3. Configurable Parameters</a></li>
61 </ul>
62 </li>
63 <li><a href="#_handling_precautions">Appendix B: Handling Precautions</a></li>
64 <li><a href="#_technical_information">Appendix C: Technical Information</a>
65 <ul class="sectlevel2">
66 <li><a href="#_gps_receiver">C.1. GPS Receiver</a></li>
67 <li><a href="#_70cm_transmitter">C.2. 70cm Transmitter</a></li>
68 <li><a href="#_micro_controller">C.3. Micro-controller</a></li>
69 <li><a href="#_lithium_polymer_battery">C.4. Lithium Polymer Battery</a></li>
70 <li><a href="#_mechanical_considerations">C.5. Mechanical Considerations</a></li>
71 <li><a href="#_on_board_data_storage">C.6. On-board data storage</a></li>
72 </ul>
73 </li>
74 <li><a href="#_updating_device_firmware">Appendix D: Updating Device Firmware</a>
75 <ul class="sectlevel2">
76 <li><a href="#_updating_telegps_firmware">D.1. Updating TeleGPS Firmware</a></li>
77 </ul>
78 </li>
79 <li><a href="#_release_notes">Appendix E: Release Notes</a>
80 <ul class="sectlevel2">
81 <li><a href="#_release_notes_for_version_1_9_21">E.1. Release Notes for Version 1.9.21</a></li>
82 <li><a href="#_release_notes_for_version_1_9_20">E.2. Release Notes for Version 1.9.20</a></li>
83 <li><a href="#_release_notes_for_version_1_9_19">E.3. Release Notes for Version 1.9.19</a></li>
84 <li><a href="#_release_notes_for_version_1_9_18">E.4. Release Notes for Version 1.9.18</a></li>
85 <li><a href="#_release_notes_for_version_1_9_17">E.5. Release Notes for Version 1.9.17</a></li>
86 <li><a href="#_release_notes_for_version_1_9_16">E.6. Release Notes for Version 1.9.16</a></li>
87 <li><a href="#_release_notes_for_version_1_9_15">E.7. Release Notes for Version 1.9.15</a></li>
88 <li><a href="#_release_notes_for_version_1_9_14">E.8. Release Notes for Version 1.9.14</a></li>
89 <li><a href="#_release_notes_for_version_1_9_13">E.9. Release Notes for Version 1.9.13</a></li>
90 <li><a href="#_release_notes_for_version_1_9_12">E.10. Release Notes for Version 1.9.12</a></li>
91 <li><a href="#_release_notes_for_version_1_9_11">E.11. Release Notes for Version 1.9.11</a></li>
92 <li><a href="#_release_notes_for_version_1_9_10">E.12. Release Notes for Version 1.9.10</a></li>
93 <li><a href="#_release_notes_for_version_1_9_9">E.13. Release Notes for Version 1.9.9</a></li>
94 <li><a href="#_release_notes_for_version_1_9_8">E.14. Release Notes for Version 1.9.8</a></li>
95 <li><a href="#_release_notes_for_version_1_9_7">E.15. Release Notes for Version 1.9.7</a></li>
96 <li><a href="#_release_notes_for_version_1_9_6">E.16. Release Notes for Version 1.9.6</a></li>
97 <li><a href="#_release_notes_for_version_1_9_5">E.17. Release Notes for Version 1.9.5</a></li>
98 <li><a href="#_release_notes_for_version_1_9_4">E.18. Release Notes for Version 1.9.4</a></li>
99 <li><a href="#_release_notes_for_version_1_9_3">E.19. Release Notes for Version 1.9.3</a></li>
100 <li><a href="#_release_notes_for_version_1_9_1">E.20. Release Notes for Version 1.9.1</a></li>
101 <li><a href="#_release_notes_for_version_1_9">E.21. Release Notes for Version 1.9</a></li>
102 <li><a href="#_release_notes_for_version_1_8_7">E.22. Release Notes for Version 1.8.7</a></li>
103 <li><a href="#_release_notes_for_version_1_8_6">E.23. Release Notes for Version 1.8.6</a></li>
104 <li><a href="#_release_notes_for_version_1_8_5">E.24. Release Notes for Version 1.8.5</a></li>
105 <li><a href="#_release_notes_for_version_1_8_4">E.25. Release Notes for Version 1.8.4</a></li>
106 <li><a href="#_release_notes_for_version_1_8_3">E.26. Release Notes for Version 1.8.3</a></li>
107 <li><a href="#_release_notes_for_version_1_8_2">E.27. Release Notes for Version 1.8.2</a></li>
108 <li><a href="#_release_notes_for_version_1_8_1">E.28. Release Notes for Version 1.8.1</a></li>
109 <li><a href="#_release_notes_for_version_1_8">E.29. Release Notes for Version 1.8</a></li>
110 <li><a href="#_release_notes_for_version_1_7">E.30. Release Notes for Version 1.7</a></li>
111 <li><a href="#_release_notes_for_version_1_6_8">E.31. Release Notes for Version 1.6.8</a></li>
112 <li><a href="#_release_notes_for_version_1_6_5">E.32. Release Notes for Version 1.6.5</a></li>
113 <li><a href="#_release_notes_for_version_1_6_4">E.33. Release Notes for Version 1.6.4</a></li>
114 <li><a href="#_release_notes_for_version_1_6_3">E.34. Release Notes for Version 1.6.3</a></li>
115 <li><a href="#_release_notes_for_version_1_6_2">E.35. Release Notes for Version 1.6.2</a></li>
116 <li><a href="#_release_notes_for_version_1_6_1">E.36. Release Notes for Version 1.6.1</a></li>
117 <li><a href="#_release_notes_for_version_1_6">E.37. Release Notes for Version 1.6</a></li>
118 <li><a href="#_release_notes_for_version_1_5">E.38. Release Notes for Version 1.5</a></li>
119 <li><a href="#_release_notes_for_version_1_4_2">E.39. Release Notes for Version 1.4.2</a></li>
120 <li><a href="#_release_notes_for_version_1_4_1">E.40. Release Notes for Version 1.4.1</a></li>
121 <li><a href="#_release_notes_for_version_1_4">E.41. Release Notes for Version 1.4</a></li>
122 </ul>
123 </li>
124 </ul>
125 </div>
126 </div>
127 <div id="content">
128 <div id="preamble">
129 <div class="sectionbody">
130 <div id="logo" class="imageblock">
131 <div class="content">
132 <a class="image" href="https://altusmetrum.org"><img src="altusmetrum-oneline.svg" alt="Altus Metrum"></a>
133 </div>
134 </div>
135 </div>
136 </div>
137 <div class="sect1">
138 <h2 id="_license">License</h2>
139 <div class="sectionbody">
140 <div class="paragraph">
141 <p>Copyright © 2025 Bdale Garbee and Keith Packard</p>
142 </div>
143 <div class="paragraph">
144 <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>
145 </div>
146 </div>
147 </div>
148 <div class="sect1">
149 <h2 id="_acknowledgments">Acknowledgments</h2>
150 <div class="sectionbody">
151 <div class="paragraph">
152 <p>Thanks to Anthony (AJ) Towns for major contributions including
153 the TeleGPS graphing and site map code and associated documentation.
154 Free software means that our customers and friends can become our
155 collaborators, and we certainly appreciate this level of
156 contribution!</p>
157 </div>
158 <div class="paragraph">
159 <p>Have fun using these products, and we hope to meet all of you
160 out on the rocket flight line somewhere.</p>
161 </div>
162 <div class="verseblock">
163 <pre class="content">Bdale Garbee, KB0G
164 NAR #87103, TRA #12201</pre>
165 </div>
166 <div class="verseblock">
167 <pre class="content">Keith Packard, K7WQ
168 NAR #88757, TRA #12200</pre>
169 </div>
170 </div>
171 </div>
172 <div class="sect1">
173 <h2 id="_telegps_quick_start_guide">1. TeleGPS Quick Start Guide</h2>
174 <div class="sectionbody">
175 <div class="paragraph">
176 <p>TeleGPS is designed to be easy to use. Requiring no external
177 components, flying takes just a few steps.</p>
178 </div>
179 <div class="olist arabic">
180 <ol class="arabic">
181 <li>
182 <p>First, download and install the software from
183 <a href="http://altusmetrum.org/AltOS" class="bare">http://altusmetrum.org/AltOS</a>. This will make sure that
184 you have the right device drivers installed.</p>
185 </li>
186 <li>
187 <p>Next, plug in the battery and USB cable and connect TeleGPS to
188 your computer. This will charge the battery and allow you to
189 configure the device.</p>
190 </li>
191 <li>
192 <p>Start the TeleGPS application and set the callsign and frequency
193 on your TeleGPS device; refer to <a href="#_configure_device">Configure Device</a> for instructions.</p>
194 </li>
195 <li>
196 <p>Unplug TeleGPS when the battery charger light goes green. This
197 will enable the radio and logging portions of the TeleGPS
198 firmware.</p>
199 </li>
200 <li>
201 <p>Connect TeleDongle to your computer and start TeleGPS or start
202 AltosDroid on your android device and connect to TeleBT. Set the
203 frequency to match the TeleGPS and you should be receiving telemetry.</p>
204 </li>
205 </ol>
206 </div>
207 </div>
208 </div>
209 <div class="sect1">
210 <h2 id="_using_telegps_hardware">2. Using TeleGPS Hardware</h2>
211 <div class="sectionbody">
212 <div class="sect2">
213 <h3 id="_hooking_up_lithium_polymer_batteries">2.1. Hooking Up Lithium Polymer Batteries</h3>
214 <div class="paragraph">
215 <p>TeleGPS has a two pin JST PH series connector to connect up
216 a single-cell Lithium Polymer cell (3.7V nominal). You can
217 purchase matching batteries from the Altus Metrum store, or
218 other vendors, or you can make your own. Pin 1 of the
219 connector is positive, pin 2 is negative. Spark Fun sells a
220 cable with the connector attached, which they call a
221 <a href="https://www.sparkfun.com/products/9914">JST Jumper 2 Wire Assembly</a></p>
222 </div>
223 <div class="admonitionblock warning">
224 <table>
225 <tr>
226 <td class="icon">
227 <div class="title">Warning</div>
228 </td>
229 <td class="content">
230 Many RC vendors also sell lithium polymer batteries with
231 this same connector. All that we have found use the opposite
232 polarity, and if you use them that way, you will damage or
233 destroy TeleGPS.
234 </td>
235 </tr>
236 </table>
237 </div>
238 </div>
239 <div class="sect2">
240 <h3 id="_on_board_data_recording">2.2. On-board Data Recording</h3>
241 <div class="paragraph">
242 <p>TeleGPS logs GPS data at a user-configurable
243 rate. Data are logged to a 2MB on-board flash memory
244 part, which can be partitioned into several
245 equal-sized blocks, one for each flight. 64kB of this
246 storage are reserved to hold configuration data,
247 leaving 1984kB for flight data.</p>
248 </div>
249 <div class="paragraph">
250 <p>The on-board flash is partitioned into separate flight
251 logs, each of a fixed maximum size. Increase the
252 maximum size of each log and you reduce the number of
253 flights that can be stored. Decrease the size and you
254 can store more flights.</p>
255 </div>
256 <div class="paragraph">
257 <p>To compute the amount of space needed for a single
258 log, you can divide the expected time (in seconds) by
259 the sample period (by default, 1 second per sample)
260 and then multiply the result by 32 bytes per
261 sample. For instance, a sample period of 1 second and
262 a flight lasting one hour will take 32 * 3600 = 115200
263 bytes. TeleGPS does try to reduce log space used by
264 not recording position information when it isn&#8217;t
265 moving, so actual space consumed may be less than
266 this.</p>
267 </div>
268 <div class="paragraph">
269 <p>The default size allows for four flights of 496kB
270 each, which provides over four hours of logging at 1
271 sample per second.</p>
272 </div>
273 <div class="paragraph">
274 <p>TeleGPS will not overwrite existing flight data, so be
275 sure to download flight data and erase it from the
276 onboard flash before it fills up. TeleGPS will still
277 report telemetry even if memory is full, so the only
278 thing you will lose is the on-board data log.</p>
279 </div>
280 </div>
281 <div class="sect2">
282 <h3 id="_leds">2.3. LEDs</h3>
283 <div class="paragraph">
284 <p>TeleGPS v1.0 has a dual greed/red LED along the edge
285 towards the USB connector end of the board. This
286 indicates battery charging status while connected to
287 power over USB. When the red LED is lit, the battery
288 is charging. Once the battery is fully charged, the
289 red LED goes out and the green LED turns on. If both
290 LEDs are lit, something is probably wrong with the battery.</p>
291 </div>
292 <div class="paragraph">
293 <p>TeleGPS v2.0 has the same green/red battery charging
294 status LED and adds another green LED along the same
295 edge, towards end of the board with the 70cm
296 antenna. This green LED indicates GPS lock status — it
297 blinks once every three seconds when the GPS receiver
298 is locked and tracking position.</p>
299 </div>
300 </div>
301 <div class="sect2">
302 <h3 id="_installation">2.4. Installation</h3>
303 <div class="paragraph">
304 <p>The battery connectors are a standard 2-pin JST
305 connector and match batteries sold by Spark Fun. These
306 batteries are single-cell Lithium Polymer batteries
307 that nominally provide 3.7 volts.  Other vendors sell
308 similar batteries for RC aircraft using mating
309 connectors, however the polarity for those is
310 generally reversed from the batteries used by Altus
311 Metrum products. In particular, the Tenergy batteries
312 supplied for use in Featherweight flight computers are
313 not compatible with Altus Metrum flight computers or
314 battery chargers.</p>
315 </div>
316 <div class="admonitionblock warning">
317 <table>
318 <tr>
319 <td class="icon">
320 <div class="title">Warning</div>
321 </td>
322 <td class="content">
323 Check polarity and voltage before connecting any
324 battery not purchased from Altus Metrum or Spark
325 Fun.
326 </td>
327 </tr>
328 </table>
329 </div>
330 <div class="paragraph">
331 <p>TeleGPS uses an integrate GPS patch antenna and won&#8217;t
332 receive GPS signals if installed inside a metal or
333 carbon fiber compartment. Test GPS reception and
334 telemetry transmission with the system installed and
335 all other electronics powered up to verify signal
336 reception and make sure there isn&#8217;t any interference
337 from other systems.</p>
338 </div>
339 </div>
340 </div>
341 </div>
342 <div class="sect1">
343 <h2 id="_telegps_application">3. TeleGPS Application</h2>
344 <div class="sectionbody">
345 <div class="paragraph">
346 <p>The TeleGPS application provides a graphical user interface for
347 interacting with the Altus Metrum product family. TeleGPS can
348 monitor telemetry data, configure devices and many other
349 tasks. The primary interface window is for displaying data
350 received over the telemetry link. There are additional
351 tasks available from the main window menu bar.</p>
352 </div>
353 <div class="sect2">
354 <h3 id="_telemetry_monitoring">3.1. Telemetry Monitoring</h3>
355 <div class="paragraph">
356 <p>This is the window brought up when you start the
357 application. If you have a TeleDongle device connected
358 to the computer, it will automatically be selected for
359 telemetry monitoring</p>
360 </div>
361 <div class="paragraph">
362 <p>All telemetry data received are automatically recorded
363 in suitable log files. The name of the files includes
364 the current date and TeleGPS serial and flight
365 numbers.</p>
366 </div>
367 <div class="paragraph">
368 <p>The radio frequency being monitored by the TeleDongle
369 device is displayed at the top of the window. You can
370 configure the frequency by clicking on the frequency
371 box and selecting the desired frequency. The TeleGPS
372 application remembers the last frequency selected for
373 each TeleDongle and selects that automatically the
374 next time you use that device.</p>
375 </div>
376 <div class="paragraph">
377 <p>Below the TeleDongle frequency selector, the window
378 contains a few significant pieces of information about
379 the altimeter providing the telemetry data stream:</p>
380 </div>
381 <div class="ulist">
382 <ul>
383 <li>
384 <p>The configured call-sign</p>
385 </li>
386 <li>
387 <p>The device serial number</p>
388 </li>
389 <li>
390 <p>The flight number. TeleGPS remembers how many times
391 it has flown.</p>
392 </li>
393 <li>
394 <p>The Received Signal Strength Indicator value. This
395 lets you know how strong a signal TeleDongle is
396 receiving. The radio inside TeleDongle operates down
397 to about -100dBm; weaker signals may not be
398 receivable. The packet link uses error detection and
399 correction techniques which prevent incorrect data
400 from being reported.</p>
401 </li>
402 <li>
403 <p>The age of the displayed data, in seconds since the
404 last successfully received telemetry packet.  In
405 normal operation this will stay in the low single
406 digits.  If the number starts counting up, then you
407 are no longer receiving data over the radio link
408 from the flight computer.</p>
409 </li>
410 </ul>
411 </div>
412 <div class="paragraph">
413 <p>Finally, the largest portion of the window contains a set of
414 tabs, each of which contain some information about the TeleGPS
415 board. The final 'table' tab displays many of the raw telemetry
416 values in one place in a spreadsheet-like format.</p>
417 </div>
418 <div class="sect3">
419 <h4 id="_map">3.1.1. Map</h4>
420 <div class="paragraph">
421 <p>The Map tab shows the TeleGPS track over time
422 on top of map data making it easy to locate
423 the device.</p>
424 </div>
425 <div class="imageblock">
426 <div class="content">
427 <img src="telegps-map.png" alt="telegps map" width="400">
428 </div>
429 <div class="title">Figure 1. TeleGPS Map View</div>
430 </div>
431 <div class="paragraph">
432 <p>The map&#8217;s default scale is approximately 3m
433 (10ft) per pixel. The map can be dragged using
434 the left mouse button. The map will attempt to
435 keep the rocket roughly centered while data is
436 being received.</p>
437 </div>
438 <div class="paragraph">
439 <p>You can adjust the style of map and the zoom
440 level with buttons on the right side of the
441 map window. You can draw a line on the map by
442 moving the mouse over the map with a button
443 other than the left one pressed, or by
444 pressing the left button while also holding
445 down the shift key. The length of the line in
446 real-world units will be shown at the start of
447 the line.</p>
448 </div>
449 <div class="paragraph">
450 <p>Images are fetched automatically via the
451 Google Maps Static API, and cached on disk for
452 reuse. If map images cannot be downloaded, the
453 rocket&#8217;s path will be traced on a dark gray
454 background instead.</p>
455 </div>
456 <div class="paragraph">
457 <p>You can pre-load images for your favorite
458 launch sites before you leave home; check out
459 <a href="#_load_maps">Load Maps</a>.</p>
460 </div>
461 </div>
462 <div class="sect3">
463 <h4 id="_location">3.1.2. Location</h4>
464 <div class="paragraph">
465 <p>The Location tab shows the raw GPS data
466 received from TeleGPS.</p>
467 </div>
468 <div class="imageblock">
469 <div class="content">
470 <img src="telegps-location.png" alt="telegps location" width="400">
471 </div>
472 <div class="title">Figure 2. TeleGPS Location View</div>
473 </div>
474 </div>
475 <div class="sect3">
476 <h4 id="_status">3.1.3. Status</h4>
477 <div class="paragraph">
478 <p>The Status tab shows data relative to the
479 location of TeleGPS when the application first
480 received telemetry from it.</p>
481 </div>
482 <div class="imageblock">
483 <div class="content">
484 <img src="telegps-status.png" alt="telegps status" width="400">
485 </div>
486 <div class="title">Figure 3. TeleGPS Status View</div>
487 </div>
488 </div>
489 <div class="sect3">
490 <h4 id="_table">3.1.4. Table</h4>
491 <div class="paragraph">
492 <p>The Table tab shows detailed information about
493 the GPS receiver</p>
494 </div>
495 <div class="imageblock">
496 <div class="content">
497 <img src="telegps-table.png" alt="telegps table" width="400">
498 </div>
499 <div class="title">Figure 4. TeleGPS Information Table</div>
500 </div>
501 </div>
502 </div>
503 <div class="sect2">
504 <h3 id="_telegps_menus">3.2. TeleGPS Menus</h3>
505 <div class="paragraph">
506 <p>TeleGPS has three or four menus at the top of
507 the window:</p>
508 </div>
509 <div class="dlist">
510 <dl>
511 <dt class="hdlist1">File</dt>
512 <dd>
513 <p>New Window, Graph Data, Export Data, Load Maps,
514 Preferences, Close and Exit</p>
515 </dd>
516 <dt class="hdlist1">Monitor</dt>
517 <dd>
518 <p>Connect Device, Disconnect and Scan Channels</p>
519 </dd>
520 <dt class="hdlist1">Device</dt>
521 <dd>
522 <p>Download Data, Configure Device and Flash Device</p>
523 </dd>
524 <dt class="hdlist1">Frequency</dt>
525 <dd>
526 <p>This shows the current monitoring frequency with a
527 drop-down menu listing other configured
528 frequencies. You can change the set of frequencies
529 shown here from the Preferences dialog. This menu is
530 only shown when the TeleGPS application is connected
531 to a TeleDongle or TeleBT device.</p>
532 </dd>
533 </dl>
534 </div>
535 <div class="sect3">
536 <h4 id="_new_window">3.2.1. New Window</h4>
537 <div class="paragraph">
538 <p>This creates another telemetry monitoring window, in case
539 you have multiple TeleDongle devices connected to the
540 computer.</p>
541 </div>
542 </div>
543 </div>
544 <div class="sect2">
545 <h3 id="_graph_data">3.3. Graph Data</h3>
546 <div class="paragraph">
547 <p>The Graph tab shows a plot of the the GPS data
548 collected. The X axis is time in seconds; there are a
549 variety of Y axes available for different kinds of
550 data. This window also allows you to see some
551 statistics computed from the data, and an overall map
552 of the entire data record.</p>
553 </div>
554 <div class="sect3">
555 <h4 id="_data_graph">3.3.1. Data Graph</h4>
556 <div class="imageblock">
557 <div class="content">
558 <img src="telegps-graph-graph.png" alt="telegps graph graph" width="400">
559 </div>
560 <div class="title">Figure 5. TeleGPS Graph</div>
561 </div>
562 </div>
563 <div class="sect3">
564 <h4 id="_graph_configuration">3.3.2. Graph Configuration</h4>
565 <div class="imageblock">
566 <div class="content">
567 <img src="telegps-graph-configure.png" alt="telegps graph configure" width="400">
568 </div>
569 <div class="title">Figure 6. TeleGPS Graph Configuration</div>
570 </div>
571 <div class="paragraph">
572 <p>This selects which graph elements to show, and, at the
573 bottom, lets you switch between metric and imperial
574 units</p>
575 </div>
576 </div>
577 <div class="sect3">
578 <h4 id="_statistics">3.3.3. Statistics</h4>
579 <div class="imageblock">
580 <div class="content">
581 <img src="telegps-graph-stats.png" alt="telegps graph stats" width="400">
582 </div>
583 <div class="title">Figure 7. TeleGPS Statistics</div>
584 </div>
585 <div class="paragraph">
586 <p>Shows overall data computed from the flight.</p>
587 </div>
588 </div>
589 <div class="sect3">
590 <h4 id="_map_2">3.3.4. Map</h4>
591 <div class="imageblock">
592 <div class="content">
593 <img src="telegps-graph-map.png" alt="telegps graph map" width="450">
594 </div>
595 <div class="title">Figure 8. TeleGPS Map</div>
596 </div>
597 <div class="paragraph">
598 <p>Shows a map of the area overlaid with the GPS track. As with
599 the telemetry monitoring window, you can select the style
600 of map and zoom level using buttons along the side;
601 you can scroll the map by dragging within the map pressing
602 the left button and you can draw a line to measure
603 distances using either the left button with the shift key,
604 or any other button.</p>
605 </div>
606 </div>
607 </div>
608 <div class="sect2">
609 <h3 id="_export_data">3.4. Export Data</h3>
610 <div class="paragraph">
611 <p>This tool takes the raw data files and makes them
612 available for external analysis. When you select this
613 button, you are prompted to select a data file, which
614 can be either a .eeprom or .telem.  The .eeprom files
615 contain higher resolution and more continuous data,
616 while .telem files contain receiver signal strength
617 information.  Next, a second dialog appears which is
618 used to select where to write the resulting file. It
619 has a selector to choose between CSV and KML file
620 formats.</p>
621 </div>
622 <div class="sect3">
623 <h4 id="_comma_separated_value_format">3.4.1. Comma Separated Value Format</h4>
624 <div class="paragraph">
625 <p>This is a text file containing the data in a
626 form suitable for import into a spreadsheet or
627 other external data analysis tool. The first
628 few lines of the file contain the version and
629 configuration information from TeleGPS, then
630 there is a single header line which labels all
631 of the fields. All of these lines start with a
632 '#' character which many tools can be
633 configured to skip over.</p>
634 </div>
635 <div class="paragraph">
636 <p>The remaining lines of the file contain the
637 data, with each field separated by a comma and
638 at least one space. All of the sensor values
639 are converted to standard units, with the
640 barometric data reported in both pressure,
641 altitude and height above pad units.</p>
642 </div>
643 </div>
644 <div class="sect3">
645 <h4 id="_keyhole_markup_language_for_google_earth">3.4.2. Keyhole Markup Language (for Google Earth)</h4>
646 <div class="paragraph">
647 <p>This is the format used by Google Earth to provide an overlay
648 within that application. With this, you can use Google Earth to
649 see the whole path in 3D.</p>
650 </div>
651 </div>
652 </div>
653 <div class="sect2">
654 <h3 id="_load_maps">3.5. Load Maps</h3>
655 <div class="imageblock">
656 <div class="content">
657 <img src="load-maps.png" alt="load maps" width="500">
658 </div>
659 <div class="title">Figure 9. Load Maps Window</div>
660 </div>
661 <div class="paragraph">
662 <p>Before heading out to a new launch site, you can use
663 this to load satellite images in case you don&#8217;t have
664 internet connectivity at the site.  Try not to wait
665 until the last minute, though, particularly if you&#8217;re
666 heading to a major launch.  If too many people are
667 all trying to download map data at once, Google may
668 limit access until the next day.</p>
669 </div>
670 <div class="paragraph">
671 <p>There&#8217;s a drop-down menu of launch sites we know
672 about; if your favorites aren&#8217;t there, please let us
673 know the lat/lon and name of the site. The contents of
674 this list are actually downloaded from our server at
675 run-time, so as new sites are sent in, they&#8217;ll get
676 automatically added to this list.  If the launch site
677 isn&#8217;t in the list, you can manually enter the lat/lon
678 values</p>
679 </div>
680 <div class="paragraph">
681 <p>There are four different kinds of maps you can view;
682 you can select which to download by selecting as many
683 as you like from the available types:</p>
684 </div>
685 <div class="dlist">
686 <dl>
687 <dt class="hdlist1">Hybrid</dt>
688 <dd>
689 <p>A combination of satellite imagery and road data. This
690 is the default view.</p>
691 </dd>
692 <dt class="hdlist1">Satellite</dt>
693 <dd>
694 <p>Just the satellite imagery without any annotation.</p>
695 </dd>
696 <dt class="hdlist1">Roadmap</dt>
697 <dd>
698 <p>Roads, political boundaries and a few geographic
699 features.</p>
700 </dd>
701 <dt class="hdlist1">Terrain</dt>
702 <dd>
703 <p>Contour intervals and shading that show hills and
704 valleys.</p>
705 </dd>
706 </dl>
707 </div>
708 <div class="paragraph">
709 <p>You can specify the range of zoom levels to download;
710 smaller numbers show more area with less
711 resolution. The default level, 0, shows about
712 3m/pixel. One zoom level change doubles or halves that
713 number. Larger zoom levels show more detail, smaller
714 zoom levels less.</p>
715 </div>
716 <div class="paragraph">
717 <p>The Map Radius value sets how large an area around the
718 center point to download. Select a value large enough
719 to cover any plausible flight from that site. Be aware
720 that loading a large area with a high maximum zoom
721 level can attempt to download a lot of data. Loading
722 hybrid maps with a 10km radius at a minimum zoom of -2
723 and a maximum zoom of 2 consumes about 120MB of
724 space. Terrain and road maps consume about 1/10 as
725 much space as satellite or hybrid maps.</p>
726 </div>
727 <div class="paragraph">
728 <p>Clicking the 'Load Map' button will fetch images from
729 Google Maps; note that Google limits how many images
730 you can fetch at once, so if you load more than one
731 launch site, you may get some gray areas in the map
732 which indicate that Google is tired of sending data to
733 you. Try again later.</p>
734 </div>
735 </div>
736 <div class="sect2">
737 <h3 id="_preferences">3.6. Preferences</h3>
738 <div class="imageblock">
739 <div class="content">
740 <img src="telegps-preferences.png" alt="telegps preferences" width="230">
741 </div>
742 <div class="title">Figure 10. TeleGPS Preferences Window</div>
743 </div>
744 <div class="sect3">
745 <h4 id="_voice_settings">3.6.1. Voice Settings</h4>
746 <div class="paragraph">
747 <p>TeleGPS provides voice announcements during
748 flight so that you can keep your eyes on the
749 sky and still get information about the
750 current flight status. However, sometimes you
751 don&#8217;t want to hear them.</p>
752 </div>
753 <div class="dlist">
754 <dl>
755 <dt class="hdlist1">Enable</dt>
756 <dd>
757 <p>Turns all voice announcements on and off</p>
758 </dd>
759 <dt class="hdlist1">Test Voice</dt>
760 <dd>
761 <p>Plays a short message allowing you to verify
762 that the audio system is working and the volume settings
763 are reasonable</p>
764 </dd>
765 </dl>
766 </div>
767 </div>
768 <div class="sect3">
769 <h4 id="_log_directory">3.6.2. Log Directory</h4>
770 <div class="paragraph">
771 <p>TeleGPS logs all telemetry data and saves all
772 flash data to this directory. This
773 directory is also used as the staring point
774 when selecting data files for display or
775 export.</p>
776 </div>
777 <div class="paragraph">
778 <p>Click on the directory name to bring up a
779 directory choosing dialog, select a new
780 directory and click 'Select Directory' to
781 change where TeleGPS reads and writes data
782 files.</p>
783 </div>
784 </div>
785 <div class="sect3">
786 <h4 id="_callsign">3.6.3. Callsign</h4>
787 <div class="paragraph">
788 <p>This value is transmitted in each command
789 packet sent from TeleDongle and received from
790 an altimeter.  It is not used in telemetry
791 mode, as the callsign configured in the
792 altimeter board is included in all telemetry
793 packets.  Configure this with the TeleGPS
794 operators call sign as needed to comply with
795 your local radio regulations.</p>
796 </div>
797 <div class="paragraph">
798 <p>Note that to successfully command a flight
799 computer over the radio (to configure the
800 altimeter, monitor idle, or fire pyro
801 charges), the callsign configured here must
802 exactly match the callsign configured in the
803 flight computer.  This matching is case
804 sensitive.</p>
805 </div>
806 </div>
807 <div class="sect3">
808 <h4 id="_imperial_units">3.6.4. Imperial Units</h4>
809 <div class="paragraph">
810 <p>This switches between metric units (meters)
811 and imperial units (feet and miles). This
812 affects the display of values use during
813 flight monitoring, configuration, data
814 graphing and all of the voice
815 announcements. It does not change the units
816 used when exporting to CSV files, those are
817 always produced in metric units.</p>
818 </div>
819 </div>
820 <div class="sect3">
821 <h4 id="_serial_debug">3.6.5. Serial Debug</h4>
822 <div class="paragraph">
823 <p>This causes all communication with a connected
824 device to be dumped to the console from which
825 TeleGPS was started. If you&#8217;ve started it from
826 an icon or menu entry, the output will simply
827 be discarded. This mode can be useful to debug
828 various serial communication issues.</p>
829 </div>
830 </div>
831 <div class="sect3">
832 <h4 id="_font_size">3.6.6. Font size</h4>
833 <div class="paragraph">
834 <p>Selects the set of fonts used in the flight
835 monitor window. Choose between the small,
836 medium and large sets.</p>
837 </div>
838 </div>
839 <div class="sect3">
840 <h4 id="_look_feel">3.6.7. Look &amp; feel</h4>
841 <div class="paragraph">
842 <p>Switches between the available Java user
843 interface appearances. The default selection
844 is supposed to match the native window system
845 appearance for the target platform.</p>
846 </div>
847 </div>
848 <div class="sect3">
849 <h4 id="_menu_position">3.6.8. Menu position</h4>
850 <div class="paragraph">
851 <p>Selects the initial position for the main
852 TeleGPS window that includes all of the
853 command buttons.</p>
854 </div>
855 </div>
856 <div class="sect3">
857 <h4 id="_map_cache_size">3.6.9. Map Cache Size</h4>
858 <div class="paragraph">
859 <p>Sets the number of map 'tiles' kept in memory
860 while the application is running. More tiles
861 consume more memory, but will make panning
862 around the map faster.</p>
863 </div>
864 </div>
865 <div class="sect3">
866 <h4 id="_manage_frequencies">3.6.10. Manage Frequencies</h4>
867 <div class="paragraph">
868 <p>This brings up a dialog where you can
869 configure the set of frequencies shown in the
870 various frequency menus. You can add as many
871 as you like, or even reconfigure the default
872 set. Changing this list does not affect the
873 frequency settings of any devices, it only
874 changes the set of frequencies shown in the
875 menus.</p>
876 </div>
877 </div>
878 </div>
879 <div class="sect2">
880 <h3 id="_close">3.7. Close</h3>
881 <div class="paragraph">
882 <p>This closes the current window, leaving any other windows
883 open and the application running.</p>
884 </div>
885 </div>
886 <div class="sect2">
887 <h3 id="_exit">3.8. Exit</h3>
888 <div class="paragraph">
889 <p>This closes all TeleGPS windows and terminates the
890 application.</p>
891 </div>
892 </div>
893 <div class="sect2">
894 <h3 id="_connect_device">3.9. Connect Device</h3>
895 <div class="paragraph">
896 <p>Selecting this item brings up a dialog box listing all
897 of the connected TeleDongle devices. When you choose
898 one of these, AltosUI will display telemetry data as
899 received by the selected TeleDongle device.</p>
900 </div>
901 <div class="imageblock">
902 <div class="content">
903 <img src="device-selection.png" alt="device selection" width="300">
904 </div>
905 <div class="title">Figure 11. Device Selection Dialog</div>
906 </div>
907 </div>
908 <div class="sect2">
909 <h3 id="_disconnect">3.10. Disconnect</h3>
910 <div class="paragraph">
911 <p>Disconnects the currently connected TeleDongle or
912 TeleBT</p>
913 </div>
914 </div>
915 <div class="sect2">
916 <h3 id="_scan_channels">3.11. Scan Channels</h3>
917 <div class="imageblock">
918 <div class="content">
919 <img src="telegps-scan.png" alt="telegps scan" width="300">
920 </div>
921 <div class="title">Figure 12. Radio Scanning Dialog</div>
922 </div>
923 <div class="paragraph">
924 <p>Scans the configured set of frequencies looking for
925 telemetry signals. A list of all of the discovered
926 signals is show; selecting one of those and clicking
927 on 'Monitor' will select that frequency in the
928 associated TeleGPS application window.</p>
929 </div>
930 </div>
931 <div class="sect2">
932 <h3 id="_download_data">3.12. Download Data</h3>
933 <div class="paragraph">
934 <p>TeleGPS records data to its internal flash memory.
935 On-board data is recorded at the same rate as
936 telemetry but is not subject to radio drop-outs. As
937 such, it generally provides a more complete and
938 precise record.  The 'Download Data' menu entry allows
939 you to read the flash memory and write it to disk.</p>
940 </div>
941 <div class="paragraph">
942 <p>Select the 'Download Data' menu entry to bring up a
943 list of connected TeleGPS devices. After the device
944 has been selected, a dialog showing the data stored in
945 the device will be shown allowing you to select which
946 entries to download and which to delete. You must
947 erase flights in order for the space they consume to
948 be reused by another track. This prevents accidentally
949 losing data if you neglect to download data before
950 starting TeleGPS again. Note that if there is no more
951 space available in the device, then no data will be
952 recorded.</p>
953 </div>
954 <div class="paragraph">
955 <p>The file name for each data log is computed
956 automatically from the recorded date, altimeter serial
957 number and flight number information.</p>
958 </div>
959 </div>
960 <div class="sect2">
961 <h3 id="_configure_device">3.13. Configure Device</h3>
962 <div class="imageblock">
963 <div class="content">
964 <img src="telegps-configure.png" alt="telegps configure" width="350">
965 </div>
966 <div class="title">Figure 13. TeleGPS Configuration Dialog</div>
967 </div>
968 <div class="paragraph">
969 <p>Select this button and then select any connected TeleGPS
970 device from the list provided.</p>
971 </div>
972 <div class="paragraph">
973 <p>The first few lines of the dialog provide information
974 about the connected device, including the product
975 name, software version and hardware serial
976 number. Below that are the individual configuration
977 entries.</p>
978 </div>
979 <div class="paragraph">
980 <p>At the bottom of the dialog, there are four buttons:</p>
981 </div>
982 <div class="dlist">
983 <dl>
984 <dt class="hdlist1">Save</dt>
985 <dd>
986 <p>This writes any changes to the configuration parameter
987 block in flash memory. If you don&#8217;t press this button,
988 any changes you make will be lost.</p>
989 </dd>
990 <dt class="hdlist1">Reset</dt>
991 <dd>
992 <p>This resets the dialog to the most recently saved
993 values, erasing any changes you have made.</p>
994 </dd>
995 <dt class="hdlist1">Reboot</dt>
996 <dd>
997 <p>This reboots the device. Use this to switch from idle
998 to pad mode by rebooting once the rocket is oriented
999 for flight, or to confirm changes you think you saved
1000 are really saved.</p>
1001 </dd>
1002 <dt class="hdlist1">Close</dt>
1003 <dd>
1004 <p>This closes the dialog. Any unsaved changes will be
1005 lost.</p>
1006 </dd>
1007 </dl>
1008 </div>
1009 <div class="paragraph">
1010 <p>The rest of the dialog contains the parameters to be configured.</p>
1011 </div>
1012 <div class="sect3">
1013 <h4 id="_frequency">3.13.1. Frequency</h4>
1014 <div class="paragraph">
1015 <p>This configures which of the frequencies to use for
1016 both telemetry and packet command mode. Note that if
1017 you set this value via packet command mode, the
1018 TeleDongle frequency will also be automatically
1019 reconfigured to match so that communication will
1020 continue afterwards.</p>
1021 </div>
1022 </div>
1023 <div class="sect3">
1024 <h4 id="_rf_calibration">3.13.2. RF Calibration</h4>
1025 <div class="paragraph">
1026 <p>The radios in every Altus Metrum device are calibrated
1027 at the factory to ensure that they transmit and
1028 receive on the specified frequency.  If you need to
1029 you can adjust the calibration by changing this value.
1030 Do not do this without understanding what the value
1031 means, read the appendix on calibration and/or the
1032 source code for more information.  To change a
1033 TeleDongle&#8217;s calibration, you must reprogram the unit
1034 completely.</p>
1035 </div>
1036 </div>
1037 <div class="sect3">
1038 <h4 id="_telemetryrdfaprs_enable">3.13.3. Telemetry/RDF/APRS Enable</h4>
1039 <div class="paragraph">
1040 <p>Enables the radio for transmission during
1041 flight. When disabled, the radio will not
1042 transmit anything during flight at all.</p>
1043 </div>
1044 </div>
1045 <div class="sect3">
1046 <h4 id="_limit_transmit_to_10mw">3.13.4. Limit transmit to 10mW</h4>
1047 <div class="paragraph">
1048 <p>Reduces transmit power to no more than 10mW. This is
1049 useful when operating under some UK radio regulations.</p>
1050 </div>
1051 </div>
1052 <div class="sect3">
1053 <h4 id="_telemetry_baud_rate">3.13.5. Telemetry baud rate</h4>
1054 <div class="paragraph">
1055 <p>This sets the modulation bit rate for data
1056 transmission for both telemetry and packet
1057 link mode. Lower bit rates will increase range
1058 while reducing the amount of data that can be
1059 sent and increasing battery consumption. All
1060 telemetry is done using a rate 1/2 constraint
1061 4 convolution code, so the actual data
1062 transmission rate is 1/2 of the modulation bit
1063 rate specified here.</p>
1064 </div>
1065 </div>
1066 <div class="sect3">
1067 <h4 id="_aprs_interval">3.13.6. APRS Interval</h4>
1068 <div class="paragraph">
1069 <p>How often to transmit GPS information via APRS
1070 (in seconds). When set to zero, APRS
1071 transmission is disabled.
1072 Note that a single APRS packet
1073 takes nearly a full second to transmit, so
1074 enabling this option will prevent sending any
1075 other telemetry during that time.</p>
1076 </div>
1077 </div>
1078 <div class="sect3">
1079 <h4 id="_aprs_ssid">3.13.7. APRS SSID</h4>
1080 <div class="paragraph">
1081 <p>Which SSID to report in APRS packets. By
1082 default, this is set to the last digit of the
1083 serial number, but can be configured to any
1084 value from 0 to 9.</p>
1085 </div>
1086 </div>
1087 <div class="sect3">
1088 <h4 id="_aprs_format">3.13.8. APRS Format</h4>
1089 <div class="paragraph">
1090 <p>Whether to send APRS data in Compressed or
1091 Uncompressed format. Compressed format is
1092 smaller and more precise. Uncompressed
1093 format is older, but may work better with your
1094 device. The Kenwood TH-D72 only displays
1095 altitude information with Uncompressed
1096 format, while the Yaesu FT1D only displays
1097 altitude with Compressed format. Test before
1098 you fly to see which to use.</p>
1099 </div>
1100 </div>
1101 <div class="sect3">
1102 <h4 id="_aprs_offset">3.13.9. APRS Offset</h4>
1103 <div class="paragraph">
1104 <p>The delay from the top of the minute before sending
1105 the first APRS packet of the minute. Coordinating
1106 values for this parameter between multiple devices can
1107 allow a single receiver to reliably receive APRS
1108 packets from multiple devices. Note that this offset only
1109 takes effect while the GPS signal is locked so that the
1110 transmitting device knows the current time.</p>
1111 </div>
1112 </div>
1113 <div class="sect3">
1114 <h4 id="_callsign_2">3.13.10. Callsign</h4>
1115 <div class="paragraph">
1116 <p>This sets the call sign included in each
1117 telemetry packet. Set this as needed to
1118 conform to your local radio regulations.</p>
1119 </div>
1120 </div>
1121 <div class="sect3">
1122 <h4 id="_logging_trigger_motion">3.13.11. Logging Trigger Motion</h4>
1123 <div class="paragraph">
1124 <p>This sets the amount of motion that TeleGPS
1125 needs to see before logging the new
1126 position. Motions smaller than this are
1127 skipped, which saves storage space.</p>
1128 </div>
1129 </div>
1130 <div class="sect3">
1131 <h4 id="_position_reporting_interval">3.13.12. Position Reporting Interval</h4>
1132 <div class="paragraph">
1133 <p>The interval between TeleGPS position reports,
1134 both over the air and in the log. Increase
1135 this to reduce the frequency of radio
1136 transmissions and the length of time available
1137 in the log.</p>
1138 </div>
1139 </div>
1140 </div>
1141 <div class="sect2">
1142 <h3 id="_flash_device">3.14. Flash Device</h3>
1143 <div class="paragraph">
1144 <p>This reprograms TeleGPS devices with new
1145 firmware. Please read the directions for flashing
1146 devices in <a href="#_updating_device_firmware">Updating Device Firmware</a>.</p>
1147 </div>
1148 </div>
1149 </div>
1150 </div>
1151 <div class="sect1">
1152 <h2 id="_telegps_system_operation">Appendix A: TeleGPS System Operation</h2>
1153 <div class="sectionbody">
1154 <div class="sect2">
1155 <h3 id="_gfsk_telemetry">A.1. GFSK Telemetry</h3>
1156 <div class="paragraph">
1157 <p>TeleGPS&#8217;s native telemetry system doesn&#8217;t use a
1158 'normal packet radio' mode like APRS because it&#8217;s not
1159 very efficient.  The GFSK modulation we use is FSK
1160 with the base-band pulses passed through a Gaussian
1161 filter before they go into the modulator to limit the
1162 transmitted bandwidth.  When combined with forward
1163 error correction and interleaving, this allows us to
1164 have a very robust 19.2 kilobit data link with only
1165 10-40 milliwatts of transmit power, a whip antenna in
1166 the rocket, and a hand-held Yagi on the ground.  We&#8217;ve
1167 had flights to above 21k feet AGL with great
1168 reception, and calculations suggest we should be good
1169 to well over 40k feet AGL with a 5-element yagi on the
1170 ground with our 10mW units and over 100k feet AGL with
1171 the 40mW devices.</p>
1172 </div>
1173 </div>
1174 <div class="sect2">
1175 <h3 id="_aprs">A.2. APRS</h3>
1176 <div class="paragraph">
1177 <p>TeleGPS can send APRS if desired, and the
1178 interval between APRS packets can be configured. As
1179 each APRS packet takes a full second to transmit, we
1180 recommend an interval of at least 5 seconds to avoid
1181 consuming too much battery power or radio channel
1182 bandwidth. You can configure the time within each
1183 minute that APRS transmits by changing the APRS offset
1184 value. When the GPS signal is locked and knows the
1185 current time, the APRS offset selects the time with
1186 each minute for the first APRS transmission;
1187 subsequent transmissions occur each APRS interval
1188 seconds thereafter.  You can configure the APRS
1189 interval and APRS offset using TeleGPS; that
1190 process is described in <a href="#_configure_device">Configure Device</a>.</p>
1191 </div>
1192 <div class="paragraph">
1193 <p>AltOS supports both compressed and uncompressed APRS
1194 position report data formats. The compressed format
1195 provides for higher position precision and shorter
1196 packets than the uncompressed APRS format. We&#8217;ve found
1197 some older APRS receivers that do not handle the
1198 compressed format. The Kenwood TH-72A requires the use
1199 of uncompressed format to display altitude information
1200 correctly. The Yaesu FT1D requires the use of
1201 compressed format to display altitude information.</p>
1202 </div>
1203 <div class="paragraph">
1204 <p>APRS packets include an SSID (Secondary Station Identifier)
1205 field that allows one operator to have multiple
1206 transmitters. AltOS allows you to set this to a single digit
1207 from 0 to 9, allowing you to fly multiple transmitters at the
1208 same time while keeping the identify of each one separate in
1209 the receiver. By default, the SSID is set to the last digit of
1210 the device serial number.</p>
1211 </div>
1212 <div class="paragraph">
1213 <p>The APRS packet format includes a comment field that
1214 can have arbitrary text in it. AltOS uses this to send
1215 status information as shown in the following table.</p>
1216 </div>
1217 <table class="tableblock frame-all grid-all stretch">
1218 <caption class="title">Table 1. Altus Metrum APRS Comments</caption>
1219 <colgroup>
1220 <col style="width: 20%;">
1221 <col style="width: 20%;">
1222 <col style="width: 60%;">
1223 </colgroup>
1224 <thead>
1225 <tr>
1226 <th class="tableblock halign-left valign-top">Field</th>
1227 <th class="tableblock halign-left valign-top">Example</th>
1228 <th class="tableblock halign-left valign-top">Description</th>
1229 </tr>
1230 </thead>
1231 <tbody>
1232 <tr>
1233 <td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
1234 <td class="tableblock halign-left valign-top"><p class="tableblock">L</p></td>
1235 <td class="tableblock halign-left valign-top"><p class="tableblock">GPS Status U for unlocked, L for locked</p></td>
1236 </tr>
1237 <tr>
1238 <td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
1239 <td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
1240 <td class="tableblock halign-left valign-top"><p class="tableblock">Number of Satellites in View</p></td>
1241 </tr>
1242 <tr>
1243 <td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
1244 <td class="tableblock halign-left valign-top"><p class="tableblock">B4.0</p></td>
1245 <td class="tableblock halign-left valign-top"><p class="tableblock">Altimeter Battery Voltage</p></td>
1246 </tr>
1247 <tr>
1248 <td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
1249 <td class="tableblock halign-left valign-top"><p class="tableblock">1286</p></td>
1250 <td class="tableblock halign-left valign-top"><p class="tableblock">Device Serial Number</p></td>
1251 </tr>
1252 </tbody>
1253 </table>
1254 <div class="paragraph">
1255 <p>Here&#8217;s an example of an APRS comment showing GPS lock with 6
1256 satellites in view and a primary battery at 4.0V from device 1876.</p>
1257 </div>
1258 <div class="literalblock">
1259 <div class="content">
1260 <pre>L6 B4.0 1876</pre>
1261 </div>
1262 </div>
1263 <div class="paragraph">
1264 <p>Make sure your primary battery is above 3.8V
1265 and GPS is locked with at least 5 or 6 satellites in
1266 view before flying. If GPS is switching between L and
1267 U regularly, then it doesn&#8217;t have a good lock and you
1268 should wait until it becomes stable.</p>
1269 </div>
1270 <div class="paragraph">
1271 <p>If the GPS receiver loses lock, the APRS data
1272 transmitted will contain the last position for which
1273 GPS lock was available. You can tell that this has
1274 happened by noticing that the GPS status character
1275 switches from 'L' to 'U'. Before GPS has locked, APRS
1276 will transmit zero for latitude, longitude and
1277 altitude.</p>
1278 </div>
1279 </div>
1280 <div class="sect2">
1281 <h3 id="_configurable_parameters">A.3. Configurable Parameters</h3>
1282 <div class="paragraph">
1283 <p>Configuring TeleGPS is very simple; the few configurable
1284 parameters can all be set using the TeleGPS application over
1285 USB. Check out <a href="#_configure_device">Configure Device</a>.</p>
1286 </div>
1287 </div>
1288 </div>
1289 </div>
1290 <div class="sect1">
1291 <h2 id="_handling_precautions">Appendix B: Handling Precautions</h2>
1292 <div class="sectionbody">
1293 <div class="paragraph">
1294 <p>All Altus Metrum products are sophisticated electronic devices.
1295 When handled gently and properly installed in an air-frame, they
1296 will deliver impressive results.  However, as with all electronic
1297 devices, there are some precautions you must take.</p>
1298 </div>
1299 <div class="admonitionblock warning">
1300 <table>
1301 <tr>
1302 <td class="icon">
1303 <div class="title">Warning</div>
1304 </td>
1305 <td class="content">
1306 The Lithium Polymer rechargeable batteries have an
1307 extraordinary power density.  This is great because we can fly with
1308 much less battery mass than if we used alkaline batteries or previous
1309 generation rechargeable batteries&#8230;&#8203; but if they are punctured
1310 or their leads are allowed to short, they can and will release their
1311 energy very rapidly!
1312 Thus we recommend that you take some care when handling our batteries
1313 and consider giving them some extra protection in your air-frame.  We
1314 often wrap them in suitable scraps of closed-cell packing foam before
1315 strapping them down, for example.
1316 </td>
1317 </tr>
1318 </table>
1319 </div>
1320 <div class="paragraph">
1321 <p>The barometric sensors used on all of our flight computers are
1322 sensitive to sunlight.  In normal mounting situations, the baro sensor
1323 and all of the other surface mount components
1324 are “down” towards whatever the underlying mounting surface is, so
1325 this is not normally a problem.  Please consider this when designing an
1326 installation in an air-frame with a see-through plastic payload bay.  It
1327 is particularly important to
1328 consider this with TeleMini v1.0, both because the baro sensor is on the
1329 “top” of the board, and because many model rockets with payload bays
1330 use clear plastic for the payload bay!  Replacing these with an opaque
1331 cardboard tube, painting them, or wrapping them with a layer of masking
1332 tape are all reasonable approaches to keep the sensor out of direct
1333 sunlight.</p>
1334 </div>
1335 <div class="paragraph">
1336 <p>The barometric sensor sampling port must be able to “breathe”,
1337 both by not being covered by foam or tape or other materials that might
1338 directly block the hole on the top of the sensor, and also by having a
1339 suitable static vent to outside air.</p>
1340 </div>
1341 <div class="paragraph">
1342 <p>As with all other rocketry electronics, Altus Metrum altimeters must
1343 be protected from exposure to corrosive motor exhaust and ejection
1344 charge gasses.</p>
1345 </div>
1346 </div>
1347 </div>
1348 <div class="sect1">
1349 <h2 id="_technical_information">Appendix C: Technical Information</h2>
1350 <div class="sectionbody">
1351 <div class="sect2">
1352 <h3 id="_gps_receiver">C.1. GPS Receiver</h3>
1353 <div class="paragraph">
1354 <p>TeleGPS uses the u-Blox Max-7Q GPS receiver.</p>
1355 </div>
1356 </div>
1357 <div class="sect2">
1358 <h3 id="_70cm_transmitter">C.2. 70cm Transmitter</h3>
1359 <div class="paragraph">
1360 <p>TeleGPS uses a TI CC115L transmitter. This radio
1361 produces 10mW of RF output.</p>
1362 </div>
1363 </div>
1364 <div class="sect2">
1365 <h3 id="_micro_controller">C.3. Micro-controller</h3>
1366 <div class="paragraph">
1367 <p>TeleGPS uses an NXP LPC11U14 micro-controller. This
1368 tiny CPU contains 32kB of flash for the application
1369 and 4kB of RAM for temporary data storage.</p>
1370 </div>
1371 </div>
1372 <div class="sect2">
1373 <h3 id="_lithium_polymer_battery">C.4. Lithium Polymer Battery</h3>
1374 <div class="paragraph">
1375 <p>Shipping restrictions may prevent us from including a
1376 battery battery with TeleGPS.</p>
1377 </div>
1378 </div>
1379 <div class="sect2">
1380 <h3 id="_mechanical_considerations">C.5. Mechanical Considerations</h3>
1381 <div class="paragraph">
1382 <p>TeleGPS is designed to be rugged enough for typical
1383 rocketry applications.  The 4 mounting holes on the
1384 board are sized for use with 4-40 or M3 screws.</p>
1385 </div>
1386 </div>
1387 <div class="sect2">
1388 <h3 id="_on_board_data_storage">C.6. On-board data storage</h3>
1389 <div class="paragraph">
1390 <p>TeleGPS has 2MB of non-volatile storage, separate from
1391 the code storage memory. The TeleGPS firmware uses
1392 this to log information during flight.</p>
1393 </div>
1394 </div>
1395 </div>
1396 </div>
1397 <div class="sect1">
1398 <h2 id="_updating_device_firmware">Appendix D: Updating Device Firmware</h2>
1399 <div class="sectionbody">
1400 <div class="paragraph">
1401 <p>TeleGPS is programmed directly over its USB connectors.</p>
1402 </div>
1403 <div class="paragraph">
1404 <p>You may wish to begin by ensuring you have current firmware images.
1405 These are distributed as part of the TeleGPS software bundle that
1406 also includes the TeleGPS ground station program.  Newer ground
1407 station versions typically work fine with older firmware versions,
1408 so you don&#8217;t need to update your devices just to try out new
1409 software features.  You can always download the most recent
1410 version from <a href="http://www.altusmetrum.org/AltOS/" class="bare">http://www.altusmetrum.org/AltOS/</a></p>
1411 </div>
1412 <div class="sect2">
1413 <h3 id="_updating_telegps_firmware">D.1. Updating TeleGPS Firmware</h3>
1414 <div class="olist arabic">
1415 <ol class="arabic">
1416 <li>
1417 <p>Attach a battery and power switch to the target
1418 device. Power up the device.</p>
1419 </li>
1420 <li>
1421 <p>Using a Micro USB cable, connect the target device to
1422 your computer&#8217;s USB socket.</p>
1423 </li>
1424 <li>
1425 <p>Run TeleGPS, and select 'Flash Device' from the
1426 Device menu.</p>
1427 </li>
1428 <li>
1429 <p>Select the target device in the Device Selection
1430 dialog.</p>
1431 </li>
1432 <li>
1433 <p>Select the image you want to flash to the device,
1434 which should have a name in the form
1435 &lt;product&gt;-v&lt;product-version&gt;-&lt;software-version&gt;.ihx,
1436 such as TeleGPS-v1.0-1.4.0.ihx.</p>
1437 </li>
1438 <li>
1439 <p>Make sure the configuration parameters are reasonable
1440 looking. If the serial number and/or RF configuration
1441 values aren&#8217;t right, you&#8217;ll need to change them.</p>
1442 </li>
1443 <li>
1444 <p>Hit the 'OK' button and the software should proceed
1445 to flash the device with new firmware, showing a
1446 progress bar.</p>
1447 </li>
1448 <li>
1449 <p>Verify that the device is working by using the
1450 'Configure Device item to check over the
1451 configuration.</p>
1452 </li>
1453 </ol>
1454 </div>
1455 </div>
1456 </div>
1457 </div>
1458 <div class="sect1">
1459 <h2 id="_release_notes">Appendix E: Release Notes</h2>
1460 <div class="sectionbody">
1461 <div class="sect2">
1462 <h3 id="_release_notes_for_version_1_9_21">E.1. Release Notes for Version 1.9.21</h3>
1463 <div class="paragraph">
1464 <p>Version 1.9.21</p>
1465 </div>
1466 <div class="sect3">
1467 <h4 id="_altos">E.1.1. AltOS</h4>
1468 <div class="ulist">
1469 <ul>
1470 <li>
1471 <p>Add support for TeleBT v4.0 factory test.</p>
1472 </li>
1473 <li>
1474 <p>Support Picolibc 1.8.10</p>
1475 </li>
1476 </ul>
1477 </div>
1478 </div>
1479 <div class="sect3">
1480 <h4 id="_altosui_telegps_application">E.1.2. AltosUI &amp; TeleGPS application</h4>
1481 <div class="ulist">
1482 <ul>
1483 <li>
1484 <p>Support pressure values below sensor range.</p>
1485 </li>
1486 </ul>
1487 </div>
1488 <div style="page-break-after: always;"></div>
1489 </div>
1490 </div>
1491 <div class="sect2">
1492 <h3 id="_release_notes_for_version_1_9_20">E.2. Release Notes for Version 1.9.20</h3>
1493 <div class="paragraph">
1494 <p>Version 1.9.20</p>
1495 </div>
1496 <div class="sect3">
1497 <h4 id="_altos_2">E.2.1. AltOS</h4>
1498 <div class="ulist">
1499 <ul>
1500 <li>
1501 <p>Add support for TeleGPS v4.0 and TeleMega v7.0</p>
1502 </li>
1503 </ul>
1504 </div>
1505 </div>
1506 <div class="sect3">
1507 <h4 id="_altosui_telegps_application_2">E.2.2. AltosUI &amp; TeleGPS application</h4>
1508 <div class="ulist">
1509 <ul>
1510 <li>
1511 <p>Add support for TeleGPS v4.0 and TeleMega v7.0</p>
1512 </li>
1513 <li>
1514 <p>Add support for 30V pyro voltage range</p>
1515 </li>
1516 </ul>
1517 </div>
1518 <div style="page-break-after: always;"></div>
1519 </div>
1520 </div>
1521 <div class="sect2">
1522 <h3 id="_release_notes_for_version_1_9_19">E.3. Release Notes for Version 1.9.19</h3>
1523 <div class="paragraph">
1524 <p>Version 1.9.19</p>
1525 </div>
1526 <div class="sect3">
1527 <h4 id="_altos_3">E.3.1. AltOS</h4>
1528 <div class="ulist">
1529 <ul>
1530 <li>
1531 <p>Finish support for EasyMega V3.</p>
1532 </li>
1533 </ul>
1534 </div>
1535 </div>
1536 <div class="sect3">
1537 <h4 id="_altosui_telegps_application_3">E.3.2. AltosUI &amp; TeleGPS application</h4>
1538 <div class="ulist">
1539 <ul>
1540 <li>
1541 <p>Show device configuration information when graphing a
1542 flight.</p>
1543 </li>
1544 </ul>
1545 </div>
1546 <div style="page-break-after: always;"></div>
1547 </div>
1548 </div>
1549 <div class="sect2">
1550 <h3 id="_release_notes_for_version_1_9_18">E.4. Release Notes for Version 1.9.18</h3>
1551 <div class="paragraph">
1552 <p>Version 1.9.18</p>
1553 </div>
1554 <div class="sect3">
1555 <h4 id="_altos_4">E.4.1. AltOS</h4>
1556 <div class="ulist">
1557 <ul>
1558 <li>
1559 <p>Add support for EasyTimer V2. The new version of this
1560 product has on-board storage to log data during flight.</p>
1561 </li>
1562 </ul>
1563 </div>
1564 </div>
1565 <div class="sect3">
1566 <h4 id="_altosui_telegps_application_4">E.4.2. AltosUI &amp; TeleGPS application</h4>
1567 <div class="ulist">
1568 <ul>
1569 <li>
1570 <p>Add support for EasyTimer V2. This includes support for
1571 analyizing flight data from the on-board logs.</p>
1572 </li>
1573 <li>
1574 <p>Allow on-board beepers to be disabled by setting the
1575 frequency to 0.</p>
1576 </li>
1577 </ul>
1578 </div>
1579 <div style="page-break-after: always;"></div>
1580 </div>
1581 </div>
1582 <div class="sect2">
1583 <h3 id="_release_notes_for_version_1_9_17">E.5. Release Notes for Version 1.9.17</h3>
1584 <div class="paragraph">
1585 <p>Version 1.9.17</p>
1586 </div>
1587 <div class="sect3">
1588 <h4 id="_altos_5">E.5.1. AltOS</h4>
1589 <div class="ulist">
1590 <ul>
1591 <li>
1592 <p>Fix TeleMini v3 Monitor Idle support</p>
1593 </li>
1594 <li>
1595 <p>Support TeleMetrum v4.0 with uBlox-10 GPS module</p>
1596 </li>
1597 <li>
1598 <p>Improve igniter reporting via the beeper.</p>
1599 </li>
1600 </ul>
1601 </div>
1602 </div>
1603 <div class="sect3">
1604 <h4 id="_altosui_telegps_application_5">E.5.2. AltosUI &amp; TeleGPS application</h4>
1605 <div class="ulist">
1606 <ul>
1607 <li>
1608 <p>Add support for EasyMini v3 Monitor Idle</p>
1609 </li>
1610 </ul>
1611 </div>
1612 <div style="page-break-after: always;"></div>
1613 </div>
1614 </div>
1615 <div class="sect2">
1616 <h3 id="_release_notes_for_version_1_9_16">E.6. Release Notes for Version 1.9.16</h3>
1617 <div class="paragraph">
1618 <p>Version 1.9.16</p>
1619 </div>
1620 <div class="sect3">
1621 <h4 id="_altos_6">E.6.1. AltOS</h4>
1622 <div class="ulist">
1623 <ul>
1624 <li>
1625 <p>Add TeleGPS v3.0 support</p>
1626 </li>
1627 </ul>
1628 </div>
1629 </div>
1630 <div class="sect3">
1631 <h4 id="_altosui_telegps_application_6">E.6.2. AltosUI &amp; TeleGPS application</h4>
1632 <div class="ulist">
1633 <ul>
1634 <li>
1635 <p>Add TeleGPS v3.0 support</p>
1636 </li>
1637 </ul>
1638 </div>
1639 <div style="page-break-after: always;"></div>
1640 </div>
1641 </div>
1642 <div class="sect2">
1643 <h3 id="_release_notes_for_version_1_9_15">E.7. Release Notes for Version 1.9.15</h3>
1644 <div class="paragraph">
1645 <p>Version 1.9.15</p>
1646 </div>
1647 <div class="sect3">
1648 <h4 id="_altos_7">E.7.1. AltOS</h4>
1649 <div class="ulist">
1650 <ul>
1651 <li>
1652 <p>Add TeleMega v6.0 support</p>
1653 </li>
1654 <li>
1655 <p>Add TeleMetrum v4.0 support</p>
1656 </li>
1657 <li>
1658 <p>Fix sign of IMU values for TeleMega v5 boards in the
1659 'across' axis. This affects IMU acceleration and gyro reports
1660 for that axis, but has no effect on in-flight operation of
1661 the tilt computation.</p>
1662 </li>
1663 </ul>
1664 </div>
1665 <div style="page-break-after: always;"></div>
1666 </div>
1667 </div>
1668 <div class="sect2">
1669 <h3 id="_release_notes_for_version_1_9_14">E.8. Release Notes for Version 1.9.14</h3>
1670 <div class="paragraph">
1671 <p>Version 1.9.14</p>
1672 </div>
1673 <div class="sect3">
1674 <h4 id="_altos_8">E.8.1. AltOS</h4>
1675 <div class="ulist">
1676 <ul>
1677 <li>
1678 <p>Fix 1.9.13 regression in TeleLCO startup sequence that
1679 detects available TeleFire units.</p>
1680 </li>
1681 </ul>
1682 </div>
1683 <div style="page-break-after: always;"></div>
1684 </div>
1685 </div>
1686 <div class="sect2">
1687 <h3 id="_release_notes_for_version_1_9_13">E.9. Release Notes for Version 1.9.13</h3>
1688 <div class="paragraph">
1689 <p>Version 1.9.13</p>
1690 </div>
1691 <div class="sect3">
1692 <h4 id="_altos_9">E.9.1. AltOS</h4>
1693 <div class="ulist">
1694 <ul>
1695 <li>
1696 <p>Add option to beep max height in feet after landing</p>
1697 </li>
1698 <li>
1699 <p>Fix APRS reports to be sent at the correct time and spacing.</p>
1700 </li>
1701 <li>
1702 <p>Fix possible barometric sensor communication failure when
1703 the CPU is busy talking to the radio at the same time. This
1704 would cause loss of telemetry and failure to track the state
1705 of the rocket during flight. This was aggrevated by the APRS
1706 reports getting sent more often than they should.</p>
1707 </li>
1708 <li>
1709 <p>Change EasyMotor v3 code to base logging on motor pressure
1710 rather than the accelerometer. This allows use of EasyMotor
1711 v3 in a static test stand.</p>
1712 </li>
1713 </ul>
1714 </div>
1715 </div>
1716 <div class="sect3">
1717 <h4 id="_altosui">E.9.2. AltosUI</h4>
1718 <div class="ulist">
1719 <ul>
1720 <li>
1721 <p>Add support for configuring the units used to report height
1722 after landing on the beeper.</p>
1723 </li>
1724 </ul>
1725 </div>
1726 <div style="page-break-after: always;"></div>
1727 </div>
1728 </div>
1729 <div class="sect2">
1730 <h3 id="_release_notes_for_version_1_9_12">E.10. Release Notes for Version 1.9.12</h3>
1731 <div class="paragraph">
1732 <p>Version 1.9.12</p>
1733 </div>
1734 <div class="sect3">
1735 <h4 id="_altos_10">E.10.1. AltOS</h4>
1736 <div class="ulist">
1737 <ul>
1738 <li>
1739 <p>Add EasyMini v3.0 and EasyMotor v3.0 support</p>
1740 </li>
1741 <li>
1742 <p>Fix TeleMetrum v2.0 configuration. Saving config would
1743 crash the board.</p>
1744 </li>
1745 </ul>
1746 </div>
1747 </div>
1748 <div class="sect3">
1749 <h4 id="_altosui_2">E.10.2. AltosUI</h4>
1750 <div class="ulist">
1751 <ul>
1752 <li>
1753 <p>Add EasyMotor log parsing and graphing.</p>
1754 </li>
1755 </ul>
1756 </div>
1757 <div style="page-break-after: always;"></div>
1758 </div>
1759 </div>
1760 <div class="sect2">
1761 <h3 id="_release_notes_for_version_1_9_11">E.11. Release Notes for Version 1.9.11</h3>
1762 <div class="paragraph">
1763 <p>Version 1.9.11</p>
1764 </div>
1765 <div class="sect3">
1766 <h4 id="_altos_11">E.11.1. AltOS</h4>
1767 <div class="ulist">
1768 <ul>
1769 <li>
1770 <p>Make Apogee Delay work again.</p>
1771 </li>
1772 <li>
1773 <p>Allow TX power to be limited to 10mW for compliance with
1774 some uses under UK regulations.</p>
1775 </li>
1776 <li>
1777 <p>Fix numerous minor issues with 16- vs 32- bit time values.</p>
1778 </li>
1779 </ul>
1780 </div>
1781 </div>
1782 <div class="sect3">
1783 <h4 id="_altosui_3">E.11.2. AltosUI</h4>
1784 <div class="ulist">
1785 <ul>
1786 <li>
1787 <p>Support M1-based Macs, follow AdoptOpenJDK to Adoptium</p>
1788 </li>
1789 </ul>
1790 </div>
1791 </div>
1792 <div class="sect3">
1793 <h4 id="_altosdroid">E.11.3. AltosDroid</h4>
1794 <div class="ulist">
1795 <ul>
1796 <li>
1797 <p>Handle Bluetooth permissions reliably.</p>
1798 </li>
1799 <li>
1800 <p>Fix some screen rotation bugs.</p>
1801 </li>
1802 </ul>
1803 </div>
1804 <div style="page-break-after: always;"></div>
1805 </div>
1806 </div>
1807 <div class="sect2">
1808 <h3 id="_release_notes_for_version_1_9_10">E.12. Release Notes for Version 1.9.10</h3>
1809 <div class="paragraph">
1810 <p>Version 1.9.10</p>
1811 </div>
1812 <div class="paragraph">
1813 <p>This release contains a couple of bug fixes for ground station software.</p>
1814 </div>
1815 <div class="sect3">
1816 <h4 id="_altosui_4">E.12.1. AltosUI</h4>
1817 <div class="ulist">
1818 <ul>
1819 <li>
1820 <p>Rework the windows DLL build to make AltosUI run on more
1821 instances of Windows 10.</p>
1822 </li>
1823 </ul>
1824 </div>
1825 </div>
1826 <div class="sect3">
1827 <h4 id="_altosdroid_2">E.12.2. AltosDroid</h4>
1828 <div class="ulist">
1829 <ul>
1830 <li>
1831 <p>Adapt to Android security changes which prevent AltosDroid
1832 from storing flights in
1833 /storage/emulated/0/AltusMetrum. Now, flights are stored in
1834 /storage/emulated/0/media/org.altusmetrum.AltosDroid/AltusMetrum
1835 instead.  Also, AltosDroid will display an error message if
1836 flight data cannot be logged.</p>
1837 </li>
1838 </ul>
1839 </div>
1840 <div style="page-break-after: always;"></div>
1841 </div>
1842 </div>
1843 <div class="sect2">
1844 <h3 id="_release_notes_for_version_1_9_9">E.13. Release Notes for Version 1.9.9</h3>
1845 <div class="paragraph">
1846 <p>Version 1.9.9</p>
1847 </div>
1848 <div class="paragraph">
1849 <p>This release contains a critical bug fix for a problem
1850 introduced in version 1.9.8 for TeleMega and EasyMega
1851 boards. This problem occurs when using the stored
1852 configuration from 1.9.7 or earlier.</p>
1853 </div>
1854 <div class="paragraph">
1855 <p>If you are running 1.9.8 or are upgrading from 1.9.8 on any
1856 version of TeleMega or EasyMega, you must reconfigure all pyro
1857 channels, recalibrate accelerometers, reset the APRS interval,
1858 adjust the beep tone and reset the pyro time.</p>
1859 </div>
1860 <div class="sect3">
1861 <h4 id="_altos_12">E.13.1. AltOS</h4>
1862 <div class="ulist">
1863 <ul>
1864 <li>
1865 <p>Fix EasyMega and TeleMega upgrade process from 1.9.7 or
1866 earlier.  1.9.8 introduced larger delay values, which
1867 required modifying the configuration in-place, and the 1.9.8
1868 version had a flaw which broke the pyro channel config and
1869 all of the config values beyond that in memory, including
1870 APRS interval, IMU accel calibation, beep tone and pyro
1871 time.</p>
1872 </li>
1873 <li>
1874 <p>Fix TeleMega v5.0 mag sensor driver. This driver was quite
1875 broken due to developing it in the presence of the magnetic
1876 beeper on the board. Because of that beeper, the values this
1877 sensor records are not accurate. Fortunately, they are not
1878 used for controlling the flight.</p>
1879 </li>
1880 </ul>
1881 </div>
1882 </div>
1883 <div class="sect3">
1884 <h4 id="_altosui_5">E.13.2. AltosUI</h4>
1885 <div class="ulist">
1886 <ul>
1887 <li>
1888 <p>Parse TeleMega v5.0 log files. A missing check in the code
1889 meant that the TeleMega v5.0 log files would cause an error
1890 when attempting to load them. Logs saved with AltosUI
1891 1.9.8 were not affected, only the presentation of the data
1892 was broken.</p>
1893 </li>
1894 </ul>
1895 </div>
1896 <div style="page-break-after: always;"></div>
1897 </div>
1898 </div>
1899 <div class="sect2">
1900 <h3 id="_release_notes_for_version_1_9_8">E.14. Release Notes for Version 1.9.8</h3>
1901 <div class="paragraph">
1902 <p>Version 1.9.8</p>
1903 </div>
1904 <div class="sect3">
1905 <h4 id="_altos_13">E.14.1. AltOS</h4>
1906 <div class="ulist">
1907 <ul>
1908 <li>
1909 <p>Add support for TeleMega v5.0</p>
1910 </li>
1911 <li>
1912 <p>Extend extra pyro channel times to support delay &gt; 327 seconds</p>
1913 </li>
1914 </ul>
1915 </div>
1916 </div>
1917 <div class="sect3">
1918 <h4 id="_altosui_6">E.14.2. AltosUI</h4>
1919 <div class="ulist">
1920 <ul>
1921 <li>
1922 <p>Support ARM devices in Linux binary release</p>
1923 </li>
1924 <li>
1925 <p>Add support for TeleMega v5.0</p>
1926 </li>
1927 </ul>
1928 </div>
1929 </div>
1930 <div class="sect3">
1931 <h4 id="_altosdroid_3">E.14.3. AltosDroid</h4>
1932 <div class="ulist">
1933 <ul>
1934 <li>
1935 <p>Show tilt angle in pad and flight tabs</p>
1936 </li>
1937 <li>
1938 <p>Show altitude as well as height (useful for TeleGPS)</p>
1939 </li>
1940 <li>
1941 <p>Support devices without GPS receivers</p>
1942 </li>
1943 </ul>
1944 </div>
1945 </div>
1946 <div class="sect3">
1947 <h4 id="_micropeak_gui">E.14.4. MicroPeak GUI</h4>
1948 <div class="ulist">
1949 <ul>
1950 <li>
1951 <p>Show error dialog if device open fails</p>
1952 </li>
1953 </ul>
1954 </div>
1955 <div style="page-break-after: always;"></div>
1956 </div>
1957 </div>
1958 <div class="sect2">
1959 <h3 id="_release_notes_for_version_1_9_7">E.15. Release Notes for Version 1.9.7</h3>
1960 <div class="paragraph">
1961 <p>Version 1.9.7</p>
1962 </div>
1963 <div class="sect3">
1964 <h4 id="_altos_14">E.15.1. AltOS</h4>
1965 <div class="ulist">
1966 <ul>
1967 <li>
1968 <p>Fix TeleGPS logging so that new data are appended to an existing log correctly</p>
1969 </li>
1970 </ul>
1971 </div>
1972 </div>
1973 <div class="sect3">
1974 <h4 id="_altosui_7">E.15.2. AltosUI</h4>
1975 <div class="ulist">
1976 <ul>
1977 <li>
1978 <p>Support Mac OS X 11 (Big Sur)</p>
1979 </li>
1980 <li>
1981 <p>Support Monitor Idle on Easy Timer</p>
1982 </li>
1983 <li>
1984 <p>Fix TeleMega v4.0 and TeleMetrum v3.0 configuration in Antenna Down mode</p>
1985 </li>
1986 <li>
1987 <p>Show launch sites in Load Maps view</p>
1988 </li>
1989 <li>
1990 <p>Add IMU header names to CSV files</p>
1991 </li>
1992 <li>
1993 <p>Clean up TeleGPS log corruption due to firmware bugs during firmware update</p>
1994 </li>
1995 </ul>
1996 </div>
1997 </div>
1998 <div class="sect3">
1999 <h4 id="_altosdroid_4">E.15.3. AltosDroid</h4>
2000 <div class="ulist">
2001 <ul>
2002 <li>
2003 <p>Support older devices back to Android version 5.1</p>
2004 </li>
2005 <li>
2006 <p>Fix a number of issues that could result in app crashes</p>
2007 </li>
2008 </ul>
2009 </div>
2010 <div style="page-break-after: always;"></div>
2011 </div>
2012 </div>
2013 <div class="sect2">
2014 <h3 id="_release_notes_for_version_1_9_6">E.16. Release Notes for Version 1.9.6</h3>
2015 <div class="paragraph">
2016 <p>Version 1.9.6</p>
2017 </div>
2018 <div class="sect3">
2019 <h4 id="_altos_15">E.16.1. AltOS</h4>
2020 <div class="ulist">
2021 <ul>
2022 <li>
2023 <p>Fix EasyTimer bug where it might mis-detect boost (either
2024 detect it early or not at all) due to small errors in
2025 accelerometer calibration leading to large accumulated error
2026 in speed.</p>
2027 </li>
2028 <li>
2029 <p>Adjust self-test of new 9-axis IMU (BMX-160) so that it
2030 doesn&#8217;t think the part has a failure when tested sitting
2031 horizontally.</p>
2032 </li>
2033 </ul>
2034 </div>
2035 <div style="page-break-after: always;"></div>
2036 </div>
2037 </div>
2038 <div class="sect2">
2039 <h3 id="_release_notes_for_version_1_9_5">E.17. Release Notes for Version 1.9.5</h3>
2040 <div class="paragraph">
2041 <p>Version 1.9.5</p>
2042 </div>
2043 <div class="sect3">
2044 <h4 id="_altos_16">E.17.1. AltOS</h4>
2045 <div class="ulist">
2046 <ul>
2047 <li>
2048 <p>Add Booster mode for all dual-deploy altimeters. Select
2049 "Separation &amp; Apogee" mode in AltosUI to fire the 'main'
2050 channel at first motor burnout and the 'apogee' channel at
2051 apogee.</p>
2052 </li>
2053 <li>
2054 <p>Improve reliability of stm32l firmware under heavy
2055 load. This was found using Monitor Idle on TeleMega with all
2056 flash slots full of data which would occasionally lock up.</p>
2057 </li>
2058 <li>
2059 <p>Fix orientation label in AltosUI for devices with
2060 radios. This makes the orientation say 'Antenna up' and
2061 'Antenna Down' for TeleMetrum and TeleMega again.</p>
2062 </li>
2063 <li>
2064 <p>Fix log data for pyro channels which were inhibited (often
2065 because of a tilt limit). They used to report 'fired' as
2066 soon as they were inhibited, which was misleading. Now they
2067 never report as having been fired.</p>
2068 </li>
2069 <li>
2070 <p>Allow Igniter Test to fire each igniter more than once.</p>
2071 </li>
2072 </ul>
2073 </div>
2074 </div>
2075 <div class="sect3">
2076 <h4 id="_altosui_8">E.17.2. AltosUI</h4>
2077 <div class="ulist">
2078 <ul>
2079 <li>
2080 <p>Improve performance of Monitor Idle mode by sending less data for each
2081 update.</p>
2082 </li>
2083 <li>
2084 <p>Improve Mac OS X install scripts so that they work on
2085 Catalina. This involves sending the user to get Java from
2086 the AdoptOpenJDK project which provides a version that works
2087 with Java applications.</p>
2088 </li>
2089 <li>
2090 <p>Make larger dialogs scrollable for use on smaller screens.</p>
2091 </li>
2092 <li>
2093 <p>Fix troubles re-flashing EasyMega boards running older
2094 firmware.</p>
2095 </li>
2096 <li>
2097 <p>Add TeleMetrum v3.0 firmware to the Windows
2098 AltosUI packages.</p>
2099 </li>
2100 </ul>
2101 </div>
2102 <div style="page-break-after: always;"></div>
2103 </div>
2104 </div>
2105 <div class="sect2">
2106 <h3 id="_release_notes_for_version_1_9_4">E.18. Release Notes for Version 1.9.4</h3>
2107 <div class="paragraph">
2108 <p>Version 1.9.4</p>
2109 </div>
2110 <div class="sect3">
2111 <h4 id="_altos_17">E.18.1. AltOS</h4>
2112 <div class="ulist">
2113 <ul>
2114 <li>
2115 <p>Fixed firmware for TeleDongle v3.0 and TeleBT v4.0. Version 1.9.3 bricked those
2116 devices requiring them to be opened up to get them working again.</p>
2117 </li>
2118 <li>
2119 <p>Fixed firmware for EasyMini v1.0. Changes in the storage
2120 code caused it to use significantly more RAM which made the
2121 interrupt stack smash into other data structures and cause
2122 the device to panic at startup time.</p>
2123 </li>
2124 </ul>
2125 </div>
2126 </div>
2127 <div class="sect3">
2128 <h4 id="_altosui_9">E.18.2. AltosUI</h4>
2129 <div class="ulist">
2130 <ul>
2131 <li>
2132 <p>Add TeleMetrum v3.0 firmware to the Linux and Mac OSX
2133 AltosUI packages.</p>
2134 </li>
2135 </ul>
2136 </div>
2137 <div style="page-break-after: always;"></div>
2138 </div>
2139 </div>
2140 <div class="sect2">
2141 <h3 id="_release_notes_for_version_1_9_3">E.19. Release Notes for Version 1.9.3</h3>
2142 <div class="paragraph">
2143 <p>Version 1.9.3</p>
2144 </div>
2145 <div class="sect3">
2146 <h4 id="_altos_18">E.19.1. AltOS</h4>
2147 <div class="ulist">
2148 <ul>
2149 <li>
2150 <p>Add APRS offset. Allows multiple APRS transmitters to coordinate when
2151 transmission occurs to allow them to share a frequency.</p>
2152 </li>
2153 <li>
2154 <p>Fix max log size. Flight computer storage is erased in 64kB chunks. Adjust max
2155 log size to be a multiple of this size.</p>
2156 </li>
2157 <li>
2158 <p>Check flight erasing more carefully. Handle interrupting erasing in the
2159 middle.</p>
2160 </li>
2161 <li>
2162 <p>Add EasyTimer support.</p>
2163 </li>
2164 </ul>
2165 </div>
2166 </div>
2167 <div class="sect3">
2168 <h4 id="_altosui_telegps_micropeak">E.19.2. AltosUI, TeleGPS, MicroPeak</h4>
2169 <div class="ulist">
2170 <ul>
2171 <li>
2172 <p>Add configuration support for APRS offset.</p>
2173 </li>
2174 <li>
2175 <p>Adjust flight log sizes to be a multiple of the flight
2176 computer erase block size.</p>
2177 </li>
2178 <li>
2179 <p>Report barometric pad altitude in Pad tab for TeleMini.</p>
2180 </li>
2181 </ul>
2182 </div>
2183 <div style="page-break-after: always;"></div>
2184 </div>
2185 </div>
2186 <div class="sect2">
2187 <h3 id="_release_notes_for_version_1_9_1">E.20. Release Notes for Version 1.9.1</h3>
2188 <div class="paragraph">
2189 <p>Version 1.9.1</p>
2190 </div>
2191 <div class="sect3">
2192 <h4 id="_altos_19">E.20.1. AltOS</h4>
2193 <div class="ulist">
2194 <ul>
2195 <li>
2196 <p>Add support for TeleMetrum v3.0</p>
2197 </li>
2198 <li>
2199 <p>Fix accel cal value when changing EasyMega v2.0 pad orientation</p>
2200 </li>
2201 <li>
2202 <p>Correct EasyMega v2.0 magnetometer data axes</p>
2203 </li>
2204 <li>
2205 <p>Fix EasyMega v2.0 idle monitor display of IMU data</p>
2206 </li>
2207 <li>
2208 <p>Report all sensor failures at power-up time.</p>
2209 </li>
2210 </ul>
2211 </div>
2212 </div>
2213 <div class="sect3">
2214 <h4 id="_altosui_telegps_micropeak_2">E.20.2. AltosUI, TeleGPS, MicroPeak</h4>
2215 <div class="ulist">
2216 <ul>
2217 <li>
2218 <p>Display error message when attempting to graph unknown format file.</p>
2219 </li>
2220 <li>
2221 <p>Make it possible to disable APRS once enabled.</p>
2222 </li>
2223 <li>
2224 <p>Display some data for point near cursor in map tab.</p>
2225 </li>
2226 <li>
2227 <p>Support upgrading devices from pre-1.8 firmware</p>
2228 </li>
2229 <li>
2230 <p>Wait for Windows to prepare new devices during firmware
2231 upgrade. This should avoid the “COMxx: open failed” message.</p>
2232 </li>
2233 </ul>
2234 </div>
2235 <div style="page-break-after: always;"></div>
2236 </div>
2237 </div>
2238 <div class="sect2">
2239 <h3 id="_release_notes_for_version_1_9">E.21. Release Notes for Version 1.9</h3>
2240 <div class="paragraph">
2241 <p>Version 1.9</p>
2242 </div>
2243 <div class="sect3">
2244 <h4 id="_altos_20">E.21.1. AltOS</h4>
2245 <div class="ulist">
2246 <ul>
2247 <li>
2248 <p>Add support for EasyMega v2.0</p>
2249 </li>
2250 <li>
2251 <p>Replace C library for ARM devices</p>
2252 </li>
2253 <li>
2254 <p>Remove support for 8051-based devices and SDCC compiler</p>
2255 </li>
2256 </ul>
2257 </div>
2258 </div>
2259 <div class="sect3">
2260 <h4 id="_altosui_telegps_micropeak_3">E.21.2. AltosUI, TeleGPS, MicroPeak</h4>
2261 <div class="ulist">
2262 <ul>
2263 <li>
2264 <p>Select ROM images based on product name when reflashing</p>
2265 </li>
2266 <li>
2267 <p>Fix TeleGPS v2 battery voltage display</p>
2268 </li>
2269 </ul>
2270 </div>
2271 <div style="page-break-after: always;"></div>
2272 </div>
2273 </div>
2274 <div class="sect2">
2275 <h3 id="_release_notes_for_version_1_8_7">E.22. Release Notes for Version 1.8.7</h3>
2276 <div class="paragraph">
2277 <p>Version 1.8.7</p>
2278 </div>
2279 <div class="sect3">
2280 <h4 id="_altos_21">E.22.1. AltOS</h4>
2281 <div class="ulist">
2282 <ul>
2283 <li>
2284 <p>Include TeleMega v3.0 firmware</p>
2285 </li>
2286 </ul>
2287 </div>
2288 </div>
2289 <div class="sect3">
2290 <h4 id="_altosui_telegps_micropeak_4">E.22.2. AltosUI, TeleGPS, MicroPeak</h4>
2291 <div class="ulist">
2292 <ul>
2293 <li>
2294 <p>Poll for new devices while Device dialog is displayed</p>
2295 </li>
2296 <li>
2297 <p>Wait for device to re-appear when flashing new firmware</p>
2298 </li>
2299 <li>
2300 <p>Fetch correct TeleBT v4.0 RF calibration values from web
2301 site when reflashing.</p>
2302 </li>
2303 <li>
2304 <p>Change gyro headings in .csv files from x/y/z to
2305 roll/pitch/yaw</p>
2306 </li>
2307 <li>
2308 <p>Add documentation about Packet Link mode</p>
2309 </li>
2310 <li>
2311 <p>Add documentation about forcing TeleMini RF parameters to
2312 known values.</p>
2313 </li>
2314 <li>
2315 <p>Create a proxy server for Google Maps to re-enable map
2316 images</p>
2317 </li>
2318 <li>
2319 <p>Fix Java version info in all distributed jar files so that
2320 applications will run with standard Mac OS X Java.</p>
2321 </li>
2322 <li>
2323 <p>Replace JavaApplicationStub for Mac OS X so that
2324 applications will run with Oracle Java.</p>
2325 </li>
2326 </ul>
2327 </div>
2328 <div style="page-break-after: always;"></div>
2329 </div>
2330 </div>
2331 <div class="sect2">
2332 <h3 id="_release_notes_for_version_1_8_6">E.23. Release Notes for Version 1.8.6</h3>
2333 <div class="paragraph">
2334 <p>Version 1.8.6</p>
2335 </div>
2336 <div class="sect3">
2337 <h4 id="_altos_22">E.23.1. AltOS</h4>
2338 <div class="ulist">
2339 <ul>
2340 <li>
2341 <p>Use maximum of 64 previous tilt values in pyro tilt tests</p>
2342 </li>
2343 <li>
2344 <p>Eliminate 100m height requirement for coast detection</p>
2345 </li>
2346 <li>
2347 <p>Change After Motor pyro check to be &gt;= instead of ==</p>
2348 </li>
2349 <li>
2350 <p>Change Time since Boost to be Time since launch.</p>
2351 </li>
2352 </ul>
2353 </div>
2354 </div>
2355 <div class="sect3">
2356 <h4 id="_altosui_telegps">E.23.2. AltosUI, TeleGPS</h4>
2357 <div class="ulist">
2358 <ul>
2359 <li>
2360 <p>Clarify pyro test phrasing</p>
2361 </li>
2362 <li>
2363 <p>Remove ascending/descending from pyro config UI</p>
2364 </li>
2365 <li>
2366 <p>Fix accel calibration in Antenna Down mode</p>
2367 </li>
2368 <li>
2369 <p>Add mag sensor reporting for TeleMega v3 idle monitoring.</p>
2370 </li>
2371 <li>
2372 <p>Fix radio parameter saving at 2400 bps telmetry rate.</p>
2373 </li>
2374 </ul>
2375 </div>
2376 </div>
2377 <div class="sect3">
2378 <h4 id="_micropeak">E.23.3. MicroPeak</h4>
2379 <div class="ulist">
2380 <ul>
2381 <li>
2382 <p>Report altimeter-recorded maximum height value</p>
2383 </li>
2384 </ul>
2385 </div>
2386 <div style="page-break-after: always;"></div>
2387 </div>
2388 </div>
2389 <div class="sect2">
2390 <h3 id="_release_notes_for_version_1_8_5">E.24. Release Notes for Version 1.8.5</h3>
2391 <div class="paragraph">
2392 <p>Version 1.8.5 includes fixes to the ground software support
2393 for TeleBT v4, along with a few other minor updates.</p>
2394 </div>
2395 <div class="sect3">
2396 <h4 id="_altos_23">E.24.1. AltOS</h4>
2397 <div class="ulist">
2398 <ul>
2399 <li>
2400 <p>Fix startup beeps that indicate sensor failures.</p>
2401 </li>
2402 </ul>
2403 </div>
2404 </div>
2405 <div class="sect3">
2406 <h4 id="_altosui_telegps_2">E.24.2. AltosUI, TeleGPS</h4>
2407 <div class="ulist">
2408 <ul>
2409 <li>
2410 <p>When updating device firmware, make sure selected firmware
2411 matches target device.</p>
2412 </li>
2413 <li>
2414 <p>Correct Bluetooth device matching when looking for TeleBT
2415 devices.</p>
2416 </li>
2417 </ul>
2418 </div>
2419 <div style="page-break-after: always;"></div>
2420 </div>
2421 </div>
2422 <div class="sect2">
2423 <h3 id="_release_notes_for_version_1_8_4">E.25. Release Notes for Version 1.8.4</h3>
2424 <div class="paragraph">
2425 <p>Version 1.8.4 includes support for EasyMini version 2.0</p>
2426 </div>
2427 <div class="sect3">
2428 <h4 id="_altos_24">E.25.1. AltOS</h4>
2429 <div class="ulist">
2430 <ul>
2431 <li>
2432 <p>Support for EasyMini version 2.0 hardware.</p>
2433 </li>
2434 </ul>
2435 </div>
2436 <div style="page-break-after: always;"></div>
2437 </div>
2438 </div>
2439 <div class="sect2">
2440 <h3 id="_release_notes_for_version_1_8_3">E.26. Release Notes for Version 1.8.3</h3>
2441 <div class="paragraph">
2442 <p>Version 1.8.3 includes support for TeleMega version 3.0 along
2443 with two important flight computer fixes. This version also
2444 changes KML export data to make Tripoli Record reporting
2445 better and some updates to graph presentation and data
2446 downloading.</p>
2447 </div>
2448 <div class="sect3">
2449 <h4 id="_altos_25">E.26.1. AltOS</h4>
2450 <div class="sect4">
2451 <h5 id="_altos_new_features">AltOS New Features</h5>
2452 <div class="ulist">
2453 <ul>
2454 <li>
2455 <p>Support for TeleMega version 3.0 hardware.</p>
2456 </li>
2457 </ul>
2458 </div>
2459 </div>
2460 <div class="sect4">
2461 <h5 id="_altos_bug_fixes">AltOS Bug Fixes</h5>
2462 <div class="ulist">
2463 <ul>
2464 <li>
2465 <p>Ground testing EasyMega and TeleMega additional pyro
2466 channels could result in a sticky 'fired' status which would
2467 prevent these channels from firing on future flights.</p>
2468 </li>
2469 <li>
2470 <p>Corrupted flight log records could prevent future flights
2471 from capturing log data.</p>
2472 </li>
2473 <li>
2474 <p>Fixed saving of pyro configuration that ended with
2475 'Descending'.</p>
2476 </li>
2477 </ul>
2478 </div>
2479 </div>
2480 </div>
2481 <div class="sect3">
2482 <h4 id="_altosui_and_telegps_applications">E.26.2. AltosUI and TeleGPS Applications</h4>
2483 <div class="sect4">
2484 <h5 id="_altosui_new_features">AltosUI New Features</h5>
2485 <div class="ulist">
2486 <ul>
2487 <li>
2488 <p>Support for TeleMega version 3.0.</p>
2489 </li>
2490 <li>
2491 <p>Graph lines have improved appearance to make them easier to
2492 distinguish. Markers may be placed at data points to show
2493 captured recorded data values.</p>
2494 </li>
2495 <li>
2496 <p>Graphing offers the ability to adjust the smoothing of
2497 computed speed and acceleration data.</p>
2498 </li>
2499 <li>
2500 <p>The download dialog now offers to graph new flights, checks
2501 for existing files to avoid overwriting data and reports if
2502 there are checksum errors in the downloaded data.</p>
2503 </li>
2504 </ul>
2505 </div>
2506 </div>
2507 <div class="sect4">
2508 <h5 id="_altosuitelegps_bug_fixes">AltosUI/TeleGPS Bug Fixes</h5>
2509 <div class="ulist">
2510 <ul>
2511 <li>
2512 <p>Restore TeleGPS tracking behavior.</p>
2513 </li>
2514 <li>
2515 <p>Display flight computer call sign and serial number in
2516 Monitor Idle mode instead of ground station values.</p>
2517 </li>
2518 </ul>
2519 </div>
2520 </div>
2521 <div class="sect4">
2522 <h5 id="_altosui_and_telegps_changes">AltosUI and TeleGPS Changes</h5>
2523 <div class="ulist">
2524 <ul>
2525 <li>
2526 <p>KML export now reports both barometric and GPS altitude data
2527 to make it more useful for Tripoli record reporting.</p>
2528 </li>
2529 <li>
2530 <p>CSV export now includes TeleMega/EasyMega pyro voltages and
2531 tilt angle.</p>
2532 </li>
2533 </ul>
2534 </div>
2535 <div style="page-break-after: always;"></div>
2536 </div>
2537 </div>
2538 </div>
2539 <div class="sect2">
2540 <h3 id="_release_notes_for_version_1_8_2">E.27. Release Notes for Version 1.8.2</h3>
2541 <div class="paragraph">
2542 <p>Version 1.8.2 includes support for TeleGPS version 2.0 along
2543 with accelerometer recalibration support in AltosUI.</p>
2544 </div>
2545 <div class="paragraph">
2546 <p>1.8.2 also contains a couple of minor fixes for AltosUI when
2547 analyzing saved data files.</p>
2548 </div>
2549 <div class="sect3">
2550 <h4 id="_altos_26">E.27.1. AltOS</h4>
2551 <div class="paragraph">
2552 <p>AltOS New Features</p>
2553 </div>
2554 <div class="ulist">
2555 <ul>
2556 <li>
2557 <p>Support for TeleGPS version 2.0 hardware.</p>
2558 </li>
2559 </ul>
2560 </div>
2561 </div>
2562 <div class="sect3">
2563 <h4 id="_altosui_and_telegps_applications_2">E.27.2. AltosUI and TeleGPS Applications</h4>
2564 <div class="paragraph">
2565 <p>AltosUI and TeleGPS New Features</p>
2566 </div>
2567 <div class="ulist">
2568 <ul>
2569 <li>
2570 <p>Support for TeleGPS version 2.0.</p>
2571 </li>
2572 <li>
2573 <p>Accelerometer re-calibration user interface.</p>
2574 </li>
2575 </ul>
2576 </div>
2577 <div class="paragraph">
2578 <p>AltosUI and TeleGPS Bug Fixes</p>
2579 </div>
2580 <div class="ulist">
2581 <ul>
2582 <li>
2583 <p>Prevent some crashes when reading older saved flight data
2584 for graphing or KML export.</p>
2585 </li>
2586 </ul>
2587 </div>
2588 <div style="page-break-after: always;"></div>
2589 </div>
2590 </div>
2591 <div class="sect2">
2592 <h3 id="_release_notes_for_version_1_8_1">E.28. Release Notes for Version 1.8.1</h3>
2593 <div class="paragraph">
2594 <p>Version 1.8.1 includes an important bug fix for Apogee Lockout
2595 operation in all flight computers. Anyone using this option
2596 must update firmware.</p>
2597 </div>
2598 <div class="paragraph">
2599 <p>This release also contains a change in how flight computers
2600 with accelerometers deal with speeds around and above Mach
2601 1. In previous versions, the flight computer would completely
2602 disregard the barometric sensor above 330m/s (around Mach
2603 1). Now, the data from the barometric sensor is reduced in
2604 effect without ever going away entirely. This prevents early
2605 drogue deployment for flights which spend considerable time
2606 above Mach 1.</p>
2607 </div>
2608 <div class="paragraph">
2609 <p>1.8.1 also contains a couple of minor fixes for AltosUI when
2610 analyzing saved data files.</p>
2611 </div>
2612 <div class="sect3">
2613 <h4 id="_altos_27">E.28.1. AltOS</h4>
2614 <div class="paragraph">
2615 <p>AltOS Bug Fixes</p>
2616 </div>
2617 <div class="ulist">
2618 <ul>
2619 <li>
2620 <p>Handle time value wrapping in Apogee Lockout
2621 correctly. Without this, apogee lockout would sometimes
2622 prevent any drogue charge from firing.</p>
2623 </li>
2624 <li>
2625 <p>Change Kalman filter on flight computers with accelerometer
2626 to continue using the barometric sensor even at high speeds
2627 to avoid unintentional drogue deployment during
2628 deceleration.</p>
2629 </li>
2630 </ul>
2631 </div>
2632 </div>
2633 <div class="sect3">
2634 <h4 id="_altosui_and_telegps_applications_3">E.28.2. AltosUI and TeleGPS Applications</h4>
2635 <div class="paragraph">
2636 <p>AltosUI New Features</p>
2637 </div>
2638 <div class="ulist">
2639 <ul>
2640 <li>
2641 <p>Add new 'Huge' font size to make text even bigger on high
2642 resolution monitors.</p>
2643 </li>
2644 </ul>
2645 </div>
2646 <div class="paragraph">
2647 <p>AltosUI Bug Fixes</p>
2648 </div>
2649 <div class="ulist">
2650 <ul>
2651 <li>
2652 <p>Prevent some crashes when reading older saved flight data
2653 for graphing or KML export.</p>
2654 </li>
2655 <li>
2656 <p>Load frequency preference at startup. The loading code was
2657 broken, so you&#8217;d see only the default frequencies.</p>
2658 </li>
2659 </ul>
2660 </div>
2661 <div style="page-break-after: always;"></div>
2662 </div>
2663 </div>
2664 <div class="sect2">
2665 <h3 id="_release_notes_for_version_1_8">E.29. Release Notes for Version 1.8</h3>
2666 <div class="paragraph">
2667 <p>Version 1.8 includes support for our new TeleBT v4.0 ground
2668 station, updates for data analysis in our ground station
2669 software and bug fixes in in the flight software for all our
2670 boards and ground station interfaces.</p>
2671 </div>
2672 <div class="sect3">
2673 <h4 id="_altos_28">E.29.1. AltOS</h4>
2674 <div class="paragraph">
2675 <p>AltOS New Features</p>
2676 </div>
2677 <div class="ulist">
2678 <ul>
2679 <li>
2680 <p>Add support for TeleBT v4.0 boards.</p>
2681 </li>
2682 </ul>
2683 </div>
2684 </div>
2685 <div class="sect3">
2686 <h4 id="_altosui_and_telegps_applications_4">E.29.2. AltosUI and TeleGPS Applications</h4>
2687 <div class="paragraph">
2688 <p>AltosUI New Features</p>
2689 </div>
2690 <div class="ulist">
2691 <ul>
2692 <li>
2693 <p>Add support for TeleBT v4.0 hardware</p>
2694 </li>
2695 <li>
2696 <p>Rewrite graphing and export functions. This code now handles
2697 each data series separately so that graphs are drawn
2698 correctly. Smoothing now uses a filter that looks both
2699 forward and backwards in time to make computed speed and
2700 acceleration data more accurate.</p>
2701 </li>
2702 </ul>
2703 </div>
2704 <div class="paragraph">
2705 <p>AltosUI Bug Fixes</p>
2706 </div>
2707 <div class="ulist">
2708 <ul>
2709 <li>
2710 <p>Correct axis labeling of magnetic sensor in TeleMega and
2711 EasyMega. The Y and Z axes were flipped.</p>
2712 </li>
2713 </ul>
2714 </div>
2715 <div style="page-break-after: always;"></div>
2716 </div>
2717 </div>
2718 <div class="sect2">
2719 <h3 id="_release_notes_for_version_1_7">E.30. Release Notes for Version 1.7</h3>
2720 <div class="paragraph">
2721 <p>Version 1.7 includes support for our new TeleMini v3.0
2722 flight computer and bug fixes in in the flight software for all our boards
2723 and ground station interfaces.</p>
2724 </div>
2725 <div class="sect3">
2726 <h4 id="_altos_29">E.30.1. AltOS</h4>
2727 <div class="paragraph">
2728 <p>AltOS New Features</p>
2729 </div>
2730 <div class="ulist">
2731 <ul>
2732 <li>
2733 <p>Add support for TeleMini v3.0 boards.</p>
2734 </li>
2735 </ul>
2736 </div>
2737 <div class="paragraph">
2738 <p>AltOS Fixes</p>
2739 </div>
2740 <div class="ulist">
2741 <ul>
2742 <li>
2743 <p>Fix interrupt priorities on STM32L processors. Run timer
2744 interrupt at lowest priority so that device interrupts get
2745 serviced first.</p>
2746 </li>
2747 </ul>
2748 </div>
2749 </div>
2750 <div class="sect3">
2751 <h4 id="_altosui_and_telegps_applications_5">E.30.2. AltosUI and TeleGPS Applications</h4>
2752 <div class="paragraph">
2753 <p>AltosUI New Features</p>
2754 </div>
2755 <div class="ulist">
2756 <ul>
2757 <li>
2758 <p>Add support for TeleMini v3.0 hardware</p>
2759 </li>
2760 </ul>
2761 </div>
2762 <div style="page-break-after: always;"></div>
2763 </div>
2764 </div>
2765 <div class="sect2">
2766 <h3 id="_release_notes_for_version_1_6_8">E.31. Release Notes for Version 1.6.8</h3>
2767 <div class="paragraph">
2768 <p>Version 1.6.8 fixes a TeleMega and TeleMetrum v2.0 bug where
2769 the device could stop logging data and transmitting
2770 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
2771 v2.0 users should update their flight firmware.</p>
2772 </div>
2773 <div class="sect3">
2774 <h4 id="_altos_30">E.31.1. AltOS</h4>
2775 <div class="paragraph">
2776 <p>AltOS fixes:</p>
2777 </div>
2778 <div class="ulist">
2779 <ul>
2780 <li>
2781 <p>Fix STM32L DMA driver to work around STM32L SoC DMA priority
2782 issue t lock-up in the logging or radio code, either of
2783 which could stop data logging and telemetry.</p>
2784 </li>
2785 <li>
2786 <p>Avoid having TeleBT battery status values smash telemetry
2787 packet data by holding a lock during both operations.</p>
2788 </li>
2789 <li>
2790 <p>Don&#8217;t start reporting 'flight 0' when the log fills in
2791 flight.</p>
2792 </li>
2793 </ul>
2794 </div>
2795 <div class="paragraph">
2796 <p>AltOS changes:</p>
2797 </div>
2798 <div class="ulist">
2799 <ul>
2800 <li>
2801 <p>Flash LEDS on all products briefly during power up so that
2802 they can be tested during production.</p>
2803 </li>
2804 </ul>
2805 </div>
2806 </div>
2807 <div class="sect3">
2808 <h4 id="_altosui_telegps_and_altosdroid_applications">E.31.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
2809 <div class="paragraph">
2810 <p>AltosUI fixes:</p>
2811 </div>
2812 <div class="ulist">
2813 <ul>
2814 <li>
2815 <p>Re-enable go/no-go entries after they&#8217;ve been disabled due
2816 to lack of data. If telemetry information is delayed when
2817 the Ui starts up, sometimes important fields would get
2818 disabled to never re-appear.</p>
2819 </li>
2820 <li>
2821 <p>Deal with ground station failure better during Configure
2822 Ground Station operation by cleaning up pending operations.</p>
2823 </li>
2824 </ul>
2825 </div>
2826 <div style="page-break-after: always;"></div>
2827 </div>
2828 </div>
2829 <div class="sect2">
2830 <h3 id="_release_notes_for_version_1_6_5">E.32. Release Notes for Version 1.6.5</h3>
2831 <div class="paragraph">
2832 <p>Version 1.6.5 fixes a TeleMega and TeleMetrum v2.0 bug where
2833 the device would often stop logging data and transmitting
2834 telemetry in flight. All TeleMega v1.0, v2.0 and TeleMetrum
2835 v2.0 users should update their flight firmware.</p>
2836 </div>
2837 <div class="sect3">
2838 <h4 id="_altos_31">E.32.1. AltOS</h4>
2839 <div class="paragraph">
2840 <p>AltOS fixes:</p>
2841 </div>
2842 <div class="ulist">
2843 <ul>
2844 <li>
2845 <p>Fix STM32L SPI driver to prevent lock-up in the logging or
2846 radio code, either of which could stop data logging and
2847 telemetry. Found and characterized by Chuck Haskin, who also
2848 tested the new firmware before release.</p>
2849 </li>
2850 </ul>
2851 </div>
2852 </div>
2853 <div class="sect3">
2854 <h4 id="_altosui_telegps_and_altosdroid_applications_2">E.32.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
2855 <div class="paragraph">
2856 <p>AltosUI fixes:</p>
2857 </div>
2858 <div class="ulist">
2859 <ul>
2860 <li>
2861 <p>Deliver firmward for TeleMega v2.0 and TeleBT v3.0 with
2862 Windows package.</p>
2863 </li>
2864 </ul>
2865 </div>
2866 <div style="page-break-after: always;"></div>
2867 </div>
2868 </div>
2869 <div class="sect2">
2870 <h3 id="_release_notes_for_version_1_6_4">E.33. Release Notes for Version 1.6.4</h3>
2871 <div class="paragraph">
2872 <p>Version 1.6.4 fixes a bluetooth communication problem with
2873 TeleBT v1.0 devices, along with some altosui and altosdroid
2874 minor nits. It also now ships firmware for some newer devices.</p>
2875 </div>
2876 <div class="sect3">
2877 <h4 id="_altos_32">E.33.1. AltOS</h4>
2878 <div class="paragraph">
2879 <p>AltOS fixes:</p>
2880 </div>
2881 <div class="ulist">
2882 <ul>
2883 <li>
2884 <p>Fix hardware flow control on TeleBT v1.0. Hardware RTS/CTS
2885 doesn&#8217;t seem to work, switch from using the hardware to
2886 driving these pins with software.</p>
2887 </li>
2888 <li>
2889 <p>Fix ARM USB drivers to deal with OS restarts. Needed to
2890 reset all USB-related state when the USB bus is reset. These
2891 fixes affect all STM32L, STM32F0 and LPC11U14 based devices.</p>
2892 </li>
2893 </ul>
2894 </div>
2895 </div>
2896 <div class="sect3">
2897 <h4 id="_altosui_telegps_and_altosdroid_applications_3">E.33.2. AltosUI, TeleGPS and AltosDroid Applications</h4>
2898 <div class="paragraph">
2899 <p>AltosUI, TeleGPS and AltosDroid New Features:</p>
2900 </div>
2901 <div class="ulist">
2902 <ul>
2903 <li>
2904 <p>Automatically switch from meters or feet to kilometers or
2905 miles for distance units.</p>
2906 </li>
2907 <li>
2908 <p>Add Monitor Idle mode to TeleGPS application.</p>
2909 </li>
2910 </ul>
2911 </div>
2912 <div class="paragraph">
2913 <p>AltosUI, TeleGPS and AltosDroid Fixes:</p>
2914 </div>
2915 <div class="ulist">
2916 <ul>
2917 <li>
2918 <p>Abort map preloading when the preload map dialog is closed.</p>
2919 </li>
2920 <li>
2921 <p>In AltosDroid, Don&#8217;t reconnect to last device if the user
2922 had disconnected it the last time the application was
2923 active.</p>
2924 </li>
2925 </ul>
2926 </div>
2927 </div>
2928 <div class="sect3">
2929 <h4 id="_documentation">E.33.3. Documentation</h4>
2930 <div class="ulist">
2931 <ul>
2932 <li>
2933 <p>Mention TeleMega v2.0 in hardware specs table.</p>
2934 </li>
2935 <li>
2936 <p>Document TeleGPS RF output in telegps manual.</p>
2937 </li>
2938 </ul>
2939 </div>
2940 </div>
2941 </div>
2942 <div class="sect2">
2943 <h3 id="_release_notes_for_version_1_6_3">E.34. Release Notes for Version 1.6.3</h3>
2944 <div class="paragraph">
2945 <p>Version 1.6.3 adds idle mode to AltosDroid and has bug fixes
2946 for our host software on desktops, laptops an android devices
2947 along with BlueTooth support for Windows.</p>
2948 </div>
2949 <div class="sect3">
2950 <h4 id="_altos_33">E.34.1. AltOS</h4>
2951 <div class="paragraph">
2952 <p>AltOS fixes:</p>
2953 </div>
2954 <div class="ulist">
2955 <ul>
2956 <li>
2957 <p>Fix hardware flow control on TeleBT v3.0. RTS/CTS is
2958 wired backwards on this board, switch from using the
2959 hardware to driving these pins with software.</p>
2960 </li>
2961 </ul>
2962 </div>
2963 </div>
2964 <div class="sect3">
2965 <h4 id="_altosui_and_telegps_applications_6">E.34.2. AltosUI and TeleGPS Applications</h4>
2966 <div class="paragraph">
2967 <p>AltosUI and TeleGPS New Features:</p>
2968 </div>
2969 <div class="ulist">
2970 <ul>
2971 <li>
2972 <p>Add BlueTooth support for Windows operating system. This
2973 supports connections to TeleBT over BlueTooth rather than
2974 just USB.</p>
2975 </li>
2976 </ul>
2977 </div>
2978 <div class="paragraph">
2979 <p>AltosUI and TeleGPS Fixes:</p>
2980 </div>
2981 <div class="ulist">
2982 <ul>
2983 <li>
2984 <p>Change Java detection and install on Windows. Detection is
2985 now done by looking for the 'javaw.exe' program, and
2986 installation by opening a browser on the java.com web site.</p>
2987 </li>
2988 <li>
2989 <p>Delay polling while the Fire Igniters is visible to allow
2990 for TeleMega to report back complete status over the radio.</p>
2991 </li>
2992 <li>
2993 <p>Disallow changing RF calibration numbers in the
2994 configuration UI. There&#8217;s no good reason to change this from
2995 the field, and recovering is really hard if you haven&#8217;t
2996 written down the right number.</p>
2997 </li>
2998 <li>
2999 <p>Fix USB device discovery on Mac OS X El Capitan. This makes
3000 the connected Altus Metrum USB devices appear again.</p>
3001 </li>
3002 <li>
3003 <p>Fix acceleration data presented in MonitorIdle mode for
3004 TeleMetrum v2.0 flight computers.</p>
3005 </li>
3006 </ul>
3007 </div>
3008 </div>
3009 <div class="sect3">
3010 <h4 id="_altosdroid_5">E.34.3. AltosDroid</h4>
3011 <div class="paragraph">
3012 <p>AltosDroid new features:</p>
3013 </div>
3014 <div class="ulist">
3015 <ul>
3016 <li>
3017 <p>Monitor Idle mode. Check state of flight computer while in
3018 idle mode over the radio link</p>
3019 </li>
3020 <li>
3021 <p>Fire Igniters. Remotely fire ignires for recovery system
3022 ground tests.</p>
3023 </li>
3024 <li>
3025 <p>Remote reboot. Cause the flight computer to reboot over the
3026 radio link. This provides a method for switching the flight
3027 computer from idle to flight mode without needing to reach
3028 the power switch.</p>
3029 </li>
3030 <li>
3031 <p>Configurable frequency menu. Change the set of available
3032 frequencies and provide more descriptive names.</p>
3033 </li>
3034 </ul>
3035 </div>
3036 <div class="paragraph">
3037 <p>AltosDroid bug fixes:</p>
3038 </div>
3039 <div class="ulist">
3040 <ul>
3041 <li>
3042 <p>Don&#8217;t set target location if GPS hasn&#8217;t locked yet.</p>
3043 </li>
3044 <li>
3045 <p>Fix saving target states so they can be reloaded when the
3046 application restarts. When the application is shut down and
3047 restarted, all previous target state information will be
3048 restored (including GPS position if available).</p>
3049 </li>
3050 <li>
3051 <p>Fix crash on some Android devices for offline maps when
3052 changing the map scale or location.</p>
3053 </li>
3054 <li>
3055 <p>Don&#8217;t require USB OTG support. This kept the latest
3056 AltosDroid from being offered on devices without USB device
3057 support, although it can work without that just fine using
3058 BlueTooth.</p>
3059 </li>
3060 <li>
3061 <p>Don&#8217;t require bluetooth to be enabled. This allows the
3062 application to operate with USB devices or just show old
3063 data without turning on the bluetooth radio.</p>
3064 </li>
3065 <li>
3066 <p>Recover old tracker positions when restarting
3067 application. This finally allows you to safely stop and
3068 restart the application without losing the last known
3069 location of any tracker.</p>
3070 </li>
3071 </ul>
3072 </div>
3073 </div>
3074 <div class="sect3">
3075 <h4 id="_documentation_2">E.34.4. Documentation</h4>
3076 <div class="ulist">
3077 <ul>
3078 <li>
3079 <p>Document TeleMega and EasyMega additional pyro channel
3080 continuity audio alert pattern.</p>
3081 </li>
3082 </ul>
3083 </div>
3084 <div style="page-break-after: always;"></div>
3085 </div>
3086 </div>
3087 <div class="sect2">
3088 <h3 id="_release_notes_for_version_1_6_2">E.35. Release Notes for Version 1.6.2</h3>
3089 <div class="paragraph">
3090 <p>Version 1.6.2 includes support for our updated TeleMega v2.0
3091 product and bug fixes in in the flight software for all our boards
3092 and ground station interfaces.</p>
3093 </div>
3094 <div class="sect3">
3095 <h4 id="_altos_34">E.35.1. AltOS</h4>
3096 <div class="paragraph">
3097 <p>AltOS New Features:</p>
3098 </div>
3099 <div class="ulist">
3100 <ul>
3101 <li>
3102 <p>Add support for TeleMega v2.0 boards.</p>
3103 </li>
3104 <li>
3105 <p>Add PWM servo driver. There&#8217;s no higher level code using
3106 this yet, but the driver allows testing of the TeleMega v2.0
3107 servo output connector.</p>
3108 </li>
3109 </ul>
3110 </div>
3111 <div class="paragraph">
3112 <p>AltOS Fixes:</p>
3113 </div>
3114 <div class="ulist">
3115 <ul>
3116 <li>
3117 <p>Slow down telemetry packets to allow receiver to keep
3118 up.</p>
3119 </li>
3120 </ul>
3121 </div>
3122 </div>
3123 <div class="sect3">
3124 <h4 id="_altosui_and_telegps_applications_7">E.35.2. AltosUI and TeleGPS Applications</h4>
3125 <div class="paragraph">
3126 <p>AltosUI and TeleGPS Fixes:</p>
3127 </div>
3128 <div class="ulist">
3129 <ul>
3130 <li>
3131 <p>Fix post-flight orientation computation when processing
3132 TeleMega and EasyMega eeprom data files.</p>
3133 </li>
3134 <li>
3135 <p>Capture complete eeprom data even when there are invalid
3136 entries in the data. This keeps reading eeprom contents and
3137 writing the associated .eeprom file when an error is detected.</p>
3138 </li>
3139 </ul>
3140 </div>
3141 </div>
3142 <div class="sect3">
3143 <h4 id="_documentation_3">E.35.3. Documentation</h4>
3144 <div class="paragraph">
3145 <p>We spent a bunch of time trying to improve our documentation</p>
3146 </div>
3147 <div class="ulist">
3148 <ul>
3149 <li>
3150 <p>HTML versions now have a table of contents on the left side.</p>
3151 </li>
3152 <li>
3153 <p>EasyMini now has its own shorter manual.</p>
3154 </li>
3155 <li>
3156 <p>Provide links between sections in each document.</p>
3157 </li>
3158 <li>
3159 <p>Lots of minor rewriting and restructuring to avoid
3160 duplication of information</p>
3161 </li>
3162 </ul>
3163 </div>
3164 <div style="page-break-after: always;"></div>
3165 </div>
3166 </div>
3167 <div class="sect2">
3168 <h3 id="_release_notes_for_version_1_6_1">E.36. Release Notes for Version 1.6.1</h3>
3169 <div class="paragraph">
3170 <p>Version 1.6.1 includes support for our updated TeleBT v3.0
3171 product and bug fixes in in the flight software for all our boards
3172 and ground station interfaces.</p>
3173 </div>
3174 <div class="sect3">
3175 <h4 id="_altos_35">E.36.1. AltOS</h4>
3176 <div class="paragraph">
3177 <p>AltOS New Features:</p>
3178 </div>
3179 <div class="ulist">
3180 <ul>
3181 <li>
3182 <p>Add support for TeleBT v3.0 boards.</p>
3183 </li>
3184 <li>
3185 <p>Add support for uncompressed APRS data, providing support
3186 for older APRS receivers. Uncompressed APRS data is less
3187 precise, takes more bandwidth and doesn&#8217;t have integrated
3188 altitude data.</p>
3189 </li>
3190 </ul>
3191 </div>
3192 <div class="paragraph">
3193 <p>AltOS Fixes:</p>
3194 </div>
3195 <div class="ulist">
3196 <ul>
3197 <li>
3198 <p>Make TeleDongle and TeleBT more tolerant of data rate
3199 variations from transmitting devices.</p>
3200 </li>
3201 </ul>
3202 </div>
3203 </div>
3204 <div class="sect3">
3205 <h4 id="_altosui_and_telegps_applications_8">E.36.2. AltosUI and TeleGPS Applications</h4>
3206 <div class="paragraph">
3207 <p>AltosUI and TeleGPS New Features:</p>
3208 </div>
3209 <div class="ulist">
3210 <ul>
3211 <li>
3212 <p>Add map to Monitor Idle display. It&#8217;s nice to be able to
3213 verify that maps are working, instead of needing to use
3214 Monitor Flight.</p>
3215 </li>
3216 </ul>
3217 </div>
3218 <div class="paragraph">
3219 <p>AltosUI and TeleGPS Fixes:</p>
3220 </div>
3221 <div class="ulist">
3222 <ul>
3223 <li>
3224 <p>Fix frequency configuration to round values instead of
3225 truncate them, avoiding a common 1kHz error in the setting.</p>
3226 </li>
3227 <li>
3228 <p>Turn the Windows stub into a more useful program that can
3229 launch the application with parameters so that file manager
3230 icons work more reliably.</p>
3231 </li>
3232 <li>
3233 <p>Force KML export to use a C locale so that numbers are
3234 formatted with '.' instead of ',' for a decimal separator in
3235 non-US locales.</p>
3236 </li>
3237 <li>
3238 <p>Preload map tiles based on distance rather than number of
3239 tiles; this means you get the same resolution covering the
3240 entire area, rather than having high resolution near the
3241 center and low resolution further away.</p>
3242 </li>
3243 <li>
3244 <p>Allow configuration of frequency and callsign in Monitor
3245 Idle mode.</p>
3246 </li>
3247 <li>
3248 <p>Fix layout weirdness when resizing windows on
3249 Windows. Windows shouldn&#8217;t have giant blank spaces around
3250 the useful content anymore.</p>
3251 </li>
3252 <li>
3253 <p>Fix layout weirdness when resizing windows on
3254 Windows. Windows shouldn&#8217;t have giant blank spaces around
3255 the useful content anymore.</p>
3256 </li>
3257 <li>
3258 <p>Use a longer filter for descent speed values. This should
3259 provide something more useful on the display, although it
3260 will take longer to respond to changes now.</p>
3261 </li>
3262 <li>
3263 <p>Make Replay Flight run in realtime again. It had been set to
3264 run at 10x speed by mistake.</p>
3265 </li>
3266 </ul>
3267 </div>
3268 </div>
3269 <div class="sect3">
3270 <h4 id="_altosdroid_6">E.36.3. AltosDroid</h4>
3271 <div class="paragraph">
3272 <p>AltosDroid New Features:</p>
3273 </div>
3274 <div class="ulist">
3275 <ul>
3276 <li>
3277 <p>Add offline map support using mapping code from AltosUI.</p>
3278 </li>
3279 <li>
3280 <p>Support TeleDongle (and TeleBT via USB) on devices
3281 supporting USB On-The-Go.</p>
3282 </li>
3283 <li>
3284 <p>Display additional TeleMega pyro channel status in Pad tab.</p>
3285 </li>
3286 <li>
3287 <p>Switch between metric and imperial units.</p>
3288 </li>
3289 <li>
3290 <p>Monitor TeleBT battery voltage.</p>
3291 </li>
3292 <li>
3293 <p>Track multiple devices at the same time, selecting between
3294 them with a menu or using the map.</p>
3295 </li>
3296 <li>
3297 <p>Add hybrid, satellite and terrain map types.</p>
3298 </li>
3299 </ul>
3300 </div>
3301 <div class="paragraph">
3302 <p>AltosDroid Fixes:</p>
3303 </div>
3304 <div class="ulist">
3305 <ul>
3306 <li>
3307 <p>Use standard Android display conventions so that a menu
3308 button is available in the application title bar.</p>
3309 </li>
3310 <li>
3311 <p>Adjust layout to work on large and small screens; shrinking
3312 the go/no-go lights in smaller environments to try and make
3313 everything visible.</p>
3314 </li>
3315 <li>
3316 <p>Make voice announcements depend on current tab.</p>
3317 </li>
3318 <li>
3319 <p>Compute adjustment to current travel direction while in
3320 motion towards rocket.</p>
3321 </li>
3322 </ul>
3323 </div>
3324 <div style="page-break-after: always;"></div>
3325 </div>
3326 </div>
3327 <div class="sect2">
3328 <h3 id="_release_notes_for_version_1_6">E.37. Release Notes for Version 1.6</h3>
3329 <div class="paragraph">
3330 <p>Version 1.6 includes support for our updated TeleDongle v3.0
3331 product and bug fixes in in the flight software for all our boards
3332 and ground station interfaces.</p>
3333 </div>
3334 <div class="sect3">
3335 <h4 id="_altos_36">E.37.1. AltOS</h4>
3336 <div class="paragraph">
3337 <p>AltOS New Features</p>
3338 </div>
3339 <div class="ulist">
3340 <ul>
3341 <li>
3342 <p>Add support for TeleDongle v3.0 boards.</p>
3343 </li>
3344 </ul>
3345 </div>
3346 <div class="paragraph">
3347 <p>AltOS Fixes</p>
3348 </div>
3349 <div class="ulist">
3350 <ul>
3351 <li>
3352 <p>Don&#8217;t beep out the continuity twice by accident in idle mode.
3353 If the battery voltage report takes longer than the initialiation
3354 sequence, the igniter continuity would get reported twice.</p>
3355 </li>
3356 <li>
3357 <p>Record all 32 bits of gyro calibration data in TeleMega and
3358 EasyMega log files. This fixes computation of the gyro rates
3359 in AltosUI.</p>
3360 </li>
3361 <li>
3362 <p>Change TeleDongle LED usage. Green LED flashes when valid
3363 packet is received. Red LED flashes when invalid packet is
3364 received.</p>
3365 </li>
3366 <li>
3367 <p>Replace LPC11U14 SPI driver with non-interrupt version. The
3368 interrupt code would occasionally wedge on long transfers
3369 if interrupts were blocked for too long. This affects all
3370 released TeleGPS products; if you have a TeleGPS device,
3371 you&#8217;ll want to reflash the firmware.</p>
3372 </li>
3373 </ul>
3374 </div>
3375 </div>
3376 <div class="sect3">
3377 <h4 id="_altosui_and_telegps_applications_9">E.37.2. AltosUI and TeleGPS Applications</h4>
3378 <div class="paragraph">
3379 <p>AltosUI and TeleGPS New Features</p>
3380 </div>
3381 <div class="ulist">
3382 <ul>
3383 <li>
3384 <p>Compute tilt angle from TeleMega and EasyMega log
3385 files. This duplicates the quaternion-based angle tracking
3386 code from the flight firmware inside the ground station
3387 software so that post-flight analysis can include evaluation
3388 of the tilt angle.</p>
3389 </li>
3390 <li>
3391 <p>Shows the tool button window when starting with a data file
3392 specified. This means that opening a data file from the file
3393 manager will now bring up the main window to let you operate
3394 the whole application.</p>
3395 </li>
3396 </ul>
3397 </div>
3398 <div class="paragraph">
3399 <p>AltosUI Fixes</p>
3400 </div>
3401 <div class="ulist">
3402 <ul>
3403 <li>
3404 <p>Show the 'Connecting' dialog when using Monitor Idle. Lets
3405 you cancel the Monitor Idle startup when connecting over the
3406 radio link.</p>
3407 </li>
3408 <li>
3409 <p>Make 'Monitor Idle' work for TeleGPS devices when connected
3410 over USB. It&#8217;s nice for testing without needing to broadcast
3411 over the radio.</p>
3412 </li>
3413 <li>
3414 <p>Use different Windows API to discover USB devices. This
3415 works better on my Windows 7 box, and will be used if the
3416 older API fails to provide the necessary information.</p>
3417 </li>
3418 <li>
3419 <p>Look in more places in the registry to try and identify the
3420 installed Java version on Windows. If you install the
3421 default 32-bit version of Windows on a 64-bit OS, the Java
3422 registry information is hiding \SOFTWARE\Wow6432Node for
3423 some reason.</p>
3424 </li>
3425 <li>
3426 <p>Fix file association on Windows by searching for the
3427 javaw.exe program instead of assuming it is in
3428 %SYSTEMROOT%. This makes double-clicking on Altus Metrum
3429 data files in the file manager work correctly.</p>
3430 </li>
3431 <li>
3432 <p>When replaying a file, put 'done' in the Age field when we
3433 reach the end of the file, instead of continuing to count forever.</p>
3434 </li>
3435 <li>
3436 <p>In the Scan Channels code, wait for five seconds if we see
3437 any packet. This is needed because AltOS now sends the
3438 callsign, serial number and flight number only once every
3439 five seconds these days.</p>
3440 </li>
3441 <li>
3442 <p>In the Scan Channels code, reset pending flight state
3443 information each time we change channels. This avoids having
3444 flight computers appear on multiple frequencies by accident.</p>
3445 </li>
3446 </ul>
3447 </div>
3448 <div style="page-break-after: always;"></div>
3449 </div>
3450 </div>
3451 <div class="sect2">
3452 <h3 id="_release_notes_for_version_1_5">E.38. Release Notes for Version 1.5</h3>
3453 <div class="paragraph">
3454 <p>Version 1.5 is a major release. It includes support for our new
3455 EasyMega product, new features and bug fixes in in the flight
3456 software for all our boards and the AltosUI ground station</p>
3457 </div>
3458 <div class="sect3">
3459 <h4 id="_altos_37">E.38.1. AltOS</h4>
3460 <div class="paragraph">
3461 <p>AltOS New Features</p>
3462 </div>
3463 <div class="ulist">
3464 <ul>
3465 <li>
3466 <p>Add support for EasyMega boards.</p>
3467 </li>
3468 <li>
3469 <p>Make the APRS SSID be configurable. This lets you track
3470 different rockets on the same receiver without getting
3471 things mixed up.</p>
3472 </li>
3473 <li>
3474 <p>Report extra pyro channel continuity state on EasyMega and
3475 TeleMega via the beeper. This lets you easily verify flight
3476 readiness on these boards after powering up the electronics
3477 on the rail.</p>
3478 </li>
3479 <li>
3480 <p>Add lower telemetry data rates (2400 and 9600 bps) to
3481 increase telemetry radio range. This reduces the amount of
3482 data received as well as increasing battery consumption in
3483 the transmitter.</p>
3484 </li>
3485 <li>
3486 <p>Change TeleGPS to have only a single log, and append new
3487 data to it rather than using seperate per-flight logs. This
3488 avoids accidentally filling up log storage by turning
3489 TeleGPS on/off several times.</p>
3490 </li>
3491 </ul>
3492 </div>
3493 <div class="paragraph">
3494 <p>AltOS Fixes</p>
3495 </div>
3496 <div class="ulist">
3497 <ul>
3498 <li>
3499 <p>Increase the maximum range for altitude values from +/-32767m
3500 to +/-2147483647m, allowing the flight computers to function
3501 correctly above the 32km level.</p>
3502 </li>
3503 <li>
3504 <p>Continuously test pyro firing conditions during delay stage,
3505 inhibiting the pyro channel if the test fails. This prevents
3506 firing pyro charges where the conditions were good before
3507 the delay, but become bad before the delay expires.</p>
3508 </li>
3509 <li>
3510 <p>Allow negative numbers in pyro configuration values. This
3511 lets you specify things like descending speed or
3512 deceleration.</p>
3513 </li>
3514 </ul>
3515 </div>
3516 </div>
3517 <div class="sect3">
3518 <h4 id="_altosui_and_telegps_applications_10">E.38.2. AltosUI and TeleGPS Applications</h4>
3519 <div class="paragraph">
3520 <p>AltosUI and TeleGPS New Features</p>
3521 </div>
3522 <div class="ulist">
3523 <ul>
3524 <li>
3525 <p>Support telemetry baud rate selection. Adds menus to
3526 the flight monitoring and configuration for baud rate
3527 selection.</p>
3528 </li>
3529 <li>
3530 <p>Support APRS SSID configuration.</p>
3531 </li>
3532 <li>
3533 <p>Integrate with file managers. This provides icons for all of
3534 our file types and associates our application with the files
3535 so that using a file manager to open a AltOS data file
3536 results in launching our application.</p>
3537 </li>
3538 </ul>
3539 </div>
3540 <div class="paragraph">
3541 <p>AltosUI Fixes</p>
3542 </div>
3543 <div class="ulist">
3544 <ul>
3545 <li>
3546 <p>Make the 'Graph' button on the landed tab work again.</p>
3547 </li>
3548 <li>
3549 <p>Make tests for Java on Windows a bit smarter, and also
3550 provide the user with the option to skip installing Java for
3551 cases where we just can&#8217;t figure out what version is installed.</p>
3552 </li>
3553 </ul>
3554 </div>
3555 <div style="page-break-after: always;"></div>
3556 </div>
3557 </div>
3558 <div class="sect2">
3559 <h3 id="_release_notes_for_version_1_4_2">E.39. Release Notes for Version 1.4.2</h3>
3560 <div class="paragraph">
3561 <p>Version 1.4.2 is a minor release. It fixes Java-related install issues on
3562 Windows</p>
3563 </div>
3564 <div class="sect3">
3565 <h4 id="_altosui_and_telegps_applications_11">E.39.1. AltosUI and TeleGPS Applications</h4>
3566 <div class="paragraph">
3567 <p>Windows Install Fixes</p>
3568 </div>
3569 <div class="ulist">
3570 <ul>
3571 <li>
3572 <p>Checks for Java installation data in more registry locations.</p>
3573 </li>
3574 <li>
3575 <p>Allows user to bypass Java installation in case the
3576 detection fails.</p>
3577 </li>
3578 </ul>
3579 </div>
3580 <div style="page-break-after: always;"></div>
3581 </div>
3582 </div>
3583 <div class="sect2">
3584 <h3 id="_release_notes_for_version_1_4_1">E.40. Release Notes for Version 1.4.1</h3>
3585 <div class="paragraph">
3586 <p>Version 1.4.1 is a minor release. It fixes install issues on
3587 Windows and provides the missing TeleMetrum V2.0 firmware. There
3588 aren&#8217;t any changes to the firmware or host applications at
3589 all. All Windows users will want to upgrade to get the signed
3590 driver, but Mac and Linux users who do not need the TeleMetrum
3591 V2.0 firmware image will not need to upgrade.</p>
3592 </div>
3593 <div class="sect3">
3594 <h4 id="_altosui_and_telegps_applications_12">E.40.1. AltosUI and TeleGPS Applications:</h4>
3595 <div class="paragraph">
3596 <p>Windows Install Fixes</p>
3597 </div>
3598 <div class="ulist">
3599 <ul>
3600 <li>
3601 <p>Provide signed Windows driver files. This should avoid any need to
3602 disable driver signature checking on Windows 7 or 8.</p>
3603 </li>
3604 <li>
3605 <p>Fix Java version detection and download. Previously, the
3606 installer would only look for Java 6 or 7 and insist on
3607 downloading its own Java bits if there was something else
3608 installed. Furthermore, the 64-bit Java link provided didn&#8217;t
3609 work for anyone other than Keith, making it impossible to
3610 install AltOS on any machine with Java SE 8 installed.</p>
3611 </li>
3612 </ul>
3613 </div>
3614 <div class="paragraph">
3615 <p>Other Fixes</p>
3616 </div>
3617 <div class="ulist">
3618 <ul>
3619 <li>
3620 <p>Include 1.4 firmware for TeleMetrum V2.0. None of the
3621 installers shipped this file. Now it&#8217;s included in the AltOS
3622 packages for Linux, Mac and Windows.</p>
3623 </li>
3624 <li>
3625 <p>Include Google Application Key for map downloading. The 1.4
3626 release didn&#8217;t have this key in the released version of the
3627 software, making map downloading fail for most people.</p>
3628 </li>
3629 </ul>
3630 </div>
3631 <div style="page-break-after: always;"></div>
3632 </div>
3633 </div>
3634 <div class="sect2">
3635 <h3 id="_release_notes_for_version_1_4">E.41. Release Notes for Version 1.4</h3>
3636 <div class="paragraph">
3637 <p>Version 1.4 is a major release. It includes support for our new
3638 TeleGPS product, new features and bug fixes in in the flight
3639 software for all our boards and the AltosUI ground station</p>
3640 </div>
3641 <div class="sect3">
3642 <h4 id="_altos_38">E.41.1. AltOS</h4>
3643 <div class="paragraph">
3644 <p>AltOS new features:</p>
3645 </div>
3646 <div class="ulist">
3647 <ul>
3648 <li>
3649 <p>Add support for TeleGPS boards.</p>
3650 </li>
3651 <li>
3652 <p>Make the beeper tone configurable, making it
3653 possible to distinguish between two Altus Metrum
3654 products in the same ebay.</p>
3655 </li>
3656 <li>
3657 <p>Make the firing time for extra pyro channels
3658 configurable, allowing longer (or shorter) than the
3659 default 50ms.  Only relevant for TeleMega at this
3660 time.</p>
3661 </li>
3662 </ul>
3663 </div>
3664 <div class="paragraph">
3665 <p>AltOS fixes:</p>
3666 </div>
3667 <div class="ulist">
3668 <ul>
3669 <li>
3670 <p>Replace the 'dit dit dit' tones at startup with the
3671 current battery voltage, measured in tenths of a
3672 volt. This lets you check the battery voltage
3673 without needing telemetry, which is especially
3674 useful on EasyMini.</p>
3675 </li>
3676 <li>
3677 <p>Change state beeping to "Farnsworth spacing", which
3678 means they&#8217;re quite a bit faster than before, and so
3679 they take less time to send.</p>
3680 </li>
3681 <li>
3682 <p>Fix bug preventing the selection of the 'Flight
3683 State After' mode in pyro configuration.</p>
3684 </li>
3685 <li>
3686 <p>Fix bug where erasing flights would reset the flight
3687 number to 2 on TeleMega and TeleMetrum v2.</p>
3688 </li>
3689 <li>
3690 <p>Fix u-Blox GPS driver to mark course and speed data
3691 as being present.</p>
3692 </li>
3693 </ul>
3694 </div>
3695 </div>
3696 <div class="sect3">
3697 <h4 id="_altosui_application">E.41.2. AltosUI Application</h4>
3698 <div class="paragraph">
3699 <p>AltosUI new features:</p>
3700 </div>
3701 <div class="ulist">
3702 <ul>
3703 <li>
3704 <p>Add zooming and new content types (terrain and road
3705 maps) to map view. Change map storage format from
3706 PNG to Jpeg, which saves a huge amount of disk
3707 space. You will need to re-download all of your
3708 pre-loaded map images.</p>
3709 </li>
3710 <li>
3711 <p>Add a distance measuring device to the maps
3712 view. Select this by using any button other than the
3713 left one, or by pressing shift or control on the
3714 keyboard while using the left button.</p>
3715 </li>
3716 <li>
3717 <p>Add new 'Ignitor' tab to the flight monitor display
3718 for TeleMega&#8217;s extra ignitors.</p>
3719 </li>
3720 <li>
3721 <p>Add additional ignitor firing marks and voltages to
3722 the graph so you can see when the ignitors fired,
3723 along with the ignitor voltages.</p>
3724 </li>
3725 <li>
3726 <p>Add GPS course, ground speed and climb rate as
3727 optional graph elements.</p>
3728 </li>
3729 </ul>
3730 </div>
3731 <div class="paragraph">
3732 <p>AltosUI fixes:</p>
3733 </div>
3734 <div class="ulist">
3735 <ul>
3736 <li>
3737 <p>When flashing new firmware, re-try opening the
3738 device as sometimes it takes a while for the
3739 underlying operating system to recognize that the
3740 device has rebooted in preparation for the flashing
3741 operation.</p>
3742 </li>
3743 <li>
3744 <p>Hide Tilt Angle in ascent tab for devices that don&#8217;t
3745 have a gyro.</p>
3746 </li>
3747 <li>
3748 <p>Increase the width of data lines in the graphs to
3749 make them easier to read.</p>
3750 </li>
3751 <li>
3752 <p>Filter out speed and acceleration spikes caused by
3753 ejection charge firing when computing the maximum
3754 values. This provides a more accurate reading of
3755 those maximums.</p>
3756 </li>
3757 <li>
3758 <p>Fix EasyMini voltage displays. Early EasyMini
3759 prototypes used a 3.0V regulator, and AltosUI still
3760 used that value as the basis of the
3761 computation. Production EasyMini boards have always
3762 shipped with a 3.3V regulator. Also, purple EasyMini
3763 boards sensed the battery voltage past the blocking
3764 diode, resulting in a drop of about 150mV from the
3765 true battery voltage. Compensate for that when
3766 displaying the value.</p>
3767 </li>
3768 <li>
3769 <p>Display error message when trying to configure
3770 maximum flight log size while the flight computer
3771 still has flight data stored.</p>
3772 </li>
3773 <li>
3774 <p>Handle TeleMetrum and TeleMini eeprom files
3775 generated with pre-1.0 firmware. Those ancient
3776 versions didn&#8217;t report the log format, so just use
3777 the product name instead.</p>
3778 </li>
3779 </ul>
3780 </div>
3781 </div>
3782 <div class="sect3">
3783 <h4 id="_telegps_application_2">E.41.3. TeleGPS Application</h4>
3784 <div class="ulist">
3785 <ul>
3786 <li>
3787 <p>New application designed for use with TeleGPS boards.</p>
3788 </li>
3789 <li>
3790 <p>Shares code with AltosUI, mostly just trimmed down
3791 to focus on TeleGPS-related functions.</p>
3792 </li>
3793 </ul>
3794 </div>
3795 </div>
3796 <div class="sect3">
3797 <h4 id="_documentation_4">E.41.4. Documentation</h4>
3798 <div class="paragraph">
3799 <p>Documentation changes:</p>
3800 </div>
3801 <div class="ulist">
3802 <ul>
3803 <li>
3804 <p>Re-create the drill template images; they should
3805 print correctly from Firefox at least. Ship these as
3806 individual PDF files so they&#8217;re easy to print.</p>
3807 </li>
3808 <li>
3809 <p>Add a description of the 'Apogee Lockout' setting,
3810 which prevents the apogee charge from firing for a
3811 configurable amount of time after boost.</p>
3812 </li>
3813 </ul>
3814 </div>
3815 </div>
3816 </div>
3817 </div>
3818 </div>
3819 </div>
3820 <div id="footer">
3821 <div id="footer-text">
3822 Version v1.9.21<br>
3823 Last updated 2025-04-28 20:49:49 -0600
3824 </div>
3825 </div>
3826 </body>
3827 </html>