#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	getBdaddr (uint8_t *bdaddr)

void	setMoveBdaddr (uint8_t *bdaddr)

void	getMoveBdaddr (uint8_t *bdaddr)

void	getMoveCalibration (uint8_t *data)

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 ()

virtual boolean	VIDPIDOK (uint16_t vid, uint16_t pid)

PS3 Controller functions
bool	getButtonPress (ButtonEnum b)

bool	getButtonClick (ButtonEnum b)

uint8_t	getAnalogButton (ButtonEnum a)

uint8_t	getAnalogHat (AnalogHatEnum a)

uint16_t	getSensor (SensorEnum a)

double	getAngle (AngleEnum a)

bool	getStatus (StatusEnum c)

void	printStatusString ()

void	setAllOff ()

void	setRumbleOff ()

void	setRumbleOn (RumbleEnum mode)

void	setRumbleOn (uint8_t rightDuration, uint8_t rightPower, uint8_t leftDuration, uint8_t leftPower)

void	setLedRaw (uint8_t value)

void	setLedOff ()

void	setLedOff (LEDEnum a)

void	setLedOn (LEDEnum a)

void	setLedToggle (LEDEnum a)

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

void	moveSetBulb (ColorsEnum color)

void	moveSetRumble (uint8_t rumble)

void	attachOnInit (void(*funcOnInit)(void))

Public Member Functions inherited from USBDeviceConfig
virtual uint8_t	ConfigureDevice (uint8_t parent, uint8_t port, bool lowspeed)

virtual void	ResetHubPort (uint8_t port)

virtual boolean	DEVCLASSOK (uint8_t klass)

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 on the Move controller.

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 58 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 23 of file PS3USB.cpp.

Member Function Documentation

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.

Reimplemented from USBDeviceConfig.

Definition at line 46 of file PS3USB.cpp.

uint8_t PS3USB::Release ( )

virtual

Release the USB device.

Returns: 0 on success.

Reimplemented from USBDeviceConfig.

Definition at line 261 of file PS3USB.cpp.

uint8_t PS3USB::Poll ( )

virtual

Poll the USB Input endpoins and run the state machines.

Returns: 0 on success.

Reimplemented from USBDeviceConfig.

Definition at line 271 of file PS3USB.cpp.

virtual uint8_t PS3USB::GetAddress ( )

inlinevirtual

Get the device address.

Returns: The device address.

Reimplemented from USBDeviceConfig.

Definition at line 93 of file PS3USB.h.

virtual bool PS3USB::isReady ( )

inlinevirtual

Used to check if the controller has been initialized.

Returns: True if it's ready.

Definition at line 101 of file PS3USB.h.

virtual boolean PS3USB::VIDPIDOK	(	uint16_t	vid,
		uint16_t	pid
	)

inlinevirtual

Used by the USB core to check what this driver support.

Parameters

vid	The device's VID.
pid	The device's PID.

Returns: Returns true if the device's VID and PID matches this driver.

Reimplemented from USBDeviceConfig.

Definition at line 111 of file PS3USB.h.

void PS3USB::setBdaddr ( uint8_t * bdaddr )

Used to set the Bluetooth address inside the Dualshock 3 and Navigation controller. Set using LSB first.

Parameters

bdaddr Your dongles Bluetooth address.

Definition at line 463 of file PS3USB.cpp.

void PS3USB::getBdaddr ( uint8_t * bdaddr )

Used to get the Bluetooth address inside the Dualshock 3 and Navigation controller. Will return LSB first.

Parameters

bdaddr Your dongles Bluetooth address.

Definition at line 476 of file PS3USB.cpp.

void PS3USB::setMoveBdaddr ( uint8_t * bdaddr )

Used to set the Bluetooth address inside the Move controller. Set using LSB first.

Parameters

bdaddr Your dongles Bluetooth address.

Definition at line 525 of file PS3USB.cpp.

void PS3USB::getMoveBdaddr ( uint8_t * bdaddr )

Used to get the Bluetooth address inside the Move controller. Will return LSB first.

Parameters

bdaddr Your dongles Bluetooth address.

Definition at line 541 of file PS3USB.cpp.

void PS3USB::getMoveCalibration ( uint8_t * data )

Used to get the calibration data inside the Move controller.

Parameters

data	Buffer to store data in. Must be at least 147 bytes

Definition at line 551 of file PS3USB.cpp.

bool PS3USB::getButtonPress ( ButtonEnum b )

getButtonPress(ButtonEnum b) will return true as long as the button is held down.

While getButtonClick(ButtonEnum b) will only return it once.

So you instance if you need to increase a variable once you would use getButtonClick(ButtonEnum b), but if you need to drive a robot forward you would use getButtonPress(ButtonEnum b).

Parameters

b	ButtonEnum to read.

Returns: getButtonPress(ButtonEnum b) will return a true as long as a button is held down, while getButtonClick(ButtonEnum b) will return true once for each button press.

Definition at line 315 of file PS3USB.cpp.

bool PS3USB::getButtonClick ( ButtonEnum b )

getButtonPress(ButtonEnum b) will return true as long as the button is held down.

While getButtonClick(ButtonEnum b) will only return it once.

So you instance if you need to increase a variable once you would use getButtonClick(ButtonEnum b), but if you need to drive a robot forward you would use getButtonPress(ButtonEnum b).

Parameters

b	ButtonEnum to read.

Returns: getButtonPress(ButtonEnum b) will return a true as long as a button is held down, while getButtonClick(ButtonEnum b) will return true once for each button press.

Definition at line 319 of file PS3USB.cpp.

uint8_t PS3USB::getAnalogButton ( ButtonEnum a )

Used to get the analog value from button presses.

Parameters

a	The ButtonEnum 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 326 of file PS3USB.cpp.

uint8_t PS3USB::getAnalogHat ( AnalogHatEnum 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 330 of file PS3USB.cpp.

uint16_t PS3USB::getSensor ( SensorEnum 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 334 of file PS3USB.cpp.

double PS3USB::getAngle ( AngleEnum 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 338 of file PS3USB.cpp.

bool PS3USB::getStatus ( StatusEnum c )

Get the StatusEnum from the controller.

Parameters

c	The StatusEnum you want to read.

Returns: True if correct and false if not.

Definition at line 361 of file PS3USB.cpp.

void PS3USB::printStatusString ( )

Read all the available statuses from the controller and prints it as a nice formated string.

Definition at line 365 of file PS3USB.cpp.

void PS3USB::setAllOff ( )

Used to set all LEDs and rumble off.

Definition at line 404 of file PS3USB.cpp.

void PS3USB::setRumbleOff ( )

Turn off rumble.

Definition at line 411 of file PS3USB.cpp.

void PS3USB::setRumbleOn ( RumbleEnum mode )

Turn on rumble.

Parameters

mode	Either RumbleHigh or RumbleLow.

Definition at line 420 of file PS3USB.cpp.

void PS3USB::setRumbleOn	(	uint8_t	rightDuration,
		uint8_t	rightPower,
		uint8_t	leftDuration,
		uint8_t	leftPower
	)

Turn on rumble using custom duration and power.

Parameters

rightDuration	The duration of the right/low rumble effect.
rightPower	The intensity of the right/low rumble effect.
leftDuration	The duration of the left/high rumble effect.
leftPower	The intensity of the left/high rumble effect.

Definition at line 431 of file PS3USB.cpp.

void PS3USB::setLedRaw ( uint8_t value )

Set LED value without using the LEDEnum.

Parameters

value See: LEDEnum.

Definition at line 439 of file PS3USB.cpp.

void PS3USB::setLedOff ( )

inline

Turn all LEDs off.

Definition at line 224 of file PS3USB.h.

void PS3USB::setLedOff ( LEDEnum a )

Turn the specific LEDEnum off.

Parameters

a	The LEDEnum to turn off.

Definition at line 444 of file PS3USB.cpp.

void PS3USB::setLedOn ( LEDEnum a )

Turn the specific LEDEnum on.

Parameters

a	The LEDEnum to turn on.

Definition at line 449 of file PS3USB.cpp.

void PS3USB::setLedToggle ( LEDEnum a )

Toggle the specific LEDEnum.

Parameters

a	The LEDEnum to toggle.

Definition at line 458 of file PS3USB.cpp.

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 502 of file PS3USB.cpp.

void PS3USB::moveSetBulb ( ColorsEnum color )

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

Parameters

color The desired color.

Definition at line 511 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 515 of file PS3USB.cpp.

void PS3USB::attachOnInit ( void(*)(void) funcOnInit )

inline

Used to call your own function when the controller is successfully initialized.

Parameters

funcOnInit Function to call.

Definition at line 263 of file PS3USB.h.

Member Data Documentation

bool PS3USB::PS3Connected

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

Definition at line 265 of file PS3USB.h.

bool PS3USB::PS3MoveConnected

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

Definition at line 271 of file PS3USB.h.

bool PS3USB::PS3NavigationConnected

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

Definition at line 273 of file PS3USB.h.

USB* PS3USB::pUsb

protected

Pointer to USB class instance.

Definition at line 277 of file PS3USB.h.

uint8_t PS3USB::bAddress

protected

Device address.

Definition at line 279 of file PS3USB.h.

EpInfo PS3USB::epInfo[PS3_MAX_ENDPOINTS]

protected

Endpoint info structure.

Definition at line 281 of file PS3USB.h.

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

Public Member Functions

Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation