-
Notifications
You must be signed in to change notification settings - Fork 294
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #107 from honeybee-robotics-forks/indigo-devel
Numerous outstanding PRs.
- Loading branch information
Showing
22 changed files
with
660 additions
and
225 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,75 @@ | ||
# PlayStation 3 Joystick Driver for ROS | ||
|
||
This package provides a driver for the PS3 (SIXAXIS or DUALSHOCK3) bluetooth joystick. | ||
|
||
This driver provides a more reliable connection, and provides access to the joystick's accelerometers and gyroscope. Linux's native support for the PS3 joystick does lacks this functionality. | ||
|
||
Additional documentation: | ||
|
||
* [Testing Instructions](doc/testing.md) | ||
* [Bluetooth Device Compatibility](doc/bluetooth_devices.md) | ||
|
||
## Dependencies | ||
|
||
* joystick | ||
* libusb-dev | ||
* bluez-5.37 | ||
|
||
## Pairing instructions | ||
|
||
1. If you can connect the joystick and the bluetooth dongle into the same | ||
computer connect the joystick to the computer using a USB cable. | ||
|
||
2. Load the bluetooth dongle's MAC address into the ps3 joystick using: | ||
``` | ||
sudo bash | ||
rosrun ps3joy sixpair | ||
``` | ||
If you cannot connect the joystick to the same computer as the dongle, | ||
find out the bluetooth dongle's MAC address by running (on the computer | ||
that has the bluetooth dongle): | ||
``` | ||
hciconfig | ||
``` | ||
If this does not work, you may need to do | ||
``` | ||
sudo hciconfig hci0 up | ||
``` | ||
and retry | ||
``` | ||
hciconfig | ||
``` | ||
3. Plug the PS3 joystick into some other computer using a USB cable. | ||
|
||
4. Replace the joystick's mac address in the following command: | ||
``` | ||
sudo rosrun ps3joy sixpair 01:23:45:67:89:ab | ||
``` | ||
|
||
## Starting the PS3 joystick | ||
|
||
5. Run the following command | ||
``` | ||
rosrun ps3joy ps3joy.py | ||
``` | ||
6. Open a new terminal and reboot bluez and run joy with: | ||
``` | ||
sudo systemctl restart bluetooth | ||
rosrun joy joy_node | ||
``` | ||
7. Open a new terminal and echo the joy topic | ||
``` | ||
rostopic echo joy | ||
``` | ||
8. This should make a joystick appear at /dev/input/js? | ||
|
||
9. You can check that it is working with | ||
jstest /dev/input/js? | ||
(replace ? with the name of your joystick) | ||
|
||
## Limitations | ||
|
||
This driver will not coexist with any other bluetooth device. In future releases, we plan to allow first non-HID and later any bluetooth device to coexist with this driver. The following devices do coexist: | ||
|
||
* Non-HID devices using a userland driver, such as one written using pybluez. | ||
* Keyboards or mice running in HID proxy mode, which appear to the kernel as USB devices. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
|
||
## Bluetooth Device Compatibility | ||
|
||
This driver works with most 2.x Bluetooth adapters. Please report other compatible and incompatible Bluetooth adapters through a pull request to this page. | ||
|
||
### Adapters that are known to work | ||
|
||
* | ||
|
||
### Adapters that are known not to work | ||
|
||
* Linksys USBBT100 version 2 (Bluetooth 1.1) | ||
* USB device 0a12:0x0001 |
Oops, something went wrong.