#define INCLUDE_FROM_BLUETOOTHHCICOMMANDS_C\r
#include "BluetoothHCICommands.h"\r
\r
-static BT_HCICommand_Header_t HCICommandHeader;\r
+/** Current processing state of the HCI portion of the Bluetooth stack. */\r
+uint8_t Bluetooth_HCIProcessingState;\r
\r
- uint8_t Bluetooth_HCIProcessingState;\r
-static uint8_t Bluetooth_HCINextState;\r
-static uint8_t Bluetooth_TempDeviceAddress[6];\r
+/** Next HCI state to enter once the last issued HCI command has completed. */\r
+static uint8_t Bluetooth_HCINextState;\r
\r
+/** Temporary Bluetooth Device Address, for HCI responses which much include the detination address */\r
+static uint8_t Bluetooth_TempDeviceAddress[6];\r
+\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
+ BT_HCICommand_Header_t HCICommandHeader;\r
+\r
switch (Bluetooth_HCIProcessingState)\r
{\r
case Bluetooth_ProcessEvents:\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
+ BT_HCI_DEBUG(1, "<< Command Complete", NULL);\r
Bluetooth_HCIProcessingState = Bluetooth_HCINextState;\r
break;\r
case EVENT_COMMAND_STATUS:\r
+ BT_HCI_DEBUG(1, "<< Command Status", NULL);\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
break;\r
case EVENT_CONNECTION_REQUEST:\r
+ BT_HCI_DEBUG(1, "<< Connection Request", NULL);\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
Bluetooth_HCIProcessingState = (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_HCIProcessingState == 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", NULL);\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
\r
Bluetooth_HCIProcessingState = Bluetooth_Conn_SendPINCode;\r
break;\r
+ case EVENT_LINK_KEY_REQUEST:\r
+ BT_HCI_DEBUG(1, "<< Link Key Request", NULL);\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_HCIProcessingState = Bluetooth_Conn_SendLinkKeyNAK;\r
+ break;\r
case EVENT_CONNECTION_COMPLETE:\r
+ BT_HCI_DEBUG(1, "<< Connection Complete", NULL);\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", NULL);\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
+ break;\r
}\r
}\r
\r
\r
break;\r
case Bluetooth_Init:\r
+ BT_HCI_DEBUG(1, "# Init", NULL);\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
break;\r
case Bluetooth_Init_Reset:\r
+ BT_HCI_DEBUG(1, "# Reset", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_RESET},\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
break;\r
case Bluetooth_Init_SetLocalName:\r
+ BT_HCI_DEBUG(1, "# Set Local Name", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_WRITE_LOCAL_NAME},\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
break;\r
case Bluetooth_Init_SetDeviceClass:\r
+ BT_HCI_DEBUG(1, "# Set Device Class", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_WRITE_CLASS_OF_DEVICE},\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
break;\r
case Bluetooth_Init_WriteScanEnable:\r
+ BT_HCI_DEBUG(1, "# Write Scan Enable", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_WRITE_SCAN_ENABLE},\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
break;\r
case Bluetooth_Conn_AcceptConnection:\r
+ BT_HCI_DEBUG(1, "# Accept Connection", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_ACCEPT_CONNECTION_REQUEST},\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
break;\r
case Bluetooth_Conn_RejectConnection:\r
+ BT_HCI_DEBUG(1, "# Reject Connection", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_REJECT_CONNECTION_REQUEST},\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
break;\r
case Bluetooth_Conn_SendPINCode:\r
+ BT_HCI_DEBUG(1, "# Send Pin Code", NULL);\r
+\r
HCICommandHeader = (BT_HCICommand_Header_t)\r
{\r
OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_PIN_CODE_REQUEST_REPLY},\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_HCIProcessingState = Bluetooth_ProcessEvents;\r
+ break;\r
+ case Bluetooth_Conn_SendLinkKeyNAK:\r
+ BT_HCI_DEBUG(1, "# Send Link Key NAK", NULL);\r
+\r
+ HCICommandHeader = (BT_HCICommand_Header_t)\r
+ {\r
+ OpCode: {OGF: OGF_LINK_CONTROL, OCF: 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
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 HCICommandHeader HCI command header to send to the attached device\r
+ * \param Parameters Pointer to the source of the control parameters (if any)\r
+ * \param 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(BT_HCICommand_Header_t* HCICommandHeader, void* Parameters, 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