Device mode class driver callbacks are now fired before the control request status...
[pub/USBasp.git] / Demos / Host / Incomplete / BluetoothHost / Lib / BluetoothStack.c
index e265910..6b434ba 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
+  Copyright 2010  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
+  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 "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
+/** 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
-       if (!(USB_IsConnected) || (USB_HostState != HOST_STATE_Ready))\r
-         Bluetooth_HCIProcessingState = Bluetooth_Init;\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