BluetoothACLPackets.h 8.34 KB
Newer Older
1
2
3
/*
             LUFA Library
     Copyright (C) Dean Camera, 2010.
4

5
6
7
8
9
10
11
  dean [at] fourwalledcubicle [dot] com
      www.fourwalledcubicle.com
*/

/*
  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)

12
  Permission to use, copy, modify, distribute, and sell this
13
  software and its documentation for any purpose is hereby granted
14
  without fee, provided that the above copyright notice appear in
15
  all copies and that both that the copyright notice and this
16
17
18
  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
  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.
*/

31
32
33
34
35
/** \file
 *
 *  Header file for BluetoothACLPackets.c.
 */

36
37
38
39
40
41
42
43
44
45
46
#ifndef _BLUETOOTH_ACLPACKETS_
#define _BLUETOOTH_ACLPACKETS_

	/* Includes: */
		#include <avr/io.h>
		#include <string.h>
		#include <stdbool.h>
		#include <stdio.h>

		#include <LUFA/Drivers/USB/USB.h>
		#include <LUFA/Drivers/Peripheral/SerialStream.h>
47

48
		#include "BluetoothStack.h"
49

50
51
52
	/* Macros: */
		#define BT_ACL_DEBUG(l, s, ...)           do { if (ACL_DEBUG_LEVEL >= l) printf_P(PSTR("(ACL) " s "\r\n"), ##__VA_ARGS__); } while (0)
		#define ACL_DEBUG_LEVEL                   0
53

Dean Camera's avatar
Dean Camera committed
54
		/** Lowest possible channel number for L2CAP data channels. */
55
56
		#define BT_CHANNELNUMBER_BASEOFFSET       0x0040

57
		/** Bluetooth specification defined channel number for signaling commands. */
58
		#define BT_CHANNEL_SIGNALING              0x0001
59

Dean Camera's avatar
Dean Camera committed
60
		/** Bluetooth specification defined channel number for connectionless data. */
61
		#define BT_CHANNEL_CONNECTIONLESS         0x0002
62

63
64
		#define BT_ACL_FIRST_AUTOFLUSH            (1 << 13)

65
66
67
68
69
70
71
72
73
74
75
		#define BT_SIGNAL_COMMAND_REJECT          0x01
		#define BT_SIGNAL_CONNECTION_REQUEST      0x02
		#define BT_SIGNAL_CONNECTION_RESPONSE     0x03
		#define BT_SIGNAL_CONFIGURATION_REQUEST   0x04
		#define BT_SIGNAL_CONFIGURATION_RESPONSE  0x05
		#define BT_SIGNAL_DISCONNECTION_REQUEST   0x06
		#define BT_SIGNAL_DISCONNECTION_RESPONSE  0x07
		#define BT_SIGNAL_ECHO_REQUEST            0x08
		#define BT_SIGNAL_ECHO_RESPONSE           0x09
		#define BT_SIGNAL_INFORMATION_REQUEST     0x0A
		#define BT_SIGNAL_INFORMATION_RESPONSE    0x0B
76

77
78
		#define BT_INFOREQ_MTU                    0x0001
		#define BT_INFOREQ_EXTENDEDFEATURES       0x0002
79

80
81
		#define BT_INFORMATION_SUCCESSFUL         0x0000
		#define BT_INFORMATION_NOTSUPPORTED       0x0001
82

83
84
85
		#define BT_CONNECTION_SUCCESSFUL          0x0000
		#define BT_CONNECTION_REFUSED_PSM         0x0002
		#define BT_CONNECTION_REFUSED_RESOURCES   0x0004
86

87
88
89
		#define BT_CONFIGURATION_SUCCESSFUL       0x0000
		#define BT_CONFIGURATION_REJECTED         0x0002
		#define BT_CONFIGURATION_UNKNOWNOPTIONS   0x0003
90

91
		#define BT_CONFIG_OPTION_MTU              1
92

93
	/* Type Defines: */
94
		/** Bluetooth ACL header structure, common to all ACL data packets. */
95
96
		typedef struct
		{
97
98
			uint16_t ConnectionHandle; /**< Unique device connection handle of the ACL packet */
			uint16_t DataLength; /**< Length of the packet payload, in bytes */
99
100
		} BT_ACL_Header_t;

Dean Camera's avatar
Dean Camera committed
101
		/** Bluetooth ACL data packet header structure, for ACL packets containing L2CAP data. */
102
103
		typedef struct
		{
104
105
			uint16_t PayloadLength; /**< Size of the data payload, in bytes */
			uint16_t DestinationChannel; /**< Destination channel in the device the data is directed to */
106
		} BT_DataPacket_Header_t;
107

108
		/** Bluetooth signaling command header structure, for all ACL packets containing a signaling command. */
109
110
		typedef struct
		{
111
112
			uint8_t  Code; /**< Signal code, a BT_SIGNAL_* mask value */
			uint8_t  Identifier; /**< Unique signal command identifier to link requests and responses */
113
			uint16_t Length; /**< Length of the signaling command data, in bytes */
114
		} BT_Signal_Header_t;
115

116
		/** Connection Request signaling command structure, for channel connection requests. */
117
118
		typedef struct
		{
119
120
			uint16_t PSM; /**< Type of data the channel will carry, a CHANNEL_PSM_* mask value */
			uint16_t SourceChannel; /**< Channel source on the sending device this channel will link to */
121
122
		} BT_Signal_ConnectionReq_t;

123
		/** Connection response signaling command structure, for responses to channel connection requests. */
124
125
		typedef struct
		{
126
127
128
129
			uint16_t DestinationChannel; /**< Destination device channel that the connection request was processed on */
			uint16_t SourceChannel; /**< Source device channel address that the connection request came from */
			uint16_t Result; /**< Connection result, a BT_CONNECTION_* mask value */
			uint16_t Status; /**< Status of the request if the result was set to the Pending value */
130
131
		} BT_Signal_ConnectionResp_t;

132
		/** Disconnection request signaling command structure, for channel disconnection requests. */
133
134
		typedef struct
		{
135
136
			uint16_t DestinationChannel; /**< Destination channel address which is to be disconnected */
			uint16_t SourceChannel; /**< Source channel address which is to be disconnected */
137
		} BT_Signal_DisconnectionReq_t;
138

139
		/** Disconnection response signaling command structure, for responses to channel disconnection requests. */
140
141
		typedef struct
		{
142
143
			uint16_t DestinationChannel; /**< Destination channel address which was disconnected */
			uint16_t SourceChannel; /**< Source channel address which was disconnected */
144
		} BT_Signal_DisconnectionResp_t;
145

146
		/** Configuration Request signaling command structure, for channel configuration requests. */
147
148
		typedef struct
		{
149
150
			uint16_t DestinationChannel; /**< Destination channel address which is to be disconnected */
			uint16_t Flags; /**< Configuration flags for the request, including command continuation */
151
152
		} BT_Signal_ConfigurationReq_t;

153
		/** Configuration Response signaling command structure, for responses to channel configuration requests. */
154
155
		typedef struct
		{
156
157
158
			uint16_t SourceChannel; /**< Source channel that the configuration request was directed at */
			uint16_t Flags; /**< Configuration flags for the response, including response continuation */
			uint16_t Result; /**< Configuration result, a BT_CONFIGURATION_* mask value */
159
160
		} BT_Signal_ConfigurationResp_t;

161
		/** Information Request signaling command structure, for device information requests. */
162
163
		typedef struct
		{
164
			uint16_t InfoType; /**< Data type that is being requested, a BT_INFOREQ_* mask value */
165
		} BT_Signal_InformationReq_t;
166

167
		/** Information Response signaling command structure, for responses to information requests. */
168
169
		typedef struct
		{
170
171
			uint16_t InfoType; /**< Data type that was requested, a BT_INFOREQ_* mask value */
			uint16_t Result; /**< Result of the request, a BT_INFORMATION_* mask value */
172
		} BT_Signal_InformationResp_t;
173

174
175
176
		/** Configuration Option header structure, placed at the start of each option in a Channel Configuration
		 *  request's options list.
		 */
177
178
		typedef struct
		{
179
180
			uint8_t Type; /**< Option type, a BT_CONFIG_OPTION_* mask value */
			uint8_t Length; /**< Length of the option's value, in bytes */
181
182
183
		} BT_Config_Option_Header_t;

	/* Function Prototypes: */
184
		void Bluetooth_ACLTask(void);
185

186
		#if defined(INCLUDE_FROM_BLUETOOTH_ACLPACKETS_C)
187
			static void Bluetooth_ProcessIncomingACLPackets(void);
188
189
190
191
192
193
194
195
196
197

			static inline void Bluetooth_Signal_ConnectionReq(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_ConnectionResp(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_ConfigurationReq(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_ConfigurationResp(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_DisconnectionReq(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_DisconnectionResp(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_EchoReq(const BT_Signal_Header_t* const SignalCommandHeader);
			static inline void Bluetooth_Signal_InformationReq(const BT_Signal_Header_t* const SignalCommandHeader);
		#endif
198

199
#endif
200