More improvements to the incomplete BluetoothHost demo - add Disconnection Event...
[pub/lufa.git] / Demos / Host / Incomplete / BluetoothHost / Lib / BluetoothHCICommands.c
index ddd159e..dd2a3e5 100644 (file)
@@ -1,21 +1,21 @@
 /*\r
              LUFA Library\r
-     Copyright (C) Dean Camera, 2009.\r
+     Copyright (C) Dean Camera, 2010.\r
               \r
   dean [at] fourwalledcubicle [dot] com\r
       www.fourwalledcubicle.com\r
 */\r
 \r
 /*\r
-  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
-  Permission to use, copy, modify, and distribute this software\r
-  and its documentation for any purpose and without fee is hereby\r
-  granted, provided that the above copyright notice appear in all\r
-  copies and that both that the copyright notice and this\r
-  permission notice and warranty disclaimer appear in supporting\r
-  documentation, and that the name of the author not be used in\r
-  advertising or publicity pertaining to distribution of the\r
+  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
+\r
+  Permission to use, copy, modify, distribute, and sell this \r
+  software and its documentation for any purpose is hereby granted\r
+  without fee, provided that the above copyright notice appear in \r
+  all copies and that both that the copyright notice and this\r
+  permission notice and warranty disclaimer appear in supporting \r
+  documentation, and that the name of the author not be used in \r
+  advertising or publicity pertaining to distribution of the \r
   software without specific, written prior permission.\r
 \r
   The author disclaim all warranties with regard to this\r
 \r
 #include "BluetoothHCICommands.h"\r
 \r
-static   Bluetooth_HCICommand_Header_t HCICommandHeader;\r
-static   Bluetooth_HCIEvent_Header_t   HCIEventHeader;\r
+static Bluetooth_HCICommand_Header_t HCICommandHeader;\r
 \r
-         uint8_t                       Bluetooth_HCIProcessingState;\r
-static   uint8_t                       Bluetooth_TempDeviceAddress[6];\r
+       uint8_t                       Bluetooth_HCIProcessingState;\r
+static uint8_t                       Bluetooth_HCINextState;\r
+static uint8_t                       Bluetooth_TempDeviceAddress[6];\r
 \r
-static uint8_t Bluetooth_SendHCICommand(void* Parameters, uint8_t ParamLength)\r
+static uint8_t Bluetooth_SendHCICommand(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
 \r
        USB_ControlRequest = (USB_Request_Header_t)\r
                {\r
-                       bmRequestType: (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_DEVICE),\r
-                       bRequest:      0,\r
-                       wValue:        0,\r
-                       wIndex:        0,\r
-                       wLength:       sizeof(CommandBuffer)\r
+                       .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_DEVICE),\r
+                       .bRequest      = 0,\r
+                       .wValue        = 0,\r
+                       .wIndex        = 0,\r
+                       .wLength       = sizeof(CommandBuffer)\r
                };\r
-               \r
-       memset(CommandBuffer, 0x00, sizeof(CommandBuffer));\r
+\r
+       /* Copy over the HCI command header to the allocated buffer */\r
        memcpy(CommandBuffer, &HCICommandHeader, sizeof(HCICommandHeader));\r
        \r
-       if (ParamLength)\r
-         memcpy(&CommandBuffer[sizeof(HCICommandHeader)], Parameters, ParamLength);\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
 \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
+       \r
        Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
-\r
        return USB_Host_SendControlRequest(CommandBuffer);\r
 }\r
 \r
-static bool Bluetooth_GetNextHCIEventHeader(void)\r
-{\r
-       Pipe_SelectPipe(BLUETOOTH_EVENTS_PIPE);\r
-       Pipe_Unfreeze();\r
-       \r
-       if (!(Pipe_IsReadWriteAllowed()))\r
-       {\r
-               Pipe_Freeze();\r
-               return false;\r
-       }\r
-         \r
-       Pipe_Read_Stream_LE(&HCIEventHeader, sizeof(HCIEventHeader));\r
-         \r
-       Pipe_Freeze();\r
-\r
-       return true;\r
-}\r
-\r
-static void Bluetooth_DiscardRemainingHCIEventParameters(void)\r
-{\r
-       Pipe_SelectPipe(BLUETOOTH_EVENTS_PIPE);\r
-       \r
-       Pipe_Unfreeze();\r
-       Pipe_Discard_Stream(HCIEventHeader.ParameterLength);\r
-       Pipe_ClearIN();\r
-       Pipe_Freeze();\r
-}\r
-\r
 void Bluetooth_ProcessHCICommands(void)\r
 {\r
-       uint8_t ErrorCode;\r
-\r
        switch (Bluetooth_HCIProcessingState)\r
        {\r
-               case Bluetooth_Init:\r
+               case Bluetooth_ProcessEvents:\r
                        Pipe_SelectPipe(BLUETOOTH_EVENTS_PIPE);\r
+                       Pipe_Unfreeze();\r
                        \r
-                       memset(&Bluetooth_Connection, 0x00, sizeof(Bluetooth_Connection));\r
-                                                          \r
-                       Bluetooth_HCIProcessingState = Bluetooth_Init_Reset; \r
-                       break;\r
-               case Bluetooth_Init_Reset:\r
-                       HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
+                       if (Pipe_IsReadWriteAllowed())\r
                        {\r
-                               OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_RESET},\r
-                               ParameterLength: 0,\r
-                       };\r
-                       \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Init_Reset", NULL);\r
+                               Bluetooth_HCIEvent_Header_t HCIEventHeader;\r
 \r
-                       ErrorCode = Bluetooth_SendHCICommand(NULL, 0);\r
+                               /* Read in the event header to fetch the event code and payload length */\r
+                               Pipe_Read_Stream_LE(&HCIEventHeader, sizeof(HCIEventHeader));\r
+                               \r
+                               /* Create a temporary buffer for the event parameters */\r
+                               uint8_t EventParams[HCIEventHeader.ParameterLength];\r
 \r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
+                               /* Read in the event parameters into the temporary buffer */\r
+                               Pipe_Read_Stream_LE(&EventParams, HCIEventHeader.ParameterLength);\r
+                               Pipe_ClearIN();\r
 \r
-                       Bluetooth_HCIProcessingState = Bluetooth_Init_ReadBufferSize;\r
+                               BT_HCI_DEBUG("Event Code: 0x%02X", HCIEventHeader.EventCode);\r
+                               \r
+                               switch (HCIEventHeader.EventCode)\r
+                               {\r
+                                       case EVENT_COMMAND_COMPLETE:\r
+                                               Bluetooth_HCIProcessingState = Bluetooth_HCINextState;\r
+\r
+                                               BT_HCI_DEBUG(">> Command Complete (Opcode 0x%04x)", \r
+                                                        ((Bluetooth_HCIEvent_CommandComplete_t*)&EventParams)->Opcode);\r
+                                               break;\r
+                                       case EVENT_COMMAND_STATUS:\r
+                                               /* If the execution of a command failed, reset the stack */\r
+                                               if (((Bluetooth_HCIEvent_CommandStatus_t*)&EventParams)->Status)\r
+                                                 Bluetooth_HCIProcessingState = Bluetooth_Init;\r
+\r
+                                               BT_HCI_DEBUG(">> Command Status: 0x%02X",\r
+                                                        ((Bluetooth_HCIEvent_CommandStatus_t*)&EventParams)->Status);                                  \r
+                                               break;\r
+                                       case EVENT_CONNECTION_REQUEST:\r
+                                               /* Need to store the remote device's BT address in a temporary buffer for later use */\r
+                                               memcpy(Bluetooth_TempDeviceAddress,\r
+                                                      &((Bluetooth_HCIEvent_ConnectionRequest_t*)&EventParams)->RemoteAddress,\r
+                                                      sizeof(Bluetooth_TempDeviceAddress));\r
+                                       \r
+                                               /* Only accept the connection if it is a ACL (data) connection */\r
+                                               Bluetooth_HCIProcessingState = (Bluetooth_Connection.IsConnected ||\r
+                                                                              (((Bluetooth_HCIEvent_ConnectionRequest_t*)&EventParams)->LinkType != 0x01)) ?\r
+                                                                                                          Bluetooth_Conn_RejectConnection : Bluetooth_Conn_AcceptConnection;\r
+\r
+                                               BT_HCI_DEBUG(">> Connection Request from Device %02X:%02X:%02X:%02X:%02X:%02X",\r
+                                                                Bluetooth_TempDeviceAddress[5], Bluetooth_TempDeviceAddress[4], Bluetooth_TempDeviceAddress[3],\r
+                                                                Bluetooth_TempDeviceAddress[2], Bluetooth_TempDeviceAddress[1], Bluetooth_TempDeviceAddress[0]);\r
+                                               break;\r
+                                       case EVENT_PIN_CODE_REQUEST:\r
+                                               /* Need to store the remote device's BT address in a temporary buffer for later use */\r
+                                               memcpy(Bluetooth_TempDeviceAddress,\r
+                                                      &((Bluetooth_HCIEvent_PinCodeRequest_t*)&EventParams)->RemoteAddress,\r
+                                                      sizeof(Bluetooth_TempDeviceAddress));\r
+\r
+                                               Bluetooth_HCIProcessingState = Bluetooth_Conn_SendPINCode;\r
+\r
+                                               BT_HCI_DEBUG(">> PIN Request from Device %02X:%02X:%02X:%02X:%02X:%02X", \r
+                                                                Bluetooth_TempDeviceAddress[5], Bluetooth_TempDeviceAddress[4], Bluetooth_TempDeviceAddress[3],\r
+                                                                Bluetooth_TempDeviceAddress[2], Bluetooth_TempDeviceAddress[1], Bluetooth_TempDeviceAddress[0]);\r
+                                               break;\r
+                                       case EVENT_CONNECTION_COMPLETE:\r
+                                               /* Need to store the remote device's BT address in a temporary buffer for later use */\r
+                                               memcpy(Bluetooth_Connection.RemoteAddress,\r
+                                                      &((Bluetooth_HCIEvent_ConnectionComplete_t*)&EventParams)->RemoteAddress,\r
+                                                      sizeof(Bluetooth_TempDeviceAddress));\r
+\r
+                                               /* Store the created connection handle and indicate that the connection has been established */\r
+                                               Bluetooth_Connection.ConnectionHandle = ((Bluetooth_HCIEvent_ConnectionComplete_t*)&EventParams)->ConnectionHandle;\r
+                                               Bluetooth_Connection.IsConnected      = true;\r
+\r
+                                               BT_HCI_DEBUG(">> Connection Complete to Device %02X:%02X:%02X:%02X:%02X:%02X, Handle 0x%04x", \r
+                                                                Bluetooth_Connection.RemoteAddress[5], Bluetooth_Connection.RemoteAddress[4],\r
+                                                                Bluetooth_Connection.RemoteAddress[3], Bluetooth_Connection.RemoteAddress[2],\r
+                                                                Bluetooth_Connection.RemoteAddress[1], Bluetooth_Connection.RemoteAddress[0],\r
+                                                                Bluetooth_Connection.ConnectionHandle);\r
+                                               break;\r
+                                       case EVENT_DISCONNECTION_COMPLETE:\r
+                                               BT_HCI_DEBUG(">> Disconnection Complete", NULL);\r
+\r
+                                               /* Device disconnected, indicate connection information no longer valid */\r
+                                               Bluetooth_Connection.IsConnected = false;\r
+                                               \r
+                                               Bluetooth_HCIProcessingState = Bluetooth_Init;\r
+                                               break;                                  \r
+                               }\r
+                       }\r
+                       \r
+                       Pipe_Freeze();\r
+                       \r
                        break;\r
-               case Bluetooth_Init_ReadBufferSize:\r
-                       HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
-                       {\r
-                               OpCode: {OGF: OGF_CTRLR_INFORMATIONAL, OCF: OGF_CTRLR_INFORMATIONAL_READBUFFERSIZE},\r
-                               ParameterLength: 0,\r
-                       };\r
-               \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Init_ReadBufferSize", NULL);\r
-\r
-                       ErrorCode = Bluetooth_SendHCICommand(NULL, 0);\r
-\r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
+               case Bluetooth_Init:\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_SetEventMask;             \r
+                       Bluetooth_HCIProcessingState = Bluetooth_Init_Reset; \r
                        break;\r
-               case Bluetooth_Init_SetEventMask:\r
+               case Bluetooth_Init_Reset:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
                        {\r
-                               OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_SET_EVENT_MASK},\r
-                               ParameterLength: 8,\r
+                               OpCode: {OGF: OGF_CTRLR_BASEBAND, OCF: OCF_CTRLR_BASEBAND_RESET},\r
+                               ParameterLength: 0,\r
                        };\r
-               \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Init_SetEventMask", NULL);\r
                        \r
-                       uint8_t EventMask[8] = {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF};\r
-                       ErrorCode = Bluetooth_SendHCICommand(&EventMask, 8);\r
-\r
-                       BT_DEBUG("(HCI) -- Event mask: 0x%02X%02X%02X%02X%02X%02X%02X%02X", EventMask[7], EventMask[6], EventMask[5], EventMask[4],\r
-                                                                                           EventMask[3], EventMask[2], EventMask[1], EventMask[0]);\r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
-               \r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Init_Reset", NULL);\r
 \r
-                       Bluetooth_HCIProcessingState = Bluetooth_Init_SetLocalName;             \r
+                       /* Send the command to reset the bluetooth dongle controller */\r
+                       Bluetooth_SendHCICommand(NULL, 0);\r
+                       \r
+                       Bluetooth_HCINextState       = Bluetooth_Init_SetLocalName;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
                case Bluetooth_Init_SetLocalName:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
@@ -169,18 +189,14 @@ void Bluetooth_ProcessHCICommands(void)
                                        ParameterLength: 248,\r
                                };\r
 \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Init_SetLocalName", NULL);\r
-                       BT_DEBUG("(HCI)  -- Name: %s", Bluetooth_DeviceConfiguration.Name);\r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Init_SetLocalName", NULL);\r
+                       BT_HCI_DEBUG("-- Name: %s", Bluetooth_DeviceConfiguration.Name);\r
 \r
-                       ErrorCode = Bluetooth_SendHCICommand(Bluetooth_DeviceConfiguration.Name, strlen(Bluetooth_DeviceConfiguration.Name));\r
-                       \r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
-                       \r
-                       Bluetooth_HCIProcessingState = Bluetooth_Init_SetDeviceClass;\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
+\r
+                       Bluetooth_HCINextState       = Bluetooth_Init_SetDeviceClass;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
                case Bluetooth_Init_SetDeviceClass:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
@@ -189,17 +205,13 @@ void Bluetooth_ProcessHCICommands(void)
                                        ParameterLength: 3,\r
                                };\r
 \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Init_SetDeviceClass", NULL);\r
-\r
-                       ErrorCode = Bluetooth_SendHCICommand(&Bluetooth_DeviceConfiguration.Class, 3);\r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Init_SetDeviceClass", NULL);\r
 \r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
+                       /* Send the command to set the class of the device for other devices to see */\r
+                       Bluetooth_SendHCICommand(&Bluetooth_DeviceConfiguration.Class, 3);\r
 \r
-                       Bluetooth_HCIProcessingState = Bluetooth_Init_WriteScanEnable;  \r
+                       Bluetooth_HCINextState       = Bluetooth_Init_WriteScanEnable;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
                case Bluetooth_Init_WriteScanEnable:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
@@ -208,169 +220,78 @@ void Bluetooth_ProcessHCICommands(void)
                                ParameterLength: 1,\r
                        };\r
                        \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Init_WriteScanEnable", NULL);\r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Init_WriteScanEnable", NULL);\r
 \r
-                       uint8_t Interval = InquiryAndPageScans;\r
-                       ErrorCode = Bluetooth_SendHCICommand(&Interval, 1);\r
-\r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
-\r
-                       Bluetooth_HCIProcessingState = Bluetooth_PrepareToProcessEvents;\r
-                       break;\r
-               case Bluetooth_PrepareToProcessEvents:\r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_ProcessEvents", NULL);\r
-\r
-                       Bluetooth_HCIProcessingState     = Bluetooth_ProcessEvents;\r
-                       break;\r
-               case Bluetooth_ProcessEvents:\r
-                       if (Bluetooth_GetNextHCIEventHeader())\r
-                       {\r
-                               BT_DEBUG("(HCI) Event Code: 0x%02X", HCIEventHeader.EventCode);\r
+                       uint8_t Interval = BT_SCANMODE_InquiryAndPageScans;\r
                        \r
-                               if (HCIEventHeader.EventCode == EVENT_COMMAND_STATUS)\r
-                               {\r
-                                       Bluetooth_HCIEvent_CommandStatus_Header_t CommandStatusHeader;\r
-\r
-                                       Pipe_Read_Stream_LE(&CommandStatusHeader, sizeof(CommandStatusHeader));\r
-                                       HCIEventHeader.ParameterLength -= sizeof(CommandStatusHeader);\r
-                                                                               \r
-                                       BT_DEBUG("(HCI) >> Command status: 0x%02X", CommandStatusHeader.CommandStatus);\r
-                                       \r
-                                       if (CommandStatusHeader.CommandStatus)\r
-                                         Bluetooth_HCIProcessingState = Bluetooth_Init;\r
-                               }\r
-                               else if (HCIEventHeader.EventCode == EVENT_CONNECTION_REQUEST)\r
-                               {\r
-                                       Bluetooth_HCIEvent_ConnectionRequest_Header_t ConnectionRequestParams;\r
-                                       \r
-                                       Pipe_Read_Stream_LE(&ConnectionRequestParams, sizeof(ConnectionRequestParams));\r
-                                       HCIEventHeader.ParameterLength -= sizeof(ConnectionRequestParams);\r
-\r
-                                       BT_DEBUG("(HCI) >> Connection Request from device %02X:%02X:%02X:%02X:%02X:%02X",\r
-                                                ConnectionRequestParams.RemoteAddress[5], ConnectionRequestParams.RemoteAddress[4], \r
-                                                ConnectionRequestParams.RemoteAddress[3], ConnectionRequestParams.RemoteAddress[2], \r
-                                                ConnectionRequestParams.RemoteAddress[1], ConnectionRequestParams.RemoteAddress[0]);\r
-                                       BT_DEBUG("(HCI) -- Device Class: 0x%02X%04X", ConnectionRequestParams.ClassOfDevice_Service,\r
-                                                                                     ConnectionRequestParams.ClassOfDevice_MajorMinor);\r
-                                       BT_DEBUG("(HCI) -- Link Type: 0x%02x", ConnectionRequestParams.LinkType);\r
-                                       \r
-                                       memcpy(Bluetooth_TempDeviceAddress, ConnectionRequestParams.RemoteAddress,\r
-                                              sizeof(Bluetooth_TempDeviceAddress));\r
-\r
-                                       Bluetooth_HCIProcessingState = (Bluetooth_Connection.IsConnected) ? Bluetooth_Conn_RejectConnection :\r
-                                                                                                               Bluetooth_Conn_AcceptConnection;\r
-                               }\r
-                               else if (HCIEventHeader.EventCode == EVENT_DISCONNECTION_COMPLETE)\r
-                               {\r
-                                       BT_DEBUG("(HCI) >> Disconnection from device complete.", NULL);\r
-                                       Bluetooth_HCIProcessingState = Bluetooth_Init;\r
-                               }\r
-                               else if (HCIEventHeader.EventCode == EVENT_CONNECTION_COMPLETE)\r
-                               {\r
-                                       Bluetooth_HCIEvent_ConnectionComplete_Header_t ConnectionCompleteParams;\r
-                                       \r
-                                       Pipe_Read_Stream_LE(&ConnectionCompleteParams, sizeof(ConnectionCompleteParams));\r
-                                       HCIEventHeader.ParameterLength -= sizeof(ConnectionCompleteParams);\r
-\r
-                                       BT_DEBUG("(HCI) >> Connection to device complete.", NULL);\r
-                                       BT_DEBUG("(HCI) -- Status: %d", ConnectionCompleteParams.Status);\r
-                                       BT_DEBUG("(HCI) -- Handle: %d", ConnectionCompleteParams.ConnectionHandle);\r
-                                       \r
-                                       if (ConnectionCompleteParams.Status == 0x00)\r
-                                       {\r
-                                               memcpy(Bluetooth_Connection.DeviceAddress, ConnectionCompleteParams.RemoteAddress,\r
-                                                          sizeof(Bluetooth_Connection.DeviceAddress));\r
-                                               Bluetooth_Connection.ConnectionHandle = ConnectionCompleteParams.ConnectionHandle;\r
-                                               Bluetooth_Connection.IsConnected = true;\r
-                                       }\r
-                               }\r
-                               else if (HCIEventHeader.EventCode == EVENT_PIN_CODE_REQUEST)\r
-                               {\r
-                                       Pipe_Read_Stream_LE(&Bluetooth_TempDeviceAddress, sizeof(Bluetooth_TempDeviceAddress));\r
-                                       HCIEventHeader.ParameterLength -= sizeof(Bluetooth_TempDeviceAddress);\r
-\r
-                                       BT_DEBUG("(HCI) >> PIN code Request from device %02X:%02X:%02X:%02X:%02X:%02X", \r
-                                                        Bluetooth_TempDeviceAddress[5], Bluetooth_TempDeviceAddress[4], Bluetooth_TempDeviceAddress[3],\r
-                                                        Bluetooth_TempDeviceAddress[2], Bluetooth_TempDeviceAddress[1], Bluetooth_TempDeviceAddress[0]);\r
-                                                        \r
-                                       Bluetooth_HCIProcessingState = Bluetooth_Conn_SendPINCode;\r
-                               }\r
-                               \r
-                               BT_DEBUG("(HCI) -- Unread Event Param Length: %d", HCIEventHeader.ParameterLength);\r
-\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       }\r
-\r
+                       /* Send the command to set the remote device scanning mode */\r
+                       Bluetooth_SendHCICommand(&Interval, 1);\r
+                       \r
+                       Bluetooth_HCINextState       = Bluetooth_ProcessEvents;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
                case Bluetooth_Conn_AcceptConnection:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
                                {\r
                                        OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_ACCEPT_CONNECTION_REQUEST},\r
-                                       ParameterLength: sizeof(Bluetooth_HCICommand_AcceptConnectionRequest_Params_t),\r
+                                       ParameterLength: sizeof(Bluetooth_HCICommand_AcceptConnectionRequest_t),\r
                                };\r
                        \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Conn_AcceptConnection", NULL);\r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Conn_AcceptConnection", NULL);\r
 \r
-                       Bluetooth_HCICommand_AcceptConnectionRequest_Params_t AcceptConnectionParams;\r
-                                                        \r
+                       /* Copy over the temporary BT device address saved from the Connection Request event, indicate slave\r
+                          connection role */\r
+                       Bluetooth_HCICommand_AcceptConnectionRequest_t AcceptConnectionParams;\r
                        memcpy(AcceptConnectionParams.RemoteAddress, Bluetooth_TempDeviceAddress,\r
-                              sizeof(Bluetooth_TempDeviceAddress));\r
+                              sizeof(AcceptConnectionParams.RemoteAddress));\r
                        AcceptConnectionParams.SlaveRole = true;\r
 \r
-                       Bluetooth_SendHCICommand(&AcceptConnectionParams, sizeof(AcceptConnectionParams));\r
+                       /* Send the command to accept the remote connection request */\r
+                       Bluetooth_SendHCICommand(&AcceptConnectionParams, sizeof(Bluetooth_HCICommand_AcceptConnectionRequest_t));\r
                        \r
-                       Bluetooth_HCIProcessingState     = Bluetooth_PrepareToProcessEvents;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
                case Bluetooth_Conn_RejectConnection:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
                                {\r
-                                       OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_ACCEPT_CONNECTION_REQUEST},\r
-                                       ParameterLength: sizeof(Bluetooth_HCICommand_RejectConnectionRequest_Params_t),\r
+                                       OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_REJECT_CONNECTION_REQUEST},\r
+                                       ParameterLength: sizeof(Bluetooth_HCICommand_RejectConnectionRequest_t),\r
                                };\r
                        \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Conn_RejectConnection", NULL);\r
-\r
-                       Bluetooth_HCICommand_RejectConnectionRequest_Params_t RejectConnectionParams;\r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Conn_RejectConnection", NULL);\r
 \r
-                       memcpy(RejectConnectionParams.RemoteAddress, Bluetooth_TempDeviceAddress,\r
-                              sizeof(Bluetooth_TempDeviceAddress));\r
+                       /* Copy over the temporary BT device address saved from the Connection Request event, indicate failure\r
+                          to accept the connection due to limited device resources */\r
+                       Bluetooth_HCICommand_RejectConnectionRequest_t RejectConnectionParams;\r
+                       memcpy(RejectConnectionParams.RemoteAddress, Bluetooth_TempDeviceAddress, sizeof(RejectConnectionParams.RemoteAddress));\r
                        RejectConnectionParams.Reason = ERROR_LIMITED_RESOURCES;\r
 \r
-                       Bluetooth_SendHCICommand(&AcceptConnectionParams, sizeof(AcceptConnectionParams));\r
+                       /* Send the command to reject the remote connection request */\r
+                       Bluetooth_SendHCICommand(&RejectConnectionParams, sizeof(Bluetooth_HCICommand_RejectConnectionRequest_t));\r
                \r
-                       Bluetooth_HCIProcessingState     = Bluetooth_PrepareToProcessEvents;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
                case Bluetooth_Conn_SendPINCode:\r
                        HCICommandHeader = (Bluetooth_HCICommand_Header_t)\r
                                {\r
                                        OpCode: {OGF: OGF_LINK_CONTROL, OCF: OCF_LINK_CONTROL_PIN_CODE_REQUEST_REPLY},\r
-                                       ParameterLength: sizeof(Bluetooth_HCICommand_PinCodeResponse_Params_t),\r
+                                       ParameterLength: sizeof(Bluetooth_HCICommand_PinCodeResponse_t),\r
                                };\r
                        \r
-                       BT_DEBUG("(HCI) Enter State: Bluetooth_Conn_SendPINCode", NULL);\r
-                       BT_DEBUG("(HCI) -- PIN: %s", Bluetooth_DeviceConfiguration.PINCode);\r
+                       BT_HCI_DEBUG("Enter State: Bluetooth_Conn_SendPINCode", NULL);\r
+                       BT_HCI_DEBUG("-- PIN: %s", Bluetooth_DeviceConfiguration.PINCode);\r
 \r
-                       Bluetooth_HCICommand_PinCodeResponse_Params_t PINCodeRequestParams;\r
-               \r
-                       memcpy(PINCodeRequestParams.RemoteAddress, Bluetooth_TempDeviceAddress,\r
-                              sizeof(Bluetooth_TempDeviceAddress));\r
+                       /* Copy over the temporary BT device address saved from the PIN Code Request event, copy over the\r
+                          local PIN authentication code to the response */\r
+                       Bluetooth_HCICommand_PinCodeResponse_t PINCodeRequestParams;\r
+                       memcpy(PINCodeRequestParams.RemoteAddress, Bluetooth_TempDeviceAddress, sizeof(PINCodeRequestParams.RemoteAddress));\r
                        PINCodeRequestParams.PINCodeLength = strlen(Bluetooth_DeviceConfiguration.PINCode);\r
-                       memcpy(PINCodeRequestParams.PINCode, Bluetooth_DeviceConfiguration.PINCode,\r
-                              sizeof(Bluetooth_DeviceConfiguration.PINCode));\r
+                       memcpy(PINCodeRequestParams.PINCode, Bluetooth_DeviceConfiguration.PINCode, sizeof(PINCodeRequestParams.PINCode));\r
                        \r
-                       Bluetooth_SendHCICommand(&PINCodeRequestParams, sizeof(PINCodeRequestParams));\r
-               \r
-                       do\r
-                       {\r
-                               while (!(Bluetooth_GetNextHCIEventHeader()));\r
-                               Bluetooth_DiscardRemainingHCIEventParameters();\r
-                       } while (HCIEventHeader.EventCode != EVENT_COMMAND_COMPLETE);\r
+                       /* Send the command to transmit the device's local PIN number for authentication */\r
+                       Bluetooth_SendHCICommand(&PINCodeRequestParams, sizeof(Bluetooth_HCICommand_PinCodeResponse_t));\r
 \r
-                       Bluetooth_HCIProcessingState     = Bluetooth_PrepareToProcessEvents;\r
+                       Bluetooth_HCIProcessingState = Bluetooth_ProcessEvents;\r
                        break;\r
        }\r
 }\r