77 lines
3.4 KiB
Plaintext
77 lines
3.4 KiB
Plaintext
This is the Readme file to Objective Development's firmware-only USB driver
|
|
for Atmel AVR microcontrollers and related code. For more information please
|
|
visit http://www.obdev.at/avrusb/.
|
|
|
|
|
|
WHAT IS INCLUDED IN THIS PACKAGE?
|
|
=================================
|
|
This package consists of the device side USB driver firmware, library code
|
|
for device and host and fully working examples for device and host:
|
|
|
|
Readme.txt .............. The file you are currently reading.
|
|
usbdrv .................. AVR-USB firmware, to be included in your project.
|
|
examples ................ Example code for device and host side.
|
|
libs-device ............. Useful code snippets for the device firmware.
|
|
libs-host ............... Useful code snippets for device drivers.
|
|
circuits ................ Example circuits using this driver.
|
|
Changelog.txt ........... Documentation of changes between versions.
|
|
License.txt ............. Free Open Source license for this package (GPL).
|
|
CommercialLicense.txt ... Alternative commercial license for this package.
|
|
USBID-License.txt ....... Terms and conditions for free USB VID/PID pairs.
|
|
|
|
Each subdirectory contains a separate Readme file which explains its
|
|
contents.
|
|
|
|
|
|
PREREQUISITES
|
|
=============
|
|
The AVR code of AVR-USB is written in C and assembler. You need either
|
|
avr-gcc or IAR CC to compile the project. We recommend avr-gcc because it
|
|
is free and easily available. Gcc version 3 generates slightly more
|
|
efficient code than version 4 for AVR-USB. Not every release is tested with
|
|
the IAR compiler. Previous versions have been tested with IAR 4.10B/W32 and
|
|
4.12A/W32 on an ATmega8 with the "small" and "tiny" memory model.
|
|
|
|
Ready made avr-gcc tool chains are available for most operating systems:
|
|
* Windows: WinAVR http://winavr.sourceforge.net/
|
|
* Mac: AVRMacPack http://www.obdev.at/avrmacpack/
|
|
* Linux and other Unixes: Most free Unixes have optional packages for AVR
|
|
development. If not, follow the instructions at
|
|
http://www.nongnu.org/avr-libc/user-manual/install_tools.html
|
|
|
|
Our host side examples are compiled with gcc on all platforms. Gcc is the
|
|
default C compiler on Mac, Linux and many other Unixes. On windows, we
|
|
recommend MinGW (http://www.mingw.org/). Use the automated MinGW installer
|
|
for least troubles. You also need MSYS from the same site to work with
|
|
standard Makefiles.
|
|
|
|
Most examples also depend on libusb. Libusb is available from
|
|
http://libusb.sourceforge.net/ for Unix and
|
|
http://libusb-win32.sourceforge.net/ for Windows.
|
|
|
|
|
|
TECHNICAL DOCUMENTATION
|
|
=======================
|
|
The API reference of the driver firmware can be found in usbdrv/usbdrv.h.
|
|
Documentation for host and device library files are in the respective header
|
|
files. For more information, see our documentation wiki at
|
|
http://www.obdev.at/goto.php?t=avrusb-wiki.
|
|
|
|
|
|
LICENSE
|
|
=======
|
|
AVR-USB and related code is distributed under the terms of the GNU General
|
|
Public License (GPL) version 2 (see License.txt for details) and the GNU
|
|
General Public License (GPL) version 3. It is your choice whether you apply
|
|
the terms of version 2 or version 3. In addition to the terms of the GPL, we
|
|
strongly encourage you to publish your entire project and mail OBJECTIVE
|
|
DEVELOPMENT a link to your publication.
|
|
|
|
Alternatively, we offer a commercial license without the restrictions of the
|
|
GPL. See CommercialLicense.txt for details.
|
|
|
|
|
|
----------------------------------------------------------------------------
|
|
(c) 2008 by OBJECTIVE DEVELOPMENT Software GmbH.
|
|
http://www.obdev.at/
|