fix typo in url
[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         <ulink url="http://yaesu.com/indexVS.cfm?cmd=DisplayProducts&ProdCatID=111&encProdID=4C6F204F6FEBB5BAFA58BCC1C131EAC0&DivisionID=65&isArchived=0">
129           Yaesu VX-6R
130         </ulink>
131           at launches.
132         </para>
133         <para>
134           So, to recap, on the ground the hardware you'll need includes:
135           <orderedlist inheritnum='inherit' numeration='arabic'>
136             <listitem> 
137               an antenna and feedline
138             </listitem>
139             <listitem> 
140               a TeleDongle
141             </listitem>
142             <listitem> 
143               a notebook computer
144             </listitem>
145             <listitem> 
146               optionally, a handheld GPS receiver
147             </listitem>
148             <listitem> 
149               optionally, an HT or receiver covering 435 Mhz
150             </listitem>
151           </orderedlist>
152         </para>
153         <para>
154           The best hand-held commercial directional antennas we've found for radio 
155           direction finding rockets are from 
156         <ulink url="http://www.arrowantennas.com/" >
157           Arrow Antennas.
158         </ulink>
159 The 440-3 and 440-5 are both good choices for finding a 
160 TeleMetrum-equipped rocket when used with a suitable 70cm HT.  
161         </para>
162       </section>
163       <section>
164         <title>Data Analysis</title>
165         <para>
166           Our software makes it easy to log the data from each flight, both the 
167           telemetry received over the RF link during the flight itself, and the more
168           complete data log recorded in the DataFlash memory on the TeleMetrum 
169           board.  Once this data is on your computer, our postflight tools make it
170           easy to quickly get to the numbers everyone wants, like apogee altitude, 
171           max acceleration, and max velocity.  You can also generate and view a 
172           standard set of plots showing the altitude, acceleration, and
173           velocity of the rocket during flight.  And you can even export a data file 
174           useable with Google Maps and Google Earth for visualizing the flight path 
175           in two or three dimensions!
176         </para>
177         <para>
178           Our ultimate goal is to emit a set of files for each flight that can be
179           published as a web page per flight, or just viewed on your local disk with 
180           a web browser.
181         </para>
182       </section>
183       <section>
184         <title>Future Plans</title>
185         <para>
186           In the future, we intend to offer "companion boards" for the rocket that will
187           plug in to TeleMetrum to collect additional data, provide more pyro channels,
188           and so forth.  A reference design for a companion board will be documented
189           soon, and will be compatible with open source Arduino programming tools.
190         </para>
191         <para>
192           We are also working on the design of a hand-held ground terminal that will
193           allow monitoring the rocket's status, collecting data during flight, and
194           logging data after flight without the need for a notebook computer on the
195           flight line.  Particularly since it is so difficult to read most notebook
196           screens in direct sunlight, we think this will be a great thing to have.
197         </para>
198         <para>
199           Because all of our work is open, both the hardware designs and the software,
200           if you have some great idea for an addition to the current Altus Metrum family,
201           feel free to dive in and help!  Or let us know what you'd like to see that 
202           we aren't already working on, and maybe we'll get excited about it too... 
203         </para>
204       </section>
205     </section>
206   </chapter>
207 </book>
208