diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/Makefile | 5 | ||||
| -rw-r--r-- | doc/altusmetrum.xsl | 88 | ||||
| -rw-r--r-- | doc/micropeak.xsl | 185 | ||||
| -rw-r--r-- | doc/telemetrum.svg | 33 | ||||
| -rw-r--r-- | doc/telemini.svg | 31 |
5 files changed, 318 insertions, 24 deletions
diff --git a/doc/Makefile b/doc/Makefile index 53985431..59fd4ebb 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -18,6 +18,7 @@ DOC=$(HTML) $(PDF) HTMLSTYLE=/usr/share/xml/docbook/stylesheet/docbook-xsl/html/docbook.xsl FOSTYLE=/usr/share/xml/docbook/stylesheet/docbook-xsl/fo/docbook.xsl PDFSTYLE= +IMAGES=telemetrum.svg telemini.svg .SUFFIXES: .xsl .html .fo .pdf @@ -50,8 +51,8 @@ clean: distclean: rm -f $(HTML) $(PDF) *.fo -altusmetrum.html: $(RELNOTES_XSL) -altusmetrum.fo: $(RELNOTES_XSL) +altusmetrum.html: $(RELNOTES_XSL) $(IMAGES) +altusmetrum.fo: $(RELNOTES_XSL) $(IMAGES) indent: altusmetrum.xsl xmlindent -i 2 < altusmetrum.xsl > altusmetrum.new diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl index 55f02e26..9fdd6b07 100644 --- a/doc/altusmetrum.xsl +++ b/doc/altusmetrum.xsl @@ -22,7 +22,7 @@ <surname>Towns</surname> </author> <copyright> - <year>2012</year> + <year>2013</year> <holder>Bdale Garbee and Keith Packard</holder> </copyright> <legalnotice> @@ -122,7 +122,7 @@ NAR #88757, TRA #12200 support optional capabilities in the future. </para> <para> - The newest device is TeleMini, a dual deploy altimeter with + Our second device was TeleMini, a dual deploy altimeter with radio telemetry and radio direction finding. This device is only 13mm by 38mm (½ inch by 1½ inches) and can fit easily in an 18mm air-frame. @@ -172,8 +172,9 @@ NAR #88757, TRA #12200 <para> The TeleMini battery can be charged by disconnecting it from the TeleMini board and plugging it into a standalone battery charger - board, and connecting that via a USB cable to a laptop or other USB - power source + such as the LipoCharger product included in TeleMini Starter Kits, + and connecting that via a USB cable to a laptop or other USB + power source. </para> <para> The other active device in the starter kit is the TeleDongle USB to @@ -1583,7 +1584,9 @@ NAR #88757, TRA #12200 <title>On the Ground</title> <para> To receive the data stream from the rocket, you need an antenna and short - feed-line connected to one of our <ulink url="http://www.altusmetrum.org/TeleDongle/">TeleDongle</ulink> units. The + feed-line connected to one of our <ulink url="http://www.altusmetrum.org/TeleDongle/">TeleDongle</ulink> units. If possible, use an SMA to BNC + adapter instead of feedline between the antenna feedpoint and + TeleDongle, as this will give you the best performance. The TeleDongle in turn plugs directly into the USB port on a notebook computer. Because TeleDongle looks like a simple serial port, your computer does not require special device drivers... just plug it in. @@ -1620,7 +1623,7 @@ NAR #88757, TRA #12200 So, to recap, on the ground the hardware you'll need includes: <orderedlist inheritnum='inherit' numeration='arabic'> <listitem> - an antenna and feed-line + an antenna and feed-line or adapter </listitem> <listitem> a TeleDongle @@ -1643,7 +1646,9 @@ NAR #88757, TRA #12200 Arrow Antennas. </ulink> The 440-3 and 440-5 are both good choices for finding a - TeleMetrum- or TeleMini- equipped rocket when used with a suitable 70cm HT. + TeleMetrum- or TeleMini- equipped rocket when used with a suitable + 70cm HT. TeleDongle and an SMA to BNC adapter fit perfectly + between the driven element and reflector of Arrow antennas. </para> </section> <section> @@ -1669,22 +1674,36 @@ NAR #88757, TRA #12200 <section> <title>Future Plans</title> <para> - In the future, we intend to offer "companion boards" for the rocket that will - plug in to TeleMetrum to collect additional data, provide more pyro channels, - and so forth. + In the future, we intend to offer "companion boards" for the rocket + that will plug in to TeleMetrum to collect additional data, provide + more pyro channels, and so forth. </para> <para> - We are also working on the design of a hand-held ground terminal that will - allow monitoring the rocket's status, collecting data during flight, and - logging data after flight without the need for a notebook computer on the - flight line. Particularly since it is so difficult to read most notebook - screens in direct sunlight, we think this will be a great thing to have. + Also under design is a new flight computer with more sensors, more + pyro channels, and a more powerful radio system designed for use + in multi-stage, complex, and extreme altitude projects. </para> <para> - Because all of our work is open, both the hardware designs and the software, - if you have some great idea for an addition to the current Altus Metrum family, - feel free to dive in and help! Or let us know what you'd like to see that - we aren't already working on, and maybe we'll get excited about it too... + We are also working on alternatives to TeleDongle. One is a + a stand-alone, hand-held ground terminal that will allow monitoring + the rocket's status, collecting data during flight, and logging data + after flight without the need for a notebook computer on the + flight line. Particularly since it is so difficult to read most + notebook screens in direct sunlight, we think this will be a great + thing to have. We are also working on a TeleDongle variant with + Bluetooth that will work with Android phones and tablets. + </para> + <para> + Because all of our work is open, both the hardware designs and the + software, if you have some great idea for an addition to the current + Altus Metrum family, feel free to dive in and help! Or let us know + what you'd like to see that we aren't already working on, and maybe + we'll get excited about it too... + </para> + <para> + Watch our + <ulink url="http://altusmetrum.org/">web site</ulink> for more news + and information as our family of products evolves! </para> </section> </chapter> @@ -2492,6 +2511,37 @@ NAR #88757, TRA #12200 </para> </appendix> <appendix> + <title>Drill Templates</title> + <para> + These images, when printed, provide precise templates for the + mounting holes in Altus Metrum flight computers + </para> + <section> + <title>TeleMetrum template</title> + <para> + TeleMetrum has overall dimensions of 1.000 x 2.750 inches, and the + mounting holes are sized for use with 4-40 or M3 screws. + </para> + <mediaobject id="TeleMetrumTemplate"> + <imageobject> + <imagedata format="SVG" fileref="telemetrum.svg"/> + </imageobject> + </mediaobject> + </section> + <section> + <title>TeleMini template</title> + <para> + TeleMini has overall dimensions of 0.500 x 1.500 inches, and the + mounting holes are sized for use with 2-56 or M2 screws. + </para> + <mediaobject id="TeleMiniTemplate"> + <imageobject> + <imagedata format="SVG" fileref="telemini.svg"/> + </imageobject> + </mediaobject> + </section> + </appendix> + <appendix> <title>Calibration</title> <para> There are only two calibrations required for a TeleMetrum board, and diff --git a/doc/micropeak.xsl b/doc/micropeak.xsl index aa1adaef..2120acb2 100644 --- a/doc/micropeak.xsl +++ b/doc/micropeak.xsl @@ -3,7 +3,7 @@ "/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd"> <book> <title>MicroPeak Owner's Manual</title> - <subtitle>A peak-recording altimeter for hobby rocketry</subtitle> + <subtitle>A recording altimeter for hobby rocketry</subtitle> <bookinfo> <author> <firstname>Keith</firstname> @@ -44,6 +44,15 @@ Add comments about EEPROM storage format and programming jig. </revremark> </revision> + <revision> + <revnumber>1.2</revnumber> + <date>20 January 2013</date> + <revremark> + Add documentation for the MicroPeak USB adapter board. Note + the switch to a Kalman filter for peak altitude + determination. + </revremark> + </revision> </revhistory> </bookinfo> <acknowledgements> @@ -176,6 +185,176 @@ NAR #88757, TRA #12200 </para> </chapter> <chapter> + <title>The MicroPeak USB adapter</title> + <para> + MicroPeak stores barometric pressure information for the first + 48 seconds of the flight in on-board non-volatile memory. The + contents of this memory can be downloaded to a computer using + the MicroPeak USB adapter. + </para> + <section> + <title>Installing the MicroPeak software</title> + <para> + The MicroPeak application runs on Linux, Mac OS X and + Windows. You can download the latest version from + <ulink url="http://altusmetrum.org/AltOS"/>. + </para> + <para> + On Mac OS X and Windows, the FTDI USB device driver needs to + be installed. A compatible version of this driver is included + with the MicroPeak application, but you may want to download a + newer version from <ulink + url="http://www.ftdichip.com/FTDrivers.htm"/>. + </para> + </section> + <section> + <title>Downloading Micro Peak data</title> + <itemizedlist> + <listitem> + <para> + Connect the MicroPeak USB adapter to a USB cable and plug it + in to your computer. + </para> + </listitem> + <listitem> + <para> + Start the MicroPeak application, locate the File menu and + select the Download entry. + </para> + </listitem> + <listitem> + <para> + The MicroPeak USB adapter has a small phototransistor on the + end of the board furthest from the USB connector. Locate + this and place the LED on the MicroPeak right over + it. Turn on the MicroPeak board and adjust the position + until the blue LED on the MicroPeak USB adapter blinks in + time with the orange LED on the MicroPeak board. + </para> + </listitem> + <listitem> + <para> + After the maximum flight height is reported, MicroPeak will + pause for a few seconds, blink the LED four times rapidly + and then send the data in one long blur on the LED. The + MicroPeak application should receive the data. When it does, + it will present the data in a graph and offer to save the + data to a file. If not, you can power cycle the MicroPeak + board and try again. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Analyzing MicroPeak Data</title> + <para> + The MicroPeak application can present flight data in the form + of a graph, a collection of computed statistics or in tabular + form. + </para> + <para> + MicroPeak collects raw barometric pressure data which is + then used to compute the remaining data. Altitude is computed + through a standard atmospheric model. Absolute error in this + data will be affected by local atmospheric + conditions. Fortunately, these errors tend to mostly cancel + out, so the error in the height computation is much smaller + than the error in altitude would be. + </para> + <para> + Speed and acceleration are computed by first smoothing the + height data with a Gaussian window averaging filter. For speed + data, this average uses seven samples. For acceleration data, + eleven samples are used. These were chosen to provide + reasonably smooth speed and acceleration data, which would + otherwise be swamped with noise. + </para> + <para> + Under the Graph tab, the height, speed and acceleration values + are displayed together. You can zoom in on the graph by + clicking and dragging to sweep out an area of + interest. Right-click on the plot to bring up a menu that will + let you save, copy or print the graph. + </para> + <para> + The Statistics tab presents overall data from the flight. Note + that the Maximum height value is taken from the minumum + pressure captured in flight, and may be different from the + apparant apogee value as the on-board data are sampled twice + as fast as the recorded values, or because the true apogee + occurred after the on-board memory was full. Each value is + presented in several units as appropriate. + </para> + <para> + A table consisting of the both the raw barometric pressure + data and values computed from that for each recorded time. + </para> + <para> + The File menu has operations to open existing flight logs, + Download new data from MicroPeak, Save a copy of the flight + log to a new file, Export the tabular data (as seen in the Raw + Data tab) to a file, change the application Preferences, Close + the current window or close all windows and Exit the + application. + </para> + </section> + <section> + <title>Configuring the MicroPeak application</title> + <para> + The MicroPeak application has a few user settings which are + configured through the Preferences dialog, which can be + accessed from the File menu. + <itemizedlist> + <listitem> + <para> + The Log Directory is where flight data will be saved to + and loaded from by default. Of course, you can always + navigate to other directories in the file chooser windows, + this setting is just the starting point. + </para> + </listitem> + <listitem> + <para> + If you prefer to see your graph data in feet and + miles per hour instead of meters and meters per second, + you can select Imperial Units. + </para> + </listitem> + <listitem> + <para> + To see what data is actually arriving over the serial + port, start the MicroPeak application from a command + prompt and select the Serial Debug option. This can be + useful in debugging serial communication problems, but + most people need never choose this. + </para> + </listitem> + <listitem> + <para> + You can adjust the size of the text in the Statistics tab + by changing the Font size preference. There are three + settings, with luck one will both fit on your screen and + provide readable values. + </para> + </listitem> + <listitem> + <para> + The Look & feel menu shows a list of available + application appearance choices. By default, the MicroPeak + application tries to blend in with other applications, but + you may choose some other appearance if you like. + </para> + </listitem> + </itemizedlist> + </para> + <para> + Note that MicroPeak shares a subset of the AltosUI + preferences, so if you use both of these applications, change + in one application will affect the other. + </para> + </section> + </chapter> + <chapter> <title>Technical Information</title> <section> <title>Barometric Sensor</title> @@ -193,8 +372,8 @@ NAR #88757, TRA #12200 <para> Ground pressure is computed from an average of 16 samples, taken while the altimeter is at rest. Flight pressure is - computed from an exponential IIR filter designed to smooth out - transients caused by mechanical stress on the barometer. + computed from a Kalman filter designed to smooth out any minor + noise in the sensor values. </para> </section> <section> diff --git a/doc/telemetrum.svg b/doc/telemetrum.svg new file mode 100644 index 00000000..97c4e4a8 --- /dev/null +++ b/doc/telemetrum.svg @@ -0,0 +1,33 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + width="5in" + height="2.5in" + viewBox="0 0 500 250" + preserveaspectratio="none" + id="svg2" + version="1.1"> + <g transform="translate(112.5,75)" + style="fill:none;stroke:#000000;stroke-width:1;stroke-linejoin:miter;font-family:Frutiger LT Std"> + <!-- outline --> + <rect width="275" height="100" x="0" y="0"/> + <!-- holes --> + <path d="M37.5,12.5 m-6.25,0 a6.25,6.25,0,1,0,12.5,0 a6.25,6.25,0,1,0,-12.5,0 l12.5,0 m-6.25,-6.25 l0,12.5"/> + <path d="M262.5,12.5 m-6.25,0 a6.25,6.25,0,1,0,12.5,0 a6.25,6.25,0,1,0,-12.5,0 l12.5,0 m-6.25,-6.25 l0,12.5"/> + <path d="M37.5,87.5 m-6.25,0 a6.25,6.25,0,1,0,12.5,0 a6.25,6.25,0,1,0,-12.5,0 l12.5,0 m-6.25,-6.25 l0,12.5"/> + <path d="M262.5,87.5 m-6.25,0 a6.25,6.25,0,1,0,12.5,0 a6.25,6.25,0,1,0,-12.5,0 l12.5,0 m-6.25,-6.25 l0,12.5"/> + <!-- arrow --> + <path d="M50,50 l165,0"/> + <path style="fill:#000000;stroke:none" d="M215,45 l10,5 l-10,5 z"/> + <!-- label --> + <text x="137.5" y="45" style="fill:#000000;stroke:none" text-anchor="middle">TeleMetrum</text> + <g transform="rotate(90)"> + <text x="50" y="-235" style="fill:#000000;stroke:none" text-anchor="middle">UP</text> + </g> + </g> +</svg>
\ No newline at end of file diff --git a/doc/telemini.svg b/doc/telemini.svg new file mode 100644 index 00000000..d07b4971 --- /dev/null +++ b/doc/telemini.svg @@ -0,0 +1,31 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + width="5in" + height="2in" + viewBox="0 0 500 200" + preserveaspectratio="none" + id="svg2" + version="1.1"> + <g transform="translate(175,75)" + style="fill:none;stroke:#000000;stroke-width:1;stroke-linejoin:miter;font-family:Frutiger LT Std"> + <!-- outline --> + <rect width="150" height="50" x="0" y="0"/> + <!-- holes --> + <path d="M135,10 A5,5,0,1,0,145,10 A5,5,0,1,0,135,10 M135,10 l10,0 M140,5 l0,10"/> + <path d="M135,40 A5,5,0,1,0,145,40 A5,5,0,1,0,135,40 M135,40 l10,0 M140,35 l0,10"/> + <!-- arrow --> + <path d="M25,25 l90,0"/> + <path style="fill:#000000;stroke:none" d="M115,20 l10,5 l-10,5 z"/> + <!-- label --> + <text x="75" y="20" style="fill:#000000;stroke:none" text-anchor="middle">TeleMini</text> + <g transform="rotate(90)"> + <text x="25" y="-130" style="fill:#000000;stroke:none" text-anchor="middle">UP</text> + </g> + </g> +</svg>
\ No newline at end of file |
