X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/e1c1c256192c099f5bfa23946c050aa5954aca4a..c2de01b66186f8f195b6d19c311a67d1aede6d57:/Projects/AVRISP-MKII/AVRISP.txt

diff --git a/Projects/AVRISP-MKII/AVRISP.txt b/Projects/AVRISP-MKII/AVRISP.txt
index 9bed59e56..feccfcabe 100644
--- a/Projects/AVRISP-MKII/AVRISP.txt
+++ b/Projects/AVRISP-MKII/AVRISP.txt
@@ -53,7 +53,7 @@
  *  This device spoofs Atmel's official AVRISP-MKII device PID so that it remains compatible with Atmel's AVRISP-MKII
  *  drivers. When prompted, direct your OS to install Atmel's AVRISP-MKII drivers provided with AVRStudio.
  *
- *  Note that this design currently has several limitations:
+ *  Note that this design currently has the following limitations:
  *    - Minimum ISP target clock speed of 500KHz due to hardware SPI module prescaler limitations
  *    - No reversed/shorted target connector detection and notification
  *
@@ -62,7 +62,9 @@
  *  without an ADC converter, VTARGET will report a fixed 5V level at all times.
  *
  *  When compiled for the XPLAIN board target, this will automatically configure itself for the correct connections to the
- *  XPLAIN's XMEGA AVR, and will enable PDI/TPI only programming support (since ISP mode is not needed).
+ *  XPLAIN's XMEGA AVR, and will enable PDI/TPI only programming support (since ISP mode is not needed). Note that the
+ *  first revision XPLAIN board lacks a bootloader on the AT90USB1287, and thus for this firmware to be loaded, an external
+ *  programmer will be required.
  *
  *  While this application can be compiled for USB AVRs with as little as 8KB of FLASH, for full functionality 16KB or more
  *  of FLASH is required. On 8KB devices, ISP or PDI/TPI programming support can be disabled to reduce program size.
@@ -108,6 +110,10 @@
  *   </tr>
  *  </table>
  *
+ *  In addition, the AVR's XCK pin will generate a .5MHz clock when SPI programming is used, to act as an external
+ *  device clock if the fuses have been mis-set. To use the recovery clock, connect XCK to the target AVR's XTAL1
+ *  pin, and set the ISP programming speed to 125KHz or below.
+ *
  *  <b><sup>1</sup></b> <i>Optional, see \ref SSec_Options section - for USB AVRs with ADC modules only</i> \n
  *  <b><sup>2</sup></b> <i>See AUX line related tokens in the \ref SSec_Options section</i>
  *
@@ -121,7 +127,7 @@
  *    <td><b>PDI 6 Pin Layout:</b></td>
  *   </tr>
  *   <tr>
- *    <td>MISO</td>
+ *    <td>MISO <b><sup>2</sup></b></td>
  *    <td>DATA</td>
  *    <td>1</td>
  *   </tr>
@@ -141,7 +147,7 @@
  *    <td>4</td>
  *   </tr>
  *   <tr>
- *    <td>PORTx.y <b><sup>2</sup></b></td>
+ *    <td>PORTx.y <b><sup>2, 3</sup></b></td>
  *    <td>CLOCK</td>
  *    <td>5</td>
  *   </tr>
@@ -152,9 +158,10 @@
  *   </tr>
  *  </table>
  *
- *  <b><sup>1</sup></b> <i>When XPROG_VIA_HARDWARE_USART is set, the AVR's Tx and Rx become the DATA line when connected together
- *                         via a pair of 300 ohm resistors, and the AVR's XCK pin becomes CLOCK.</i> \n
- *  <b><sup>2</sup></b> <i>See AUX line related tokens in the \ref SSec_Options section</i>
+ *  <b><sup>1</sup></b> <i>Optional, see \ref SSec_Options section - for USB AVRs with ADC modules only</i> \n
+ *  <b><sup>2</sup></b> <i>When XPROG_VIA_HARDWARE_USART is set, the AVR's Tx and Rx become the DATA line when connected together
+ *                         via a pair of 220 ohm resistors, and the AVR's XCK pin becomes CLOCK.</i> \n
+ *  <b><sup>3</sup></b> <i>See AUX line related tokens in the \ref SSec_Options section</i>
  *
  *  \section Sec_TPI TPI Connections
  *  Connections to the device for TPI programming<b><sup>1</sup></b> (when enabled):
@@ -166,7 +173,7 @@
  *    <td><b>TPI 6 Pin Layout:</b></td>
  *   </tr>
  *   <tr>
- *    <td>MISO</td>
+ *    <td>MISO <b><sup>2</sup></b></td>
  *    <td>DATA</td>
  *    <td>1</td>
  *   </tr>
@@ -176,7 +183,7 @@
  *    <td>2</td>
  *   </tr>
  *   <tr>
- *    <td>SCLK</td>
+ *    <td>SCLK <b><sup>2</sup></b></td>
  *    <td>CLOCK</td>
  *    <td>3</td>
  *   </tr>
@@ -186,7 +193,7 @@
  *    <td>4</td>
  *   </tr>
  *   <tr>
- *    <td>PORTx.y <b><sup>2</sup></b></td>
+ *    <td>PORTx.y <b><sup>3</sup></b></td>
  *    <td>/RESET</td>
  *    <td>5</td>
  *   </tr>
@@ -197,9 +204,10 @@
  *   </tr>
  *  </table>
  *
- *  <b><sup>1</sup></b> <i>When XPROG_VIA_HARDWARE_USART is set, the AVR's Tx and Rx become the DATA line when connected together
- *                         via a pair of 300 ohm resistors, and the AVR's XCK pin becomes CLOCK.</i> \n
- *  <b><sup>2</sup></b> <i>See AUX line related tokens in the \ref SSec_Options section</i>
+ *  <b><sup>1</sup></b> <i>Optional, see \ref SSec_Options section - for USB AVRs with ADC modules only</i> \n
+ *  <b><sup>2</sup></b> <i>When XPROG_VIA_HARDWARE_USART is set, the AVR's Tx and Rx become the DATA line when connected together
+ *                         via a pair of 220 ohm resistors, and the AVR's XCK pin becomes CLOCK.</i> \n
+ *  <b><sup>3</sup></b> <i>See AUX line related tokens in the \ref SSec_Options section</i>
  *
  *  \section SSec_Options Project Options
  *
@@ -239,7 +247,7 @@
  *   <tr>
  *    <td>VTARGET_ADC_CHANNEL</td>
  *    <td>Makefile CDEFS</td>
- *    <td>ADC channel number (on supported AVRs) to use for VTARGET level detection.</td> 
+ *    <td>ADC channel number (on supported AVRs) to use for VTARGET level detection, if NO_VTARGET_DETECT is not defined.</td> 
  *   </tr>
  *   <tr>
  *    <td>ENABLE_ISP_PROTOCOL</td>
@@ -259,5 +267,11 @@
  *        seperate ISP, PDI, and TPI programming headers) but increases programming speed dramatically.
  *        <i>Ignored when compiled for the XPLAIN board.</i></td>  
  *   </tr>
+ *   <tr>
+ *    <td>NO_VTARGET_DETECT</td>
+ *    <td>Makefile CDEFS</td>
+ *    <td>Define to disable VTARGET sampling and reporting on AVR models with an ADC converter. This will cause the programmer
+ *        to report a fixed 5V target voltage to the host regardless of the real target voltage.</td>  
+ *   </tr>
  *  </table>
  */