From: Bdale Garbee Date: Tue, 17 Dec 2013 21:09:30 +0000 (-0700) Subject: Merge branch 'master' of ssh://git.gag.com/scm/git/fw/altos X-Git-Tag: 1.3~37 X-Git-Url: https://git.gag.com/?p=fw%2Faltos;a=commitdiff_plain;h=90c88bab305c43eb62f964fd3ff350b8b0b5320d;hp=-c Merge branch 'master' of ssh://git.gag.com/scm/git/fw/altos Conflicts: doc/altusmetrum.xsl --- 90c88bab305c43eb62f964fd3ff350b8b0b5320d diff --combined doc/altusmetrum.xsl index 3e6b4025,61451f41..1e9f04b4 --- a/doc/altusmetrum.xsl +++ b/doc/altusmetrum.xsl @@@ -180,8 -180,8 +180,8 @@@ NAR #88757, TRA #1220 For a slightly more portable ground station experience that also provides direct rocket recovery support, TeleBT offers flight - monitoring and data logging using a Bluetooth connection between - the receiver and an Android device that has the Altos Droid + monitoring and data logging using a Bluetooth™ connection between + the receiver and an Android device that has the AltosDroid application installed from the Google Play store. @@@ -207,7 -207,7 +207,7 @@@ On TeleMetrum v1 boards, when the GPS chip is initially searching for satellites, TeleMetrum will consume more current - than it can pull from the USB port, so the battery must be + than it pulls from the USB port, so the battery must be attached in order to get satellite lock. Once GPS is locked, the current consumption goes back down enough to enable charging while running. So it's a good idea to fully charge the battery @@@ -238,7 -238,7 +238,7 @@@ and EasyMini, anything supplying between 4 and 12 volts should work fine (like a standard 9V battery), but if you are planning to fire pyro charges, ground testing is required to verify that - the battery supplies enough current. + the battery supplies enough current to fire your chosen e-matches. The other active device in the starter kit is the TeleDongle USB to @@@ -247,13 -247,13 +247,13 @@@ driver information that is part of the AltOS download to know that the existing USB modem driver will work. We therefore recommend installing our software before plugging in TeleDongle if you are using a Windows - computer. If you are using Linux and are having problems, try moving - to a fresher kernel (2.6.33 or newer), as the USB serial driver had - ugly bugs in some earlier versions. + computer. If you are using an older version of Linux and are having + problems, try moving to a fresher kernel (2.6.33 or newer). - Next you should obtain and install the AltOS software. These - include the AltosUI ground station program, current firmware + Next you should obtain and install the AltOS software. The AltOS + distribution includes the AltosUI ground station program, current + firmware images for all of the hardware, and a number of standalone utilities that are rarely needed. Pre-built binary packages are available for Linux, Microsoft Windows, and recent MacOSX @@@ -262,9 -262,9 +262,9 @@@ . - If you're using a TeleBT instead of the TeleDongle, you'll want - to go install the Altos Droid application from the Google Play - store. You don't need a data plan to use Altos Droid, but + If you're using a TeleBT instead of the TeleDongle, you'll want to + install the AltosDroid application from the Google Play store on an + Android device. You don't need a data plan to use AltosDroid, but without network access, the Map view will be less useful as it won't contain any map data. You can also use TeleBT connected over USB with your laptop computer; it acts exactly like a @@@ -297,9 -297,9 +297,9 @@@ sensitive to sunlight. In normal mounting situations, the baro sensor and all of the other surface mount components are “down” towards whatever the underlying mounting surface is, so - this is not normally a problem. Please consider this, though, when - designing an installation, for example, in an air-frame with a - see-through plastic payload bay. It is particularly important to + this is not normally a problem. Please consider this when designing an + installation in an air-frame with a see-through plastic payload bay. It + is particularly important to consider this with TeleMini v1.0, both because the baro sensor is on the “top” of the board, and because many model rockets with payload bays use clear plastic for the payload bay! Replacing these with an opaque @@@ -329,6 -329,7 +329,7 @@@ Altus Metrum Electronics + @@@ -436,6 -437,7 +437,7 @@@
Altus Metrum Boards + @@@ -481,7 -483,7 +483,7 @@@ ½ inch (1.27cm) 1½ inch (3.81cm) - 18mm airframe + 18mm coupler TeleMini v2.0 @@@ -544,6 -546,11 +546,11 @@@
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 +566,11 @@@
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 +585,11 @@@ 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,15 -600,25 +600,25 @@@
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 - screw terminals match TeleMini, so you can swap an EasyMini - with a TeleMini. + screw terminals match TeleMini v2.0, so you can easily swap between + EasyMini and TeleMini.
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 +639,7 @@@
Data Storage on Altus Metrum altimeters + @@@ -720,7 -748,7 +748,7 @@@ apogee and main ejection charges. All Altus Metrum products are designed for use with single-cell batteries with 3.7 volts nominal. TeleMini v2.0 and EasyMini may also be used with other - batteries as long as they supply between 4 and 12 volts. + batteries as long as they supply between 4 and 12 volts. The battery connectors are a standard 2-pin JST connector and @@@ -762,8 -790,8 +790,8 @@@ adequate. However, if you are installing in a carbon-fiber or metal electronics bay which is opaque to RF signals, you may need to use off-board external antennas instead. In this case, you can - order an altimeter with an SMA connector for the UHF antenna - connection, and, on TeleMetrum v1, you can unplug the integrated GPS + replace the stock UHF antenna wire with an edge-launched SMA connector, + and, on TeleMetrum v1, you can unplug the integrated GPS antenna and select an appropriate off-board GPS antenna with cable terminating in a U.FL connector. @@@ -777,11 -805,10 +805,11 @@@ The AltOS firmware build for the altimeters has two fundamental modes, “idle” and “flight”. Which of these modes the firmware operates in is determined at start up time. For - TeleMetrum, the mode is controlled by the orientation of the + TeleMetrum and TeleMega, which have accelerometers, the mode is + controlled by the orientation of the rocket (well, actually the board, of course...) at the time power is switched on. If the rocket is “nose up”, then - TeleMetrum assumes it's on a rail or rod being prepared for + the flight computer assumes it's on a rail or rod being prepared for launch, so the firmware chooses flight mode. However, if the rocket is more or less horizontal, the firmware instead enters idle mode. Since TeleMini v2.0 and EasyMini don't have an @@@ -1013,7 -1040,7 +1041,7 @@@
Radio Link - The chip our boards are based on incorporates an RF transceiver, but + Our flight computers all incorporate an RF transceiver, but it's not a full duplex system... each end can only be transmitting or receiving at any given moment. So we had to decide how to manage the link. @@@ -1049,7 -1076,7 +1077,7 @@@ performance in higher altitude flights! - TeleMetrum v2.0 and TeleMega can send APRS if desired, the + TeleMetrum v2.0 and TeleMega can send APRS if desired, and the interval between APRS packets can be configured. As each APRS packet takes a full second to transmit, we recommend an interval of at least 5 seconds to avoid consuming too much @@@ -1124,11 -1151,6 +1152,11 @@@ the available storage, future flights will not get logged until you erase some of the stored ones. + + Even though our flight computers (except TeleMini v1.0) can store + multiple flights, we strongly recommend downloading and saving + flight data after each flight. +
Ignite Mode @@@ -1136,8 -1158,9 +1164,8 @@@ Instead of firing one charge at apogee and another charge at a fixed height above the ground, you can configure the altimeter to fire both at apogee or both during - descent. This was added to support an airframe that has two - altimeters, one in the fin can and one in the - nose. + descent. This was added to support an airframe Bdale designed that + had two altimeters, one in the fin can and one in the nose. Providing the ability to use both igniters for apogee or @@@ -1161,7 -1184,7 +1189,7 @@@
- Pyro Channels + Configurable Pyro Channels In addition to the usual Apogee and Main pyro channels, TeleMega has four additional channels that can be configured @@@ -1210,7 -1233,7 +1238,7 @@@ system. Because this value is computed by integrating rate gyros, it gets progressively less accurate as the flight goes on. It should have an accumulated error of - less than .2°/second (after 10 seconds of flight, the + less than 0.2°/second (after 10 seconds of flight, the error should be less than 2°). @@@ -1329,8 -1352,8 +1357,8 @@@ interacting with the Altus Metrum product family. AltosUI can monitor telemetry data, configure devices and many other tasks. The primary interface window provides a selection of - buttons, one for each major activity in the system. This manual - is split into chapters, each of which documents one of the tasks + buttons, one for each major activity in the system. This chapter + is split into sections, each of which documents one of the tasks provided from the top-level toolbar.
@@@ -1420,8 -1443,8 +1448,8 @@@ Battery Voltage - This indicates whether the Li-Po battery - powering the TeleMetrum has sufficient charge to last for + This indicates whether the Li-Po battery powering the + flight computer has sufficient charge to last for the duration of the flight. A value of more than 3.8V is required for a 'GO' status. @@@ -1459,15 -1482,13 +1487,15 @@@ 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 + left. Most of our flight computers can store multiple + flights, depending on the configured maximum flight log + size. TeleMini v1.0 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. + ejection charges at the proper times even if the flight + data storage is full. @@@ -1514,7 -1535,7 +1542,7 @@@ flight. - The current latitude and longitude reported by the TeleMetrum GPS are + The current latitude and longitude reported by the GPS are also shown. Note that under high acceleration, these values may not get updated as the GPS receiver loses position fix. Once the rocket starts coasting, the receiver should @@@ -1542,7 -1563,7 +1570,7 @@@ be below 10m/s when under the main parachute in a dual-deploy flight. - For TeleMetrum altimeters, you can locate the rocket in the + With GPS-equipped flight computers, you can locate the rocket in the sky using the elevation and bearing information to figure out where to look. Elevation is in degrees above the horizon. Bearing is reported in degrees relative to true @@@ -1579,7 -1600,7 +1607,7 @@@ unit and have that compute a track to the landing location. - Both TeleMini and TeleMetrum will continue to transmit RDF + Our flight computers will continue to transmit RDF tones after landing, allowing you to locate the rocket by following the radio signal if necessary. You may need to get away from the clutter of the flight line, or even get up on @@@ -1590,7 -1611,7 +1618,7 @@@ during the flight are displayed for your admiring observers. The accuracy of these immediate values depends on the quality of your radio link and how many packets were received. - Recovering the on-board data after flight will likely yield + Recovering the on-board data after flight may yield more precise results. @@@ -1634,14 -1655,16 +1662,14 @@@ system can handle, and is not subject to radio drop-outs. As such, it provides a more complete and precise record of the flight. The 'Save Flight Data' button allows you to read the - flash memory and write it to disk. As TeleMini has only a barometer, it - records data at the same rate as the telemetry signal, but there will be - no data lost due to telemetry drop-outs. + flash memory and write it to disk. Clicking on the 'Save Flight Data' button brings up a list of - connected TeleMetrum and TeleDongle devices. If you select a - TeleMetrum device, the flight data will be downloaded from that + connected flight computers and TeleDongle devices. If you select a + flight computer, the flight data will be downloaded from that device directly. If you select a TeleDongle device, flight data - will be downloaded from an altimeter over radio link via the + will be downloaded from a flight computer over radio link via the specified TeleDongle. See the chapter on Controlling An Altimeter Over The Radio Link for more information. @@@ -1747,10 -1770,10 +1775,10 @@@ This tool takes the raw data files and makes them available for external analysis. When you select this button, you are prompted to - select a flight - data file (either .eeprom or .telem will do, remember that - .eeprom files contain higher resolution and more continuous - data). Next, a second dialog appears which is used to select + select a flight data file, which can be either a .eeprom or .telem. + The .eeprom files contain higher resolution and more continuous data, + while .telem files contain receiver signal strength information. + Next, a second dialog appears which is used to select where to write the resulting file. It has a selector to choose between CSV and KML file formats. @@@ -1798,35 -1821,47 +1826,47 @@@ 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. @@@ -1918,58 -1953,73 +1958,73 @@@ 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 - Because it includes an accelerometer, TeleMetrum and + Because they include accelerometers, TeleMetrum and TeleMega are sensitive to the orientation of the board. By - default, it expects the antenna end to point forward. This + default, they expect the antenna end to point forward. This 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 - flight computer must point forward, in line with the - expected flight path. - - - - - Antenna Down. In this mode, the antenna end of the - flight computer 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 ++ flight computer 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 ++ flight computer must point aft, in line with the + expected flight path. + + + +
Configure Pyro Channels @@@ -2116,27 -2166,36 +2171,36 @@@ 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. @@@ -2165,7 -2224,7 +2229,7 @@@
Flash Image - This reprograms Altus Metrum device with new + This reprograms Altus Metrum devices 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 @@@ -2214,17 -2273,17 +2278,17 @@@
Fire Igniter - This activates the igniter circuits in TeleMetrum to help test - recovery systems deployment. Because this command can operate + This activates the igniter circuits in the flight computer to help + test recovery systems deployment. Because this command can operate over the Packet Command Link, you can prepare the rocket as for flight and then test the recovery system without needing to snake wires inside the air-frame. Selecting the 'Fire Igniter' button brings up the usual device - selection dialog. Pick the desired TeleDongle or TeleMetrum - device. This brings up another window which shows the current - continuity test status for both apogee and main charges. + selection dialog. Pick the desired device. This brings up another + window which shows the current continuity test status for both + apogee and main charges. Next, select the desired igniter to fire. This will enable the @@@ -2261,8 -2320,8 +2325,8 @@@ There's a drop-down menu of launch sites we know about; if your favorites aren't there, please let us know the lat/lon and name of the site. The contents of this list are actually - downloaded at run-time, so as new sites are sent in, they'll - get automatically added to this list. + downloaded from our server at run-time, so as new sites are sent + in, they'll get automatically added to this list. If the launch site isn't in the list, you can manually enter the lat/lon values @@@ -2294,7 -2353,7 +2358,7 @@@ AltosDroid provides the same flight monitoring capabilities as AltosUI, but runs on Android devices and is designed to connect - to a TeleBT receiver over Bluetooth™. Altos Droid monitors + to a TeleBT receiver over Bluetooth™. AltosDroid monitors telemetry data, logging it to internal storage in the Android device, and presents that data in a UI the same way the 'Monitor Flight' window does in AltosUI. @@@ -2341,9 -2400,9 +2405,9 @@@
- Altos Droid Flight Monitoring + AltosDroid Flight Monitoring - Altos Droid is designed to mimic the AltosUI flight monitoring + AltosDroid is designed to mimic the AltosUI flight monitoring display, providing separate tabs for each stage of your rocket flight along with a tab containing a map of the local area with icons marking the current location of the altimeter and @@@ -2443,7 -2502,7 +2507,7 @@@
Downloading Flight Logs - Altos Droid always saves every bit of telemetry data it + AltosDroid always saves every bit of telemetry data it receives. To download that to a computer for use with AltosUI, simply remove the SD card from your Android device, or connect your device to your computer's USB port and browse the files @@@ -2603,7 -2662,7 +2667,7 @@@ 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. + Bluetooth™ that will work with Android phones and tablets. Because all of our work is open, both the hardware designs and the @@@ -4109,4 -4168,4 +4173,4 @@@ +-->