CC254x-BLE协议栈添加服务与特征值

he129807

CC254x-BLE协议栈添加服务与特征值

针对协议栈版本：CC254x-1.4.2.2

使用的工程文件：Texas Instruments\BLE-CC254x-1.4.2.2\Projects\ble\SimpleBLEPeripheral\CC2541DBSimpleBLEPeripheral.eww

实验过程：

1.修改profile

2.应用层处理

3.使用SensorTag测试结果

（后续有时间会写一篇TI协议栈OSAL任务调度的讲解）

一．增加服务，增加两个特征值 的宏定义

位置：simpleGATTprofile.h

1. // Profile Parameters
   
2. 
   
3. #define SIMPLEPROFILE_CHAR1                   0  // RW uint8 - Profile Characteristic 1 value
   
4. 
   
5. #define SIMPLEPROFILE_CHAR2                   1  // RW uint8 - Profile Characteristic 2 value
   
6. 
   
7. #define SIMPLEPROFILE_CHAR3                   2  // RW uint8 - Profile Characteristic 3 value
   
8. 
   
9. #define SIMPLEPROFILE_CHAR4                   3  // RW uint8 - Profile Characteristic 4 value
   
10. 
    
11. #define SIMPLEPROFILE_CHAR5                   4  // RW uint8 - Profile Characteristic 5 value
    
12. 
    
13. #define SIMPLEPROFILE_CHAR6                   5  // RW uint8 - Profile Characteristic 6 value
    
14. 
    
15. #define SIMPLEPROFILE_CHAR7                   6  // RW uint8 - Profile Characteristic 7 value
    
16. 
    
17. 
    
18. 
    
19.   
    
20. 
    
21. // Simple Profile Service UUID
    
22. 
    
23. #define SIMPLEPROFILE_SERV_UUID               0xFFF0
    
24. 
    
25. #define SIMPLEPROFILE_TEST_UUID               0xFFE0
    
26. 
    
27.    
    
28. 
    
29. // Key Pressed UUID
    
30. 
    
31. #define SIMPLEPROFILE_CHAR1_UUID            0xFFF1
    
32. 
    
33. #define SIMPLEPROFILE_CHAR2_UUID            0xFFF2
    
34. 
    
35. #define SIMPLEPROFILE_CHAR3_UUID            0xFFF3
    
36. 
    
37. #define SIMPLEPROFILE_CHAR4_UUID            0xFFF4
    
38. 
    
39. #define SIMPLEPROFILE_CHAR5_UUID            0xFFF5
    
40. 
    
41. #define SIMPLEPROFILE_CHAR6_UUID            0xFFE1
    
42. 
    
43. #define SIMPLEPROFILE_CHAR7_UUID            0xFFE2

复制代码

二．增加服务，增加两个特征值的UUID

位置：simpleGATTprofile.c

1. // Simple GATT Profile Test UUID: 0xFFE0
   
2. 
   
3. CONST uint8 simpleProfileTestUUID[ATT_BT_UUID_SIZE] =
   
4. 
   
5. {
   
6. 
   
7.   LO_UINT16(SIMPLEPROFILE_TEST_UUID), HI_UINT16(SIMPLEPROFILE_TEST_UUID)
   
8. 
   
9. };
   
10. 
    
11. 
    
12. 
    
13. // Characteristic 6 UUID: 0xFFE1
    
14. 
    
15. CONST uint8 simpleProfilechar6UUID[ATT_BT_UUID_SIZE] =
    
16. 
    
17. {
    
18. 
    
19.   LO_UINT16(SIMPLEPROFILE_CHAR6_UUID), HI_UINT16(SIMPLEPROFILE_CHAR6_UUID)
    
20. 
    
21. };
    
22. 
    
23. 
    
24. 
    
25. // Characteristic 7 UUID: 0xFFE2
    
26. 
    
27. CONST uint8 simpleProfilechar7UUID[ATT_BT_UUID_SIZE] =
    
28. 
    
29. {
    
30. 
    
31.   LO_UINT16(SIMPLEPROFILE_CHAR7_UUID), HI_UINT16(SIMPLEPROFILE_CHAR7_UUID)
    
32. 
    
33. };

复制代码

三．增加服务和特征值的属性

位置：simpleGATTprofile.c

1. // Simple Profile Service attribute
   
2. 
   
3. static CONST gattAttrType_t simpleProfileService = { ATT_BT_UUID_SIZE, simpleProfileServUUID };
   
4. 
   
5. 
   
6. 
   
7. // Simple Profile Test attribute
   
8. 
   
9. static CONST gattAttrType_t simpleProfileTest = { ATT_BT_UUID_SIZE, simpleProfileTestUUID };

复制代码

增加特征值6，属性为可读可写

增加特征值7，属性为Notify(通知)

1. // Simple Profile Characteristic 6 Properties
   
2. 
   
3. static uint8 simpleProfileChar6Props = GATT_PROP_READ | GATT_PROP_WRITE;
   
4. 
   
5. 
   
6. 
   
7. // Characteristic 6 Value
   
8. 
   
9. static uint8 simpleProfileChar6 = 0;
   
10. 
    
11. 
    
12. 
    
13. // Simple Profile Characteristic 6 User Description
    
14. 
    
15. static uint8 simpleProfileChar6UserDesp[17] = "Characteristic 6";
    
16. 
    
17. 
    
18. 
    
19. 
    
20. 
    
21. // Simple Profile Characteristic 7 Properties
    
22. 
    
23. static uint8 simpleProfileChar7Props = GATT_PROP_NOTIFY;
    
24. 
    
25. 
    
26. 
    
27. // Characteristic 7 Value
    
28. 
    
29. static uint8 simpleProfileChar7 = 0;
    
30. 
    
31. 
    
32. 
    
33. // Simple Profile Characteristic 7 Configuration Each client has its own
    
34. 
    
35. // instantiation of the Client Characteristic Configuration. Reads of the
    
36. 
    
37. // Client Characteristic Configuration only shows the configuration for
    
38. 
    
39. // that client and writes only affect the configuration of that client.
    
40. 
    
41. static gattCharCfg_t *simpleProfileChar7Config;
    
42. 
    
43.                                        
    
44. 
    
45. // Simple Profile Characteristic 7 User Description
    
46. 
    
47. static uint8 simpleProfileChar7UserDesp[17] = "Characteristic 7";

复制代码

四．增加注册服务列表

位置：simpleGATTprofile.c

1. static gattAttribute_t testProfileAttrTbl[8] =
   
2. 
   
3. {
   
4. 
   
5.   // Simple Profile Service
   
6. 
   
7.   {
   
8. 
   
9.     { ATT_BT_UUID_SIZE, primaryServiceUUID }, /* type */
   
10. 
    
11.     GATT_PERMIT_READ,                         /* permissions */
    
12. 
    
13.     0,                                        /* handle */
    
14. 
    
15.     (uint8 *)&simpleProfileTest               /* pValue */
    
16. 
    
17.   },
    
18. 
    
19. 
    
20. 
    
21.     // Characteristic 6 Declaration
    
22. 
    
23.     {
    
24. 
    
25.       { ATT_BT_UUID_SIZE, characterUUID },
    
26. 
    
27.       GATT_PERMIT_READ,
    
28. 
    
29.       0,
    
30. 
    
31.       &simpleProfileChar6Props
    
32. 
    
33.     },
    
34. 
    
35. 
    
36. 
    
37.       // Characteristic Value 6
    
38. 
    
39.       {
    
40. 
    
41.         { ATT_BT_UUID_SIZE, simpleProfilechar6UUID },
    
42. 
    
43.         GATT_PERMIT_READ | GATT_PERMIT_WRITE,
    
44. 
    
45.         0,
    
46. 
    
47.         &simpleProfileChar6
    
48. 
    
49.       },
    
50. 
    
51. 
    
52. 
    
53.       // Characteristic 6 User Description
    
54. 
    
55.       {
    
56. 
    
57.         { ATT_BT_UUID_SIZE, charUserDescUUID },
    
58. 
    
59.         GATT_PERMIT_READ,
    
60. 
    
61.         0,
    
62. 
    
63.         simpleProfileChar6UserDesp
    
64. 
    
65.       },
    
66. 
    
67. 
    
68. 
    
69.     // Characteristic 7 Declaration
    
70. 
    
71.     {
    
72. 
    
73.       { ATT_BT_UUID_SIZE, characterUUID },
    
74. 
    
75.       GATT_PERMIT_READ,
    
76. 
    
77.       0,
    
78. 
    
79.       &simpleProfileChar7Props
    
80. 
    
81.     },
    
82. 
    
83. 
    
84. 
    
85.       // Characteristic Value 7
    
86. 
    
87.       {
    
88. 
    
89.         { ATT_BT_UUID_SIZE, simpleProfilechar7UUID },
    
90. 
    
91.         0,
    
92. 
    
93.         0,
    
94. 
    
95.         &simpleProfileChar7
    
96. 
    
97.       },
    
98. 
    
99. 
    
100. 
     
101.       // Characteristic 7 configuration
     
102. 
     
103.       {
     
104. 
     
105.         { ATT_BT_UUID_SIZE, clientCharCfgUUID },
     
106. 
     
107.         GATT_PERMIT_READ | GATT_PERMIT_WRITE,
     
108. 
     
109.         0,
     
110. 
     
111.         (uint8 *)&simpleProfileChar7Config
     
112. 
     
113.       },
     
114. 
     
115.       
     
116. 
     
117.       // Characteristic 7 User Description
     
118. 
     
119.       {
     
120. 
     
121.         { ATT_BT_UUID_SIZE, charUserDescUUID },
     
122. 
     
123.         GATT_PERMIT_READ,
     
124. 
     
125.         0,
     
126. 
     
127.         simpleProfileChar7UserDesp
     
128. 
     
129.       },
     
130. 
     
131. };

复制代码

五．注册新的服务

位置：SimpleProfile_AddService

1. simpleProfileChar4Config = (gattCharCfg_t *)osal_mem_alloc( sizeof(gattCharCfg_t) *
   
2. 
   
3.                                                               linkDBNumConns );
   
4. 
   
5.   simpleProfileChar7Config = (gattCharCfg_t *)osal_mem_alloc( sizeof(gattCharCfg_t) *
   
6. 
   
7.                                                               linkDBNumConns );
   
8. 
   
9.   if ( simpleProfileChar4Config == NULL || simpleProfileChar7Config == NULL)
   
10. 
    
11.   {     
    
12. 
    
13.     return ( bleMemAllocError );
    
14. 
    
15.   }
    
16. 
    
17.   
    
18. 
    
19.   // Initialize Client Characteristic Configuration attributes
    
20. 
    
21.   GATTServApp_InitCharCfg( INVALID_CONNHANDLE, simpleProfileChar4Config );
    
22. 
    
23.   GATTServApp_InitCharCfg( INVALID_CONNHANDLE, simpleProfileChar7Config );
    
24. 
    
25.   
    
26. 
    
27.   if ( services & SIMPLEPROFILE_SERVICE )
    
28. 
    
29.   {
    
30. 
    
31.     // Register GATT attribute list and CBs with GATT Server App
    
32. 
    
33.     status = GATTServApp_RegisterService( simpleProfileAttrTbl,
    
34. 
    
35.                                           GATT_NUM_ATTRS( simpleProfileAttrTbl ),
    
36. 
    
37.                                           GATT_MAX_ENCRYPT_KEY_SIZE,
    
38. 
    
39.                                           &simpleProfileCBs );
    
40. 
    
41.    
    
42. 
    
43.     status = GATTServApp_RegisterService( testProfileAttrTbl,
    
44. 
    
45.                                           GATT_NUM_ATTRS( testProfileAttrTbl ),
    
46. 
    
47.                                           GATT_MAX_ENCRYPT_KEY_SIZE,
    
48. 
    
49.                                           &simpleProfileCBs );

复制代码

六．增加特征值设置处理

位置：SimpleProfile_SetParameter

1. case SIMPLEPROFILE_CHAR6:
   
2. 
   
3.       if ( len == sizeof ( uint8 ) )
   
4. 
   
5.       {
   
6. 
   
7.         simpleProfileChar6 = *((uint8*)value);
   
8. 
   
9.       }
   
10. 
    
11.       else
    
12. 
    
13.       {
    
14. 
    
15.         ret = bleInvalidRange;
    
16. 
    
17.       }
    
18. 
    
19.       break;
    
20. 
    
21. 
    
22. 
    
23.     case SIMPLEPROFILE_CHAR7:
    
24. 
    
25.       if ( len == sizeof ( uint8 ) )
    
26. 
    
27.       {
    
28. 
    
29.         simpleProfileChar7 = *((uint8*)value);
    
30. 
    
31.         
    
32. 
    
33.         // See if Notification has been enabled
    
34. 
    
35.         GATTServApp_ProcessCharCfg( simpleProfileChar7Config, &simpleProfileChar7, FALSE,
    
36. 
    
37.                                     testProfileAttrTbl, GATT_NUM_ATTRS( testProfileAttrTbl ),
    
38. 
    
39.                                     INVALID_TASK_ID, simpleProfile_ReadAttrCB );
    
40. 
    
41.       }

复制代码

七．增加特征值获取处理

位置：SimpleProfile_GetParameter

1. case SIMPLEPROFILE_CHAR6:
   
2. 
   
3.       *((uint8*)value) = simpleProfileChar6;
   
4. 
   
5.       break;  
   
6. 
   
7. 
   
8. 
   
9. 
   
10. 
    
11. 
    
12. 
    
13.     case SIMPLEPROFILE_CHAR7:
    
14. 
    
15.       *((uint8*)value) = simpleProfileChar7;

复制代码

八．增加特征值读取处理

位置：simpleProfile_ReadAttrCB

九．增加特征值写入处理

位置：simpleProfile_WriteAttrCB

1. case SIMPLEPROFILE_CHAR1_UUID:
   
2. 
   
3.       case SIMPLEPROFILE_CHAR3_UUID:
   
4. 
   
5.       case SIMPLEPROFILE_CHAR6_UUID:
   
6. 
   
7. 
   
8. 
   
9.         //Validate the value
   
10. 
    
11.         // Make sure it's not a blob oper
    
12. 
    
13.         if ( offset == 0 )
    
14. 
    
15.         {
    
16. 
    
17.           if ( len != 1 )
    
18. 
    
19.           {
    
20. 
    
21.             status = ATT_ERR_INVALID_VALUE_SIZE;
    
22. 
    
23.           }
    
24. 
    
25.         }
    
26. 
    
27.         else
    
28. 
    
29.         {
    
30. 
    
31.           status = ATT_ERR_ATTR_NOT_LONG;
    
32. 
    
33.         }
    
34. 
    
35.         
    
36. 
    
37.         //Write the value
    
38. 
    
39.         if ( status == SUCCESS )
    
40. 
    
41.         {
    
42. 
    
43.           uint8 *pCurValue = (uint8 *)pAttr->pValue;        
    
44. 
    
45.           *pCurValue = pValue[0];
    
46. 
    
47. 
    
48. 
    
49.           if( pAttr->pValue == &simpleProfileChar1 )
    
50. 
    
51.           {
    
52. 
    
53.             notifyApp = SIMPLEPROFILE_CHAR1;        
    
54. 
    
55.           }
    
56. 
    
57.           else if( pAttr->pValue == &simpleProfileChar3 )
    
58. 
    
59.           {
    
60. 
    
61.             notifyApp = SIMPLEPROFILE_CHAR3;           
    
62. 
    
63.           }
    
64. 
    
65.           else
    
66. 
    
67.           {
    
68. 
    
69.             notifyApp = SIMPLEPROFILE_CHAR6;           
    
70. 
    
71.           }
    
72. 
    
73.         }
    
74. 
    
75.             
    
76. 
    
77.         break;

复制代码

到此为止！！！Profile就修改完了。下面开始应用层的处理。

十． 增加广播数据

位置：simpleBLEPeripheral.c

1. 0x03,   // length of this data
   
2. 
   
3.   GAP_ADTYPE_16BIT_MORE,      // some of the UUID's, but not all
   
4. 
   
5.   LO_UINT16( SIMPLEPROFILE_TEST_UUID ),
   
6. 
   
7.   HI_UINT16( SIMPLEPROFILE_TEST_UUID ),

复制代码

十一．初始化特征值

位置：SimpleBLEPeripheral_Init

1. uint8 charValue1 = 1;
   
2. 
   
3.     uint8 charValue2 = 2;
   
4. 
   
5.     uint8 charValue3 = 3;
   
6. 
   
7.     uint8 charValue4 = 4;
   
8. 
   
9.     uint8 charValue5[SIMPLEPROFILE_CHAR5_LEN] = { 1, 2, 3, 4, 5 };
   
10. 
    
11.     uint8 charValue6 = 6;
    
12. 
    
13.     uint8 charValue7 = 7;
    
14. 
    
15.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR1, sizeof ( uint8 ), &charValue1 );
    
16. 
    
17.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR2, sizeof ( uint8 ), &charValue2 );
    
18. 
    
19.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR3, sizeof ( uint8 ), &charValue3 );
    
20. 
    
21.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR4, sizeof ( uint8 ), &charValue4 );
    
22. 
    
23.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR5, SIMPLEPROFILE_CHAR5_LEN, charValue5 );
    
24. 
    
25.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR6, sizeof ( uint8 ), &charValue6 );
    
26. 
    
27.     SimpleProfile_SetParameter( SIMPLEPROFILE_CHAR7, sizeof ( uint8 ), &charValue7 );

复制代码

十二．增加特征值处理应用

位置：SimpleBLEPeripheral_ProcessEvent

时间处理函数中，在启动事件中创建周期性事件

周期性事件中调用处理函数performPeriodicTask

处理函数中读取char6的值，并写入char7

这样当char7改变时，会自动通知serve端

测试结果：

下载并运行程序，打开SensorTag这款TI官方APP。可以看到设备名。

点击设备并选择Service Explorer,可以看到我们添加的UUID为0xffe0的服务

点进去可以看到UUID为0xffe1的特征值其属性是读写，0xffe2属性为N（Notify）

点选0xffe2特征值，选择打开Notify开关on。

稍微等待，可以接收到设备notify过来的值06。

然后返回到UUID为0xffe1的特征值，修改其值为9

返回0xffe2可以看到设备主动notify过来的值是9

实验到此结束，你可以在开发板和手机之间传输 PWM等任何数据了。

其过程只针对TI协议栈CC254x-1.4.2.2这个版本。

后面有时间，开贴讲解协议栈中负责各层任务调度的OSAL系统。