BluetoothStack.h 6.27 KB
Newer Older
1
2
/*
             LUFA Library
Dean Camera's avatar
Dean Camera committed
3
     Copyright (C) Dean Camera, 2010.
4
5
6
7
8
9
              
  dean [at] fourwalledcubicle [dot] com
      www.fourwalledcubicle.com
*/

/*
Dean Camera's avatar
Dean Camera committed
10
  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)
11

12
13
14
15
16
17
18
  Permission to use, copy, modify, distribute, and sell this 
  software and its documentation for any purpose is hereby granted
  without fee, provided that the above copyright notice appear in 
  all copies and that both that the copyright notice and this
  permission notice and warranty disclaimer appear in supporting 
  documentation, and that the name of the author not be used in 
  advertising or publicity pertaining to distribution of the 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
  software without specific, written prior permission.

  The author disclaim all warranties with regard to this
  software, including all implied warranties of merchantability
  and fitness.  In no event shall the author be liable for any
  special, indirect or consequential damages or any damages
  whatsoever resulting from loss of use, data or profits, whether
  in an action of contract, negligence or other tortious action,
  arising out of or in connection with the use or performance of
  this software.
*/

#ifndef _BLUETOOTH_STACK_
#define _BLUETOOTH_STACK_

	/* Includes: */
35
		#include <LUFA/Drivers/USB/USB.h>
36
37
38
39
		
		#include "BluetoothHost.h"
		
	/* Macros: */
40
41
42
		#define BLUETOOTH_DATA_IN_PIPE                   1
		#define BLUETOOTH_DATA_OUT_PIPE                  2
		#define BLUETOOTH_EVENTS_PIPE                    3
43

44
		#define BLUETOOTH_MAX_OPEN_CHANNELS              6
45
		
46
		#define CHANNEL_PSM_SERVICEDISCOVERY             0x0001
47
		#define CHANNEL_PSM_UDP                          0x0002
48
		#define CHANNEL_PSM_RFCOMM                       0x0003
49
50
51
52
53
54
		#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
55
		
56
57
		#define MAXIMUM_CHANNEL_MTU                      255
		
58
	/* Enums: */
59
		/** Enum for the possible states for a bluetooth ACL channel. */
60
		enum BT_ChannelStates_t
61
		{
62
63
64
65
66
67
68
69
70
71
72
73
74
			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. */
75
76
		};

77
78
		/** Enum for the possible error codes returned by the \ref Bluetooth_SendPacket() function. */
		enum BT_SendPacket_ErrorCodes_t
79
		{
80
81
82
			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. */
83
84
85
		};

	/* Type Defines: */
86
87
88
		/** 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.
		 */
89
90
91
92
93
94
		typedef struct
		{
			uint8_t  State;
			uint16_t LocalNumber;
			uint16_t RemoteNumber;
			uint16_t PSM;
95
			uint16_t LocalMTU;
96
			uint16_t RemoteMTU;
97
98
		} Bluetooth_Channel_t;

99
100
101
		/** 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.
		 */
102
103
104
105
		typedef struct
		{
			bool                IsConnected;
			uint16_t            ConnectionHandle;
106
			uint8_t             RemoteAddress[6];
107
			Bluetooth_Channel_t Channels[BLUETOOTH_MAX_OPEN_CHANNELS];
108
			uint8_t             SignallingIdentifier;
109
110
		} Bluetooth_Connection_t;
		
111
		/** Local Bluetooth device information structure, for the defining of local device characteristics for the Bluetooth stack. */
112
113
114
115
116
117
		typedef struct
		{
			uint32_t Class;
			char     PINCode[16];
			char     Name[];
		} Bluetooth_Device_t;
118
119
120
121
	
	/* Includes: */
		#include "BluetoothHCICommands.h"
		#include "BluetoothACLPackets.h"		
122
		
123
	/* Function Prototypes: */		
124
125
		void Bluetooth_Stack_Init(void);
		void Bluetooth_Stack_USBTask(void);
126

127
128
129
130
131
132
133
134
		bool                 Bluetooth_ConnectionRequest(uint8_t* RemoteAddress);
		void                 Bluetooth_ConnectionComplete(void);
		void                 Bluetooth_DisconnectionComplete(void);
		void                 Bluetooth_PacketReceived(uint16_t* PacketLength, Bluetooth_Channel_t* Channel);
		Bluetooth_Channel_t* Bluetooth_GetChannelData(uint16_t ChannelNumber, bool SearchByRemoteChannel);
		Bluetooth_Channel_t* Bluetooth_OpenChannel(uint16_t PSM);
		void                 Bluetooth_CloseChannel(Bluetooth_Channel_t* Channel);
		uint8_t              Bluetooth_SendPacket(void* Data, uint16_t DataLen, Bluetooth_Channel_t* Channel);
135

136
137
138
139
140
	/* External Variables: */
		extern Bluetooth_Device_t     Bluetooth_DeviceConfiguration;
		extern Bluetooth_Connection_t Bluetooth_Connection;

#endif