specchioriflesso/USB_Host_Shield_2.0
1
Fork 0
mirror of https://github.com/felis/USB_Host_Shield_2.0.git synced 2024-03-22 11:31:26 +01:00
Code Issues Packages Projects Releases Wiki Activity
560 commits 10 branches 13 tags 86 MiB
C++ 92%
C 8%
Find a file
Andrew J. Kroll 02b685e329 lock settings for spi (unused at this time)
2013-10-08 11:36:15 -04:00
examples Fix example, and reformat 2013-10-01 14:50:09 -04:00
.gitignore commit 2013-06-11 21:11:43 -06:00
.gitmodules Add RTClib 2013-09-02 04:19:31 -04:00
address.h compile faster 2013-09-23 18:40:10 -04:00
adk.cpp fixed PrintHex in Kbd example 2013-08-14 14:02:42 -06:00
adk.h compile faster 2013-09-23 18:40:10 -04:00
avrpins.h Move Usb.h UsbCore.h and trim. Usb.h is now only includes, as it aught to be. Clean up more header files, more include traps. 2013-09-30 01:13:11 -04:00
BTD.cpp Indent... 2013-09-27 21:39:38 +02:00
BTD.h compile faster 2013-09-23 18:40:10 -04:00
cdcacm.cpp fixed PrintHex in Kbd example 2013-08-14 14:02:42 -06:00
cdcacm.h compile faster 2013-09-23 18:40:10 -04:00
cdcftdi.cpp fixed PrintHex in Kbd example 2013-08-14 14:02:42 -06:00
cdcftdi.h compile faster 2013-09-23 18:40:10 -04:00
cdcprolific.cpp fixed ready flag in Prolific driver 2013-06-18 20:22:19 -06:00
cdcprolific.h Fix headers 2013-09-23 16:08:31 -04:00
confdescparser.h compile faster 2013-09-23 18:40:10 -04:00
controllerEnums.h Added support for original Xbox controller 2013-07-18 17:52:23 +02:00
gpl2.txt Merge my debug changes. 2013-03-28 03:26:02 -04:00
hexdump.h compile faster 2013-09-23 18:40:10 -04:00
hid.cpp refactor entire library for hex printing 2013-06-17 15:37:09 -04:00
hid.h compile faster 2013-09-23 18:40:10 -04:00
hidboot.cpp Added KeyboardReportParser::OnControlKeysChanged(before, after) to be able to react on control key presses and enhanced the HID keyboard example. 2013-05-16 20:45:26 +02:00
hidboot.h Improved hidboot, now supports composite keyboard mouse devices. 2013-09-29 16:08:20 -04:00
hidescriptorparser.cpp Fixed printing in HID Descriptor Parser 2013-06-18 14:00:43 -06:00
hidescriptorparser.h Fix headers 2013-09-23 16:08:31 -04:00
hiduniversal.cpp fixed Get Conf Descr and delay after SetAddr in hiduniversal 2013-09-10 16:10:34 -06:00
hiduniversal.h Merge my debug changes. 2013-03-28 03:26:02 -04:00
hidusagestr.h Merge my debug changes. 2013-03-28 03:26:02 -04:00
hidusagetitlearrays.cpp Merge my debug changes. 2013-03-28 03:26:02 -04:00
keywords.txt Add USBHub to keywords 2013-08-13 21:33:21 +02:00
macros.h Move Usb.h UsbCore.h and trim. Usb.h is now only includes, as it aught to be. Clean up more header files, more include traps. 2013-09-30 01:13:11 -04:00
masstorage.cpp Shrink more. Fix capacity bug. Reduce includes, which reduces compile time. 2013-09-23 04:49:37 -04:00
masstorage.h compile faster 2013-09-23 18:40:10 -04:00
max3421e.h compile faster 2013-09-23 18:40:10 -04:00
max_LCD.cpp compile faster 2013-09-23 18:40:10 -04:00
max_LCD.h compile faster 2013-09-23 18:40:10 -04:00
message.cpp compile faster 2013-09-23 18:40:10 -04:00
message.h Move Usb.h UsbCore.h and trim. Usb.h is now only includes, as it aught to be. Clean up more header files, more include traps. 2013-09-30 01:13:11 -04:00
parsetools.cpp compile faster 2013-09-23 18:40:10 -04:00
parsetools.h compile faster 2013-09-23 18:40:10 -04:00
printhex.h compile faster 2013-09-23 18:40:10 -04:00
PS3BT.cpp Clear buttonState properly 2013-07-20 22:07:03 +02:00
PS3BT.h Added attachOnInit 2013-07-14 00:43:35 +02:00
PS3Enums.h Moved PS3 report buffer into PS3Enums 2013-04-02 00:12:38 +02:00
PS3USB.cpp Minor 2013-07-20 12:57:23 +02:00
PS3USB.h compile faster 2013-09-23 18:40:10 -04:00
README.md Changed how boards and serial debugging are activated 2013-09-30 02:44:22 +02:00
settings.h lock settings for spi (unused at this time) 2013-10-08 11:36:15 -04:00
SPP.cpp ARM non-init issue. 2013-09-27 17:07:05 +08:00
SPP.h Fixed some comments 2013-05-07 01:01:55 +02:00
Usb.cpp Unwedge failed device on failed attempt. 2013-09-29 18:22:37 -04:00
Usb.h Move Usb.h UsbCore.h and trim. Usb.h is now only includes, as it aught to be. Clean up more header files, more include traps. 2013-09-30 01:13:11 -04:00
usb_ch9.h Move Usb.h UsbCore.h and trim. Usb.h is now only includes, as it aught to be. Clean up more header files, more include traps. 2013-09-30 01:13:11 -04:00
UsbCore.h Zap silly Author default. 2013-09-30 01:25:14 -04:00
usbhost.h Move Usb.h UsbCore.h and trim. Usb.h is now only includes, as it aught to be. Clean up more header files, more include traps. 2013-09-30 01:13:11 -04:00
usbhub.cpp [BUGFIX] Ensure bmReserved is a zero 2013-09-02 22:57:54 -04:00
usbhub.h compile faster 2013-09-23 18:40:10 -04:00
Wii.cpp Fixed bug when using Wiicamera with new Wiimote with MotionPlus inside 2013-08-13 22:31:51 +02:00
Wii.h Fixed disconnect problem when using the old Wiimote with the external MotionPlus extension 2013-07-18 19:43:21 +02:00
WiiCameraReadme.md Fixed some markdown issues 2013-04-01 22:45:45 +02:00
xboxEnums.h Clean up code formatting to industry standards. 2013-03-28 04:46:43 -04:00
XBOXOLD.cpp Minor 2013-07-20 12:57:23 +02:00
XBOXOLD.h compile faster 2013-09-23 18:40:10 -04:00
XBOXRECV.cpp Xbox libraries doesn't collide anymore 2013-07-18 18:21:44 +02:00
XBOXRECV.h compile faster 2013-09-23 18:40:10 -04:00
XBOXUSB.cpp Added support for GameStop wired controller 2013-09-02 21:21:26 +02:00
XBOXUSB.h compile faster 2013-09-23 18:40:10 -04:00

README.md

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 or from TKJ Electronics: http://shop.tkjelectronics.dk/product_info.php?products_id=43.

USB Host Shield

For more information about the hardware see the Hardware Manual.

Developed By

How to include the library

First download the library by clicking on the following link: https://github.com/felis/USB_Host_Shield_2.0/archive/master.zip.

Then uncompress the zip folder and rename the directory to "USB_Host_Shield_20", as any special characters are not supported by the Arduino IDE.

Now 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. Now move the "USB_Host_Shield_20" directory to the "libraries" directory.

The final structure should look like this:

  • Arduino/
    • libraries/
      • USB_Host_Shield_20/

Now quit the Arduino IDE and reopen it.

Now 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.

For more information visit the following site: http://arduino.cc/en/Guide/Libraries.

How to use the library

Documentation

Documentation for the library can be found at the following link: http://felis.github.com/USB_Host_Shield_2.0/.

Enable debugging

By default serial debugging is disabled. To turn it on simply change ENABLE_UHS_DEBUGGING to 1 in settings.h like so:

#define ENABLE_UHS_DEBUGGING 1

Boards

Currently the following boards are supported by the library: All official Arduino AVR boards (Uno, Duemilanove, Mega, Mega 2560, Mega ADK, Leonardo etc.), Teensy (Teensy 1.0, Teensy 2.0 and Teensy++ 2.0), Balanduino, Sanguino and Black Widdow.

The following boards need to be activated manually in settings.h: Arduino ADK, Sanguino, Teeny 2.0, and Black Widdow. Simply set the corresponding value to 1 instead of 0.

Bluetooth libraries

The BTD library 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.

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

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.

More information can be found at these blog posts:

To implement the SPP 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.

PS3 Library

These libraries consist of the PS3BT and PS3USB. 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:

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:

Xbox Libraries

The library supports both the original Xbox controller via USB and the Xbox 360 controller both via USB and wirelessly.

Xbox library

The XBOXOLD class implements support for the original Xbox controller via USB.

All the information are from the following sites:

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.

To use it via USB use the XBOXUSB library or to use it wirelessly use the XBOXRECV library.

Note that a Wireless controller can NOT be used via USB!

Examples code can be found in the examples directory.

Also see the following blog posts:

All the information regarding the Xbox 360 controller protocol are form these sites:

Wii library

The Wii library support the Wiimote, but also the Nunchuch and Motion Plus extensions via Bluetooth. The Wii U Pro Controller is also supported via Bluetooth.

First you have to pair with the controller, this is done automatically by the library if you create the instance like so:

WII Wii(&Btd,PAIR);

And then press 1 & 2 at once on the Wiimote or press sync if you are using a Wii U Pro Controller.

After that you can simply create the instance like so:

WII Wii(&Btd);

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:

All the information about the Wii controllers are from these sites:

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.