\r
#include "BluetoothStack.h"\r
\r
-Bluetooth_Connection_t Bluetooth_Connection = {IsConnected: false};\r
+/** Bluetooth device connection information structure. Once connected to a remote device, this structure tracks the\r
+ * connection state of the individual L2CAP channels.\r
+ */\r
+Bluetooth_Connection_t Bluetooth_Connection = { IsConnected: false };\r
\r
-Bluetooth_Device_t Bluetooth_DeviceConfiguration ATTR_WEAK =\r
- {\r
- Class: DEVICE_CLASS_MAJOR_MISC,\r
- PINCode: "0000",\r
- Name: "LUFA BT Device"\r
- };\r
-\r
-void Bluetooth_State_Init(void)\r
-{\r
- Bluetooth_HCIProcessingState = Bluetooth_Init;\r
-}\r
+/** Bluetooth device state information structure. This structure contains details on the current Bluetooth stack\r
+ * state.\r
+ */\r
+Bluetooth_Stack_State_t Bluetooth_State = { IsInitialized: false };\r
\r
-void Bluetooth_Stack_Task(void)\r
+/** Bluetooth stack initialization function. This function must be called once to initialize the Bluetooth stack,\r
+ * ready for connection to remote devices.\r
+ *\r
+ * \note This function only begins the initialization process; the stack is initialized as the main Bluetooth stack\r
+ * management task is repeatedly called. The initialization process ends when the IsInitialized element of the\r
+ * \ref Bluetooth_State structure becomes true and the \ref Bluetooth_StackInitialized() callback fires.\r
+ */\r
+void Bluetooth_Stack_Init(void)\r
{\r
- Bluetooth_ProcessHCICommands();\r
- Bluetooth_ProcessACLPackets();\r
+ /* Reset the HCI state machine - this will eventually reset the adapter and stack when the Bluetooth stack task is called */\r
+ Bluetooth_State.CurrentHCIState = Bluetooth_Init;\r
+ Bluetooth_State.NextHCIState = Bluetooth_Init;\r
}\r
\r
-Bluetooth_Channel_t* Bluetooth_GetChannelData(uint16_t ChannelNumber, bool SearchBySource)\r
+/** Bluetooth stack management task. This task must be repeatedly called to maintain the Bluetooth stack and any connection\r
+ * to remote Bluetooth devices, including both the HCI control layer and the ACL channel layer.\r
+ */\r
+void Bluetooth_Stack_USBTask(void)\r
{\r
- Bluetooth_Channel_t* CurrentChannelStructure;\r
-\r
- for (uint8_t i = 0; i < BLUETOOTH_MAX_OPEN_CHANNELS; i++)\r
- {\r
- CurrentChannelStructure = &Bluetooth_Connection.Channels[i];\r
- \r
- uint16_t CurrentChannelNumber = ((SearchBySource) ? CurrentChannelStructure->RemoteNumber : CurrentChannelStructure->LocalNumber);\r
- \r
- if (CurrentChannelNumber == ChannelNumber)\r
- return CurrentChannelStructure;\r
- }\r
-\r
- return NULL;\r
+ Bluetooth_HCITask();\r
+ Bluetooth_ACLTask();\r
}\r
\r
-Bluetooth_Channel_t* Bluetooth_InitChannelData(uint16_t RemoteChannelNumber, uint16_t PSM)\r
+/** Retrieves the channel information structure with the given local or remote channel number from the channel list.\r
+ *\r
+ * \param[in] SearchValue Value to search for in the channel structure list\r
+ * \param[in] SearchKey Key to search within the channel structure, a CHANNEL_SEARCH_* mask\r
+ *\r
+ * \return Pointer to the matching channel information structure in the channel table if found, NULL otherwise\r
+ */\r
+Bluetooth_Channel_t* Bluetooth_GetChannelData(const uint16_t SearchValue, const uint8_t SearchKey)\r
{\r
- Bluetooth_Channel_t* CurrentChannelStructure;\r
-\r
for (uint8_t i = 0; i < BLUETOOTH_MAX_OPEN_CHANNELS; i++)\r
{\r
- CurrentChannelStructure = &Bluetooth_Connection.Channels[i];\r
+ Bluetooth_Channel_t* ChannelData = &Bluetooth_Connection.Channels[i];\r
\r
- if (CurrentChannelStructure->State == Channel_Closed)\r
+ bool FoundMatch = false;\r
+ \r
+ switch (SearchKey)\r
{\r
- CurrentChannelStructure->RemoteNumber = RemoteChannelNumber;\r
- CurrentChannelStructure->LocalNumber = (BLUETOOTH_CHANNELNUMBER_BASEOFFSET + i);\r
- CurrentChannelStructure->PSM = PSM;\r
- CurrentChannelStructure->State = Channel_Config;\r
- \r
- return CurrentChannelStructure;\r
- } \r
+ case CHANNEL_SEARCH_LOCALNUMBER:\r
+ FoundMatch = (SearchValue == ChannelData->LocalNumber);\r
+ break;\r
+ case CHANNEL_SEARCH_REMOTENUMBER:\r
+ FoundMatch = (SearchValue == ChannelData->RemoteNumber);\r
+ break;\r
+ case CHANNEL_SEARCH_PSM:\r
+ FoundMatch = (SearchValue == ChannelData->PSM);\r
+ break;\r
+ }\r
+ \r
+ if (FoundMatch)\r
+ return ChannelData;\r
}\r
\r
return NULL;\r