1 # USB Host Library Rev.2.0
3 The code is released under the GNU General Public License.
7 This is Revision 2.0 of
MAX3421E-based
USB Host Shield Library
for AVR
's.
9 Project main web site is: <http://www.circuitsathome.com>.
11 Some information can also be found at: <http://blog.tkjelectronics.dk/>.
13 The shield can be purchased at the main site: <http://www.circuitsathome.com/products-page/arduino-shields> or from [TKJ Electronics](http://tkjelectronics.com/): <http://shop.tkjelectronics.dk/product_info.php?products_id=43>.
15 ![USB Host Shield](http://www.circuitsathome.com/wp/wp-content/uploads/2012/02/UHS_20_main-288x216.jpg)
17 For more information about the hardware see the [Hardware Manual](http://www.circuitsathome.com/usb-host-shield-hardware-manual).
21 * <b>Oleg Mazurov, Circuits\@Home</b> - <mazurov@circuitsathome.com>
22 * Developer of the USB Core, HID, FTDI, ADK, ACM, and PL2303 libraries
23 * <b>Kristian Lauszus, TKJ Electronics</b> - <kristianl@tkjelectronics.com>
24 * Developer of the BTD, SPP, PS3, Wii, and Xbox libraries
26 # How to use the library
29 To use this library with the official [Arduino ADK](http://arduino.cc/en/Main/ArduinoBoardADK) uncomment the following line in [avrpins.h](https://github.com/felis/USB_Host_Shield_2.0/blob/master/avrpins.h):
32 \#define BOARD\_MEGA_ADK
35 ### [Bluetooth libraries](https://github.com/felis/USB_Host_Shield_2.0/blob/master/BTD.cpp)
37 The [BTD library](https://github.com/felis/USB_Host_Shield_2.0/blob/master/BTD.cpp) is a general purpose library for an ordinary Bluetooth dongle.
38 This library make it easy to add support for different Bluetooth services like a PS3 or a Wii controller or SPP which is a virtual serial port via Bluetooth.
39 Some different examples can be found in the [example directory](https://github.com/felis/USB_Host_Shield_2.0/tree/master/examples/Bluetooth).
41 The BTD library will also make it possible to use multiple services at once, the following example sketch is an example of this:
42 <https://github.com/felis/USB_Host_Shield_2.0/blob/master/examples/Bluetooth/PS3SPP/PS3SPP.ino>
44 ### [SPP library](https://github.com/felis/USB_Host_Shield_2.0/blob/master/SPP.cpp)
46 SPP stands for "Serial Port Profile" and is a Bluetooth protocol that implements a virtual comport which allows you to send data back and forth from your computer/phone to your Arduino via Bluetooth.
47 It has been tested successfully on Windows, Mac OS X, Linux, and Android.
48 Unfortunately Google broke something in Android 4.2, so it's currently not working in
this version of Android.
50 More information can be found at these blog posts:
55 To implement the
SPP protocol I used a
Bluetooth sniffing tool called [PacketLogger](http:
56 It enables me to see the
Bluetooth communication between my Mac and any device.
60 These libraries consist of the [
PS3BT](https:
62 In order to use your Playstation controller via
Bluetooth you have to
set the
Bluetooth address of the dongle internally to your PS3 Controller. This can be achieved by plugging the controller in via
USB and letting the library
set it automatically.
64 __Note:__ To obtain the address you have to plug in the
Bluetooth dongle before connecting the controller, or alternatively you could
set it in code like so: <https:
66 For more information about the PS3 protocol see the official wiki: <https:
68 Also take a look at the blog posts:
74 A special thanks go to the following people:
76 1. _Richard Ibbotson_ who made
this excellent guide: <http:
77 2. _Tomoyuki Tanaka_
for releasing his code
for the Arduino
USB Host shield connected to the wiimote: <http:
79 Also a big thanks all the people behind these sites about the Motion controller:
88 The library support one Xbox 360 via
USB or up to four Xbox 360 controllers wirelessly by
using a [Xbox 360 wireless receiver](http:
92 __Note that a Wireless controller can NOT be used via
USB!__
94 Examples code can be found in the [examples directory](https:
96 Also see the following blog posts:
102 All the information regarding the Xbox 360 controller protocol are form these sites:
108 ### [Wii library](https://github.com/felis/USB_Host_Shield_2.0/blob/master/Wii.cpp)
112 First you have to pair with the controller,
this is done automatically by the library
if you create the instance like so:
118 And then press 1 & 2 at once on the Wiimote or press sync
if you are
using a Wii U Pro Controller.
120 After that you can simply create the instance like so:
126 Then just press any button any button on the Wiimote and it will connect to the dongle.
128 Take a look at the example
for more information: <https:
130 Also take a look at the blog post:
134 All the information about the Wii controllers are from these sites:
140 * The old library created by _Tomoyuki Tanaka_: <https:
144 > When I plug my device into the
USB connector nothing happens?
146 Try to connect a external power supply to the Arduino -
this solves the problem in most cases.