#include <PS3USB.h>

Inheritance diagram for PS3USB:

Collaboration diagram for PS3USB:

Public Member Functions
	PS3USB (USB *pUsb, uint8_t btadr5=0, uint8_t btadr4=0, uint8_t btadr3=0, uint8_t btadr2=0, uint8_t btadr1=0, uint8_t btadr0=0)

void	setBdaddr (uint8_t *BDADDR)

void	setMoveBdaddr (uint8_t *BDADDR)

USBDeviceConfig implementation
virtual uint8_t	Init (uint8_t parent, uint8_t port, bool lowspeed)

virtual uint8_t	Release ()

virtual uint8_t	Poll ()

virtual uint8_t	GetAddress ()

virtual bool	isReady ()

PS3 Controller functions
bool	getButtonPress (Button b)

bool	getButtonClick (Button b)

uint8_t	getAnalogButton (Button a)

uint8_t	getAnalogHat (AnalogHat a)

uint16_t	getSensor (Sensor a)

double	getAngle (Angle a)

bool	getStatus (Status c)

String	getStatusString ()

void	setAllOff ()

void	setRumbleOff ()

void	setRumbleOn (Rumble mode)

void	setLedOff (LED a)

void	setLedOn (LED a)

void	setLedToggle (LED a)

void	moveSetBulb (uint8_t r, uint8_t g, uint8_t b)

void	moveSetBulb (Colors color)

void	moveSetRumble (uint8_t rumble)

Public Attributes
bool	PS3Connected

bool	PS3MoveConnected

bool	PS3NavigationConnected

Protected Attributes
USB *	pUsb

uint8_t	bAddress

EpInfo	epInfo [PS3_MAX_ENDPOINTS]

Detailed Description

This class implements support for all the official PS3 Controllers: Dualshock 3, Navigation or a Motion controller via USB.

One can only set the color of the bulb, set the rumble, set and get the bluetooth address and calibrate the magnetometer via USB.

Information about the protocol can be found at the wiki: https://github.com/felis/USB_Host_Shield_2.0/wiki/PS3-Information.

Definition at line 64 of file PS3USB.h.

Constructor & Destructor Documentation

PS3USB::PS3USB	(	USB *	pUsb,
		uint8_t	btadr5 = `0`,
		uint8_t	btadr4 = `0`,
		uint8_t	btadr3 = `0`,
		uint8_t	btadr2 = `0`,
		uint8_t	btadr1 = `0`,
		uint8_t	btadr0 = `0`
	)

Constructor for the PS3USB class.

Parameters

pUsb	Pointer to USB class instance.
btadr5,btadr4,btadr3,btadr2,btadr1,btadr0	Pass your dongles Bluetooth address into the constructor, so you are able to pair the controller with a Bluetooth dongle.

Definition at line 41 of file PS3USB.cpp.

Member Function Documentation

virtual uint8_t PS3USB::GetAddress ( )

inlinevirtual

Get the device address.

Returns: The device address.

Implements USBDeviceConfig.

Definition at line 98 of file PS3USB.h.

uint8_t PS3USB::getAnalogButton ( Button a )

Used to get the analog value from button presses.

Parameters

a	The Button to read. The supported buttons are: UP, RIGHT, DOWN, LEFT, L1, L2, R1, R2, TRIANGLE, CIRCLE, CROSS, SQUARE, and T.

Returns: Analog value in the range of 0-255.

Definition at line 338 of file PS3USB.cpp.

uint8_t PS3USB::getAnalogHat ( AnalogHat a )

Used to read the analog joystick.

Parameters

a	LeftHatX, LeftHatY, RightHatX, and RightHatY.

Returns: Return the analog value in the range of 0-255.

Definition at line 343 of file PS3USB.cpp.

double PS3USB::getAngle ( Angle a )

Use this to get Pitch and Roll calculated using the accelerometer.

Parameters

a	Either Pitch or Roll.

Returns: Return the angle in the range of 0-360.

Definition at line 353 of file PS3USB.cpp.

bool PS3USB::getButtonClick ( Button b )

getButtonPress(Button b) will return true as long as the button is held down While getButtonClick(Button b) will only return it once So you instance if you need to increase a variable once you would use getButtonClick(Button b), but if you need to drive a robot forward you would use getButtonPress(Button b).

Definition at line 332 of file PS3USB.cpp.

bool PS3USB::getButtonPress ( Button b )

getButtonPress(Button b) will return true as long as the button is held down While getButtonClick(Button b) will only return it once So you instance if you need to increase a variable once you would use getButtonClick(Button b), but if you need to drive a robot forward you would use getButtonPress(Button b).

Definition at line 329 of file PS3USB.cpp.

uint16_t PS3USB::getSensor ( Sensor a )

Used to read the sensors inside the Dualshock 3 controller.

Parameters

a	The Dualshock 3 has a 3-axis accelerometer and a 1-axis gyro inside.

Returns: Return the raw sensor value.

Definition at line 348 of file PS3USB.cpp.

bool PS3USB::getStatus ( Status c )

Get the Status from the controller.

Parameters

c	The Status you want to read.

Returns: True if correct and false if not.

Definition at line 378 of file PS3USB.cpp.

String PS3USB::getStatusString ( )

Read all the available Status from the controller.

Returns: One large string with all the information.

Definition at line 385 of file PS3USB.cpp.

uint8_t PS3USB::Init	(	uint8_t	parent,
		uint8_t	port,
		bool	lowspeed
	)

virtual

Initialize the PS3 Controller.

Parameters

parent	Hub number.
port	Port number on the hub.
lowspeed	Speed of the device.

Returns: 0 on success.

Implements USBDeviceConfig.

Definition at line 64 of file PS3USB.cpp.

virtual bool PS3USB::isReady ( )

inlinevirtual

Used to check if the controller has been initialized.

Returns: True if it's ready.

Definition at line 103 of file PS3USB.h.

void PS3USB::moveSetBulb	(	uint8_t	r,
		uint8_t	g,
		uint8_t	b
	)

Use this to set the Color using RGB values.

Parameters

r,g,b RGB value.

Definition at line 507 of file PS3USB.cpp.

void PS3USB::moveSetBulb ( Colors color )

Use this to set the color using the predefined colors in Colors.

Parameters

color The desired color.

Definition at line 515 of file PS3USB.cpp.

void PS3USB::moveSetRumble ( uint8_t rumble )

Set the rumble value inside the Move controller.

Parameters

rumble The desired value in the range from 64-255.

Definition at line 518 of file PS3USB.cpp.

uint8_t PS3USB::Poll ( )

virtual

Poll the USB Input endpoins and run the state machines.

Returns: 0 on success.

Implements USBDeviceConfig.

Definition at line 278 of file PS3USB.cpp.

uint8_t PS3USB::Release ( )

virtual

Release the USB device.

Returns: 0 on success.

Implements USBDeviceConfig.

Definition at line 269 of file PS3USB.cpp.

void PS3USB::setAllOff ( )

Used to set all LEDs and Rumble off.

Definition at line 424 of file PS3USB.cpp.

void PS3USB::setBdaddr ( uint8_t * BDADDR )

Used to set the Bluetooth address inside the Dualshock 3 and Navigation controller.

Parameters

BDADDR Your dongles Bluetooth address.

Definition at line 471 of file PS3USB.cpp.

void PS3USB::setLedOff ( LED a )

Turn the specific LED off.

Parameters

a	The LED to turn off.

Definition at line 459 of file PS3USB.cpp.

void PS3USB::setLedOn ( LED a )

Turn the specific LED on.

Parameters

a	The LED to turn on.

Definition at line 463 of file PS3USB.cpp.

void PS3USB::setLedToggle ( LED a )

Toggle the specific LED.

Parameters

a	The LED to toggle.

Definition at line 467 of file PS3USB.cpp.

void PS3USB::setMoveBdaddr ( uint8_t * BDADDR )

Used to set the Bluetooth address inside the Move controller.

Parameters

BDADDR Your dongles Bluetooth address.

Definition at line 528 of file PS3USB.cpp.

void PS3USB::setRumbleOff ( )

Turn off Rumble.

Definition at line 430 of file PS3USB.cpp.

void PS3USB::setRumbleOn ( Rumble mode )

Turn on Rumble.

Parameters

mode	Either RumbleHigh or RumbleLow.

Definition at line 438 of file PS3USB.cpp.

Member Data Documentation

uint8_t PS3USB::bAddress

protected

Device address.

Definition at line 221 of file PS3USB.h.

EpInfo PS3USB::epInfo[PS3_MAX_ENDPOINTS]

protected

Endpoint info structure.

Definition at line 223 of file PS3USB.h.

bool PS3USB::PS3Connected

Variable used to indicate if the normal playstation controller is successfully connected.

Definition at line 211 of file PS3USB.h.

bool PS3USB::PS3MoveConnected

Variable used to indicate if the move controller is successfully connected.

Definition at line 213 of file PS3USB.h.

bool PS3USB::PS3NavigationConnected

Variable used to indicate if the navigation controller is successfully connected.

Definition at line 215 of file PS3USB.h.

USB* PS3USB::pUsb

protected

Pointer to USB class instance.

Definition at line 219 of file PS3USB.h.

The documentation for this class was generated from the following files:

/Users/Lauszus/GitHub/USB_Host_Shield_2.0/PS3USB.h
/Users/Lauszus/GitHub/USB_Host_Shield_2.0/PS3USB.cpp

Public Member Functions

Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation