【DWM1000】 code 解密3一ANCHOR RUN起来
int done = INST_NOT_DONE_YET;
#define INST_DONE_WAIT_FOR_NEXT_EVENT 1 //this signifies that the current event has been processed and instance is ready for next one
#define INST_DONE_WAIT_FOR_NEXT_EVENT_TO 2 //this signifies that the current event has been processed and that instance is waiting for next one with a timeout
//which will trigger if no event coming in specified time
#define INST_NOT_DONE_YET 0 //this signifies that the instance is still processing the current event
int message = instance_peekevent(); //get any of the received events from ISR
int instance_peekevent(void)
{
int instance = 0;
return instance_data[instance].dwevent[instance_data[instance].dweventPeek].type; //return the type of event that is in front of the queue
}
第一次运行到这里的时候，instance_data[instance].dweventPeek 为0 ，我们在之前初始化的时候看到的结果
Peek，也就是瞟一眼，看看是否有事件，假定我们这里还米有收到任何事件。 后面我们会看事件的产生，怎么往里面装，怎么取出。 这里只是简单的瞟一眼。
while(done == INST_NOT_DONE_YET)
{
//int state = instance_data[instance].testAppState;
done = instance_localdata[instance].testapprun_fn(&instance_data[instance], message) ; // run the communications application
//we've processed message
message = 0;
}
由于进入函数的时候，我们定义了局部变量done 为INST_NOT_DONE_YET，所以至少会执行一下while 循环里面的内容。
done = instance_localdata[instance].testapprun_fn(&instance_data[instance], message) ;
回忆之前我们code分析如下内容
//应用层函数设定
void instance_setapprun(int (*apprun_fn)(instance_data_t *inst, int message))
{
int instance = 0 ;
instance_localdata[instance].testapprun_fn = apprun_fn;
}
设定这些函数，只是提供入口，此时还不会执行。但是RX TX 回调函数是通过中断触发的，设定后可能会立马执行，这个我们后续看代码分析。
之前只是赋值，而现在才是真的执行这个函数testapprun_s
testapprun_s &instance_data[instance], message)
传递的两个变量A : instance_data, 也就是我们开始初始化的变量instance
B:message. instance_peekevent()是它的返回值，我们暂且还不能假定是什么东西。
那么我们现在看看testapprun_s函数吧。
/ -------------------------------------------------------------------------------------------------------------------
//
// the main instance state machine (all the instance modes Tag, Anchor or Listener use the same statemachine....)
//
// -------------------------------------------------------------------------------------------------------------------
//
int testapprun_s(instance_data_t *inst, int message)
{
switch (inst->testAppState)
{
case TA_INIT :
// printf("TA_INIT") ;
switch (inst->mode)
{
case TAG:
{
列出一段，对着就是十分糟糕的主要状态机部分了。
在分析这段代码前，我们需要做一些假定，暂时假定，我们现在分析流程是ANCHOR的，因为这个家伙会先启动，由于涉及到无线通信数据收发，所以我们会时不时的切换到TAG。
到目前为止，ANCHOR 和TAG 的代码基本都是一致的。后面状态机就有区别了。
好了，我们假定现在设备是ANCHOR，开始状态机第一步吧。
switch (inst->testAppState)
{
case TA_INIT :
// printf("TA_INIT") ;
switch (inst->mode)
{
case TAG:
{
……
}
break;
case ANCHOR:
{
dwt_enableframefilter(DWT_FF_NOTYPE_EN); //disable frame filtering
inst->frameFilteringEnabled = 0 ;
dwt_seteui(inst->eui64);
dwt_setpanid(inst->panid);
#if (USING_64BIT_ADDR==0)
{
uint16 addr = inst->eui64[0] + (inst->eui64[1] << 8);
dwt_setaddress16(addr);
//set source address into the message structure
memcpy(&inst->msg.sourceAddr[0], inst->eui64, ADDR_BYTE_SIZE_S);
//set source address into the message structure
memcpy(&inst->rng_initmsg.sourceAddr[0], inst->eui64, ADDR_BYTE_SIZE_S);
}
#else
//set source address into the message structure
memcpy(&inst->msg.sourceAddr[0], inst->eui64, ADDR_BYTE_SIZE_L);
//set source address into the message structure
memcpy(&inst->rng_initmsg.sourceAddr[0], inst->eui64, ADDR_BYTE_SIZE_L);
#endif
// First time anchor listens we don't do a delayed RX
dwt_setrxaftertxdelay(0);
//change to next state - wait to receive a message
inst->testAppState = TA_RXE_WAIT ;
dwt_setrxtimeout(0);
inst->canprintinfo = 1;
}
break;
case LISTENER:
{
……
}
break ; // end case TA_INIT
default:
break;
}
break; // end case TA_INIT
上来case 是根据设备状态判断的，没错，我们之前初始化的时候见过这个家伙
INST_STATES testAppState ; int instance_init_s(int mode) TA_INIT
进去后，会根据不同的角色(TAG ANCHOR LISTENER)执行不同的代码，先忽略TAG 和 LISTENER的部分，看看ANCHOR做了什么
dwt_enableframefilter(DWT_FF_NOTYPE_EN); //disable frame filtering inst->frameFilteringEnabled = 0 ;
关于帧的控制，感觉这家伙不想接收任何数据，同时对结构体frameFilteringEnabled 赋值为0.
dwt_seteui(inst->eui64); dwt_setpanid(inst->panid);
设置64位地址以及PANIND，我们在初始化的时候做的内容包括这两个家伙了。
uint8 eui64[8]; // devices EUI 64-bit address ？？？？ uint16 panid ; instance_init 0 xdeca // panid used in the frames
可以追进去看看这两个函数，都是寄存器级别的操作了，我们不追了。dwt_ 开头的都是寄存器级别的操作。
宏定义有如下一行内容
#define USING_64BIT_ADDR (1) //when set to 0 - the DecaRanging application will use 16-bit addresses
所以我们就知道执行的东西是
#else
//set source address into the message structure
memcpy(&inst->msg.sourceAddr[0], inst->eui64, ADDR_BYTE_SIZE_L);
//set source address into the message structure
memcpy(&inst->rng_initmsg.sourceAddr[0], inst->eui64, ADDR_BYTE_SIZE_L);
#endif
好，关于结构体，已知参数又多了两个msg.sourceAddr[0] 和rng_initmsg.sourceAddr[0]。 这两个参数都是ANCHOR的长地址。(这两个参数的值归ANCHOR所有)
// First time anchor listens we don't do a delayed RX dwt_setrxaftertxdelay(0); //change to next state - wait to receive a message inst->testAppState = TA_RXE_WAIT ; dwt_setrxtimeout(0); inst->canprintinfo = 1;
这段代码中有两个dwt_ 开头的函数，我们看注释就可以了，取消delayed RX设定以及将rxtimeout设置为0. 修改了testAppState = TA_RXE_WAIT，同时canprintinfo 被设置为1
看到这里突然想到我们testapprun_s 传入两个函数，第二message 还没有用到，确实，对ANCHOR 的TA_INIT 还没有用到这个参数。
case TA_INIT : …… Break;
Break 了，我们需要看看 switch (inst->testAppState)之外是否还有代码。
一直拉到testapprun_s最后，发现只有这个了
return inst->done; } // end testapprun()
好吧，我们刚才没有看inst->done是个什么东西，返回去再看看
仔细在TA_INITàANCHOR 代码块找了一圈发现并没有设置这个inst->done. 好吧，那我们看看之前初始化的时候是否有设置。
int done ; //done with the current event/wait for next event to arrive
没有标记，那可能是没有设置，我们那认为它返回的初始值0. 先这样吧，第一次尝试了testapprun_s，我们赶快跳到instance_run(void) 中吧。
while(done == INST_NOT_DONE_YET)
{
//int state = instance_data[instance].testAppState;
done = instance_localdata[instance].testapprun_fn(&instance_data[instance], message) ; // run the communications application
//we've processed message
message = 0;
}
我们假定done为0，name看看是否还在while中
#define INST_NOT_DONE_YET 0
看来很不幸，满足while 条件，再次执行，再次进入到testapprun_s中。
