Test version of BlueUSB stack. Includes SDP and RFCOMM. As Client it allows to connect to my fischertechnik TX Controller. As Server it echo\\\\\\\'s characters to Putty. PIN=1234
Dependencies: mbed myUSBHost AvailableMemory
Dependents: mbed_TANK_Kinect myBlueUSB_ros ftusbClass
hci.h@0:81ed8b6e4a8b, 2011-04-04 (annotated)
- Committer:
- networker
- Date:
- Mon Apr 04 16:41:03 2011 +0000
- Revision:
- 0:81ed8b6e4a8b
initial revision
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
networker | 0:81ed8b6e4a8b | 1 | /* |
networker | 0:81ed8b6e4a8b | 2 | Copyright (c) 2010 Peter Barrett |
networker | 0:81ed8b6e4a8b | 3 | |
networker | 0:81ed8b6e4a8b | 4 | Permission is hereby granted, free of charge, to any person obtaining a copy |
networker | 0:81ed8b6e4a8b | 5 | of this software and associated documentation files (the "Software"), to deal |
networker | 0:81ed8b6e4a8b | 6 | in the Software without restriction, including without limitation the rights |
networker | 0:81ed8b6e4a8b | 7 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
networker | 0:81ed8b6e4a8b | 8 | copies of the Software, and to permit persons to whom the Software is |
networker | 0:81ed8b6e4a8b | 9 | furnished to do so, subject to the following conditions: |
networker | 0:81ed8b6e4a8b | 10 | |
networker | 0:81ed8b6e4a8b | 11 | The above copyright notice and this permission notice shall be included in |
networker | 0:81ed8b6e4a8b | 12 | all copies or substantial portions of the Software. |
networker | 0:81ed8b6e4a8b | 13 | |
networker | 0:81ed8b6e4a8b | 14 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
networker | 0:81ed8b6e4a8b | 15 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
networker | 0:81ed8b6e4a8b | 16 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
networker | 0:81ed8b6e4a8b | 17 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
networker | 0:81ed8b6e4a8b | 18 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
networker | 0:81ed8b6e4a8b | 19 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
networker | 0:81ed8b6e4a8b | 20 | THE SOFTWARE. |
networker | 0:81ed8b6e4a8b | 21 | */ |
networker | 0:81ed8b6e4a8b | 22 | |
networker | 0:81ed8b6e4a8b | 23 | #ifndef HCI_H_INCLUDED |
networker | 0:81ed8b6e4a8b | 24 | #define HCI_H_INCLUDED |
networker | 0:81ed8b6e4a8b | 25 | |
networker | 0:81ed8b6e4a8b | 26 | #include "mbed.h" |
networker | 0:81ed8b6e4a8b | 27 | #include "Socket.h" |
networker | 0:81ed8b6e4a8b | 28 | |
networker | 0:81ed8b6e4a8b | 29 | #pragma pack(1) |
networker | 0:81ed8b6e4a8b | 30 | |
networker | 0:81ed8b6e4a8b | 31 | #define ERR_HCI_DEVICE_NOT_FOUND -300 |
networker | 0:81ed8b6e4a8b | 32 | |
networker | 0:81ed8b6e4a8b | 33 | class HCI; |
networker | 0:81ed8b6e4a8b | 34 | class HCITransport; |
networker | 0:81ed8b6e4a8b | 35 | class BTDevice; |
networker | 0:81ed8b6e4a8b | 36 | |
networker | 0:81ed8b6e4a8b | 37 | typedef struct |
networker | 0:81ed8b6e4a8b | 38 | { |
networker | 0:81ed8b6e4a8b | 39 | u8 addr[6]; |
networker | 0:81ed8b6e4a8b | 40 | } BD_ADDR; |
networker | 0:81ed8b6e4a8b | 41 | |
networker | 0:81ed8b6e4a8b | 42 | typedef struct |
networker | 0:81ed8b6e4a8b | 43 | { |
networker | 0:81ed8b6e4a8b | 44 | BD_ADDR bdaddr; |
networker | 0:81ed8b6e4a8b | 45 | u8 pscan_rep_mode; |
networker | 0:81ed8b6e4a8b | 46 | u8 pscan_period_mode; |
networker | 0:81ed8b6e4a8b | 47 | u8 pscan_mode; |
networker | 0:81ed8b6e4a8b | 48 | u8 dev_class[3]; |
networker | 0:81ed8b6e4a8b | 49 | u16 clock_offset; |
networker | 0:81ed8b6e4a8b | 50 | } inquiry_info; |
networker | 0:81ed8b6e4a8b | 51 | |
networker | 0:81ed8b6e4a8b | 52 | typedef struct |
networker | 0:81ed8b6e4a8b | 53 | { |
networker | 0:81ed8b6e4a8b | 54 | u8 status; |
networker | 0:81ed8b6e4a8b | 55 | u16 handle; |
networker | 0:81ed8b6e4a8b | 56 | BD_ADDR bdaddr; |
networker | 0:81ed8b6e4a8b | 57 | u8 link_type; |
networker | 0:81ed8b6e4a8b | 58 | u8 encr_mode; |
networker | 0:81ed8b6e4a8b | 59 | } connection_info; |
networker | 0:81ed8b6e4a8b | 60 | |
networker | 0:81ed8b6e4a8b | 61 | // Address struct for creating L2CAP sockets |
networker | 0:81ed8b6e4a8b | 62 | typedef struct { |
networker | 0:81ed8b6e4a8b | 63 | SocketAddrHdr hdr; |
networker | 0:81ed8b6e4a8b | 64 | BD_ADDR bdaddr; |
networker | 0:81ed8b6e4a8b | 65 | u16 psm; |
networker | 0:81ed8b6e4a8b | 66 | } L2CAPAddr; |
networker | 0:81ed8b6e4a8b | 67 | |
networker | 0:81ed8b6e4a8b | 68 | typedef struct { |
networker | 0:81ed8b6e4a8b | 69 | u16 handle; |
networker | 0:81ed8b6e4a8b | 70 | u16 length; // total |
networker | 0:81ed8b6e4a8b | 71 | u16 l2capLength; // length -4 |
networker | 0:81ed8b6e4a8b | 72 | u16 cid; // Signaling packet CID = 1 |
networker | 0:81ed8b6e4a8b | 73 | |
networker | 0:81ed8b6e4a8b | 74 | // Payload |
networker | 0:81ed8b6e4a8b | 75 | u8 cmd; // |
networker | 0:81ed8b6e4a8b | 76 | u8 id; |
networker | 0:81ed8b6e4a8b | 77 | u16 cmdLength; // total-8 |
networker | 0:81ed8b6e4a8b | 78 | u16 params[4]; // Params |
networker | 0:81ed8b6e4a8b | 79 | } L2CAPCmd; |
networker | 0:81ed8b6e4a8b | 80 | |
networker | 0:81ed8b6e4a8b | 81 | #pragma pack(4) |
networker | 0:81ed8b6e4a8b | 82 | |
networker | 0:81ed8b6e4a8b | 83 | class BTDevice; |
networker | 0:81ed8b6e4a8b | 84 | typedef struct |
networker | 0:81ed8b6e4a8b | 85 | { |
networker | 0:81ed8b6e4a8b | 86 | public: |
networker | 0:81ed8b6e4a8b | 87 | SocketInternal si; |
networker | 0:81ed8b6e4a8b | 88 | BTDevice* btdevice; |
networker | 0:81ed8b6e4a8b | 89 | u16 scid; |
networker | 0:81ed8b6e4a8b | 90 | u16 dcid; |
networker | 0:81ed8b6e4a8b | 91 | } L2CAPSocket; |
networker | 0:81ed8b6e4a8b | 92 | |
networker | 0:81ed8b6e4a8b | 93 | #define MAX_HCL_NAME_LENGTH 20 // TODO - BTDevice wants to be a multiple of 4 |
networker | 0:81ed8b6e4a8b | 94 | |
networker | 0:81ed8b6e4a8b | 95 | // BTDevice encapsulates individual device state |
networker | 0:81ed8b6e4a8b | 96 | // It provides L2CAP layer sockets |
networker | 0:81ed8b6e4a8b | 97 | |
networker | 0:81ed8b6e4a8b | 98 | class BTDevice : public SocketHandler |
networker | 0:81ed8b6e4a8b | 99 | { |
networker | 0:81ed8b6e4a8b | 100 | public: |
networker | 0:81ed8b6e4a8b | 101 | HCITransport* _transport; |
networker | 0:81ed8b6e4a8b | 102 | inquiry_info _info; |
networker | 0:81ed8b6e4a8b | 103 | u16 _handle; // acl connection handle |
networker | 0:81ed8b6e4a8b | 104 | u8 _state; // connection state |
networker | 0:81ed8b6e4a8b | 105 | u8 _txid; |
networker | 0:81ed8b6e4a8b | 106 | u16 peer_mtu; |
networker | 0:81ed8b6e4a8b | 107 | char _name[MAX_HCL_NAME_LENGTH]; |
networker | 0:81ed8b6e4a8b | 108 | |
networker | 0:81ed8b6e4a8b | 109 | void Init(); |
networker | 0:81ed8b6e4a8b | 110 | |
networker | 0:81ed8b6e4a8b | 111 | BD_ADDR* GetAddress() { return &_info.bdaddr; } |
networker | 0:81ed8b6e4a8b | 112 | |
networker | 0:81ed8b6e4a8b | 113 | // Called from HCI |
networker | 0:81ed8b6e4a8b | 114 | void ACLRecv(const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 115 | void ACLFwd(const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 116 | |
networker | 0:81ed8b6e4a8b | 117 | // SocketHandler |
networker | 0:81ed8b6e4a8b | 118 | virtual int Open(SocketInternal* sock, SocketAddrHdr* addr); |
networker | 0:81ed8b6e4a8b | 119 | virtual int Send(SocketInternal* sock, const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 120 | virtual int Close(SocketInternal* sock); |
networker | 0:81ed8b6e4a8b | 121 | virtual char* Name() { return "BTDevice SocketHandler";} |
networker | 0:81ed8b6e4a8b | 122 | |
networker | 0:81ed8b6e4a8b | 123 | private: |
networker | 0:81ed8b6e4a8b | 124 | int l2cap_sock, plen, contPos, contState; |
networker | 0:81ed8b6e4a8b | 125 | unsigned char *contBuf; |
networker | 0:81ed8b6e4a8b | 126 | Timeout rtx; |
networker | 0:81ed8b6e4a8b | 127 | L2CAPCmd last_req; |
networker | 0:81ed8b6e4a8b | 128 | void repeat_cmd(); |
networker | 0:81ed8b6e4a8b | 129 | |
networker | 0:81ed8b6e4a8b | 130 | L2CAPSocket* SCIDToSocket(int scid); |
networker | 0:81ed8b6e4a8b | 131 | int Send(const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 132 | int Send(u8 c, u8 id, u16* params, int count); |
networker | 0:81ed8b6e4a8b | 133 | int Connect(int scid, int psm); |
networker | 0:81ed8b6e4a8b | 134 | int Disconnect(int scid, int dcid); |
networker | 0:81ed8b6e4a8b | 135 | int ConfigureRequest(int dcid); |
networker | 0:81ed8b6e4a8b | 136 | int ConfigureResponse(u8 rxid, int dcid); |
networker | 0:81ed8b6e4a8b | 137 | int DisconnectResponse(u8 rxid, int scid, int dcid); |
networker | 0:81ed8b6e4a8b | 138 | void Control(const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 139 | }; |
networker | 0:81ed8b6e4a8b | 140 | |
networker | 0:81ed8b6e4a8b | 141 | enum HCI_CALLBACK_EVENT |
networker | 0:81ed8b6e4a8b | 142 | { |
networker | 0:81ed8b6e4a8b | 143 | CALLBACK_NONE, |
networker | 0:81ed8b6e4a8b | 144 | CALLBACK_READY, |
networker | 0:81ed8b6e4a8b | 145 | CALLBACK_INQUIRY_RESULT, |
networker | 0:81ed8b6e4a8b | 146 | CALLBACK_INQUIRY_DONE, |
networker | 0:81ed8b6e4a8b | 147 | CALLBACK_REMOTE_NAME, |
networker | 0:81ed8b6e4a8b | 148 | CALLBACK_CONNECTION_COMPLETE, |
networker | 0:81ed8b6e4a8b | 149 | CALLBACK_CONNECTION_FAILED, |
networker | 0:81ed8b6e4a8b | 150 | CALLBACK_PIN_REQ, |
networker | 0:81ed8b6e4a8b | 151 | CALLBACK_CMD_STATUS |
networker | 0:81ed8b6e4a8b | 152 | }; |
networker | 0:81ed8b6e4a8b | 153 | |
networker | 0:81ed8b6e4a8b | 154 | // L2CAP Protocol/Service Multiplexor (PSM) values |
networker | 0:81ed8b6e4a8b | 155 | |
networker | 0:81ed8b6e4a8b | 156 | #define L2CAP_PSM_ANY 0x0000 /* Any/Invalid PSM */ |
networker | 0:81ed8b6e4a8b | 157 | #define L2CAP_PSM_SDP 0x0001 /* Service Discovery Protocol */ |
networker | 0:81ed8b6e4a8b | 158 | #define L2CAP_PSM_RFCOMM 0x0003 /* RFCOMM protocol */ |
networker | 0:81ed8b6e4a8b | 159 | #define L2CAP_PSM_TCP 0x0005 /* Telephony Control Protocol */ |
networker | 0:81ed8b6e4a8b | 160 | #define L2CAP_PSM_TCS 0x0007 /* TCS cordless */ |
networker | 0:81ed8b6e4a8b | 161 | #define L2CAP_PSM_BNEP 0x000f /* Bluetooth Network Encapsulation Protocol*/ |
networker | 0:81ed8b6e4a8b | 162 | #define L2CAP_PSM_HID_CNTL 0x0011 /* HID Control */ |
networker | 0:81ed8b6e4a8b | 163 | #define L2CAP_PSM_HID_INTR 0x0013 /* HID Interrupt */ |
networker | 0:81ed8b6e4a8b | 164 | #define L2CAP_PSM_ESDP 0x0015 /* Extended Service Discovery Profile */ |
networker | 0:81ed8b6e4a8b | 165 | #define L2CAP_PSM_AVCTP 0x0017 /* Audio/Visual Control Transport Protocol */ |
networker | 0:81ed8b6e4a8b | 166 | #define L2CAP_PSM_AVDTP 0x0019 /* Audio/Visual Distribution */ |
networker | 0:81ed8b6e4a8b | 167 | |
networker | 0:81ed8b6e4a8b | 168 | // Callback from inquiry |
networker | 0:81ed8b6e4a8b | 169 | typedef int (*HCICallback)(HCI* hci, HCI_CALLBACK_EVENT evt, const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 170 | //typedef int (HCI::*HCICallback)(HCI_CALLBACK_EVENT evt, const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 171 | |
networker | 0:81ed8b6e4a8b | 172 | #define MAX_BTDEVICES 8 |
networker | 0:81ed8b6e4a8b | 173 | |
networker | 0:81ed8b6e4a8b | 174 | class HCITransport; |
networker | 0:81ed8b6e4a8b | 175 | class HCI : public SocketHandler |
networker | 0:81ed8b6e4a8b | 176 | { |
networker | 0:81ed8b6e4a8b | 177 | HCITransport* _transport; |
networker | 0:81ed8b6e4a8b | 178 | HCICallback _callback; |
networker | 0:81ed8b6e4a8b | 179 | BD_ADDR _localAddr; |
networker | 0:81ed8b6e4a8b | 180 | |
networker | 0:81ed8b6e4a8b | 181 | BTDevice _devices[MAX_BTDEVICES]; |
networker | 0:81ed8b6e4a8b | 182 | int _deviceCount; |
networker | 0:81ed8b6e4a8b | 183 | |
networker | 0:81ed8b6e4a8b | 184 | int _acl_mtu; |
networker | 0:81ed8b6e4a8b | 185 | int _acl_max_pkt; |
networker | 0:81ed8b6e4a8b | 186 | int _sco_mtu; |
networker | 0:81ed8b6e4a8b | 187 | int _sco_max_pkt; |
networker | 0:81ed8b6e4a8b | 188 | |
networker | 0:81ed8b6e4a8b | 189 | int _state; |
networker | 0:81ed8b6e4a8b | 190 | char cmd_credits, data_credits; |
networker | 0:81ed8b6e4a8b | 191 | public: |
networker | 0:81ed8b6e4a8b | 192 | |
networker | 0:81ed8b6e4a8b | 193 | // Open a local adapter |
networker | 0:81ed8b6e4a8b | 194 | int Open(HCITransport* transport, HCICallback callback=0); |
networker | 0:81ed8b6e4a8b | 195 | |
networker | 0:81ed8b6e4a8b | 196 | // Return list of discovered addreses |
networker | 0:81ed8b6e4a8b | 197 | int GetDevices(BTDevice** devices, int maxDevices); |
networker | 0:81ed8b6e4a8b | 198 | |
networker | 0:81ed8b6e4a8b | 199 | // Lookup a device by address or handle |
networker | 0:81ed8b6e4a8b | 200 | BTDevice* Find(const BD_ADDR* addr); |
networker | 0:81ed8b6e4a8b | 201 | BTDevice* Find(int handle); |
networker | 0:81ed8b6e4a8b | 202 | |
networker | 0:81ed8b6e4a8b | 203 | // Disconnect from a remote device |
networker | 0:81ed8b6e4a8b | 204 | int Disconnect(const BD_ADDR* addr); |
networker | 0:81ed8b6e4a8b | 205 | int DisconnectAll(); |
networker | 0:81ed8b6e4a8b | 206 | |
networker | 0:81ed8b6e4a8b | 207 | // see what devies are in the system |
networker | 0:81ed8b6e4a8b | 208 | int Inquiry(int duration = 10); |
networker | 0:81ed8b6e4a8b | 209 | |
networker | 0:81ed8b6e4a8b | 210 | // get a name, delivered in callback |
networker | 0:81ed8b6e4a8b | 211 | int RemoteNameRequest(const BD_ADDR* addr); |
networker | 0:81ed8b6e4a8b | 212 | int RemoteNameRequest(inquiry_info* ii); |
networker | 0:81ed8b6e4a8b | 213 | |
networker | 0:81ed8b6e4a8b | 214 | // Connect to a remote device |
networker | 0:81ed8b6e4a8b | 215 | int CreateConnection(const BD_ADDR* remoteAddr); |
networker | 0:81ed8b6e4a8b | 216 | |
networker | 0:81ed8b6e4a8b | 217 | bool Busy(); |
networker | 0:81ed8b6e4a8b | 218 | |
networker | 0:81ed8b6e4a8b | 219 | // called from transport |
networker | 0:81ed8b6e4a8b | 220 | void HCIRecv(const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 221 | |
networker | 0:81ed8b6e4a8b | 222 | // called from transport |
networker | 0:81ed8b6e4a8b | 223 | void ACLRecv(const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 224 | |
networker | 0:81ed8b6e4a8b | 225 | // SocketHandler methods for maintaining L2CAP sockets |
networker | 0:81ed8b6e4a8b | 226 | virtual int Open(SocketInternal* sock, SocketAddrHdr* addr); |
networker | 0:81ed8b6e4a8b | 227 | virtual int Send(SocketInternal* sock, const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 228 | virtual int Close(SocketInternal* sock); |
networker | 0:81ed8b6e4a8b | 229 | virtual char* Name() { return "HCI SocketHandler";} |
networker | 0:81ed8b6e4a8b | 230 | |
networker | 0:81ed8b6e4a8b | 231 | private: |
networker | 0:81ed8b6e4a8b | 232 | void InquiryResult(const inquiry_info* info); |
networker | 0:81ed8b6e4a8b | 233 | void RemoteName(const BD_ADDR* addr, const char* name); |
networker | 0:81ed8b6e4a8b | 234 | void ConnectComplete(const connection_info* info); |
networker | 0:81ed8b6e4a8b | 235 | void DisconnectComplete(int handle); |
networker | 0:81ed8b6e4a8b | 236 | int SendCmd(int cmd, const u8* params = 0, int len = 0); |
networker | 0:81ed8b6e4a8b | 237 | void OnCommandComplete(int cmd, const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 238 | virtual void Callback(HCI_CALLBACK_EVENT c, const u8* data, int len); |
networker | 0:81ed8b6e4a8b | 239 | protected: |
networker | 0:81ed8b6e4a8b | 240 | int PinCodeReply(const u8* data, const u8* pin = "0000"); |
networker | 0:81ed8b6e4a8b | 241 | }; |
networker | 0:81ed8b6e4a8b | 242 | |
networker | 0:81ed8b6e4a8b | 243 | class HCITransport |
networker | 0:81ed8b6e4a8b | 244 | { |
networker | 0:81ed8b6e4a8b | 245 | protected: |
networker | 0:81ed8b6e4a8b | 246 | HCI* _target; |
networker | 0:81ed8b6e4a8b | 247 | public: |
networker | 0:81ed8b6e4a8b | 248 | void Set(HCI* target) { _target = target; }; |
networker | 0:81ed8b6e4a8b | 249 | virtual void HCISend(const u8* data, int len) = 0; |
networker | 0:81ed8b6e4a8b | 250 | virtual void ACLSend(const u8* data, int len) = 0; |
networker | 0:81ed8b6e4a8b | 251 | }; |
networker | 0:81ed8b6e4a8b | 252 | |
networker | 0:81ed8b6e4a8b | 253 | #endif |