USB Host Shield 2.0
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
BTD.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 
18 #ifndef _btd_h_
19 #define _btd_h_
20 
21 #include "Usb.h"
22 #include "confdescparser.h"
23 
24 //PID and VID of the Sony PS3 devices
25 #define PS3_VID 0x054C // Sony Corporation
26 #define PS3_PID 0x0268 // PS3 Controller DualShock 3
27 #define PS3NAVIGATION_PID 0x042F // Navigation controller
28 #define PS3MOVE_PID 0x03D5 // Motion controller
29 
30 /* Bluetooth dongle data taken from descriptors */
31 #define BULK_MAXPKTSIZE 64 // max size for ACL data
32 
33 // Used in control endpoint header for HCI Commands
34 #define bmREQ_HCI_OUT USB_SETUP_HOST_TO_DEVICE|USB_SETUP_TYPE_CLASS|USB_SETUP_RECIPIENT_DEVICE
35 // Used in control endpoint header for HID Commands
36 #define bmREQ_HID_OUT USB_SETUP_HOST_TO_DEVICE|USB_SETUP_TYPE_CLASS|USB_SETUP_RECIPIENT_INTERFACE
37 #define HID_REQUEST_SET_REPORT 0x09
38 
39 /* Bluetooth HCI states for hci_task() */
40 #define HCI_INIT_STATE 0
41 #define HCI_RESET_STATE 1
42 #define HCI_BDADDR_STATE 2
43 #define HCI_LOCAL_VERSION_STATE 3
44 #define HCI_SET_NAME_STATE 4
45 #define HCI_CHECK_WII_SERVICE 5
46 
47 #define HCI_INQUIRY_STATE 6 // These three states are only used if it should pair and connect to a Wii controller
48 #define HCI_CONNECT_WII_STATE 7
49 #define HCI_CONNECTED_WII_STATE 8
50 
51 #define HCI_SCANNING_STATE 9
52 #define HCI_CONNECT_IN_STATE 10
53 #define HCI_REMOTE_NAME_STATE 11
54 #define HCI_CONNECTED_STATE 12
55 #define HCI_DISABLE_SCAN_STATE 13
56 #define HCI_DONE_STATE 14
57 #define HCI_DISCONNECT_STATE 15
58 
59 /* HCI event flags*/
60 #define HCI_FLAG_CMD_COMPLETE 0x01
61 #define HCI_FLAG_CONN_COMPLETE 0x02
62 #define HCI_FLAG_DISCONN_COMPLETE 0x04
63 #define HCI_FLAG_REMOTE_NAME_COMPLETE 0x08
64 #define HCI_FLAG_INCOMING_REQUEST 0x10
65 #define HCI_FLAG_READ_BDADDR 0x20
66 #define HCI_FLAG_READ_VERSION 0x40
67 #define HCI_FLAG_WII_FOUND 0x80
68 #define HCI_FLAG_CONNECT_EVENT 0x100
69 
70 /*Macros for HCI event flag tests */
71 #define hci_cmd_complete (hci_event_flag & HCI_FLAG_CMD_COMPLETE)
72 #define hci_connect_complete (hci_event_flag & HCI_FLAG_CONN_COMPLETE)
73 #define hci_disconnect_complete (hci_event_flag & HCI_FLAG_DISCONN_COMPLETE)
74 #define hci_remote_name_complete (hci_event_flag & HCI_FLAG_REMOTE_NAME_COMPLETE)
75 #define hci_incoming_connect_request (hci_event_flag & HCI_FLAG_INCOMING_REQUEST)
76 #define hci_read_bdaddr_complete (hci_event_flag & HCI_FLAG_READ_BDADDR)
77 #define hci_read_version_complete (hci_event_flag & HCI_FLAG_READ_VERSION)
78 #define hci_wii_found (hci_event_flag & HCI_FLAG_WII_FOUND)
79 #define hci_connect_event (hci_event_flag & HCI_FLAG_CONNECT_EVENT)
80 
81 /* HCI Events managed */
82 #define EV_INQUIRY_COMPLETE 0x01
83 #define EV_INQUIRY_RESULT 0x02
84 #define EV_CONNECT_COMPLETE 0x03
85 #define EV_INCOMING_CONNECT 0x04
86 #define EV_DISCONNECT_COMPLETE 0x05
87 #define EV_AUTHENTICATION_COMPLETE 0x06
88 #define EV_REMOTE_NAME_COMPLETE 0x07
89 #define EV_ENCRYPTION_CHANGE 0x08
90 #define EV_CHANGE_CONNECTION_LINK 0x09
91 #define EV_ROLE_CHANGED 0x12
92 #define EV_NUM_COMPLETE_PKT 0x13
93 #define EV_PIN_CODE_REQUEST 0x16
94 #define EV_LINK_KEY_REQUEST 0x17
95 #define EV_LINK_KEY_NOTIFICATION 0x18
96 #define EV_DATA_BUFFER_OVERFLOW 0x1A
97 #define EV_MAX_SLOTS_CHANGE 0x1B
98 #define EV_READ_REMOTE_VERSION_INFORMATION_COMPLETE 0x0C
99 #define EV_QOS_SETUP_COMPLETE 0x0D
100 #define EV_COMMAND_COMPLETE 0x0E
101 #define EV_COMMAND_STATUS 0x0F
102 #define EV_LOOPBACK_COMMAND 0x19
103 #define EV_PAGE_SCAN_REP_MODE 0x20
104 
105 /* L2CAP signaling commands */
106 #define L2CAP_CMD_COMMAND_REJECT 0x01
107 #define L2CAP_CMD_CONNECTION_REQUEST 0x02
108 #define L2CAP_CMD_CONNECTION_RESPONSE 0x03
109 #define L2CAP_CMD_CONFIG_REQUEST 0x04
110 #define L2CAP_CMD_CONFIG_RESPONSE 0x05
111 #define L2CAP_CMD_DISCONNECT_REQUEST 0x06
112 #define L2CAP_CMD_DISCONNECT_RESPONSE 0x07
113 #define L2CAP_CMD_INFORMATION_REQUEST 0x0A
114 #define L2CAP_CMD_INFORMATION_RESPONSE 0x0B
115 
116 // Used For Connection Response - Remember to Include High Byte
117 #define PENDING 0x01
118 #define SUCCESSFUL 0x00
119 
120 /* Bluetooth L2CAP PSM - see http://www.bluetooth.org/Technical/AssignedNumbers/logical_link.htm */
121 #define SDP_PSM 0x01 // Service Discovery Protocol PSM Value
122 #define RFCOMM_PSM 0x03 // RFCOMM PSM Value
123 #define HID_CTRL_PSM 0x11 // HID_Control PSM Value
124 #define HID_INTR_PSM 0x13 // HID_Interrupt PSM Value
125 
126 // Used to determine if it is a Bluetooth dongle
127 #define WI_SUBCLASS_RF 0x01 // RF Controller
128 #define WI_PROTOCOL_BT 0x01 // Bluetooth Programming Interface
129 
130 #define BTD_MAX_ENDPOINTS 4
131 #define BTD_NUMSERVICES 4 // Max number of Bluetooth services
132 
134 class BluetoothService {
135 public:
140  virtual void ACLData(uint8_t* ACLData);
142  virtual void Run();
144  virtual void Reset();
146  virtual void disconnect();
147 };
148 
153 class BTD : public USBDeviceConfig, public UsbConfigXtracter {
154 public:
159  BTD(USB *p);
160 
169  virtual uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed);
174  virtual uint8_t Release();
179  virtual uint8_t Poll();
184  virtual uint8_t GetAddress() { return bAddress; };
189  virtual bool isReady() { return bPollEnable; };
201  virtual void EndpointXtract(uint8_t conf, uint8_t iface, uint8_t alt, uint8_t proto, const USB_ENDPOINT_DESCRIPTOR *ep);
205  void disconnect() {
206  for (uint8_t i=0; i<BTD_NUMSERVICES; i++)
207  if (btService[i])
208  btService[i]->disconnect();
209  };
215  int8_t registerServiceClass(BluetoothService *pService) {
216  for (uint8_t i=0; i<BTD_NUMSERVICES; i++) {
217  if (!btService[i]) {
218  btService[i] = pService;
219  return i; // Return ID
220  }
221  }
222  return -1; // ErrorregisterServiceClass
223  };
224 
231  void HCI_Command(uint8_t* data, uint16_t nbytes);
233  void hci_reset();
235  void hci_read_bdaddr();
237  void hci_read_local_version_information();
242  void hci_set_local_name(const char* name);
244  void hci_write_scan_enable();
246  void hci_write_scan_disable();
248  void hci_remote_name();
250  void hci_accept_connection();
255  void hci_disconnect(uint16_t handle);
261  void hci_pin_code_request_reply();
263  void hci_pin_code_negative_request_reply();
268  void hci_link_key_request_negative_reply();
270  void hci_authentication_request();
272  void hci_inquiry();
274  void hci_inquiry_cancel();
276  void hci_connect();
288  void L2CAP_Command(uint16_t handle, uint8_t* data, uint8_t nbytes, uint8_t channelLow = 0x01, uint8_t channelHigh = 0x00);
296  void l2cap_connection_request(uint16_t handle, uint8_t rxid, uint8_t* scid, uint16_t psm);
305  void l2cap_connection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid, uint8_t result);
312  void l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t* dcid);
319  void l2cap_config_response(uint16_t handle, uint8_t rxid, uint8_t* scid);
327  void l2cap_disconnection_request(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid);
335  void l2cap_disconnection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid);
342  void l2cap_information_response(uint16_t handle, uint8_t rxid, uint8_t infoTypeLow, uint8_t infoTypeHigh);
346  bool watingForConnection;
348  bool l2capConnectionClaimed;
350  bool sdpConnectionClaimed;
352  bool rfcommConnectionClaimed;
353 
355  const char* btdName;
357  const char* btdPin;
358 
360  uint8_t my_bdaddr[6];
362  uint16_t hci_handle;
364  uint8_t disc_bdaddr[6];
366  uint8_t remote_name[30];
372  uint8_t hci_version;
374  bool connectToWii;
376  bool incomingWii;
378  bool pairWithWii;
380  bool motionPlusInside;
382  bool wiiUProController;
383 
388  uint8_t readPollInterval() { return pollInterval; };
389 
390 protected:
392  USB *pUsb;
394  uint8_t bAddress;
396  EpInfo epInfo[BTD_MAX_ENDPOINTS];
397 
399  uint8_t bConfNum;
401  uint8_t bNumEP;
403  uint32_t qNextPollTime;
404 
406  static const uint8_t BTD_CONTROL_PIPE;
408  static const uint8_t BTD_EVENT_PIPE;
410  static const uint8_t BTD_DATAIN_PIPE;
412  static const uint8_t BTD_DATAOUT_PIPE;
413 
418  void PrintEndpointDescriptor(const USB_ENDPOINT_DESCRIPTOR* ep_ptr);
419 
420 private:
421  BluetoothService* btService[BTD_NUMSERVICES];
422 
423  bool bPollEnable;
424  uint8_t pollInterval;
425 
426  /* Variables used by high level HCI task */
427  uint8_t hci_state; //current state of bluetooth hci connection
428  uint16_t hci_counter; // counter used for bluetooth hci reset loops
429  uint8_t hci_num_reset_loops; // this value indicate how many times it should read before trying to reset
430  uint16_t hci_event_flag; // hci flags of received bluetooth events
431  uint8_t inquiry_counter;
432 
433  uint8_t hcibuf[BULK_MAXPKTSIZE];//General purpose buffer for hci data
434  uint8_t l2capinbuf[BULK_MAXPKTSIZE];//General purpose buffer for l2cap in data
435  uint8_t l2capoutbuf[BULK_MAXPKTSIZE];//General purpose buffer for l2cap out data
436 
437  /* State machines */
438  void HCI_event_task(); // Poll the HCI event pipe
439  void HCI_task(); // HCI state machine
440  void ACL_event_task(); // ACL input pipe
441 
442  /* Used to set the Bluetooth Address internally to the PS3 Controllers */
443  void setBdaddr(uint8_t* BDADDR);
444  void setMoveBdaddr(uint8_t* BDADDR);
445 };
446 #endif
Generated by   doxygen 1.8.3.1