X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/fd96b288824caaa3ee4e5e03887f016de9df80cf..d92e9133d392fe9abfde27b60b27b24f3b142fc3:/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h index 20bc95696..a97ac089a 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h @@ -34,63 +34,105 @@ /* Includes: */ #include - #include "BluetoothHost.h" - #include "BluetoothHCICommands.h" - #include "BluetoothACLPackets.h" - /* Macros: */ - #define BLUETOOTH_DATA_IN_PIPE 1 - #define BLUETOOTH_DATA_OUT_PIPE 2 - #define BLUETOOTH_EVENTS_PIPE 3 + #define BLUETOOTH_DATA_IN_PIPE 1 + #define BLUETOOTH_DATA_OUT_PIPE 2 + #define BLUETOOTH_EVENTS_PIPE 3 - #define BLUETOOTH_MAX_OPEN_CHANNELS 2 - #define BLUETOOTH_CHANNELNUMBER_BASEOFFSET 0x0040 + #define BLUETOOTH_MAX_OPEN_CHANNELS 6 + + #define CHANNEL_PSM_SDP 0x0001 + #define CHANNEL_PSM_UDP 0x0002 + #define CHANNEL_PSM_RFCOMM 0x0003 + #define CHANNEL_PSM_TCP 0x0004 + #define CHANNEL_PSM_IP 0x0009 + #define CHANNEL_PSM_FTP 0x000A + #define CHANNEL_PSM_HTTP 0x000C + #define CHANNEL_PSM_UPNP 0x0010 + #define CHANNEL_PSM_HIDP 0x0011 - #define CHANNEL_LOOKUP_BY_SOURCE true - #define CHANNEL_LOOKUP_BY_DESTINATION false + #define MAXIMUM_CHANNEL_MTU 255 /* Enums: */ - enum Bluetooth_Channel_State_t + /** Enum for the possible states for a bluetooth ACL channel. */ + enum BT_ChannelStates_t + { + Channel_Closed = 0, /**< Channel is closed and inactive. No data may be sent or received. */ + Channel_WaitConnect = 1, /**< A connection request has been received, but a response has not been sent. */ + Channel_WaitConnectRsp = 2, /**< A connection request has been sent, but a response has not been received. */ + Channel_Config_WaitConfig = 3, /**< Channel has been connected, but not yet configured on either end. */ + Channel_Config_WaitSendConfig = 4, /**< Channel configuration has been received and accepted, but not yet sent. */ + Channel_Config_WaitReqResp = 5, /**< Channel configuration has been sent but not responded to, and a configuration + request from the remote end has not yet been received. */ + Channel_Config_WaitResp = 6, /**< Channel configuration has been sent but not accepted, but a configuration request + from the remote end has been accepted. */ + Channel_Config_WaitReq = 7, /**< Channel configuration has been sent and accepted, but a configuration request + from the remote end has not yet been accepted. */ + Channel_Open = 8, /**< Channel is open and ready to send or receive data */ + Channel_WaitDisconnect = 9, /**< A disconnection request has been sent, but not yet acknowledged. */ + }; + + /** Enum for the possible error codes returned by the \ref Bluetooth_SendPacket() function. */ + enum BT_SendPacket_ErrorCodes_t { - Channel_Closed = 0, - Channel_WaitConnect = 1, - Channel_WaitConnectRsp = 2, - Channel_Config = 3, - Channel_Open = 4, - Channel_WaitDisconnect = 5, + BT_SENDPACKET_NoError = 0, /**< The packet was sent sucessfully. */ + BT_SENDPACKET_NotConnected = 1, /**< The bluetooth stack is not currently connected to a remote device. */ + BT_SENDPACKET_ChannelNotOpen = 2, /**< The given channel is not currently in the Open state. */ }; /* Type Defines: */ + /** Type define for a Bluetooth ACL channel information structure. This structure contains all the relevent + * information on an ACL channel for data transmission and reception by the stack. + */ typedef struct { uint8_t State; uint16_t LocalNumber; uint16_t RemoteNumber; uint16_t PSM; - uint16_t MTU; + uint16_t LocalMTU; + uint16_t RemoteMTU; } Bluetooth_Channel_t; + /** Type define for a Bluetooth device connection information structure. This structure contains all the + * information needed to maintain a connection to a remote Bluetooth device via the Bluetooth stack. + */ typedef struct { - bool IsConnected; - uint16_t ConnectionHandle; - uint8_t RemoteAddress[6]; - Bluetooth_Channel_t Channels[BLUETOOTH_MAX_OPEN_CHANNELS]; + bool IsConnected; /**< Indicates if the stack is currently connected to a remote device - if this value is + * false, the remaining elements are invalid. + */ + uint16_t ConnectionHandle; /**< Connection handle to the remote device, used internally in the stack. */ + uint8_t RemoteAddress[6]; /**< Bluetooth device address of the attached remote device. */ + Bluetooth_Channel_t Channels[BLUETOOTH_MAX_OPEN_CHANNELS]; /**< Channel information structures for the connection. */ + uint8_t SignallingIdentifier; /**< Next Signalling Channel unique command sequence identifier. */ } Bluetooth_Connection_t; + /** Local Bluetooth device information structure, for the defining of local device characteristics for the Bluetooth stack. */ typedef struct { - uint32_t Class; - char PINCode[16]; - char Name[]; + uint32_t Class; /**< Class of the local device, a mask of DEVICE_CLASS_* masks. */ + char PINCode[16]; /**< Pin code required to send or receive in order to authenticate with a remote device. */ + char Name[]; /**< Name of the local bluetooth device, up to 248 characters. */ } Bluetooth_Device_t; + + /* Includes: */ + #include "BluetoothHCICommands.h" + #include "BluetoothACLPackets.h" - /* Function Prototypes: */ - Bluetooth_Channel_t* Bluetooth_GetChannelData(uint16_t ChannelNumber, bool SearchBySource); - Bluetooth_Channel_t* Bluetooth_InitChannelData(uint16_t RemoteChannelNumber, uint16_t PSM); - - void Bluetooth_State_Init(void); - void Bluetooth_Stack_Task(void); + /* Function Prototypes: */ + void Bluetooth_Stack_Init(void); + void Bluetooth_Stack_USBTask(void); + + bool Bluetooth_ConnectionRequest(const uint8_t* RemoteAddress); + void Bluetooth_ConnectionComplete(void); + void Bluetooth_DisconnectionComplete(void); + bool Bluetooth_ChannelConnectionRequest(const uint16_t PSM); + void Bluetooth_PacketReceived(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel); + Bluetooth_Channel_t* Bluetooth_GetChannelData(const uint16_t ChannelNumber, const bool SearchByRemoteChannel); + Bluetooth_Channel_t* Bluetooth_OpenChannel(const uint16_t PSM); + void Bluetooth_CloseChannel(Bluetooth_Channel_t* const Channel); + uint8_t Bluetooth_SendPacket(void* Data, uint16_t DataLen, Bluetooth_Channel_t* const Channel); /* External Variables: */ extern Bluetooth_Device_t Bluetooth_DeviceConfiguration;