X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=doc%2Faltusmetrum.xsl;h=c71e08a7dc2ddec4530fd9dc7909019675bda403;hb=c35ea586b9e792c45b287924fd256928308d9a36;hp=da6ad02ce8dcbff5fc3d75e56986c8c9a2d425bb;hpb=1d093383fe58fc8c8c11e1c7cd1cd929ae1bd9e4;p=fw%2Faltos
diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl
index da6ad02c..c71e08a7 100644
--- a/doc/altusmetrum.xsl
+++ b/doc/altusmetrum.xsl
@@ -546,11 +546,13 @@ NAR #88757, TRA #12200
TeleMetrum
-
-
-
-
-
+
+
+
+
+
+
+
TeleMetrum is a 1 inch by 2¾ inch circuit board. It was designed to
fit inside coupler for 29mm air-frame tubing, but using it in a tube that
@@ -566,11 +568,13 @@ NAR #88757, TRA #12200
TeleMini
-
-
-
-
-
+
+
+
+
+
+
+
TeleMini v1.0 is ½ inches by 1½ inches. It was
designed to fit inside an 18mm air-frame tube, but using it in
@@ -585,11 +589,13 @@ NAR #88757, TRA #12200
the board, meaning an ideal âsimpleâ avionics bay for TeleMini
should have at least 9 inches of interior length.
-
-
-
-
-
+
+
+
+
+
+
+
TeleMini v2.0 is 0.8 inches by 1½ inches. It adds more
on-board data logging memory, a built-in USB connector and
@@ -600,11 +606,13 @@ NAR #88757, TRA #12200
EasyMini
-
-
-
-
-
+
+
+
+
+
+
+
EasyMini is built on a 0.8 inch by 1½ inch circuit board. It's
designed to fit in a 24mm coupler tube. The connectors and
@@ -614,11 +622,13 @@ NAR #88757, TRA #12200
TeleMega
-
-
-
-
-
+
+
+
+
+
+
+
TeleMega is a 1¼ inch by 3¼ inch circuit board. It was
designed to easily fit in a 38mm coupler. Like TeleMetrum,
@@ -825,17 +835,144 @@ NAR #88757, TRA #12200
the altimeter completes initialization and self test, and decides
which mode to enter next.
+
+ Here's a short summary of all of the modes and the beeping (or
+ flashing, in the case of TeleMini v1) that accompanies each
+ mode. In the description of the beeping pattern, âditâ means a
+ short beep while "dah" means a long beep (three times as
+ long). âBrapâ means a long dissonant tone.
+
+ AltOS Modes
+
+
+
+
+
+
+
+
+ Mode Name
+ Abbreviation
+ Beeps
+ Description
+
+
+
+
+ Startup
+ S
+ dit dit dit
+
+
+ Calibrating sensors, detecting orientation.
+
+
+
+
+ Idle
+ I
+ dit dit
+
+
+ Ready to accept commands over USB or radio link.
+
+
+
+
+ Pad
+ P
+ dit dah dah dit
+
+
+ Waiting for launch. Not listening for commands.
+
+
+
+
+ Boost
+ B
+ dah dit dit dit
+
+
+ Accelerating upwards.
+
+
+
+
+ Fast
+ F
+ dit dit dah dit
+
+
+ Decellerating, but moving faster than 200m/s.
+
+
+
+
+ Coast
+ C
+ dah dit dah dit
+
+
+ Decellerating, moving slower than 200m/s
+
+
+
+
+ Drogue
+ D
+ dah dit dit
+
+
+ Descending after apogee. Above main height.
+
+
+
+
+ Main
+ M
+ dah dah
+
+
+ Descending. Below main height.
+
+
+
+
+ Landed
+ L
+ dit dah dit dit
+
+
+ Stable altitude for at least ten seconds.
+
+
+
+
+ Sensor error
+ X
+ dah dit dit dah
+
+
+ Error detected during sensor calibration.
+
+
+
+
+
+
+
In flight or âpadâ mode, the altimeter engages the flight
- state machine, goes into transmit-only mode to
- send telemetry, and waits for launch to be detected.
- Flight mode is indicated by an âdi-dah-dah-ditâ (âPâ for pad)
- on the beeper or lights, followed by beeps or flashes
- indicating the state of the pyrotechnic igniter continuity.
- One beep/flash indicates apogee continuity, two beeps/flashes
- indicate main continuity, three beeps/flashes indicate both
- apogee and main continuity, and one longer âbrapâ sound or
- rapidly alternating lights indicates no continuity. For a
+ state machine, goes into transmit-only mode to send telemetry,
+ and waits for launch to be detected. Flight mode is indicated
+ by an âdi-dah-dah-ditâ (âPâ for pad) on the beeper or lights,
+ followed by beeps or flashes indicating the state of the
+ pyrotechnic igniter continuity. One beep/flash indicates
+ apogee continuity, two beeps/flashes indicate main continuity,
+ three beeps/flashes indicate both apogee and main continuity,
+ and one longer âbrapâ sound which is made by rapidly
+ alternating between two tones indicates no continuity. For a
dual deploy flight, make sure you're getting three beeps or
flashes before launching! For apogee-only or motor eject
flights, do what makes sense.
@@ -852,6 +989,93 @@ NAR #88757, TRA #12200
data from the on-board storage chip after flight, and for
ground testing pyro charges.
+
+ In âIdleâ and âPadâ modes, once the mode indication
+ beeps/flashes and continuity indication has been sent, if
+ there is no space available to log the flight in on-board
+ memory, the flight computer will emit a warbling tone (much
+ slower than the âno continuity toneâ)
+
+
+ Here's a summary of all of the âpadâ and âidleâ mode indications.
+
+ Pad/Idle Indications
+
+
+
+
+
+
+
+ Name
+ Beeps
+ Description
+
+
+
+
+ Neither
+ brap
+
+
+ No continuity detected on either apogee or main
+ igniters.
+
+
+
+
+ Apogee
+ dit
+
+
+ Continuity detected only on apogee igniter.
+
+
+
+
+ Main
+ dit dit
+
+
+ Continuity detected only on main igniter.
+
+
+
+
+ Both
+ dit dit dit
+
+
+ Continuity detected on both igniters.
+
+
+
+
+ Storage Full
+ warble
+
+
+ On-board data logging storage is full. This will
+ not prevent the flight computer from safely
+ controlling the flight or transmitting telemetry
+ signals, but no record of the flight will be
+ stored in on-board flash.
+
+
+
+
+
+
+
+
+ Once landed, the flight computer will signal that by emitting
+ the âLandedâ sound described above, after which it will beep
+ out the apogee height (in meters). Each digit is represented
+ by a sequence of short âditâ beeps, with a pause between
+ digits. A zero digit is represented with one long âdahâ
+ beep. The flight computer will continue to report landed mode
+ and beep out the maximum height until turned off.
+
One âneat trickâ of particular value when TeleMetrum or TeleMega are used with
very large air-frames, is that you can power the board up while the
@@ -1350,8 +1574,14 @@ NAR #88757, TRA #12200
-
AltosUI
+
+
+
+
+
+
+
The AltosUI program provides a graphical user interface for
interacting with the Altus Metrum product family. AltosUI can
@@ -1370,6 +1600,13 @@ NAR #88757, TRA #12200
AltosUI will create a window to display telemetry data as
received by the selected TeleDongle device.
+
+
+
+
+
+
+
All telemetry data received are automatically recorded in
suitable log files. The name of the files includes the current
@@ -1438,6 +1675,13 @@ NAR #88757, TRA #12200
Launch Pad
+
+
+
+
+
+
+
The 'Launch Pad' tab shows information used to decide when the
rocket is ready for flight. The first elements include red/green
@@ -1530,6 +1774,13 @@ NAR #88757, TRA #12200
Ascent
+
+
+
+
+
+
+
This tab is shown during Boost, Fast and Coast
phases. The information displayed here helps monitor the
@@ -1556,6 +1807,13 @@ NAR #88757, TRA #12200
Descent
+
+
+
+
+
+
+
Once the rocket has reached apogee and (we hope) activated the
apogee charge, attention switches to tracking the rocket on
@@ -1592,6 +1850,13 @@ NAR #88757, TRA #12200
Landed
+
+
+
+
+
+
+
Once the rocket is on the ground, attention switches to
recovery. While the radio signal is often lost once the
@@ -1627,8 +1892,32 @@ NAR #88757, TRA #12200
graph window for the current flight.
+
+ Table
+
+
+
+
+
+
+
+
+ The table view shows all of the data available from the
+ flight computer. Probably the most useful data on
+ this tab is the detailed GPS information, which includes
+ horizontal dilution of precision information, and
+ information about the signal being received from the satellites.
+
+
Site Map
+
+
+
+
+
+
+
When the TeleMetrum has a GPS fix, the Site Map tab will map
the rocket's position to make it easier for you to locate the
@@ -1712,50 +2001,28 @@ NAR #88757, TRA #12200
.eeprom file containing flight data saved from
flash memory.
+
+ Note that telemetry files will generally produce poor graphs
+ due to the lower sampling rate and missed telemetry packets.
+ Use saved flight data in .eeprom files for graphing where possible.
+
Once a flight record is selected, a window with multiple tabs is
opened.
-
-
- Flight Graph
-
-
- By default, the graph contains acceleration (blue),
- velocity (green) and altitude (red).
-
-
-
-
- Configure Graph
-
-
- This selects which graph elements to show, and, at the
- very bottom, lets you switch between metric and
- imperial units
-
-
-
-
- Flight Statistics
-
-
- Shows overall data computed from the flight.
-
-
-
-
- Map
-
-
- Shows a satellite image of the flight area overlaid
- with the path of the flight. The red concentric
- circles mark the launch pad, the black concentric
- circles mark the landing location.
-
-
-
-
+
+ Flight Graph
+
+
+
+
+
+
+
+
+ By default, the graph contains acceleration (blue),
+ velocity (green) and altitude (red).
+
The graph can be zoomed into a particular area by clicking and
dragging down and to the right. Once zoomed, the graph can be
@@ -1764,11 +2031,51 @@ NAR #88757, TRA #12200
The right mouse button causes a pop-up menu to be displayed, giving
you the option save or print the plot.
-
- Note that telemetry files will generally produce poor graphs
- due to the lower sampling rate and missed telemetry packets.
- Use saved flight data in .eeprom files for graphing where possible.
-
+
+
+ Configure Graph
+
+
+
+
+
+
+
+
+ This selects which graph elements to show, and, at the
+ very bottom, lets you switch between metric and
+ imperial units
+
+
+
+ Flight Statistics
+
+
+
+
+
+
+
+
+ Shows overall data computed from the flight.
+
+
+
+ Map
+
+
+
+
+
+
+
+
+ Shows a satellite image of the flight area overlaid
+ with the path of the flight. The red concentric
+ circles mark the launch pad, the black concentric
+ circles mark the landing location.
+
+
Export Data
@@ -1812,6 +2119,13 @@ NAR #88757, TRA #12200
Configure Altimeter
+
+
+
+
+
+
+
Select this button and then select either an altimeter or
TeleDongle Device from the list provided. Selecting a TeleDongle
@@ -2028,6 +2342,13 @@ NAR #88757, TRA #12200
Configure Pyro Channels
+
+
+
+
+
+
+
This opens a separate window to configure the additional
pyro channels available on TeleMega. One column is
@@ -2055,6 +2376,13 @@ NAR #88757, TRA #12200
Configure AltosUI
+
+
+
+
+
+
+
This button presents a dialog so that you can configure the AltosUI global settings.
@@ -2066,18 +2394,24 @@ NAR #88757, TRA #12200
the current flight status. However, sometimes you don't want
to hear them.
-
-
- Enableâturns all voice announcements on and off
-
-
-
- Test VoiceâPlays a short message allowing you to verify
- that the audio system is working and the volume settings
- are reasonable
-
-
-
+
+
+ Enable
+
+ Turns all voice announcements on and off
+
+
+
+ Test Voice
+
+
+ Plays a short message allowing you to verify
+ that the audio system is working and the volume settings
+ are reasonable
+
+
+
+
Log Directory
@@ -2152,6 +2486,13 @@ NAR #88757, TRA #12200
Configure Groundstation
+
+
+
+
+
+
+
Select this button and then select a TeleDongle Device from the list provided.
@@ -2237,46 +2578,16 @@ NAR #88757, TRA #12200
(self programming). Please read the directions for flashing
devices in the Updating Device Firmware chapter below.
-
- For âself programmingâ, connect USB to the device to be
- programmed and push the 'Flash Image' button. That will
- present a dialog box listing all of the connected
- devices. Carefully select the device to be programmed.
-
-
- For âpair programmingâ, once you have the programmer and
- target devices connected, push the 'Flash Image' button. That
- will present a dialog box listing all of the connected
- devices. Carefully select the programmer device, not the
- device to be programmed.
-
-
- Next, select the image to flash to the device. These are named
- with the product name and firmware version. The file selector
- will start in the directory containing the firmware included
- with the AltosUI package. Navigate to the directory containing
- the desired firmware if it isn't there.
-
-
- Next, a small dialog containing the device serial number and
- RF calibration values should appear. If these values are
- incorrect (possibly due to a corrupted image in the device),
- enter the correct values here.
-
-
- Finally, a dialog containing a progress bar will follow the
- programming process.
-
-
- When programming is complete, the target device will
- reboot. Note that if a pair programmed target device is
- connected via USB, you will have to unplug it and then plug it
- back in for the USB connection to reset so that you can
- communicate with the device again.
-
Fire Igniter
+
+
+
+
+
+
+
This activates the igniter circuits in the flight computer to help
test recovery systems deployment. Because this command can operate
@@ -2304,6 +2615,13 @@ NAR #88757, TRA #12200
Scan Channels
+
+
+
+
+
+
+
This listens for telemetry packets on all of the configured
frequencies, displaying information about each device it
@@ -2315,6 +2633,13 @@ NAR #88757, TRA #12200
Load Maps
+
+
+
+
+
+
+
Before heading out to a new launch site, you can use this to
load satellite images in case you don't have internet
@@ -3969,11 +4294,13 @@ NAR #88757, TRA #12200
TeleMega has overall dimensions of 1.250 x 3.250 inches, and
the mounting holes are sized for use with 4-40 or M3 screws.
-
-
-
-
-
+
+
+
+
+
+
+
TeleMetrum template
@@ -3981,11 +4308,13 @@ NAR #88757, TRA #12200
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.
-
-
-
-
-
+
+
+
+
+
+
+
TeleMini v2/EasyMini template
@@ -3993,11 +4322,13 @@ NAR #88757, TRA #12200
TeleMini v2 and EasyMini have overall dimensions of 0.800 x 1.500 inches, and the
mounting holes are sized for use with 4-40 or M3 screws.
-
-
-
-
-
+
+
+
+
+
+
+
TeleMini v1 template
@@ -4005,11 +4336,13 @@ NAR #88757, TRA #12200
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.
-
-
-
-
-
+
+
+
+
+
+
+