mirror of
https://github.com/felis/USB_Host_Shield_2.0.git
synced 2024-03-22 11:31:26 +01:00
New README
This commit is contained in:
Kristian Sloth Lauszus
parent
fedb7445ce
commit
7750b494e6
3 changed files with 146 additions and 32 deletions
31
EXTRAREADME
31
EXTRAREADME
|
|
@ -1,31 +0,0 @@
|
|||
BTD.cpp, BTD.h, SPP.cpp, SPP.h, PS3BT.cpp, PS3BT.h, Wii.cpp, Wii.h, PS3USB.cpp, PS3USB.h, XBOXUSB.cpp, and XBOXUSB.h are developed by Kristian Lauszus
|
||||
|
||||
For more information regarding the PS3 protocol etc. visit my blog at: http://blog.tkjelectronics.dk/ or send me an email at kristianl at tkjelectronics dot dk.
|
||||
You could also visit the official wiki: https://github.com/felis/USB_Host_Shield_2.0/wiki/PS3-Information for information.
|
||||
|
||||
All three PS3 Controllers are supported (Dualshock 3-, Navigation-, and Motioncontroller).
|
||||
They communicate with the Arduino via Bluetooth or USB using the USB Host Shield from http://www.circuitsathome.com/
|
||||
|
||||
A special thanks go to the following people:
|
||||
"Richard Ibbotson" who made this excellent guide: http://www.circuitsathome.com/mcu/ps3-and-wiimote-game-controllers-on-the-arduino-host-shield-part-1
|
||||
- It inspired me to get starting and had a lot of good information for the USB communication
|
||||
"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
|
||||
- It helped me a lot to see the structure of the Bluetooth communication
|
||||
|
||||
Also I would like to thank all the people behind these sites about the Motion controller:
|
||||
http://thp.io/2010/psmove/, http://www.copenhagengamecollective.org/unimove/,
|
||||
https://github.com/thp/psmoveapi and http://code.google.com/p/moveonpc/
|
||||
|
||||
All the information regarding the Xbox 360 controller protocol are form these two sites:
|
||||
http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/UsbInfo
|
||||
http://pingus.seul.org/~grumbel/xboxdrv/
|
||||
|
||||
To implement the RFCOMM protocol I used a bluetooth sniffing tool called PacketLogger developed by Apple.
|
||||
It enables me to see the bluetooth communication between my Mac and any device.
|
||||
|
||||
All the information about the Wii controllers are from these sites: http://wiibrew.org/wiki/Wiimote,
|
||||
http://wiibrew.org/wiki/Wiimote/Extension_Controllers, http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Nunchuck,
|
||||
and http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Wii_Motion_Plus
|
||||
The old library created by Tomoyuki Tanaka: https://github.com/moyuchin/WiiRemote_on_Arduino also helped a lot.
|
||||
|
||||
And at last I would like to thank Oleg from http://www.circuitsathome.com/ for making such an awesome shield!
|
||||
1
README
1
README
|
|
@ -1 +0,0 @@
|
|||
This is Rev.2.0 of MAX3421E-based USB Host Shield Library. Project web site is http://www.circuitsathome.com
|
||||
146
README.md
Normal file
146
README.md
Normal file
|
|
@ -0,0 +1,146 @@
|
|||
# USB Host Library Rev.2.0
|
||||
|
||||
The code is released under the GNU General Public License.
|
||||
__________
|
||||
|
||||
# Summary
|
||||
This is Revision 2.0 of MAX3421E-based USB Host Shield Library for AVR's.
|
||||
|
||||
Project main web site is: <http://www.circuitsathome.com>.
|
||||
|
||||
Some information can also be found at: <http://blog.tkjelectronics.dk/>.
|
||||
|
||||
The shield can be purchased at the main site: <http://www.circuitsathome.com/products-page/arduino-shields>.
|
||||
|
||||
[](http://www.circuitsathome.com/products-page/arduino-shields)
|
||||
|
||||
For more information about the hardware see the [Hardware Manual](http://www.circuitsathome.com/usb-host-shield-hardware-manual).
|
||||
|
||||
# Developed By
|
||||
|
||||
* __Oleg Mazurov, Circuits@Home__ - <mazurov@circuitsathome.com>
|
||||
* Developer of the USB Core, HID, FTDI, ADK, ACM, and PL2303 libraries
|
||||
* __Kristian Lauszus, TKJ Electronics__ - <kristianl@tkjelectronics.com>
|
||||
* Developer of the BTD, SPP, PS3, Wii, and Xbox libraries
|
||||
|
||||
# How to use the library
|
||||
|
||||
### Arduino ADK
|
||||
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):
|
||||
|
||||
<code>
|
||||
\#define BOARD\_MEGA_ADK
|
||||
</code>
|
||||
|
||||
### [Bluetooth libraries](https://github.com/felis/USB_Host_Shield_2.0/blob/master/BTD.cpp)
|
||||
|
||||
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.
|
||||
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.
|
||||
Some different examples can be found in the [example directory](https://github.com/felis/USB_Host_Shield_2.0/tree/master/examples/Bluetooth).
|
||||
|
||||
The BTD library will also make it possible to use multiple services at once, the following example sketch is an example of this:
|
||||
<https://github.com/felis/USB_Host_Shield_2.0/blob/master/examples/Bluetooth/PS3SPP/PS3SPP.ino>
|
||||
|
||||
### [SPP library](https://github.com/felis/USB_Host_Shield_2.0/blob/master/SPP.cpp)
|
||||
|
||||
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.
|
||||
It has been tested successfully on Windows, Mac OS X, Linux, and Android.
|
||||
Unfortunately Google broke something in Android 4.2, so it's currently not working in this version of Android.
|
||||
|
||||
More information can be found at these blog posts:
|
||||
|
||||
* <http://www.circuitsathome.com/mcu/bluetooth-rfcommspp-service-support-for-usb-host-2-0-library-released>
|
||||
* <http://blog.tkjelectronics.dk/2012/07/rfcommspp-library-for-arduino/>
|
||||
|
||||
To implement the SPP protocol I used a Bluetooth sniffing tool called [PacketLogger](http://www.tkjelectronics.com/uploads/PacketLogger.zip) developed by Apple.
|
||||
It enables me to see the Bluetooth communication between my Mac and any device.
|
||||
|
||||
### PS3 Library
|
||||
|
||||
These 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.
|
||||
|
||||
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.
|
||||
|
||||
__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>.
|
||||
|
||||
For more information about the PS3 protocol see the official wiki: <https://github.com/felis/USB_Host_Shield_2.0/wiki/PS3-Information>.
|
||||
|
||||
Also take a look at the blog posts:
|
||||
|
||||
* <http://blog.tkjelectronics.dk/2012/01/ps3-controller-bt-library-for-arduino/>
|
||||
* <http://www.circuitsathome.com/mcu/sony-ps3-controller-support-added-to-usb-host-library>
|
||||
* <http://www.circuitsathome.com/mcu/arduino/interfacing-ps3-controllers-via-usb>
|
||||
|
||||
A special thanks go to the following people:
|
||||
|
||||
1. _Richard Ibbotson_ who made this excellent guide: <http://www.circuitsathome.com/mcu/ps3-and-wiimote-game-controllers-on-the-arduino-host-shield-part>
|
||||
2. _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>
|
||||
|
||||
Also a big thanks all the people behind these sites about the Motion controller:
|
||||
|
||||
* <http://thp.io/2010/psmove/>
|
||||
* <http://www.copenhagengamecollective.org/unimove/>
|
||||
* <https://github.com/thp/psmoveapi>
|
||||
* <http://code.google.com/p/moveonpc/>
|
||||
|
||||
### Xbox 360 Library
|
||||
|
||||
The 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).
|
||||
|
||||
To 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.
|
||||
|
||||
__Note that a Wireless controller can NOT be used via USB!__
|
||||
|
||||
Examples code can be found in the [examples directory](https://github.com/felis/USB_Host_Shield_2.0/tree/master/examples/Xbox).
|
||||
|
||||
Also see the following blog posts:
|
||||
|
||||
* <http://www.circuitsathome.com/mcu/xbox360-controller-support-added-to-usb-host-shield-2-0-library>
|
||||
* <http://blog.tkjelectronics.dk/2012/07/xbox-360-controller-support-added-to-the-usb-host-library/>
|
||||
* <http://blog.tkjelectronics.dk/2012/12/xbox-360-receiver-added-to-the-usb-host-library/>
|
||||
|
||||
All the information regarding the Xbox 360 controller protocol are form these sites:
|
||||
|
||||
* <http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/UsbInfo>
|
||||
* <http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/WirelessUsbInfo>
|
||||
* <https://github.com/Grumbel/xboxdrv/blob/master/PROTOCOL>
|
||||
|
||||
### [Wii library](https://github.com/felis/USB_Host_Shield_2.0/blob/master/Wii.cpp)
|
||||
|
||||
The [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 extension via Bluetooth.
|
||||
|
||||
First you have to pair with the controller, this is done automatically by the library if you create the instance like so:
|
||||
|
||||
<code>
|
||||
WII Wii(&Btd,PAIR);
|
||||
</code>
|
||||
|
||||
And then press 1 & 2 at once on the Wiimote.
|
||||
|
||||
After that you can simply create the instance like so:
|
||||
|
||||
<code>
|
||||
WII Wii(&Btd);
|
||||
</code>
|
||||
|
||||
Then just press any button any button on the Wiimote and it will connect to the dongle.
|
||||
|
||||
Take a look at the example for more information: <https://github.com/felis/USB_Host_Shield_2.0/blob/master/examples/Bluetooth/Wii/Wii.ino>.
|
||||
|
||||
Also take a look at the blog post:
|
||||
|
||||
* <http://blog.tkjelectronics.dk/2012/08/wiimote-added-to-usb-host-library/>
|
||||
|
||||
All the information about the Wii controllers are from these sites:
|
||||
|
||||
* <http://wiibrew.org/wiki/Wiimote>
|
||||
* <http://wiibrew.org/wiki/Wiimote/Extension_Controllers>
|
||||
* <http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Nunchuck>
|
||||
* <http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Wii_Motion_Plus>
|
||||
* The old library created by _Tomoyuki Tanaka_: <https://github.com/moyuchin/WiiRemote_on_Arduino> also helped a lot.
|
||||
|
||||
# FAQ
|
||||
|
||||
> When I plug my device into the USB connector nothing happens?
|
||||
|
||||
Try to connect a external power supply to the Arduino - this solves the problem in most cases.
|
||||
Loading…
Reference in a new issue