Newer AS7 integration binary, with ASF detection fixes and newer image assets.

[pub/USBasp.git] / Projects / AVRISP-MKII / AVRISP-MKII.txt

diff --git a/Projects/AVRISP-MKII/AVRISP-MKII.txt b/Projects/AVRISP-MKII/AVRISP-MKII.txt
index d4eaa17..1ac602b 100644 (file)
--- a/Projects/AVRISP-MKII/AVRISP-MKII.txt
+++ b/Projects/AVRISP-MKII/AVRISP-MKII.txt
@@ -67,6 +67,25 @@
  *  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 protocol programming support can be disabled to reduce program size.
  *
+ *  \section Sec_KnownIssues Known Issues:
+ *
+ *  \par Incompatible with newer AVRDUDE releases.
+ *  Due to <a href="http://savannah.nongnu.org/bugs/index.php?40831">a change in 6.0.1 and never AVRDUDE releases</a>,
+ *  these builds are incompatible with the AVRISP-MKII clone project. Use an older 5.x release until AVRDUDE is patched.
+ *
+ *  \par XMEGA EEPROM programming fails in some cases.
+ *  Several users have reported that XMEGA EEPROM programming fails unless the chip is erased first. If a non-blank EEPROM
+ *  is present, writing further EEPROM data causes corruption.
+ *  <a href="https://github.com/abcminiuser/lufa/issues/25">LUFA issue tracker entry</a>.
+ *
+ *  \par Does not work with Atmel Studio 6.2 or newer in some cases.
+ *  If the libUSB filter driver is used to bind both libUSB and Jungo drivers to the clone device at the same time, it will
+ *  no longer work in Atmel Studio 6.2 and newer. This is due to a change in the latter; Atmel Studio now supports both
+ *  drivers for various tools, but while the libUSB driver is given preference the inner workings of Atmel Studio cannot
+ *  communicate with the AVR-ISP MKII with libUSB (this is true for the genuine tool also). Uninstall the filter driver and
+ *  install only the standard libUSB driver, or Jungo driver. The \c RESET_TOGGLES_LIBUSB_COMPAT compile option (detailed
+ *  below) is a suitable workaround to this issue.
+ *
  *  \section Sec_Installation Installation
  *  The programmer supports multiple platforms, both Windows and Linux.
  *
@@ -87,19 +106,34 @@
  *  with your compiled copy of AVRDude, or create them using the libUSB-Win32 (http://sourceforge.net/projects/libusb-win32)
  *  project.
  *
- *  For convenience, the programmer will report two different serial numbers depending on the firmware compatibity mode, so
+ *  For convenience, the programmer will report two different serial numbers depending on the firmware compatibility mode, so
  *  that the correct driver can be installed for the matching firmware. If the \c RESET_TOGGLES_LIBUSB_COMPAT compile option
  *  is used (see \ref Sec_Options) this allows for an easy way to automatically switch device drivers along with the firmware
- *  compatibility mode.
+ *  compatibility mode. The serials are:
+ *
+ *  <table>
+ *   <tr>
+ *    <th><b>Serial Number:</b></th>
+ *    <th><b>Compatibility Mode:</b></th>
+ *   </tr>
+ *   <tr>
+ *    <td>000200012345</td>
+ *    <td>Jungo (Atmel Studio) Compatibility</td>
+ *   </tr>
+ *   <tr>
+ *    <td>000200112345</td>
+ *    <td>libUSB Compatibility</td>
+ *   </tr>
+ *  </table>
  *
  *  \section Sec_ISP ISP Connections
  *  Connections to the device for SPI programming (when enabled):
  *
  *  <table>
  *   <tr>
- *    <td><b>Programmer Pin:</b></td>
- *    <td><b>Target Device Pin:</b></td>
- *    <td><b>ISP 6 Pin Layout:</b></td>
+ *    <th><b>Programmer Pin:</b></th>
+ *    <th><b>Target Device Pin:</b></th>
+ *    <th><b>ISP 6 Pin Layout:</b></th>
  *   </tr>
  *   <tr>
  *    <td>MISO</td>
@@ -145,9 +179,9 @@
  *
  *  <table>
  *   <tr>
- *    <td><b>Programmer Pin:</b></td>
- *    <td><b>Target Device Pin:</b></td>
- *    <td><b>PDI 6 Pin Layout:</b></td>
+ *    <th><b>Programmer Pin:</b></th>
+ *    <th><b>Target Device Pin:</b></th>
+ *    <th><b>PDI 6 Pin Layout:</b></th>
  *   </tr>
  *   <tr>
  *    <td>Tx/Rx <b><sup>2</sup></b></td>
@@ -189,9 +223,9 @@
  *
  *  <table>
  *   <tr>
- *    <td><b>Programmer Pin:</b></td>
- *    <td><b>Target Device Pin:</b></td>
- *    <td><b>TPI 6 Pin Layout:</b></td>
+ *    <th><b>Programmer Pin:</b></th>
+ *    <th><b>Target Device Pin:</b></th>
+ *    <th><b>TPI 6 Pin Layout:</b></th>
  *   </tr>
  *   <tr>
  *    <td>Tx/Rx <b><sup>2</sup></b></td>
@@ -235,9 +269,9 @@
  *
  *  <table>
  *   <tr>
- *    <td><b>Define Name:</b></td>
- *    <td><b>Location:</b></td>
- *    <td><b>Description:</b></td>
+ *    <th><b>Define Name:</b></th>
+ *    <th><b>Location:</b></th>
+ *    <th><b>Description:</b></th>
  *   </tr>
  *   <tr>
  *    <td>AUX_LINE_PORT</td>
@@ -289,7 +323,7 @@
  *    <td>NO_VTARGET_DETECT</td>
  *    <td>AppConfig.h</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 3.3V target voltage to the host regardless of the real target voltage. 
+ *        to report a fixed 3.3V target voltage to the host regardless of the real target voltage.
  *        \n \n <i>Ignored when compiled for targets lacking an ADC.</i></td>
  *   </tr>
  *   <tr>