3 The code is released under the GNU General Public License.
4 __________
5
6# Summary
7 This is Revision 2.0 of MAX3421E-based USB Host Shield Library for AVR's.
8
9Project main web site is: <http://www.circuitsathome.com>.
10
11Some information can also be found at: <http://blog.tkjelectronics.dk/>.
12
13The 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>.
25 * Developer of the BTD, SPP, PS3, Wii, and Xbox libraries
26* __Andrew Kroll__ - <xxxajk@gmail.com>
27 * Major contributor to mass storage code
28
29# How to include the library
30
31First download the library by clicking on the following link: <https://github.com/felis/USB_Host_Shield_2.0/archive/master.zip>.
32
33Then uncompress the zip folder and rename the directory to "USB\_Host\_Shield\_20", as any special characters are not supported by the Arduino IDE.
34
35Now open up the Arduino IDE and open "File>Preferences". There you will see the location of your sketchbook. Open that directory and create a directory called "libraries" inside that directory.
36Now move the "USB\_Host\_Shield\_20" directory to the "libraries" directory.
37
38The final structure should look like this:
39
40* Arduino/
41 * libraries/
42 * USB\_Host\_Shield\_20/
43
44Now quit the Arduino IDE and reopen it.
45
46Now you should be able to go open all the examples codes by navigating to "File>Examples>USB\_Host\_Shield\_20" and then select the example you will like to open.
47
48For more information visit the following site: <http://arduino.cc/en/Guide/Libraries>.
49
50# How to use the library
51
52### Documentation
53
54Documentation for the library can be found at the following link: <http://felis.github.com/USB_Host_Shield_2.0/>.
55
56### Arduino ADK
57To 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):
65The [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.
66This 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.
67Some different examples can be found in the [example directory](https://github.com/felis/USB_Host_Shield_2.0/tree/master/examples/Bluetooth).
68
69The BTD library will also make it possible to use multiple services at once, the following example sketch is an example of this:
74SPP 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.
75It has been tested successfully on Windows, Mac OS X, Linux, and Android.
76
77More information can be found at these blog posts:
82To implement the SPP protocol I used a Bluetooth sniffing tool called [PacketLogger](http://www.tkjelectronics.com/uploads/PacketLogger.zip) developed by Apple.
83It enables me to see the Bluetooth communication between my Mac and any device.
84
85### PS3 Library
86
87These libraries consist of the [PS3BT](https://github.com/felis/USB_Host_Shield_2.0/blob/master/PS3BT.cpp) and [PS3USB](https://github.com/felis/USB_Host_Shield_2.0/blob/master/PS3USB.cpp). These libraries allows you to use a Dualshock 3, Navigation or a Motion controller with the USB Host Shield both via Bluetooth and USB.
88
89In 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.
90
91__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://github.com/felis/USB_Host_Shield_2.0/blob/master/examples/Bluetooth/PS3BT/PS3BT.ino#L12>.
92
93For more information about the PS3 protocol see the official wiki: <https://github.com/felis/USB_Host_Shield_2.0/wiki/PS3-Information>.
1031. _Richard Ibbotson_ who made this excellent guide: <http://www.circuitsathome.com/mcu/ps3-and-wiimote-game-controllers-on-the-arduino-host-shield-part>
1042. _Tomoyuki Tanaka_ for releasing his code for the Arduino USB Host shield connected to the wiimote: <http://www.circuitsathome.com/mcu/rc-car-controlled-by-wii-remote-on-arduino>
105
106Also a big thanks all the people behind these sites about the Motion controller:
115The library support one Xbox 360 via USB or up to four Xbox 360 controllers wirelessly by using a [Xbox 360 wireless receiver](http://blog.tkjelectronics.dk/wp-content/uploads/xbox360-wireless-receiver.jpg).
116
117To use it via USB use the [XBOXUSB](https://github.com/felis/USB_Host_Shield_2.0/blob/master/XBOXUSB.cpp) library or to use it wirelessly use the [XBOXRECV](https://github.com/felis/USB_Host_Shield_2.0/blob/master/XBOXRECV.cpp) library.
118
119__Note that a Wireless controller can NOT be used via USB!__
120
121Examples code can be found in the [examples directory](https://github.com/felis/USB_Host_Shield_2.0/tree/master/examples/Xbox).
137The [Wii](https://github.com/felis/USB_Host_Shield_2.0/blob/master/Wii.cpp) library support the Wiimote, but also the Nunchuch and Motion Plus extensions via Bluetooth. The Wii U Pro Controller is also supported via Bluetooth.
138
139First you have to pair with the controller, this is done automatically by the library if you create the instance like so:
140
141<code>
142WII Wii(&Btd,PAIR);
143</code>
144
145And then press 1 & 2 at once on the Wiimote or press sync if you are using a Wii U Pro Controller.
146
147After that you can simply create the instance like so:
148
149<code>
150WII Wii(&Btd);
151</code>
152
153Then just press any button any button on the Wiimote and it will connect to the dongle.
154
155Take a look at the example for more information: <https://github.com/felis/USB_Host_Shield_2.0/blob/master/examples/Bluetooth/Wii/Wii.ino>.