crudely incorporate "day in the life" info from web page
[fw/altos] / doc / telemetrum.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   <bookinfo>
6     <author>
7       <firstname>Bdale</firstname>
8       <surname>Garbee</surname>
9     </author>
10     <author>
11       <firstname>Keith</firstname>
12       <surname>Packard</surname>
13     </author>
14     <copyright>
15       <year>2010</year>
16       <holder>Bdale Garbee and Keith Packard</holder>
17     </copyright>
18     <title>TeleMetrum</title>
19     <subtitle>Owner's Manual for the TeleMetrum System</subtitle>
20     <legalnotice>
21       <para>
22         This document is released under the terms of the 
23         <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">
24           Creative Commons ShareAlike 3.0
25         </ulink>
26         license.
27       </para>
28     </legalnotice>
29     <revhistory>
30       <revision>
31         <revnumber>0.1</revnumber>
32         <date>30 March 2010</date>
33         <revremark>Initial content</revremark>
34       </revision>
35     </revhistory>
36   </bookinfo>
37   <chapter>
38     <title>Introduction and Overview</title>
39     <para>
40       Placeholder.
41     </para>
42   </chapter>
43   <chapter>
44     <title>Specifications</title>
45     <para>
46       Placeholder.
47     </para>
48   </chapter>
49   <chapter>
50     <title>Handling Precautions</title>
51     <para>
52       Placeholder.
53     </para>
54   </chapter>
55   <chapter>
56     <title>Hardware Overview</title>
57     <para>
58       Placeholder.
59     </para>
60   </chapter>
61   <chapter>
62     <title>Operation</title>
63     <para>
64       Placeholder.
65     </para>
66   </chapter>
67   <chapter>
68     <title>Using Altus Metrum Products</title>
69     <section>
70       <title>Being Legal</title>
71       <para>
72         First off, in the US, you need an [amateur radio license](../Radio) or 
73         other authorization to legally operate the radio transmitters that are part
74         of our products.
75       </para>
76       <section>
77         <title>In the Rocket</title>
78         <para>
79           In the rocket itself, you just need a [TeleMetrum](../TeleMetrum) board and 
80           a LiPo rechargeable battery.  An 860mAh battery weighs less than a 9V 
81           alkaline battery, and will run a [TeleMetrum](../TeleMetrum) for hours.
82         </para>
83         <para>
84           By default, we ship TeleMetrum with a simple wire antenna.  If your 
85           electronics bay or the airframe it resides within is made of carbon fiber, 
86           which is opaque to RF signals, you may choose to have an SMA connector 
87           installed so that you can run a coaxial cable to an antenna mounted 
88           elsewhere in the rocket.
89         </para>
90       </section>
91       <section>
92         <title>On the Ground</title>
93         <para>
94           To receive the data stream from the rocket, you need an antenna and short 
95           feedline connected to one of our [TeleDongle](../TeleDongle) units.  The
96           TeleDongle in turn plugs directly into the USB port on a notebook 
97           computer.  Because TeleDongle looks like a simple serial port, your computer
98           does not require special device drivers... just plug it in.
99         </para>
100         <para>
101           Right now, all of our application software is written for Linux.  However, 
102           because we understand that many people run Windows or MacOS, we are working 
103           on a new ground station program written in Java that should work on all
104           operating systems.
105         </para>
106         <para>
107           After the flight, you can use the RF link to extract the more detailed data 
108           logged in the rocket, or you can use a mini USB cable to plug into the 
109           TeleMetrum board directly.  Pulling out the data without having to open up
110           the rocket is pretty cool!  A USB cable is also how you charge the LiPo 
111           battery, so you'll want one of those anyway... the same cable used by lots 
112           of digital cameras and other modern electronic stuff will work fine.
113         </para>
114         <para>
115           If your rocket lands out of sight, you may enjoy having a hand-held GPS 
116           receiver, so that you can put in a waypoint for the last reported rocket 
117           position before touch-down.  This makes looking for your rocket a lot like 
118           Geo-Cacheing... just go to the waypoint and look around starting from there.
119         </para>
120         <para>
121           You may also enjoy having a ham radio "HT" that covers the 70cm band... you 
122           can use that with your antenna to direction-find the rocket on the ground 
123           the same way you can use a Walston or Beeline tracker.  This can be handy 
124           if the rocket is hiding in sage brush or a tree, or if the last GPS position 
125           doesn't get you close enough because the rocket dropped into a canyon, or 
126           the wind is blowing it across a dry lake bed, or something like that...  Keith
127           and Bdale both currently own and use the 
128           [Yaesu VX-6R](http://yaesu.com/indexVS.cfm?cmd=DisplayProducts&ProdCatID=111&encProdID=4C6F204F6FEBB5BAFA58BCC1C131EAC0&DivisionID=65&isArchived=0) 
129           at launches.
130         </para>
131         <para>
132           So, to recap, on the ground the hardware you'll need includes:
133           <orderedlist inheritnum='inherit' numeration='arabic'>
134             <listitem> 
135               an antenna and feedline
136             </listitem>
137             <listitem> 
138               a TeleDongle
139             </listitem>
140             <listitem> 
141               a notebook computer
142             </listitem>
143             <listitem> 
144               optionally, a handheld GPS receiver
145             </listitem>
146             <listitem> 
147               optionally, an HT or receiver covering 435 Mhz
148             </listitem>
149           </orderedlist>
150         </para>
151         <para>
152           The best hand-held commercial directional antennas we've found for radio 
153           direction finding rockets are from 
154           [Arrow Antennas](http://www.arrowantennas.com/).  The 440-3 and 440-5 are 
155           both good choices for finding a TeleMetrum-equipped rocket when used with 
156           a suitable 70cm HT.  
157         </para>
158       </section>
159       <section>
160         <title>Data Analysis</title>
161         <para>
162           Our software makes it easy to log the data from each flight, both the 
163           telemetry received over the RF link during the flight itself, and the more
164           complete data log recorded in the DataFlash memory on the TeleMetrum 
165           board.  Once this data is on your computer, our postflight tools make it
166           easy to quickly get to the numbers everyone wants, like apogee altitude, 
167           max acceleration, and max velocity.  You can also generate and view a 
168           standard set of plots showing the altitude, acceleration, and
169           velocity of the rocket during flight.  And you can even export a data file 
170           useable with Google Maps and Google Earth for visualizing the flight path 
171           in two or three dimensions!
172         </para>
173         <para>
174           Our ultimate goal is to emit a set of files for each flight that can be
175           published as a web page per flight, or just viewed on your local disk with 
176           a web browser.
177         </para>
178       </section>
179       <section>
180         <title>Future Plans</title>
181         <para>
182           In the future, we intend to offer "companion boards" for the rocket that will
183           plug in to TeleMetrum to collect additional data, provide more pyro channels,
184           and so forth.  A reference design for a companion board will be documented
185           soon, and will be compatible with open source Arduino programming tools.
186         </para>
187         <para>
188           We are also working on the design of a hand-held ground terminal that will
189           allow monitoring the rocket's status, collecting data during flight, and
190           logging data after flight without the need for a notebook computer on the
191           flight line.  Particularly since it is so difficult to read most notebook
192           screens in direct sunlight, we think this will be a great thing to have.
193         </para>
194         <para>
195           Because all of our work is open, both the hardware designs and the software,
196           if you have some great idea for an addition to the current Altus Metrum family,
197           feel free to dive in and help!  Or let us know what you'd like to see that 
198           we aren't already working on, and maybe we'll get excited about it too... 
199         </para>
200       </section>
201     </section>
202   </chapter>
203 </book>
204