first cut at turnon scripts for EasyTimer v2

[fw/altos] / doc / updating-firmware.inc

diff --git a/doc/updating-firmware.inc b/doc/updating-firmware.inc
index d734f89828b5e093279b1b846ad622945799720d..e2e1388a74c4bcda591cb6985c75e1ae5d0aa4b9 100644 (file)
--- a/doc/updating-firmware.inc
+++ b/doc/updating-firmware.inc
@@ -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[]
@@ -17,6 +17,15 @@
        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.
@@ -28,7 +37,7 @@
 
        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[]
@@ -44,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.
 
@@ -84,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
@@ -97,7 +107,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
@@ -105,12 +115,22 @@
                        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
@@ -124,10 +144,22 @@
                        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::