Rename software USART driver globals to make the code more in line with the rest...
[pub/USBasp.git] / Demos / Host / Incomplete / BluetoothHost / Lib / ServiceDiscoveryProtocol.h
index fc0abae..9103dce 100644 (file)
-/*\r
-             LUFA Library\r
-     Copyright (C) Dean Camera, 2010.\r
-              \r
-  dean [at] fourwalledcubicle [dot] com\r
-      www.fourwalledcubicle.com\r
-*/\r
-\r
-/*\r
-  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
-  Permission to use, copy, modify, distribute, and sell this \r
-  software and its documentation for any purpose is hereby granted\r
-  without fee, provided that the above copyright notice appear in \r
-  all copies and that both that the copyright notice and this\r
-  permission notice and warranty disclaimer appear in supporting \r
-  documentation, and that the name of the author not be used in \r
-  advertising or publicity pertaining to distribution of the \r
-  software without specific, written prior permission.\r
-\r
-  The author disclaim all warranties with regard to this\r
-  software, including all implied warranties of merchantability\r
-  and fitness.  In no event shall the author be liable for any\r
-  special, indirect or consequential damages or any damages\r
-  whatsoever resulting from loss of use, data or profits, whether\r
-  in an action of contract, negligence or other tortious action,\r
-  arising out of or in connection with the use or performance of\r
-  this software.\r
-*/\r
-\r
-#ifndef _SERVICEDISCOVERYPROTOCOL_H_\r
-#define _SERVICEDISCOVERYPROTOCOL_H_\r
-\r
-       /* Includes: */\r
-               #include <avr/io.h>\r
-               #include <string.h>\r
-               #include <stdbool.h>\r
-               #include <stdio.h>\r
-\r
-               #include <LUFA/Common/Common.h>\r
-               #include <LUFA/Drivers/Peripheral/SerialStream.h>\r
-\r
-               #include "BluetoothStack.h"\r
-               \r
-       /* Macros: */\r
-               #define BT_SDP_DEBUG(l, s, ...)                 do { if (SDP_DEBUG_LEVEL >= l) printf_P(PSTR("(SDP) " s "\r\n"), ##__VA_ARGS__); } while (0)\r
-               #define SDP_DEBUG_LEVEL                         2\r
-               \r
-               #define SDP_PDU_ERRORRESPONSE                   0x01\r
-               #define SDP_PDU_SERVICESEARCHREQUEST            0x02\r
-               #define SDP_PDU_SERVICESEARCHRESPONSE           0x03\r
-               #define SDP_PDU_SERVICEATTRIBUTEREQUEST         0x04\r
-               #define SDP_PDU_SERVICEATTRIBUTERESPONSE        0x05\r
-               #define SDP_PDU_SERVICESEARCHATTRIBUTEREQUEST   0x06\r
-               #define SDP_PDU_SERVICESEARCHATTRIBUTERESPONSE  0x07\r
-               \r
-               #define SDP_ATTRIBUTE_NAME                      0x0000\r
-               #define SDP_ATTRIBUTE_DESCRIPTION               0x0001\r
-               #define SDP_ATTRIBUTE_PROVIDER                  0x0002\r
-               #define SDP_ATTRIBUTE_AVAILABILITY              0x0008\r
-               \r
-               #define SDP_DATATYPE_NIL                        (0x00 << 3)\r
-               #define SDP_DATATYPE_UNSIGNED_INT               (0x01 << 3)\r
-               #define SDP_DATATYPE_SIGNED_INT                 (0x02 << 3)\r
-               #define SDP_DATATYPE_UUID                       (0x03 << 3)\r
-               #define SDP_DATATYPE_TEXT                       (0x04 << 3)\r
-               #define SDP_DATATYPE_BOOLEAN                    (0x05 << 3)\r
-               #define SDP_DATATYPE_ELEMENT_SEQUENCE           (0x06 << 3)\r
-               #define SDP_DATATYPE_ELEMENT_ALTERNATIVE        (0x07 << 3)\r
-               #define SDP_DATATYPE_URL                        (0x08 << 3)\r
-               \r
-               #define BASE_96BIT_UUID                         0xFB, 0x34, 0x9B, 0x5F, 0x80, 0x00, 0x00, 0x80, 0x00, 0x10, 0x00, 0x00\r
-               \r
-               #define SERVICE_ATTRIBUTE_TEXT(name, string)    SERVICE_ATTRIBUTE_8BIT_LEN(name, SDP_DATATYPE_TEXT, sizeof(string), string)\r
-               #define SERVICE_ATTRIBUTE_8BIT_LEN(name, type, size, ...)  const ServiceAttributeData8Bit_t  name PROGMEM = \\r
-                                                               {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__}\r
-               #define SERVICE_ATTRIBUTE_16BIT_LEN(name, type, size, ...) const ServiceAttributeData16Bit_t name PROGMEM = \\r
-                                                               {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__}\r
-               #define SERVICE_ATTRIBUTE_32BIT_LEN(name, type, size, ...) const ServiceAttributeData32Bit_t name PROGMEM = \\r
-                                                               {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__}\r
-               #define SERVICE_ATTRIBUTE_TABLE_TERMINATOR      {.AttributeData = NULL}\r
-\r
-       /* Type Defines: */\r
-               typedef struct\r
-               {\r
-                       uint8_t  PDU;\r
-                       uint16_t TransactionID;\r
-                       uint16_t ParameterLength;\r
-               } SDP_PDUHeader_t;\r
-               \r
-               typedef struct\r
-               {\r
-                       uint16_t    AttributeID;\r
-                       const void* AttributeData;\r
-               } ServiceAttributeTable_t;\r
-\r
-               typedef struct\r
-               {\r
-                       uint8_t UUID[16];\r
-                       const void* AttributeTable;\r
-               } ServiceTable_t;\r
-\r
-               typedef struct\r
-               {\r
-                       uint8_t  Header;\r
-                       uint32_t Size;\r
-                       uint8_t  Data[];\r
-               } ServiceAttributeData32Bit_t;\r
-\r
-               typedef struct\r
-               {\r
-                       uint8_t  Header;\r
-                       uint16_t Size;\r
-                       uint8_t  Data[];\r
-               } ServiceAttributeData16Bit_t;\r
-\r
-               typedef struct\r
-               {\r
-                       uint8_t Header;\r
-                       uint8_t Size;\r
-                       uint8_t Data[];\r
-               } ServiceAttributeData8Bit_t;\r
-\r
-               typedef struct\r
-               {\r
-                       uint8_t Header;\r
-                       uint8_t Data[];\r
-               } ServiceAttributeData_t;\r
-               \r
-       /* Function Prototypes: */\r
-               void ServiceDiscovery_ProcessPacket(void* Data, Bluetooth_Channel_t* Channel);\r
-\r
-               #if defined(INCLUDE_FROM_SERVICEDISCOVERYPROTOCOL_C)\r
-                       static void ServiceDiscovery_ProcessServiceSearch(SDP_PDUHeader_t* SDPHeader);\r
-                       static void ServiceDiscovery_ProcessServiceAttribute(SDP_PDUHeader_t* SDPHeader);\r
-                       static void ServiceDiscovery_ProcessServiceSearchAttribute(SDP_PDUHeader_t* SDPHeader);\r
-                       \r
-                       static inline uint16_t ServiceDiscovery_Read16BitParameter(void** AttributeHeader)\r
-                       {\r
-                               uint16_t ParamValue = *((uint16_t*)*AttributeHeader);\r
-                               *AttributeHeader += sizeof(uint16_t);\r
-                               return ParamValue;\r
-                       }\r
-\r
-                       static uint32_t ServiceDiscovery_GetDataElementSize(void** AttributeHeader, uint8_t* ElementHeaderSize);\r
-               #endif\r
-\r
-#endif\r
+/*
+             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_ID_SERVICERECORDHANDLE    0x0000
+               #define SDP_ATTRIBUTE_ID_SERVICECLASSIDS        0x0001
+               #define SDP_ATTRIBUTE_ID_LANGIDOFFSET           0x0006
+               #define SDP_ATTRIBUTE_ID_AVAILABILITY           0x0008
+               #define SDP_ATTRIBUTE_ID_VERSION                0x0200
+               
+               /** Size of a full 128 bit UUID, in bytes. */
+               #define UUID_SIZE_BYTES                         16
+               
+               /** First 96 bits common to all standadized Bluetooth services. */
+               #define BASE_96BIT_UUID                         0xFB, 0x34, 0x9B, 0x5F, 0x80, 0x00, 0x00, 0x80, 0x00, 0x10, 0x00, 0x00
+               
+               /** Terminator for a service attribute table of type \ref ServiceAttributeTable_t. */
+               #define SERVICE_ATTRIBUTE_TABLE_TERMINATOR      {.Data = NULL}
+               
+       /* Enums: */
+               /** Data sizes for SDP Data Element headers, to indicate the size of the data contained in the element. When creating
+                *  a Data Element, a value from this enum should be ORed with a value from the \ref ServiceDiscovery_DataTypes_t enum.
+                */
+               enum ServiceDiscovery_DataSizes_t
+               {
+                       SDP_DATASIZE_8Bit          = 0, /**< Contained data is 8 bits in length. */
+                       SDP_DATASIZE_16Bit         = 1, /**< Contained data is 16 bits in length. */
+                       SDP_DATASIZE_32Bit         = 2, /**< Contained data is 32 bits in length. */
+                       SDP_DATASIZE_64Bit         = 3, /**< Contained data is 64 bits in length. */
+                       SDP_DATASIZE_128Bit        = 4, /**< Contained data is 128 bits in length. */
+                       SDP_DATASIZE_Variable8Bit  = 5, /**< Contained data is encoded in an 8 bit size integer following the header. */
+                       SDP_DATASIZE_Variable16Bit = 6, /**< Contained data is encoded in an 16 bit size integer following the header. */
+                       SDP_DATASIZE_Variable32Bit = 7, /**< Contained data is encoded in an 32 bit size integer following the header. */
+               };
+
+               /** Data types for SDP Data Element headers, to indicate the type of data contained in the element. When creating
+                *  a Data Element, a value from this enum should be ORed with a value from the \ref ServiceDiscovery_DataSizes_t enum.
+                */
+               enum ServiceDiscovery_DataTypes_t
+               {
+                       SDP_DATATYPE_Nill        = (0 << 3), /**< Indicates the container data is a Nill (null) type. */
+                       SDP_DATATYPE_UnsignedInt = (1 << 3), /**< Indicates the container data is an unsigned integer. */
+                       SDP_DATATYPE_SignedInt   = (2 << 3), /**< Indicates the container data is a signed integer. */
+                       SDP_DATATYPE_UUID        = (3 << 3), /**< Indicates the container data is a UUID. */
+                       SDP_DATATYPE_String      = (4 << 3), /**< Indicates the container data is an ASCII string. */
+                       SDP_DATATYPE_Boolean     = (5 << 3), /**< Indicates the container data is a logical boolean. */
+                       SDP_DATATYPE_Sequence    = (6 << 3), /**< Indicates the container data is a sequence of containers. */
+                       SDP_DATATYPE_Alternative = (7 << 3), /**< Indicates the container data is a sequence of alternative containers. */
+                       SDP_DATATYPE_URL         = (8 << 3), /**< Indicates the container data is a URL. */
+               };
+
+       /* Type Defines: */
+               /** Header for all SPD transaction packets. This header is sent at the start of all SDP packets sent to or from a SDP
+                *  server.
+                */
+               typedef struct
+               {
+                       uint8_t  PDU; /**< SDP packet type, a SDP_PDU_* mask value */
+                       uint16_t TransactionID; /**< Unique transaction ID number to associate requests and responses */
+                       uint16_t ParameterLength; /**< Length of the data following the SDP header */
+               } SDP_PDUHeader_t;
+               
+               /** Structure for the association of attribute ID values to an attribute value in FLASH. A table of these
+                *  structures can then be built up for each supported UUID service within the device.
+                */
+               typedef struct
+               {
+                       uint16_t    AttributeID; /**< Attribute ID of the table element which the UUID service supports */
+                       const void* Data; /**< Pointer to the attribute data, located in PROGMEM memory space */
+               } ServiceAttributeTable_t;
+
+               /** Structure for the association of service UUID values to attribute tables stored in FLASH. A table of these
+                *  structures can then be built up for each supported UUID service within the device.
+                */
+               typedef struct
+               {
+                       uint8_t     UUID[UUID_SIZE_BYTES]; /**< UUID of a service supported by the device */
+                       const void* AttributeTable; /**< Pointer to the UUID's attribute table, located in PROGMEM memory space */
+               } ServiceTable_t;
+
+               /** Structure for a list of Data Elements containing UUIDs, for service attributes requiring UUID lists. */
+               typedef struct
+               {
+                       uint8_t Header; /**< Data Element header, should be (SDP_DATATYPE_UUID | SDP_DATASIZE_128Bit) */
+                       uint8_t UUID[UUID_SIZE_BYTES]; /**< UUID to store in the list Data Element */
+               } ClassUUID_t;
+
+               /** Structure for a list of Data Elements containing Version Numbers, for service attributes requiring Version lists. */
+               typedef struct
+               {
+                       uint8_t  Header; /**< Data Element header, should be (SDP_DATATYPE_UnsignedInt | SDP_DATASIZE_16Bit) */
+                       uint16_t Version; /**< Version number to store in the list Data Element */
+               } Version_t;
+               
+       /* Inline Functions: */
+               /** Adds a new Data Element container of the given type with a 16-bit size header to the buffer. The
+                *  buffer pointer's position is advanced past the added header once the element has been added. The
+                *  returned size header value is pre-zeroed out so that it can be incremented as data is placed into
+                *  the Data Element container.
+                *
+                *  The total added size of the container header is three bytes, regardless of the size of its contents
+                *  as long as the contents' size in bytes fits into a 16-bit integer.
+                *
+                *  \param[in, out] BufferPos  Pointer to a buffer where the container header is to be placed
+                *  \param[in]      Type       Type of data the container is to store, a value from the \ref ServiceDiscovery_DataTypes_t enum
+                *
+                *  \return Pointer to the 16-bit size value of the contaner header, which has been pre-zeroed
+                */
+               static inline uint16_t* SDP_AddDataElementHeader16(void** BufferPos, const uint8_t Type)
+               {
+                       *((uint8_t*)*BufferPos) = (SDP_DATASIZE_Variable16Bit | Type);  
+
+                       uint16_t* SizePos = (uint16_t*)*(BufferPos + 1);
+                       *SizePos = 0;
+
+                       *BufferPos += 3;                        
+                       return SizePos;
+               }
+               
+       /* Function Prototypes: */
+               void SDP_ProcessPacket(void* Data, Bluetooth_Channel_t* Channel);
+
+               #if defined(INCLUDE_FROM_SERVICEDISCOVERYPROTOCOL_C)
+                       static void SDP_ProcessServiceSearch(const SDP_PDUHeader_t* const SDPHeader, Bluetooth_Channel_t* const Channel);
+                       static void SDP_ProcessServiceAttribute(const SDP_PDUHeader_t* const SDPHeader, Bluetooth_Channel_t* const Channel);
+                       static void SDP_ProcessServiceSearchAttribute(const SDP_PDUHeader_t* const SDPHeader, Bluetooth_Channel_t* const Channel);
+
+                       static uint16_t SDP_AddAttributeToResponse(const uint16_t AttributeID, const void* AttributeValue, void** ResponseBuffer);
+                       static void*    SDP_GetAttributeValue(const ServiceAttributeTable_t* AttributeTable, const uint16_t AttributeID);
+                       static ServiceAttributeTable_t* SDP_GetAttributeTable(const uint8_t* const UUID);
+                       static uint8_t  SDP_GetAttributeList(uint16_t AttributeList[][2], const void** const CurrentParameter);
+                       static uint8_t  SDP_GetUUIDList(uint8_t UUIDList[][UUID_SIZE_BYTES], const void** const CurrentParameter);
+                       static uint32_t SDP_GetLocalAttributeContainerSize(const void* const AttributeData, uint8_t* const HeaderSize);
+                       static uint32_t SDP_GetDataElementSize(const void** const AttributeHeader, uint8_t* const ElementHeaderSize);
+               #endif
+
+#endif