Add 1.4.1 release notes
[fw/altos] / doc / altusmetrum.xsl
1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3   "/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">
4 <book>
5   <title>The Altus Metrum System</title>
6   <subtitle>An Owner's Manual for Altus Metrum Rocketry Electronics</subtitle>
7   <bookinfo>
8     <author>
9       <firstname>Bdale</firstname>
10       <surname>Garbee</surname>
11     </author>
12     <author>
13       <firstname>Keith</firstname>
14       <surname>Packard</surname>
15     </author>
16     <author>
17       <firstname>Bob</firstname>
18       <surname>Finch</surname>
19     </author>
20     <author>
21       <firstname>Anthony</firstname>
22       <surname>Towns</surname>
23     </author>
24     <copyright>
25       <year>2014</year>
26       <holder>Bdale Garbee and Keith Packard</holder>
27     </copyright>
28     <mediaobject>
29       <imageobject>
30         <imagedata fileref="../themes/background.png" width="6.0in"/>
31       </imageobject>
32     </mediaobject>
33     <legalnotice>
34       <para>
35         This document is released under the terms of the
36         <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">
37           Creative Commons ShareAlike 3.0
38         </ulink>
39         license.
40       </para>
41     </legalnotice>
42     <revhistory>
43       <revision>
44         <revnumber>1.4.1</revnumber>
45         <date>20 June 2014</date>
46         <revremark>
47           Minor release fixing some installation bugs.
48         </revremark>
49       </revision>
50       <revision>
51         <revnumber>1.4</revnumber>
52         <date>15 June 2014</date>
53         <revremark>
54           Major release adding TeleGPS support.
55         </revremark>
56       </revision>
57       <revision>
58         <revnumber>1.3.2</revnumber>
59         <date>24 January 2014</date>
60         <revremark>
61           Bug fixes for TeleMega and AltosUI.
62         </revremark>
63       </revision>
64       <revision>
65         <revnumber>1.3.1</revnumber>
66         <date>21 January 2014</date>
67         <revremark>
68           Bug fixes for TeleMega and TeleMetrum v2.0 along with a few
69           small UI improvements.
70         </revremark>
71       </revision>
72       <revision>
73         <revnumber>1.3</revnumber>
74         <date>12 November 2013</date>
75         <revremark>
76           Updated for software version 1.3. Version 1.3 adds support
77           for TeleMega, TeleMetrum v2.0, TeleMini v2.0 and EasyMini
78           and fixes bugs in AltosUI and the AltOS firmware.
79         </revremark>
80       </revision>
81       <revision>
82         <revnumber>1.2.1</revnumber>
83         <date>21 May 2013</date>
84         <revremark>
85           Updated for software version 1.2. Version 1.2 adds support
86           for TeleBT and AltosDroid. It also adds a few minor features
87           and fixes bugs in AltosUI and the AltOS firmware.
88         </revremark>
89       </revision>
90       <revision>
91         <revnumber>1.2</revnumber>
92         <date>18 April 2013</date>
93         <revremark>
94           Updated for software version 1.2. Version 1.2 adds support
95           for MicroPeak and the MicroPeak USB interface.
96         </revremark>
97       </revision>
98       <revision>
99         <revnumber>1.1.1</revnumber>
100         <date>16 September 2012</date>
101         <revremark>
102           Updated for software version 1.1.1 Version 1.1.1 fixes a few
103           bugs found in version 1.1.
104         </revremark>
105       </revision>
106       <revision>
107         <revnumber>1.1</revnumber>
108         <date>13 September 2012</date>
109         <revremark>
110           Updated for software version 1.1. Version 1.1 has new
111           features but is otherwise compatible with version 1.0.
112         </revremark>
113       </revision>
114       <revision>
115         <revnumber>1.0</revnumber>
116         <date>24 August 2011</date>
117         <revremark>
118           Updated for software version 1.0.  Note that 1.0 represents a
119           telemetry format change, meaning both ends of a link 
120           (TeleMetrum/TeleMini and TeleDongle) must be updated or 
121           communications will fail.
122         </revremark>
123       </revision>
124       <revision>
125         <revnumber>0.9</revnumber>
126         <date>18 January 2011</date>
127         <revremark>
128           Updated for software version 0.9.  Note that 0.9 represents a
129           telemetry format change, meaning both ends of a link (TeleMetrum and
130           TeleDongle) must be updated or communications will fail.
131         </revremark>
132       </revision>
133       <revision>
134         <revnumber>0.8</revnumber>
135         <date>24 November 2010</date>
136         <revremark>Updated for software version 0.8 </revremark>
137       </revision>
138     </revhistory>
139   </bookinfo>
140   <dedication>
141     <title>Acknowledgments</title>
142     <para>
143       Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing “The
144       Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter
145       Kit” which formed the basis of the original Getting Started chapter 
146       in this manual.  Bob was one of our first customers for a production
147       TeleMetrum, and his continued enthusiasm and contributions
148       are immensely gratifying and highly appreciated!
149     </para>
150     <para>
151       And thanks to Anthony (AJ) Towns for major contributions including
152       the AltosUI graphing and site map code and associated documentation. 
153       Free software means that our customers and friends can become our
154       collaborators, and we certainly appreciate this level of
155       contribution!
156     </para>
157     <para>
158       Have fun using these products, and we hope to meet all of you
159       out on the rocket flight line somewhere.
160       <literallayout>
161 Bdale Garbee, KB0G
162 NAR #87103, TRA #12201
163
164 Keith Packard, KD7SQG
165 NAR #88757, TRA #12200
166       </literallayout>
167     </para>
168   </dedication>
169   <chapter>
170     <title>Introduction and Overview</title>
171     <para>
172       Welcome to the Altus Metrum community!  Our circuits and software reflect
173       our passion for both hobby rocketry and Free Software.  We hope their
174       capabilities and performance will delight you in every way, but by
175       releasing all of our hardware and software designs under open licenses,
176       we also hope to empower you to take as active a role in our collective
177       future as you wish!
178     </para>
179     <para>
180       The first device created for our community was TeleMetrum, a dual
181       deploy altimeter with fully integrated GPS and radio telemetry
182       as standard features, and a “companion interface” that will
183       support optional capabilities in the future. The latest version
184       of TeleMetrum, v2.0, has all of the same features but with
185       improved sensors and radio to offer increased performance.
186     </para>
187     <para>
188       Our second device was TeleMini, a dual deploy altimeter with
189       radio telemetry and radio direction finding. The first version
190       of this device was only 13mm by 38mm (½ inch by 1½ inches) and
191       could fit easily in an 18mm air-frame. The latest version, v2.0,
192       includes a beeper, USB data download and extended on-board
193       flight logging, along with an improved barometric sensor.
194     </para>
195     <para>
196       TeleMega is our most sophisticated device, including six pyro
197       channels (four of which are fully programmable), integrated GPS,
198       integrated gyroscopes for staging/air-start inhibit and high
199       performance telemetry.
200     </para>
201     <para>
202       EasyMini is a dual-deploy altimeter with logging and built-in
203       USB data download.
204     </para>
205     <para>
206       TeleDongle was our first ground station, providing a USB to RF
207       interfaces for communicating with the altimeters. Combined with
208       your choice of antenna and notebook computer, TeleDongle and our
209       associated user interface software form a complete ground
210       station capable of logging and displaying in-flight telemetry,
211       aiding rocket recovery, then processing and archiving flight
212       data for analysis and review.
213     </para>
214     <para>
215       For a slightly more portable ground station experience that also
216       provides direct rocket recovery support, TeleBT offers flight
217       monitoring and data logging using a  Bluetooth™ connection between
218       the receiver and an Android device that has the AltosDroid
219       application installed from the Google Play store.
220     </para>
221     <para>
222       More products will be added to the Altus Metrum family over time, and
223       we currently envision that this will be a single, comprehensive manual
224       for the entire product family.
225     </para>
226   </chapter>
227   <chapter>
228     <title>Getting Started</title>
229     <para>
230       The first thing to do after you check the inventory of parts in your
231       “starter kit” is to charge the battery.
232     </para>
233     <para>
234       For TeleMetrum and TeleMega, the battery can be charged by plugging it into the
235       corresponding socket of the device and then using the USB
236       cable to plug the flight computer into your computer's USB socket. The
237       on-board circuitry will charge the battery whenever it is plugged
238       in, because the on-off switch does NOT control the
239       charging circuitry.
240     </para>
241     <para>
242       On TeleMetrum v1 boards, when the GPS chip is initially
243       searching for satellites, TeleMetrum will consume more current
244       than it pulls from the USB port, so the battery must be
245       attached in order to get satellite lock.  Once GPS is locked,
246       the current consumption goes back down enough to enable charging
247       while running. So it's a good idea to fully charge the battery
248       as your first item of business so there is no issue getting and
249       maintaining satellite lock.  The yellow charge indicator led
250       will go out when the battery is nearly full and the charger goes
251       to trickle charge. It can take several hours to fully recharge a
252       deeply discharged battery.
253     </para>
254     <para>
255       TeleMetrum v2.0 and TeleMega use a higher power battery charger,
256       allowing them to charge the battery while running the board at
257       maximum power. When the battery is charging, or when the board
258       is consuming a lot of power, the red LED will be lit. When the
259       battery is fully charged, the green LED will be lit. When the
260       battery is damaged or missing, both LEDs will be lit, which
261       appears yellow.
262     </para>
263     <para>
264       The Lithium Polymer TeleMini and EasyMini battery can be charged by
265       disconnecting it from the board and plugging it into a
266       standalone battery charger such as the LipoCharger product
267       included in TeleMini Starter Kits, and connecting that via a USB
268       cable to a laptop or other USB power source.
269     </para>
270     <para>
271       You can also choose to use another battery with TeleMini v2.0
272       and EasyMini, anything supplying between 4 and 12 volts should
273       work fine (like a standard 9V battery), but if you are planning
274       to fire pyro charges, ground testing is required to verify that
275       the battery supplies enough current to fire your chosen e-matches.
276     </para>
277     <para>
278       The other active device in the starter kit is the TeleDongle USB to
279       RF interface.  If you plug it in to your Mac or Linux computer it should
280       “just work”, showing up as a serial port device.  Windows systems need
281       driver information that is part of the AltOS download to know that the
282       existing USB modem driver will work.  We therefore recommend installing
283       our software before plugging in TeleDongle if you are using a Windows
284       computer.  If you are using an older version of Linux and are having 
285       problems, try moving to a fresher kernel (2.6.33 or newer). 
286     </para>
287     <para>
288       Next you should obtain and install the AltOS software.  The AltOS
289       distribution includes the AltosUI ground station program, current 
290       firmware
291       images for all of the hardware, and a number of standalone
292       utilities that are rarely needed.  Pre-built binary packages are
293       available for Linux, Microsoft Windows, and recent MacOSX
294       versions.  Full source code and build instructions are also
295       available.  The latest version may always be downloaded from
296       <ulink url="http://altusmetrum.org/AltOS"/>.
297     </para>
298     <para>
299       If you're using a TeleBT instead of the TeleDongle, you'll want to 
300       install the AltosDroid application from the Google Play store on an 
301       Android device. You don't need a data plan to use AltosDroid, but 
302       without network access, the Map view will be less useful as it
303       won't contain any map data. You can also use TeleBT connected
304       over USB with your laptop computer; it acts exactly like a
305       TeleDongle. Anywhere this manual talks about TeleDongle, you can
306       also read that as 'and TeleBT when connected via USB'.
307     </para>
308   </chapter>
309   <chapter>
310     <title>Handling Precautions</title>
311     <para>
312       All Altus Metrum products are sophisticated electronic devices.  
313       When handled gently and properly installed in an air-frame, they
314       will deliver impressive results.  However, as with all electronic 
315       devices, there are some precautions you must take.
316     </para>
317     <para>
318       The Lithium Polymer rechargeable batteries have an
319       extraordinary power density.  This is great because we can fly with
320       much less battery mass than if we used alkaline batteries or previous
321       generation rechargeable batteries... but if they are punctured
322       or their leads are allowed to short, they can and will release their
323       energy very rapidly!
324       Thus we recommend that you take some care when handling our batteries
325       and consider giving them some extra protection in your air-frame.  We
326       often wrap them in suitable scraps of closed-cell packing foam before
327       strapping them down, for example.
328     </para>
329     <para>
330       The barometric sensors used on all of our flight computers are 
331       sensitive to sunlight.  In normal mounting situations, the baro sensor
332       and all of the other surface mount components
333       are “down” towards whatever the underlying mounting surface is, so
334       this is not normally a problem.  Please consider this when designing an 
335       installation in an air-frame with a see-through plastic payload bay.  It
336       is particularly important to
337       consider this with TeleMini v1.0, both because the baro sensor is on the
338       “top” of the board, and because many model rockets with payload bays
339       use clear plastic for the payload bay!  Replacing these with an opaque
340       cardboard tube, painting them, or wrapping them with a layer of masking
341       tape are all reasonable approaches to keep the sensor out of direct
342       sunlight.
343     </para>
344     <para>
345       The barometric sensor sampling port must be able to “breathe”,
346       both by not being covered by foam or tape or other materials that might
347       directly block the hole on the top of the sensor, and also by having a
348       suitable static vent to outside air.
349     </para>
350     <para>
351       As with all other rocketry electronics, Altus Metrum altimeters must 
352       be protected from exposure to corrosive motor exhaust and ejection 
353       charge gasses.
354     </para>
355   </chapter>
356   <chapter>
357     <title>Altus Metrum Hardware</title>
358     <section>
359       <title>General Usage Instructions</title>
360       <para>
361         Here are general instructions for hooking up an Altus Metrum
362         flight computer. Instructions specific to each model will be
363         found in the section devoted to that model below.
364       </para>
365       <para>
366         To prevent electrical interference from affecting the
367         operation of the flight computer, it's important to always
368         twist pairs of wires connected to the board. Twist the switch
369         leads, the pyro leads and the battery leads. This reduces
370         interference through a mechanism called common mode rejection.
371       </para>
372       <section>
373         <title>Hooking Up Lithium Polymer Batteries</title>
374         <para>
375           All Altus Metrum flight computers have a two pin JST PH
376           series connector to connect up a single-cell Lithium Polymer
377           cell (3.7V nominal). You can purchase matching batteries
378           from the Altus Metrum store, or other vendors, or you can
379           make your own. Pin 1 of the connector is positive, pin 2 is
380           negative. Spark Fun sells a cable with the connector
381           attached, which they call a <ulink
382           url="https://www.sparkfun.com/products/9914">JST Jumper 2
383           Wire Assembly</ulink>.
384         </para>
385         <para>
386           Many RC vendors also sell lithium polymer batteries with
387           this same connector. All that we have found use the opposite
388           polarity, and if you use them that way, you will damage or
389           destroy the flight computer.
390         </para>
391       </section>
392       <section>
393         <title>Hooking Up Pyro Charges</title>
394         <para>
395           Altus Metrum flight computers always have two screws for
396           each pyro charge. This means you shouldn't need to put two
397           wires into a screw terminal or connect leads from pyro
398           charges together externally.
399         </para>
400         <para>
401           On the flight computer, one lead from each charge is hooked
402           to the positive battery terminal through the power switch.
403           The other lead is connected through the pyro circuit, which
404           is connected to the negative battery terminal when the pyro
405           circuit is fired.
406         </para>
407       </section>
408       <section>
409         <title>Hooking Up a Power Switch</title>
410         <para>
411           Altus Metrum flight computers need an external power switch
412           to turn them on. This disconnects both the computer and the
413           pyro charges from the battery, preventing the charges from
414           firing when in the Off position. The switch is in-line with
415           the positive battery terminal.
416         </para>
417         <section>
418           <title>Using an External Active Switch Circuit</title>
419           <para>
420             You can use an active switch circuit, such as the
421             Featherweight Magnetic Switch, with any Altus Metrum
422             flight computer. These require three connections, one to
423             the battery, one to the positive power input on the flight
424             computer and one to ground. Find instructions on how to
425             hook these up for each flight computer below. The follow
426             the instructions that come with your active switch to
427             connect it up.
428           </para>
429         </section>
430       </section>
431       <section>
432         <title>Using a Separate Pyro Battery</title>
433         <para>
434           As mentioned above in the section on hooking up pyro
435           charges, one lead for each of the pyro charges is connected
436           through the power switch directly to the positive battery
437           terminal. The other lead is connected to the pyro circuit,
438           which connects it to the negative battery terminal when the
439           pyro circuit is fired. The pyro circuit on all of the flight
440           computers is designed to handle up to 16V.
441         </para>
442         <para>
443           To use a separate pyro battery, connect the negative pyro
444           battery terminal to the flight computer ground terminal,
445           the positive battery terminal to the igniter and the other
446           igniter lead to the negative pyro terminal on the flight
447           computer. When the pyro channel fires, it will complete the
448           circuit between the negative pyro terminal and the ground
449           terminal, firing the igniter. Specific instructions on how
450           to hook this up will be found in each section below.
451         </para>
452       </section>
453       <section>
454         <title>Using a Different Kind of Battery</title>
455         <para>
456           EasyMini and TeleMini v2 are designed to use either a
457           lithium polymer battery or any other battery producing
458           between 4 and 12 volts, such as a rectangular 9V
459           battery. TeleMega and TeleMetrum are not designed for this,
460           and must only be powered by a lithium polymer battery. Find
461           instructions on how to use other batteries in the EasyMini
462           and TeleMini sections below.
463         </para>
464       </section>
465     </section>
466     <section>
467       <title>Specifications</title>
468       <para>
469         Here's the full set of Altus Metrum products, both in
470         production and retired.
471       </para>
472       <table frame='all'>
473         <title>Altus Metrum Electronics</title>
474         <?dbfo keep-together="always"?>
475         <tgroup cols='8' align='center' colsep='1' rowsep='1'>
476           <colspec align='center' colwidth='*' colname='Device'/>
477           <colspec align='center' colwidth='*' colname='Barometer'/>
478           <colspec align='center' colwidth='*' colname='Z-axis accelerometer'/>
479           <colspec align='center' colwidth='*' colname='GPS'/>
480           <colspec align='center' colwidth='*' colname='3D sensors'/>
481           <colspec align='center' colwidth='*' colname='Storage'/>
482           <colspec align='center' colwidth='*' colname='RF'/>
483           <colspec align='center' colwidth='*' colname='Battery'/>
484           <thead>
485             <row>
486               <entry align='center'>Device</entry>
487               <entry align='center'>Barometer</entry>
488               <entry align='center'>Z-axis accelerometer</entry>
489               <entry align='center'>GPS</entry>
490               <entry align='center'>3D sensors</entry>
491               <entry align='center'>Storage</entry>
492               <entry align='center'>RF Output</entry>
493               <entry align='center'>Battery</entry>
494             </row>
495           </thead>
496           <tbody>
497             <row>
498               <entry>TeleMetrum v1.0</entry>
499               <entry><para>MP3H6115 10km (33k')</para></entry>
500               <entry><para>MMA2202 50g</para></entry>
501               <entry>SkyTraq</entry>
502               <entry>-</entry>
503               <entry>1MB</entry>
504               <entry>10mW</entry>
505               <entry>3.7V</entry>
506             </row>
507             <row>
508               <entry>TeleMetrum v1.1</entry>
509               <entry><para>MP3H6115 10km (33k')</para></entry>
510               <entry><para>MMA2202 50g</para></entry>
511               <entry>SkyTraq</entry>
512               <entry>-</entry>
513               <entry>2MB</entry>
514               <entry>10mW</entry>
515               <entry>3.7V</entry>
516             </row>
517             <row>
518               <entry>TeleMetrum v1.2</entry>
519               <entry><para>MP3H6115 10km (33k')</para></entry>
520               <entry><para>ADXL78 70g</para></entry>
521               <entry>SkyTraq</entry>
522               <entry>-</entry>
523               <entry>2MB</entry>
524               <entry>10mW</entry>
525               <entry>3.7V</entry>
526             </row>
527             <row>
528               <entry>TeleMetrum v2.0</entry>
529               <entry><para>MS5607 30km (100k')</para></entry>
530               <entry><para>MMA6555 102g</para></entry>
531               <entry>uBlox Max-7Q</entry>
532               <entry>-</entry>
533               <entry>8MB</entry>
534               <entry>40mW</entry>
535               <entry>3.7V</entry>
536             </row>
537             <row>
538               <entry><para>TeleMini <?linebreak?>v1.0</para></entry>
539               <entry><para>MP3H6115 10km (33k')</para></entry>
540               <entry>-</entry>
541               <entry>-</entry>
542               <entry>-</entry>
543               <entry>5kB</entry>
544               <entry>10mW</entry>
545               <entry>3.7V</entry>
546             </row>
547             <row>
548               <entry>TeleMini <?linebreak?>v2.0</entry>
549               <entry><para>MS5607 30km (100k')</para></entry>
550               <entry>-</entry>
551               <entry>-</entry>
552               <entry>-</entry>
553               <entry>1MB</entry>
554               <entry>10mW</entry>
555               <entry>3.7-12V</entry>
556             </row>
557             <row>
558               <entry>EasyMini <?linebreak?>v1.0</entry>
559               <entry><para>MS5607 30km (100k')</para></entry>
560               <entry>-</entry>
561               <entry>-</entry>
562               <entry>-</entry>
563               <entry>1MB</entry>
564               <entry>-</entry>
565               <entry>3.7-12V</entry>
566             </row>
567             <row>
568               <entry>TeleMega <?linebreak?>v1.0</entry>
569               <entry><para>MS5607 30km (100k')</para></entry>
570               <entry><para>MMA6555 102g</para></entry>
571               <entry>uBlox Max-7Q</entry>
572               <entry><para>MPU6000 HMC5883</para></entry>
573               <entry>8MB</entry>
574               <entry>40mW</entry>
575               <entry>3.7V</entry>
576             </row>
577           </tbody>
578         </tgroup>
579       </table>
580       <table frame='all'>
581         <title>Altus Metrum Boards</title>
582         <?dbfo keep-together="always"?>
583         <tgroup cols='6' align='center' colsep='1' rowsep='1'>
584           <colspec align='center' colwidth='*' colname='Device'/>
585           <colspec align='center' colwidth='*' colname='Connectors'/>
586           <colspec align='center' colwidth='*' colname='Screw Terminals'/>
587           <colspec align='center' colwidth='*' colname='Width'/>
588           <colspec align='center' colwidth='*' colname='Length'/>
589           <colspec align='center' colwidth='*' colname='Tube Size'/>
590           <thead>
591             <row>
592               <entry align='center'>Device</entry>
593               <entry align='center'>Connectors</entry>
594               <entry align='center'>Screw Terminals</entry>
595               <entry align='center'>Width</entry>
596               <entry align='center'>Length</entry>
597               <entry align='center'>Tube Size</entry>
598             </row>
599           </thead>
600           <tbody>
601             <row>
602               <entry>TeleMetrum</entry>
603               <entry><para>
604                 Antenna<?linebreak?>
605                 Debug<?linebreak?>
606                 Companion<?linebreak?>
607                 USB<?linebreak?>
608                 Battery
609               </para></entry>
610               <entry><para>Apogee pyro <?linebreak?>Main pyro <?linebreak?>Switch</para></entry>
611               <entry>1 inch (2.54cm)</entry>
612               <entry>2 ¾ inch (6.99cm)</entry>
613               <entry>29mm coupler</entry>
614             </row>
615             <row>
616               <entry><para>TeleMini <?linebreak?>v1.0</para></entry>
617               <entry><para>
618                 Antenna<?linebreak?>
619                 Debug<?linebreak?>
620                 Battery
621               </para></entry>
622               <entry><para>
623                 Apogee pyro <?linebreak?>
624                 Main pyro
625               </para></entry>
626               <entry>½ inch (1.27cm)</entry>
627               <entry>1½ inch (3.81cm)</entry>
628               <entry>18mm coupler</entry>
629             </row>
630             <row>
631               <entry>TeleMini <?linebreak?>v2.0</entry>
632               <entry><para>
633                 Antenna<?linebreak?>
634                 Debug<?linebreak?>
635                 USB<?linebreak?>
636                 Battery
637               </para></entry>
638               <entry><para>
639                 Apogee pyro <?linebreak?>
640                 Main pyro <?linebreak?>
641                 Battery <?linebreak?>
642                 Switch
643                 </para></entry>
644               <entry>0.8 inch (2.03cm)</entry>
645               <entry>1½ inch (3.81cm)</entry>
646               <entry>24mm coupler</entry>
647             </row>
648             <row>
649               <entry>EasyMini</entry>
650               <entry><para>
651                 Debug<?linebreak?>
652                 USB<?linebreak?>
653                 Battery
654               </para></entry>
655               <entry><para>
656                 Apogee pyro <?linebreak?>
657                 Main pyro <?linebreak?>
658                 Battery <?linebreak?>
659                 Switch
660                 </para></entry>
661               <entry>0.8 inch (2.03cm)</entry>
662               <entry>1½ inch (3.81cm)</entry>
663               <entry>24mm coupler</entry>
664             </row>
665             <row>
666               <entry>TeleMega</entry>
667               <entry><para>
668                 Antenna<?linebreak?>
669                 Debug<?linebreak?>
670                 Companion<?linebreak?>
671                 USB<?linebreak?>
672                 Battery
673               </para></entry>
674               <entry><para>
675                 Apogee pyro <?linebreak?>
676                 Main pyro<?linebreak?>
677                 Pyro A-D<?linebreak?>
678                 Switch<?linebreak?>
679                 Pyro battery
680               </para></entry>
681               <entry>1¼ inch (3.18cm)</entry>
682               <entry>3¼ inch (8.26cm)</entry>
683               <entry>38mm coupler</entry>
684             </row>
685           </tbody>
686         </tgroup>
687       </table>
688     </section>
689     <section>
690       <title>TeleMetrum</title>
691       <informalfigure>
692         <mediaobject>
693           <imageobject>
694             <imagedata fileref="telemetrum-v1.1-thside.jpg" width="5.5in" scalefit="1"/>
695           </imageobject>
696         </mediaobject>
697       </informalfigure>
698       <para>
699         TeleMetrum is a 1 inch by 2¾ inch circuit board.  It was designed to
700         fit inside coupler for 29mm air-frame tubing, but using it in a tube that
701         small in diameter may require some creativity in mounting and wiring
702         to succeed!  The presence of an accelerometer means TeleMetrum should
703         be aligned along the flight axis of the airframe, and by default the ¼
704         wave UHF wire antenna should be on the nose-cone end of the board.  The
705         antenna wire is about 7 inches long, and wiring for a power switch and
706         the e-matches for apogee and main ejection charges depart from the
707         fin can end of the board, meaning an ideal “simple” avionics
708         bay for TeleMetrum should have at least 10 inches of interior length.
709       </para>
710       <section>
711         <title>TeleMetrum Screw Terminals</title>
712         <para>
713           TeleMetrum has six screw terminals on the end of the board
714           opposite the telemetry antenna. Two are for the power
715           switch, and two each for the apogee and main igniter
716           circuits. Using the picture above and starting from the top,
717           the terminals are as follows:
718         </para>
719         <table frame='all'>
720           <title>TeleMetrum Screw Terminals</title>
721           <?dbfo keep-together="always"?>
722           <tgroup cols='3' align='center' colsep='1' rowsep='1'>
723             <colspec align='center' colwidth='*' colname='Pin #'/>
724             <colspec align='center' colwidth='2*' colname='Pin Name'/>
725             <colspec align='left' colwidth='5*' colname='Description'/>
726             <thead>
727               <row>
728                 <entry align='center'>Terminal #</entry>
729                 <entry align='center'>Terminal Name</entry>
730                 <entry align='center'>Description</entry>
731               </row>
732             </thead>
733             <tbody>
734               <row>
735                 <entry>1</entry>
736                 <entry>Switch Output</entry>
737                 <entry>Switch connection to flight computer</entry>
738               </row>
739               <row>
740                 <entry>2</entry>
741                 <entry>Switch Input</entry>
742                 <entry>Switch connection to positive battery terminal</entry>
743               </row>
744               <row>
745                 <entry>3</entry>
746                 <entry>Main +</entry>
747                 <entry>Main pyro channel common connection to battery +</entry>
748               </row>
749               <row>
750                 <entry>4</entry>
751                 <entry>Main -</entry>
752                 <entry>Main pyro channel connection to pyro circuit</entry>
753               </row>
754               <row>
755                 <entry>5</entry>
756                 <entry>Apogee +</entry>
757                 <entry>Apogee pyro channel common connection to battery +</entry>
758               </row>
759               <row>
760                 <entry>6</entry>
761                 <entry>Apogee -</entry>
762                 <entry>Apogee pyro channel connection to pyro circuit</entry>
763               </row>
764             </tbody>
765           </tgroup>
766         </table>
767       </section>
768       <section>
769         <title>Using a Separate Pyro Battery with TeleMetrum</title>
770         <para>
771           As described above, using an external pyro battery involves
772           connecting the negative battery terminal to the flight
773           computer ground, connecting the positive battery terminal to
774           one of the igniter leads and connecting the other igniter
775           lead to the per-channel pyro circuit connection.
776         </para>
777         <para>
778           To connect the negative battery terminal to the TeleMetrum
779           ground, insert a small piece of wire, 24 to 28 gauge
780           stranded, into the GND hole just above the screw terminal
781           strip and solder it in place.
782         </para>
783         <para>
784           Connecting the positive battery terminal to the pyro
785           charges must be done separate from TeleMetrum, by soldering
786           them together or using some other connector.
787         </para>
788         <para>
789           The other lead from each pyro charge is then inserted into
790           the appropriate per-pyro channel screw terminal (terminal 4 for the
791           Main charge, terminal 6 for the Apogee charge).
792         </para>
793       </section>
794       <section>
795         <title>Using an Active Switch with TeleMetrum</title>
796         <para>
797           As explained above, an external active switch requires three
798           connections, one to the positive battery terminal, one to
799           the flight computer positive input and one to ground.
800         </para>
801         <para>
802           The positive battery terminal is available on screw terminal
803           2, the positive flight computer input is on terminal 1. To
804           hook a lead to ground, solder a piece of wire, 24 to 28
805           gauge stranded, to the GND hole just above terminal 1.
806         </para>
807       </section>
808     </section>
809     <section>
810       <title>TeleMini v1.0</title>
811       <informalfigure>
812         <mediaobject>
813           <imageobject>
814             <imagedata fileref="telemini-v1-top.jpg" width="5.5in" scalefit="1"/>
815           </imageobject>
816         </mediaobject>
817       </informalfigure>
818       <para>
819         TeleMini v1.0 is ½ inches by 1½ inches.  It was
820         designed to fit inside an 18mm air-frame tube, but using it in
821         a tube that small in diameter may require some creativity in
822         mounting and wiring to succeed!  Since there is no
823         accelerometer, TeleMini can be mounted in any convenient
824         orientation.  The default ¼ wave UHF wire antenna attached to
825         the center of one end of the board is about 7 inches long. Two
826         wires for the power switch are connected to holes in the
827         middle of the board. Screw terminals for the e-matches for
828         apogee and main ejection charges depart from the other end of
829         the board, meaning an ideal “simple” avionics bay for TeleMini
830         should have at least 9 inches of interior length.
831       </para>
832       <section>
833         <title>TeleMini v1.0 Screw Terminals</title>
834         <para>
835           TeleMini v1.0 has four screw terminals on the end of the
836           board opposite the telemetry antenna. Two are for the apogee
837           and two are for main igniter circuits. There are also wires
838           soldered to the board for the power switch.  Using the
839           picture above and starting from the top for the terminals
840           and from the left for the power switch wires, the
841           connections are as follows:
842         </para>
843         <table frame='all'>
844           <title>TeleMini v1.0 Connections</title>
845           <?dbfo keep-together="always"?>
846           <tgroup cols='3' align='center' colsep='1' rowsep='1'>
847             <colspec align='center' colwidth='*' colname='Pin #'/>
848             <colspec align='center' colwidth='2*' colname='Pin Name'/>
849             <colspec align='left' colwidth='5*' colname='Description'/>
850             <thead>
851               <row>
852                 <entry align='center'>Terminal #</entry>
853                 <entry align='center'>Terminal Name</entry>
854                 <entry align='center'>Description</entry>
855               </row>
856             </thead>
857             <tbody>
858               <row>
859                 <entry>1</entry>
860                 <entry>Apogee -</entry>
861                 <entry>Apogee pyro channel connection to pyro circuit</entry>
862               </row>
863               <row>
864                 <entry>2</entry>
865                 <entry>Apogee +</entry>
866                 <entry>Apogee pyro channel common connection to battery +</entry>
867               </row>
868               <row>
869                 <entry>3</entry>
870                 <entry>Main -</entry>
871                 <entry>Main pyro channel connection to pyro circuit</entry>
872               </row>
873               <row>
874                 <entry>4</entry>
875                 <entry>Main +</entry>
876                 <entry>Main pyro channel common connection to battery +</entry>
877               </row>
878               <row>
879                 <entry>Left</entry>
880                 <entry>Switch Output</entry>
881                 <entry>Switch connection to flight computer</entry>
882               </row>
883               <row>
884                 <entry>Right</entry>
885                 <entry>Switch Input</entry>
886                 <entry>Switch connection to positive battery terminal</entry>
887               </row>
888             </tbody>
889           </tgroup>
890         </table>
891       </section>
892       <section>
893         <title>Using a Separate Pyro Battery with TeleMini v1.0</title>
894         <para>
895           As described above, using an external pyro battery involves
896           connecting the negative battery terminal to the flight
897           computer ground, connecting the positive battery terminal to
898           one of the igniter leads and connecting the other igniter
899           lead to the per-channel pyro circuit connection. Because
900           there is no solid ground connection to use on TeleMini, this
901           is not recommended.
902         </para>
903         <para>
904           The only available ground connection on TeleMini v1.0 are
905           the two mounting holes next to the telemetry
906           antenna. Somehow connect a small piece of wire to one of
907           those holes and hook it to the negative pyro battery terminal.
908         </para>
909         <para>
910           Connecting the positive battery terminal to the pyro
911           charges must be done separate from TeleMini v1.0, by soldering
912           them together or using some other connector.
913         </para>
914         <para>
915           The other lead from each pyro charge is then inserted into
916           the appropriate per-pyro channel screw terminal (terminal 3 for the
917           Main charge, terminal 1 for the Apogee charge).
918         </para>
919       </section>
920       <section>
921         <title>Using an Active Switch with TeleMini v1.0</title>
922         <para>
923           As explained above, an external active switch requires three
924           connections, one to the positive battery terminal, one to
925           the flight computer positive input and one to ground. Again,
926           because TeleMini doesn't have any good ground connection,
927           this is not recommended.
928         </para>
929         <para>
930           The positive battery terminal is available on the Right
931           power switch wire, the positive flight computer input is on
932           the left power switch wire. Hook a lead to either of the
933           mounting holes for a ground connection.
934         </para>
935       </section>
936     </section>
937     <section>
938       <title>TeleMini v2.0</title>
939       <informalfigure>
940         <mediaobject>
941           <imageobject>
942             <imagedata fileref="telemini-v2-top.jpg" width="5.5in" scalefit="1"/>
943           </imageobject>
944         </mediaobject>
945       </informalfigure>
946       <para>
947         TeleMini v2.0 is 0.8 inches by 1½ inches. It adds more
948         on-board data logging memory, a built-in USB connector and
949         screw terminals for the battery and power switch. The larger
950         board fits in a 24mm coupler. There's also a battery connector
951         for a LiPo battery if you want to use one of those.
952       </para>
953       <section>
954         <title>TeleMini v2.0 Screw Terminals</title>
955         <para>
956           TeleMini v2.0 has two sets of four screw terminals on the end of the
957           board opposite the telemetry antenna. Using the picture
958           above, the top four have connections for the main pyro
959           circuit and an external battery and the bottom four have
960           connections for the apogee pyro circuit and the power
961           switch. Counting from the left, the connections are as follows:
962         </para>
963         <table frame='all'>
964           <title>TeleMini v2.0 Connections</title>
965           <?dbfo keep-together="always"?>
966           <tgroup cols='3' align='center' colsep='1' rowsep='1'>
967             <colspec align='center' colwidth='*' colname='Pin #'/>
968             <colspec align='center' colwidth='2*' colname='Pin Name'/>
969             <colspec align='left' colwidth='5*' colname='Description'/>
970             <thead>
971               <row>
972                 <entry align='center'>Terminal #</entry>
973                 <entry align='center'>Terminal Name</entry>
974                 <entry align='center'>Description</entry>
975               </row>
976             </thead>
977             <tbody>
978               <row>
979                 <entry>Top 1</entry>
980                 <entry>Main -</entry>
981                 <entry>Main pyro channel connection to pyro circuit</entry>
982               </row>
983               <row>
984                 <entry>Top 2</entry>
985                 <entry>Main +</entry>
986                 <entry>Main pyro channel common connection to battery +</entry>
987               </row>
988               <row>
989                 <entry>Top 3</entry>
990                 <entry>Battery +</entry>
991                 <entry>Positive external battery terminal</entry>
992               </row>
993               <row>
994                 <entry>Top 4</entry>
995                 <entry>Battery -</entry>
996                 <entry>Negative external battery terminal</entry>
997               </row>
998               <row>
999                 <entry>Bottom 1</entry>
1000                 <entry>Apogee -</entry>
1001                 <entry>Apogee pyro channel connection to pyro circuit</entry>
1002               </row>
1003               <row>
1004                 <entry>Bottom 2</entry>
1005                 <entry>Apogee +</entry>
1006                 <entry>Apogee pyro channel common connection to
1007                 battery +</entry>
1008               </row>
1009               <row>
1010                 <entry>Bottom 3</entry>
1011                 <entry>Switch Output</entry>
1012                 <entry>Switch connection to flight computer</entry>
1013               </row>
1014               <row>
1015                 <entry>Bottom 4</entry>
1016                 <entry>Switch Input</entry>
1017                 <entry>Switch connection to positive battery terminal</entry>
1018               </row>
1019             </tbody>
1020           </tgroup>
1021         </table>
1022       </section>
1023       <section>
1024         <title>Using a Separate Pyro Battery with TeleMini v2.0</title>
1025         <para>
1026           As described above, using an external pyro battery involves
1027           connecting the negative battery terminal to the flight
1028           computer ground, connecting the positive battery terminal to
1029           one of the igniter leads and connecting the other igniter
1030           lead to the per-channel pyro circuit connection.
1031         </para>
1032         <para>
1033           To connect the negative pyro battery terminal to TeleMini
1034           ground, connect it to the negative external battery
1035           connection, top terminal 4.
1036         </para>
1037         <para>
1038           Connecting the positive battery terminal to the pyro
1039           charges must be done separate from TeleMini v2.0, by soldering
1040           them together or using some other connector.
1041         </para>
1042         <para>
1043           The other lead from each pyro charge is then inserted into
1044           the appropriate per-pyro channel screw terminal (top
1045           terminal 1 for the Main charge, bottom terminal 1 for the
1046           Apogee charge).
1047         </para>
1048       </section>
1049       <section>
1050         <title>Using an Active Switch with TeleMini v2.0</title>
1051         <para>
1052           As explained above, an external active switch requires three
1053           connections, one to the positive battery terminal, one to
1054           the flight computer positive input and one to ground. Use
1055           the negative external battery connection, top terminal 4 for
1056           ground.
1057         </para>
1058         <para>
1059           The positive battery terminal is available on bottom
1060           terminal 4, the positive flight computer input is on the
1061           bottom terminal 3.
1062         </para>
1063       </section>
1064     </section>
1065     <section>
1066       <title>EasyMini</title>
1067       <informalfigure>
1068         <mediaobject>
1069           <imageobject>
1070             <imagedata fileref="easymini-top.jpg" width="5.5in" scalefit="1"/>
1071           </imageobject>
1072         </mediaobject>
1073       </informalfigure>
1074       <para>
1075         EasyMini is built on a 0.8 inch by 1½ inch circuit board. It's
1076         designed to fit in a 24mm coupler tube. The connectors and
1077         screw terminals match TeleMini v2.0, so you can easily swap between
1078         EasyMini and TeleMini.
1079       </para>
1080       <section>
1081         <title>EasyMini Screw Terminals</title>
1082         <para>
1083           EasyMini has two sets of four screw terminals on the end of the
1084           board opposite the telemetry antenna. Using the picture
1085           above, the top four have connections for the main pyro
1086           circuit and an external battery and the bottom four have
1087           connections for the apogee pyro circuit and the power
1088           switch. Counting from the left, the connections are as follows:
1089         </para>
1090         <table frame='all'>
1091           <title>EasyMini Connections</title>
1092           <?dbfo keep-together="always"?>
1093           <tgroup cols='3' align='center' colsep='1' rowsep='1'>
1094             <colspec align='center' colwidth='*' colname='Pin #'/>
1095             <colspec align='center' colwidth='2*' colname='Pin Name'/>
1096             <colspec align='left' colwidth='5*' colname='Description'/>
1097             <thead>
1098               <row>
1099                 <entry align='center'>Terminal #</entry>
1100                 <entry align='center'>Terminal Name</entry>
1101                 <entry align='center'>Description</entry>
1102               </row>
1103             </thead>
1104             <tbody>
1105               <row>
1106                 <entry>Top 1</entry>
1107                 <entry>Main -</entry>
1108                 <entry>Main pyro channel connection to pyro circuit</entry>
1109               </row>
1110               <row>
1111                 <entry>Top 2</entry>
1112                 <entry>Main +</entry>
1113                 <entry>Main pyro channel common connection to battery +</entry>
1114               </row>
1115               <row>
1116                 <entry>Top 3</entry>
1117                 <entry>Battery +</entry>
1118                 <entry>Positive external battery terminal</entry>
1119               </row>
1120               <row>
1121                 <entry>Top 4</entry>
1122                 <entry>Battery -</entry>
1123                 <entry>Negative external battery terminal</entry>
1124               </row>
1125               <row>
1126                 <entry>Bottom 1</entry>
1127                 <entry>Apogee -</entry>
1128                 <entry>Apogee pyro channel connection to pyro circuit</entry>
1129               </row>
1130               <row>
1131                 <entry>Bottom 2</entry>
1132                 <entry>Apogee +</entry>
1133                 <entry>Apogee pyro channel common connection to
1134                 battery +</entry>
1135               </row>
1136               <row>
1137                 <entry>Bottom 3</entry>
1138                 <entry>Switch Output</entry>
1139                 <entry>Switch connection to flight computer</entry>
1140               </row>
1141               <row>
1142                 <entry>Bottom 4</entry>
1143                 <entry>Switch Input</entry>
1144                 <entry>Switch connection to positive battery terminal</entry>
1145               </row>
1146             </tbody>
1147           </tgroup>
1148         </table>
1149       </section>
1150       <section>
1151         <title>Using a Separate Pyro Battery with EasyMini</title>
1152         <para>
1153           As described above, using an external pyro battery involves
1154           connecting the negative battery terminal to the flight
1155           computer ground, connecting the positive battery terminal to
1156           one of the igniter leads and connecting the other igniter
1157           lead to the per-channel pyro circuit connection.
1158         </para>
1159         <para>
1160           To connect the negative pyro battery terminal to TeleMini
1161           ground, connect it to the negative external battery
1162           connection, top terminal 4.
1163         </para>
1164         <para>
1165           Connecting the positive battery terminal to the pyro
1166           charges must be done separate from EasyMini, by soldering
1167           them together or using some other connector.
1168         </para>
1169         <para>
1170           The other lead from each pyro charge is then inserted into
1171           the appropriate per-pyro channel screw terminal (top
1172           terminal 1 for the Main charge, bottom terminal 1 for the
1173           Apogee charge).
1174         </para>
1175       </section>
1176       <section>
1177         <title>Using an Active Switch with EasyMini</title>
1178         <para>
1179           As explained above, an external active switch requires three
1180           connections, one to the positive battery terminal, one to
1181           the flight computer positive input and one to ground. Use
1182           the negative external battery connection, top terminal 4 for
1183           ground.
1184         </para>
1185         <para>
1186           The positive battery terminal is available on bottom
1187           terminal 4, the positive flight computer input is on the
1188           bottom terminal 3.
1189         </para>
1190       </section>
1191     </section>
1192     <section>
1193       <title>TeleMega</title>
1194       <informalfigure>
1195         <mediaobject>
1196           <imageobject>
1197             <imagedata fileref="telemega-v1.0-top.jpg" width="5.5in" scalefit="1"/>
1198           </imageobject>
1199         </mediaobject>
1200       </informalfigure>
1201       <para>
1202         TeleMega is a 1¼ inch by 3¼ inch circuit board. It was
1203         designed to easily fit in a 38mm coupler. Like TeleMetrum,
1204         TeleMega has an accelerometer and so it must be mounted so that
1205         the board is aligned with the flight axis. It can be mounted
1206         either antenna up or down.
1207       </para>
1208       <section>
1209         <title>TeleMega Screw Terminals</title>
1210         <para>
1211           TeleMega has two sets of nine screw terminals on the end of
1212           the board opposite the telemetry antenna. They are as follows:
1213         </para>
1214         <table frame='all'>
1215           <title>TeleMega Screw Terminals</title>
1216           <?dbfo keep-together="always"?>
1217           <tgroup cols='3' align='center' colsep='1' rowsep='1'>
1218             <colspec align='center' colwidth='*' colname='Pin #'/>
1219             <colspec align='center' colwidth='2*' colname='Pin Name'/>
1220             <colspec align='left' colwidth='5*' colname='Description'/>
1221             <thead>
1222               <row>
1223                 <entry align='center'>Terminal #</entry>
1224                 <entry align='center'>Terminal Name</entry>
1225                 <entry align='center'>Description</entry>
1226               </row>
1227             </thead>
1228             <tbody>
1229               <row>
1230                 <entry>Top 1</entry>
1231                 <entry>Switch Input</entry>
1232                 <entry>Switch connection to positive battery terminal</entry>
1233               </row>
1234               <row>
1235                 <entry>Top 2</entry>
1236                 <entry>Switch Output</entry>
1237                 <entry>Switch connection to flight computer</entry>
1238               </row>
1239               <row>
1240                 <entry>Top 3</entry>
1241                 <entry>GND</entry>
1242                 <entry>Ground connection for use with external active switch</entry>
1243               </row>
1244               <row>
1245                 <entry>Top 4</entry>
1246                 <entry>Main -</entry>
1247                 <entry>Main pyro channel connection to pyro circuit</entry>
1248               </row>
1249               <row>
1250                 <entry>Top 5</entry>
1251                 <entry>Main +</entry>
1252                 <entry>Main pyro channel common connection to battery +</entry>
1253               </row>
1254               <row>
1255                 <entry>Top 6</entry>
1256                 <entry>Apogee -</entry>
1257                 <entry>Apogee pyro channel connection to pyro circuit</entry>
1258               </row>
1259               <row>
1260                 <entry>Top 7</entry>
1261                 <entry>Apogee +</entry>
1262                 <entry>Apogee pyro channel common connection to battery +</entry>
1263               </row>
1264               <row>
1265                 <entry>Top 8</entry>
1266                 <entry>D -</entry>
1267                 <entry>D pyro channel connection to pyro circuit</entry>
1268               </row>
1269               <row>
1270                 <entry>Top 9</entry>
1271                 <entry>D +</entry>
1272                 <entry>D pyro channel common connection to battery +</entry>
1273               </row>
1274               <row>
1275                 <entry>Bottom 1</entry>
1276                 <entry>GND</entry>
1277                 <entry>Ground connection for negative pyro battery terminal</entry>
1278               </row>
1279               <row>
1280                 <entry>Bottom 2</entry>
1281                 <entry>Pyro</entry>
1282                 <entry>Positive pyro battery terminal</entry>
1283               </row>
1284               <row>
1285                 <entry>Bottom 3</entry>
1286                 <entry>Lipo</entry>
1287                 <entry>
1288                   Power switch output. Use to connect main battery to
1289                   pyro battery input
1290                 </entry>
1291               </row>
1292               <row>
1293                 <entry>Bottom 4</entry>
1294                 <entry>A -</entry>
1295                 <entry>A pyro channel connection to pyro circuit</entry>
1296               </row>
1297               <row>
1298                 <entry>Bottom 5</entry>
1299                 <entry>A +</entry>
1300                 <entry>A pyro channel common connection to battery +</entry>
1301               </row>
1302               <row>
1303                 <entry>Bottom 6</entry>
1304                 <entry>B -</entry>
1305                 <entry>B pyro channel connection to pyro circuit</entry>
1306               </row>
1307               <row>
1308                 <entry>Bottom 7</entry>
1309                 <entry>B +</entry>
1310                 <entry>B pyro channel common connection to battery +</entry>
1311               </row>
1312               <row>
1313                 <entry>Bottom 8</entry>
1314                 <entry>C -</entry>
1315                 <entry>C pyro channel connection to pyro circuit</entry>
1316               </row>
1317               <row>
1318                 <entry>Bottom 9</entry>
1319                 <entry>C +</entry>
1320                 <entry>C pyro channel common connection to battery +</entry>
1321               </row>
1322             </tbody>
1323           </tgroup>
1324         </table>
1325       </section>
1326       <section>
1327         <title>Using a Separate Pyro Battery with TeleMega</title>
1328         <para>
1329           TeleMega provides explicit support for an external pyro
1330           battery. All that is required is to remove the jumper
1331           between the lipo terminal (Bottom 3) and the pyro terminal
1332           (Bottom 2). Then hook the negative pyro battery terminal to ground
1333           (Bottom 1) and the positive pyro battery to the pyro battery
1334           input (Bottom 2). You can then use the existing pyro screw
1335           terminals to hook up all of the pyro charges.
1336         </para>
1337       </section>
1338       <section>
1339         <title>Using Only One Battery With TeleMega</title>
1340         <para>
1341           Because TeleMega has built-in support for a separate pyro
1342           battery, if you want to fly with just one battery running
1343           both the computer and firing the charges, you need to
1344           connect the flight computer battery to the pyro
1345           circuit. TeleMega has two screw terminals for this—hook a
1346           wire from the Lipo terminal (Bottom 3) to the Pyro terminal
1347           (Bottom 2).
1348         </para>
1349       </section>
1350       <section>
1351         <title>Using an Active Switch with TeleMega</title>
1352         <para>
1353           As explained above, an external active switch requires three
1354           connections, one to the positive battery terminal, one to
1355           the flight computer positive input and one to ground.
1356         </para>
1357         <para>
1358           The positive battery terminal is available on Top terminal
1359           1, the positive flight computer input is on Top terminal
1360           2. Ground is on Top terminal 3.
1361         </para>
1362       </section>
1363     </section>
1364     <section>
1365       <title>Flight Data Recording</title>
1366       <para>
1367         Each flight computer logs data at 100 samples per second
1368         during ascent and 10 samples per second during descent, except
1369         for TeleMini v1.0, which records ascent at 10 samples per
1370         second and descent at 1 sample per second. Data are logged to
1371         an on-board flash memory part, which can be partitioned into
1372         several equal-sized blocks, one for each flight.
1373       </para>
1374       <table frame='all'>
1375         <title>Data Storage on Altus Metrum altimeters</title>
1376         <?dbfo keep-together="always"?>
1377         <tgroup cols='4' align='center' colsep='1' rowsep='1'>
1378           <colspec align='center' colwidth='*' colname='Device'/>
1379           <colspec align='center' colwidth='*' colname='Bytes per sample'/>
1380           <colspec align='center' colwidth='*' colname='Total storage'/>
1381           <colspec align='center' colwidth='*' colname='Minutes of
1382                                                         full-rate'/>
1383           <thead>
1384             <row>
1385               <entry align='center'>Device</entry>
1386               <entry align='center'>Bytes per Sample</entry>
1387               <entry align='center'>Total Storage</entry>
1388               <entry align='center'>Minutes at Full Rate</entry>
1389             </row>
1390           </thead>
1391           <tbody>
1392             <row>
1393               <entry>TeleMetrum v1.0</entry>
1394               <entry>8</entry>
1395               <entry>1MB</entry>
1396               <entry>20</entry>
1397             </row>
1398             <row>
1399               <entry>TeleMetrum v1.1 v1.2</entry>
1400               <entry>8</entry>
1401               <entry>2MB</entry>
1402               <entry>40</entry>
1403             </row>
1404             <row>
1405               <entry>TeleMetrum v2.0</entry>
1406               <entry>16</entry>
1407               <entry>8MB</entry>
1408               <entry>80</entry>
1409             </row>
1410             <row>
1411               <entry>TeleMini v1.0</entry>
1412               <entry>2</entry>
1413               <entry>5kB</entry>
1414               <entry>4</entry>
1415             </row>
1416             <row>
1417               <entry>TeleMini v2.0</entry>
1418               <entry>16</entry>
1419               <entry>1MB</entry>
1420               <entry>10</entry>
1421             </row>
1422             <row>
1423               <entry>EasyMini</entry>
1424               <entry>16</entry>
1425               <entry>1MB</entry>
1426               <entry>10</entry>
1427             </row>
1428             <row>
1429               <entry>TeleMega</entry>
1430               <entry>32</entry>
1431               <entry>8MB</entry>
1432               <entry>40</entry>
1433             </row>
1434           </tbody>
1435         </tgroup>
1436       </table>
1437       <para>
1438         The on-board flash is partitioned into separate flight logs,
1439         each of a fixed maximum size. Increase the maximum size of
1440         each log and you reduce the number of flights that can be
1441         stored. Decrease the size and you can store more flights.
1442       </para>
1443       <para>
1444         Configuration data is also stored in the flash memory on
1445         TeleMetrum v1.x, TeleMini and EasyMini. This consumes 64kB
1446         of flash space.  This configuration space is not available
1447         for storing flight log data. TeleMetrum v2.0 and TeleMega
1448         store configuration data in a bit of eeprom available within
1449         the processor chip, leaving that space available in flash for
1450         more flight data.
1451       </para>
1452       <para>
1453         To compute the amount of space needed for a single flight, you
1454         can multiply the expected ascent time (in seconds) by 100
1455         times bytes-per-sample, multiply the expected descent time (in
1456         seconds) by 10 times the bytes per sample and add the two
1457         together. That will slightly under-estimate the storage (in
1458         bytes) needed for the flight. For instance, a TeleMetrum v2.0 flight spending
1459         20 seconds in ascent and 150 seconds in descent will take
1460         about (20 * 1600) + (150 * 160) = 56000 bytes of storage. You
1461         could store dozens of these flights in the on-board flash.
1462       </para>
1463       <para>
1464         The default size allows for several flights on each flight
1465         computer, except for TeleMini v1.0, which only holds data for a
1466         single flight. You can adjust the size.
1467       </para>
1468       <para>
1469         Altus Metrum flight computers will not overwrite existing
1470         flight data, so be sure to download flight data and erase it
1471         from the flight computer before it fills up. The flight
1472         computer will still successfully control the flight even if it
1473         cannot log data, so the only thing you will lose is the data.
1474       </para>
1475     </section>
1476     <section>
1477       <title>Installation</title>
1478       <para>
1479         A typical installation involves attaching 
1480         only a suitable battery, a single pole switch for 
1481         power on/off, and two pairs of wires connecting e-matches for the 
1482         apogee and main ejection charges.  All Altus Metrum products are 
1483         designed for use with single-cell batteries with 3.7 volts
1484         nominal. TeleMini v2.0 and EasyMini may also be used with other
1485         batteries as long as they supply between 4 and 12 volts. 
1486       </para>
1487       <para>
1488         The battery connectors are a standard 2-pin JST connector and
1489         match batteries sold by Spark Fun. These batteries are
1490         single-cell Lithium Polymer batteries that nominally provide 3.7
1491         volts.  Other vendors sell similar batteries for RC aircraft
1492         using mating connectors, however the polarity for those is
1493         generally reversed from the batteries used by Altus Metrum
1494         products. In particular, the Tenergy batteries supplied for use
1495         in Featherweight flight computers are not compatible with Altus
1496         Metrum flight computers or battery chargers. <emphasis>Check
1497         polarity and voltage before connecting any battery not purchased
1498         from Altus Metrum or Spark Fun.</emphasis>
1499       </para>
1500       <para>
1501         By default, we use the unregulated output of the battery directly
1502         to fire ejection charges.  This works marvelously with standard
1503         low-current e-matches like the J-Tek from MJG Technologies, and with
1504         Quest Q2G2 igniters.  However, if you want or need to use a separate 
1505         pyro battery, check out the “External Pyro Battery” section in this 
1506         manual for instructions on how to wire that up. The altimeters are 
1507         designed to work with an external pyro battery of no more than 15 volts.
1508       </para>
1509       <para>
1510         Ejection charges are wired directly to the screw terminal block
1511         at the aft end of the altimeter.  You'll need a very small straight 
1512         blade screwdriver for these screws, such as you might find in a 
1513         jeweler's screwdriver set.
1514       </para>
1515       <para>
1516         Except for TeleMini v1.0, the flight computers also use the
1517         screw terminal block for the power switch leads. On TeleMini v1.0,
1518         the power switch leads are soldered directly to the board and
1519         can be connected directly to a switch.
1520       </para>
1521       <para>
1522         For most air-frames, the integrated antennas are more than
1523         adequate.   However, if you are installing in a carbon-fiber or
1524         metal electronics bay which is opaque to RF signals, you may need to
1525         use off-board external antennas instead.  In this case, you can
1526         replace the stock UHF antenna wire with an edge-launched SMA connector,
1527         and, on TeleMetrum v1, you can unplug the integrated GPS
1528         antenna and select an appropriate off-board GPS antenna with
1529         cable terminating in a U.FL connector.
1530       </para>
1531     </section>
1532   </chapter>
1533   <chapter>
1534     <title>System Operation</title>
1535     <section>
1536       <title>Firmware Modes </title>
1537       <para>
1538         The AltOS firmware build for the altimeters has two
1539         fundamental modes, “idle” and “flight”.  Which of these modes
1540         the firmware operates in is determined at start up time. For
1541         TeleMetrum and TeleMega, which have accelerometers, the mode is 
1542         controlled by the orientation of the
1543         rocket (well, actually the board, of course...) at the time
1544         power is switched on.  If the rocket is “nose up”, then
1545         the flight computer assumes it's on a rail or rod being prepared for
1546         launch, so the firmware chooses flight mode.  However, if the
1547         rocket is more or less horizontal, the firmware instead enters
1548         idle mode.  Since TeleMini v2.0 and EasyMini don't have an
1549         accelerometer we can use to determine orientation, “idle” mode
1550         is selected if the board is connected via USB to a computer,
1551         otherwise the board enters “flight” mode. TeleMini v1.0
1552         selects “idle” mode if it receives a command packet within the
1553         first five seconds of operation.
1554       </para>
1555       <para>
1556         At power on, the altimeter will beep out the battery voltage
1557         to the nearest tenth of a volt.  Each digit is represented by
1558         a sequence of short “dit” beeps, with a pause between
1559         digits. A zero digit is represented with one long “dah”
1560         beep. Then there will be a short pause while the altimeter
1561         completes initialization and self test, and decides which mode
1562         to enter next.
1563       </para>
1564       <para>
1565         Here's a short summary of all of the modes and the beeping (or
1566         flashing, in the case of TeleMini v1) that accompanies each
1567         mode. In the description of the beeping pattern, “dit” means a
1568         short beep while "dah" means a long beep (three times as
1569         long). “Brap” means a long dissonant tone.
1570         <table frame='all'>
1571           <title>AltOS Modes</title>
1572           <?dbfo keep-together="always"?>
1573           <tgroup cols='4' align='center' colsep='1' rowsep='1'>
1574             <colspec align='center' colwidth='*' colname='Mode Name'/>
1575             <colspec align='center' colwidth='*' colname='Letter'/>
1576             <colspec align='center' colwidth='*' colname='Beeps'/>
1577             <colspec align='center' colwidth='*' colname='Description'/>
1578             <thead>
1579               <row>
1580                 <entry>Mode Name</entry>
1581                 <entry>Abbreviation</entry>
1582                 <entry>Beeps</entry>
1583                 <entry>Description</entry>
1584               </row>
1585             </thead>
1586             <tbody>
1587               <row>
1588                 <entry>Startup</entry>
1589                 <entry>S</entry>
1590                 <entry>battery voltage in decivolts</entry>
1591                 <entry>
1592                   <para>
1593                     Calibrating sensors, detecting orientation.
1594                   </para>
1595                 </entry>
1596               </row>
1597               <row>
1598                 <entry>Idle</entry>
1599                 <entry>I</entry>
1600                 <entry>dit dit</entry>
1601                 <entry>
1602                   <para>
1603                     Ready to accept commands over USB or radio link.
1604                   </para>
1605                 </entry>
1606               </row>
1607               <row>
1608                 <entry>Pad</entry>
1609                 <entry>P</entry>
1610                 <entry>dit dah dah dit</entry>
1611                 <entry>
1612                   <para>
1613                     Waiting for launch. Not listening for commands.
1614                   </para>
1615                 </entry>
1616               </row>
1617               <row>
1618                 <entry>Boost</entry>
1619                 <entry>B</entry>
1620                 <entry>dah dit dit dit</entry>
1621                 <entry>
1622                   <para>
1623                     Accelerating upwards.
1624                   </para>
1625                 </entry>
1626               </row>
1627               <row>
1628                 <entry>Fast</entry>
1629                 <entry>F</entry>
1630                 <entry>dit dit dah dit</entry>
1631                 <entry>
1632                   <para>
1633                     Decelerating, but moving faster than 200m/s.
1634                   </para>
1635                 </entry>
1636               </row>
1637               <row>
1638                 <entry>Coast</entry>
1639                 <entry>C</entry>
1640                 <entry>dah dit dah dit</entry>
1641                 <entry>
1642                   <para>
1643                     Decelerating, moving slower than 200m/s
1644                   </para>
1645                 </entry>
1646               </row>
1647               <row>
1648                 <entry>Drogue</entry>
1649                 <entry>D</entry>
1650                 <entry>dah dit dit</entry>
1651                 <entry>
1652                   <para>
1653                     Descending after apogee. Above main height.
1654                   </para>
1655                 </entry>
1656               </row>
1657               <row>
1658                 <entry>Main</entry>
1659                 <entry>M</entry>
1660                 <entry>dah dah</entry>
1661                 <entry>
1662                   <para>
1663                     Descending. Below main height.
1664                   </para>
1665                 </entry>
1666               </row>
1667               <row>
1668                 <entry>Landed</entry>
1669                 <entry>L</entry>
1670                 <entry>dit dah dit dit</entry>
1671                 <entry>
1672                   <para>
1673                     Stable altitude for at least ten seconds.
1674                   </para>
1675                 </entry>
1676               </row>
1677               <row>
1678                 <entry>Sensor error</entry>
1679                 <entry>X</entry>
1680                 <entry>dah dit dit dah</entry>
1681                 <entry>
1682                   <para>
1683                     Error detected during sensor calibration.
1684                   </para>
1685                 </entry>
1686               </row>
1687             </tbody>
1688           </tgroup>
1689         </table>
1690       </para>
1691       <para>
1692         In flight or “pad” mode, the altimeter engages the flight
1693         state machine, goes into transmit-only mode to send telemetry,
1694         and waits for launch to be detected.  Flight mode is indicated
1695         by an “di-dah-dah-dit” (“P” for pad) on the beeper or lights,
1696         followed by beeps or flashes indicating the state of the
1697         pyrotechnic igniter continuity.  One beep/flash indicates
1698         apogee continuity, two beeps/flashes indicate main continuity,
1699         three beeps/flashes indicate both apogee and main continuity,
1700         and one longer “brap” sound which is made by rapidly
1701         alternating between two tones indicates no continuity.  For a
1702         dual deploy flight, make sure you're getting three beeps or
1703         flashes before launching!  For apogee-only or motor eject
1704         flights, do what makes sense.
1705       </para>
1706       <para>
1707         If idle mode is entered, you will hear an audible “di-dit” or
1708         see two short flashes (“I” for idle), and the flight state
1709         machine is disengaged, thus no ejection charges will fire.
1710         The altimeters also listen for the radio link when in idle
1711         mode for requests sent via TeleDongle.  Commands can be issued
1712         in idle mode over either USB or the radio link
1713         equivalently. TeleMini v1.0 only has the radio link.  Idle
1714         mode is useful for configuring the altimeter, for extracting
1715         data from the on-board storage chip after flight, and for
1716         ground testing pyro charges.
1717       </para>
1718       <para>
1719         In “Idle” and “Pad” modes, once the mode indication
1720         beeps/flashes and continuity indication has been sent, if
1721         there is no space available to log the flight in on-board
1722         memory, the flight computer will emit a warbling tone (much
1723         slower than the “no continuity tone”)
1724       </para>
1725       <para>
1726         Here's a summary of all of the “pad” and “idle” mode indications.
1727         <table frame='all'>
1728           <title>Pad/Idle Indications</title>
1729           <?dbfo keep-together="always"?>
1730           <tgroup cols='3' align='center' colsep='1' rowsep='1'>
1731             <colspec align='center' colwidth='*' colname='Name'/>
1732             <colspec align='center' colwidth='*' colname='Beeps'/>
1733             <colspec align='center' colwidth='*' colname='Description'/>
1734             <thead>
1735               <row>
1736                 <entry>Name</entry>
1737                 <entry>Beeps</entry>
1738                 <entry>Description</entry>
1739               </row>
1740             </thead>
1741             <tbody>
1742               <row>
1743                 <entry>Neither</entry>
1744                 <entry>brap</entry>
1745                 <entry>
1746                   <para>
1747                     No continuity detected on either apogee or main
1748                     igniters.
1749                   </para>
1750                 </entry>
1751               </row>
1752               <row>
1753                 <entry>Apogee</entry>
1754                 <entry>dit</entry>
1755                 <entry>
1756                   <para>
1757                     Continuity detected only on apogee igniter.
1758                   </para>
1759                 </entry>
1760               </row>
1761               <row>
1762                 <entry>Main</entry>
1763                 <entry>dit dit</entry>
1764                 <entry>
1765                   <para>
1766                     Continuity detected only on main igniter.
1767                   </para>
1768                 </entry>
1769               </row>
1770               <row>
1771                 <entry>Both</entry>
1772                 <entry>dit dit dit</entry>
1773                 <entry>
1774                   <para>
1775                     Continuity detected on both igniters.
1776                   </para>
1777                 </entry>
1778               </row>
1779               <row>
1780                 <entry>Storage Full</entry>
1781                 <entry>warble</entry>
1782                 <entry>
1783                   <para>
1784                     On-board data logging storage is full. This will
1785                     not prevent the flight computer from safely
1786                     controlling the flight or transmitting telemetry
1787                     signals, but no record of the flight will be
1788                     stored in on-board flash.
1789                   </para>
1790                 </entry>
1791               </row>
1792             </tbody>
1793           </tgroup>
1794         </table>
1795       </para>
1796       <para>
1797         Once landed, the flight computer will signal that by emitting
1798         the “Landed” sound described above, after which it will beep
1799         out the apogee height (in meters). Each digit is represented
1800         by a sequence of short “dit” beeps, with a pause between
1801         digits. A zero digit is represented with one long “dah”
1802         beep. The flight computer will continue to report landed mode
1803         and beep out the maximum height until turned off.
1804       </para>
1805       <para>
1806         One “neat trick” of particular value when TeleMetrum or TeleMega are used with 
1807         very large air-frames, is that you can power the board up while the 
1808         rocket is horizontal, such that it comes up in idle mode.  Then you can
1809         raise the air-frame to launch position, and issue a 'reset' command 
1810         via TeleDongle over the radio link to cause the altimeter to reboot and 
1811         come up in flight mode.  This is much safer than standing on the top 
1812         step of a rickety step-ladder or hanging off the side of a launch 
1813         tower with a screw-driver trying to turn on your avionics before 
1814         installing igniters!
1815       </para>
1816       <para>
1817         TeleMini v1.0 is configured solely via the radio link. Of course, that
1818         means you need to know the TeleMini radio configuration values
1819         or you won't be able to communicate with it. For situations
1820         when you don't have the radio configuration values, TeleMini v1.0
1821         offers an 'emergency recovery' mode. In this mode, TeleMini is
1822         configured as follows:
1823         <itemizedlist>
1824           <listitem>
1825             <para>
1826             Sets the radio frequency to 434.550MHz
1827             </para>
1828           </listitem>
1829           <listitem>
1830             <para>
1831             Sets the radio calibration back to the factory value.
1832             </para>
1833           </listitem>
1834           <listitem>
1835             <para>
1836             Sets the callsign to N0CALL
1837             </para>
1838           </listitem>
1839           <listitem>
1840             <para>
1841             Does not go to 'pad' mode after five seconds.
1842             </para>
1843           </listitem>
1844         </itemizedlist>
1845       </para>
1846       <para>
1847         To get into 'emergency recovery' mode, first find the row of
1848         four small holes opposite the switch wiring. Using a short
1849         piece of small gauge wire, connect the outer two holes
1850         together, then power TeleMini up. Once the red LED is lit,
1851         disconnect the wire and the board should signal that it's in
1852         'idle' mode after the initial five second startup period.
1853       </para>
1854     </section>
1855     <section>
1856       <title>GPS </title>
1857       <para>
1858         TeleMetrum and TeleMega include a complete GPS receiver.  A
1859         complete explanation of how GPS works is beyond the scope of
1860         this manual, but the bottom line is that the GPS receiver
1861         needs to lock onto at least four satellites to obtain a solid
1862         3 dimensional position fix and know what time it is.
1863       </para>
1864       <para>
1865         The flight computers provide backup power to the GPS chip any time a 
1866         battery is connected.  This allows the receiver to “warm start” on
1867         the launch rail much faster than if every power-on were a GPS 
1868         “cold start”.  In typical operations, powering up
1869         on the flight line in idle mode while performing final air-frame
1870         preparation will be sufficient to allow the GPS receiver to cold
1871         start and acquire lock.  Then the board can be powered down during
1872         RSO review and installation on a launch rod or rail.  When the board
1873         is turned back on, the GPS system should lock very quickly, typically
1874         long before igniter installation and return to the flight line are
1875         complete.
1876       </para>
1877     </section>
1878     <section>
1879       <title>Controlling An Altimeter Over The Radio Link</title>
1880       <para>
1881         One of the unique features of the Altus Metrum system is the
1882         ability to create a two way command link between TeleDongle
1883         and an altimeter using the digital radio transceivers
1884         built into each device. This allows you to interact with the
1885         altimeter from afar, as if it were directly connected to the
1886         computer.
1887       </para>
1888       <para>
1889         Any operation which can be performed with a flight computer can
1890         either be done with the device directly connected to the
1891         computer via the USB cable, or through the radio
1892         link. TeleMini v1.0 doesn't provide a USB connector and so it is
1893         always communicated with over radio.  Select the appropriate 
1894         TeleDongle device when the list of devices is presented and 
1895         AltosUI will interact with an altimeter over the radio link.
1896       </para>
1897       <para>
1898         One oddity in the current interface is how AltosUI selects the
1899         frequency for radio communications. Instead of providing
1900         an interface to specifically configure the frequency, it uses
1901         whatever frequency was most recently selected for the target
1902         TeleDongle device in Monitor Flight mode. If you haven't ever
1903         used that mode with the TeleDongle in question, select the
1904         Monitor Flight button from the top level UI, and pick the
1905         appropriate TeleDongle device.  Once the flight monitoring
1906         window is open, select the desired frequency and then close it
1907         down again. All radio communications will now use that frequency.
1908       </para>
1909       <itemizedlist>
1910         <listitem>
1911           <para>
1912             Save Flight Data—Recover flight data from the rocket without
1913             opening it up.
1914           </para>
1915         </listitem>
1916         <listitem>
1917           <para>
1918             Configure altimeter apogee delays, main deploy heights
1919             and additional pyro event conditions
1920             to respond to changing launch conditions. You can also
1921             'reboot' the altimeter. Use this to remotely enable the
1922             flight computer by turning TeleMetrum or TeleMega on in “idle” mode,
1923             then once the air-frame is oriented for launch, you can
1924             reboot the altimeter and have it restart in pad mode
1925             without having to climb the scary ladder.
1926           </para>
1927         </listitem>
1928         <listitem>
1929           <para>
1930             Fire Igniters—Test your deployment charges without snaking
1931             wires out through holes in the air-frame. Simply assemble the
1932             rocket as if for flight with the apogee and main charges
1933             loaded, then remotely command the altimeter to fire the
1934             igniters.
1935           </para>
1936         </listitem>
1937       </itemizedlist>
1938       <para>
1939         Operation over the radio link for configuring an altimeter, ground
1940         testing igniters, and so forth uses the same RF frequencies as flight
1941         telemetry.  To configure the desired TeleDongle frequency, select
1942         the monitor flight tab, then use the frequency selector and 
1943         close the window before performing other desired radio operations.
1944       </para>
1945       <para>
1946         The flight computers only enable radio commanding in 'idle' mode.
1947         TeleMetrum and TeleMega use the accelerometer to detect which orientation they
1948         start up in, so make sure you have the flight computer lying horizontally when you turn
1949         it on. Otherwise, it will start in 'pad' mode ready for
1950         flight, and will not be listening for command packets from TeleDongle.
1951       </para>
1952       <para>
1953         TeleMini listens for a command packet for five seconds after
1954         first being turned on, if it doesn't hear anything, it enters
1955         'pad' mode, ready for flight and will no longer listen for
1956         command packets. The easiest way to connect to TeleMini is to
1957         initiate the command and select the TeleDongle device. At this
1958         point, the TeleDongle will be attempting to communicate with
1959         the TeleMini. Now turn TeleMini on, and it should immediately
1960         start communicating with the TeleDongle and the desired
1961         operation can be performed.
1962       </para>
1963       <para>
1964         You can monitor the operation of the radio link by watching the 
1965         lights on the devices. The red LED will flash each time a packet
1966         is transmitted, while the green LED will light up on TeleDongle when 
1967         it is waiting to receive a packet from the altimeter.
1968       </para>
1969     </section>
1970     <section>
1971       <title>Ground Testing </title>
1972       <para>
1973         An important aspect of preparing a rocket using electronic deployment
1974         for flight is ground testing the recovery system.  Thanks
1975         to the bi-directional radio link central to the Altus Metrum system,
1976         this can be accomplished in a TeleMega, TeleMetrum or TeleMini equipped rocket 
1977         with less work than you may be accustomed to with other systems.  It 
1978         can even be fun!
1979       </para>
1980       <para>
1981         Just prep the rocket for flight, then power up the altimeter
1982         in “idle” mode (placing air-frame horizontal for TeleMetrum or TeleMega, or
1983         selecting the Configure Altimeter tab for TeleMini).  This will cause 
1984         the firmware to go into “idle” mode, in which the normal flight
1985         state machine is disabled and charges will not fire without
1986         manual command.  You can now command the altimeter to fire the apogee
1987         or main charges from a safe distance using your computer and 
1988         TeleDongle and the Fire Igniter tab to complete ejection testing.
1989       </para>
1990     </section>
1991     <section>
1992       <title>Radio Link </title>
1993       <para>
1994         Our flight computers all incorporate an RF transceiver, but
1995         it's not a full duplex system... each end can only be transmitting or
1996         receiving at any given moment.  So we had to decide how to manage the
1997         link.
1998       </para>
1999       <para>
2000         By design, the altimeter firmware listens for the radio link when
2001         it's in “idle mode”, which
2002         allows us to use the radio link to configure the rocket, do things like
2003         ejection tests, and extract data after a flight without having to
2004         crack open the air-frame.  However, when the board is in “flight
2005         mode”, the altimeter only
2006         transmits and doesn't listen at all.  That's because we want to put
2007         ultimate priority on event detection and getting telemetry out of
2008         the rocket through
2009         the radio in case the rocket crashes and we aren't able to extract
2010         data later...
2011       </para>
2012       <para>
2013         We don't generally use a 'normal packet radio' mode like APRS
2014         because they're just too inefficient.  The GFSK modulation we
2015         use is FSK with the base-band pulses passed through a Gaussian
2016         filter before they go into the modulator to limit the
2017         transmitted bandwidth.  When combined with forward error
2018         correction and interleaving, this allows us to have a very
2019         robust 19.2 kilobit data link with only 10-40 milliwatts of
2020         transmit power, a whip antenna in the rocket, and a hand-held
2021         Yagi on the ground.  We've had flights to above 21k feet AGL
2022         with great reception, and calculations suggest we should be
2023         good to well over 40k feet AGL with a 5-element yagi on the
2024         ground with our 10mW units and over 100k feet AGL with the
2025         40mW devices.  We hope to fly boards to higher altitudes over
2026         time, and would of course appreciate customer feedback on
2027         performance in higher altitude flights!
2028       </para>
2029     </section>
2030     <section>
2031       <title>APRS</title>
2032       <para>
2033         TeleMetrum v2.0 and TeleMega can send APRS if desired, and the
2034         interval between APRS packets can be configured. As each APRS
2035         packet takes a full second to transmit, we recommend an
2036         interval of at least 5 seconds to avoid consuming too much
2037         battery power or radio channel bandwidth. You can configure
2038         the APRS interval using AltosUI; that process is described in
2039         the Configure Altimeter section of the AltosUI chapter.
2040       </para>
2041       <para>
2042         AltOS uses the APRS compressed position report data format,
2043         which provides for higher position precision and shorter
2044         packets than the original APRS format. It also includes
2045         altitude data, which is invaluable when tracking rockets. We
2046         haven't found a receiver which doesn't handle compressed
2047         positions, but it's just possible that you have one, so if you
2048         have an older device that can receive the raw packets but
2049         isn't displaying position information, it's possible that this
2050         is the cause.
2051       </para>
2052       <para>
2053         The APRS packet format includes a comment field that can have
2054         arbitrary text in it. AltOS uses this to send status
2055         information about the flight computer. It sends four fields as
2056         shown in the following table.
2057       </para>
2058       <table frame='all'>
2059         <title>Altus Metrum APRS Comments</title>
2060         <?dbfo keep-together="always"?>
2061         <tgroup cols='3' align='center' colsep='1' rowsep='1'>
2062           <colspec align='center' colwidth='*' colname='Field'/>
2063           <colspec align='center' colwidth='*' colname='Example'/>
2064           <colspec align='center' colwidth='4*' colname='Description'/>
2065           <thead>
2066             <row>
2067               <entry align='center'>Field</entry>
2068               <entry align='center'>Example</entry>
2069               <entry align='center'>Description</entry>
2070             </row>
2071           </thead>
2072           <tbody>
2073             <row>
2074               <entry>1</entry>
2075               <entry>L</entry>
2076               <entry>GPS Status U for unlocked, L for locked</entry>
2077             </row>
2078             <row>
2079               <entry>2</entry>
2080               <entry>6</entry>
2081               <entry>Number of Satellites in View</entry>
2082             </row>
2083             <row>
2084               <entry>3</entry>
2085               <entry>B4.0</entry>
2086               <entry>Altimeter Battery Voltage</entry>
2087             </row>
2088             <row>
2089               <entry>4</entry>
2090               <entry>A3.7</entry>
2091               <entry>Apogee Igniter Voltage</entry>
2092             </row>
2093             <row>
2094               <entry>5</entry>
2095               <entry>M3.7</entry>
2096               <entry>Main Igniter Voltage</entry>
2097             </row>
2098           </tbody>
2099         </tgroup>
2100       </table>
2101       <para>
2102         Here's an example of an APRS comment showing GPS lock with 6
2103         satellites in view, a primary battery at 4.0V, and
2104         apogee and main igniters both at 3.7V.
2105         <screen>
2106           L6 B4.0 A3.7 M3.7
2107         </screen>
2108       </para>
2109       <para>
2110         Make sure your primary battery is above 3.8V, any connected
2111         igniters are above 3.5V and GPS is locked with at least 5 or 6
2112         satellites in view before flying. If GPS is switching between
2113         L and U regularly, then it doesn't have a good lock and you
2114         should wait until it becomes stable.
2115       </para>
2116       <para>
2117         If the GPS receiver loses lock, the APRS data transmitted will
2118         contain the last position for which GPS lock was
2119         available. You can tell that this has happened by noticing
2120         that the GPS status character switches from 'L' to 'U'. Before
2121         GPS has locked, APRS will transmit zero for latitude,
2122         longitude and altitude.
2123       </para>
2124     </section>
2125     <section>
2126       <title>Configurable Parameters</title>
2127       <para>
2128         Configuring an Altus Metrum altimeter for flight is very
2129         simple.  Even on our baro-only TeleMini and EasyMini boards,
2130         the use of a Kalman filter means there is no need to set a
2131         “mach delay”.  The few configurable parameters can all be set
2132         using AltosUI over USB or or radio link via TeleDongle. Read
2133         the Configure Altimeter section in the AltosUI chapter below
2134         for more information.
2135       </para>
2136       <section>
2137         <title>Radio Frequency</title>
2138         <para>
2139           Altus Metrum boards support radio frequencies in the 70cm
2140           band. By default, the configuration interface provides a
2141           list of 10 “standard” frequencies in 100kHz channels starting at
2142           434.550MHz.  However, the firmware supports use of
2143           any 50kHz multiple within the 70cm band. At any given
2144           launch, we highly recommend coordinating when and by whom each
2145           frequency will be used to avoid interference.  And of course, both
2146           altimeter and TeleDongle must be configured to the same
2147           frequency to successfully communicate with each other.
2148         </para>
2149       </section>
2150       <section>
2151         <title>Callsign</title>
2152         <para>
2153           This sets the callsign used for telemetry, APRS and the
2154           packet link. For telemetry and APRS, this is used to
2155           identify the device. For the packet link, the callsign must
2156           match that configured in AltosUI or the link will not
2157           work. This is to prevent accidental configuration of another
2158           Altus Metrum flight computer operating on the same frequency nearby.
2159         </para>
2160       </section>
2161       <section>
2162         <title>Telemetry/RDF/APRS Enable</title>
2163         <para>
2164           You can completely disable the radio while in flight, if
2165           necessary. This doesn't disable the packet link in idle
2166           mode.
2167         </para>
2168       </section>
2169       <section>
2170         <title>APRS Interval</title>
2171         <para>
2172           This selects how often APRS packets are transmitted. Set
2173           this to zero to disable APRS without also disabling the
2174           regular telemetry and RDF transmissions. As APRS takes a
2175           full second to transmit a single position report, we
2176           recommend sending packets no more than once every 5 seconds.
2177         </para>
2178       </section>
2179       <section>
2180         <title>Apogee Delay</title>
2181         <para>
2182           Apogee delay is the number of seconds after the altimeter detects flight
2183           apogee that the drogue charge should be fired.  In most cases, this
2184           should be left at the default of 0.  However, if you are flying
2185           redundant electronics such as for an L3 certification, you may wish
2186           to set one of your altimeters to a positive delay so that both
2187           primary and backup pyrotechnic charges do not fire simultaneously.
2188         </para>
2189         <para>
2190           The Altus Metrum apogee detection algorithm fires exactly at
2191           apogee.  If you are also flying an altimeter like the
2192           PerfectFlite MAWD, which only supports selecting 0 or 1
2193           seconds of apogee delay, you may wish to set the MAWD to 0
2194           seconds delay and set the TeleMetrum to fire your backup 2
2195           or 3 seconds later to avoid any chance of both charges
2196           firing simultaneously.  We've flown several air-frames this
2197           way quite happily, including Keith's successful L3 cert.
2198         </para>
2199       </section>
2200       <section>
2201         <title>Apogee Lockout</title>
2202         <para>
2203           Apogee lockout is the number of seconds after boost where
2204           the flight computer will not fire the apogee charge, even if
2205           the rocket appears to be at apogee. This is often called
2206           'Mach Delay', as it is intended to prevent a flight computer
2207           from unintentionally firing apogee charges due to the pressure
2208           spike that occurrs across a mach transition. Altus Metrum
2209           flight computers include a Kalman filter which is not fooled
2210           by this sharp pressure increase, and so this setting should
2211           be left at the default value of zero to disable it.
2212         </para>
2213       </section>
2214       <section>
2215         <title>Main Deployment Altitude</title>
2216         <para>
2217           By default, the altimeter will fire the main deployment charge at an
2218           elevation of 250 meters (about 820 feet) above ground.  We think this
2219           is a good elevation for most air-frames, but feel free to change this
2220           to suit.  In particular, if you are flying two altimeters, you may
2221           wish to set the
2222           deployment elevation for the backup altimeter to be something lower
2223           than the primary so that both pyrotechnic charges don't fire
2224           simultaneously.
2225         </para>
2226       </section>
2227       <section>
2228         <title>Maximum Flight Log</title>
2229         <para>
2230           Changing this value will set the maximum amount of flight
2231           log storage that an individual flight will use. The
2232           available storage is divided into as many flights of the
2233           specified size as can fit in the available space. You can
2234           download and erase individual flight logs. If you fill up
2235           the available storage, future flights will not get logged
2236           until you erase some of the stored ones.
2237         </para>
2238         <para>
2239           Even though our flight computers (except TeleMini v1.0) can store
2240           multiple flights, we strongly recommend downloading and saving
2241           flight data after each flight.
2242         </para>
2243       </section>
2244       <section>
2245         <title>Ignite Mode</title>
2246         <para>
2247           Instead of firing one charge at apogee and another charge at
2248           a fixed height above the ground, you can configure the
2249           altimeter to fire both at apogee or both during
2250           descent. This was added to support an airframe Bdale designed that 
2251           had two altimeters, one in the fin can and one in the nose.
2252         </para>
2253         <para>
2254           Providing the ability to use both igniters for apogee or
2255           main allows some level of redundancy without needing two
2256           flight computers.  In Redundant Apogee or Redundant Main
2257           mode, the two charges will be fired two seconds apart.
2258         </para>
2259       </section>
2260       <section>
2261         <title>Pad Orientation</title>
2262         <para>
2263           TeleMetrum and TeleMega measure acceleration along the axis
2264           of the board. Which way the board is oriented affects the
2265           sign of the acceleration value. Instead of trying to guess
2266           which way the board is mounted in the air frame, the
2267           altimeter must be explicitly configured for either Antenna
2268           Up or Antenna Down. The default, Antenna Up, expects the end
2269           of the board connected to the 70cm antenna to be nearest the
2270           nose of the rocket, with the end containing the screw
2271           terminals nearest the tail.
2272         </para>
2273       </section>
2274       <section>
2275         <title>Configurable Pyro Channels</title>
2276         <para>
2277           In addition to the usual Apogee and Main pyro channels,
2278           TeleMega has four additional channels that can be configured
2279           to activate when various flight conditions are
2280           satisfied. You can select as many conditions as necessary;
2281           all of them must be met in order to activate the
2282           channel. The conditions available are:
2283         </para>
2284         <itemizedlist>
2285           <listitem>
2286             <para>
2287               Acceleration away from the ground. Select a value, and
2288               then choose whether acceleration should be above or
2289               below that value. Acceleration is positive upwards, so
2290               accelerating towards the ground would produce negative
2291               numbers. Acceleration during descent is noisy and
2292               inaccurate, so be careful when using it during these
2293               phases of the flight.
2294             </para>
2295           </listitem>
2296           <listitem>
2297             <para>
2298               Vertical speed.  Select a value, and then choose whether
2299               vertical speed should be above or below that
2300               value. Speed is positive upwards, so moving towards the
2301               ground would produce negative numbers. Speed during
2302               descent is a bit noisy and so be careful when using it
2303               during these phases of the flight.
2304             </para>
2305           </listitem>
2306           <listitem>
2307             <para>
2308               Height. Select a value, and then choose whether the
2309               height above the launch pad should be above or below
2310               that value.
2311             </para>
2312           </listitem>
2313           <listitem>
2314             <para>
2315               Orientation. TeleMega contains a 3-axis gyroscope and
2316               accelerometer which is used to measure the current
2317               angle. Note that this angle is not the change in angle
2318               from the launch pad, but rather absolute relative to
2319               gravity; the 3-axis accelerometer is used to compute the
2320               angle of the rocket on the launch pad and initialize the
2321               system. Because this value is computed by integrating
2322               rate gyros, it gets progressively less accurate as the
2323               flight goes on. It should have an accumulated error of
2324               less than 0.2°/second (after 10 seconds of flight, the
2325               error should be less than 2°).
2326             </para>
2327             <para>
2328               The usual use of the orientation configuration is to
2329               ensure that the rocket is traveling mostly upwards when
2330               deciding whether to ignite air starts or additional
2331               stages. For that, choose a reasonable maximum angle
2332               (like 20°) and set the motor igniter to require an angle
2333               of less than that value.
2334             </para>
2335           </listitem>
2336           <listitem>
2337             <para>
2338               Flight Time. Time since boost was detected. Select a
2339               value and choose whether to activate the pyro channel
2340               before or after that amount of time.
2341             </para>
2342           </listitem>
2343           <listitem>
2344             <para>
2345               Ascending. A simple test saying whether the rocket is
2346               going up or not. This is exactly equivalent to testing
2347               whether the speed is &gt; 0.
2348             </para>
2349           </listitem>
2350           <listitem>
2351             <para>
2352               Descending. A simple test saying whether the rocket is
2353               going down or not. This is exactly equivalent to testing
2354               whether the speed is &lt; 0.
2355             </para>
2356           </listitem>
2357           <listitem>
2358             <para>
2359               After Motor. The flight software counts each time the
2360               rocket starts accelerating (presumably due to a motor or
2361               motors igniting). Use this value to count ignitions for
2362               multi-staged or multi-airstart launches.
2363             </para>
2364           </listitem>
2365           <listitem>
2366             <para>
2367               Delay. This value doesn't perform any checks, instead it
2368               inserts a delay between the time when the other
2369               parameters become true and when the pyro channel is
2370               activated.
2371             </para>
2372           </listitem>
2373           <listitem>
2374             <para>
2375               Flight State. The flight software tracks the flight
2376               through a sequence of states:
2377               <orderedlist>
2378                 <listitem>
2379                   <para>
2380                     Boost. The motor has lit and the rocket is
2381                     accelerating upwards.
2382                   </para>
2383                 </listitem>
2384                 <listitem>
2385                   <para>
2386                     Fast. The motor has burned out and the rocket is
2387                     decelerating, but it is going faster than 200m/s.
2388                   </para>
2389                 </listitem>
2390                 <listitem>
2391                   <para>
2392                     Coast. The rocket is still moving upwards and
2393                     decelerating, but the speed is less than 200m/s.
2394                   </para>
2395                 </listitem>
2396                 <listitem>
2397                   <para>
2398                     Drogue. The rocket has reached apogee and is heading
2399                     back down, but is above the configured Main
2400                     altitude.
2401                   </para>
2402                 </listitem>
2403                 <listitem>
2404                   <para>
2405                     Main. The rocket is still descending, and is below
2406                     the Main altitude
2407                   </para>
2408                 </listitem>
2409                 <listitem>
2410                   <para>
2411                     Landed. The rocket is no longer moving.
2412                   </para>
2413                 </listitem>
2414               </orderedlist>
2415             </para>
2416             <para>
2417               You can select a state to limit when the pyro channel
2418               may activate; note that the check is based on when the
2419               rocket transitions <emphasis>into</emphasis> the state, and so checking for
2420               “greater than Boost” means that the rocket is currently
2421               in boost or some later state.
2422             </para>
2423             <para>
2424               When a motor burns out, the rocket enters either Fast or
2425               Coast state (depending on how fast it is moving). If the
2426               computer detects upwards acceleration again, it will
2427               move back to Boost state.
2428             </para>
2429           </listitem>
2430         </itemizedlist>
2431       </section>
2432     </section>
2433
2434   </chapter>
2435   <chapter>
2436     <title>AltosUI</title>
2437     <informalfigure>
2438       <mediaobject>
2439         <imageobject>
2440           <imagedata fileref="altosui.png" width="4.6in"/>
2441         </imageobject>
2442       </mediaobject>
2443     </informalfigure>
2444     <para>
2445       The AltosUI program provides a graphical user interface for
2446       interacting with the Altus Metrum product family. AltosUI can
2447       monitor telemetry data, configure devices and many other
2448       tasks. The primary interface window provides a selection of
2449       buttons, one for each major activity in the system.  This chapter
2450       is split into sections, each of which documents one of the tasks
2451       provided from the top-level toolbar.
2452     </para>
2453     <section>
2454       <title>Monitor Flight</title>
2455       <subtitle>Receive, Record and Display Telemetry Data</subtitle>
2456       <para>
2457         Selecting this item brings up a dialog box listing all of the
2458         connected TeleDongle devices. When you choose one of these,
2459         AltosUI will create a window to display telemetry data as
2460         received by the selected TeleDongle device.
2461       </para>
2462       <informalfigure>
2463         <mediaobject>
2464           <imageobject>
2465             <imagedata fileref="device-selection.png" width="3.1in"/>
2466           </imageobject>
2467         </mediaobject>
2468       </informalfigure>
2469       <para>
2470         All telemetry data received are automatically recorded in
2471         suitable log files. The name of the files includes the current
2472         date and rocket serial and flight numbers.
2473       </para>
2474       <para>
2475         The radio frequency being monitored by the TeleDongle device is
2476         displayed at the top of the window. You can configure the
2477         frequency by clicking on the frequency box and selecting the desired
2478         frequency. AltosUI remembers the last frequency selected for each
2479         TeleDongle and selects that automatically the next time you use
2480         that device.
2481       </para>
2482       <para>
2483         Below the TeleDongle frequency selector, the window contains a few
2484         significant pieces of information about the altimeter providing
2485         the telemetry data stream:
2486       </para>
2487       <itemizedlist>
2488         <listitem>
2489           <para>The configured call-sign</para>
2490         </listitem>
2491         <listitem>
2492           <para>The device serial number</para>
2493         </listitem>
2494         <listitem>
2495           <para>The flight number. Each altimeter remembers how many
2496             times it has flown.
2497           </para>
2498         </listitem>
2499         <listitem>
2500           <para>
2501             The rocket flight state. Each flight passes through several
2502             states including Pad, Boost, Fast, Coast, Drogue, Main and
2503             Landed.
2504           </para>
2505         </listitem>
2506         <listitem>
2507           <para>
2508             The Received Signal Strength Indicator value. This lets
2509             you know how strong a signal TeleDongle is receiving. The
2510             radio inside TeleDongle operates down to about -99dBm;
2511             weaker signals may not be receivable. The packet link uses
2512             error detection and correction techniques which prevent
2513             incorrect data from being reported.
2514           </para>
2515         </listitem>
2516         <listitem>
2517           <para>
2518             The age of the displayed data, in seconds since the last 
2519             successfully received telemetry packet.  In normal operation
2520             this will stay in the low single digits.  If the number starts
2521             counting up, then you are no longer receiving data over the radio
2522             link from the flight computer.
2523           </para>
2524         </listitem>
2525       </itemizedlist>
2526       <para>
2527         Finally, the largest portion of the window contains a set of
2528         tabs, each of which contain some information about the rocket.
2529         They're arranged in 'flight order' so that as the flight
2530         progresses, the selected tab automatically switches to display
2531         data relevant to the current state of the flight. You can select
2532         other tabs at any time. The final 'table' tab displays all of
2533         the raw telemetry values in one place in a spreadsheet-like format.
2534       </para>
2535       <section>
2536         <title>Launch Pad</title>
2537         <informalfigure>
2538           <mediaobject>
2539             <imageobject>
2540               <imagedata fileref="launch-pad.png" width="5.5in"/>
2541             </imageobject>
2542           </mediaobject>
2543         </informalfigure>
2544         <para>
2545           The 'Launch Pad' tab shows information used to decide when the
2546           rocket is ready for flight. The first elements include red/green
2547           indicators, if any of these is red, you'll want to evaluate
2548           whether the rocket is ready to launch:
2549           <variablelist>
2550             <varlistentry>
2551               <term>Battery Voltage</term>
2552               <listitem>
2553                 <para>
2554                   This indicates whether the Li-Po battery powering the 
2555                   flight computer has sufficient charge to last for
2556                   the duration of the flight. A value of more than
2557                   3.8V is required for a 'GO' status.
2558                 </para>
2559               </listitem>
2560             </varlistentry>
2561             <varlistentry>
2562               <term>Apogee Igniter Voltage</term>
2563               <listitem>
2564                 <para>
2565                   This indicates whether the apogee
2566                   igniter has continuity. If the igniter has a low
2567                   resistance, then the voltage measured here will be close
2568                   to the Li-Po battery voltage. A value greater than 3.2V is
2569                   required for a 'GO' status.
2570                 </para>
2571               </listitem>
2572             </varlistentry>
2573             <varlistentry>
2574               <term>Main Igniter Voltage</term>
2575               <listitem>
2576                 <para>
2577                   This indicates whether the main
2578                   igniter has continuity. If the igniter has a low
2579                   resistance, then the voltage measured here will be close
2580                   to the Li-Po battery voltage. A value greater than 3.2V is
2581                   required for a 'GO' status.
2582                 </para>
2583               </listitem>
2584             </varlistentry>
2585             <varlistentry>
2586               <term>On-board Data Logging</term>
2587               <listitem>
2588                 <para>
2589                   This indicates whether there is
2590                   space remaining on-board to store flight data for the
2591                   upcoming flight. If you've downloaded data, but failed
2592                   to erase flights, there may not be any space
2593                   left. Most of our flight computers can store multiple 
2594                   flights, depending on the configured maximum flight log 
2595                   size. TeleMini v1.0 stores only a single flight, so it 
2596                   will need to be
2597                   downloaded and erased after each flight to capture
2598                   data. This only affects on-board flight logging; the
2599                   altimeter will still transmit telemetry and fire
2600                   ejection charges at the proper times even if the flight
2601                   data storage is full.
2602                 </para>
2603               </listitem>
2604             </varlistentry>
2605             <varlistentry>
2606               <term>GPS Locked</term>
2607               <listitem>
2608                 <para>
2609                   For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is
2610                   currently able to compute position information. GPS requires
2611                   at least 4 satellites to compute an accurate position.
2612                 </para>
2613               </listitem>
2614             </varlistentry>
2615             <varlistentry>
2616               <term>GPS Ready</term>
2617               <listitem>
2618                 <para>
2619                   For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least
2620                   10 consecutive positions without losing lock. This ensures
2621                   that the GPS receiver has reliable reception from the
2622                   satellites.
2623                 </para>
2624               </listitem>
2625             </varlistentry>
2626           </variablelist>
2627         </para>
2628         <para>
2629           The Launchpad tab also shows the computed launch pad position
2630           and altitude, averaging many reported positions to improve the
2631           accuracy of the fix.
2632         </para>
2633       </section>
2634       <section>
2635         <title>Ascent</title>
2636         <informalfigure>
2637           <mediaobject>
2638             <imageobject>
2639               <imagedata fileref="ascent.png" width="5.5in"/>
2640             </imageobject>
2641           </mediaobject>
2642         </informalfigure>
2643         <para>
2644           This tab is shown during Boost, Fast and Coast
2645           phases. The information displayed here helps monitor the
2646           rocket as it heads towards apogee.
2647         </para>
2648         <para>
2649           The height, speed, acceleration and tilt are shown along
2650           with the maximum values for each of them. This allows you to
2651           quickly answer the most commonly asked questions you'll hear
2652           during flight.
2653         </para>
2654         <para>
2655           The current latitude and longitude reported by the GPS are
2656           also shown. Note that under high acceleration, these values
2657           may not get updated as the GPS receiver loses position
2658           fix. Once the rocket starts coasting, the receiver should
2659           start reporting position again.
2660         </para>
2661         <para>
2662           Finally, the current igniter voltages are reported as in the
2663           Launch Pad tab. This can help diagnose deployment failures
2664           caused by wiring which comes loose under high acceleration.
2665         </para>
2666       </section>
2667       <section>
2668         <title>Descent</title>
2669         <informalfigure>
2670           <mediaobject>
2671             <imageobject>
2672               <imagedata fileref="descent.png" width="5.5in"/>
2673             </imageobject>
2674           </mediaobject>
2675         </informalfigure>
2676         <para>
2677           Once the rocket has reached apogee and (we hope) activated the
2678           apogee charge, attention switches to tracking the rocket on
2679           the way back to the ground, and for dual-deploy flights,
2680           waiting for the main charge to fire.
2681         </para>
2682         <para>
2683           To monitor whether the apogee charge operated correctly, the
2684           current descent rate is reported along with the current
2685           height. Good descent rates vary based on the choice of recovery
2686           components, but generally range from 15-30m/s on drogue and should
2687           be below 10m/s when under the main parachute in a dual-deploy flight.
2688         </para>
2689         <para>
2690           With GPS-equipped flight computers, you can locate the rocket in the
2691           sky using the elevation and bearing information to figure
2692           out where to look. Elevation is in degrees above the
2693           horizon. Bearing is reported in degrees relative to true
2694           north. Range can help figure out how big the rocket will
2695           appear. Ground Distance shows how far it is to a point
2696           directly under the rocket and can help figure out where the
2697           rocket is likely to land. Note that all of these values are
2698           relative to the pad location. If the elevation is near 90°,
2699           the rocket is over the pad, not over you.
2700         </para>
2701         <para>
2702           Finally, the igniter voltages are reported in this tab as
2703           well, both to monitor the main charge as well as to see what
2704           the status of the apogee charge is.  Note that some commercial
2705           e-matches are designed to retain continuity even after being
2706           fired, and will continue to show as green or return from red to
2707           green after firing.
2708         </para>
2709       </section>
2710       <section>
2711         <title>Landed</title>
2712         <informalfigure>
2713           <mediaobject>
2714             <imageobject>
2715               <imagedata fileref="landed.png" width="5.5in"/>
2716             </imageobject>
2717           </mediaobject>
2718         </informalfigure>
2719         <para>
2720           Once the rocket is on the ground, attention switches to
2721           recovery. While the radio signal is often lost once the
2722           rocket is on the ground, the last reported GPS position is
2723           generally within a short distance of the actual landing location.
2724         </para>
2725         <para>
2726           The last reported GPS position is reported both by
2727           latitude and longitude as well as a bearing and distance from
2728           the launch pad. The distance should give you a good idea of
2729           whether to walk or hitch a ride.  Take the reported
2730           latitude and longitude and enter them into your hand-held GPS
2731           unit and have that compute a track to the landing location.
2732         </para>
2733         <para>
2734           Our flight computers will continue to transmit RDF
2735           tones after landing, allowing you to locate the rocket by
2736           following the radio signal if necessary. You may need to get 
2737           away from the clutter of the flight line, or even get up on 
2738           a hill (or your neighbor's RV roof) to receive the RDF signal.
2739         </para>
2740         <para>
2741           The maximum height, speed and acceleration reported
2742           during the flight are displayed for your admiring observers.
2743           The accuracy of these immediate values depends on the quality
2744           of your radio link and how many packets were received.  
2745           Recovering the on-board data after flight may yield
2746           more precise results.
2747         </para>
2748         <para>
2749           To get more detailed information about the flight, you can
2750           click on the 'Graph Flight' button which will bring up a
2751           graph window for the current flight.
2752         </para>
2753       </section>
2754       <section>
2755         <title>Table</title>
2756         <informalfigure>
2757           <mediaobject>
2758             <imageobject>
2759               <imagedata fileref="table.png" width="5.5in"/>
2760             </imageobject>
2761           </mediaobject>
2762         </informalfigure>
2763         <para>
2764           The table view shows all of the data available from the
2765           flight computer. Probably the most useful data on
2766           this tab is the detailed GPS information, which includes
2767           horizontal dilution of precision information, and
2768           information about the signal being received from the satellites.
2769         </para>
2770       </section>
2771       <section>
2772         <title>Site Map</title>
2773         <informalfigure>
2774           <mediaobject>
2775             <imageobject>
2776               <imagedata fileref="site-map.png" width="5.5in"/>
2777             </imageobject>
2778           </mediaobject>
2779         </informalfigure>
2780         <para>
2781           When the TeleMetrum has a GPS fix, the Site Map tab will map
2782           the rocket's position to make it easier for you to locate the
2783           rocket, both while it is in the air, and when it has landed. The
2784           rocket's state is indicated by color: white for pad, red for
2785           boost, pink for fast, yellow for coast, light blue for drogue,
2786           dark blue for main, and black for landed.
2787         </para>
2788         <para>
2789           The map's default scale is approximately 3m (10ft) per pixel. The map
2790           can be dragged using the left mouse button. The map will attempt
2791           to keep the rocket roughly centered while data is being received.
2792         </para>
2793         <para>
2794           You can adjust the style of map and the zoom level with
2795           buttons on the right side of the map window. You can draw a
2796           line on the map by moving the mouse over the map with a
2797           button other than the left one pressed, or by pressing the
2798           left button while also holding down the shift key. The
2799           length of the line in real-world units will be shown at the
2800           start of the line.
2801         </para>
2802         <para>
2803           Images are fetched automatically via the Google Maps Static API,
2804           and cached on disk for reuse. If map images cannot be downloaded,
2805           the rocket's path will be traced on a dark gray background
2806           instead.
2807         </para>
2808         <para>
2809           You can pre-load images for your favorite launch sites
2810           before you leave home; check out the 'Preload Maps' section below.
2811         </para>
2812       </section>
2813       <section>
2814         <title>Ignitor</title>
2815         <informalfigure>
2816           <mediaobject>
2817             <imageobject>
2818               <imagedata fileref="ignitor.png" width="5.5in"/>
2819             </imageobject>
2820           </mediaobject>
2821         </informalfigure>
2822         <para>
2823           TeleMega includes four additional programmable pyro
2824           channels. The Ignitor tab shows whether each of them has
2825           continuity. If an ignitor has a low resistance, then the
2826           voltage measured here will be close to the pyro battery
2827           voltage. A value greater than 3.2V is required for a 'GO'
2828           status.
2829         </para>
2830       </section>
2831     </section>
2832     <section>
2833       <title>Save Flight Data</title>
2834       <para>
2835         The altimeter records flight data to its internal flash memory.
2836         TeleMetrum data is recorded at a much higher rate than the telemetry
2837         system can handle, and is not subject to radio drop-outs. As
2838         such, it provides a more complete and precise record of the
2839         flight. The 'Save Flight Data' button allows you to read the
2840         flash memory and write it to disk. 
2841       </para>
2842       <para>
2843         Clicking on the 'Save Flight Data' button brings up a list of
2844         connected flight computers and TeleDongle devices. If you select a
2845         flight computer, the flight data will be downloaded from that
2846         device directly. If you select a TeleDongle device, flight data
2847         will be downloaded from a flight computer over radio link via the 
2848         specified TeleDongle. See the chapter on Controlling An Altimeter 
2849         Over The Radio Link for more information.
2850       </para>
2851       <para>
2852         After the device has been selected, a dialog showing the
2853         flight data saved in the device will be shown allowing you to
2854         select which flights to download and which to delete. With
2855         version 0.9 or newer firmware, you must erase flights in order
2856         for the space they consume to be reused by another
2857         flight. This prevents accidentally losing flight data
2858         if you neglect to download data before flying again. Note that
2859         if there is no more space available in the device, then no
2860         data will be recorded during the next flight.
2861       </para>
2862       <para>
2863         The file name for each flight log is computed automatically
2864         from the recorded flight date, altimeter serial number and
2865         flight number information.
2866       </para>
2867     </section>
2868     <section>
2869       <title>Replay Flight</title>
2870       <para>
2871         Select this button and you are prompted to select a flight
2872         record file, either a .telem file recording telemetry data or a
2873         .eeprom file containing flight data saved from the altimeter
2874         flash memory.
2875       </para>
2876       <para>
2877         Once a flight record is selected, the flight monitor interface
2878         is displayed and the flight is re-enacted in real time. Check
2879         the Monitor Flight chapter above to learn how this window operates.
2880       </para>
2881     </section>
2882     <section>
2883       <title>Graph Data</title>
2884       <para>
2885         Select this button and you are prompted to select a flight
2886         record file, either a .telem file recording telemetry data or a
2887         .eeprom file containing flight data saved from
2888         flash memory.
2889       </para>
2890       <para>
2891         Note that telemetry files will generally produce poor graphs
2892         due to the lower sampling rate and missed telemetry packets.
2893         Use saved flight data in .eeprom files for graphing where possible.
2894       </para>
2895       <para>
2896         Once a flight record is selected, a window with multiple tabs is
2897         opened.
2898       </para>
2899       <section>
2900         <title>Flight Graph</title>
2901         <informalfigure>
2902           <mediaobject>
2903             <imageobject>
2904               <imagedata fileref="graph.png" width="6in" scalefit="1"/>
2905             </imageobject>
2906           </mediaobject>
2907         </informalfigure>
2908         <para>
2909           By default, the graph contains acceleration (blue),
2910           velocity (green) and altitude (red).
2911         </para>
2912       <para>
2913         The graph can be zoomed into a particular area by clicking and
2914         dragging down and to the right. Once zoomed, the graph can be
2915         reset by clicking and dragging up and to the left. Holding down
2916         control and clicking and dragging allows the graph to be panned.
2917         The right mouse button causes a pop-up menu to be displayed, giving
2918         you the option save or print the plot.
2919       </para>
2920       </section>
2921       <section>
2922         <title>Configure Graph</title>
2923         <informalfigure>
2924           <mediaobject>
2925             <imageobject>
2926               <imagedata fileref="graph-configure.png" width="6in" scalefit="1"/>
2927             </imageobject>
2928           </mediaobject>
2929         </informalfigure>
2930         <para>
2931           This selects which graph elements to show, and, at the
2932           very bottom, lets you switch between metric and
2933           imperial units
2934         </para>
2935       </section>
2936       <section>
2937         <title>Flight Statistics</title>
2938         <informalfigure>
2939           <mediaobject>
2940             <imageobject>
2941               <imagedata fileref="graph-stats.png" width="6in" scalefit="1"/>
2942             </imageobject>
2943           </mediaobject>
2944         </informalfigure>
2945         <para>
2946           Shows overall data computed from the flight.
2947         </para>
2948       </section>
2949       <section>
2950         <title>Map</title>
2951         <informalfigure>
2952           <mediaobject>
2953             <imageobject>
2954               <imagedata fileref="graph-map.png" width="6in" scalefit="1"/>
2955             </imageobject>
2956           </mediaobject>
2957         </informalfigure>
2958         <para>
2959           Shows a satellite image of the flight area overlaid
2960           with the path of the flight. The red concentric
2961           circles mark the launch pad, the black concentric
2962           circles mark the landing location.
2963         </para>
2964       </section>
2965     </section>
2966     <section>
2967       <title>Export Data</title>
2968       <para>
2969         This tool takes the raw data files and makes them available for
2970         external analysis. When you select this button, you are prompted to 
2971         select a flight data file, which can be either a .eeprom or .telem.
2972         The .eeprom files contain higher resolution and more continuous data, 
2973         while .telem files contain receiver signal strength information.  
2974         Next, a second dialog appears which is used to select
2975         where to write the resulting file. It has a selector to choose
2976         between CSV and KML file formats.
2977       </para>
2978       <section>
2979         <title>Comma Separated Value Format</title>
2980         <para>
2981           This is a text file containing the data in a form suitable for
2982           import into a spreadsheet or other external data analysis
2983           tool. The first few lines of the file contain the version and
2984           configuration information from the altimeter, then
2985           there is a single header line which labels all of the
2986           fields. All of these lines start with a '#' character which
2987           many tools can be configured to skip over.
2988         </para>
2989         <para>
2990           The remaining lines of the file contain the data, with each
2991           field separated by a comma and at least one space. All of
2992           the sensor values are converted to standard units, with the
2993           barometric data reported in both pressure, altitude and
2994           height above pad units.
2995         </para>
2996       </section>
2997       <section>
2998         <title>Keyhole Markup Language (for Google Earth)</title>
2999         <para>
3000           This is the format used by Google Earth to provide an overlay 
3001           within that application. With this, you can use Google Earth to 
3002           see the whole flight path in 3D.
3003         </para>
3004       </section>
3005     </section>
3006     <section>
3007       <title>Configure Altimeter</title>
3008       <informalfigure>
3009         <mediaobject>
3010           <imageobject>
3011             <imagedata fileref="configure-altimeter.png" width="3.6in" scalefit="1"/>
3012           </imageobject>
3013         </mediaobject>
3014       </informalfigure>
3015       <para>
3016         Select this button and then select either an altimeter or
3017         TeleDongle Device from the list provided. Selecting a TeleDongle
3018         device will use the radio link to configure a remote altimeter. 
3019       </para>
3020       <para>
3021         The first few lines of the dialog provide information about the
3022         connected device, including the product name,
3023         software version and hardware serial number. Below that are the
3024         individual configuration entries.
3025       </para>
3026       <para>
3027         At the bottom of the dialog, there are four buttons:
3028       </para>
3029       <variablelist>
3030         <varlistentry>
3031           <term>Save</term>
3032           <listitem>
3033             <para>
3034               This writes any changes to the
3035               configuration parameter block in flash memory. If you don't
3036               press this button, any changes you make will be lost.
3037             </para>
3038           </listitem>
3039         </varlistentry>
3040         <varlistentry>
3041           <term>Reset</term>
3042           <listitem>
3043             <para>
3044               This resets the dialog to the most recently saved values,
3045               erasing any changes you have made.
3046             </para>
3047           </listitem>
3048         </varlistentry>
3049         <varlistentry>
3050           <term>Reboot</term>
3051           <listitem>
3052             <para>
3053               This reboots the device. Use this to
3054               switch from idle to pad mode by rebooting once the rocket is
3055               oriented for flight, or to confirm changes you think you saved 
3056               are really saved.
3057             </para>
3058           </listitem>
3059         </varlistentry>
3060         <varlistentry>
3061           <term>Close</term>
3062           <listitem>
3063             <para>
3064               This closes the dialog. Any unsaved changes will be
3065               lost.
3066             </para>
3067           </listitem>
3068         </varlistentry>
3069       </variablelist>
3070       <para>
3071         The rest of the dialog contains the parameters to be configured.
3072       </para>
3073       <section>
3074         <title>Main Deploy Altitude</title>
3075         <para>
3076           This sets the altitude (above the recorded pad altitude) at
3077           which the 'main' igniter will fire. The drop-down menu shows
3078           some common values, but you can edit the text directly and
3079           choose whatever you like. If the apogee charge fires below
3080           this altitude, then the main charge will fire two seconds
3081           after the apogee charge fires.
3082         </para>
3083       </section>
3084       <section>
3085         <title>Apogee Delay</title>
3086         <para>
3087           When flying redundant electronics, it's often important to
3088           ensure that multiple apogee charges don't fire at precisely
3089           the same time, as that can over pressurize the apogee deployment
3090           bay and cause a structural failure of the air-frame. The Apogee
3091           Delay parameter tells the flight computer to fire the apogee
3092           charge a certain number of seconds after apogee has been
3093           detected.
3094         </para>
3095       </section>
3096       <section>
3097         <title>Apogee Lockoug</title>
3098         <para>
3099           Apogee lockout is the number of seconds after boost where
3100           the flight computer will not fire the apogee charge, even if
3101           the rocket appears to be at apogee. This is often called
3102           'Mach Delay', as it is intended to prevent a flight computer
3103           from unintentionally firing apogee charges due to the pressure
3104           spike that occurrs across a mach transition. Altus Metrum
3105           flight computers include a Kalman filter which is not fooled
3106           by this sharp pressure increase, and so this setting should
3107           be left at the default value of zero to disable it.
3108         </para>
3109       </section>
3110       <section>
3111         <title>Frequency</title>
3112         <para>
3113           This configures which of the frequencies to use for both
3114           telemetry and packet command mode. Note that if you set this
3115           value via packet command mode, the TeleDongle frequency will
3116           also be automatically reconfigured to match so that
3117           communication will continue afterwards.
3118         </para>
3119       </section>
3120       <section>
3121         <title>RF Calibration</title>
3122         <para>
3123           The radios in every Altus Metrum device are calibrated at the
3124           factory to ensure that they transmit and receive on the
3125           specified frequency.  If you need to you can adjust the calibration 
3126           by changing this value.  Do not do this without understanding what
3127           the value means, read the appendix on calibration and/or the source
3128           code for more information.  To change a TeleDongle's calibration, 
3129           you must reprogram the unit completely.
3130         </para>
3131       </section>
3132       <section>
3133         <title>Telemetry/RDF/APRS Enable</title>
3134         <para>
3135           Enables the radio for transmission during flight. When
3136           disabled, the radio will not transmit anything during flight
3137           at all.
3138         </para>
3139       </section>
3140       <section>
3141         <title>APRS Interval</title>
3142         <para>
3143           How often to transmit GPS information via APRS (in
3144           seconds). When set to zero, APRS transmission is
3145           disabled. This option is available on TeleMetrum v2 and
3146           TeleMega boards. TeleMetrum v1 boards cannot transmit APRS
3147           packets. Note that a single APRS packet takes nearly a full
3148           second to transmit, so enabling this option will prevent
3149           sending any other telemetry during that time.
3150         </para>
3151       </section>
3152       <section>
3153         <title>Callsign</title>
3154         <para>
3155           This sets the call sign included in each telemetry packet. Set this
3156           as needed to conform to your local radio regulations.
3157         </para>
3158       </section>
3159       <section>
3160         <title>Maximum Flight Log Size</title>
3161         <para>
3162           This sets the space (in kilobytes) allocated for each flight
3163           log. The available space will be divided into chunks of this
3164           size. A smaller value will allow more flights to be stored,
3165           a larger value will record data from longer flights.
3166         </para>
3167       </section>
3168       <section>
3169         <title>Ignitor Firing Mode</title>
3170         <para>
3171           This configuration parameter allows the two standard ignitor
3172           channels (Apogee and Main) to be used in different
3173           configurations.
3174         </para>
3175           <variablelist>
3176             <varlistentry>
3177               <term>Dual Deploy</term>
3178               <listitem>
3179                 <para>
3180                   This is the usual mode of operation; the
3181                   'apogee' channel is fired at apogee and the 'main'
3182                   channel at the height above ground specified by the
3183                   'Main Deploy Altitude' during descent.
3184                 </para>
3185               </listitem>
3186             </varlistentry>
3187             <varlistentry>
3188               <term>Redundant Apogee</term>
3189               <listitem>
3190                 <para>
3191                   This fires both channels at
3192                   apogee, the 'apogee' channel first followed after a two second
3193                   delay by the 'main' channel.
3194                 </para>
3195               </listitem>
3196             </varlistentry>
3197             <varlistentry>
3198               <term>Redundant Main</term>
3199               <listitem>
3200                 <para>
3201                   This fires both channels at the
3202                   height above ground specified by the Main Deploy
3203                   Altitude setting during descent. The 'apogee'
3204                   channel is fired first, followed after a two second
3205                   delay by the 'main' channel.
3206                 </para>
3207               </listitem>
3208             </varlistentry>
3209         </variablelist>
3210       </section>
3211       <section>
3212         <title>Pad Orientation</title>
3213         <para>
3214           Because they include accelerometers, TeleMetrum and
3215           TeleMega are sensitive to the orientation of the board. By
3216           default, they expect the antenna end to point forward. This
3217           parameter allows that default to be changed, permitting the
3218           board to be mounted with the antenna pointing aft instead.
3219         </para>
3220         <variablelist>
3221           <varlistentry>
3222             <term>Antenna Up</term>
3223             <listitem>
3224               <para>
3225                 In this mode, the antenna end of the
3226                 flight computer must point forward, in line with the
3227                 expected flight path.
3228               </para>
3229             </listitem>
3230           </varlistentry>
3231           <varlistentry>
3232             <term>Antenna Down</term>
3233             <listitem>
3234               <para>
3235                 In this mode, the antenna end of the
3236                 flight computer must point aft, in line with the
3237                 expected flight path.
3238               </para>
3239             </listitem>
3240           </varlistentry>
3241         </variablelist>
3242       </section>
3243       <section>
3244         <title>Beeper Frequency</title>
3245         <para>
3246           The beeper on all Altus Metrum flight computers works best
3247           at 4000Hz, however if you have more than one flight computer
3248           in a single airframe, having all of them sound at the same
3249           frequency can be confusing. This parameter lets you adjust
3250           the base beeper frequency value.
3251         </para>
3252       </section>
3253       <section>
3254         <title>Configure Pyro Channels</title>
3255         <informalfigure>
3256           <mediaobject>
3257             <imageobject>
3258               <imagedata fileref="configure-pyro.png" width="6in" scalefit="1"/>
3259             </imageobject>
3260           </mediaobject>
3261         </informalfigure>
3262         <para>
3263           This opens a separate window to configure the additional
3264           pyro channels available on TeleMega.  One column is
3265           presented for each channel. Each row represents a single
3266           parameter, if enabled the parameter must meet the specified
3267           test for the pyro channel to be fired. See the Pyro Channels
3268           section in the System Operation chapter above for a
3269           description of these parameters.
3270         </para>
3271         <para>
3272           Select conditions and set the related value; the pyro
3273           channel will be activated when <emphasis>all</emphasis> of the
3274           conditions are met. Each pyro channel has a separate set of
3275           configuration values, so you can use different values for
3276           the same condition with different channels.
3277         </para>
3278         <para>
3279           At the bottom of the window, the 'Pyro Firing Time'
3280           configuration sets the length of time (in seconds) which
3281           each of these pyro channels will fire for.
3282         </para>
3283         <para>
3284           Once you have selected the appropriate configuration for all
3285           of the necessary pyro channels, you can save the pyro
3286           configuration along with the rest of the flight computer
3287           configuration by pressing the 'Save' button in the main
3288           Configure Flight Computer window.
3289         </para>
3290       </section>
3291     </section>
3292     <section>
3293       <title>Configure AltosUI</title>
3294       <informalfigure>
3295         <mediaobject>
3296           <imageobject>
3297             <imagedata fileref="configure-altosui.png" width="2.4in" scalefit="1"/>
3298           </imageobject>
3299         </mediaobject>
3300       </informalfigure>
3301       <para>
3302         This button presents a dialog so that you can configure the AltosUI global settings.
3303       </para>
3304       <section>
3305         <title>Voice Settings</title>
3306         <para>
3307           AltosUI provides voice announcements during flight so that you
3308           can keep your eyes on the sky and still get information about
3309           the current flight status. However, sometimes you don't want
3310           to hear them.
3311         </para>
3312         <variablelist>
3313           <varlistentry>
3314             <term>Enable</term>
3315             <listitem>
3316               <para>Turns all voice announcements on and off</para>
3317             </listitem>
3318           </varlistentry>
3319           <varlistentry>
3320             <term>Test Voice</term>
3321             <listitem>
3322               <para>
3323                 Plays a short message allowing you to verify
3324                 that the audio system is working and the volume settings
3325                 are reasonable
3326               </para>
3327             </listitem>
3328           </varlistentry>
3329         </variablelist>
3330       </section>
3331       <section>
3332         <title>Log Directory</title>
3333         <para>
3334           AltosUI logs all telemetry data and saves all TeleMetrum flash
3335           data to this directory. This directory is also used as the
3336           staring point when selecting data files for display or export.
3337         </para>
3338         <para>
3339           Click on the directory name to bring up a directory choosing
3340           dialog, select a new directory and click 'Select Directory' to
3341           change where AltosUI reads and writes data files.
3342         </para>
3343       </section>
3344       <section>
3345         <title>Callsign</title>
3346         <para>
3347           This value is transmitted in each command packet sent from 
3348           TeleDongle and received from an altimeter.  It is not used in 
3349           telemetry mode, as the callsign configured in the altimeter board
3350           is included in all telemetry packets.  Configure this
3351           with the AltosUI operators call sign as needed to comply with
3352           your local radio regulations.
3353         </para>
3354         <para>
3355           Note that to successfully command a flight computer over the radio
3356           (to configure the altimeter, monitor idle, or fire pyro charges), 
3357           the callsign configured here must exactly match the callsign
3358           configured in the flight computer.  This matching is case 
3359           sensitive.
3360         </para>
3361       </section>
3362       <section>
3363         <title>Imperial Units</title>
3364         <para>
3365           This switches between metric units (meters) and imperial
3366           units (feet and miles). This affects the display of values
3367           use during flight monitoring, configuration, data graphing
3368           and all of the voice announcements. It does not change the
3369           units used when exporting to CSV files, those are always
3370           produced in metric units.
3371         </para>
3372       </section>
3373       <section>
3374         <title>Font Size</title>
3375         <para>
3376           Selects the set of fonts used in the flight monitor
3377           window. Choose between the small, medium and large sets.
3378         </para>
3379       </section>
3380       <section>
3381         <title>Serial Debug</title>
3382         <para>
3383           This causes all communication with a connected device to be
3384           dumped to the console from which AltosUI was started. If
3385           you've started it from an icon or menu entry, the output
3386           will simply be discarded. This mode can be useful to debug
3387           various serial communication issues.
3388         </para>
3389       </section>
3390       <section>
3391         <title>Manage Frequencies</title>
3392         <para>
3393           This brings up a dialog where you can configure the set of
3394           frequencies shown in the various frequency menus. You can
3395           add as many as you like, or even reconfigure the default
3396           set. Changing this list does not affect the frequency
3397           settings of any devices, it only changes the set of
3398           frequencies shown in the menus.
3399         </para>
3400       </section>
3401     </section>
3402     <section>
3403       <title>Configure Groundstation</title>
3404       <informalfigure>
3405         <mediaobject>
3406           <imageobject>
3407             <imagedata fileref="configure-groundstation.png" width="3.1in" scalefit="1"/>
3408           </imageobject>
3409         </mediaobject>
3410       </informalfigure>
3411       <para>
3412         Select this button and then select a TeleDongle Device from the list provided.
3413       </para>
3414       <para>
3415         The first few lines of the dialog provide information about the
3416         connected device, including the product name,
3417         software version and hardware serial number. Below that are the
3418         individual configuration entries.
3419       </para>
3420       <para>
3421         Note that the TeleDongle itself doesn't save any configuration
3422         data, the settings here are recorded on the local machine in
3423         the Java preferences database. Moving the TeleDongle to
3424         another machine, or using a different user account on the same
3425         machine will cause settings made here to have no effect.
3426       </para>
3427       <para>
3428         At the bottom of the dialog, there are three buttons:
3429       </para>
3430       <variablelist>
3431         <varlistentry>
3432           <term>Save</term>
3433           <listitem>
3434             <para>
3435               This writes any changes to the
3436               local Java preferences file. If you don't
3437               press this button, any changes you make will be lost.
3438             </para>
3439           </listitem>
3440         </varlistentry>
3441         <varlistentry>
3442           <term>Reset</term>
3443           <listitem>
3444             <para>
3445               This resets the dialog to the most recently saved values,
3446               erasing any changes you have made.
3447             </para>
3448           </listitem>
3449         </varlistentry>
3450         <varlistentry>
3451           <term>Close</term>
3452           <listitem>
3453             <para>
3454               This closes the dialog. Any unsaved changes will be
3455               lost.
3456             </para>
3457           </listitem>
3458         </varlistentry>
3459       </variablelist>
3460       <para>
3461         The rest of the dialog contains the parameters to be configured.
3462       </para>
3463       <section>
3464         <title>Frequency</title>
3465         <para>
3466           This configures the frequency to use for both telemetry and
3467           packet command mode. Set this before starting any operation
3468           involving packet command mode so that it will use the right
3469           frequency. Telemetry monitoring mode also provides a menu to
3470           change the frequency, and that menu also sets the same Java
3471           preference value used here.
3472         </para>
3473       </section>
3474       <section>
3475         <title>Radio Calibration</title>
3476         <para>
3477           The radios in every Altus Metrum device are calibrated at the
3478           factory to ensure that they transmit and receive on the
3479           specified frequency.  To change a TeleDongle's calibration, 
3480           you must reprogram the unit completely, so this entry simply
3481           shows the current value and doesn't allow any changes.
3482         </para>
3483       </section>
3484     </section>
3485     <section>
3486       <title>Flash Image</title>
3487       <para>
3488         This reprograms Altus Metrum devices with new
3489         firmware. TeleMetrum v1.x, TeleDongle, TeleMini and TeleBT are
3490         all reprogrammed by using another similar unit as a
3491         programming dongle (pair programming). TeleMega, TeleMetrum v2
3492         and EasyMini are all programmed directly over their USB ports
3493         (self programming).  Please read the directions for flashing
3494         devices in the Updating Device Firmware chapter below.
3495       </para>
3496     </section>
3497     <section>
3498       <title>Fire Igniter</title>
3499       <informalfigure>
3500         <mediaobject>
3501           <imageobject>
3502             <imagedata fileref="fire-igniter.png" width="1.2in" scalefit="1"/>
3503           </imageobject>
3504         </mediaobject>
3505       </informalfigure>
3506       <para>
3507         This activates the igniter circuits in the flight computer to help 
3508         test recovery systems deployment. Because this command can operate
3509         over the Packet Command Link, you can prepare the rocket as
3510         for flight and then test the recovery system without needing
3511         to snake wires inside the air-frame.
3512       </para>
3513       <para>
3514         Selecting the 'Fire Igniter' button brings up the usual device
3515         selection dialog. Pick the desired device. This brings up another 
3516         window which shows the current continuity test status for all
3517         of the pyro channels.
3518       </para>
3519       <para>
3520         Next, select the desired igniter to fire. This will enable the
3521         'Arm' button.
3522       </para>
3523       <para>
3524         Select the 'Arm' button. This enables the 'Fire' button. The
3525         word 'Arm' is replaced by a countdown timer indicating that
3526         you have 10 seconds to press the 'Fire' button or the system
3527         will deactivate, at which point you start over again at
3528         selecting the desired igniter.
3529       </para>
3530     </section>
3531     <section>
3532       <title>Scan Channels</title>
3533       <informalfigure>
3534         <mediaobject>
3535           <imageobject>
3536             <imagedata fileref="scan-channels.png" width="3.2in" scalefit="1"/>
3537           </imageobject>
3538         </mediaobject>
3539       </informalfigure>
3540       <para>
3541         This listens for telemetry packets on all of the configured
3542         frequencies, displaying information about each device it
3543         receives a packet from. You can select which of the three
3544         telemetry formats should be tried; by default, it only listens
3545         for the standard telemetry packets used in v1.0 and later
3546         firmware.
3547       </para>
3548     </section>
3549     <section>
3550       <title>Load Maps</title>
3551       <informalfigure>
3552         <mediaobject>
3553           <imageobject>
3554             <imagedata fileref="load-maps.png" width="5.2in" scalefit="1"/>
3555           </imageobject>
3556         </mediaobject>
3557       </informalfigure>
3558       <para>
3559         Before heading out to a new launch site, you can use this to
3560         load satellite images in case you don't have internet
3561         connectivity at the site. This loads a fairly large area
3562         around the launch site, which should cover any flight you're likely to make.
3563       </para>
3564       <para>
3565         There's a drop-down menu of launch sites we know about; if
3566         your favorites aren't there, please let us know the lat/lon
3567         and name of the site. The contents of this list are actually
3568         downloaded from our server at run-time, so as new sites are sent 
3569         in, they'll get automatically added to this list.
3570         If the launch site isn't in the list, you can manually enter the lat/lon values
3571       </para>
3572       <para>
3573         There are four different kinds of maps you can view; you can
3574         select which to download by selecting as many as you like from
3575         the available types:
3576         <variablelist>
3577           <varlistentry>
3578             <term>Hybrid</term>
3579             <listitem>
3580               <para>
3581                 A combination of satellite imagery and road data. This
3582                 is the default view.
3583               </para>
3584             </listitem>
3585           </varlistentry>
3586           <varlistentry>
3587             <term>Satellite</term>
3588             <listitem>
3589               <para>
3590                 Just the satellite imagery without any annotation.
3591               </para>
3592             </listitem>
3593           </varlistentry>
3594           <varlistentry>
3595             <term>Roadmap</term>
3596             <listitem>
3597               <para>
3598                 Roads, political boundaries and a few geographic features.
3599               </para>
3600             </listitem>
3601           </varlistentry>
3602           <varlistentry>
3603             <term>Terrain</term>
3604             <listitem>
3605               <para>
3606                 Contour intervals and shading that show hills and
3607                 valleys.
3608               </para>
3609             </listitem>
3610           </varlistentry>
3611         </variablelist>
3612       </para>
3613       <para>
3614         You can specify the range of zoom levels to download; smaller
3615         numbers show more area with less resolution. The default
3616         level, 0, shows about 3m/pixel. One zoom level change
3617         doubles or halves that number.
3618       </para>
3619       <para>
3620         The Tile Radius value sets how large an area around the center
3621         point to download. Each tile is 512x512 pixels, and the
3622         'radius' value specifies how many tiles away from the center
3623         will be downloaded. Specify a radius of 0 and you get only the
3624         center tile. A radius of 1 loads a 3x3 grid, centered on the
3625         specified location.
3626       </para>
3627       <para>
3628         Clicking the 'Load Map' button will fetch images from Google
3629         Maps; note that Google limits how many images you can fetch at
3630         once, so if you load more than one launch site, you may get
3631         some gray areas in the map which indicate that Google is tired
3632         of sending data to you. Try again later.
3633       </para>
3634     </section>
3635     <section>
3636       <title>Monitor Idle</title>
3637       <para>
3638         This brings up a dialog similar to the Monitor Flight UI,
3639         except it works with the altimeter in “idle” mode by sending
3640         query commands to discover the current state rather than
3641         listening for telemetry packets. Because this uses command
3642         mode, it needs to have the TeleDongle and flight computer
3643         callsigns match exactly. If you can receive telemetry, but
3644         cannot manage to run Monitor Idle, then it's very likely that
3645         your callsigns are different in some way.
3646       </para>
3647     </section>
3648   </chapter>
3649   <chapter>
3650     <title>AltosDroid</title>
3651     <para>
3652       AltosDroid provides the same flight monitoring capabilities as
3653       AltosUI, but runs on Android devices and is designed to connect
3654       to a TeleBT receiver over Bluetooth™. AltosDroid monitors
3655       telemetry data, logging it to internal storage in the Android
3656       device, and presents that data in a UI the same way the 'Monitor
3657       Flight' window does in AltosUI.
3658     </para>
3659     <para>
3660       This manual will explain how to configure AltosDroid, connect
3661       to TeleBT, operate the flight monitoring interface and describe
3662       what the displayed data means.
3663     </para>
3664     <section>
3665       <title>Installing AltosDroid</title>
3666       <para>
3667         AltosDroid is available from the Google Play store. To install
3668         it on your Android device, open the Google Play Store
3669         application and search for “altosdroid”. Make sure you don't
3670         have a space between “altos” and “droid” or you probably won't
3671         find what you want. That should bring you to the right page
3672         from which you can download and install the application.
3673       </para>
3674     </section>
3675     <section>
3676       <title>Connecting to TeleBT</title>
3677       <para>
3678         Press the Android 'Menu' button or soft-key to see the
3679         configuration options available. Select the 'Connect a device'
3680         option and then the 'Scan for devices' entry at the bottom to
3681         look for your TeleBT device. Select your device, and when it
3682         asks for the code, enter '1234'.
3683       </para>
3684       <para>
3685         Subsequent connections will not require you to enter that
3686         code, and your 'paired' device will appear in the list without
3687         scanning.
3688       </para>
3689     </section>
3690     <section>
3691       <title>Configuring AltosDroid</title>
3692       <para>
3693         The only configuration option available for AltosDroid is
3694         which frequency to listen on. Press the Android 'Menu' button
3695         or soft-key and pick the 'Select radio frequency' entry. That
3696         brings up a menu of pre-set radio frequencies; pick the one
3697         which matches your altimeter.
3698       </para>
3699     </section>
3700     <section>
3701       <title>AltosDroid Flight Monitoring</title>
3702       <para>
3703         AltosDroid is designed to mimic the AltosUI flight monitoring
3704         display, providing separate tabs for each stage of your rocket
3705         flight along with a tab containing a map of the local area
3706         with icons marking the current location of the altimeter and
3707         the Android device.
3708       </para>
3709       <section>
3710         <title>Pad</title>
3711         <para>
3712           The 'Launch Pad' tab shows information used to decide when the
3713           rocket is ready for flight. The first elements include red/green
3714           indicators, if any of these is red, you'll want to evaluate
3715           whether the rocket is ready to launch:
3716           <variablelist>
3717             <varlistentry>
3718               <term>Battery Voltage</term>
3719               <listitem>
3720                 <para>
3721                   This indicates whether the Li-Po battery
3722                   powering the TeleMetrum has sufficient charge to last for
3723                   the duration of the flight. A value of more than
3724                   3.8V is required for a 'GO' status.
3725                 </para>
3726               </listitem>
3727             </varlistentry>
3728             <varlistentry>
3729               <term>Apogee Igniter Voltage</term>
3730               <listitem>
3731                 <para>
3732                   This indicates whether the apogee
3733                   igniter has continuity. If the igniter has a low
3734                   resistance, then the voltage measured here will be close
3735                   to the Li-Po battery voltage. A value greater than 3.2V is
3736                   required for a 'GO' status.
3737                 </para>
3738               </listitem>
3739             </varlistentry>
3740             <varlistentry>
3741               <term>Main Igniter Voltage</term>
3742               <listitem>
3743                 <para>
3744                   This indicates whether the main
3745                   igniter has continuity. If the igniter has a low
3746                   resistance, then the voltage measured here will be close
3747                   to the Li-Po battery voltage. A value greater than 3.2V is
3748                   required for a 'GO' status.
3749                 </para>
3750               </listitem>
3751             </varlistentry>
3752             <varlistentry>
3753               <term>On-board Data Logging</term>
3754               <listitem>
3755                 <para>
3756                   This indicates whether there is
3757                   space remaining on-board to store flight data for the
3758                   upcoming flight. If you've downloaded data, but failed
3759                   to erase flights, there may not be any space
3760                   left. TeleMetrum can store multiple flights, depending
3761                   on the configured maximum flight log size. TeleMini
3762                   stores only a single flight, so it will need to be
3763                   downloaded and erased after each flight to capture
3764                   data. This only affects on-board flight logging; the
3765                   altimeter will still transmit telemetry and fire
3766                   ejection charges at the proper times.
3767                 </para>
3768               </listitem>
3769             </varlistentry>
3770             <varlistentry>
3771               <term>GPS Locked</term>
3772               <listitem>
3773                 <para>
3774                   For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is
3775                   currently able to compute position information. GPS requires
3776                   at least 4 satellites to compute an accurate position.
3777                 </para>
3778               </listitem>
3779             </varlistentry>
3780             <varlistentry>
3781               <term>GPS Ready</term>
3782               <listitem>
3783                 <para>
3784                   For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least
3785                   10 consecutive positions without losing lock. This ensures
3786                   that the GPS receiver has reliable reception from the
3787                   satellites.
3788                 </para>
3789               </listitem>
3790             </varlistentry>
3791           </variablelist>
3792         </para>
3793         <para>
3794           The Launchpad tab also shows the computed launch pad position
3795           and altitude, averaging many reported positions to improve the
3796           accuracy of the fix.
3797         </para>
3798       </section>
3799     </section>
3800     <section>
3801       <title>Downloading Flight Logs</title>
3802       <para>
3803         AltosDroid always saves every bit of telemetry data it
3804         receives. To download that to a computer for use with AltosUI,
3805         simply remove the SD card from your Android device, or connect
3806         your device to your computer's USB port and browse the files
3807         on that device. You will find '.telem' files in the TeleMetrum
3808         directory that will work with AltosUI directly.
3809       </para>
3810     </section>
3811   </chapter>
3812   <chapter>
3813     <title>Using Altus Metrum Products</title>
3814     <section>
3815       <title>Being Legal</title>
3816       <para>
3817         First off, in the US, you need an <ulink url="http://www.altusmetrum.org/Radio/">amateur radio license</ulink> or
3818         other authorization to legally operate the radio transmitters that are part
3819         of our products.
3820       </para>
3821       </section>
3822       <section>
3823         <title>In the Rocket</title>
3824         <para>
3825           In the rocket itself, you just need a flight computer and
3826           a single-cell, 3.7 volt nominal Li-Po rechargeable battery.  An 
3827           850mAh battery weighs less than a 9V alkaline battery, and will 
3828           run a TeleMetrum or TeleMega for hours.
3829           A 110mAh battery weighs less than a triple A battery and is a good
3830           choice for use with TeleMini.
3831         </para>
3832         <para>
3833           By default, we ship flight computers with a simple wire antenna.  
3834           If your electronics bay or the air-frame it resides within is made 
3835           of carbon fiber, which is opaque to RF signals, you may prefer to 
3836           install an SMA connector so that you can run a coaxial cable to an 
3837           antenna mounted elsewhere in the rocket.  However, note that the 
3838           GPS antenna is fixed on all current products, so you really want
3839           to install the flight computer in a bay made of RF-transparent
3840           materials if at all possible.
3841         </para>
3842       </section>
3843       <section>
3844         <title>On the Ground</title>
3845         <para>
3846           To receive the data stream from the rocket, you need an antenna and short
3847           feed-line connected to one of our <ulink url="http://www.altusmetrum.org/TeleDongle/">TeleDongle</ulink> units.  If possible, use an SMA to BNC 
3848         adapter instead of feedline between the antenna feedpoint and 
3849         TeleDongle, as this will give you the best performance.  The
3850           TeleDongle in turn plugs directly into the USB port on a notebook
3851           computer.  Because TeleDongle looks like a simple serial port, your computer
3852           does not require special device drivers... just plug it in.
3853         </para>
3854         <para>
3855           The GUI tool, AltosUI, is written in Java and runs across
3856           Linux, Mac OS and Windows. There's also a suite of C tools
3857           for Linux which can perform most of the same tasks.
3858         </para>
3859         <para>
3860           Alternatively, a TeleBT attached with an SMA to BNC adapter at the
3861           feed point of a hand-held yagi used in conjunction with an Android
3862           device running AltosDroid makes an outstanding ground station.
3863         </para>
3864         <para>
3865           After the flight, you can use the radio link to extract the more detailed data
3866           logged in either TeleMetrum or TeleMini devices, or you can use a mini USB cable to plug into the
3867           TeleMetrum board directly.  Pulling out the data without having to open up
3868           the rocket is pretty cool!  A USB cable is also how you charge the Li-Po
3869           battery, so you'll want one of those anyway... the same cable used by lots
3870           of digital cameras and other modern electronic stuff will work fine.
3871         </para>
3872         <para>
3873           If your rocket lands out of sight, you may enjoy having a hand-held 
3874           GPS receiver, so that you can put in a way-point for the last 
3875           reported rocket position before touch-down.  This makes looking for 
3876           your rocket a lot like Geo-Caching... just go to the way-point and 
3877           look around starting from there.  AltosDroid on an Android device
3878           with GPS receiver works great for this, too!
3879         </para>
3880         <para>
3881           You may also enjoy having a ham radio “HT” that covers the 70cm band... you
3882           can use that with your antenna to direction-find the rocket on the ground
3883           the same way you can use a Walston or Beeline tracker.  This can be handy
3884           if the rocket is hiding in sage brush or a tree, or if the last GPS position
3885           doesn't get you close enough because the rocket dropped into a canyon, or
3886           the wind is blowing it across a dry lake bed, or something like that...  Keith
3887           currently uses a Yaesu VX-7R, Bdale has a Baofung UV-5R
3888           which isn't as nice, but was a whole lot cheaper.
3889         </para>
3890         <para>
3891           So, to recap, on the ground the hardware you'll need includes:
3892           <orderedlist inheritnum='inherit' numeration='arabic'>
3893             <listitem>
3894               <para>
3895               an antenna and feed-line or adapter
3896               </para>
3897             </listitem>
3898             <listitem>
3899               <para>
3900               a TeleDongle
3901               </para>
3902             </listitem>
3903             <listitem>
3904               <para>
3905               a notebook computer
3906               </para>
3907             </listitem>
3908             <listitem>
3909               <para>
3910               optionally, a hand-held GPS receiver
3911               </para>
3912             </listitem>
3913             <listitem>
3914               <para>
3915               optionally, an HT or receiver covering 435 MHz
3916               </para>
3917             </listitem>
3918           </orderedlist>
3919         </para>
3920         <para>
3921           The best hand-held commercial directional antennas we've found for radio
3922           direction finding rockets are from
3923           <ulink url="http://www.arrowantennas.com/" >
3924             Arrow Antennas.
3925           </ulink>
3926           The 440-3 and 440-5 are both good choices for finding a
3927           TeleMetrum- or TeleMini- equipped rocket when used with a suitable 
3928           70cm HT.  TeleDongle and an SMA to BNC adapter fit perfectly
3929           between the driven element and reflector of Arrow antennas.
3930         </para>
3931       </section>
3932       <section>
3933         <title>Data Analysis</title>
3934         <para>
3935           Our software makes it easy to log the data from each flight, both the
3936           telemetry received during the flight itself, and the more
3937           complete data log recorded in the flash memory on the altimeter
3938           board.  Once this data is on your computer, our post-flight tools make it
3939           easy to quickly get to the numbers everyone wants, like apogee altitude,
3940           max acceleration, and max velocity.  You can also generate and view a
3941           standard set of plots showing the altitude, acceleration, and
3942           velocity of the rocket during flight.  And you can even export a TeleMetrum data file
3943           usable with Google Maps and Google Earth for visualizing the flight path
3944           in two or three dimensions!
3945         </para>
3946         <para>
3947           Our ultimate goal is to emit a set of files for each flight that can be
3948           published as a web page per flight, or just viewed on your local disk with
3949           a web browser.
3950         </para>
3951       </section>
3952       <section>
3953         <title>Future Plans</title>
3954         <para>
3955           We've designed a simple GPS based radio tracker called TeleGPS.  
3956           If all goes well, we hope to introduce this in the first
3957           half of 2014.
3958         </para>
3959         <para>
3960           We have designed and prototyped several “companion boards” that 
3961           can attach to the companion connector on TeleMetrum and TeleMega
3962           flight computers to collect more data, provide more pyro channels, 
3963           and so forth.  We do not yet know if or when any of these boards
3964           will be produced in enough quantity to sell.  If you have specific
3965           interests for data collection or control of events in your rockets
3966           beyond the capabilities of our existing productions, please let 
3967           us know!
3968         </para>
3969         <para>
3970           Because all of our work is open, both the hardware designs and the 
3971           software, if you have some great idea for an addition to the current 
3972           Altus Metrum family, feel free to dive in and help!  Or let us know 
3973           what you'd like to see that we aren't already working on, and maybe 
3974           we'll get excited about it too...
3975         </para>
3976         <para>
3977           Watch our 
3978           <ulink url="http://altusmetrum.org/">web site</ulink> for more news 
3979           and information as our family of products evolves!
3980         </para>
3981     </section>
3982   </chapter>
3983   <chapter>
3984     <title>Altimeter Installation Recommendations</title>
3985     <para>
3986       Building high-power rockets that fly safely is hard enough. Mix
3987       in some sophisticated electronics and a bunch of radio energy
3988       and some creativity and/or compromise may be required. This chapter
3989       contains some suggestions about how to install Altus Metrum
3990       products into a rocket air-frame, including how to safely and
3991       reliably mix a variety of electronics into the same air-frame.
3992     </para>
3993     <section>
3994       <title>Mounting the Altimeter</title>
3995       <para>
3996         The first consideration is to ensure that the altimeter is
3997         securely fastened to the air-frame. For most of our products, we 
3998         prefer nylon standoffs and nylon screws; they're good to at least 50G
3999         and cannot cause any electrical issues on the board.  Metal screws
4000         and standoffs are fine, too, just be careful to avoid electrical
4001         shorts!  For TeleMini v1.0, we usually cut small pieces of 1/16 inch 
4002         balsa to fit
4003         under the screw holes, and then take 2x56 nylon screws and
4004         screw them through the TeleMini mounting holes, through the
4005         balsa and into the underlying material.
4006       </para>
4007       <orderedlist inheritnum='inherit' numeration='arabic'>
4008         <listitem>
4009           <para>
4010             Make sure accelerometer-equipped products like TeleMetrum and
4011             TeleMega are aligned precisely along the axis of
4012             acceleration so that the accelerometer can accurately
4013             capture data during the flight.
4014           </para>
4015         </listitem>
4016         <listitem>
4017           <para>
4018             Watch for any metal touching components on the
4019             board. Shorting out connections on the bottom of the board
4020             can cause the altimeter to fail during flight.
4021           </para>
4022         </listitem>
4023       </orderedlist>
4024     </section>
4025     <section>
4026       <title>Dealing with the Antenna</title>
4027       <para>
4028         The antenna supplied is just a piece of solid, insulated,
4029         wire. If it gets damaged or broken, it can be easily
4030         replaced. It should be kept straight and not cut; bending or
4031         cutting it will change the resonant frequency and/or
4032         impedance, making it a less efficient radiator and thus
4033         reducing the range of the telemetry signal.
4034       </para>
4035       <para>
4036         Keeping metal away from the antenna will provide better range
4037         and a more even radiation pattern. In most rockets, it's not
4038         entirely possible to isolate the antenna from metal
4039         components; there are often bolts, all-thread and wires from other
4040         electronics to contend with. Just be aware that the more stuff
4041         like this around the antenna, the lower the range.
4042       </para>
4043       <para>
4044         Make sure the antenna is not inside a tube made or covered
4045         with conducting material. Carbon fiber is the most common
4046         culprit here -- CF is a good conductor and will effectively
4047         shield the antenna, dramatically reducing signal strength and
4048         range. Metallic flake paint is another effective shielding
4049         material which should be avoided around any antennas.
4050       </para>
4051       <para>
4052         If the ebay is large enough, it can be convenient to simply
4053         mount the altimeter at one end and stretch the antenna out
4054         inside. Taping the antenna to the sled can keep it straight
4055         under acceleration. If there are metal rods, keep the
4056         antenna as far away as possible.
4057       </para>
4058       <para>
4059         For a shorter ebay, it's quite practical to have the antenna
4060         run through a bulkhead and into an adjacent bay. Drill a small
4061         hole in the bulkhead, pass the antenna wire through it and
4062         then seal it up with glue or clay. We've also used acrylic
4063         tubing to create a cavity for the antenna wire. This works a
4064         bit better in that the antenna is known to stay straight and
4065         not get folded by recovery components in the bay. Angle the
4066         tubing towards the side wall of the rocket and it ends up
4067         consuming very little space.
4068       </para>
4069       <para>
4070         If you need to place the UHF antenna at a distance from the
4071         altimeter, you can replace the antenna with an edge-mounted
4072         SMA connector, and then run 50Ω coax from the board to the
4073         antenna. Building a remote antenna is beyond the scope of this
4074         manual.
4075       </para>
4076     </section>
4077     <section>
4078       <title>Preserving GPS Reception</title>
4079       <para>
4080         The GPS antenna and receiver used in TeleMetrum and TeleMega is 
4081         highly sensitive and normally have no trouble tracking enough
4082         satellites to provide accurate position information for
4083         recovering the rocket. However, there are many ways the GPS signal
4084         can end up attenuated, negatively affecting GPS performance. 
4085       <orderedlist inheritnum='inherit' numeration='arabic'>
4086         <listitem>
4087           <para>
4088             Conductive tubing or coatings. Carbon fiber and metal
4089             tubing, or metallic paint will all dramatically attenuate the
4090             GPS signal. We've never heard of anyone successfully
4091             receiving GPS from inside these materials.
4092           </para>
4093         </listitem>
4094         <listitem>
4095           <para>
4096             Metal components near the GPS patch antenna. These will
4097             de-tune the patch antenna, changing the resonant frequency
4098             away from the L1 carrier and reduce the effectiveness of the
4099             antenna. You can place as much stuff as you like beneath the
4100             antenna as that's covered with a ground plane. But, keep
4101             wires and metal out from above the patch antenna.
4102           </para>
4103         </listitem>
4104       </orderedlist>
4105       </para>
4106     </section>
4107     <section>
4108       <title>Radio Frequency Interference</title>
4109       <para>
4110         Any altimeter will generate RFI; the digital circuits use
4111         high-frequency clocks that spray radio interference across a
4112         wide band. Altus Metrum altimeters generate intentional radio
4113         signals as well, increasing the amount of RF energy around the board.
4114       </para>
4115       <para>
4116         Rocketry altimeters also use precise sensors measuring air
4117         pressure and acceleration. Tiny changes in voltage can cause
4118         these sensor readings to vary by a huge amount. When the
4119         sensors start mis-reporting data, the altimeter can either
4120         fire the igniters at the wrong time, or not fire them at all.
4121       </para>
4122       <para>
4123         Voltages are induced when radio frequency energy is
4124         transmitted from one circuit to another. Here are things that
4125         influence the induced voltage and current:
4126       </para>
4127       <itemizedlist>
4128         <listitem>
4129           <para>
4130             Keep wires from different circuits apart. Moving circuits
4131             further apart will reduce RFI.
4132           </para>
4133         </listitem>
4134         <listitem>
4135           <para>
4136           Avoid parallel wires from different circuits. The longer two
4137           wires run parallel to one another, the larger the amount of
4138           transferred energy. Cross wires at right angles to reduce
4139           RFI.
4140           </para>
4141         </listitem>
4142         <listitem>
4143           <para>
4144           Twist wires from the same circuits. Two wires the same
4145           distance from the transmitter will get the same amount of
4146           induced energy which will then cancel out. Any time you have
4147           a wire pair running together, twist the pair together to
4148           even out distances and reduce RFI. For altimeters, this
4149           includes battery leads, switch hookups and igniter
4150           circuits.
4151           </para>
4152         </listitem>
4153         <listitem>
4154           <para>
4155           Avoid resonant lengths. Know what frequencies are present
4156           in the environment and avoid having wire lengths near a
4157           natural resonant length. Altus Metrum products transmit on the
4158           70cm amateur band, so you should avoid lengths that are a
4159           simple ratio of that length; essentially any multiple of ¼
4160           of the wavelength (17.5cm).
4161           </para>
4162         </listitem>
4163       </itemizedlist>
4164     </section>
4165     <section>
4166       <title>The Barometric Sensor</title>
4167       <para>
4168         Altusmetrum altimeters measure altitude with a barometric
4169         sensor, essentially measuring the amount of air above the
4170         rocket to figure out how high it is. A large number of
4171         measurements are taken as the altimeter initializes itself to
4172         figure out the pad altitude. Subsequent measurements are then
4173         used to compute the height above the pad.
4174       </para>
4175       <para>
4176         To accurately measure atmospheric pressure, the ebay
4177         containing the altimeter must be vented outside the
4178         air-frame. The vent must be placed in a region of linear
4179         airflow, have smooth edges, and away from areas of increasing or 
4180         decreasing pressure.
4181       </para>
4182       <para>
4183         All barometric sensors are quite sensitive to chemical damage from 
4184         the products of APCP or BP combustion, so make sure the ebay is 
4185         carefully sealed from any compartment which contains ejection 
4186         charges or motors.
4187       </para>
4188     </section>
4189     <section>
4190       <title>Ground Testing</title>
4191       <para>
4192         The most important aspect of any installation is careful
4193         ground testing. Bringing an air-frame up to the LCO table which
4194         hasn't been ground tested can lead to delays or ejection
4195         charges firing on the pad, or, even worse, a recovery system
4196         failure.
4197       </para>
4198       <para>
4199         Do a 'full systems' test that includes wiring up all igniters
4200         without any BP and turning on all of the electronics in flight
4201         mode. This will catch any mistakes in wiring and any residual
4202         RFI issues that might accidentally fire igniters at the wrong
4203         time. Let the air-frame sit for several minutes, checking for
4204         adequate telemetry signal strength and GPS lock.  If any igniters
4205         fire unexpectedly, find and resolve the issue before loading any
4206         BP charges!
4207       </para>
4208       <para>
4209         Ground test the ejection charges. Prepare the rocket for
4210         flight, loading ejection charges and igniters. Completely
4211         assemble the air-frame and then use the 'Fire Igniters'
4212         interface through a TeleDongle to command each charge to
4213         fire. Make sure the charge is sufficient to robustly separate
4214         the air-frame and deploy the recovery system.
4215       </para>
4216     </section>
4217   </chapter>
4218   <chapter>
4219     <title>Updating Device Firmware</title>
4220     <para>
4221       TeleMega, TeleMetrum v2 and EasyMini are all programmed directly
4222       over their USB connectors (self programming). TeleMetrum v1, TeleMini and
4223       TeleDongle are all programmed by using another device as a
4224       programmer (pair programming). It's important to recognize which
4225       kind of devices you have before trying to reprogram them.
4226     </para>
4227     <para>
4228       You may wish to begin by ensuring you have current firmware images.
4229       These are distributed as part of the AltOS software bundle that
4230       also includes the AltosUI ground station program.  Newer ground
4231       station versions typically work fine with older firmware versions,
4232       so you don't need to update your devices just to try out new
4233       software features.  You can always download the most recent
4234       version from <ulink url="http://www.altusmetrum.org/AltOS/"/>.
4235     </para>
4236     <para>
4237       If you need to update the firmware on a TeleDongle, we recommend 
4238       updating the altimeter first, before updating TeleDongle.  However,
4239       note that TeleDongle rarely need to be updated.  Any firmware version
4240       1.0.1 or later will work, version 1.2.1 may have improved receiver
4241       performance slightly.
4242     </para>
4243     <para>
4244       Self-programmable devices (TeleMega, TeleMetrum v2 and EasyMini)
4245       are reprogrammed by connecting them to your computer over USB
4246     </para>
4247     <section>
4248       <title>
4249         Updating TeleMega, TeleMetrum v2 or EasyMini Firmware
4250       </title>
4251       <orderedlist inheritnum='inherit' numeration='arabic'>
4252         <listitem>
4253           <para>
4254             Attach a battery and power switch to the target
4255             device. Power up the device.
4256           </para>
4257         </listitem>
4258         <listitem>
4259           <para>
4260             Using a Micro USB cable, connect the target device to your
4261             computer's USB socket.
4262           </para>
4263         </listitem>
4264         <listitem>
4265           <para>
4266             Run AltosUI, and select 'Flash Image' from the File menu.
4267           </para>
4268         </listitem>
4269         <listitem>
4270           <para>
4271             Select the target device in the Device Selection dialog.
4272           </para>
4273         </listitem>
4274         <listitem>
4275           <para>
4276             Select the image you want to flash to the device, which
4277             should have a name in the form
4278             &lt;product&gt;-v&lt;product-version&gt;-&lt;software-version&gt;.ihx, such
4279             as TeleMega-v1.0-1.3.0.ihx.
4280           </para>
4281         </listitem>
4282         <listitem>
4283           <para>
4284             Make sure the configuration parameters are reasonable
4285             looking. If the serial number and/or RF configuration
4286             values aren't right, you'll need to change them.
4287           </para>
4288         </listitem>
4289         <listitem>
4290           <para>
4291             Hit the 'OK' button and the software should proceed to flash
4292             the device with new firmware, showing a progress bar.
4293           </para>
4294         </listitem>
4295         <listitem>
4296           <para>
4297             Verify that the device is working by using the 'Configure
4298             Altimeter' item to check over the configuration.
4299           </para>
4300         </listitem>
4301       </orderedlist>
4302       <section>
4303         <title>Recovering From Self-Flashing Failure</title>
4304         <para>
4305           If the firmware loading fails, it can leave the device
4306           unable to boot. Not to worry, you can force the device to
4307           start the boot loader instead, which will let you try to
4308           flash the device again.
4309         </para>
4310         <para>
4311           On each device, connecting two pins from one of the exposed
4312           connectors will force the boot loader to start, even if the
4313           regular operating system has been corrupted in some way.
4314         </para>
4315         <variablelist>
4316           <varlistentry>
4317             <term>TeleMega</term>
4318             <listitem>
4319               <para>
4320                 Connect pin 6 and pin 1 of the companion connector. Pin 1
4321                 can be identified by the square pad around it, and then
4322                 the pins could sequentially across the board. Be very
4323                 careful to <emphasis>not</emphasis> short pin 8 to
4324                 anything as that is connected directly to the battery. Pin
4325                 7 carries 3.3V and the board will crash if that is
4326                 connected to pin 1, but shouldn't damage the board.
4327               </para>
4328             </listitem>
4329           </varlistentry>
4330           <varlistentry>
4331             <term>TeleMetrum v2</term>
4332             <listitem>
4333               <para>
4334                 Connect pin 6 and pin 1 of the companion connector. Pin 1
4335                 can be identified by the square pad around it, and then
4336                 the pins could sequentially across the board. Be very
4337                 careful to <emphasis>not</emphasis> short pin 8 to
4338                 anything as that is connected directly to the battery. Pin
4339                 7 carries 3.3V and the board will crash if that is
4340                 connected to pin 1, but shouldn't damage the board.
4341               </para>
4342             </listitem>
4343           </varlistentry>
4344           <varlistentry>
4345             <term>EasyMini</term>
4346             <listitem>
4347               <para>
4348                 Connect pin 6 and pin 1 of the debug connector, which is
4349                 the six holes next to the beeper. Pin 1 can be identified
4350                 by the square pad around it, and then the pins could
4351                 sequentially across the board, making Pin 6 the one on the
4352                 other end of the row.
4353               </para>
4354             </listitem>
4355           </varlistentry>
4356         </variablelist>
4357         <para>
4358           Once you've located the right pins:
4359         </para>
4360         <orderedlist inheritnum='inherit' numeration='arabic'>
4361           <listitem>
4362             <para>
4363               Turn the altimeter power off.
4364             </para>
4365           </listitem>
4366           <listitem>
4367             <para>
4368               Connect a battery.
4369             </para>
4370           </listitem>
4371           <listitem>
4372             <para>
4373               Connect the indicated terminals together with a short
4374               piece of wire. Take care not to accidentally connect
4375               anything else.
4376             </para>
4377           </listitem>
4378           <listitem>
4379             <para>
4380               Connect USB
4381             </para>
4382           </listitem>
4383           <listitem>
4384             <para>
4385               Turn the board power on.
4386             </para>
4387           </listitem>
4388           <listitem>
4389             <para>
4390               The board should now be visible over USB as 'AltosFlash'
4391               and be ready to receive firmware.
4392             </para>
4393           </listitem>
4394           <listitem>
4395             <para>
4396               Once the board has been powered up, you can remove the
4397               piece of wire.
4398             </para>
4399           </listitem>
4400         </orderedlist>
4401       </section>
4402     </section>
4403     <section>
4404       <title>Pair Programming</title>
4405       <para>
4406         The big concept to understand is that you have to use a
4407         TeleMega, TeleMetrum or TeleDongle as a programmer to update a
4408         pair programmed device. Due to limited memory resources in the
4409         cc1111, we don't support programming directly over USB for these
4410         devices.
4411       </para>
4412     </section>
4413     <section>
4414       <title>Updating TeleMetrum v1.x Firmware</title>
4415       <orderedlist inheritnum='inherit' numeration='arabic'>
4416         <listitem>
4417           <para>
4418           Find the 'programming cable' that you got as part of the starter
4419           kit, that has a red 8-pin MicroMaTch connector on one end and a
4420           red 4-pin MicroMaTch connector on the other end.
4421           </para>
4422         </listitem>
4423         <listitem>
4424           <para>
4425           Take the 2 screws out of the TeleDongle case to get access
4426           to the circuit board.
4427           </para>
4428         </listitem>
4429         <listitem>
4430           <para>
4431           Plug the 8-pin end of the programming cable to the
4432           matching connector on the TeleDongle, and the 4-pin end to the
4433           matching connector on the TeleMetrum.
4434           Note that each MicroMaTch connector has an alignment pin that
4435           goes through a hole in the PC board when you have the cable
4436           oriented correctly.
4437           </para>
4438         </listitem>
4439         <listitem>
4440           <para>
4441           Attach a battery to the TeleMetrum board.
4442           </para>
4443         </listitem>
4444         <listitem>
4445           <para>
4446           Plug the TeleDongle into your computer's USB port, and power
4447           up the TeleMetrum.
4448           </para>
4449         </listitem>
4450         <listitem>
4451           <para>
4452           Run AltosUI, and select 'Flash Image' from the File menu.
4453           </para>
4454         </listitem>
4455         <listitem>
4456           <para>
4457           Pick the TeleDongle device from the list, identifying it as the
4458           programming device.
4459           </para>
4460         </listitem>
4461         <listitem>
4462           <para>
4463           Select the image you want put on the TeleMetrum, which should have a
4464           name in the form telemetrum-v1.2-1.0.0.ihx.  It should be visible
4465         in the default directory, if not you may have to poke around
4466         your system to find it.
4467           </para>
4468         </listitem>
4469         <listitem>
4470           <para>
4471           Make sure the configuration parameters are reasonable
4472           looking. If the serial number and/or RF configuration
4473           values aren't right, you'll need to change them.
4474           </para>
4475         </listitem>
4476         <listitem>
4477           <para>
4478           Hit the 'OK' button and the software should proceed to flash
4479           the TeleMetrum with new firmware, showing a progress bar.
4480           </para>
4481         </listitem>
4482         <listitem>
4483           <para>
4484           Confirm that the TeleMetrum board seems to have updated OK, which you
4485           can do by plugging in to it over USB and using a terminal program
4486           to connect to the board and issue the 'v' command to check
4487           the version, etc.
4488           </para>
4489         </listitem>
4490         <listitem>
4491           <para>
4492           If something goes wrong, give it another try.
4493           </para>
4494         </listitem>
4495       </orderedlist>
4496     </section>
4497     <section>
4498       <title>Updating TeleMini Firmware</title>
4499       <orderedlist inheritnum='inherit' numeration='arabic'>
4500         <listitem>
4501 <para>
4502           You'll need a special 'programming cable' to reprogram the
4503           TeleMini.  You can make your own using an 8-pin MicroMaTch 
4504           connector on one end and a set of four pins on the other.
4505         </para>
4506 </listitem>
4507         <listitem>
4508 <para>
4509           Take the 2 screws out of the TeleDongle case to get access
4510           to the circuit board.
4511         </para>
4512 </listitem>
4513         <listitem>
4514 <para>
4515           Plug the 8-pin end of the programming cable to the matching
4516           connector on the TeleDongle, and the 4-pins into the holes
4517           in the TeleMini circuit board.  Note that the MicroMaTch
4518           connector has an alignment pin that goes through a hole in
4519           the PC board when you have the cable oriented correctly, and
4520           that pin 1 on the TeleMini board is marked with a square pad
4521           while the other pins have round pads.
4522         </para>
4523 </listitem>
4524         <listitem>
4525 <para>
4526           Attach a battery to the TeleMini board.
4527         </para>
4528 </listitem>
4529         <listitem>
4530 <para>
4531           Plug the TeleDongle into your computer's USB port, and power
4532           up the TeleMini
4533         </para>
4534 </listitem>
4535         <listitem>
4536 <para>
4537           Run AltosUI, and select 'Flash Image' from the File menu.
4538         </para>
4539 </listitem>
4540         <listitem>
4541 <para>
4542           Pick the TeleDongle device from the list, identifying it as the
4543           programming device.
4544         </para>
4545 </listitem>
4546         <listitem>
4547 <para>
4548           Select the image you want put on the TeleMini, which should have a
4549           name in the form telemini-v1.0-1.0.0.ihx.  It should be visible
4550         in the default directory, if not you may have to poke around
4551         your system to find it.
4552         </para>
4553 </listitem>
4554         <listitem>
4555 <para>
4556           Make sure the configuration parameters are reasonable
4557           looking. If the serial number and/or RF configuration
4558           values aren't right, you'll need to change them.
4559         </para>
4560 </listitem>
4561         <listitem>
4562 <para>
4563           Hit the 'OK' button and the software should proceed to flash
4564           the TeleMini with new firmware, showing a progress bar.
4565         </para>
4566 </listitem>
4567         <listitem>
4568 <para>
4569           Confirm that the TeleMini board seems to have updated OK, which you
4570           can do by configuring it over the radio link through the TeleDongle, or
4571           letting it come up in “flight” mode and listening for telemetry.
4572         </para>
4573 </listitem>
4574         <listitem>
4575 <para>
4576           If something goes wrong, give it another try.
4577         </para>
4578 </listitem>
4579       </orderedlist>
4580     </section>
4581     <section>
4582       <title>Updating TeleDongle Firmware</title>
4583       <para>
4584         Updating TeleDongle's firmware is just like updating TeleMetrum or TeleMini
4585         firmware, but you use either a TeleMetrum or another TeleDongle as the programmer.
4586         </para>
4587       <orderedlist inheritnum='inherit' numeration='arabic'>
4588         <listitem>
4589 <para>
4590           Find the 'programming cable' that you got as part of the starter
4591           kit, that has a red 8-pin MicroMaTch connector on one end and a
4592           red 4-pin MicroMaTch connector on the other end.
4593         </para>
4594 </listitem>
4595         <listitem>
4596 <para>
4597           Find the USB cable that you got as part of the starter kit, and
4598           plug the “mini” end in to the mating connector on TeleMetrum or TeleDongle.
4599         </para>
4600 </listitem>
4601         <listitem>
4602 <para>
4603           Take the 2 screws out of the TeleDongle case to get access
4604           to the circuit board.
4605         </para>
4606 </listitem>
4607         <listitem>
4608 <para>
4609           Plug the 8-pin end of the programming cable to the
4610           matching connector on the programmer, and the 4-pin end to the
4611           matching connector on the TeleDongle.
4612           Note that each MicroMaTch connector has an alignment pin that
4613           goes through a hole in the PC board when you have the cable
4614           oriented correctly.
4615         </para>
4616 </listitem>
4617         <listitem>
4618 <para>
4619           Attach a battery to the TeleMetrum board if you're using one.
4620         </para>
4621 </listitem>
4622         <listitem>
4623 <para>
4624           Plug both the programmer and the TeleDongle into your computer's USB
4625           ports, and power up the programmer.
4626         </para>
4627 </listitem>
4628         <listitem>
4629 <para>
4630           Run AltosUI, and select 'Flash Image' from the File menu.
4631         </para>
4632 </listitem>
4633         <listitem>
4634 <para>
4635           Pick the programmer device from the list, identifying it as the
4636           programming device.
4637         </para>
4638 </listitem>
4639         <listitem>
4640 <para>
4641           Select the image you want put on the TeleDongle, which should have a
4642           name in the form teledongle-v0.2-1.0.0.ihx.  It should be visible
4643         in the default directory, if not you may have to poke around
4644         your system to find it.
4645         </para>
4646 </listitem>
4647         <listitem>
4648 <para>
4649           Make sure the configuration parameters are reasonable
4650           looking. If the serial number and/or RF configuration
4651           values aren't right, you'll need to change them.  The TeleDongle
4652           serial number is on the “bottom” of the circuit board, and can
4653           usually be read through the translucent blue plastic case without
4654           needing to remove the board from the case.
4655         </para>
4656 </listitem>
4657         <listitem>
4658 <para>
4659           Hit the 'OK' button and the software should proceed to flash
4660           the TeleDongle with new firmware, showing a progress bar.
4661         </para>
4662 </listitem>
4663         <listitem>
4664 <para>
4665           Confirm that the TeleDongle board seems to have updated OK, which you
4666           can do by plugging in to it over USB and using a terminal program
4667           to connect to the board and issue the 'v' command to check
4668           the version, etc.  Once you're happy, remove the programming cable
4669           and put the cover back on the TeleDongle.
4670         </para>
4671 </listitem>
4672         <listitem>
4673 <para>
4674           If something goes wrong, give it another try.
4675         </para>
4676 </listitem>
4677       </orderedlist>
4678       <para>
4679         Be careful removing the programming cable from the locking 8-pin
4680         connector on TeleMetrum.  You'll need a fingernail or perhaps a thin
4681         screwdriver or knife blade to gently pry the locking ears out
4682         slightly to extract the connector.  We used a locking connector on
4683         TeleMetrum to help ensure that the cabling to companion boards
4684         used in a rocket don't ever come loose accidentally in flight.
4685       </para>
4686     </section>
4687   </chapter>
4688   <chapter>
4689     <title>Hardware Specifications</title>
4690     <section>
4691       <title>
4692         TeleMega Specifications
4693       </title>
4694       <itemizedlist>
4695         <listitem>
4696           <para>
4697             Recording altimeter for model rocketry.
4698           </para>
4699         </listitem>
4700         <listitem>
4701           <para>
4702             Supports dual deployment and four auxiliary pyro channels
4703             (a total of 6 events).
4704           </para>
4705         </listitem>
4706         <listitem>
4707           <para>
4708             70cm 40mW ham-band transceiver for telemetry down-link.
4709           </para>
4710         </listitem>
4711         <listitem>
4712           <para>
4713             Barometric pressure sensor good to 100k feet MSL.
4714           </para>
4715         </listitem>
4716         <listitem>
4717           <para>
4718             1-axis high-g accelerometer for motor characterization, capable of
4719             +/- 102g.
4720           </para>
4721         </listitem>
4722         <listitem>
4723           <para>
4724             9-axis IMU including integrated 3-axis accelerometer,
4725             3-axis gyroscope and 3-axis magnetometer.
4726           </para>
4727         </listitem>
4728         <listitem>
4729           <para>
4730             On-board, integrated uBlox Max 7 GPS receiver with 5Hz update rate capability.
4731           </para>
4732         </listitem>
4733         <listitem>
4734           <para>
4735             On-board 8 Megabyte non-volatile memory for flight data storage.
4736           </para>
4737         </listitem>
4738         <listitem>
4739           <para>
4740             USB interface for battery charging, configuration, and data recovery.
4741           </para>
4742         </listitem>
4743         <listitem>
4744           <para>
4745             Fully integrated support for Li-Po rechargeable batteries.
4746           </para>
4747         </listitem>
4748         <listitem>
4749           <para>
4750             Can use either main system Li-Po or optional separate pyro battery
4751             to fire e-matches.
4752           </para>
4753         </listitem>
4754         <listitem>
4755           <para>
4756             3.25 x 1.25 inch board designed to fit inside 38mm air-frame coupler tube.
4757           </para>
4758         </listitem>
4759       </itemizedlist>
4760     </section>
4761     <section>
4762       <title>
4763         TeleMetrum v2 Specifications
4764       </title>
4765       <itemizedlist>
4766         <listitem>
4767           <para>
4768             Recording altimeter for model rocketry.
4769           </para>
4770         </listitem>
4771         <listitem>
4772           <para>
4773             Supports dual deployment (can fire 2 ejection charges).
4774           </para>
4775         </listitem>
4776         <listitem>
4777           <para>
4778             70cm, 40mW ham-band transceiver for telemetry down-link.
4779           </para>
4780         </listitem>
4781         <listitem>
4782           <para>
4783             Barometric pressure sensor good to 100k feet MSL.
4784           </para>
4785         </listitem>
4786         <listitem>
4787           <para>
4788             1-axis high-g accelerometer for motor characterization, capable of
4789             +/- 102g.
4790           </para>
4791         </listitem>
4792         <listitem>
4793           <para>
4794             On-board, integrated uBlox Max 7 GPS receiver with 5Hz update rate capability.
4795           </para>
4796         </listitem>
4797         <listitem>
4798           <para>
4799             On-board 8 Megabyte non-volatile memory for flight data storage.
4800           </para>
4801         </listitem>
4802         <listitem>
4803           <para>
4804             USB interface for battery charging, configuration, and data recovery.
4805           </para>
4806         </listitem>
4807         <listitem>
4808           <para>
4809             Fully integrated support for Li-Po rechargeable batteries.
4810           </para>
4811         </listitem>
4812         <listitem>
4813           <para>
4814             Uses Li-Po to fire e-matches, can be modified to support 
4815             optional separate pyro battery if needed.
4816           </para>
4817         </listitem>
4818         <listitem>
4819           <para>
4820             2.75 x 1 inch board designed to fit inside 29mm air-frame coupler tube.
4821           </para>
4822         </listitem>
4823       </itemizedlist>
4824     </section>
4825     <section>
4826       <title>TeleMetrum v1 Specifications</title>
4827       <itemizedlist>
4828         <listitem>
4829           <para>
4830             Recording altimeter for model rocketry.
4831           </para>
4832         </listitem>
4833         <listitem>
4834           <para>
4835             Supports dual deployment (can fire 2 ejection charges).
4836           </para>
4837         </listitem>
4838         <listitem>
4839           <para>
4840             70cm, 10mW ham-band transceiver for telemetry down-link.
4841           </para>
4842         </listitem>
4843         <listitem>
4844           <para>
4845             Barometric pressure sensor good to 45k feet MSL.
4846           </para>
4847         </listitem>
4848         <listitem>
4849           <para>
4850             1-axis high-g accelerometer for motor characterization, capable of
4851             +/- 50g using default part.
4852           </para>
4853         </listitem>
4854         <listitem>
4855           <para>
4856             On-board, integrated GPS receiver with 5Hz update rate capability.
4857           </para>
4858         </listitem>
4859         <listitem>
4860           <para>
4861             On-board 1 megabyte non-volatile memory for flight data storage.
4862           </para>
4863         </listitem>
4864         <listitem>
4865           <para>
4866             USB interface for battery charging, configuration, and data recovery.
4867           </para>
4868         </listitem>
4869         <listitem>
4870           <para>
4871             Fully integrated support for Li-Po rechargeable batteries.
4872           </para>
4873         </listitem>
4874         <listitem>
4875           <para>
4876             Uses Li-Po to fire e-matches, can be modified to support 
4877             optional separate pyro battery if needed.
4878           </para>
4879         </listitem>
4880         <listitem>
4881           <para>
4882             2.75 x 1 inch board designed to fit inside 29mm air-frame coupler tube.
4883           </para>
4884         </listitem>
4885       </itemizedlist>
4886     </section>
4887     <section>
4888       <title>
4889         TeleMini v2.0 Specifications
4890       </title>
4891       <itemizedlist>
4892         <listitem>
4893           <para>
4894             Recording altimeter for model rocketry.
4895           </para>
4896         </listitem>
4897         <listitem>
4898           <para>
4899             Supports dual deployment (can fire 2 ejection charges).
4900           </para>
4901         </listitem>
4902         <listitem>
4903           <para>
4904             70cm, 10mW ham-band transceiver for telemetry down-link.
4905           </para>
4906         </listitem>
4907         <listitem>
4908           <para>
4909             Barometric pressure sensor good to 100k feet MSL.
4910           </para>
4911         </listitem>
4912         <listitem>
4913           <para>
4914             On-board 1 megabyte non-volatile memory for flight data storage.
4915           </para>
4916         </listitem>
4917         <listitem>
4918           <para>
4919             USB interface for configuration, and data recovery.
4920           </para>
4921         </listitem>
4922         <listitem>
4923           <para>
4924             Support for Li-Po rechargeable batteries (using an
4925             external charger), or any 3.7-15V external battery.
4926           </para>
4927         </listitem>
4928         <listitem>
4929           <para>
4930             Uses Li-Po to fire e-matches, can be modified to support 
4931             optional separate pyro battery if needed.
4932           </para>
4933         </listitem>
4934         <listitem>
4935           <para>
4936             1.5 x .8 inch board designed to fit inside 24mm air-frame coupler tube.
4937           </para>
4938         </listitem>
4939       </itemizedlist>
4940     </section>
4941     <section>
4942       <title>
4943         TeleMini v1.0 Specifications
4944       </title>
4945       <itemizedlist>
4946         <listitem>
4947           <para>
4948             Recording altimeter for model rocketry.
4949           </para>
4950         </listitem>
4951         <listitem>
4952           <para>
4953             Supports dual deployment (can fire 2 ejection charges).
4954           </para>
4955         </listitem>
4956         <listitem>
4957           <para>
4958             70cm, 10mW ham-band transceiver for telemetry down-link.
4959           </para>
4960         </listitem>
4961         <listitem>
4962           <para>
4963             Barometric pressure sensor good to 45k feet MSL.
4964           </para>
4965         </listitem>
4966         <listitem>
4967           <para>
4968             On-board 5 kilobyte non-volatile memory for flight data storage.
4969           </para>
4970         </listitem>
4971         <listitem>
4972           <para>
4973             RF interface for configuration, and data recovery.
4974           </para>
4975         </listitem>
4976         <listitem>
4977           <para>
4978             Support for Li-Po rechargeable batteries, using an external charger.
4979           </para>
4980         </listitem>
4981         <listitem>
4982           <para>
4983             Uses Li-Po to fire e-matches, can be modified to support 
4984             optional separate pyro battery if needed.
4985           </para>
4986         </listitem>
4987         <listitem>
4988           <para>
4989             1.5 x .5 inch board designed to fit inside 18mm air-frame coupler tube.
4990           </para>
4991         </listitem>
4992       </itemizedlist>
4993     </section>
4994     <section>
4995       <title>
4996         EasyMini Specifications
4997       </title>
4998       <itemizedlist>
4999         <listitem>
5000           <para>
5001             Recording altimeter for model rocketry.
5002           </para>
5003         </listitem>
5004         <listitem>
5005           <para>
5006             Supports dual deployment (can fire 2 ejection charges).
5007           </para>
5008         </listitem>
5009         <listitem>
5010           <para>
5011             Barometric pressure sensor good to 100k feet MSL.
5012           </para>
5013         </listitem>
5014         <listitem>
5015           <para>
5016             On-board 1 megabyte non-volatile memory for flight data storage.
5017           </para>
5018         </listitem>
5019         <listitem>
5020           <para>
5021             USB interface for configuration, and data recovery.
5022           </para>
5023         </listitem>
5024         <listitem>
5025           <para>
5026             Support for Li-Po rechargeable batteries (using an
5027             external charger), or any 3.7-15V external battery.
5028           </para>
5029         </listitem>
5030         <listitem>
5031           <para>
5032             Uses Li-Po to fire e-matches, can be modified to support 
5033             optional separate pyro battery if needed.
5034           </para>
5035         </listitem>
5036         <listitem>
5037           <para>
5038             1.5 x .8 inch board designed to fit inside 24mm air-frame coupler tube.
5039           </para>
5040         </listitem>
5041       </itemizedlist>
5042     </section>
5043   </chapter>
5044   <chapter>
5045     <title>FAQ</title>
5046       <para>
5047         <emphasis>TeleMetrum seems to shut off when disconnected from the
5048         computer.</emphasis>  <?linebreak?>
5049         Make sure the battery is adequately charged.  Remember the
5050         unit will pull more power than the USB port can deliver before the
5051         GPS enters “locked” mode.  The battery charges best when TeleMetrum
5052         is turned off.
5053       </para>
5054       <para>
5055         <emphasis>It's impossible to stop the TeleDongle when it's in “p” mode, I have
5056         to unplug the USB cable? </emphasis><?linebreak?>
5057         Make sure you have tried to “escape out” of
5058         this mode.  If this doesn't work the reboot procedure for the
5059         TeleDongle *is* to simply unplug it. 'cu' however will retain it's
5060         outgoing buffer IF your “escape out” ('~~') does not work.
5061         At this point using either 'ao-view' (or possibly
5062         'cutemon') instead of 'cu' will 'clear' the issue and allow renewed
5063         communication.
5064       </para>
5065       <para>
5066         <emphasis>The amber LED (on the TeleMetrum) lights up when both
5067         battery and USB are connected. Does this mean it's charging? 
5068         </emphasis><?linebreak?>
5069         Yes, the yellow LED indicates the charging at the 'regular' rate.
5070         If the led is out but the unit is still plugged into a USB port,
5071         then the battery is being charged at a 'trickle' rate.
5072       </para>
5073       <para>
5074         <emphasis>There are no “dit-dah-dah-dit” sound or lights like the manual 
5075         mentions?</emphasis><?linebreak?>
5076         That's the “pad” mode.  Weak batteries might be the problem.
5077         It is also possible that the flight computer is horizontal and the 
5078         output
5079         is instead a “dit-dit” meaning 'idle'. For TeleMini, it's possible that
5080         it received a command packet which would have left it in “pad” mode.
5081       </para>
5082       <para>
5083         <emphasis>How do I save flight data?</emphasis><?linebreak?>
5084         Live telemetry is written to file(s) whenever AltosUI is connected
5085         to the TeleDongle.  The file area defaults to ~/TeleMetrum
5086         but is easily changed using the menus in AltosUI. The files that
5087         are written end in '.telem'. The after-flight
5088         data-dumped files will end in .eeprom and represent continuous data
5089         unlike the .telem files that are subject to losses
5090         along the RF data path.
5091         See the above instructions on what and how to save the eeprom stored
5092         data after physically retrieving your altimeter.  Make sure to save
5093         the on-board data after each flight; while the TeleMetrum can store
5094         multiple flights, you never know when you'll lose the altimeter...
5095       </para>
5096   </chapter>
5097   <appendix>
5098     <title>Notes for Older Software</title>
5099     <para>
5100       <emphasis>
5101       Before AltosUI was written, using Altus Metrum devices required
5102       some finesse with the Linux command line. There was a limited
5103       GUI tool, ao-view, which provided functionality similar to the
5104       Monitor Flight window in AltosUI, but everything else was a
5105       fairly 80's experience. This appendix includes documentation for
5106       using that software.
5107       </emphasis>
5108     </para>
5109     <para>
5110       Both TeleMetrum and TeleDongle can be directly communicated
5111       with using USB ports. The first thing you should try after getting
5112       both units plugged into to your computer's USB port(s) is to run
5113       'ao-list' from a terminal-window to see what port-device-name each
5114       device has been assigned by the operating system.
5115       You will need this information to access the devices via their
5116       respective on-board firmware and data using other command line
5117       programs in the AltOS software suite.
5118     </para>
5119     <para>
5120       TeleMini can be communicated with through a TeleDongle device
5121       over the radio link. When first booted, TeleMini listens for a
5122       TeleDongle device and if it receives a packet, it goes into
5123       'idle' mode. Otherwise, it goes into 'pad' mode and waits to be
5124       launched. The easiest way to get it talking is to start the
5125       communication link on the TeleDongle and the power up the
5126       TeleMini board.
5127     </para>
5128     <para>
5129       To access the device's firmware for configuration you need a terminal
5130       program such as you would use to talk to a modem.  The software
5131       authors prefer using the program 'cu' which comes from the UUCP package
5132       on most Unix-like systems such as Linux.  An example command line for
5133       cu might be 'cu -l /dev/ttyACM0', substituting the correct number
5134       indicated from running the
5135       ao-list program.  Another reasonable terminal program for Linux is
5136       'cutecom'.  The default 'escape'
5137       character used by CU (i.e. the character you use to
5138       issue commands to cu itself instead of sending the command as input
5139       to the connected device) is a '~'. You will need this for use in
5140       only two different ways during normal operations. First is to exit
5141       the program by sending a '~.' which is called a 'escape-disconnect'
5142       and allows you to close-out from 'cu'. The
5143       second use will be outlined later.
5144     </para>
5145     <para>
5146       All of the Altus Metrum devices share the concept of a two level
5147       command set in their firmware.
5148       The first layer has several single letter commands. Once
5149       you are using 'cu' (or 'cutecom') sending (typing) a '?'
5150       returns a full list of these
5151       commands. The second level are configuration sub-commands accessed
5152       using the 'c' command, for
5153       instance typing 'c?' will give you this second level of commands
5154       (all of which require the
5155       letter 'c' to access).  Please note that most configuration options
5156       are stored only in Flash memory; TeleDongle doesn't provide any storage
5157       for these options and so they'll all be lost when you unplug it.
5158     </para>
5159     <para>
5160       Try setting these configuration ('c' or second level menu) values.  A good
5161       place to start is by setting your call sign.  By default, the boards
5162       use 'N0CALL' which is cute, but not exactly legal!
5163       Spend a few minutes getting comfortable with the units, their
5164       firmware, and 'cu' (or possibly 'cutecom').
5165       For instance, try to send
5166       (type) a 'c r 2' and verify the channel change by sending a 'c s'.
5167       Verify you can connect and disconnect from the units while in your
5168       terminal program by sending the escape-disconnect mentioned above.
5169     </para>
5170         <para>
5171           To set the radio frequency, use the 'c R' command to specify the
5172           radio transceiver configuration parameter. This parameter is computed
5173           using the desired frequency, 'F', the radio calibration parameter, 'C' (showed by the 'c s' command) and
5174           the standard calibration reference frequency, 'S', (normally 434.550MHz):
5175           <programlisting>
5176             R = F / S * C
5177           </programlisting>
5178           Round the result to the nearest integer value.
5179           As with all 'c' sub-commands, follow this with a 'c w' to write the
5180           change to the parameter block in the on-board flash on
5181           your altimeter board if you want the change to stay in place across reboots.
5182         </para>
5183         <para>
5184           To set the apogee delay, use the 'c d' command.
5185           As with all 'c' sub-commands, follow this with a 'c w' to write the
5186           change to the parameter block in the on-board DataFlash chip.
5187         </para>
5188         <para>
5189           To set the main deployment altitude, use the 'c m' command.
5190           As with all 'c' sub-commands, follow this with a 'c w' to write the
5191           change to the parameter block in the on-board DataFlash chip.
5192         </para>
5193         <para>
5194           To calibrate the radio frequency, connect the UHF antenna port to a
5195           frequency counter, set the board to 434.550MHz, and use the 'C'
5196           command to generate a CW carrier.  Wait for the transmitter temperature
5197           to stabilize and the frequency to settle down.
5198           Then, divide 434.550 MHz by the
5199           measured frequency and multiply by the current radio cal value show
5200           in the 'c s' command.  For an unprogrammed board, the default value
5201           is 1186611 for cc1111 based products and 7119667 for cc1120
5202           based products.  Take the resulting integer and program it using the 'c f'
5203           command.  Testing with the 'C' command again should show a carrier
5204           within a few tens of Hertz of the intended frequency.
5205           As with all 'c' sub-commands, follow this with a 'c w' to write the
5206           change to the configuration memory.
5207         </para>
5208     <para>
5209       Note that the 'reboot' command, which is very useful on the altimeters,
5210       will likely just cause problems with the dongle.  The *correct* way
5211       to reset the dongle is just to unplug and re-plug it.
5212     </para>
5213     <para>
5214       A fun thing to do at the launch site and something you can do while
5215       learning how to use these units is to play with the radio link access
5216       between an altimeter and the TeleDongle.  Be aware that you *must* create
5217       some physical separation between the devices, otherwise the link will
5218       not function due to signal overload in the receivers in each device.
5219     </para>
5220     <para>
5221       Now might be a good time to take a break and read the rest of this
5222       manual, particularly about the two “modes” that the altimeters
5223       can be placed in. TeleMetrum uses the position of the device when booting
5224       up will determine whether the unit is in “pad” or “idle” mode. TeleMini
5225       enters “idle” mode when it receives a command packet within the first 5 seconds
5226       of being powered up, otherwise it enters “pad” mode.
5227     </para>
5228     <para>
5229       You can access an altimeter in idle mode from the TeleDongle's USB
5230       connection using the radio link
5231       by issuing a 'p' command to the TeleDongle. Practice connecting and
5232       disconnecting ('~~' while using 'cu') from the altimeter.  If
5233       you cannot escape out of the “p” command, (by using a '~~' when in
5234       CU) then it is likely that your kernel has issues.  Try a newer version.
5235     </para>
5236     <para>
5237       Using this radio link allows you to configure the altimeter, test
5238       fire e-matches and igniters from the flight line, check pyro-match
5239       continuity and so forth. You can leave the unit turned on while it
5240       is in 'idle mode' and then place the
5241       rocket vertically on the launch pad, walk away and then issue a
5242       reboot command.  The altimeter will reboot and start sending data
5243       having changed to the “pad” mode. If the TeleDongle is not receiving
5244       this data, you can disconnect 'cu' from the TeleDongle using the
5245       procedures mentioned above and THEN connect to the TeleDongle from
5246       inside 'ao-view'. If this doesn't work, disconnect from the
5247       TeleDongle, unplug it, and try again after plugging it back in.
5248     </para>
5249     <para>
5250       In order to reduce the chance of accidental firing of pyrotechnic
5251       charges, the command to fire a charge is intentionally somewhat
5252       difficult to type, and the built-in help is slightly cryptic to
5253       prevent accidental echoing of characters from the help text back at
5254       the board from firing a charge.  The command to fire the apogee
5255       drogue charge is 'i DoIt drogue' and the command to fire the main
5256       charge is 'i DoIt main'.
5257     </para>
5258     <para>
5259       On TeleMetrum, the GPS will eventually find enough satellites, lock in on them,
5260       and 'ao-view' will both auditorily announce and visually indicate
5261       that GPS is ready.
5262       Now you can launch knowing that you have a good data path and
5263       good satellite lock for flight data and recovery.  Remember
5264       you MUST tell ao-view to connect to the TeleDongle explicitly in
5265       order for ao-view to be able to receive data.
5266     </para>
5267     <para>
5268       The altimeters provide RDF (radio direction finding) tones on
5269       the pad, during descent and after landing. These can be used to
5270       locate the rocket using a directional antenna; the signal
5271       strength providing an indication of the direction from receiver to rocket.
5272     </para>
5273     <para>
5274       TeleMetrum also provides GPS tracking data, which can further simplify
5275       locating the rocket once it has landed. (The last good GPS data
5276       received before touch-down will be on the data screen of 'ao-view'.)
5277     </para>
5278     <para>
5279       Once you have recovered the rocket you can download the eeprom
5280       contents using either 'ao-dumplog' (or possibly 'ao-eeprom'), over
5281       either a USB cable or over the radio link using TeleDongle.
5282       And by following the man page for 'ao-postflight' you can create
5283       various data output reports, graphs, and even KML data to see the
5284       flight trajectory in Google-earth. (Moving the viewing angle making
5285       sure to connect the yellow lines while in Google-earth is the proper
5286       technique.)
5287     </para>
5288     <para>
5289       As for ao-view.... some things are in the menu but don't do anything
5290       very useful.  The developers have stopped working on ao-view to focus
5291       on a new, cross-platform ground station program.  So ao-view may or
5292       may not be updated in the future.  Mostly you just use
5293       the Log and Device menus.  It has a wonderful display of the incoming
5294       flight data and I am sure you will enjoy what it has to say to you
5295       once you enable the voice output!
5296     </para>
5297   </appendix>
5298   <appendix>
5299     <title>Drill Templates</title>
5300     <para>
5301       These images, when printed, provide precise templates for the
5302       mounting holes in Altus Metrum flight computers
5303     </para>
5304     <section>
5305       <title>TeleMega template</title>
5306       <para>
5307         TeleMega has overall dimensions of 1.250 x 3.250 inches, and
5308         the mounting holes are sized for use with 4-40 or M3 screws.
5309       </para>
5310       <informalfigure>
5311         <mediaobject id="TeleMegaTemplate">
5312           <imageobject>
5313             <imagedata format="SVG" fileref="telemega.svg"
5314                        scalefit="0" scale="100" align="center" />
5315           </imageobject>
5316         </mediaobject>
5317       </informalfigure>
5318     </section>
5319     <section>
5320       <title>TeleMetrum template</title>
5321       <para>
5322         TeleMetrum has overall dimensions of 1.000 x 2.750 inches, and the
5323         mounting holes are sized for use with 4-40 or M3 screws.
5324       </para>
5325       <informalfigure>
5326         <mediaobject id="TeleMetrumTemplate">
5327           <imageobject>
5328             <imagedata format="SVG" fileref="telemetrum.svg"
5329                        scalefit="0" scale="100" align="center" />
5330           </imageobject>
5331         </mediaobject>
5332       </informalfigure>
5333     </section>
5334     <section>
5335       <title>TeleMini v2/EasyMini template</title>
5336       <para>
5337         TeleMini v2 and EasyMini have overall dimensions of 0.800 x 1.500 inches, and the
5338         mounting holes are sized for use with 4-40 or M3 screws.
5339       </para>
5340       <informalfigure>
5341         <mediaobject id="MiniTemplate">
5342           <imageobject>
5343             <imagedata format="SVG" fileref="easymini.svg"
5344                        scalefit="0" scale="100" align="center" />
5345           </imageobject>
5346         </mediaobject>
5347       </informalfigure>
5348     </section>
5349     <section>
5350       <title>TeleMini v1 template</title>
5351       <para>
5352         TeleMini has overall dimensions of 0.500 x 1.500 inches, and the
5353         mounting holes are sized for use with 2-56 or M2 screws.
5354       </para>
5355       <informalfigure>
5356         <mediaobject id="TeleMiniTemplate">
5357           <imageobject>
5358             <imagedata format="SVG" fileref="telemini.svg"
5359                        scalefit="0" scale="100" align="center" />
5360           </imageobject>
5361         </mediaobject>
5362       </informalfigure>
5363     </section>
5364   </appendix>
5365   <appendix>
5366       <title>Calibration</title>
5367       <para>
5368         There are only two calibrations required for TeleMetrum and
5369         TeleMega, and only one for TeleDongle, TeleMini and EasyMini.
5370         All boards are shipped from the factory pre-calibrated, but
5371         the procedures are documented here in case they are ever
5372         needed.  Re-calibration is not supported by AltosUI, you must
5373         connect to the board with a serial terminal program and
5374         interact directly with the on-board command interpreter to
5375         effect calibration.
5376       </para>
5377       <section>
5378         <title>Radio Frequency</title>
5379         <para>
5380           The radio frequency is synthesized from a clock based on the
5381           crystal on the board.  The actual frequency of this oscillator 
5382           must be measured to generate a calibration constant.  While our 
5383           GFSK modulation
5384           bandwidth is wide enough to allow boards to communicate even when
5385           their oscillators are not on exactly the same frequency, performance
5386           is best when they are closely matched.
5387           Radio frequency calibration requires a calibrated frequency counter.
5388           Fortunately, once set, the variation in frequency due to aging and
5389           temperature changes is small enough that re-calibration by customers
5390           should generally not be required.
5391         </para>
5392         <para>
5393           To calibrate the radio frequency, connect the UHF antenna
5394           port to a frequency counter, set the board to 434.550MHz,
5395           and use the 'C' command in the on-board command interpreter
5396           to generate a CW carrier.  For USB-enabled boards, this is
5397           best done over USB.  For TeleMini v1, note that the only way
5398           to escape the 'C' command is via power cycle since the board
5399           will no longer be listening for commands once it starts
5400           generating a CW carrier.
5401         </para>
5402         <para>
5403           Wait for the transmitter temperature to stabilize and the frequency 
5404           to settle down.  Then, divide 434.550 MHz by the
5405           measured frequency and multiply by the current radio cal value show
5406           in the 'c s' command.  For an unprogrammed board, the default value
5407           is 1186611.  Take the resulting integer and program it using the 'c f'
5408           command.  Testing with the 'C' command again should show a carrier
5409           within a few tens of Hertz of the intended frequency.
5410           As with all 'c' sub-commands, follow this with a 'c w' to write the
5411           change to the parameter block in the on-board storage chip.
5412         </para>
5413         <para>
5414           Note that any time you re-do the radio frequency calibration, the
5415           radio frequency is reset to the default 434.550 Mhz.  If you want
5416           to use another frequency, you will have to set that again after
5417           calibration is completed.
5418         </para>
5419       </section>
5420       <section>
5421         <title>TeleMetrum and TeleMega Accelerometers</title>
5422         <para>
5423           While barometric sensors are factory-calibrated,
5424           accelerometers are not, and so each must be calibrated once
5425           installed in a flight computer.  Explicitly calibrating the
5426           accelerometers also allows us to load any compatible device.
5427           We perform a two-point calibration using gravity.
5428         </para>
5429         <para>
5430           To calibrate the acceleration sensor, use the 'c a 0' command.  You
5431           will be prompted to orient the board vertically with the UHF antenna
5432           up and press a key, then to orient the board vertically with the
5433           UHF antenna down and press a key.  Note that the accuracy of this
5434           calibration depends primarily on how perfectly vertical and still
5435           the board is held during the cal process.  As with all 'c' 
5436           sub-commands, follow this with a 'c w' to write the
5437           change to the parameter block in the on-board DataFlash chip.
5438         </para>
5439         <para>
5440           The +1g and -1g calibration points are included in each telemetry
5441           frame and are part of the header stored in onboard flash to be
5442           downloaded after flight.  We always store and return raw ADC 
5443           samples for each sensor... so nothing is permanently “lost” or 
5444           “damaged” if the calibration is poor.
5445         </para>
5446         <para>
5447          In the unlikely event an accel cal goes badly, it is possible
5448          that TeleMetrum or TeleMega may always come up in 'pad mode'
5449          and as such not be listening to either the USB or radio link.
5450          If that happens, there is a special hook in the firmware to
5451          force the board back in to 'idle mode' so you can re-do the
5452          cal.  To use this hook, you just need to ground the SPI clock
5453          pin at power-on.  This pin is available as pin 2 on the 8-pin
5454          companion connector, and pin 1 is ground.  So either
5455          carefully install a fine-gauge wire jumper between the two
5456          pins closest to the index hole end of the 8-pin connector, or
5457          plug in the programming cable to the 8-pin connector and use
5458          a small screwdriver or similar to short the two pins closest
5459          to the index post on the 4-pin end of the programming cable,
5460          and power up the board.  It should come up in 'idle mode'
5461          (two beeps), allowing a re-cal.
5462         </para>
5463       </section>
5464   </appendix>
5465   <appendix>
5466     <title>Release Notes</title>
5467     <simplesect>
5468       <title>Version 1.41</title>
5469       <xi:include
5470           xmlns:xi="http://www.w3.org/2001/XInclude"
5471           href="release-notes-1.4.1.xsl"
5472           xpointer="xpointer(/article/*)"/>
5473     </simplesect>
5474     <simplesect>
5475       <title>Version 1.4</title>
5476       <xi:include
5477           xmlns:xi="http://www.w3.org/2001/XInclude"
5478           href="release-notes-1.4.xsl"
5479           xpointer="xpointer(/article/*)"/>
5480     </simplesect>
5481     <simplesect>
5482       <title>Version 1.3.2</title>
5483       <xi:include
5484           xmlns:xi="http://www.w3.org/2001/XInclude"
5485           href="release-notes-1.3.2.xsl"
5486           xpointer="xpointer(/article/*)"/>
5487     </simplesect>
5488     <simplesect>
5489       <title>Version 1.3.1</title>
5490       <xi:include
5491           xmlns:xi="http://www.w3.org/2001/XInclude"
5492           href="release-notes-1.3.1.xsl"
5493           xpointer="xpointer(/article/*)"/>
5494     </simplesect>
5495     <simplesect>
5496       <title>Version 1.3</title>
5497       <xi:include
5498           xmlns:xi="http://www.w3.org/2001/XInclude"
5499           href="release-notes-1.3.xsl"
5500           xpointer="xpointer(/article/*)"/>
5501     </simplesect>
5502     <simplesect>
5503       <title>Version 1.2.1</title>
5504       <xi:include
5505           xmlns:xi="http://www.w3.org/2001/XInclude"
5506           href="release-notes-1.2.1.xsl"
5507           xpointer="xpointer(/article/*)"/>
5508     </simplesect>
5509     <simplesect>
5510       <title>Version 1.2</title>
5511       <xi:include
5512           xmlns:xi="http://www.w3.org/2001/XInclude"
5513           href="release-notes-1.2.xsl"
5514           xpointer="xpointer(/article/*)"/>
5515     </simplesect>
5516     <simplesect>
5517       <title>Version 1.1.1</title>
5518       <xi:include
5519           xmlns:xi="http://www.w3.org/2001/XInclude"
5520           href="release-notes-1.1.1.xsl"
5521           xpointer="xpointer(/article/*)"/>
5522     </simplesect>
5523     <simplesect>
5524       <title>Version 1.1</title>
5525       <xi:include
5526           xmlns:xi="http://www.w3.org/2001/XInclude"
5527           href="release-notes-1.1.xsl"
5528           xpointer="xpointer(/article/*)"/>
5529     </simplesect>
5530     <simplesect>
5531       <title>Version 1.0.1</title>
5532       <xi:include
5533           xmlns:xi="http://www.w3.org/2001/XInclude"
5534           href="release-notes-1.0.1.xsl"
5535           xpointer="xpointer(/article/*)"/>
5536     </simplesect>
5537     <simplesect>
5538       <title>Version 0.9.2</title>
5539       <xi:include
5540           xmlns:xi="http://www.w3.org/2001/XInclude"
5541           href="release-notes-0.9.2.xsl"
5542           xpointer="xpointer(/article/*)"/>
5543     </simplesect>
5544     <simplesect>
5545       <title>Version 0.9</title>
5546       <xi:include
5547           xmlns:xi="http://www.w3.org/2001/XInclude"
5548           href="release-notes-0.9.xsl"
5549           xpointer="xpointer(/article/*)"/>
5550     </simplesect>
5551     <simplesect>
5552       <title>Version 0.8</title>
5553       <xi:include
5554           xmlns:xi="http://www.w3.org/2001/XInclude"
5555           href="release-notes-0.8.xsl"
5556           xpointer="xpointer(/article/*)"/>
5557     </simplesect>
5558     <simplesect>
5559       <title>Version 0.7.1</title>
5560       <xi:include
5561           xmlns:xi="http://www.w3.org/2001/XInclude"
5562           href="release-notes-0.7.1.xsl"
5563           xpointer="xpointer(/article/*)"/>
5564     </simplesect>
5565   </appendix>
5566 </book>
5567
5568 <!-- LocalWords: Altusmetrum
5569 -->