first cut at turnon scripts for EasyTimer v2
[fw/altos] / doc / updating-firmware.inc
index 91aa58f2b3309c87cc00edc79da6362f61c211e3..e2e1388a74c4bcda591cb6985c75e1ae5d0aa4b9 100644 (file)
@@ -2,7 +2,7 @@
 == Updating Device Firmware
 
        ifdef::telemega[]
-       TeleMega, TeleMetrum v2, EasyMega, EasyMini and TeleDongle v3
+       TeleMega, TeleMetrum v2 and newer, EasyMega, EasyMini and TeleDongle v3
        are all
        endif::telemega[]
        ifndef::telemega[]
        you have before trying to reprogram them.
        endif::telemega[]
 
+       TeleMini v3 can be updated directly over USB, but has no USB connector
+       on the board.  Instead, the USB signals are present on a row of 6
+       holes adjacent to the copyright assertion in the silk screen.  Thus, 
+       updating firmware on TeleMini v3 requires making up a special cable, 
+       after which you can treat it just like TeleMetrum or TeleMega.  Many
+       USB cables seem to follow the color code of red is +5V, black is GND,
+       green is USB +, and white is USB -.  On TeleMini v3, pin 3 which has 
+       a square copper pad is ground, pin 1 is USB -, and pin 2 is USB +.  
+
        You may wish to begin by ensuring you have current firmware
        images.  These are distributed as part of the AltOS software
        bundle that also includes the AltosUI ground station program.
        http://www.altusmetrum.org/AltOS/
 
        ifdef::telemega[]
-       === Updating TeleMega, TeleMetrum v2, EasyMega, EasyMini or TeleDongle v3 Firmware
+
+       === Updating TeleMega, TeleMetrum v2 or newer, TeleMini v3, EasyMega, EasyMini, TeleDongle v3 or TeleBT v3 Firmware
+
        endif::telemega[]
        ifndef::telemega[]
+
        === Updating EasyMini Firmware
+
        endif::telemega[]
 
                Self-programmable devices are reprogrammed by
@@ -40,7 +53,8 @@
                  the target device. Power up the device.
 
                . Using a Micro USB cable, connect the target device to your
-                 computer's USB socket.
+                 computer's USB socket.  If the target is a TeleMini v3,
+                 make up and attach a special USB cable.
 
                . Run AltosUI, and select 'Flash Image' from the File menu.
 
@@ -80,7 +94,7 @@
 
                        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
+                       around it, and then the pins count 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
 
                        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
+                       around it, and then the pins count 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
                        the board.
                        endif::easymega[]
 
+                       ifdef::easytimer[]
+                       EasyTimer::
+
+                       Connect pin 5 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 count sequentially across the board, making Pin 5
+                       the one on the other end of the row.
+                       endif::easytimer[]
+
                        ifdef::telemetrum[]
-                       TeleMetrum v2::
+                       TeleMetrum v2 and newer::
 
                        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
+                       around it, and then the pins count 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
                        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
+                       pins count sequentially across the board, making Pin 6
                        the one on the other end of the row.
                        endif::easymini[]
 
+                       TeleGPS v1::
+
+                       Connect pin 32 on the CPU to ground.  Pin 32 is the
+                       right-most pin on the bottom edge of the CPU when the
+                       board is oriented with the USB and battery connectors
+                       to the right.
+
+                       TeleGPS v2::
+
+                       Connect together pins 1 and 5 of the Debug connector.
+                       Pin 1 is the pin with the square pad around the hole.
+
                        ifdef::telemetrum[]
                        TeleDongle v3::
 
                        to the USB wires on the row of pins towards the center
                        of the board. Ground is available on the capacitor
                        next to it, on the end towards the USB wires.
+                       
+                       TeleBT v3::
+
+                       Connect pin 4 on the CPU to 3.3V, which can be done by
+                       connecting pin 1 to pin 4.  Pin 1 is the left pin on
+                       the lower edge of the chip when the unit is oriented
+                       such that the SMA is at the top.
+
+                       TeleBT v4::
+
+                       Connect pin 30 on the CPU to ground. Pin 30 is the 6th
+                       pin from the right on the top when the unit is oriented
+                       such that the SMA is at the top.
                        endif::telemetrum[]
 
                        Once you've located the right pins: