From: Keith Packard <keithp@keithp.com>
Date: Thu, 29 May 2014 02:45:01 +0000 (-0700)
Subject: doc: Add outline of TeleGPS doc
X-Git-Tag: 1.3.2.2~51
X-Git-Url: https://git.gag.com/?p=fw%2Faltos;a=commitdiff_plain;h=47ff6f7528e3984012e874f91ea4f5c1d68cb465

doc: Add outline of TeleGPS doc

No actual content, mostly a place holder to make the build work

Signed-off-by: Keith Packard <keithp@keithp.com>
---

diff --git a/doc/Makefile b/doc/Makefile
index 1f47076c..05a49927 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -62,8 +62,8 @@ SVG=\
 	telemini.svg
 
 RELNOTES_XSL=$(RELNOTES:.html=.xsl)
-HTML=altusmetrum.html altos.html telemetry.html companion.html micropeak.html $(RELNOTES)
-PDF=altusmetrum.pdf altos.pdf telemetry.pdf companion.pdf micropeak.pdf \
+HTML=altusmetrum.html altos.html telemetry.html companion.html micropeak.html telegps.html $(RELNOTES)
+PDF=altusmetrum.pdf altos.pdf telemetry.pdf companion.pdf micropeak.pdf telegps.pdf \
 	telemetrum-outline.pdf telemega-outline.pdf easymini-outline.pdf
 HTMLSTYLE=/usr/share/xml/docbook/stylesheet/docbook-xsl/html/docbook.xsl
 FOSTYLE=xorg-fo.xsl
diff --git a/doc/telegps.xsl b/doc/telegps.xsl
new file mode 100644
index 00000000..534b39a1
--- /dev/null
+++ b/doc/telegps.xsl
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">
+<book>
+  <title>TeleGPS Owner's Manual</title>
+  <subtitle>A recording GPS tracker</subtitle>
+  <bookinfo>
+    <author>
+      <firstname>Keith</firstname>
+      <surname>Packard</surname>
+    </author>
+    <copyright>
+      <year>2014</year>
+      <holder>Bdale Garbee and Keith Packard</holder>
+    </copyright>
+    <mediaobject>
+      <imageobject>
+	<imagedata fileref="micropeak-dime.jpg" width="6in"/>
+      </imageobject>
+    </mediaobject>
+    <legalnotice>
+      <para>
+        This document is released under the terms of the
+        <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">
+          Creative Commons ShareAlike 3.0
+        </ulink>
+        license.
+      </para>
+    </legalnotice>
+    <revhistory>
+      <revision>
+	<revnumber>1.0</revnumber>
+	<date>28 May 2014</date>
+	<revremark>
+	  Initial release with preliminary hardware.
+	</revremark>
+      </revision>
+    </revhistory>
+  </bookinfo>
+  <dedication>
+    <title>Acknowledgements</title>
+    <para>
+      Have fun using these products, and we hope to meet all of you
+      out on the rocket flight line somewhere.
+      <literallayout>
+Bdale Garbee, KB0G
+NAR #87103, TRA #12201
+
+Keith Packard, KD7SQG
+NAR #88757, TRA #12200
+      </literallayout>
+    </para>
+  </dedication>
+  <chapter>
+    <title>Quick Start Guide</title>
+    <para>
+      TeleGPS is designed to be easy to use. Requiring no external
+      components, flying takes just a few steps.
+    </para>
+  </chapter>
+  <chapter>
+    <title>Handling Precautions</title>
+    <para>
+      All Altus Metrum products are sophisticated electronic devices.  
+      When handled gently and properly installed in an air-frame, they
+      will deliver impressive results.  However, as with all electronic 
+      devices, there are some precautions you must take.
+    </para>
+    <para>
+      The Lithium polymer batteries have an
+      extraordinary power density.  This is great because we can fly with
+      much less battery mass... but if they are punctured
+      or their contacts are allowed to short, they can and will release their
+      energy very rapidly!
+      Thus we recommend that you take some care when handling TeleGPS
+      to keep conductive material from coming in contact with the exposed metal elements.
+    </para>
+    <para>
+      As with all other rocketry electronics, Altus Metrum devices must 
+      be protected from exposure to corrosive motor exhaust and ejection 
+      charge gasses.
+    </para>
+  </chapter>
+  <chapter>
+    <title>Technical Information</title>
+    <section>
+      <title>GPS Receiver</title>
+      <para>
+	TeleGPS uses the u-Blox Max-7Q GPS receiver.
+      </para>
+    </section>
+    <section>
+      <title>Micro-controller</title>
+      <para>
+	TeleGPS uses an NXP LPC11U14 micro-controller. This tiny
+	CPU contains 32kB of flash for the application and 4kB of RAM for
+	temporary data storage.
+      </para>
+    </section>
+    <section>
+      <title>Lithium Polymer Battery</title>
+      <para>
+	Shipping restrictions may prevent us from including a battery
+	battery with TeleGPS.
+      </para>
+    </section>
+    <section>
+      <title>Mechanical Considerations</title>
+      <para>
+	TeleGPS is designed to be rugged enough for typical rocketry
+	applications. 
+      </para>
+    </section>
+    <section>
+      <title>On-board data storage</title>
+      <para>
+	TeleGPS has some bytes of non-volatile storage, separate
+	from the code storage memory. The TeleGPS firmware uses this
+	to store information about the last completed
+	flight.
+      </para>
+    </section>
+  </chapter>
+</book>
+<!--  LocalWords:  Altusmetrum TeleGPS
+-->