Projects/AVRISP_Programmer/AVRISP_Programmer.txt

   1 /** \file
   2  *
   3  *  This file contains special DoxyGen information for the generation of the main page and other special
   4  *  documentation pages. It is not a project source file.
   5  */
   6
   7 /** \mainpage AVRISP_Programmer
   8  *
   9  *  Communications Device Class demonstration application.
  10  *  This gives a simple reference application for implementing
  11  *  a USB to Serial converter using the CDC class.  Data communicated
  12  *  over the USB Virtual Serial Port according to Atmel's AVR910
  13  *  protocol is used to program AVR MCUs that are
  14  *  "In-System Programmable via SPI Port".
  15  *
  16  *  After running this firmware for the first time on a new computer,
  17  *  you will need to supply the .INF file located in this demo
  18  *  project's directory as the device's driver when running under
  19  *  Windows. This will enable Windows to use its inbuilt CDC drivers,
  20  *  negating the need for custom drivers for the device. Other
  21  *  Operating Systems should automatically use their own inbuilt
  22  *  CDC-ACM drivers.
  23  *
  24  *  Usage:
  25  *   avrdude -vv -F -P COM7 -c avr910 -p t261
  26  *     Note -F flag which overrides signature check and enables programming
  27  *     of any "In-System Programmable via SPI Port" AVR MCU.  Part number,
  28  *     t261, should be set to your target device.
  29  *   avrdude -vv -F -P COM7 -c avr910 -p t261 -U flash:w:PROG.hex
  30  *     PROG.hex is the hex file to program your t261 AVR with
  31  *   avrdude -vv -F -P COM7 -b 115200 -c avr910 -p t261 -U flash:w:test.hex
  32  *     The -b 115200 sets the SPI clock to 62.5kHz from the default 125kHz and may
  33  *     work when the default programming speed fails.
  34  * AVROSP.exe -dATtiny261 -cCOM7 -rf
  35  *     AVRosp is the Open Source AVR ISP Programming Software available from Atmel.com
  36  *
  37  *  Note: on Linux systems, COM7 should be replaced with someting like /dev/ttyACM0
  38  *        You can determine this value by running dmesg after plugging in the device
  39  *  Note: you must RESET the programmer after each use (AVRdude session).
  40  *
  41  *  Note: If you experience errors with older devices, try changing DELAY_LONG
  42  *  to a larger value, such as 0xFF in AVRISP_Programmer.c
  43  *
  44  *  MISO, MOSI, and SCK are connected directly from the AVRopendous board
  45  *  to the pin of the same functionality on the target.  RESET pin on the target
  46  *  can be connected either to SS (PB0), or PC2.  Do not have any other pins
  47  *  connected - especially HWB pin, to avoid unintentional behaviour.
  48  *
  49  *  AVR910 functionality was overlayed on USBtoSerial  functionality.
  50  *  Keep this in mind when looking over the code.
  51  *  Default target speed is 125kHz and corresponds to 19200 baud, which
  52  *  is the default setting for AVRdude.
  53  *
  54  *  Changing "Baud-Rate" will change the SPI speed.  Defualt SPI clock speed
  55  *  is 8Mhz / 4 = 2MHz.  8Mhz is the device clock speed.  This is the setting at
  56  *  9600 baud.  The following is a table of baud-rate vs. SPI Speed that will result
  57  *       9600 = 2Mhz
  58  *       14400 = 1MHz
  59  *       19200 = 125kHz (AVRdude Default)
  60  *       38400 = 250kHz
  61  *       57600 = 500kHz
  62  *       115200 = 62.5kHz
  63  *
  64  *
  65  *
  66  *
  67  *  <table>
  68  *   <tr>
  69  *    <td><b>USB Mode:</b></td>
  70  *    <td>Device</td>
  71  *   </tr>
  72  *   <tr>
  73  *    <td><b>USB Class:</b></td>
  74  *    <td>Communications Device Class (CDC)</td>
  75  *   </tr>
  76  *   <tr>
  77  *    <td><b>USB Subclass:</b></td>
  78  *    <td>Abstract Control Model (ACM)</td>
  79  *   </tr>
  80  *   <tr>
  81  *    <td><b>Relevant Standards:</b></td>
  82  *    <td>USBIF CDC Class Standard</td>
  83  *   </tr>
  84  *   <tr>
  85  *    <td><b>Usable Speeds:</b></td>
  86  *    <td>Full Speed Mode</td>
  87  *   </tr>
  88  *  </table>
  89  */