Name: "LUFA Bluetooth Demo"\r
};\r
\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 \ref Bluetooth_HCIProcessingState\r
+ * global enters the Bluetooth_ProcessEvents state.\r
+ */\r
void Bluetooth_Stack_Init(void)\r
{\r
+ /* Reset the HCI state machine - this will eventually reset the adapter and stack when the Bluetooth stack task is called */\r
Bluetooth_HCIProcessingState = Bluetooth_Init;\r
}\r
\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_HCITask();\r
Bluetooth_ACLTask();\r
}\r
\r
-Bluetooth_Channel_t* Bluetooth_GetChannelData(uint16_t ChannelNumber, bool SearchByRemoteChannel)\r
+/** Retrieves the channel information structure with the given local or remote channel number from the channel list.\r
+ *\r
+ * \param[in] ChannelNumber Channel number to search for in the channel list\r
+ * \param[in] SearchByRemoteChannel Indicated whether to search for a channel information structure by the given remote channel\r
+ * or local channel number\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 ChannelNumber, const bool SearchByRemoteChannel)\r
{\r
for (uint8_t i = 0; i < BLUETOOTH_MAX_OPEN_CHANNELS; i++)\r
{\r
Bluetooth_Channel_t* ChannelData = &Bluetooth_Connection.Channels[i];\r
\r
- uint16_t CurrentChannelNumber = (SearchByRemoteChannel) ? ChannelData->RemoteNumber : ChannelData->LocalNumber;\r
+ /* Fetch the channel number that is to be matched against from the current channel information struct */\r
+ uint16_t SearchChannelNumber = (SearchByRemoteChannel) ? ChannelData->RemoteNumber : ChannelData->LocalNumber;\r
\r
- if (CurrentChannelNumber == ChannelNumber)\r
+ if (SearchChannelNumber == ChannelNumber)\r
return ChannelData;\r
}\r
\r
return NULL;\r
}\r
-\r
-Bluetooth_Channel_t* Bluetooth_InitChannelData(uint16_t RemoteChannelNumber, uint16_t PSM)\r
-{\r
- Bluetooth_Channel_t* ChannelData = Bluetooth_GetChannelData(RemoteChannelNumber, false);\r
-\r
- if (ChannelData == NULL)\r
- {\r
- for (uint8_t i = 0; i < BLUETOOTH_MAX_OPEN_CHANNELS; i++)\r
- {\r
- if (Bluetooth_Connection.Channels[i].State == Channel_Closed)\r
- {\r
- ChannelData = &Bluetooth_Connection.Channels[i]; \r
- ChannelData->LocalNumber = (BLUETOOTH_CHANNELNUMBER_BASEOFFSET + i);\r
- break;\r
- }\r
- }\r
- }\r
-\r
- if (ChannelData != NULL)\r
- {\r
- ChannelData->RemoteNumber = RemoteChannelNumber;\r
- ChannelData->PSM = PSM;\r
- ChannelData->LocalMTU = MAXIMUM_CHANNEL_MTU;\r
- ChannelData->State = Channel_Config_WaitConfig;\r
- }\r
-\r
- return ChannelData;\r
-}\r