zstack 串口使用指南

还是藏的很隐蔽就是了，呵呵！！！！关于这个128我是做个实验的，在串口互发的实验也是定义的128.多了就会丢掉！这个下次有机会在说。
5、uint8 rxCnt ;
static void pollISR( uartCfg_t *cfg )
{
uint8 cnt = UART_RX_AVAIL( cfg );
static void pollISR( uartCfg_t *cfg )
这两个函数直接就用到了这个结构作为参数，应该说是联系最紧密的了，是我们重点剖析的对象了，但是这里不看DMA,因为这个俺很外行----------哈哈！！！！
uint16 HalUARTRead( uint8 port, uint8 *buf, uint16 len )
首先说说这个结构的应用范畴，它是直接面向串口的应用层，也就是与客户接触的还是比较紧密的一个结构，一般是在串口接收数据和发送数据的时候使用。而串口有两种方式，一种是普通的串口，一种是DMA方式。这里我只针对普通串口来分析这个结构。
首先来看看这个结构在什么地方用到了？
static void pollDMA( uartCfg_t *cfg )
4、uint8 rxMax;//接收最大长度
这个我想没必要多做解释，这里只看看它究竟有多大，因为这个量的赋值非常隐蔽，俺找了好久才功夫不负有心人！！！
首先在打开串口第函数中有：
cfg->rxMax = config->rx.maxBufSize;
其次在void SPIMgr_Init ()函数中有：
其实从上面那个中断函数就已经把这个参数的功能体现的淋漓尽致了：
就是串口接收数据，这个参数始终指向像一个参数被存放到rxBuf的位置。因为硬件串口缓存器U0DBUF只能存放一个字节，如果不及时把这个接收到的转移出去，那么就会被下一个到来的字节覆盖掉，所以rxHead变量就指向了这个存放的地址，当然是基于定义的rxBuf存储空间。相当于一个数组赋值，那么必然有个变量会指向该数组的下一个赋值的参数，当然这个变量的最终值也能在一定程度上体现这个被赋值数组的大小。所以rxHead在这里起到了类似的作用，而if ( cfg0->rxHead == cfg0->rxMax )这一句判断也说明的很清楚，一旦这个计数达到了定义的最大接收数量，也就是说已经把rxBuf存储空间占满了，那么就不能在继续存放了，否则存放的位置就未知，而且有可能造成程序中其他变量的损坏，那么这个时候如果串口还有数据怎么办？那就需要把rxBuf清空在接收了，否则就会丢失数据。
cfg->rxCnt = cnt;
}
/* It is necessary to stop Rx flow in advance of a full Rx buffer because
* bytes can keep coming while sending H/W fifo flushes.
typedef struct
{
uint8 *rxBuf;//接收缓存
uint8 rxHead;//头
uint8 rxTail;//尾
uint8 rxMax;//接收最大长度
uint8 rxCnt;//计数
uint8 rxTick;//时间
uint8 rxHigh;//高位
uint8 *txBuf;
从这个函数中还能看出两个问题：
rxHead是否用作了串口接收计数，而rxMax代表最大的接收数据长度。
2、uint8 rxHead
字面理解为接收头，但是上面已经提到了似乎起到了串口接收计数的功能。那下面就来看看它到底有什么意义。
cfg->rxHead = cfg->rxTail = 0;
在打开串口中有这么赋值，把它初始化为0.
if ( !(cfg->flag & UART_CFG_RXF) )
{
// If anything received, reset the Rx idle timer.
if ( cfg->rxCnt != cnt )
{
cfg->rxTick = HAL_UART_RX_IDLE;
{
cfg0->rxBuf[cfg0->rxHead] = U0DBUF;
if ( cfg0->rxHead == cfgd = 0;
}
else
{
cfg0->rxHead++;
}
}
这个是串口0中断函数：其中cfg0->rxBuf[cfg0->rxHead] = U0DBUF，显然是把U0DBUF中的数据转移到存储区去。
uint16 HalUARTWrite( uint8 port, uint8 *buf, uint16 len )
这几个函数都在其中定义了这个结构的变量在使用，所以我们也需要关注。
可以看出，这个结构与串口的应用，也就是数据的接收和发送有关，而与串口的初始化灯没有关系。所以这里排除串口初始化的任何可能。
{
cfg->rxTail = 0;
}
else
{
cfg->rxTail++;
}
cnt++;
}
这里是在uint16 HalUARTRead( uint8 port, uint8 *buf, uint16 len )函数中调用的，实际上把rxBuf空间的数据读走，然后rxBuf可以继续串口数据的接收了。可以看到*buf++ = cfg->rxBuf[cfg->rxTail]这个是在转移数据，而转移多少的计数是以rxTail来计数的。一旦计数达到rxMax，那么该计数归0，因为rxMax定义了rxBuf的最大的数据量。
uint8 cnt = UART_RX_AVAIL( cfg );这个函数的第一句，而：
#define UART_RX_AVAIL( cfg ) \
( (cfg->rxHead >= cfg->rxTail) ? (cfg->rxHead - cfg->rxTail) : \
(cfg->rxMax - cfg->rxTail + cfg->rxHead +1 ) )
我的理解是UART_RX_AVAIL是指明串口缓存区rxBuf还剩多少有用的数据，也就是没有被取走的数据。首先从字面理解avail为“效用”的意思，那么扩展下为available，那么意思就是“有用的”“有空的”，呵呵！只有理解其实也很有意思哈。
再从后面的判断语句，cfg->rxHead - cfg->rxTail，由于有上面的讲解，理解这个就很容易了，有的数据数量-已经取走的数据数量，那么就省还有多少各有用的数据量。
3、uint8 rxTail;
这个变量就与上面提到的清空rxBuf密切相关了。
while ( (cfg->rxTail != cfg->rxHead) && (cnt < len) )
{
*buf++ = cfg->rxBuf[cfg->rxTail];
if ( cfg->rxTail == cfg->rxMax )
#if HAL_UART_BIG_TX_BUF
uint16 txHead;
uint16 txTail;
uint16 txMax;
uint16 txCnt;
#else
uint8 txHead;
uint8 txTail;
uint8 txMax;
uint8 txCnt;
#endif
uint8 txTick;
为了更明确每个参数的意思，所以一个个来分析。这个是逆向解决问题的方法，正向思维就是先把每个函数都看完看明白，自然也就知道了。但是我哪有那能耐和功夫？所以就偷懒从后面出发！！！
1、uint8 *rxBuf;//接收缓存
这个参数我觉得没必要太多解释，就是串口接收缓存。直观理解就是串口接收放数据的地方，体现这个含义最明显的地方就是串口接收函数了：
uint8 HalUARTOpen( uint8 port, halUARTCfg_t *config )
void HalUARTClose( uint8 port )
void HalUARTPoll( void )
uint16 Hal_UART_RxBufLen( uint8 port )
其实仔细想想，这两个参数还是与串口的头和尾有关的。头又名开始，串口接收数据开始存放数据的指向；尾又名结束，是把串口数据取走用作他用的指向。rxHead=0，标示串口接收数据新的起点，新的开始；而rxTail=0，标示把串口接收到的数据全部取走用作他用，------结束。体现了串口数据从接收到被使用的整个过程。
uartConfig.rx.maxBufSize = SPI_MGR_DEFAULT_MAX_RX_BUFF;
在次有如下定义：
#define SPI_MGR_DEFAULT_MAX_RX_BUFF SPI_RX_BUFF_MAX
最后才找到其最终的东西：
#define SPI_RX_BUFF_MAX 128
cfg->rxBuf = osal_mem_alloc( cfg->rxMax+1 );
这里是在打开串口函数中的语句，就是为接收缓存分配存储空间。
osal_mem_free( cfg->rxBuf );