USB Host Shield 2.0
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
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 /* Endpoint types */
30 #define EP_INTERRUPT 0x03
31 
32 /* Names we give to the 9 Xbox360 pipes */
33 #define XBOX_CONTROL_PIPE 0
34 #define XBOX_INPUT_PIPE_1 1
35 #define XBOX_OUTPUT_PIPE_1 2
36 #define XBOX_INPUT_PIPE_2 3
37 #define XBOX_OUTPUT_PIPE_2 4
38 #define XBOX_INPUT_PIPE_3 5
39 #define XBOX_OUTPUT_PIPE_3 6
40 #define XBOX_INPUT_PIPE_4 7
41 #define XBOX_OUTPUT_PIPE_4 8
42 
43 // PID and VID of the different devices
44 #define XBOX_VID 0x045E // Microsoft Corporation
45 #define MADCATZ_VID 0x1BAD // For unofficial Mad Catz receivers
46 #define JOYTECH_VID 0x162E // For unofficial Joytech controllers
47 
48 #define XBOX_WIRELESS_RECEIVER_PID 0x0719 // Microsoft Wireless Gaming Receiver
49 #define XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID 0x0291 // Third party Wireless Gaming Receiver
50 
51 #define XBOX_MAX_ENDPOINTS 9
52 
58 class XBOXRECV : public USBDeviceConfig {
59 public:
64  XBOXRECV(USB *pUsb);
65 
74  virtual uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed);
82  virtual uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed);
87  virtual uint8_t Release();
92  virtual uint8_t Poll();
93 
98  virtual uint8_t GetAddress() {
99  return bAddress;
100  };
101 
106  virtual bool isReady() {
107  return bPollEnable;
108  };
109 
116  virtual boolean VIDPIDOK(uint16_t vid, uint16_t pid) {
117  return ((vid == XBOX_VID || vid == MADCATZ_VID || vid == JOYTECH_VID) && (pid == XBOX_WIRELESS_RECEIVER_PID || pid == XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID));
118  };
133  uint8_t getButtonPress(ButtonEnum b, uint8_t controller = 0);
134  bool getButtonClick(ButtonEnum b, uint8_t controller = 0);
144  int16_t getAnalogHat(AnalogHatEnum a, uint8_t controller = 0);
145 
150  void disconnect(uint8_t controller = 0);
151 
156  void setAllOff(uint8_t controller = 0) {
157  setRumbleOn(0, 0, controller);
158  setLedOff(controller);
159  };
160 
165  void setRumbleOff(uint8_t controller = 0) {
166  setRumbleOn(0, 0, controller);
167  };
174  void setRumbleOn(uint8_t lValue, uint8_t rValue, uint8_t controller = 0);
182  void setLedRaw(uint8_t value, uint8_t controller = 0);
183 
188  void setLedOff(uint8_t controller = 0) {
189  setLedRaw(0, controller);
190  };
196  void setLedOn(LEDEnum l, uint8_t controller = 0);
202  void setLedBlink(LEDEnum l, uint8_t controller = 0);
208  void setLedMode(LEDModeEnum lm, uint8_t controller = 0);
214  uint8_t getBatteryLevel(uint8_t controller = 0);
220  bool buttonChanged(uint8_t controller = 0);
221 
226  void attachOnInit(void (*funcOnInit)(void)) {
227  pFuncOnInit = funcOnInit;
228  };
234  uint8_t Xbox360Connected[4];
235 
236 protected:
240  uint8_t bAddress;
243 
244 private:
251  void onInit(uint8_t controller);
252  void (*pFuncOnInit)(void); // Pointer to function called in onInit()
253 
254  bool bPollEnable;
255 
256  /* Variables to store the buttons */
257  uint32_t ButtonState[4];
258  uint32_t OldButtonState[4];
259  uint16_t ButtonClickState[4];
260  int16_t hatValue[4][4];
261  uint16_t controllerStatus[4];
262  bool buttonStateChanged[4]; // True if a button has changed
263 
264  bool L2Clicked[4]; // These buttons are analog, so we use we use these bools to check if they where clicked or not
265  bool R2Clicked[4];
266 
267  uint32_t checkStatusTimer; // Timing for checkStatus() signals
268 
269  uint8_t readBuf[EP_MAXPKTSIZE]; // General purpose buffer for input data
270  uint8_t writeBuf[7]; // General purpose buffer for output data
271 
272  void readReport(uint8_t controller); // read incoming data
273  void printReport(uint8_t controller, uint8_t nBytes); // print incoming date - Uncomment for debugging
274 
275  /* Private commands */
276  void XboxCommand(uint8_t controller, uint8_t* data, uint16_t nbytes);
277  void checkStatus();
278 };
279 #endif
#define XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
Definition: XBOXRECV.h:49
LEDModeEnum
Definition: xboxEnums.h:24
virtual uint8_t Poll()
Definition: XBOXRECV.cpp:292
void setRumbleOn(uint8_t lValue, uint8_t rValue, uint8_t controller=0)
Definition: XBOXRECV.cpp:556
#define XBOX_WIRELESS_RECEIVER_PID
Definition: XBOXRECV.h:48
uint8_t bAddress
Definition: XBOXRECV.h:240
void setLedOff(uint8_t controller=0)
Definition: XBOXRECV.h:188
#define EP_MAXPKTSIZE
Definition: XBOXRECV.h:27
virtual uint8_t GetAddress()
Definition: XBOXRECV.h:98
uint8_t Xbox360Connected[4]
Definition: XBOXRECV.h:234
void setLedMode(LEDModeEnum lm, uint8_t controller=0)
Definition: XBOXRECV.cpp:526
AnalogHatEnum
bool buttonChanged(uint8_t controller=0)
Definition: XBOXRECV.cpp:441
void setRumbleOff(uint8_t controller=0)
Definition: XBOXRECV.h:165
virtual uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed)
Definition: XBOXRECV.cpp:40
virtual bool isReady()
Definition: XBOXRECV.h:106
LEDEnum
#define XBOX_VID
Definition: XBOXRECV.h:44
void setAllOff(uint8_t controller=0)
Definition: XBOXRECV.h:156
virtual uint8_t Release()
Definition: XBOXRECV.cpp:282
Definition: address.h:32
bool getButtonClick(ButtonEnum b, uint8_t controller=0)
Definition: XBOXRECV.cpp:417
void setLedOn(LEDEnum l, uint8_t controller=0)
Definition: XBOXRECV.cpp:515
ButtonEnum
uint8_t getButtonPress(ButtonEnum b, uint8_t controller=0)
Definition: XBOXRECV.cpp:409
bool XboxReceiverConnected
Definition: XBOXRECV.h:228
uint8_t getBatteryLevel(uint8_t controller=0)
Definition: XBOXRECV.cpp:466
int16_t getAnalogHat(AnalogHatEnum a, uint8_t controller=0)
Definition: XBOXRECV.cpp:437
XBOXRECV(USB *pUsb)
Definition: XBOXRECV.cpp:25
#define JOYTECH_VID
Definition: XBOXRECV.h:46
void setLedBlink(LEDEnum l, uint8_t controller=0)
Definition: XBOXRECV.cpp:522
virtual uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed)
Definition: XBOXRECV.cpp:137
#define MADCATZ_VID
Definition: XBOXRECV.h:45
void setLedRaw(uint8_t value, uint8_t controller=0)
Definition: XBOXRECV.cpp:506
virtual boolean VIDPIDOK(uint16_t vid, uint16_t pid)
Definition: XBOXRECV.h:116
Definition: UsbCore.h:176
void attachOnInit(void(*funcOnInit)(void))
Definition: XBOXRECV.h:226
void disconnect(uint8_t controller=0)
Definition: XBOXRECV.cpp:497
USB * pUsb
Definition: XBOXRECV.h:238
EpInfo epInfo[XBOX_MAX_ENDPOINTS]
Definition: XBOXRECV.h:242
#define XBOX_MAX_ENDPOINTS
Definition: XBOXRECV.h:51