From: Keith Packard Date: Sun, 7 Sep 2014 05:28:13 +0000 (-0700) Subject: doc: Update for version 1.5 release X-Git-Tag: 1.4.9.3~2^2 X-Git-Url: https://git.gag.com/?p=fw%2Faltos;a=commitdiff_plain;h=6c812f10761ec4ebf13e29ccef1d6c2c864f1158 doc: Update for version 1.5 release Add stuff about EasyMega and telemetry rate configuration. Update screen shots as needed. Signed-off-by: Keith Packard --- diff --git a/doc/Makefile b/doc/Makefile index c39450c7..60c63f63 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -16,7 +16,8 @@ RELNOTES=\ release-notes-1.3.1.html \ release-notes-1.3.2.html \ release-notes-1.4.html \ - release-notes-1.4.1.html + release-notes-1.4.1.html \ + release-notes-1.5.html PICTURES=\ altosui.png \ @@ -61,12 +62,13 @@ SVG=\ easymini.svg \ telemega.svg \ telemetrum.svg \ - telemini.svg + telemini.svg \ + easymega.svg RELNOTES_XSL=$(RELNOTES:.html=.xsl) 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 + telemetrum-outline.pdf telemega-outline.pdf easymini-outline.pdf easymega-outline.pdf HTMLSTYLE=/usr/share/xml/docbook/stylesheet/docbook-xsl/html/docbook.xsl FOSTYLE=xorg-fo.xsl TEMPLATES=titlepage.templates.xsl diff --git a/doc/altusmetrum.xsl b/doc/altusmetrum.xsl index b4cac48e..0785f65a 100644 --- a/doc/altusmetrum.xsl +++ b/doc/altusmetrum.xsl @@ -40,6 +40,13 @@ + + 1.5 + 6 September 2014 + + Major release adding EasyMega support. + + 1.4.1 20 June 2014 @@ -202,6 +209,11 @@ NAR #88757, TRA #12200 EasyMini is a dual-deploy altimeter with logging and built-in USB data download. + + EasyMega is essentially a TeleMega board with the GPS receiver + and telemetry transmitter removed. It offers the same 6 pyro + channels and integrated gyroscopes for staging/air-start inhibit. + TeleDongle was our first ground station, providing a USB to RF interfaces for communicating with the altimeters. Combined with @@ -231,7 +243,7 @@ NAR #88757, TRA #12200 “starter kit” is to charge the battery. - For TeleMetrum and TeleMega, the battery can be charged by plugging it into the + For TeleMetrum, TeleMega and EasyMega, the battery can be charged by plugging it into the corresponding socket of the device and then using the USB cable to plug the flight computer into your computer's USB socket. The on-board circuitry will charge the battery whenever it is plugged @@ -252,7 +264,7 @@ NAR #88757, TRA #12200 deeply discharged battery. - TeleMetrum v2.0 and TeleMega use a higher power battery charger, + TeleMetrum v2.0, TeleMega and EasyMega use a higher power battery charger, allowing them to charge the battery while running the board at maximum power. When the battery is charging, or when the board is consuming a lot of power, the red LED will be lit. When the @@ -456,7 +468,7 @@ NAR #88757, TRA #12200 EasyMini and TeleMini v2 are designed to use either a lithium polymer battery or any other battery producing between 4 and 12 volts, such as a rectangular 9V - battery. TeleMega and TeleMetrum are not designed for this, + battery. TeleMega, EasyMega and TeleMetrum are not designed for this, and must only be powered by a lithium polymer battery. Find instructions on how to use other batteries in the EasyMini and TeleMini sections below. @@ -574,6 +586,16 @@ NAR #88757, TRA #12200 40mW 3.7V + + EasyMega v1.0 + MS5607 30km (100k') + MMA6555 102g + - + MPU6000 HMC5883 + 8MB + - + 3.7V + @@ -682,6 +704,25 @@ NAR #88757, TRA #12200 3¼ inch (8.26cm) 38mm coupler + + EasyMega + + Debug + Companion + USB + Battery + + + Apogee pyro + Main pyro + Pyro A-D + Switch + Pyro battery + + 1¼ inch (3.18cm) + 2¼ inch (5.62cm) + 38mm coupler + @@ -1361,6 +1402,178 @@ NAR #88757, TRA #12200 +
+ EasyMega + + + + + + + + + EasyMega is a 1¼ inch by 2¼ inch circuit board. It was + designed to easily fit in a 38mm coupler. Like TeleMetrum, + EasyMega has an accelerometer and so it must be mounted so that + the board is aligned with the flight axis. It can be mounted + either antenna up or down. + +
+ EasyMega Screw Terminals + + EasyMega has two sets of nine screw terminals on the end of + the board opposite the telemetry antenna. They are as follows: + + + EasyMega Screw Terminals + + + + + + + + Terminal # + Terminal Name + Description + + + + + Top 1 + Switch Input + Switch connection to positive battery terminal + + + Top 2 + Switch Output + Switch connection to flight computer + + + Top 3 + GND + Ground connection for use with external active switch + + + Top 4 + Main - + Main pyro channel connection to pyro circuit + + + Top 5 + Main + + Main pyro channel common connection to battery + + + + Top 6 + Apogee - + Apogee pyro channel connection to pyro circuit + + + Top 7 + Apogee + + Apogee pyro channel common connection to battery + + + + Top 8 + D - + D pyro channel connection to pyro circuit + + + Top 9 + D + + D pyro channel common connection to battery + + + + Bottom 1 + GND + Ground connection for negative pyro battery terminal + + + Bottom 2 + Pyro + Positive pyro battery terminal + + + Bottom 3 + Lipo + + Power switch output. Use to connect main battery to + pyro battery input + + + + Bottom 4 + A - + A pyro channel connection to pyro circuit + + + Bottom 5 + A + + A pyro channel common connection to battery + + + + Bottom 6 + B - + B pyro channel connection to pyro circuit + + + Bottom 7 + B + + B pyro channel common connection to battery + + + + Bottom 8 + C - + C pyro channel connection to pyro circuit + + + Bottom 9 + C + + C pyro channel common connection to battery + + + + +
+
+
+ Using a Separate Pyro Battery with EasyMega + + EasyMega provides explicit support for an external pyro + battery. All that is required is to remove the jumper + between the lipo terminal (Bottom 3) and the pyro terminal + (Bottom 2). Then hook the negative pyro battery terminal to ground + (Bottom 1) and the positive pyro battery to the pyro battery + input (Bottom 2). You can then use the existing pyro screw + terminals to hook up all of the pyro charges. + +
+
+ Using Only One Battery With EasyMega + + Because EasyMega has built-in support for a separate pyro + battery, if you want to fly with just one battery running + both the computer and firing the charges, you need to + connect the flight computer battery to the pyro + circuit. EasyMega has two screw terminals for this—hook a + wire from the Lipo terminal (Bottom 3) to the Pyro terminal + (Bottom 2). + +
+
+ Using an Active Switch with EasyMega + + As explained above, an external active switch requires three + connections, one to the positive battery terminal, one to + the flight computer positive input and one to ground. + + + The positive battery terminal is available on Top terminal + 1, the positive flight computer input is on Top terminal + 2. Ground is on Top terminal 3. + +
+
Flight Data Recording @@ -1431,6 +1644,12 @@ NAR #88757, TRA #12200 8MB 40 + + EasyMega + 32 + 8MB + 40 + @@ -1444,7 +1663,7 @@ NAR #88757, TRA #12200 Configuration data is also stored in the flash memory on TeleMetrum v1.x, TeleMini and EasyMini. This consumes 64kB of flash space. This configuration space is not available - for storing flight log data. TeleMetrum v2.0 and TeleMega + for storing flight log data. TeleMetrum v2.0, TeleMega and EasyMega store configuration data in a bit of eeprom available within the processor chip, leaving that space available in flash for more flight data. @@ -1538,7 +1757,7 @@ NAR #88757, TRA #12200 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 and TeleMega, which have accelerometers, the mode is + TeleMetrum, TeleMega and EasyMega, 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 @@ -1803,7 +2022,8 @@ NAR #88757, TRA #12200 and beep out the maximum height until turned off. - One “neat trick” of particular value when TeleMetrum or TeleMega are used with + One “neat trick” of particular value when TeleMetrum, TeleMega + or EasyMega are used with very large air-frames, is that you can power the board up while the rocket is horizontal, such that it comes up in idle mode. Then you can raise the air-frame to launch position, and issue a 'reset' command @@ -2049,6 +2269,15 @@ NAR #88757, TRA #12200 isn't displaying position information, it's possible that this is the cause. + + APRS packets include an SSID (Secondary Station Identifier) + field that allows one operator to have multiple + transmitters. AltOS allows you to set this to a single digit + from 0 to 9, allowing you to fly multiple transmitters at the + same time while keeping the identify of each one separate in + the receiver. By default, the SSID is set to the last digit of + the device serial number. + The APRS packet format includes a comment field that can have arbitrary text in it. AltOS uses this to send status @@ -2095,15 +2324,20 @@ NAR #88757, TRA #12200 M3.7 Main Igniter Voltage + + 6 + 1286 + Device Serial Number + Here's an example of an APRS comment showing GPS lock with 6 satellites in view, a primary battery at 4.0V, and - apogee and main igniters both at 3.7V. + apogee and main igniters both at 3.7V from device 1286. - L6 B4.0 A3.7 M3.7 + L6 B4.0 A3.7 M3.7 1286 @@ -2166,6 +2400,18 @@ NAR #88757, TRA #12200 mode.
+
+ Telemetry baud rate + + This sets the modulation bit rate for data transmission for + both telemetry and packet link mode. Lower bit + rates will increase range while reducing the amount of data + that can be sent and increasing battery consumption. All + telemetry is done using a rate 1/2 constraint 4 convolution + code, so the actual data transmission rate is 1/2 of the + modulation bit rate specified here. + +
APRS Interval @@ -2176,6 +2422,14 @@ NAR #88757, TRA #12200 recommend sending packets no more than once every 5 seconds.
+
+ APRS SSID + + This selects the SSID reported in APRS packets. By default, + it is set to the last digit of the serial number, but you + can change this to any value from 0 to 9. + +
Apogee Delay @@ -2260,7 +2514,7 @@ NAR #88757, TRA #12200
Pad Orientation - TeleMetrum and TeleMega measure acceleration along the axis + TeleMetrum, TeleMega and EasyMega measure acceleration along the axis of the board. Which way the board is oriented affects the sign of the acceleration value. Instead of trying to guess which way the board is mounted in the air frame, the @@ -2275,7 +2529,7 @@ NAR #88757, TRA #12200 Configurable Pyro Channels In addition to the usual Apogee and Main pyro channels, - TeleMega has four additional channels that can be configured + TeleMega and EasyMega have four additional channels that can be configured to activate when various flight conditions are satisfied. You can select as many conditions as necessary; all of them must be met in order to activate the @@ -2312,7 +2566,7 @@ NAR #88757, TRA #12200 - Orientation. TeleMega contains a 3-axis gyroscope and + Orientation. TeleMega and EasyMega contain a 3-axis gyroscope and accelerometer which is used to measure the current angle. Note that this angle is not the change in angle from the launch pad, but rather absolute relative to @@ -3137,6 +3391,18 @@ NAR #88757, TRA #12200 at all.
+
+ Telemetry baud rate + + This sets the modulation bit rate for data transmission for + both telemetry and packet link mode. Lower bit + rates will increase range while reducing the amount of data + that can be sent and increasing battery consumption. All + telemetry is done using a rate 1/2 constraint 4 convolution + code, so the actual data transmission rate is 1/2 of the + modulation bit rate specified here. + +
APRS Interval @@ -3149,6 +3415,14 @@ NAR #88757, TRA #12200 sending any other telemetry during that time.
+
+ APRS SSID + + Which SSID to report in APRS packets. By default, this is + set to the last digit of the serial number, but can be + configured to any value from 0 to 9. + +
Callsign @@ -3211,8 +3485,8 @@ NAR #88757, TRA #12200
Pad Orientation - Because they include accelerometers, TeleMetrum and - TeleMega are sensitive to the orientation of the board. By + Because they include accelerometers, TeleMetrum, + TeleMega and EasyMega are sensitive to the orientation of the board. By 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. @@ -3261,7 +3535,7 @@ NAR #88757, TRA #12200 This opens a separate window to configure the additional - pyro channels available on TeleMega. One column is + pyro channels available on TeleMega and EasyMega. 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. See the Pyro Channels @@ -3409,7 +3683,7 @@ NAR #88757, TRA #12200 - Select this button and then select a TeleDongle Device from the list provided. + Select this button and then select a TeleDongle or TeleBT Device from the list provided. The first few lines of the dialog provide information about the @@ -3418,9 +3692,9 @@ NAR #88757, TRA #12200 individual configuration entries. - Note that the TeleDongle itself doesn't save any configuration + Note that TeleDongle and TeleBT don't save any configuration data, the settings here are recorded on the local machine in - the Java preferences database. Moving the TeleDongle to + the Java preferences database. Moving the device to another machine, or using a different user account on the same machine will cause settings made here to have no effect. @@ -3472,15 +3746,23 @@ NAR #88757, TRA #12200
- Radio Calibration + RF Calibration The radios in every Altus Metrum device are calibrated at the factory to ensure that they transmit and receive on the - specified frequency. To change a TeleDongle's calibration, + specified frequency. To change a TeleDongle or TeleBT's calibration, you must reprogram the unit completely, so this entry simply shows the current value and doesn't allow any changes.
+
+ Telemetry Rate + + This lets you match the telemetry and packet link rate from + the transmitter. If they don't match, the device won't + receive any data. + +
Flash Image @@ -3488,7 +3770,7 @@ NAR #88757, TRA #12200 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 + programming dongle (pair programming). TeleMega, EasyMega, 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. @@ -3540,9 +3822,9 @@ NAR #88757, TRA #12200 This listens for telemetry packets on all of the configured frequencies, displaying information about each device it - receives a packet from. You can select which of the three - telemetry formats should be tried; by default, it only listens - for the standard telemetry packets used in v1.0 and later + receives a packet from. You can select which of the baud rates + and telemetry formats should be tried; by default, it only listens + at 38400 baud with the standard telemetry format used in v1.0 and later firmware.
@@ -3825,12 +4107,12 @@ NAR #88757, TRA #12200 In the rocket itself, you just need a flight computer and a single-cell, 3.7 volt nominal Li-Po rechargeable battery. An 850mAh battery weighs less than a 9V alkaline battery, and will - run a TeleMetrum or TeleMega for hours. + run a TeleMetrum, TeleMega or EasyMega for hours. A 110mAh battery weighs less than a triple A battery and is a good - choice for use with TeleMini. + choice for use with TeleMini or EasyMini. - By default, we ship flight computers with a simple wire antenna. + By default, we ship TeleMini, TeleMetrum and TeleMega flight computers with a simple wire antenna. If your electronics bay or the air-frame it resides within is made of carbon fiber, which is opaque to RF signals, you may prefer to install an SMA connector so that you can run a coaxial cable to an @@ -3884,8 +4166,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 - currently uses a Yaesu VX-7R, Bdale has a Baofung UV-5R - which isn't as nice, but was a whole lot cheaper. + currently uses a Yaesu FT1D, Bdale has a Yaesu VX-7R, which + is a nicer radio in most ways but doesn't support APRS. So, to recap, on the ground the hardware you'll need includes: @@ -3951,14 +4233,10 @@ NAR #88757, TRA #12200
Future Plans - - We've designed a simple GPS based radio tracker called TeleGPS. - If all goes well, we hope to introduce this in the first - half of 2014. - We have designed and prototyped several “companion boards” that - can attach to the companion connector on TeleMetrum and TeleMega + can attach to the companion connector on TeleMetrum, + TeleMega and EasyMega flight computers to collect more data, provide more pyro channels, and so forth. We do not yet know if or when any of these boards will be produced in enough quantity to sell. If you have specific @@ -4007,8 +4285,8 @@ NAR #88757, TRA #12200 - Make sure accelerometer-equipped products like TeleMetrum and - TeleMega are aligned precisely along the axis of + Make sure accelerometer-equipped products like TeleMetrum, + TeleMega and EasyMega are aligned precisely along the axis of acceleration so that the accelerometer can accurately capture data during the flight. @@ -4218,7 +4496,7 @@ NAR #88757, TRA #12200 Updating Device Firmware - TeleMega, TeleMetrum v2 and EasyMini are all programmed directly + TeleMega, TeleMetrum v2, EasyMega 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 @@ -4241,12 +4519,12 @@ NAR #88757, TRA #12200 performance slightly. - Self-programmable devices (TeleMega, TeleMetrum v2 and EasyMini) + Self-programmable devices (TeleMega, TeleMetrum v2, EasyMega and EasyMini) are reprogrammed by connecting them to your computer over USB
- Updating TeleMega, TeleMetrum v2 or EasyMini Firmware + Updating TeleMega, TeleMetrum v2, EasyMega or EasyMini Firmware @@ -4327,6 +4605,20 @@ NAR #88757, TRA #12200 + + EasyMega + + + 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 @@ -4758,6 +5050,67 @@ NAR #88757, TRA #12200
+
+ + EasyMega Specifications + + + + + Recording altimeter for model rocketry. + + + + + Supports dual deployment and four auxiliary pyro channels + (a total of 6 events). + + + + + 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 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. + + + + + Can use either main system Li-Po or optional separate pyro battery + to fire e-matches. + + + + + 1.25 x 1.25 inch board designed to fit inside 38mm air-frame coupler tube. + + + +
TeleMetrum v2 Specifications @@ -5316,6 +5669,21 @@ NAR #88757, TRA #12200 </mediaobject> </informalfigure> </section> + <section> + <title>EasyMega template + + EasyMega has overall dimensions of 1.250 x 2.250 inches, and + the mounting holes are sized for use with 4-40 or M3 screws. + + + + + + + + +
TeleMetrum template @@ -5366,7 +5734,7 @@ NAR #88757, TRA #12200 Calibration There are only two calibrations required for TeleMetrum and - TeleMega, and only one for TeleDongle, TeleMini and EasyMini. + TeleMega, and only one for EasyMega, 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 @@ -5418,7 +5786,7 @@ NAR #88757, TRA #12200
- TeleMetrum and TeleMega Accelerometers + TeleMetrum, TeleMega and EasyMega Accelerometers While barometric sensors are factory-calibrated, accelerometers are not, and so each must be calibrated once @@ -5445,7 +5813,7 @@ NAR #88757, TRA #12200 In the unlikely event an accel cal goes badly, it is possible - that TeleMetrum or TeleMega may always come up in 'pad mode' + that TeleMetrum, TeleMega or EasyMega 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 @@ -5465,12 +5833,19 @@ NAR #88757, TRA #12200 Release Notes - Version 1.41 + Version 1.4.1 + + Version 1.5 + + Version 1.4 + +
+ EasyMega Outline and Hole Pattern + + This image, when printed, provides a precise template for the + mounting holes in EasyMega. EasyMega has overall dimensions + of 1.250 x 2.250 inches, and the mounting holes are sized for + use with 4-40 or M3 screws. + + + + + + + + +
+ + diff --git a/doc/easymega-v1.0-bottom.jpg b/doc/easymega-v1.0-bottom.jpg new file mode 100644 index 00000000..be46f14f Binary files /dev/null and b/doc/easymega-v1.0-bottom.jpg differ diff --git a/doc/easymega-v1.0-top.jpg b/doc/easymega-v1.0-top.jpg new file mode 100644 index 00000000..4526f659 Binary files /dev/null and b/doc/easymega-v1.0-top.jpg differ diff --git a/doc/easymega.svg b/doc/easymega.svg new file mode 100644 index 00000000..6d9d766f --- /dev/null +++ b/doc/easymega.svg @@ -0,0 +1,33 @@ + + + + + + + + + + + + + + + + EasyMega + + UP + + + diff --git a/doc/release-notes-1.5.xsl b/doc/release-notes-1.5.xsl new file mode 100644 index 00000000..50d83f77 --- /dev/null +++ b/doc/release-notes-1.5.xsl @@ -0,0 +1,121 @@ + + + +
+ + Version 1.5 is a major release. It includes support for our new + EasyMega product, new features and bug fixes in in the flight + software for all our boards and the AltosUI ground station + + + AltOS New Features + + + + Add support for EasyMega boards. + + + + + Make the APRS SSID be configurable. This lets you track + different rockets on the same receiver without getting + things mixed up. + + + + + Report extra pyro channel continuity state on EasyMega and + TeleMega via the beeper. This lets you easily verify flight + readiness on these boards after powering up the electronics + on the rail. + + + + + Add lower telemetry data rates (2400 and 9600 bps) to + increase telemetry radio range. This reduces the amount of + data received as well as increasing battery consumption in + the transmitter. + + + + + Change TeleGPS to have only a single log, and append new + data to it rather than using seperate per-flight logs. This + avoids accidentally filling up log storage by turning + TeleGPS on/off several times. + + + + + + AltOS Fixes + + + + Increase the maximum range for altitude values from +/-32767m + to +/-2147483647m, allowing the flight computers to function + correctly above the 32km level. + + + + + Continuously test pyro firing conditions during delay stage, + inhibiting the pyro channel if the test fails. This prevents + firing pyro charges where the conditions were good before + the delay, but become bad before the delay expires. + + + + + Allow negative numbers in pyro configuration values. This + lets you specify things like descending speed or + deceleration. + + + + + + AltosUI and TeleGPS New Features + + + + Support telemetry baud rate selection. Adds menus to + the flight monitoring and configuration for baud rate + selection. + + + + + Support APRS SSID configuration. + + + + + Integrate with file managers. This provides icons for all of + our file types and associates our application with the files + so that using a file manager to open a AltOS data file + results in launching our application. + + + + + + AltosUI Fixes + + + + Make the 'Graph' button on the landed tab work again. + + + + + Make tests for Java on Windows a bit smarter, and also + provide the user with the option to skip installing Java for + cases where we just can't figure out what version is installed. + + + + +
diff --git a/doc/scan-channels.png b/doc/scan-channels.png index bf6b6e53..e45880cd 100644 Binary files a/doc/scan-channels.png and b/doc/scan-channels.png differ