/* Includes: */\r
#include <LUFA/Drivers/USB/USB.h>\r
\r
- #include "BluetoothHost.h"\r
- \r
/* Macros: */\r
- #define BLUETOOTH_DATA_IN_PIPE 1\r
- #define BLUETOOTH_DATA_OUT_PIPE 2\r
- #define BLUETOOTH_EVENTS_PIPE 3\r
+ #define BLUETOOTH_DATA_IN_PIPE 1\r
+ #define BLUETOOTH_DATA_OUT_PIPE 2\r
+ #define BLUETOOTH_EVENTS_PIPE 3\r
\r
- #define BLUETOOTH_MAX_OPEN_CHANNELS 6\r
+ #define BLUETOOTH_MAX_OPEN_CHANNELS 6\r
+ \r
+ #define CHANNEL_PSM_SDP 0x0001\r
+ #define CHANNEL_PSM_UDP 0x0002\r
+ #define CHANNEL_PSM_RFCOMM 0x0003\r
+ #define CHANNEL_PSM_TCP 0x0004\r
+ #define CHANNEL_PSM_IP 0x0009\r
+ #define CHANNEL_PSM_FTP 0x000A\r
+ #define CHANNEL_PSM_HTTP 0x000C\r
+ #define CHANNEL_PSM_UPNP 0x0010\r
+ #define CHANNEL_PSM_HIDP 0x0011\r
\r
- #define CHANNEL_PSM_SERVICEDISCOVERY 0x0001\r
- #define CHANNEL_PSM_UDP 0x0002\r
- #define CHANNEL_PSM_RFCOMM 0x0003\r
- #define CHANNEL_PSM_TCP 0x0004\r
- #define CHANNEL_PSM_IP 0x0009\r
- #define CHANNEL_PSM_FTP 0x000A\r
- #define CHANNEL_PSM_HTTP 0x000C\r
- #define CHANNEL_PSM_UPNP 0x0010\r
- #define CHANNEL_PSM_HIDP 0x0011\r
+ #define CHANNEL_SEARCH_LOCALNUMBER 0\r
+ #define CHANNEL_SEARCH_REMOTENUMBER 1\r
+ #define CHANNEL_SEARCH_PSM 2\r
\r
- #define MAXIMUM_CHANNEL_MTU 255\r
+ #define MAXIMUM_CHANNEL_MTU 255\r
\r
/* Enums: */\r
/** Enum for the possible states for a bluetooth ACL channel. */\r
*/\r
typedef struct\r
{\r
- bool IsConnected;\r
- uint16_t ConnectionHandle;\r
- uint8_t RemoteAddress[6];\r
- Bluetooth_Channel_t Channels[BLUETOOTH_MAX_OPEN_CHANNELS];\r
- uint8_t SignallingIdentifier;\r
+ bool IsConnected; /**< Indicates if the stack is currently connected to a remote device - if this value is\r
+ * false, the remaining elements are invalid.\r
+ */\r
+ uint16_t ConnectionHandle; /**< Connection handle to the remote device, used internally in the stack. */\r
+ uint8_t RemoteAddress[6]; /**< Bluetooth device address of the attached remote device. */\r
+ Bluetooth_Channel_t Channels[BLUETOOTH_MAX_OPEN_CHANNELS]; /**< Channel information structures for the connection. */\r
+ uint8_t SignallingIdentifier; /**< Next Signalling Channel unique command sequence identifier. */\r
} Bluetooth_Connection_t;\r
\r
/** Local Bluetooth device information structure, for the defining of local device characteristics for the Bluetooth stack. */\r
typedef struct\r
{\r
- uint32_t Class;\r
- char PINCode[16];\r
- char Name[];\r
+ uint32_t Class; /**< Class of the local device, a mask of DEVICE_CLASS_* masks. */\r
+ char PINCode[16]; /**< Pin code required to send or receive in order to authenticate with a remote device. */\r
+ char Name[]; /**< Name of the local bluetooth device, up to 248 characters. */\r
} Bluetooth_Device_t;\r
+ \r
+ /** Bluetooth stack state information structure, for the containment of the Bluetooth stack state. The values in\r
+ * this structure are set by the Bluetooth stack internally, and should all be treated as read only by the user\r
+ * application.\r
+ */\r
+ typedef struct\r
+ {\r
+ uint8_t CurrentHCIState; /**< Current HCI state machine state. */\r
+ uint8_t NextHCIState; /**< Next HCI state machine state to progress to once the currently issued command completes. */\r
+ bool IsInitialized; /**< Indicates if the Bluetooth stack is currently initialized and ready for connections\r
+ * to or from a remote Bluetooth device.\r
+ */\r
+ uint8_t LocalBDADDR[6]; /**< Local bluetooth adapter's BDADDR, valid when the stack is fully initialized. */\r
+ } Bluetooth_Stack_State_t;\r
\r
/* Includes: */\r
#include "BluetoothHCICommands.h"\r
void Bluetooth_Stack_Init(void);\r
void Bluetooth_Stack_USBTask(void);\r
\r
- bool Bluetooth_ConnectionRequest(uint8_t* RemoteAddress);\r
+ void Bluetooth_StackInitialized(void);\r
+ bool Bluetooth_ConnectionRequest(const uint8_t* RemoteAddress);\r
void Bluetooth_ConnectionComplete(void);\r
void Bluetooth_DisconnectionComplete(void);\r
- void Bluetooth_PacketReceived(uint16_t* PacketLength, Bluetooth_Channel_t* Channel);\r
- Bluetooth_Channel_t* Bluetooth_GetChannelData(uint16_t ChannelNumber, bool SearchByRemoteChannel);\r
- Bluetooth_Channel_t* Bluetooth_OpenChannel(uint16_t PSM);\r
- void Bluetooth_CloseChannel(Bluetooth_Channel_t* Channel);\r
- uint8_t Bluetooth_SendPacket(void* Data, uint16_t DataLen, Bluetooth_Channel_t* Channel);\r
+ bool Bluetooth_ChannelConnectionRequest(const uint16_t PSM);\r
+ void Bluetooth_PacketReceived(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel);\r
+ Bluetooth_Channel_t* Bluetooth_GetChannelData(const uint16_t SearchValue, const uint8_t SearchKey);\r
+ Bluetooth_Channel_t* Bluetooth_OpenChannel(const uint16_t PSM);\r
+ void Bluetooth_CloseChannel(Bluetooth_Channel_t* const Channel);\r
+ uint8_t Bluetooth_SendPacket(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel);\r
\r
/* External Variables: */\r
- extern Bluetooth_Device_t Bluetooth_DeviceConfiguration;\r
- extern Bluetooth_Connection_t Bluetooth_Connection;\r
+ extern Bluetooth_Device_t Bluetooth_DeviceConfiguration;\r
+ extern Bluetooth_Connection_t Bluetooth_Connection;\r
+ extern Bluetooth_Stack_State_t Bluetooth_State;\r
\r
#endif\r