X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/8ecdc2b1441417bf97661a3d3edd17a5afd707bf..c2de01b66186f8f195b6d19c311a67d1aede6d57:/Projects/AVRISP-MKII/AVRISP.txt
diff --git a/Projects/AVRISP-MKII/AVRISP.txt b/Projects/AVRISP-MKII/AVRISP.txt
index f39e68f2c..feccfcabe 100644
--- a/Projects/AVRISP-MKII/AVRISP.txt
+++ b/Projects/AVRISP-MKII/AVRISP.txt
@@ -53,19 +53,21 @@
* 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:
- * - Minimum ISP target clock speed of 500KHz due to hardware SPI used
+ * 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
*
* On AVR models with an ADC converter, AVCC should be tied to 5V (e.g. VBUS) and the VTARGET_ADC_CHANNEL token should be
* set to an appropriate ADC channel number in the project makefile for VTARGET detection to operate correctly. On models
- * without an ADC converter, VTARGET will report at a fixed 5V level.
+ * 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 only programming support (since ISP and TPI modes are 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, PDI or TPI programming support can be disabled to reduce program size.
+ * of FLASH is required. On 8KB devices, ISP or PDI/TPI programming support can be disabled to reduce program size.
*
* \section Sec_ISP ISP Connections
* Connections to the device for SPI programming (when enabled):
@@ -108,8 +110,12 @@
*
*
*
+ * 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.
+ *
* 1 Optional, see \ref SSec_Options section - for USB AVRs with ADC modules only \n
- * 2 See \ref SSec_Options section
+ * 2 See AUX line related tokens in the \ref SSec_Options section
*
* \section Sec_PDI PDI Connections
* Connections to the device for PDI programming1 (when enabled):
@@ -121,7 +127,7 @@
* | PDI 6 Pin Layout: |
*
*
- * | MISO |
+ * MISO 2 |
* DATA |
* 1 |
*
@@ -141,7 +147,7 @@
* 4 |
*
*
- * | PORTx.y 2 |
+ * PORTx.y 2, 3 |
* CLOCK |
* 5 |
*
@@ -152,8 +158,10 @@
*
*
*
- * 1 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.
+ * 1 Optional, see \ref SSec_Options section - for USB AVRs with ADC modules only \n
+ * 2 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. \n
+ * 3 See AUX line related tokens in the \ref SSec_Options section
*
* \section Sec_TPI TPI Connections
* Connections to the device for TPI programming1 (when enabled):
@@ -165,7 +173,7 @@
* TPI 6 Pin Layout: |
*
*
- * | MISO |
+ * MISO 2 |
* DATA |
* 1 |
*
@@ -175,7 +183,7 @@
* 2 |
*
*
- * | SCLK |
+ * SCLK 2 |
* CLOCK |
* 3 |
*
@@ -185,7 +193,7 @@
* 4 |
*
*
- * | PORTx.y 2 |
+ * PORTx.y 3 |
* /RESET |
* 5 |
*
@@ -196,8 +204,10 @@
*
*
*
- * 1 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.
+ * 1 Optional, see \ref SSec_Options section - for USB AVRs with ADC modules only \n
+ * 2 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. \n
+ * 3 See AUX line related tokens in the \ref SSec_Options section
*
* \section SSec_Options Project Options
*
@@ -210,32 +220,34 @@
* Description: |
*
*
- * | RESET_LINE_PORT |
+ * AUX_LINE_PORT |
* Makefile CDEFS |
- * PORT register for the programmer's target RESET line. Ignored when compiled for the XPLAIN board. |
+ * PORT register for the programmer's AUX target line. The use of this line varies between the programming protocols,
+ * but is generally used for the target's /RESET line. Ignored when compiled for the XPLAIN board. |
*
*
- * | RESET_LINE_PIN |
+ * AUX_LINE_PIN |
* Makefile CDEFS |
- * PIN register for the programmer's target RESET line. Ignored when compiled for the XPLAIN board. |
+ * PIN register for the programmer's AUX target line. The use of this line varies between the programming protocols,
+ * but is generally used for the target's /RESET line. Ignored when compiled for the XPLAIN board. |
*
*
- * | RESET_LINE_DDR |
+ * AUX_LINE_DDR |
* Makefile CDEFS |
- * DDR register for the programmer's target RESET line. Ignored when compiled for the XPLAIN board. |
+ * DDR register for the programmer's AUX target line. The use of this line varies between the programming protocols,
+ * but is generally used for the target's /RESET line. Ignored when compiled for the XPLAIN board. |
*
*
- * | RESET_LINE_MASK |
+ * AUX_LINE_MASK |
* Makefile CDEFS |
- * Mask for the programmer's target RESET line on the chosen port. Must not be the AVR's /SS pin, as the
- * target pins are tri-stated when not in use, and low signals on the /SS pin will force SPI slave mode when the
- * pin is configured as an input. When in PDI programming mode, this is the target clock pin.
- * Ignored when compiled for the XPLAIN board. |
+ * Mask for the programmer's AUX target line. The use of this line varies between the programming protocols,
+ * but is generally used for the target's /RESET line. Must not be the AVR's /SS pin. Ignored when
+ * compiled for the XPLAIN board. |
*
*
* | VTARGET_ADC_CHANNEL |
* Makefile CDEFS |
- * ADC channel number (on supported AVRs) to use for VTARGET level detection. |
+ * ADC channel number (on supported AVRs) to use for VTARGET level detection, if NO_VTARGET_DETECT is not defined. |
*
*
* | ENABLE_ISP_PROTOCOL |
@@ -250,10 +262,16 @@
*
* | XPROG_VIA_HARDWARE_USART |
* Makefile CDEFS |
- * Define to force the PDI and TPI protocols (when enabled) to use the much faster hardware USART instead of bit-banging to
- * match the official AVRISP pinout. This breaks pinout compatibility with the official AVRISP MKII (and requires
- * seperate ISP and PDI/TPI programming headers) but increases programming speed dramatically.
+ * | Define to force the PDI and TPI protocols (when enabled) to use the much faster hardware USART instead of bit-banging
+ * to match the official AVRISP pinout. This breaks pinout compatibility with the official AVRISP MKII (and requires
+ * seperate ISP, PDI, and TPI programming headers) but increases programming speed dramatically.
* Ignored when compiled for the XPLAIN board. |
*
+ *
+ * | NO_VTARGET_DETECT |
+ * Makefile CDEFS |
+ * 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. |
+ *
*
*/