CH58X/CH57X/V208 Observer（观察者）例程讨论讲解
使用的是沁恒的CH582M的Observer例程与官方的demo板。
本例程的功能是主机扫描到从机的MAC地址并打印出来。
先对宏定义进行理解讨论。
最大响应扫描数为8，在串口调试助手那里可以看到打印出的8个MAC地址。
这里的白名单是默认关闭的。
接下来对初始化进行讨论。
void Observer_Init() { ObserverTaskId = TMOS_ProcessEventRegister(Observer_ProcessEvent); // Setup Observer Profile { uint8_t scanRes = DEFAULT_MAX_SCAN_RES; GAPRole_SetParameter(GAPROLE_MAX_SCAN_RES, sizeof(uint8_t), &scanRes); } // Setup GAP GAP_SetParamValue(TGAP_DISC_SCAN, DEFAULT_SCAN_DURATION); // Setup a delayed profile startup tmos_set_event(ObserverTaskId, START_DEVICE_EVT); }
这里是初始化期间调用的功能，这里的详解可以参照CH58X/CH57X/V208的Broadcaster（广播者）例程讲解 – 小舟从此逝_1 – 博客园 (cnblogs.com)这篇文章。
接下来是对任务的管理调度，这里用的是TMOS事件管理。关于TMOS的理解具体可以参照WCH TMOS用法详解 – debugdabiaoge – 博客园 (cnblogs.com)
再次之前我们要了解一下TMOS任务的调度，在这里TMOS任务可以定义16个其中有15个自定义，1个系统任务。
广播者的例程里共写了两个任务，首先看到第一个任务
if(events & SYS_EVENT_MSG) { uint8_t *pMsg; if((pMsg = tmos_msg_receive(ObserverTaskId)) != NULL) { Observer_ProcessTMOSMsg((tmos_event_hdr_t *)pMsg); // Release the TMOS message tmos_msg_deallocate(pMsg); } // return unprocessed events return (events ^ SYS_EVENT_MSG); }
这个任务就是唯一的一个系统任务，这里是在各层协议栈之间传递数据，这这里是接收消息。同时还有这几个函数用于内部数据的传递。这部分可以参考CH579/CH57x 的TMOS系统使用 – iot-fan – 博客园 (cnblogs.com)对这部分进行更详尽的了解。
extern bStatus_t tmos_msg_send( tmosTaskID taskID, uint8_t *msg_ptr ); extern uint8_t *tmos_msg_receive( tmosTaskID taskID ); extern uint8_t *tmos_msg_allocate( uint16_t len ); extern bStatus_t tmos_msg_deallocate( uint8_t *msg_ptr );
第二个任务则是用户自定义事件，本例程中只使用了这一个自定义事件；
if(events & START_DEVICE_EVT) { // Start the Device GAPRole_ObserverStartDevice((gapRoleObserverCB_t *)&ObserverRoleCB); return (events ^ START_DEVICE_EVT); } // Discard unknown events return 0; }
GAPRole_ObserverStartDevice((gapRoleObserverCB_t *)&ObserverRoleCB);此函数是观察者角色启动设备，在系统启动期间调用一次。
下面讨论的是对自定义任务的回调函数。
static void ObserverEventCB(gapRoleEvent_t *pEvent) { switch(pEvent->gap.opcode) {
//事件初始化完成之后发送
case GAP_DEVICE_INIT_DONE_EVENT：
{
GAPRole_ObserverStartDiscovery(DEFAULT_DISCOVERY_MODE,
DEFAULT_DISCOVERY_ACTIVE_SCAN,
DEFAULT_DISCOVERY_WHITE_LIST);
PRINT("Discovering...\n"); } break;
//将设备添加到设备发现结果列表 case GAP_DEVICE_INFO_EVENT: { ObserverAddDeviceInfo(pEvent->deviceInfo.addr, pEvent->deviceInfo.addrType); } break; //设备发现完成将设备罗列出来 case GAP_DEVICE_DISCOVERY_EVENT: { PRINT("Discovery over...\n"); // Display discovery results if(pEvent->discCmpl.numDevs > 0) { int i, j; // Increment index of current result (with wraparound) for(j = 0; j < pEvent->discCmpl.numDevs; j++) { PRINT("Device %d : ", j); for(i = 0; i < 6; i++) { PRINT("%x ", pEvent->discCmpl.pDevList[j].addr[i]); } PRINT("\n"); } } GAPRole_ObserverStartDiscovery(DEFAULT_DISCOVERY_MODE, DEFAULT_DISCOVERY_ACTIVE_SCAN, DEFAULT_DISCOVERY_WHITE_LIST); PRINT("Discovering...\n "); } break; default: break; } }
上述程序中的
GAPRole_ObserverStartDiscovery(DEFAULT_DISCOVERY_MODE,
DEFAULT_DISCOVERY_ACTIVE_SCAN,
DEFAULT_DISCOVERY_WHITE_LIST); 我们可以看到可以看到本函数的定义
extern bStatus_t GAPRole_ObserverStartDiscovery( uint8_t mode, uint8_t activeScan, uint8_t whiteList );
uint8_t mode：发现模式 uint8_t activeScan：如果为TRUE执行主动扫描 uint8_t whiteList：仅扫描白名单中的设备
这三个参数在本例程的定义分别是：
#define DEFAULT_DISCOVERY_MODE DEVDISC_MODE_ALL
#define DEFAULT_DISCOVERY_ACTIVE_SCAN TRUE
#define DEFAULT_DISCOVERY_WHITE_LIST FALSE
ObserverAddDeviceInfo(pEvent->deviceInfo.addr, pEvent->deviceInfo.addrType);调用的函数为
static void ObserverAddDeviceInfo(uint8_t *pAddr, uint8_t addrType) { uint8_t i; // If result count not at max if(ObserverScanRes < DEFAULT_MAX_SCAN_RES) //如果未达到最大扫描数量，扫描个数由自己设置（大约可扫描的数量是40左右） { // Check if device is already in scan results for(i = 0; i < ObserverScanRes; i++) { if(tmos_memcmp(pAddr, ObserverDevList[i].addr, B_ADDR_LEN)) { return; } } // Add addr to scan result list tmos_memcpy(ObserverDevList[ObserverScanRes].addr, pAddr, B_ADDR_LEN); ObserverDevList[ObserverScanRes].addrType = addrType; // Increment scan result count ObserverScanRes++; } }
这只是最基础的讨论，如有问题请指正！
如转载请标明出处！文章可能被无良网站搬运。某些网站拿着别人的文章写着“我的编程学习分享”。
禁止soolco-博客、易学编程网 – 易学编程网 (yixuebiancheng.com)转载。
