fl-shelved/xmega-arduino
1
0
Fork 0
Code Releases Activity

Update README.

Browse source
This commit is contained in:
flabbergast 2015-03-30 19:27:02 +01:00
parent bc4570f561
commit 0603b384d8
1 changed files with 27 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
README.md
View file

@ -6,15 +6,19 @@ line of microcontrollers.
Most of the hard work has been done by [Xmegaduino] folks. But I just
wanted an add-on to regular [Arduino] IDE.
I've added support for USB enabled atxmega chips (at the moment, one
-A4U board).
I've added support for USB enabled atxmega chips (at the moment, two
xmega128A4U boards tested).
## Caveats (for USB boards)
## Caveats (mainly for USB boards)
- USB support is alpha quality - so may be quite buggy.
- Only USB support present at the moment is for Serial (e.g. like the
standard Arduino Leonardo). So no Keyboard, Mouse ... (like
[Teensyduino]) support yet.
- Only DFU bootloaded boards for now.
- Autoreset is not implemented - you need to put your board into DFU
mode manually before uploading.
- Various third-party libraries might (and most probably do) need some
adjustments to work with XMEGAs.
@ -33,9 +37,6 @@ Select one of the Xmega boards in your IDE. Enjoy!
# Remarks and ramblings
- Only USB support present at the moment is for Serial (e.g. like the
standard Arduino Leonardo). So no Keyboard, Mouse ... (like
[Teensyduino]) support yet.
- The USB stack is based on my quick-and-dirty XMEGA-USB code, based
originally on Nonolith Labs' [USB-XMEGA] {so not on
Dean Camera's excellent [LUFA] library - mainly because I didn't want
@ -45,20 +46,37 @@ Select one of the Xmega boards in your IDE. Enjoy!
- The build settings assume DFU bootloader. The flashing is done with
[dfu-programmer], supplied in the zip (tested on Mac OS X, Linux (i686
and x86_64 - you'll need to install dfu-programmer manually on arm).
- I've only tested it on [X-A4U-stick] - I don't have any other XMEGA
boards.
- I've only tested it on [X-A4U-stick] and [MT-DB-X4] xmega128A4U
breakout from [MattairTech] - I don't have any other XMEGA boards.
- `dfu-programmer` on linux might claim that 'No device present' even if
the DFU bootloader shows up on `lsusb`. It's a permissions problem
then - give your user enough permissions to access that usb device
(google usb device permissions udev rule to see how can you fix that
on your particular system).
## Pin assignments for -A4U boards
### MT-DB-X4 from MattairTech
Digital pins go around the board from `0` = `A0`, to `29` = `E3`, with
the exception `30` = `D6` and `31` = `D7`. In particular, the LED is
digital `27` and the jumper is digital `26`.
Analog pins go from `A0` = `A0` to `A7` = `A7` and then `A8` = `B0`, up
to `A11` = `B3`.
### X-A4U stick
The pins numbers are described on the [X-A4U-stick] webpage.
[Teensyduino]: https://www.pjrc.com/teensy/teensyduino.html
[LUFA]: http://www.fourwalledcubicle.com/LUFA.php
[Xmegaduino]: https://github.com/akafugu/Xmegaduino
[Arduino]: http://arduino.cc
[X-A4U-stick]: https://flabbergast.github.io/X-A4U-r2
[X-A4U-stick]: https://flabbergast.github.io/x-a4u-r2
[dfu-programmer]: https://dfu-programmer.github.io/
[USB-XMEGA]: https://dfu-programmer.github.io/
[MattairTech]: https://www.mattairtech.com/
[MT-DB-X4]: https://www.mattairtech.com/index.php/featured/mt-db-x4.html