this software.\r
*/\r
\r
+/*\r
+ TODO: Add local to remote device connections\r
+ */\r
+\r
#define INCLUDE_FROM_BLUETOOTHHCICOMMANDS_C\r
#include "BluetoothHCICommands.h"\r
\r
-static BT_HCICommand_Header_t HCICommandHeader;\r
-\r
- uint8_t Bluetooth_HCIProcessingState;\r
-static uint8_t Bluetooth_HCINextState;\r
-static uint8_t Bluetooth_TempDeviceAddress[6];\r
+/** Temporary Bluetooth Device Address, for HCI responses which much include the detination address */\r
+static uint8_t Bluetooth_TempDeviceAddress[6];\r
\r
+/** Bluetooth HCI processing task. This task should be called repeatedly the main Bluetooth\r
+ * stack task to manage the HCI processing state.\r
+ */\r
void Bluetooth_HCITask(void)\r
{\r
- switch (Bluetooth_HCIProcessingState)\r
+ BT_HCICommand_Header_t HCICommandHeader;\r
+\r
+ switch (Bluetooth_State.CurrentHCIState)\r
{\r
case Bluetooth_ProcessEvents:\r
Pipe_SelectPipe(BLUETOOTH_EVENTS_PIPE);\r
/* Read in the event parameters into the temporary buffer */\r
Pipe_Read_Stream_LE(&EventParams, HCIEventHeader.ParameterLength);\r
Pipe_ClearIN();\r
+ \r
+ BT_HCI_DEBUG(1, "Event Received (0x%02X)", HCIEventHeader.EventCode);\r
\r
switch (HCIEventHeader.EventCode)\r
{\r
case EVENT_COMMAND_COMPLETE:\r
- Bluetooth_HCIProcessingState = Bluetooth_HCINextState;\r
+ BT_HCI_DEBUG(1, "<< Command Complete");\r
+ \r
+ /* Check which operation was completed in case we need to process the even parameters */\r
+ switch (((BT_HCIEvent_CommandComplete_t*)&EventParams)->Opcode)\r
+ {\r
+ case (OGF_CTRLR_INFORMATIONAL | OCF_CTRLR_INFORMATIONAL_READBDADDR):\r
+ /* A READ BDADDR command completed, copy over the local device's BDADDR from the response */\r
+ memcpy(Bluetooth_State.LocalBDADDR,\r
+ &((BT_HCIEvent_CommandComplete_t*)&EventParams)->ReturnParams[1],\r
+ sizeof(Bluetooth_State.LocalBDADDR));\r
+ break;\r
+ }\r
+ \r
+ Bluetooth_State.CurrentHCIState = Bluetooth_State.NextHCIState;\r
break;\r
case EVENT_COMMAND_STATUS:\r
+ BT_HCI_DEBUG(1, "<< Command Status");\r
+ BT_HCI_DEBUG(2, "-- Status Code: 0x%02X", (((BT_HCIEvent_CommandStatus_t*)&EventParams)->Status));\r
+\r
/* If the execution of a command failed, reset the stack */\r
if (((BT_HCIEvent_CommandStatus_t*)&EventParams)->Status)\r
- Bluetooth_HCIProcessingState = Bluetooth_Init;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_Init;\r
break;\r
case EVENT_CONNECTION_REQUEST:\r
+ BT_HCI_DEBUG(1, "<< Connection Request");\r
+ BT_HCI_DEBUG(2, "-- Link Type: 0x%02X", (((BT_HCIEvent_ConnectionRequest_t*)&EventParams)->LinkType));\r
+\r
/* Need to store the remote device's BT address in a temporary buffer for later use */\r
memcpy(Bluetooth_TempDeviceAddress,\r
&((BT_HCIEvent_ConnectionRequest_t*)&EventParams)->RemoteAddress,\r
\r
/* Only accept the connection if it is a ACL (data) connection, a device is not already connected\r
and the user application has indicated that the connection should be allowed */\r
- Bluetooth_HCIProcessingState = (Bluetooth_Connection.IsConnected || !(IsACLConnection) ||\r
- !(Bluetooth_ConnectionRequest(Bluetooth_TempDeviceAddress))) ?\r
- Bluetooth_Conn_RejectConnection : Bluetooth_Conn_AcceptConnection;\r
+ Bluetooth_State.CurrentHCIState = (Bluetooth_Connection.IsConnected || !(IsACLConnection) ||\r
+ !(Bluetooth_ConnectionRequest(Bluetooth_TempDeviceAddress))) ?\r
+ Bluetooth_Conn_RejectConnection : Bluetooth_Conn_AcceptConnection;\r
+\r
+ BT_HCI_DEBUG(2, "-- Connection %S", (Bluetooth_State.CurrentHCIState == Bluetooth_Conn_RejectConnection) ?\r
+ PSTR("REJECTED") : PSTR("ACCEPTED"));\r
+\r
break;\r
case EVENT_PIN_CODE_REQUEST:\r
+ BT_HCI_DEBUG(1, "<< Pin Code Request");\r
+\r
/* Need to store the remote device's BT address in a temporary buffer for later use */\r
memcpy(Bluetooth_TempDeviceAddress,\r
&((BT_HCIEvent_PinCodeReq_t*)&EventParams)->RemoteAddress,\r
sizeof(Bluetooth_TempDeviceAddress));\r
\r
- Bluetooth_HCIProcessingState = Bluetooth_Conn_SendPINCode;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_Conn_SendPINCode;\r
+ break;\r
+ case EVENT_LINK_KEY_REQUEST:\r
+ BT_HCI_DEBUG(1, "<< Link Key Request");\r
+ \r
+ /* Need to store the remote device's BT address in a temporary buffer for later use */\r
+ memcpy(Bluetooth_TempDeviceAddress,\r
+ &((BT_HCIEvent_LinkKeyReq_t*)&EventParams)->RemoteAddress,\r
+ sizeof(Bluetooth_TempDeviceAddress)); \r
+ \r
+ Bluetooth_State.CurrentHCIState = Bluetooth_Conn_SendLinkKeyNAK;\r
break;\r
case EVENT_CONNECTION_COMPLETE:\r
+ BT_HCI_DEBUG(1, "<< Connection Complete");\r
+ BT_HCI_DEBUG(2, "-- Handle: 0x%04X", ((BT_HCIEvent_ConnectionComplete_t*)&EventParams)->ConnectionHandle);\r
+\r
/* Need to store the remote device's BT address in a temporary buffer for later use */\r
memcpy(Bluetooth_Connection.RemoteAddress,\r
&((BT_HCIEvent_ConnectionComplete_t*)&EventParams)->RemoteAddress,\r
Bluetooth_ConnectionComplete(); \r
break;\r
case EVENT_DISCONNECTION_COMPLETE:\r
+ BT_HCI_DEBUG(1, "<< Disconnection Complete");\r
+\r
/* Device disconnected, indicate connection information no longer valid */\r
Bluetooth_Connection.IsConnected = false;\r
\r
Bluetooth_DisconnectionComplete();\r
\r
- Bluetooth_HCIProcessingState = Bluetooth_Init;\r
- break; \r
+ Bluetooth_State.CurrentHCIState = Bluetooth_Init;\r
+ break;\r
}\r
}\r
\r
\r
break;\r
case Bluetooth_Init:\r
+ BT_HCI_DEBUG(1, "# Init");\r
+\r
+ Bluetooth_State.IsInitialized = false;\r
+\r
/* Reset the connection information structure to destroy any previous connection state */\r
memset(&Bluetooth_Connection, 0x00, sizeof(Bluetooth_Connection));\r
\r
- Bluetooth_HCIProcessingState = Bluetooth_Init_Reset; \r
+ Bluetooth_State.CurrentHCIState = Bluetooth_Init_Reset; \r
break;\r
case Bluetooth_Init_Reset:\r
+ BT_HCI_DEBUG(1, "# Reset");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_RESET},\r
+ OpCode: (OGF_CTRLR_BASEBAND | OCF_CTRLR_BASEBAND_RESET),\r
ParameterLength: 0,\r
};\r
\r
/* Send the command to reset the bluetooth dongle controller */\r
- Bluetooth_SendHCICommand(NULL, 0);\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, NULL, 0);\r
\r
- Bluetooth_HCINextState = Bluetooth_Init_SetLocalName;\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init_ReadBufferSize;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
+ break;\r
+ case Bluetooth_Init_ReadBufferSize:\r
+ BT_HCI_DEBUG(1, "# Read Buffer Size");\r
+ \r
+ HCICommandHeader = (BT_HCICommand_Header_t)\r
+ {\r
+ OpCode: (OGF_CTRLR_INFORMATIONAL | OCF_CTRLR_INFORMATIONAL_READBUFFERSIZE),\r
+ ParameterLength: 0,\r
+ };\r
+\r
+ /* Send the command to read the bluetooth buffer size (mandatory before device sends any data) */\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, NULL, 0);\r
+\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init_GetBDADDR;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
+ break;\r
+ case Bluetooth_Init_GetBDADDR:\r
+ BT_HCI_DEBUG(1, "# Get BDADDR");\r
+ \r
+ HCICommandHeader = (BT_HCICommand_Header_t)\r
+ {\r
+ OpCode: (OGF_CTRLR_INFORMATIONAL | OCF_CTRLR_INFORMATIONAL_READBDADDR),\r
+ ParameterLength: 0,\r
+ };\r
+\r
+ /* Send the command to retrieve the BDADDR of the inserted bluetooth dongle */\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, NULL, 0);\r
+\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init_SetLocalName;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
case Bluetooth_Init_SetLocalName:\r
+ BT_HCI_DEBUG(1, "# Set Local Name");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_WRITE_LOCAL_NAME},\r
+ OpCode: (OGF_CTRLR_BASEBAND | OCF_CTRLR_BASEBAND_WRITE_LOCAL_NAME),\r
ParameterLength: 248,\r
};\r
\r
/* Send the command to set the bluetooth dongle's name for other devices to see */\r
- Bluetooth_SendHCICommand(Bluetooth_DeviceConfiguration.Name, strlen(Bluetooth_DeviceConfiguration.Name));\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, Bluetooth_DeviceConfiguration.Name, strlen(Bluetooth_DeviceConfiguration.Name));\r
\r
- Bluetooth_HCINextState = Bluetooth_Init_SetDeviceClass;\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init_SetDeviceClass;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
case Bluetooth_Init_SetDeviceClass:\r
+ BT_HCI_DEBUG(1, "# Set Device Class");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_WRITE_CLASS_OF_DEVICE},\r
+ OpCode: (OGF_CTRLR_BASEBAND | OCF_CTRLR_BASEBAND_WRITE_CLASS_OF_DEVICE),\r
ParameterLength: 3,\r
};\r
\r
/* Send the command to set the class of the device for other devices to see */\r
- Bluetooth_SendHCICommand(&Bluetooth_DeviceConfiguration.Class, 3);\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, &Bluetooth_DeviceConfiguration.Class, 3);\r
\r
- Bluetooth_HCINextState = Bluetooth_Init_WriteScanEnable;\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init_WriteScanEnable;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
case Bluetooth_Init_WriteScanEnable:\r
+ BT_HCI_DEBUG(1, "# Write Scan Enable");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_WRITE_SCAN_ENABLE},\r
+ OpCode: (OGF_CTRLR_BASEBAND | OCF_CTRLR_BASEBAND_WRITE_SCAN_ENABLE),\r
ParameterLength: 1,\r
};\r
\r
uint8_t Interval = BT_SCANMODE_InquiryAndPageScans;\r
\r
/* Send the command to set the remote device scanning mode */\r
- Bluetooth_SendHCICommand(&Interval, 1);\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, &Interval, 1);\r
\r
- Bluetooth_HCINextState = Bluetooth_ProcessEvents;\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init_FinalizeInit;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
+ break;\r
+ case Bluetooth_Init_FinalizeInit:\r
+ Bluetooth_State.IsInitialized = true;\r
+\r
+ /* Fire the user application callback to indicate that the stack is now fully initialized */\r
+ Bluetooth_StackInitialized();\r
+\r
+ Bluetooth_State.NextHCIState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
case Bluetooth_Conn_AcceptConnection:\r
+ BT_HCI_DEBUG(1, "# Accept Connection");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_ACCEPT_CONNECTION_REQUEST},\r
+ OpCode: (OGF_LINK_CONTROL | OCF_LINK_CONTROL_ACCEPT_CONNECTION_REQUEST),\r
ParameterLength: sizeof(BT_HCICommand_AcceptConnectionReq_t),\r
};\r
\r
AcceptConnectionParams.SlaveRole = true;\r
\r
/* Send the command to accept the remote connection request */\r
- Bluetooth_SendHCICommand(&AcceptConnectionParams, sizeof(BT_HCICommand_AcceptConnectionReq_t));\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, &AcceptConnectionParams, sizeof(BT_HCICommand_AcceptConnectionReq_t));\r
\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
case Bluetooth_Conn_RejectConnection:\r
+ BT_HCI_DEBUG(1, "# Reject Connection");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_REJECT_CONNECTION_REQUEST},\r
+ OpCode: (OGF_LINK_CONTROL | OCF_LINK_CONTROL_REJECT_CONNECTION_REQUEST),\r
ParameterLength: sizeof(BT_HCICommand_RejectConnectionReq_t),\r
};\r
\r
RejectConnectionParams.Reason = Bluetooth_Connection.IsConnected ? ERROR_LIMITED_RESOURCES : ERROR_UNACCEPTABLE_BDADDR;\r
\r
/* Send the command to reject the remote connection request */\r
- Bluetooth_SendHCICommand(&RejectConnectionParams, sizeof(BT_HCICommand_RejectConnectionReq_t));\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, &RejectConnectionParams, sizeof(BT_HCICommand_RejectConnectionReq_t));\r
\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
case Bluetooth_Conn_SendPINCode:\r
+ BT_HCI_DEBUG(1, "# Send Pin Code");\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
- OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_PIN_CODE_REQUEST_REPLY},\r
+ OpCode: (OGF_LINK_CONTROL | OCF_LINK_CONTROL_PIN_CODE_REQUEST_REPLY),\r
ParameterLength: sizeof(BT_HCICommand_PinCodeResp_t),\r
};\r
\r
memcpy(PINCodeRequestParams.PINCode, Bluetooth_DeviceConfiguration.PINCode, sizeof(PINCodeRequestParams.PINCode));\r
\r
/* Send the command to transmit the device's local PIN number for authentication */\r
- Bluetooth_SendHCICommand(&PINCodeRequestParams, sizeof(BT_HCICommand_PinCodeResp_t));\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, &PINCodeRequestParams, sizeof(BT_HCICommand_PinCodeResp_t));\r
+\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
+ break;\r
+ case Bluetooth_Conn_SendLinkKeyNAK:\r
+ BT_HCI_DEBUG(1, "# Send Link Key NAK");\r
+\r
+ HCICommandHeader = (BT_HCICommand_Header_t)\r
+ {\r
+ OpCode: (OGF_LINK_CONTROL | OCF_LINK_CONTROL_LINK_KEY_REQUEST_NEG_REPLY),\r
+ ParameterLength: sizeof(BT_HCICommand_LinkKeyNAKResp_t),\r
+ };\r
+\r
+ /* Copy over the temporary BT device address saved from the Link Key Request event */\r
+ BT_HCICommand_LinkKeyNAKResp_t LinkKeyNAKParams;\r
+ memcpy(LinkKeyNAKParams.RemoteAddress, Bluetooth_TempDeviceAddress, sizeof(LinkKeyNAKParams.RemoteAddress));\r
+\r
+ /* Send the command to transmit the link key NAK to the receiver */\r
+ Bluetooth_SendHCICommand(&HCICommandHeader, &LinkKeyNAKParams, sizeof(BT_HCICommand_LinkKeyNAKResp_t));\r
\r
- Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_ProcessEvents;\r
break;\r
}\r
}\r
\r
-static uint8_t Bluetooth_SendHCICommand(void* Parameters, uint16_t ParameterLength)\r
+/** Sends a Bluetooth HCI control command to the attached Bluetooth device.\r
+ *\r
+ * \param[in] HCICommandHeader HCI command header to send to the attached device\r
+ * \param[in] Parameters Pointer to the source of the control parameters (if any)\r
+ * \param[in] ParameterLength Length of the parameters to send in bytes\r
+ *\r
+ * \return A value from the USB_Host_SendControlErrorCodes_t enum.\r
+ */\r
+static uint8_t Bluetooth_SendHCICommand(const BT_HCICommand_Header_t* const HCICommandHeader, const void* Parameters, const uint16_t ParameterLength)\r
{\r
/* Need to reserve the amount of bytes given in the header for the complete payload */\r
- uint8_t CommandBuffer[sizeof(HCICommandHeader) + HCICommandHeader.ParameterLength];\r
+ uint8_t CommandBuffer[sizeof(BT_HCICommand_Header_t) + HCICommandHeader->ParameterLength];\r
\r
USB_ControlRequest = (USB_Request_Header_t)\r
{\r
};\r
\r
/* Copy over the HCI command header to the allocated buffer */\r
- memcpy(CommandBuffer, &HCICommandHeader, sizeof(HCICommandHeader));\r
+ memcpy(CommandBuffer, HCICommandHeader, sizeof(BT_HCICommand_Header_t));\r
\r
- /* Zero out the parameter section of the response to ensure that any padding bytes do not expose private RAM contents */\r
- memset(&CommandBuffer[sizeof(HCICommandHeader)], 0x00, HCICommandHeader.ParameterLength);\r
+ /* Zero out the parameter section of the response so that all padding bytes are known to be zero */\r
+ memset(&CommandBuffer[sizeof(BT_HCICommand_Header_t)], 0x00, HCICommandHeader->ParameterLength);\r
\r
/* Copy over the command parameters (if any) to the command buffer - note, the number of actual source parameter bytes\r
may differ to those in the header; any difference in length is filled with 0x00 padding bytes */\r
- memcpy(&CommandBuffer[sizeof(HCICommandHeader)], Parameters, ParameterLength);\r
+ memcpy(&CommandBuffer[sizeof(BT_HCICommand_Header_t)], Parameters, ParameterLength);\r
\r
Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
return USB_Host_SendControlRequest(CommandBuffer);\r