一、简单介绍
本文介绍怎样在SimpleBLEPeripheralproject中。加入一个香瓜任务。
（香瓜任务与project原有任务相互独立。互不影响）
二、实验平台
协议栈版本号：BLE-CC254x-1.4.0
编译软件：IAR 8.20.2
硬件平台：Smart RF（主芯片CC2541）
三、版权声明
博主：甜甜的大香瓜
四、实验前提
1、在进行本文步骤前。请先阅读下面博文：
暂无
2、在进行本文步骤前，请先实现下面博文：
暂无
五、基础知识
1、任务、事件、消息的差别是什么？
答：
1）简述
1台设备中有多个任务，1个任务有16个事件，消息用于不同任务之间的传递。
2）详述
任务：SimpleBLEPeripheralproject中从底层的LL层到应用的Application层。一共分为有12个任务，每一个任务会分配一个事件管理的变量，变量统一存在：
uint16 *tasksEvents;
当中，越底层的优先级越高。应用层的优先级是最低的，也就是此层中的事件是最后才会处理。
事件：1个任务中有16个事件，也就是上面tasksEvents的16位每一位都相应一个事件。0x0001意味着第0位的事件须要被运行。
注意，每一个任务的第15位事件（0x8000）是用于不同任务之间的消息传递的，此事件不可被我们编程使用！
！！！
消息：用于不同任务之间的传递。
比方，当按键按下时，HAL层检測到了按键。osal会将按键的信息打包，通过消息的形式发往应用层，终于在应用层做按键的处理。
以下举个样例。加强理解。
比如，tasksEvents[11] = 0x0002。那么就意味着，第11个任务的第1位事件须要被运行。
首先，在OSAL_SimpleBLEPeripheral.c中，能够看到第11个任务是应用层。
const pTaskEventHandlerFn tasksArr[] =
{
LL_ProcessEvent, // task 0
Hal_ProcessEvent, // task 1
HCI_ProcessEvent, // task 2
#if defined ( OSAL_CBTIMER_NUM_TASKS )
OSAL_CBTIMER_PROCESS_EVENT( osal_CbTimerProcessEvent ), // task 3
#endif
L2CAP_ProcessEvent, // task 4
GAP_ProcessEvent, // task 5
GATT_ProcessEvent, // task 6
SM_ProcessEvent, // task 7
GAPRole_ProcessEvent, // task 8
GAPBondMgr_ProcessEvent, // task 9
GATTServApp_ProcessEvent, // task 10
SimpleBLEPeripheral_ProcessEvent // task 11
};
其次，在应用层的SimpleBLEPeripheral.h文件里。发现0x0002事件是周期事件
// Simple BLE Peripheral Task Events
#define SBP_START_DEVICE_EVT 0x0001
#define SBP_PERIODIC_EVT 0x0002
最后。当osal层运行到应用层时，就会去运行应用层中的事件处理函数SimpleBLEPeripheral_ProcessEvent中的SBP_PERIODIC_EVT事件了。
2、是否一定须要加入自己的任务、事件、消息？
答：SimpleBLEPeripheralproject中已经给每一个层分配了任务，而osal也把消息机制做好了。因此并不一定要加入自己的任务、消息。
而应用层的事件往往是须要被修改的，比方加入按键事件、通信事件、定时事件、採集事件……
当应用层的16个事件都被你使用完了，这时候才须要考虑新增一个任务，这样又多16个事件可使用。
六、实验步骤
1、加入香瓜任务的初始化调用
1）调用香瓜任务的初始化函数（OSAL_SimpleBLEPeripheral.c的osalInitTasks中）
void osalInitTasks( void )
{
uint8 taskID = 0;
tasksEvents = (uint16 *)osal_mem_alloc( sizeof( uint16 ) * tasksCnt);
osal_memset( tasksEvents, 0, (sizeof( uint16 ) * tasksCnt));
/* LL Task */
LL_Init( taskID++ );
/* Hal Task */
Hal_Init( taskID++ );
/* HCI Task */
HCI_Init( taskID++ );
#if defined ( OSAL_CBTIMER_NUM_TASKS )
/* Callback Timer Tasks */
osal_CbTimerInit( taskID );
taskID += OSAL_CBTIMER_NUM_TASKS;
#endif
/* L2CAP Task */
L2CAP_Init( taskID++ );
/* GAP Task */
GAP_Init( taskID++ );
/* GATT Task */
GATT_Init( taskID++ );
/* SM Task */
SM_Init( taskID++ );
/* Profiles */
GAPRole_Init( taskID++ );
GAPBondMgr_Init( taskID++ );
GATTServApp_Init( taskID++ );
//香瓜
/* Application */
SimpleBLEPeripheral_Init( taskID++ );
/* 香瓜应用 */
GUA_Init( taskID );
//香瓜
}
注意SimpleBLEPeripheral_Init任务的括号里。taskID须要添加。
而香瓜任务为最后一个任务。不须要再添加。
2）注冊香瓜任务的事件（OSAL_SimpleBLEPeripheral.c中）
const pTaskEventHandlerFn tasksArr[] =
{
LL_ProcessEvent, // task 0
Hal_ProcessEvent, // task 1
HCI_ProcessEvent, // task 2
#if defined ( OSAL_CBTIMER_NUM_TASKS )
OSAL_CBTIMER_PROCESS_EVENT( osal_CbTimerProcessEvent ), // task 3
#endif
L2CAP_ProcessEvent, // task 4
GAP_ProcessEvent, // task 5
GATT_ProcessEvent, // task 6
SM_ProcessEvent, // task 7
GAPRole_ProcessEvent, // task 8
GAPBondMgr_ProcessEvent, // task 9
GATTServApp_ProcessEvent, // task 10
SimpleBLEPeripheral_ProcessEvent, // task 11
//香瓜
GUA_ProcessEvent // task 12
//香瓜
};
将香瓜任务中的事件处理函数名称。写到tasksArr中，当osal轮询到有香瓜任务的事件须要运行时，就会运行GUA_ProcessEvent函数。
3）加入香瓜任务的头文件（OSAL_SimpleBLEPeripheral.c中）
//香瓜
#include "GUA.h"
//香瓜
2、编写并加入香瓜任务
1）写一个GUA.c（存放在“……\BLE-CC254x-1.4.0\Projects\ble\SimpleBLEPeripheral\Source\GUA”路径下）
//******************************************************************************
//name: GUA.c
//introduce: 香瓜任务
//author: 甜甜的大香瓜
//changetime: 2016.04.07
//email: 897503845@qq.com
//******************************************************************************
/*********************头文件************************/
#include "GUA.h"
#include "OSAL.h"
#include "ioCC2541.h"
/*********************宏定义************************/
#define VOID (void)
#define GUA_LED_TEST_EVT_PERIOD 1000
/***************内部变量声明************************/
static uint8 GUA_TaskID; // Task ID for internal task/event processing
/***************内部函数声明************************/
static void GUA_ProcessOSALMsg( osal_event_hdr_t *pMsg );
//******************************************************************************
//name: GUA_Init
//introduce: 香瓜任务的初始化
//parameter: task_id:任务的ID
//return: none
//author: 甜甜的大香瓜
//email: 897503845@qq.com
//changetime: 2016.04.07
//******************************************************************************
void GUA_Init( uint8 task_id )
{
GUA_TaskID = task_id;
//运行香瓜任务的启动事件
osal_set_event( GUA_TaskID, GUA_START_DEVICE_EVT );
}
//******************************************************************************
//name: GUA_ProcessEvent
//introduce: 香瓜任务的事件处理
//parameter: task_id:任务的ID,
// events:事件
//return: 返回运行后的事件状态
//author: 甜甜的大香瓜
//email: 897503845@qq.com
//changetime: 2016.04.07
//******************************************************************************
uint16 GUA_ProcessEvent( uint8 task_id, uint16 events )
{
VOID task_id;
//系统事件
if ( events & SYS_EVENT_MSG )
{
uint8 *pMsg;
if ( (pMsg = osal_msg_receive( GUA_TaskID )) != NULL )
{
GUA_ProcessOSALMsg( (osal_event_hdr_t *)pMsg );
VOID osal_msg_deallocate( pMsg );
}
return (events ^ SYS_EVENT_MSG);
}
//香瓜任务的启动事件
if ( events & GUA_START_DEVICE_EVT )
{
osal_start_timerEx( GUA_TaskID, GUA_LED_TEST_EVT, GUA_LED_TEST_EVT_PERIOD );
return ( events ^ GUA_START_DEVICE_EVT );
}
//香瓜任务的LED点灯事件
if ( events & GUA_LED_TEST_EVT )
{
//test
P1_1 = ~P1_1; //这里測试按一次长按键按键，就取反一次P1_1，方便观察P1_1相应的led
P1SEL &= ~(1 << 1); //设置为IO口
P1DIR |= (1 << 1); //设置为输出
osal_start_timerEx( GUA_TaskID, GUA_LED_TEST_EVT, GUA_LED_TEST_EVT_PERIOD );
//test
return ( events ^ GUA_LED_TEST_EVT );
}
return 0;
}
//******************************************************************************
//name: GUA_ProcessOSALMsg
//introduce: 香瓜任务的消息处理
//parameter: pMsg:消息
//return: none
//author: 甜甜的大香瓜
//email: 897503845@qq.com
//changetime: 2016.04.07
//******************************************************************************
static void GUA_ProcessOSALMsg( osal_event_hdr_t *pMsg )
{
switch ( pMsg->event )
{
default:
break;
}
}
2）写一个头文件GUA.h（存放在“……\BLE-CC254x-1.4.0\Projects\ble\SimpleBLEPeripheral\Source\GUA”路径下）
//******************************************************************************
//name: GUA.c
//introduce: 香瓜任务头文件
//author: 甜甜的大香瓜
//changetime: 2016.04.07
//email: 897503845@qq.com
//******************************************************************************
#ifndef GUA_H
#define GUA_H
#ifdef __cplusplus
extern "C"
{
#endif
/*********************头文件************************/
#include "bcomdef.h"
/*********************宏定义************************/
#define GUA_START_DEVICE_EVT 0x0001
#define GUA_LED_TEST_EVT 0x0002
/*******************香瓜函数************************/
extern void GUA_Init( uint8 task_id );
extern uint16 GUA_ProcessEvent( uint8 task_id, uint16 events );
#ifdef __cplusplus
}
#endif
#endif
3）project中加入GUA.c和GUA.h
4）在IAR设置中加入香瓜任务的源文件路径
$PROJ_DIR$\..\..\SimpleBLEPeripheral\Source\GUA
七、注意事项
手机可能缓存了之前的代码（在更新过CC2541的代码之后，都须要清除手机端的缓存！！！），因此要清除缓存。清除缓存的方法例如以下：
方法一：关闭app、关闭蓝牙总开关、打开蓝牙总开关、打开app。
方法二：手机重新启动。
八、实验结果
代码下进Smart RF之后。板子上P11引脚相应的LED2会一秒变换一次亮、灭状态。
这个LED2亮灭的測试代码即在香瓜任务中实现的，所以香瓜任务加入成功。
