X-Git-Url: https://git.gag.com/?p=fw%2Faltos;a=blobdiff_plain;f=doc%2Faltusmetrum.xsl;h=61451f414c840c22ba01f5e72fc21867202f339e;hp=302b8d6041363cc2abd8d39c4f1a7f950e9a2684;hb=dffbdd93d7a86a12d83a412de37dfd2a5f063995;hpb=473ae38ade0552c5ff3ca088b21345ed5dfad5d0 diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl index 302b8d60..61451f41 100644 --- a/doc/altusmetrum.xsl +++ b/doc/altusmetrum.xsl @@ -104,7 +104,7 @@ - Acknowledgements + Acknowledgments Thanks to Bob Finch, W9YA, NAR 12965, TRA 12350 for writing “The Mere-Mortals Quick Start/Usage Guide to the Altus Metrum Starter @@ -329,6 +329,7 @@ NAR #88757, TRA #12200 Altus Metrum Electronics + @@ -436,6 +437,7 @@ NAR #88757, TRA #12200
Altus Metrum Boards + @@ -481,7 +483,7 @@ NAR #88757, TRA #12200 ½ inch (1.27cm) 1½ inch (3.81cm) - 18mm aiframe + 18mm airframe TeleMini v2.0 @@ -544,6 +546,11 @@ 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 @@ -559,6 +566,11 @@ 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 @@ -573,6 +585,11 @@ 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 @@ -583,6 +600,11 @@ 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 @@ -592,6 +614,11 @@ 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, @@ -612,6 +639,7 @@ NAR #88757, TRA #12200
Data Storage on Altus Metrum altimeters + @@ -1286,7 +1314,7 @@ NAR #88757, TRA #12200 - Main. The rocket is still descending, and is blow + Main. The rocket is still descending, and is below the Main altitude @@ -1300,9 +1328,9 @@ NAR #88757, TRA #12200 You can select a state to limit when the pyro channel may activate; note that the check is based on when the - rocket transitions *into* the state, and so checking for - 'greater than Boost' means that the rocket is currently - in boost state. + rocket transitions into the state, and so checking for + “greater than Boost” means that the rocket is currently + in boost or some later state. When a motor burns out, the rocket enters either Fast or @@ -1410,64 +1438,82 @@ NAR #88757, TRA #12200 rocket is ready for flight. The first elements include red/green indicators, if any of these is red, you'll want to evaluate whether the rocket is ready to launch: - - - - Battery Voltage. This indicates whether the Li-Po battery - powering the TeleMetrum has sufficient charge to last for - the duration of the flight. A value of more than - 3.7V is required for a 'GO' status. - - - - - Apogee Igniter Voltage. This indicates whether the apogee - igniter has continuity. If the igniter has a low - resistance, then the voltage measured here will be close - to the Li-Po battery voltage. A value greater than 3.2V is - required for a 'GO' status. - - - - - Main Igniter Voltage. This indicates whether the main - igniter has continuity. If the igniter has a low - resistance, then the voltage measured here will be close - to the Li-Po battery voltage. A value greater than 3.2V is - required for a 'GO' status. - - - - - On-board Data Logging. This indicates whether there is - space remaining on-board to store flight data for the - upcoming flight. If you've downloaded data, but failed - to erase flights, there may not be any space - left. TeleMetrum can store multiple flights, depending - on the configured maximum flight log size. TeleMini - stores only a single flight, so it will need to be - downloaded and erased after each flight to capture - data. This only affects on-board flight logging; the - altimeter will still transmit telemetry and fire - ejection charges at the proper times. - - - - - GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is - currently able to compute position information. GPS requires - at least 4 satellites to compute an accurate position. - - - - - GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least - 10 consecutive positions without losing lock. This ensures - that the GPS receiver has reliable reception from the - satellites. - - - + + + Battery Voltage + + + This indicates whether the Li-Po battery + powering the TeleMetrum has sufficient charge to last for + the duration of the flight. A value of more than + 3.8V is required for a 'GO' status. + + + + + Apogee Igniter Voltage + + + This indicates whether the apogee + igniter has continuity. If the igniter has a low + resistance, then the voltage measured here will be close + to the Li-Po battery voltage. A value greater than 3.2V is + required for a 'GO' status. + + + + + Main Igniter Voltage + + + This indicates whether the main + igniter has continuity. If the igniter has a low + resistance, then the voltage measured here will be close + to the Li-Po battery voltage. A value greater than 3.2V is + required for a 'GO' status. + + + + + On-board Data Logging + + + This indicates whether there is + space remaining on-board to store flight data for the + upcoming flight. If you've downloaded data, but failed + to erase flights, there may not be any space + left. TeleMetrum can store multiple flights, depending + on the configured maximum flight log size. TeleMini + stores only a single flight, so it will need to be + downloaded and erased after each flight to capture + data. This only affects on-board flight logging; the + altimeter will still transmit telemetry and fire + ejection charges at the proper times. + + + + + GPS Locked + + + For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is + currently able to compute position information. GPS requires + at least 4 satellites to compute an accurate position. + + + + + GPS Ready + + + For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least + 10 consecutive positions without losing lock. This ensures + that the GPS receiver has reliable reception from the + satellites. + + + + The Launchpad tab also shows the computed launch pad position @@ -1662,15 +1708,48 @@ NAR #88757, TRA #12200 flash memory. - Once a flight record is selected, a window with four tabs is - opened. The first tab contains a graph with acceleration - (blue), velocity (green) and altitude (red) of the flight, - measured in metric units. The apogee(yellow) and main(magenta) - igniter voltages are also displayed; high voltages indicate - continuity, low voltages indicate open circuits. The second - tab lets you configure which data to show in the graph. The - third contains some basic flight statistics while the fourth - has a map with the ground track of the flight displayed. + 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. + + + + The graph can be zoomed into a particular area by clicking and @@ -1742,35 +1821,47 @@ NAR #88757, TRA #12200 At the bottom of the dialog, there are four buttons: - - - - Save. This writes any changes to the - configuration parameter block in flash memory. If you don't - press this button, any changes you make will be lost. - - - - - Reset. This resets the dialog to the most recently saved values, - erasing any changes you have made. - - - - - Reboot. This reboots the device. Use this to - switch from idle to pad mode by rebooting once the rocket is - oriented for flight, or to confirm changes you think you saved - are really saved. - - - - - Close. This closes the dialog. Any unsaved changes will be - lost. - - - + + + Save + + + This writes any changes to the + configuration parameter block in flash memory. If you don't + press this button, any changes you make will be lost. + + + + + Reset + + + This resets the dialog to the most recently saved values, + erasing any changes you have made. + + + + + Reboot + + + This reboots the device. Use this to + switch from idle to pad mode by rebooting once the rocket is + oriented for flight, or to confirm changes you think you saved + are really saved. + + + + + Close + + + This closes the dialog. Any unsaved changes will be + lost. + + + + The rest of the dialog contains the parameters to be configured. @@ -1862,32 +1953,41 @@ NAR #88757, TRA #12200 computers. This configuration parameter allows the two channels to be used in different configurations. - - - - Dual Deploy. This is the usual mode of operation; the - 'apogee' channel is fired at apogee and the 'main' - channel at the height above ground specified by the - 'Main Deploy Altitude' during descent. - - - - - Redundant Apogee. This fires both channels at - apogee, the 'apogee' channel first followed after a two second - delay by the 'main' channel. - - - - - Redundant Main. This fires both channels at the - height above ground specified by the Main Deploy - Altitude setting during descent. The 'apogee' - channel is fired first, followed after a two second - delay by the 'main' channel. - - - + + + Dual Deploy + + + This is the usual mode of operation; the + 'apogee' channel is fired at apogee and the 'main' + channel at the height above ground specified by the + 'Main Deploy Altitude' during descent. + + + + + Redundant Apogee + + + This fires both channels at + apogee, the 'apogee' channel first followed after a two second + delay by the 'main' channel. + + + + + Redundant Main + + + This fires both channels at the + height above ground specified by the Main Deploy + Altitude setting during descent. The 'apogee' + channel is fired first, followed after a two second + delay by the 'main' channel. + + + +
Pad Orientation @@ -1898,22 +1998,28 @@ NAR #88757, TRA #12200 parameter allows that default to be changed, permitting the board to be mounted with the antenna pointing aft instead. - - - - Antenna Up. In this mode, the antenna end of the - TeleMetrum board must point forward, in line with the - expected flight path. - - - - - Antenna Down. In this mode, the antenna end of the - TeleMetrum board must point aft, in line with the - expected flight path. - - - + + + Antenna Up + + + In this mode, the antenna end of the + TeleMetrum board must point forward, in line with the + expected flight path. + + + + + Antenna Down + + + In this mode, the antenna end of the + TeleMetrum board must point aft, in line with the + expected flight path. + + + +
Configure Pyro Channels @@ -1922,92 +2028,10 @@ NAR #88757, TRA #12200 pyro channels available on TeleMega. One column is presented for each channel. Each row represents a single parameter, if enabled the parameter must meet the specified - test for the pyro channel to be fired. + test for the pyro channel to be fired. See the Pyro Channels + section in the System Operation chapter above for a + description of these parameters. - - - - Acceleration less than. - - - - - Acceleration greater than. - - - - - Speed less than. - - - - - Speed greater than. - - - - - Height less than. - - - - - Height greater than. - - - - - Angle from vertical less than. - - - - - Angle from vertical greater than. - - - - - Time since boost less than. - - - - - Time since boost greater than. - - - - - Ascending. This is exactly the same as setting a - condition for speed > 0. - - - - - Descending. This is exactly the same as setting a - condition for speed < 0. - - - - - After motor number. - - - - - Delay after other conditions. - - - - - Flight state before. - - - - - Flight state after. - - - Select conditions and set the related value; the pyro channel will be activated when all of the @@ -2142,27 +2166,36 @@ NAR #88757, TRA #12200 At the bottom of the dialog, there are three buttons: - - - - Save. This writes any changes to the - local Java preferences file. If you don't - press this button, any changes you make will be lost. - - - - - Reset. This resets the dialog to the most recently saved values, - erasing any changes you have made. - - - - - Close. This closes the dialog. Any unsaved changes will be - lost. - - - + + + Save + + + This writes any changes to the + local Java preferences file. If you don't + press this button, any changes you make will be lost. + + + + + Reset + + + This resets the dialog to the most recently saved values, + erasing any changes you have made. + + + + + Close + + + This closes the dialog. Any unsaved changes will be + lost. + + + + The rest of the dialog contains the parameters to be configured. @@ -2382,64 +2415,82 @@ NAR #88757, TRA #12200 rocket is ready for flight. The first elements include red/green indicators, if any of these is red, you'll want to evaluate whether the rocket is ready to launch: - - - - Battery Voltage. This indicates whether the Li-Po battery - powering the TeleMetrum has sufficient charge to last for - the duration of the flight. A value of more than - 3.7V is required for a 'GO' status. - - - - - Apogee Igniter Voltage. This indicates whether the apogee - igniter has continuity. If the igniter has a low - resistance, then the voltage measured here will be close - to the Li-Po battery voltage. A value greater than 3.2V is - required for a 'GO' status. - - - - - Main Igniter Voltage. This indicates whether the main - igniter has continuity. If the igniter has a low - resistance, then the voltage measured here will be close - to the Li-Po battery voltage. A value greater than 3.2V is - required for a 'GO' status. - - - - - On-board Data Logging. This indicates whether there is - space remaining on-board to store flight data for the - upcoming flight. If you've downloaded data, but failed - to erase flights, there may not be any space - left. TeleMetrum can store multiple flights, depending - on the configured maximum flight log size. TeleMini - stores only a single flight, so it will need to be - downloaded and erased after each flight to capture - data. This only affects on-board flight logging; the - altimeter will still transmit telemetry and fire - ejection charges at the proper times. - - - - - GPS Locked. For a TeleMetrum device, this indicates whether the GPS receiver is - currently able to compute position information. GPS requires - at least 4 satellites to compute an accurate position. - - - - - GPS Ready. For a TeleMetrum device, this indicates whether GPS has reported at least - 10 consecutive positions without losing lock. This ensures - that the GPS receiver has reliable reception from the - satellites. - - - + + + Battery Voltage + + + This indicates whether the Li-Po battery + powering the TeleMetrum has sufficient charge to last for + the duration of the flight. A value of more than + 3.8V is required for a 'GO' status. + + + + + Apogee Igniter Voltage + + + This indicates whether the apogee + igniter has continuity. If the igniter has a low + resistance, then the voltage measured here will be close + to the Li-Po battery voltage. A value greater than 3.2V is + required for a 'GO' status. + + + + + Main Igniter Voltage + + + This indicates whether the main + igniter has continuity. If the igniter has a low + resistance, then the voltage measured here will be close + to the Li-Po battery voltage. A value greater than 3.2V is + required for a 'GO' status. + + + + + On-board Data Logging + + + This indicates whether there is + space remaining on-board to store flight data for the + upcoming flight. If you've downloaded data, but failed + to erase flights, there may not be any space + left. TeleMetrum can store multiple flights, depending + on the configured maximum flight log size. TeleMini + stores only a single flight, so it will need to be + downloaded and erased after each flight to capture + data. This only affects on-board flight logging; the + altimeter will still transmit telemetry and fire + ejection charges at the proper times. + + + + + GPS Locked + + + For a TeleMetrum or TeleMega device, this indicates whether the GPS receiver is + currently able to compute position information. GPS requires + at least 4 satellites to compute an accurate position. + + + + + GPS Ready + + + For a TeleMetrum or TeleMega device, this indicates whether GPS has reported at least + 10 consecutive positions without losing lock. This ensures + that the GPS receiver has reliable reception from the + satellites. + + + + The Launchpad tab also shows the computed launch pad position @@ -2526,7 +2577,8 @@ NAR #88757, TRA #12200 if the rocket is hiding in sage brush or a tree, or if the last GPS position doesn't get you close enough because the rocket dropped into a canyon, or the wind is blowing it across a dry lake bed, or something like that... Keith - and Bdale both currently own and use the Yaesu VX-7R at launches. + currently uses a Yaesu VX-7R, Bdale has a Baofung UV-5R + which isn't as nice, but was a whole lot cheaper. So, to recap, on the ground the hardware you'll need includes: @@ -2861,7 +2913,7 @@ NAR #88757, TRA #12200 Updating Device Firmware - TeleMega, TeleMetrum v2 and EasMini are all programmed directly + TeleMega, TeleMetrum v2 and EasyMini are all programmed directly over their USB connectors (self programming). TeleMetrum v1, TeleMini and TeleDongle are all programmed by using another device as a programmer (pair programming). It's important to recognize which @@ -2883,13 +2935,6 @@ NAR #88757, TRA #12200 Self-programmable devices (TeleMega, TeleMetrum v2 and EasyMini) are reprogrammed by connecting them to your computer over USB - - The big concept to understand is that you have to use a - TeleMega, TeleMetrum or TeleDongle as a programmer to update a - pair programmed device. Due to limited memory resources in the - cc1111, we don't support programming directly over USB for these - devices. -
Updating TeleMega, TeleMetrum v2 or EasyMini Firmware @@ -2912,6 +2957,11 @@ NAR #88757, TRA #12200 Run AltosUI, and select 'Flash Image' from the File menu. </para> </listitem> + <listitem> + <para> + Select the target device in the Device Selection dialog. + </para> + </listitem> <listitem> <para> Select the image you want to flash to the device, which @@ -2940,6 +2990,72 @@ NAR #88757, TRA #12200 </para> </listitem> </orderedlist> + <section> + <title>Recovering From Self-Flashing Failure + + If the firmware loading fails, it can leave the device + unable to boot. Not to worry, you can force the device to + start the boot loader instead, which will let you try to + flash the device again. + + + On each device, connecting two pins from one of the exposed + connectors will force the boot loader to start, even if the + regular operating system has been corrupted in some way. + + + + TeleMega + + + Connect pin 6 and pin 1 of the companion connector. Pin 1 + can be identified by the square pad around it, and then + the pins could sequentially across the board. Be very + careful to not short pin 8 to + anything as that is connected directly to the battery. Pin + 7 carries 3.3V and the board will crash if that is + connected to pin 1, but shouldn't damage the board. + + + + + TeleMetrum v2 + + + Connect pin 6 and pin 1 of the companion connector. Pin 1 + can be identified by the square pad around it, and then + the pins could sequentially across the board. Be very + careful to not short pin 8 to + anything as that is connected directly to the battery. Pin + 7 carries 3.3V and the board will crash if that is + connected to pin 1, but shouldn't damage the board. + + + + + EasyMini + + + Connect pin 6 and pin 1 of the debug connector, which is + the six holes next to the beeper. Pin 1 can be identified + by the square pad around it, and then the pins could + sequentially across the board, making Pin 6 the one on the + other end of the row. + + + + +
+
+
+ Pair Programming + + The big concept to understand is that you have to use a + TeleMega, TeleMetrum or TeleDongle as a programmer to update a + pair programmed device. Due to limited memory resources in the + cc1111, we don't support programming directly over USB for these + devices. +
Updating TeleMetrum v1.x Firmware @@ -3231,7 +3347,8 @@ NAR #88757, TRA #12200 - Supports dual deployment and four auxilary pyro channels (can initiate 6 events). + Supports dual deployment and four auxiliary pyro channels + (a total of 6 events).