USB Host Shield 2.0
XBOXRECV.h
Go to the documentation of this file.
1 /* Copyright (C) 2012 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16 
17  getBatteryLevel and checkStatus functions made by timstamp.co.uk found using BusHound from Perisoft.net
18  */
19 
20 #ifndef _xboxrecv_h_
21 #define _xboxrecv_h_
22 
23 #include "Usb.h"
24 #include "xboxEnums.h"
25 
26 /* Data Xbox 360 taken from descriptors */
27 #define EP_MAXPKTSIZE 32 // max size for data via USB
28 
29 /* Names we give to the 9 Xbox360 pipes */
30 #define XBOX_CONTROL_PIPE 0
31 #define XBOX_INPUT_PIPE_1 1
32 #define XBOX_OUTPUT_PIPE_1 2
33 #define XBOX_INPUT_PIPE_2 3
34 #define XBOX_OUTPUT_PIPE_2 4
35 #define XBOX_INPUT_PIPE_3 5
36 #define XBOX_OUTPUT_PIPE_3 6
37 #define XBOX_INPUT_PIPE_4 7
38 #define XBOX_OUTPUT_PIPE_4 8
39 
40 // PID and VID of the different devices
41 #define XBOX_VID 0x045E // Microsoft Corporation
42 #define MADCATZ_VID 0x1BAD // For unofficial Mad Catz receivers
43 #define JOYTECH_VID 0x162E // For unofficial Joytech controllers
44 
45 #define XBOX_WIRELESS_RECEIVER_PID 0x0719 // Microsoft Wireless Gaming Receiver
46 #define XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID 0x0291 // Third party Wireless Gaming Receiver
47 
48 #define XBOX_MAX_ENDPOINTS 9
49 
55 class XBOXRECV : public USBDeviceConfig {
56 public:
61  XBOXRECV(USB *pUsb);
62 
71  uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed);
79  uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed);
84  uint8_t Release();
89  uint8_t Poll();
90 
95  virtual uint8_t GetAddress() {
96  return bAddress;
97  };
98 
103  virtual bool isReady() {
104  return bPollEnable;
105  };
106 
113  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
114  return ((vid == XBOX_VID || vid == MADCATZ_VID || vid == JOYTECH_VID) && (pid == XBOX_WIRELESS_RECEIVER_PID || pid == XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID));
115  };
130  uint8_t getButtonPress(ButtonEnum b, uint8_t controller = 0);
131  bool getButtonClick(ButtonEnum b, uint8_t controller = 0);
141  int16_t getAnalogHat(AnalogHatEnum a, uint8_t controller = 0);
142 
147  void disconnect(uint8_t controller = 0);
148 
153  void setAllOff(uint8_t controller = 0) {
154  setRumbleOn(0, 0, controller);
155  setLedOff(controller);
156  };
157 
162  void setRumbleOff(uint8_t controller = 0) {
163  setRumbleOn(0, 0, controller);
164  };
171  void setRumbleOn(uint8_t lValue, uint8_t rValue, uint8_t controller = 0);
179  void setLedRaw(uint8_t value, uint8_t controller = 0);
180 
185  void setLedOff(uint8_t controller = 0) {
186  setLedRaw(0, controller);
187  };
193  void setLedOn(LEDEnum l, uint8_t controller = 0);
199  void setLedBlink(LEDEnum l, uint8_t controller = 0);
205  void setLedMode(LEDModeEnum lm, uint8_t controller = 0);
211  uint8_t getBatteryLevel(uint8_t controller = 0);
217  bool buttonChanged(uint8_t controller = 0);
218 
223  void attachOnInit(void (*funcOnInit)(void)) {
224  pFuncOnInit = funcOnInit;
225  };
231  uint8_t Xbox360Connected[4];
232 
233 protected:
237  uint8_t bAddress;
240 
241 private:
248  void onInit(uint8_t controller);
249  void (*pFuncOnInit)(void); // Pointer to function called in onInit()
250 
251  bool bPollEnable;
252 
253  /* Variables to store the buttons */
254  uint32_t ButtonState[4];
255  uint32_t OldButtonState[4];
256  uint16_t ButtonClickState[4];
257  int16_t hatValue[4][4];
258  uint16_t controllerStatus[4];
259  bool buttonStateChanged[4]; // True if a button has changed
260 
261  bool L2Clicked[4]; // These buttons are analog, so we use we use these bools to check if they where clicked or not
262  bool R2Clicked[4];
263 
264  uint32_t checkStatusTimer; // Timing for checkStatus() signals
265 
266  uint8_t readBuf[EP_MAXPKTSIZE]; // General purpose buffer for input data
267  uint8_t writeBuf[7]; // General purpose buffer for output data
268 
269  void readReport(uint8_t controller); // read incoming data
270  void printReport(uint8_t controller, uint8_t nBytes); // print incoming date - Uncomment for debugging
271 
272  /* Private commands */
273  void XboxCommand(uint8_t controller, uint8_t* data, uint16_t nbytes);
274  void checkStatus();
275 };
276 #endif
XBOXRECV::getButtonClick
bool getButtonClick(ButtonEnum b, uint8_t controller=0)
Definition: XBOXRECV.cpp:419
XBOX_WIRELESS_RECEIVER_PID
#define XBOX_WIRELESS_RECEIVER_PID
Definition: XBOXRECV.h:45
USBDeviceConfig
Definition: UsbCore.h:134
XBOXRECV
Definition: XBOXRECV.h:55
XBOXRECV::setLedOn
void setLedOn(LEDEnum l, uint8_t controller=0)
Definition: XBOXRECV.cpp:518
XBOXRECV::getButtonPress
uint8_t getButtonPress(ButtonEnum b, uint8_t controller=0)
Definition: XBOXRECV.cpp:410
XBOX_VID
#define XBOX_VID
Definition: XBOXRECV.h:41
XBOXRECV::setLedBlink
void setLedBlink(LEDEnum l, uint8_t controller=0)
Definition: XBOXRECV.cpp:525
XBOXRECV::getBatteryLevel
uint8_t getBatteryLevel(uint8_t controller=0)
Definition: XBOXRECV.cpp:469
XBOXRECV::setLedRaw
void setLedRaw(uint8_t value, uint8_t controller=0)
Definition: XBOXRECV.cpp:509
XBOXRECV::XBOXRECV
XBOXRECV(USB *pUsb)
Definition: XBOXRECV.cpp:25
XBOXRECV::Init
uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed)
Definition: XBOXRECV.cpp:138
LEDEnum
LEDEnum
Definition: controllerEnums.h:31
XBOXRECV::epInfo
EpInfo epInfo[XBOX_MAX_ENDPOINTS]
Definition: XBOXRECV.h:239
XBOXRECV::Poll
uint8_t Poll()
Definition: XBOXRECV.cpp:293
XBOXRECV::attachOnInit
void attachOnInit(void(*funcOnInit)(void))
Definition: XBOXRECV.h:223
XBOXRECV::setRumbleOn
void setRumbleOn(uint8_t lValue, uint8_t rValue, uint8_t controller=0)
Definition: XBOXRECV.cpp:559
XBOXRECV::setLedOff
void setLedOff(uint8_t controller=0)
Definition: XBOXRECV.h:185
XBOXRECV::GetAddress
virtual uint8_t GetAddress()
Definition: XBOXRECV.h:95
EpInfo
Definition: address.h:39
XBOXRECV::setLedMode
void setLedMode(LEDModeEnum lm, uint8_t controller=0)
Definition: XBOXRECV.cpp:529
XBOXRECV::disconnect
void disconnect(uint8_t controller=0)
Definition: XBOXRECV.cpp:500
USB
Definition: UsbCore.h:210
XBOXRECV::pUsb
USB * pUsb
Definition: XBOXRECV.h:235
XBOXRECV::setRumbleOff
void setRumbleOff(uint8_t controller=0)
Definition: XBOXRECV.h:162
XBOXRECV::VIDPIDOK
virtual bool VIDPIDOK(uint16_t vid, uint16_t pid)
Definition: XBOXRECV.h:113
XBOX_MAX_ENDPOINTS
#define XBOX_MAX_ENDPOINTS
Definition: XBOXRECV.h:48
XBOXRECV::buttonChanged
bool buttonChanged(uint8_t controller=0)
Definition: XBOXRECV.cpp:444
XBOXRECV::isReady
virtual bool isReady()
Definition: XBOXRECV.h:103
EP_MAXPKTSIZE
#define EP_MAXPKTSIZE
Definition: XBOXRECV.h:27
XBOXRECV::bAddress
uint8_t bAddress
Definition: XBOXRECV.h:237
XBOXRECV::Xbox360Connected
uint8_t Xbox360Connected[4]
Definition: XBOXRECV.h:231
XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
#define XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
Definition: XBOXRECV.h:46
JOYTECH_VID
#define JOYTECH_VID
Definition: XBOXRECV.h:43
XBOXRECV::Release
uint8_t Release()
Definition: XBOXRECV.cpp:283
Usb.h
LEDModeEnum
LEDModeEnum
Definition: xboxEnums.h:24
XBOXRECV::XboxReceiverConnected
bool XboxReceiverConnected
Definition: XBOXRECV.h:225
XBOXRECV::ConfigureDevice
uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed)
Definition: XBOXRECV.cpp:41
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
MADCATZ_VID
#define MADCATZ_VID
Definition: XBOXRECV.h:42
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:213
xboxEnums.h
XBOXRECV::setAllOff
void setAllOff(uint8_t controller=0)
Definition: XBOXRECV.h:153
XBOXRECV::getAnalogHat
int16_t getAnalogHat(AnalogHatEnum a, uint8_t controller=0)
Definition: XBOXRECV.cpp:440