Document Bluetooth files with overall file Doxygen comments. Add more initial RFCOMM...

[pub/USBasp.git] / Demos / Host / Incomplete / BluetoothHost / Lib / SDPServices.c

diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c b/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c
index ca47f90..16317e7 100644 (file)
--- a/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c
+++ b/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c
@@ -28,8 +28,19 @@
   this software.\r
 */\r
 \r
+/** \file\r
+ *\r
+ *  SDP Service Attribute definitions. This file contains the attributes\r
+ *  and attribute tables of all the services the device supports, which can\r
+ *  then be retrieved by a connected Bluetooth device via the SDP server.\r
+ */\r
+\r
 #include "SDPServices.h"\r
 \r
+/** Serial Port Profile attribute, listing the unique service handle of the Serial Port service\r
+ *  within the device. This handle can then be requested by the SDP client in future transactions\r
+ *  in lieu of a search UUID list.\r
+ */\r
 const struct\r
 {\r
        uint8_t  Header;\r
@@ -40,6 +51,10 @@ const struct
                SWAPENDIAN_32(0x00010001),\r
        };\r
 \r
+/** Serial Port Profile attribute, listing the implemented Service Class UUIDs of the Serial Port service\r
+ *  within the device. This list indicates all the class UUIDs that apply to the Serial Port service, so that\r
+ *  a SDP client can search by a generalized class rather than a specific UUID to determine supported services.\r
+ */\r
 const struct\r
 {\r
        uint8_t    Header;\r
@@ -54,6 +69,10 @@ const struct
                },\r
        };\r
 \r
+/** Serial Port Profile attribute, listing the Protocols (and their attributes) of the Serial Port service\r
+ *  within the device. This list indicates what protocols the service is layered on top of, as well as any\r
+ *  configuration information for each layer.\r
+ */\r
 const struct\r
 {\r
        uint8_t               Header;\r
@@ -77,11 +96,15 @@ const struct
                        (sizeof(ItemUUID_t) + sizeof(Item8Bit_t)),\r
                        {\r
                                {(SDP_DATATYPE_UUID | SDP_DATASIZE_128Bit), RFCOMM_UUID},\r
-                               {(SDP_DATATYPE_UnsignedInt | SDP_DATASIZE_8Bit), 0x00},\r
+                               {(SDP_DATATYPE_UnsignedInt | SDP_DATASIZE_8Bit), 0x03},\r
                        },\r
                },\r
        };\r
 \r
+/** Serial Port Profile attribute, listing the Browse Group List UUIDs which this service is a member of.\r
+ *  Browse Group UUIDs give a way to group together services within a device in a simple heirachy, so that\r
+ *  a SDP client can progressively narrow down an general browse to a specific service which it requires.\r
+ */\r
 const struct\r
 {\r
        uint8_t    Header;\r
@@ -95,7 +118,10 @@ const struct
                        {(SDP_DATATYPE_UUID | SDP_DATASIZE_128Bit), PUBLICBROWSEGROUP_CLASS_UUID},\r
                },\r
        };\r
-       \r
+\r
+/** Serial Port Profile attribute, listing the languages (and their encodings) supported\r
+ *  by the Serial Port service in its text string attributes.\r
+ */\r
 const struct\r
 {\r
        uint8_t            Header;\r
@@ -113,7 +139,8 @@ const struct
                        },\r
                },\r
        };\r
-       \r
+\r
+/** Serial Port Profile attribute, listing a human readable name of the service. */\r
 const struct\r
 {\r
        uint8_t Header;\r
@@ -126,6 +153,7 @@ const struct
                "Wireless Serial Port",\r
        };\r
 \r
+/** Serial Port Profile attribute, listing a human readable description of the service. */\r
 const struct\r
 {\r
        uint8_t Header;\r
@@ -138,6 +166,9 @@ const struct
                "Wireless Serial Port Service",\r
        };\r
 \r
+/** Service Attribute Table for the Serial Port service, linking each supported attribute ID to its data, so that\r
+ *  the SDP server can retrieve it for transmission back to a SDP client upon request.\r
+ */\r
 const ServiceAttributeTable_t PROGMEM SerialPort_Attribute_Table[] =\r
        {\r
                {.AttributeID = SDP_ATTRIBUTE_ID_SERVICERECORDHANDLE,    .Data = &SerialPort_Attribute_ServiceHandle       },\r