Doc updates for version 1.8.4
[fw/altos] / doc / using-am-products.inc
1 == Using Altus Metrum Products
2
3         ifdef::radio[]
4         === Being Legal
5
6                 In the US, you need an
7                 link:http://www.altusmetrum.org/Radio/[amateur radio license]
8                 or other authorization to legally operate the radio
9                 transmitters that are part of our products.
10         endif::radio[]
11
12
13         === In the Rocket
14
15                 In the rocket itself, you just need a flight computer
16                 and a single-cell, 3.7 volt nominal Li-Po rechargeable
17                 battery.
18                 ifdef::telemetrum,telemega,easymega[]
19                 An 850mAh battery weighs less than a 9V
20                 alkaline battery, and will run a TeleMetrum, TeleMega
21                 or EasyMega for hours.
22                 endif::telemetrum,telemega,easymega[]
23                 A 110mAh battery weighs less
24                 than a triple A battery and is a good choice for use
25                 with
26                 ifdef::telemini[TeleMini or]
27                 EasyMini.
28
29                 ifdef::radio[]
30                 By default, we ship TeleMini, TeleMetrum and TeleMega
31                 flight computers with a simple wire antenna.  If your
32                 electronics bay or the air-frame it resides within is
33                 made of carbon fiber, which is opaque to RF signals,
34                 you may prefer to install an SMA connector so that you
35                 can run a coaxial cable to an antenna mounted
36                 elsewhere in the rocket.  However, note that the GPS
37                 antenna is fixed on all current products, so you
38                 really want to install the flight computer in a bay
39                 made of RF-transparent materials if at all possible.
40                 endif::radio[]
41
42         === On the Ground
43
44                 ifdef::radio[]
45                 To receive the data stream from the rocket, you need
46                 an antenna and short feed-line connected to one of our
47                 link:http://www.altusmetrum.org/TeleDongle/[TeleDongle]
48                 units.  If possible, use an SMA to BNC adapter instead
49                 of feedline between the antenna feedpoint and
50                 TeleDongle, as this will give you the best
51                 performance.  The TeleDongle in turn plugs directly
52                 into the USB port on a notebook computer.  Because
53                 TeleDongle looks like a simple serial port, your
54                 computer does not require special device
55                 drivers... just plug it in.
56                 endif::radio[]
57
58                 The GUI tool, AltosUI, is written in Java and runs
59                 across Linux, Mac OS and Windows. There's also a suite
60                 of C tools for Linux which can perform most of the
61                 same tasks.
62
63                 ifdef::radio[]
64                 Alternatively, a TeleBT attached with an SMA to BNC
65                 adapter at the feed point of a hand-held yagi used in
66                 conjunction with an Android device running AltosDroid
67                 makes an outstanding ground station.
68                 endif::radio[]
69
70                 After the flight,
71                 ifdef::radio[]
72                 you can use the radio link to
73                 extract the more detailed data logged in either
74                 TeleMetrum or TeleMini devices, or
75                 endif::radio[]
76                 you can use a
77                 USB cable to plug into the flight computer board directly.
78                 A USB cable is also how you
79                 charge the Li-Po battery, so you'll want one of those
80                 anyway. The same cable used by lots of digital
81                 cameras and other modern electronic stuff will work
82                 fine.
83
84                 ifdef::gps[]
85                 If your rocket lands out of sight, you may enjoy
86                 having a hand-held GPS receiver, so that you can put
87                 in a way-point for the last reported rocket position
88                 before touch-down.  This makes looking for your rocket
89                 a lot like Geo-Caching... just go to the way-point and
90                 look around starting from there.  AltosDroid on an
91                 Android device with GPS receiver works great for this,
92                 too!
93                 endif::gps[]
94
95                 ifdef::radio[]
96                 You may also enjoy having a ham radio “HT” that covers
97                 the 70cm band... you can use that with your antenna to
98                 direction-find the rocket on the ground the same way
99                 you can use a Walston or Beeline tracker.  This can be
100                 handy if the rocket is hiding in sage brush or a tree,
101                 or if the last GPS position doesn't get you close
102                 enough because the rocket dropped into a canyon, or
103                 the wind is blowing it across a dry lake bed, or
104                 something like that...  Keith currently uses a Yaesu
105                 FT1D, Bdale has a Yaesu VX-7R, which is a nicer radio
106                 in most ways but doesn't support APRS.
107
108                 So, to recap, on the ground the hardware you'll need includes:
109
110                 . an antenna and feed-line or adapter
111                 . a TeleDongle
112                 . a notebook computer
113                 . optionally, a hand-held GPS receiver
114                 . optionally, an HT or receiver covering 435 MHz
115
116                 The best hand-held commercial directional antennas we've found for radio
117                 direction finding rockets are from
118                 link:http://www.arrowantennas.com/[Arrow Antennas].
119
120                 The 440-3 and 440-5 are both good choices for finding
121                 a TeleMetrum- or TeleMini- equipped rocket when used
122                 with a suitable 70cm HT.  TeleDongle and an SMA to BNC
123                 adapter fit perfectly between the driven element and
124                 reflector of Arrow antennas.
125                 endif::radio[]
126
127         === Data Analysis
128
129                 Our software makes it easy to log the data from each
130                 flight, both the telemetry received during the flight
131                 itself, and the more complete data log recorded in the
132                 flash memory on the altimeter board.  Once this data
133                 is on your computer, our post-flight tools make it
134                 easy to quickly get to the numbers everyone wants,
135                 like apogee altitude, max acceleration, and max
136                 velocity.  You can also generate and view a standard
137                 set of plots showing the altitude, acceleration, and
138                 velocity of the rocket during flight.  And you can
139                 even export a flight log in a format usable with Google
140                 Maps and Google Earth for visualizing the flight path
141                 in two or three dimensions!
142
143                 Our ultimate goal is to emit a set of files for each
144                 flight that can be published as a web page per flight,
145                 or just viewed on your local disk with a web browser.
146
147         === Future Plans
148
149                 ifdef::telemetrum,telemega,easymega[]
150                 We have designed and prototyped several “companion
151                 boards” that can attach to the companion connector on
152                 TeleMetrum, TeleMega and EasyMega flight computers to
153                 collect more data, provide more pyro channels, and so
154                 forth.  We do not yet know if or when any of these
155                 boards will be produced in enough quantity to sell.
156                 If you have specific interests for data collection or
157                 control of events in your rockets beyond the
158                 capabilities of our existing productions, please let
159                 us know!
160                 endif::telemetrum,telemega,easymega[]
161
162                 Because all of our work is open, both the hardware
163                 designs and the software, if you have some great idea
164                 for an addition to the current Altus Metrum family,
165                 feel free to dive in and help!  Or let us know what
166                 you'd like to see that we aren't already working on,
167                 and maybe we'll get excited about it too...
168
169                 Watch our link:http://altusmetrum.org/[web site] for
170                 more news and information as our family of products
171                 evolves!