From 473ae38ade0552c5ff3ca088b21345ed5dfad5d0 Mon Sep 17 00:00:00 2001 From: Keith Packard Date: Thu, 28 Nov 2013 15:21:26 -0800 Subject: [PATCH] doc: First pass for 1.3 finished; docs have most major sections updated. Final edits and corrections still required. Signed-off-by: Keith Packard --- doc/altusmetrum.xsl | 462 +++++++++++++++++++++++++++++++++++++------- 1 file changed, 396 insertions(+), 66 deletions(-) diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl index 0fb26e68..302b8d60 100644 --- a/doc/altusmetrum.xsl +++ b/doc/altusmetrum.xsl @@ -2191,16 +2191,26 @@ NAR #88757, TRA #12200
Flash Image - This reprograms any Altus Metrum device by using a TeleMetrum - or TeleDongle as a programming dongle. Please read the - directions for flashing devices in the Updating Device - Firmware chapter below. + This reprograms Altus Metrum device with new + firmware. TeleMetrum v1.x, TeleDongle, TeleMini and TeleBT are + all reprogrammed by using another similar unit as a + programming dongle (pair programming). TeleMega, TeleMetrum v2 + and EasyMini are all programmed directly over their USB ports + (self programming). Please read the directions for flashing + devices in the Updating Device Firmware chapter below. - 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. + 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 @@ -2221,10 +2231,10 @@ NAR #88757, TRA #12200 When programming is complete, the target device will - reboot. Note that if the 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. + 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.
@@ -2851,11 +2861,11 @@ NAR #88757, TRA #12200 Updating Device Firmware - The big concept to understand is that you have to use a - TeleDongle as a programmer to update a TeleMetrum or TeleMini, - and a TeleMetrum or other TeleDongle to program the TeleDongle - Due to limited memory resources in the cc1111, we don't support - programming directly over USB. + TeleMega, TeleMetrum v2 and EasMini 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 + kind of devices you have before trying to reprogram them. You may wish to begin by ensuring you have current firmware images. @@ -2869,8 +2879,70 @@ NAR #88757, TRA #12200 We recommend updating the altimeter first, before updating TeleDongle. + + 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 TeleMetrum Firmware + + Updating TeleMega, TeleMetrum v2 or EasyMini Firmware + + + + + Attach a battery and power switch to the target + device. Power up the device. + + + + + Using a Micro USB cable, connect the target device to your + computer's USB socket. + + + + + Run AltosUI, and select 'Flash Image' from the File menu. + + + + + Select the image you want to flash to the device, which + should have a name in the form + <product>-v<product-version>-<software-version>.ihx, such + as TeleMega-v1.0-1.3.0.ihx. + + + + + Make sure the configuration parameters are reasonable + looking. If the serial number and/or RF configuration + values aren't right, you'll need to change them. + + + + + Hit the 'OK' button and the software should proceed to flash + the device with new firmware, showing a progress bar. + + + + + Verify that the device is working by using the 'Configure + Altimeter' item to check over the configuration. + + + +
+
+ Updating TeleMetrum v1.x Firmware @@ -3148,7 +3220,141 @@ NAR #88757, TRA #12200 Hardware Specifications
- TeleMetrum Specifications + + TeleMega Specifications + + + + + Recording altimeter for model rocketry. + + + + + Supports dual deployment and four auxilary pyro channels (can initiate 6 events). + + + + + 70cm 40mW ham-band transceiver for telemetry down-link. + + + + + Barometric pressure sensor good to 100k feet MSL. + + + + + 1-axis high-g accelerometer for motor characterization, capable of + +/- 102g. + + + + + 9-axis IMU including integrated 3-axis accelerometer, + 3-axis gyroscope and 3-axis magnetometer. + + + + + On-board, integrated uBlox Max 7 GPS receiver with 5Hz update rate capability. + + + + + On-board 8 Megabyte non-volatile memory for flight data storage. + + + + + USB interface for battery charging, configuration, and data recovery. + + + + + Fully integrated support for Li-Po rechargeable batteries. + + + + + Uses Li-Po to fire e-matches, can be modified to support + optional separate pyro battery if needed. + + + + + 3.25 x 1.25 inch board designed to fit inside 38mm air-frame coupler tube. + + + +
+
+ + TeleMetrum v2 Specifications + + + + + Recording altimeter for model rocketry. + + + + + Supports dual deployment (can fire 2 ejection charges). + + + + + 70cm, 40mW ham-band transceiver for telemetry down-link. + + + + + Barometric pressure sensor good to 100k feet MSL. + + + + + 1-axis high-g accelerometer for motor characterization, capable of + +/- 102g. + + + + + On-board, integrated uBlox Max 7 GPS receiver with 5Hz update rate capability. + + + + + On-board 8 Megabyte non-volatile memory for flight data storage. + + + + + USB interface for battery charging, configuration, and data recovery. + + + + + Fully integrated support for Li-Po rechargeable batteries. + + + + + Uses Li-Po to fire e-matches, can be modified to support + optional separate pyro battery if needed. + + + + + 2.75 x 1 inch board designed to fit inside 29mm air-frame coupler tube. + + + +
+
+ TeleMetrum v1 Specifications @@ -3162,7 +3368,7 @@ NAR #88757, TRA #12200 - 70cm ham-band transceiver for telemetry down-link. + 70cm, 10mW ham-band transceiver for telemetry down-link. @@ -3210,7 +3416,9 @@ NAR #88757, TRA #12200
- TeleMini Specifications + + TeleMini v2.0 Specifications + @@ -3224,7 +3432,61 @@ NAR #88757, TRA #12200 - 70cm ham-band transceiver for telemetry down-link. + 70cm, 10mW ham-band transceiver for telemetry down-link. + + + + + Barometric pressure sensor good to 100k feet MSL. + + + + + On-board 1 megabyte non-volatile memory for flight data storage. + + + + + USB interface for configuration, and data recovery. + + + + + Support for Li-Po rechargeable batteries (using an + external charger), or any 3.7-15V external battery. + + + + + Uses Li-Po to fire e-matches, can be modified to support + optional separate pyro battery if needed. + + + + + 1.5 x .8 inch board designed to fit inside 24mm air-frame coupler tube. + + + +
+
+ + TeleMini v1.0 Specifications + + + + + Recording altimeter for model rocketry. + + + + + Supports dual deployment (can fire 2 ejection charges). + + + + + 70cm, 10mW ham-band transceiver for telemetry down-link. @@ -3260,6 +3522,55 @@ NAR #88757, TRA #12200
+
+ + EasyMini Specifications + + + + + Recording altimeter for model rocketry. + + + + + Supports dual deployment (can fire 2 ejection charges). + + + + + Barometric pressure sensor good to 100k feet MSL. + + + + + On-board 1 megabyte non-volatile memory for flight data storage. + + + + + USB interface for configuration, and data recovery. + + + + + Support for Li-Po rechargeable batteries (using an + external charger), or any 3.7-15V external battery. + + + + + Uses Li-Po to fire e-matches, can be modified to support + optional separate pyro battery if needed. + + + + + 1.5 x .8 inch board designed to fit inside 24mm air-frame coupler tube. + + + +
FAQ @@ -3515,6 +3826,18 @@ NAR #88757, TRA #12200 These images, when printed, provide precise templates for the mounting holes in Altus Metrum flight computers +
+ TeleMega template + + 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 @@ -3528,7 +3851,19 @@ NAR #88757, TRA #12200
- TeleMini template + TeleMini v2/EasyMini template + + 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 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. @@ -3543,18 +3878,19 @@ NAR #88757, TRA #12200 Calibration - There are only two calibrations required for a TeleMetrum board, and - only one for TeleDongle and TeleMini. All boards are shipped from - the factory pre-calibrated, but the procedures are documented here - in case they are ever needed. Re-calibration is not supported by - AltosUI, you must connect to the board with a serial terminal program - and interact directly with the on-board command interpreter to effect - calibration. + There are only two calibrations required for TeleMetrum and + TeleMega, and only one for TeleDongle, TeleMini and EasyMini. + All boards are shipped from the factory pre-calibrated, but + the procedures are documented here in case they are ever + needed. Re-calibration is not supported by AltosUI, you must + connect to the board with a serial terminal program and + interact directly with the on-board command interpreter to + effect calibration.
Radio Frequency - The radio frequency is synthesized from a clock based on the 48 MHz + The radio frequency is synthesized from a clock based on the crystal on the board. The actual frequency of this oscillator must be measured to generate a calibration constant. While our GFSK modulation @@ -3567,13 +3903,14 @@ NAR #88757, TRA #12200 should generally not be required. - To calibrate the radio frequency, connect the UHF antenna port to a - frequency counter, set the board to 434.550MHz, and use the 'C' - command in the on-board command interpreter to generate a CW - carrier. For TeleMetrum, this is best done over USB. For TeleMini, - note that the only way to escape the 'C' command is via power cycle - since the board will no longer be listening for commands once it - starts generating a CW carrier. + To calibrate the radio frequency, connect the UHF antenna + port to a frequency counter, set the board to 434.550MHz, + and use the 'C' command in the on-board command interpreter + to generate a CW carrier. For USB-enabled boards, this is + best done over USB. For TeleMini v1, note that the only way + to escape the 'C' command is via power cycle since the board + will no longer be listening for commands once it starts + generating a CW carrier. Wait for the transmitter temperature to stabilize and the frequency @@ -3584,7 +3921,7 @@ NAR #88757, TRA #12200 command. Testing with the 'C' command again should show a carrier within a few tens of Hertz of the intended frequency. As with all 'c' sub-commands, follow this with a 'c w' to write the - change to the parameter block in the on-board DataFlash chip. + change to the parameter block in the on-board storage chip. Note that any time you re-do the radio frequency calibration, the @@ -3594,21 +3931,13 @@ NAR #88757, TRA #12200
- TeleMetrum Accelerometer + TeleMetrum and TeleMega Accelerometers - The TeleMetrum accelerometer we use has its own 5 volt power - supply and - the output must be passed through a resistive voltage divider to match - the input of our 3.3 volt ADC. This means that unlike the barometric - sensor, the output of the acceleration sensor is not ratio-metric to - the ADC converter, and calibration is required. Explicitly - calibrating the accelerometers also allows us to load any device - from a Freescale family that includes at least +/- 40g, 50g, 100g, - and 200g parts. Using gravity, - a simple 2-point calibration yields acceptable results capturing both - the different sensitivities and ranges of the different accelerometer - parts and any variation in power supply voltages or resistor values - in the divider network. + While barometric sensors are factory-calibrated, + accelerometers are not, and so each must be calibrated once + installed in a flight computer. Explicitly calibrating the + accelerometers also allows us to load any compatible device. + We perform a two-point calibration using gravity. To calibrate the acceleration sensor, use the 'c a 0' command. You @@ -3629,19 +3958,20 @@ NAR #88757, TRA #12200 In the unlikely event an accel cal goes badly, it is possible - that TeleMetrum may always come up in 'pad mode' and as such not be - listening to either the USB or radio link. If that happens, - there is a special hook in the firmware to force the board back - in to 'idle mode' so you can re-do the cal. To use this hook, you - just need to ground the SPI clock pin at power-on. This pin is - available as pin 2 on the 8-pin companion connector, and pin 1 is - ground. So either carefully install a fine-gauge wire jumper - between the two pins closest to the index hole end of the 8-pin - connector, or plug in the programming cable to the 8-pin connector - and use a small screwdriver or similar to short the two pins closest - to the index post on the 4-pin end of the programming cable, and - power up the board. It should come up in 'idle mode' (two beeps), - allowing a re-cal. + that TeleMetrum or TeleMega may always come up in 'pad mode' + and as such not be listening to either the USB or radio link. + If that happens, there is a special hook in the firmware to + force the board back in to 'idle mode' so you can re-do the + cal. To use this hook, you just need to ground the SPI clock + pin at power-on. This pin is available as pin 2 on the 8-pin + companion connector, and pin 1 is ground. So either + carefully install a fine-gauge wire jumper between the two + pins closest to the index hole end of the 8-pin connector, or + plug in the programming cable to the 8-pin connector and use + a small screwdriver or similar to short the two pins closest + to the index post on the 4-pin end of the programming cable, + and power up the board. It should come up in 'idle mode' + (two beeps), allowing a re-cal.
-- 2.30.2