X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/d03d6513d0d24cf63225c8d3dfa07675d9107f40..f64e3db07ac167bf0b64bf429a53721f1848e91d:/Demos/Host/Incomplete/BluetoothHost/Lib/ServiceDiscoveryProtocol.h diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/ServiceDiscoveryProtocol.h b/Demos/Host/Incomplete/BluetoothHost/Lib/ServiceDiscoveryProtocol.h index 26b3c109d..9103dce63 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/ServiceDiscoveryProtocol.h +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/ServiceDiscoveryProtocol.h @@ -1,147 +1,189 @@ -/* - 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 - #include - #include - #include - - #include - #include - - #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 - - #define SDP_DATATYPE_NIL (0x00 << 3) - #define SDP_DATATYPE_UNSIGNED_INT (0x01 << 3) - #define SDP_DATATYPE_SIGNED_INT (0x02 << 3) - #define SDP_DATATYPE_UUID (0x03 << 3) - #define SDP_DATATYPE_TEXT (0x04 << 3) - #define SDP_DATATYPE_BOOLEAN (0x05 << 3) - #define SDP_DATATYPE_ELEMENT_SEQUENCE (0x06 << 3) - #define SDP_DATATYPE_ELEMENT_ALTERNATIVE (0x07 << 3) - #define SDP_DATATYPE_URL (0x08 << 3) - - #define BASE_96BIT_UUID 0xFB, 0x34, 0x9B, 0x5F, 0x80, 0x00, 0x00, 0x80, 0x00, 0x10, 0x00, 0x00 - - #define SERVICE_ATTRIBUTE_TEXT(name, string) SERVICE_ATTRIBUTE_8BIT_LEN(name, SDP_DATATYPE_TEXT, sizeof(string), string) - #define SERVICE_ATTRIBUTE_8BIT_LEN(name, type, size, ...) const ServiceAttributeData8Bit_t name PROGMEM = \ - {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__} - #define SERVICE_ATTRIBUTE_16BIT_LEN(name, type, size, ...) const ServiceAttributeData16Bit_t name PROGMEM = \ - {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__} - #define SERVICE_ATTRIBUTE_32BIT_LEN(name, type, size, ...) const ServiceAttributeData32Bit_t name PROGMEM = \ - {.Header = (type | 5), .Size = size, .Data = __VA_ARGS__} - - /* Type Defines: */ - typedef struct - { - uint8_t PDU; - uint16_t TransactionID; - uint16_t ParameterLength; - } SDP_PDUHeader_t; - - typedef struct - { - uint16_t AttributeID; - const void* AttributeData; - } 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; - - /* Function Prototypes: */ - void ServiceDiscovery_ProcessPacket(void* Data, Bluetooth_Channel_t* Channel); - - #if defined(INCLUDE_FROM_SERVICEDISCOVERYPROTOCOL_C) - static void ServiceDiscovery_ProcessServiceSearch(SDP_PDUHeader_t* SDPHeader); - static void ServiceDiscovery_ProcessServiceAttribute(SDP_PDUHeader_t* SDPHeader); - static void ServiceDiscovery_ProcessServiceSearchAttribute(SDP_PDUHeader_t* SDPHeader); - - static inline uint16_t ServiceDiscovery_Read16BitParameter(void** AttributeHeader) - { - uint16_t ParamValue = *((uint16_t*)*AttributeHeader); - *AttributeHeader += sizeof(uint16_t); - return ParamValue; - } - - static uint32_t ServiceDiscovery_GetDataElementSize(void** AttributeHeader, uint8_t* ElementHeaderSize); - #endif - -#endif +/* + 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 + #include + #include + #include + + #include + #include + + #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