ServiceDiscoveryProtocol.h 7.59 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
/*
             LUFA Library
     Copyright (C) Dean Camera, 2010.
              
  dean [at] fourwalledcubicle [dot] com
      www.fourwalledcubicle.com
*/

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

  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 
  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 _SERVICEDISCOVERYPROTOCOL_H_
#define _SERVICEDISCOVERYPROTOCOL_H_

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

		#include <LUFA/Common/Common.h>
		#include <LUFA/Drivers/Peripheral/SerialStream.h>

		#include "BluetoothStack.h"
		
	/* Macros: */
		#define BT_SDP_DEBUG(l, s, ...)                 do { if (SDP_DEBUG_LEVEL >= l) printf_P(PSTR("(SDP) " s "\r\n"), ##__VA_ARGS__); } while (0)
		#define SDP_DEBUG_LEVEL                         2
		
		#define SDP_PDU_ERRORRESPONSE                   0x01
		#define SDP_PDU_SERVICESEARCHREQUEST            0x02
		#define SDP_PDU_SERVICESEARCHRESPONSE           0x03
		#define SDP_PDU_SERVICEATTRIBUTEREQUEST         0x04
		#define SDP_PDU_SERVICEATTRIBUTERESPONSE        0x05
		#define SDP_PDU_SERVICESEARCHATTRIBUTEREQUEST   0x06
		#define SDP_PDU_SERVICESEARCHATTRIBUTERESPONSE  0x07
		
		#define SDP_ATTRIBUTE_NAME                      0x0000
		#define SDP_ATTRIBUTE_DESCRIPTION               0x0001
		#define SDP_ATTRIBUTE_PROVIDER                  0x0002
		#define SDP_ATTRIBUTE_AVAILABILITY              0x0008
		
62
		/** Size of a full 128 bit UUID, in bytes */
63
		#define UUID_SIZE_BYTES                         16
64
65
		
		/** First 96 bits common to all standadized Bluetooth services */
66
67
		#define BASE_96BIT_UUID                         0xFB, 0x34, 0x9B, 0x5F, 0x80, 0x00, 0x00, 0x80, 0x00, 0x10, 0x00, 0x00
		
68
69
70
71
72
73
74
75
76
77
78
79
80
81
		/** Defines a service attribute as a string of characters.
		 *
		 *  \param name    Name of the attribute (used to identify the attribute variable only)
		 *  \param string  String of characters to associate with the attribute
		 */
		#define SERVICE_ATTRIBUTE_TEXT(name, string)    SERVICE_ATTRIBUTE_LEN8(name, SDP_DATATYPE_String, sizeof(string), string)

		/** Defines a service attribute with a contents that can fit into an 8-bit integer.
		 *
		 *  \param name    Name of the attribute (used to identify the attribute variable only)
		 *  \param type    Type of attribute contents, a value from the \ref ServiceDiscovery_DataTypes_t enum
		 *  \param size    Size of the data, in bytes
		 *  \param ...     Data to associate with the attribute
		 */
82
		#define SERVICE_ATTRIBUTE_LEN8(name, type, size, ...)  const ServiceAttributeData8Bit_t  name PROGMEM = \
83
		                                                {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__}
84
85
86
87
88
89
90
91

		/** Defines a service attribute with a contents that can fit into an 16-bit integer.
		 *
		 *  \param name    Name of the attribute (used to identify the attribute variable only)
		 *  \param type    Type of attribute contents, a value from the \ref ServiceDiscovery_DataTypes_t enum
		 *  \param size    Size of the data, in bytes
		 *  \param ...     Data to associate with the attribute
		 */
92
		#define SERVICE_ATTRIBUTE_LEN16(name, type, size, ...) const ServiceAttributeData16Bit_t name PROGMEM = \
93
		                                                {.Header = (type | 6), .Size = size, .Data = __VA_ARGS__}
94
95
96
97
98
99
100
101

		/** Defines a service attribute with a contents that can fit into an 32-bit integer.
		 *
		 *  \param name    Name of the attribute (used to identify the attribute variable only)
		 *  \param type    Type of attribute contents, a value from the \ref ServiceDiscovery_DataTypes_t enum
		 *  \param size    Size of the data, in bytes
		 *  \param ...     Data to associate with the attribute
		 */
102
		#define SERVICE_ATTRIBUTE_LEN32(name, type, size, ...) const ServiceAttributeData32Bit_t name PROGMEM = \
103
		                                                       {.Header = (type | 7), .Size = size, .Data = __VA_ARGS__}
104
105

		/** Terminator for a service attribute table of type \ref ServiceAttributeTable_t. */
106
		#define SERVICE_ATTRIBUTE_TABLE_TERMINATOR      {.Data = NULL}
107

108
109
110
111
112
113
114
115
116
117
118
119
120
121
	/* Enums: */
		enum ServiceDiscovery_DataTypes_t
		{
			SDP_DATATYPE_Nill        = (0 << 3),
			SDP_DATATYPE_UnsignedInt = (1 << 3),
			SDP_DATATYPE_SignedInt   = (2 << 3),
			SDP_DATATYPE_UUID        = (3 << 3),
			SDP_DATATYPE_String      = (4 << 3),
			SDP_DATATYPE_Boolean     = (5 << 3),
			SDP_DATATYPE_Sequence    = (6 << 3),
			SDP_DATATYPE_Alternative = (7 << 3),
			SDP_DATATYPE_URL         = (8 << 3),
		};

122
123
124
125
126
127
128
129
130
131
	/* Type Defines: */
		typedef struct
		{
			uint8_t  PDU;
			uint16_t TransactionID;
			uint16_t ParameterLength;
		} SDP_PDUHeader_t;
		
		typedef struct
		{
132
			uint16_t    AttributeID;
133
			const void* Data;
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
		} ServiceAttributeTable_t;

		typedef struct
		{
			uint8_t UUID[16];
			const void* AttributeTable;
		} ServiceTable_t;

		typedef struct
		{
			uint8_t  Header;
			uint32_t Size;
			uint8_t  Data[];
		} ServiceAttributeData32Bit_t;

		typedef struct
		{
			uint8_t  Header;
			uint16_t Size;
			uint8_t  Data[];
		} ServiceAttributeData16Bit_t;

		typedef struct
		{
			uint8_t Header;
			uint8_t Size;
			uint8_t Data[];
		} ServiceAttributeData8Bit_t;

		typedef struct
		{
			uint8_t Header;
			uint8_t Data[];
		} ServiceAttributeData_t;
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188

	/* Inline Functions: */
		static inline uint16_t* ServiceDiscovery_AddDataElementHeader(uint8_t** BufferPos, const uint8_t Type)
		{
			**BufferPos = (6 | Type);	
			*BufferPos += 1;

			uint16_t* SizePos = (uint16_t*)*BufferPos;				
			*SizePos = 0;

			**BufferPos += 2;
			
			return SizePos;
		}

		static inline uint16_t ServiceDiscovery_Read16BitParameter(const void** AttributeHeader)
		{
			uint16_t ParamValue = *((uint16_t*)*AttributeHeader);
			*AttributeHeader += sizeof(uint16_t);
			return ParamValue;
		}
189
190
191
192
193
		
	/* Function Prototypes: */
		void ServiceDiscovery_ProcessPacket(void* Data, Bluetooth_Channel_t* Channel);

		#if defined(INCLUDE_FROM_SERVICEDISCOVERYPROTOCOL_C)
194
195
196
			static void ServiceDiscovery_ProcessServiceSearch(SDP_PDUHeader_t* SDPHeader, Bluetooth_Channel_t* Channel);
			static void ServiceDiscovery_ProcessServiceAttribute(SDP_PDUHeader_t* SDPHeader, Bluetooth_Channel_t* Channel);
			static void ServiceDiscovery_ProcessServiceSearchAttribute(SDP_PDUHeader_t* SDPHeader, Bluetooth_Channel_t* Channel);
197

198
199
200
			static void* ServiceDiscovery_GetAttributeValue(ServiceAttributeTable_t* AttributeTable, uint16_t AttributeID);
			static ServiceAttributeTable_t* ServiceDiscovery_GetAttributeTable(uint8_t* UUID);
			static uint8_t ServiceDiscovery_GetAttributeList(uint16_t AttributeList[][2], const void** CurrentParameter);
201
			static uint8_t ServiceDiscovery_GetUUIDList(uint8_t UUIDList[][UUID_SIZE_BYTES], const void** CurrentParameter);
202
			static uint32_t ServiceDiscovery_GetDataElementSize(const void** AttributeHeader, uint8_t* ElementHeaderSize);
203
204
205
		#endif

#endif