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
 /*\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
               \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
 \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
   software without specific, written prior permission.\r
 \r
   The author disclaim all warranties with regard to this\r
 \r
 #include "BluetoothStack.h"\r
 \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
 \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
 \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
 {\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
 }\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
 {\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
 }\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
 {\r
-       Bluetooth_Channel_t* CurrentChannelStructure;\r
-\r
        for (uint8_t i = 0; i < BLUETOOTH_MAX_OPEN_CHANNELS; i++)\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
        \r
-               if (CurrentChannelStructure->State == Channel_Closed)\r
+               bool FoundMatch = false;\r
+               \r
+               switch (SearchKey)\r
                {\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
        }\r
 \r
        return NULL;\r