【RL-TCPnet网络教程】第21章 RL-TCPnet之高效的事件触发框架

第21章       RL-TCPnet之高效的事件触发框架

本章节为大家讲解高效的事件触发框架实现方法,BSD Socket编程和后面章节要讲解到的FTP、TFTP和HTTP等都非常适合使用这种方式。实际项目中也推荐大家采用这种方式,不过仅适用于RTOS环境,比如RTX、FreeRTOS或者uCOS-III均可,裸机方式不支持。

另外,前面章节讲解的TCP和UDP的原始socket使用这种方式不太方便,因为应用程序的编写会变的稍麻烦,不像BSD Socket那么省事。

21.1  初学者重要提示

21.2  高效的事件触发框架说明

21.3  RTX系统实例修改方法

21.4  uCOS-III系统实例修改方法

21.5  FreeRTOS系统实例修改方法

21.6  实验操作和实验例程说明

21.7  总结

21.1  初学者重要提示

  • 实际项目中强烈推荐大家采用这种方式,不过仅适用于RTOS环境,比如RTX、FreeRTOS或者uCOS-III均可。后面章节配套的例子,基本也都采用这种方式。
  • 前面章节讲解的TCP和UDP的原始socket使用这种方式不太方便,因为应用程序的编写会变的稍麻烦,不像BSD Socket这么省事。

21.2  高效的事件触发框架说明

讲解高效的事件触发框架之前,先看下没有使用事件触发方式时,ping的响应速度,以例程:V6-1024_RL-TCPnet实验_BSD Socket服务器之TCP(RTX)为例进行说明:

【RL-TCPnet网络教程】第21章 RL-TCPnet之高效的事件触发框架

下面是使用了事件触发方式时,ping的响应速度,以例程:V6-1030_RL-TCPnet实验_高效的事件触发框架(RTX)为例进行说明:

【RL-TCPnet网络教程】第21章 RL-TCPnet之高效的事件触发框架

从上面的两个响应速度的对比中,可以看出,使用了时间触发方式的例子,响应速度都在1ms以下,效果还是非常明显的。

前面章节配套的例子里面,响应速度慢,是因为我们都是周期性的调用RL-TCPnet的主处理函数main_TcpNet(),比如前面BSD Socket服务器章节配套的例子中:

/*

*********************************************************************************************************

*    函 数 名: AppTaskTCPMain

*    功能说明: RL-TCPnet网络主任务

*    形    参: 无

*    返 回 值: 无

*   优 先 级: 5 

*********************************************************************************************************

*/

__task void AppTaskTCPMain(void)

{

     while ()

     {

         /* RL-TCPnet处理函数 */

         main_TcpNet();

         os_dly_wait();

     }

}

这种方式有如下两个缺点:

  1. 没有网络通信时也要周期性的执行。
  2. 实时响应差,因为在延迟的这段时间内有网络数据包的话,数据包得不到及时的处理。

另外特别注意一点,一些不理解的读者会问,我们的底层函数里面不是有以太网中断吗,为什么还会不能实时性响应呢?根本的原因就在,虽然有以太网中断,但是中断后,RL-TCPent的主处理函数main_TcpNet()不能得到及时的执行,所以我们要解决的就是让主处理函数得到实时执行。

用户通过修改以下几个地方就可以实现:

  • 修改ETH_STM32F4xx.c文件中的函数send_frame。
  • 修改ETH_STM32F4xx.c文件中的以太网中断函数。
  • 修改RL-TCPnet的时间基准更新任务。
  • 修改RL-TCPnet的网络主任务,函数main_TcpNet的调用不再采用轮询方式,改成事件标志等待方式。

下面针对RTX、uCOS-III和FreeRTOS操作系统分别做讲解:

21.3  RTX系统实例修改方法

下面针对RTX系统要做的具体修改做个说明,我们以例程:V6-1024_RL-TCPnet实验_BSD Socket服务器之TCP(RTX)为例。通过修改函数send_frame,以太网中断和时间基准更新任务都给网络主任务发事件标志,让其得到实时执行,从而实现高效的事件触发框架。

21.3.1 修改函数send_frame

修改ETH_STM32F4xx.c文件中的函数send_frame,此函数的末尾添加事件标志函数os_evt_set(0x0001, HandleTaskTCPMain);

/*

*********************************************************************************************************

*    函 数 名: send_frame

*    功能说明: 传递数据帧给MAC DMA发送描述符,并使能发送。

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

extern OS_TID HandleTaskTCPMain;

void send_frame (OS_FRAME *frame)

{

     U32 *sp,*dp;

     U32 i,j;

     j = TxBufIndex;

     /* 等待上一帧数据发送完成 */

     while (Tx_Desc[j].CtrlStat & DMA_TX_OWN);

     sp = (U32 *)&frame->data[];

     dp = (U32 *)(Tx_Desc[j].Addr & ~);

     /* 复制要发送的数据到DMA发送描述符中 */

     for (i = (frame->length + ) >> ; i; i--)

     {

         *dp++ = *sp++;

     }

     /* 设置数据帧大小 */

     Tx_Desc[j].Size      = frame->length;

     /* 发送描述符由DMA控制发送 */

     Tx_Desc[j].CtrlStat |= DMA_TX_OWN;

     if (++j == NUM_TX_BUF) j = ;

     TxBufIndex = j;

     /* 开始帧传输 */

     /*

        DMASR 以太网 DMA 状态寄存器

        向ETH_DMASR寄存器[16:0]中的(未保留)位写入1会将其清零,写入 0 则不起作用。

        位1 TPSS:发送过程停止状态 (Transmit process stopped status)

                 当发送停止时,此位置 1。

     */

     ETH->DMASR   = DSR_TPSS;

     /*

        DMATPDR 以太网DMA发送轮询请求寄存器

       应用程序使用此寄存器来指示DMA轮询发送描述符列表。

       位 31:0 TPD:发送轮询请求(Transmit poll demand)

                    向这些位写入任何值时,DMA都会读取ETH_DMACHTDR寄存器指向的当前描述符。如果

                    该描述符不可用(由CPU所有),则发送会返回到挂起状态,并将ETH_DMASR寄存器位2

                    进行置位。如果该描述符可用,则发送会继续进行。      

     */

     ETH->DMATPDR = ;

     os_evt_set(0x0001, HandleTaskTCPMain);

}

21.3.2 修改以太网中断函数

修改ETH_STM32F4xx.c文件中的以太网中断函数,此函数的末尾添加事件标志函数:isr_evt_set(0x0001, HandleTaskTCPMain);

/*

*********************************************************************************************************

*    函 数 名: ETH_IRQHandler

*    功能说明: 以太网中断,主要处理从MAC DMA接收描述符接收到的数据帧以及错误标志的处理。

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

void ETH_IRQHandler (void)

{

     OS_FRAME *frame;

     U32 i, RxLen;

     U32 *sp,*dp;

     i = RxBufIndex;

     /* 循环所有接受描述符列表,遇到未接收到数据的退出循环 */

     do

     {

         /*

              #define DMA_RX_ERROR_MASK   (DMA_RX_ES | DMA_RX_LE | DMA_RX_RWT | \

                                              DMA_RX_RE | DMA_RX_CE)

              有错误,放弃此帧数据,错误类型包含如下:

              位15 DMA_RX_ES:错误汇总(Error summary),即CRC错误,接收错误,看门狗超时,延迟冲突等。

             位12 DMA_RX_LE:长度错误(Length error)

                             该位置1时,指示接收帧的实际长度与长度/类型字段的值不符。该字段仅在帧类

                             型位(RDES0[5])复位后有效。

              位4 DMA_RX_RWT:接收看门狗超时 (Receive watchdog timeout)

                             该位置1时,表示接收看门狗计时器在接收当前帧时超时,且当前帧在看门狗超

                             时后被截断了

              位3 DMA_RX_RE: 接收错误 (Receive error)

                            该位置1时,表示在帧接收期间,当发出RX_DV信号时,会发出RX_ERR信号。

              位1 DMA_RX_CE: CRC 错误(CRC error)

                            该位置1时,表示接收的帧发生循环冗余校验(CRC)错误。只有最后一个描述符

                             (RDES0[8])置1时,该字段才有效

         */

         if (Rx_Desc[i].Stat & DMA_RX_ERROR_MASK)

         {

              goto rel;

         }

          /*

              #define DMA_RX_SEG_MASK   (DMA_RX_FS | DMA_RX_LS)

             位9 FS:第一个描述符 (First descriptor)

                    该位置1时,指示此描述符包含帧的第一个缓冲区。如果第一个缓冲区的大小为0,则第二

                    个缓冲区将包含帧的帧头。如果第二个缓冲区的大小为0,则下一个描述符将包含帧的帧头。

             位8 LS:最后一个描述符 (Last descriptor)

                    该位置1时,指示此描述符指向的缓冲区为帧的最后一个缓冲区。

             下面的函数用于判断此帧数据是否只有一个缓冲,初始化接收描述符列表的时候,每个描述符仅设置了

             一个缓冲。

         */

         if ((Rx_Desc[i].Stat & DMA_RX_SEG_MASK) != DMA_RX_SEG_MASK)

         {

              goto rel;

         }

         RxLen = ((Rx_Desc[i].Stat >> ) & 0x3FFF) - ;

         if (RxLen > ETH_MTU)

         {

              /* 数据包太大,直接放弃 */

              goto rel;

         }

          /* 申请动态内存,RxLen或上0x80000000表示动态内存不足了不会调用函数sys_error() */

         frame = alloc_mem (RxLen | 0x80000000);

          /* 如果动态内存申请失败了,放弃此帧数据;成功了,通过函数put_in_queue存入队列中 */

         if (frame != NULL)

         {

              sp = (U32 *)(Rx_Desc[i].Addr & ~);

              dp = (U32 *)&frame->data[];

              for (RxLen = (RxLen + ) >> ; RxLen; RxLen--)

              {

                   *dp++ = *sp++;

              }

              put_in_queue (frame);

         }

          /* 设置此接收描述符继续接收新的数据 */

         rel: Rx_Desc[i].Stat = DMA_RX_OWN;

         if (++i == NUM_RX_BUF) i = ;

     }

     while (!(Rx_Desc[i].Stat & DMA_RX_OWN));

     RxBufIndex = i;

     /*

        DMASR DMA的状态寄存器(DMA status register)

        位7 RBUS:接收缓冲区不可用状态 (Receive buffer unavailable status)

                 此位指示接收列表中的下一个描述符由CPU所拥有,DMA无法获取。接收过程进入挂起状态。

                  要恢复处理接收描述符,CPU应更改描述符的拥有关系,然后发出接收轮询请求命令。如果

                  未发出接收轮询请求命令,则当接收到下一个识别的传入帧时,接收过程会恢复。仅当上一

                  接收描述符由DMA所拥有时,才能将ETH_DMASR[7]置1。

        DMAIER的接收缓冲区不可用中断RBUIE是bit7,对于的接收缓冲区不可用状态在DMA状态寄存器中也是bit7。

     */

     if (ETH->DMASR & INT_RBUIE)

     {

         /* 接收缓冲区不可用,重新恢复DMA传输 */

         ETH->DMASR = ETH_DMASR_RBUS;

         ETH->DMARPDR = ;

     }

     /*

        DMASR DMA的状态寄存器(DMA status register)

        这里实现清除中断挂起标志

        位16 ETH_DMASR_NIS:所有正常中断 (Normal interrupt summary)

        位15 ETH_DMASR_AIS:所有异常中断 (Abnormal interrupt summary)

        位6  ETH_DMASR_RS :接收状态 (Receive status)

                            此位指示帧接收已完成,具体的帧状态信息已经包含在描述符中,接收仍保持运行状态。

     */

     ETH->DMASR = ETH_DMASR_NIS | ETH_DMASR_AIS | ETH_DMASR_RS;

     isr_evt_set(0x0001, HandleTaskTCPMain);

}

21.3.3 修改RL-TCPnet的时间基准更新任务

修改RL-TCPnet的时间基准更新任务,添加事件标志函数os_evt_set(0x0001, HandleTaskTCPMain);

/*

*********************************************************************************************************

*    函 数 名: AppTaskStart

*    功能说明: 启动任务,也是最高优先级任务,这里实现RL-TCPnet的时间基准更新。

*    形    参: 无

*    返 回 值: 无

*   优 先 级: 6 

*********************************************************************************************************

*/

__task void AppTaskStart(void)

{

     /* 初始化RL-TCPnet */

     init_TcpNet ();

     /* 创建任务 */

     AppTaskCreate();

     os_itv_set ();

    while()

    {

         os_itv_wait ();

         /* RL-TCPnet时间基准更新函数 */

          timer_tick ();

         os_evt_set(0x0001, HandleTaskTCPMain);

    }

}

21.3.4 修改RL-TCPnet的网络主任务

修改RL-TCPnet的网络主任务,函数main_TcpNet的调用不再采用轮询方式,改成事件标志等待方式,即修改为如下形式:

/*

*********************************************************************************************************

*    函 数 名: AppTaskTCPMain

*    功能说明: RL-TCPnet网络主任务

*    形    参: 无

*    返 回 值: 无

*   优 先 级: 5 

*********************************************************************************************************

*/

__task void AppTaskTCPMain(void)

{

     while ()

     {

          /* RL-TCPnet处理函数 */

         os_evt_wait_and(0x0001, 0xFFFF);

         while (main_TcpNet() == __TRUE);

     }

}

21.3.5 最后特别注意优先级安排

最后,用户要特别注意几个任务的优先级安排,非常重要。

  • RL-TCPnet的时间基准更新任务一定要是最高优先级任务。
  • RL-TCPnet的网络主任务,即调用函数main_TcpNet的任务是次高优先级任务。
  • 应用层的任务要比前面两个任务的优先级都低。

21.4 uCOS-III系统实例修改方法

下面针对uCOS-III系统要做的具体修改做个说明,我们以例程:V6-1025_RL-TCPnet实验_BSD Socket服务器之TCP(uCOS-III)为例。通过修改函数send_frame,以太网中断和时间基准更新任务都给网络主任务发事件标志,让其得到实时执行,从而实现高效的事件触发框架。

21.4.1 创建事件标志组

创建uCOS-III的事件标志组:

OS_FLAG_GRP        FLAG_TCPnet;

/*

*********************************************************************************************************

*    函 数 名: AppObjCreate

*    功能说明: 创建任务通讯

*    形    参: p_arg 是在创建该任务时传递的形参

*    返 回 值: 无

*********************************************************************************************************

*/

static  void  AppObjCreate (void)

{

     OS_ERR      err;

     /* 创建事件标志组 */

     OSFlagCreate ((OS_FLAG_GRP  *)&FLAG_TCPnet,

                  (CPU_CHAR     *)"FLAG TCPnet",

                  (OS_FLAGS      ),

                  (OS_ERR       *)&err);

}

21.4.2 修改函数send_frame

修改ETH_STM32F4xx.c文件中的函数send_frame,此函数的末尾添加事件标志函数OSFlagPost(宏定义uCOS_EN在bsp.h文件里面使能,针对教程配套例子做的定义,方便管理。大家自己搞时,不必受此限制)。

/*

*********************************************************************************************************

*    函 数 名: send_frame

*    功能说明: 传递数据帧给MAC DMA发送描述符,并使能发送。

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

void send_frame (OS_FRAME *frame)

{

     U32 *sp,*dp;

     U32 i,j;

#if uCOS_EN == 1

     OS_ERR  err;

#endif

     j = TxBufIndex;

     /* 等待上一帧数据发送完成 */

     while (Tx_Desc[j].CtrlStat & DMA_TX_OWN);

     sp = (U32 *)&frame->data[];

     dp = (U32 *)(Tx_Desc[j].Addr & ~);

     /* 复制要发送的数据到DMA发送描述符中 */

     for (i = (frame->length + ) >> ; i; i--)

     {

         *dp++ = *sp++;

     }

     /* 设置数据帧大小 */

     Tx_Desc[j].Size      = frame->length;

     /* 发送描述符由DMA控制发送 */

     Tx_Desc[j].CtrlStat |= DMA_TX_OWN;

     if (++j == NUM_TX_BUF) j = ;

     TxBufIndex = j;

     /* 开始帧传输 */

     /*

        DMASR 以太网 DMA 状态寄存器

        向ETH_DMASR寄存器[16:0]中的(未保留)位写入1会将其清零,写入 0 则不起作用。

        位1 TPSS:发送过程停止状态 (Transmit process stopped status)

                 当发送停止时,此位置 1。

     */

     ETH->DMASR   = DSR_TPSS;

     /*

        DMATPDR 以太网DMA发送轮询请求寄存器

       应用程序使用此寄存器来指示DMA轮询发送描述符列表。

       位 31:0 TPD:发送轮询请求(Transmit poll demand)

                    向这些位写入任何值时,DMA都会读取ETH_DMACHTDR寄存器指向的当前描述符。如果

                    该描述符不可用(由CPU所有),则发送会返回到挂起状态,并将ETH_DMASR寄存器位2

                    进行置位。如果该描述符可用,则发送会继续进行。      

     */

     ETH->DMATPDR = ;

#if uCOS_EN == 1

     OSFlagPost ((OS_FLAG_GRP  *)&FLAG_TCPnet,

                   (OS_FLAGS      )0x0001,

                   (OS_OPT        )OS_OPT_POST_FLAG_SET,

                   (OS_ERR       *)&err);

#endif  

}

21.4.3 修改以太网中断函数

修改ETH_STM32F4xx.c文件中的以太网中断函数,此函数的末尾添加事件标志函数:OSFlagPost(宏定义uCOS_EN在bsp.h文件里面使能,针对教程配套例子做的定义,方便管理。大家自己搞时,不必受此限制)。

/*

*********************************************************************************************************

*    函 数 名: ETH_IRQHandler

*    功能说明: 以太网中断,主要处理从MAC DMA接收描述符接收到的数据帧以及错误标志的处理。

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

void ETH_IRQHandler (void)

{

     OS_FRAME *frame;

     U32 i, RxLen;

     U32 *sp,*dp;

#if uCOS_EN == 1

     OS_ERR  err;

     CPU_SR_ALLOC();

     CPU_CRITICAL_ENTER();

     OSIntEnter();                        

     CPU_CRITICAL_EXIT();

#endif

     i = RxBufIndex;

     /* 循环所有接受描述符列表,遇到未接收到数据的退出循环 */

     do

     {

         /*

              #define DMA_RX_ERROR_MASK   (DMA_RX_ES | DMA_RX_LE | DMA_RX_RWT | \

                                              DMA_RX_RE | DMA_RX_CE)

              有错误,放弃此帧数据,错误类型包含如下:

              位15 DMA_RX_ES:错误汇总(Error summary),即CRC错误,接收错误,看门狗超时,延迟冲突等。

             位12 DMA_RX_LE:长度错误(Length error)

                             该位置1时,指示接收帧的实际长度与长度/类型字段的值不符。该字段仅在帧类

                             型位(RDES0[5])复位后有效。

              位4 DMA_RX_RWT:接收看门狗超时 (Receive watchdog timeout)

                             该位置1时,表示接收看门狗计时器在接收当前帧时超时,且当前帧在看门狗超

                             时后被截断了

              位3 DMA_RX_RE: 接收错误 (Receive error)

                            该位置1时,表示在帧接收期间,当发出RX_DV信号时,会发出RX_ERR信号。

              位1 DMA_RX_CE: CRC 错误(CRC error)

                            该位置1时,表示接收的帧发生循环冗余校验(CRC)错误。只有最后一个描述符

                             (RDES0[8])置1时,该字段才有效

         */

         if (Rx_Desc[i].Stat & DMA_RX_ERROR_MASK)

         {

              goto rel;

         }

          /*

              #define DMA_RX_SEG_MASK   (DMA_RX_FS | DMA_RX_LS)

             位9 FS:第一个描述符 (First descriptor)

                    该位置1时,指示此描述符包含帧的第一个缓冲区。如果第一个缓冲区的大小为0,则第二

                    个缓冲区将包含帧的帧头。如果第二个缓冲区的大小为0,则下一个描述符将包含帧的帧头。

             位8 LS:最后一个描述符 (Last descriptor)

                    该位置1时,指示此描述符指向的缓冲区为帧的最后一个缓冲区。

             下面的函数用于判断此帧数据是否只有一个缓冲,初始化接收描述符列表的时候,每个描述符仅设置了

             一个缓冲。

         */

         if ((Rx_Desc[i].Stat & DMA_RX_SEG_MASK) != DMA_RX_SEG_MASK)

         {

              goto rel;

         }

         RxLen = ((Rx_Desc[i].Stat >> ) & 0x3FFF) - ;

         if (RxLen > ETH_MTU)

         {

              /* 数据包太大,直接放弃 */

              goto rel;

         }

          /* 申请动态内存,RxLen或上0x80000000表示动态内存不足了不会调用函数sys_error() */

         frame = alloc_mem (RxLen | 0x80000000);

          /* 如果动态内存申请失败了,放弃此帧数据;成功了,通过函数put_in_queue存入队列中 */

         if (frame != NULL)

         {

              sp = (U32 *)(Rx_Desc[i].Addr & ~);

              dp = (U32 *)&frame->data[];

              for (RxLen = (RxLen + ) >> ; RxLen; RxLen--)

              {

                   *dp++ = *sp++;

              }

              put_in_queue (frame);

         }

          /* 设置此接收描述符继续接收新的数据 */

         rel: Rx_Desc[i].Stat = DMA_RX_OWN;

         if (++i == NUM_RX_BUF) i = ;

     }

     while (!(Rx_Desc[i].Stat & DMA_RX_OWN));

     RxBufIndex = i;

     /*

        DMASR DMA的状态寄存器(DMA status register)

        位7 RBUS:接收缓冲区不可用状态 (Receive buffer unavailable status)

                 此位指示接收列表中的下一个描述符由CPU所拥有,DMA无法获取。接收过程进入挂起状态。

                  要恢复处理接收描述符,CPU应更改描述符的拥有关系,然后发出接收轮询请求命令。如果

                  未发出接收轮询请求命令,则当接收到下一个识别的传入帧时,接收过程会恢复。仅当上一

                  接收描述符由DMA所拥有时,才能将ETH_DMASR[7]置1。

        DMAIER的接收缓冲区不可用中断RBUIE是bit7,对于的接收缓冲区不可用状态在DMA状态寄存器中也是bit7。

     */

     if (ETH->DMASR & INT_RBUIE)

     {

         /* 接收缓冲区不可用,重新恢复DMA传输 */

         ETH->DMASR = ETH_DMASR_RBUS;

         ETH->DMARPDR = ;

     }

     /*

        DMASR DMA的状态寄存器(DMA status register)

        这里实现清除中断挂起标志

        位16 ETH_DMASR_NIS:所有正常中断 (Normal interrupt summary)

        位15 ETH_DMASR_AIS:所有异常中断 (Abnormal interrupt summary)

        位6  ETH_DMASR_RS :接收状态 (Receive status)

                            此位指示帧接收已完成,具体的帧状态信息已经包含在描述符中,接收仍保持运行状态。

     */

     ETH->DMASR = ETH_DMASR_NIS | ETH_DMASR_AIS | ETH_DMASR_RS;

#if uCOS_EN == 1

     OSFlagPost ((OS_FLAG_GRP  *)&FLAG_TCPnet,

                   (OS_FLAGS      )0x0001,

                   (OS_OPT        )OS_OPT_POST_FLAG_SET,

                   (OS_ERR       *)&err);

     OSIntExit();                          

#endif

}

21.4.4 修改RL-TCPnet的时间基准更新任务

修改RL-TCPnet的时间基准更新任务,添加事件标志函数:OSFlagPost。

/*

*********************************************************************************************************

*    函 数 名: AppTaskStart

*    功能说明: 这是一个启动任务,在多任务系统启动后,必须初始化滴答计数器。本任务主要实现RL-TCPnet的时间

*             基准更新。

*    形    参: p_arg 是在创建该任务时传递的形参

*    返 回 值: 无

     优 先 级: 2

*********************************************************************************************************

*/

static  void  AppTaskStart (void *p_arg)

{

     OS_ERR      err;

   (void)p_arg;

     CPU_Init();    /* 此函数要优先调用,因为外设驱动中使用的us和ms延迟是基于此函数的 */

     bsp_Init();  

     init_TcpNet ();/* 初始化RL-TCPnet */

     BSP_Tick_Init();

#if OS_CFG_STAT_TASK_EN > 0u

     OSStatTaskCPUUsageInit(&err);  

#endif

#ifdef CPU_CFG_INT_DIS_MEAS_EN

    CPU_IntDisMeasMaxCurReset();

#endif

     /* 创建任务 */

    AppTaskCreate();

     /* 创建任务间通信机制 */

     AppObjCreate();   

    while ()

     { 

         /* RL-TCPnet时间基准更新函数 */

         timer_tick ();

         OSFlagPost ((OS_FLAG_GRP  *)&FLAG_TCPnet,

                       (OS_FLAGS      )0x0001,

                       (OS_OPT        )OS_OPT_POST_FLAG_SET,

                       (OS_ERR       *)&err); 

         OSTimeDly(, OS_OPT_TIME_PERIODIC, &err);

    }

}

21.4.5 修改RL-TCPnet的网络主任务

修改RL-TCPnet的网络主任务,函数main_TcpNet的调用不再采用轮询方式,改成事件标志等待方式,即修改为如下形式:

/*

*********************************************************************************************************

*    函 数 名: AppTaskTCPnet

*    功能说明: RL-TCPnet网络主任务

*    形    参: p_arg 是在创建该任务时传递的形参

*    返 回 值: 无

     优 先 级: 3

*********************************************************************************************************

*/

static void AppTaskTCPnet(void *p_arg)

{

     OS_ERR  err; 

     CPU_TS   ts; 

     (void)p_arg;

     while()

     {

         /* RL-TCPnet处理函数 */

         OSFlagPend ((OS_FLAG_GRP  *)&FLAG_TCPnet,

                       (OS_FLAGS      )0x0001,

                       (OS_TICK       ),

                       (OS_OPT        )OS_OPT_PEND_FLAG_SET_ANY + OS_OPT_PEND_FLAG_CONSUME,

                       (CPU_TS       *)&ts,

                       (OS_ERR       *)&err);

         while (main_TcpNet() == __TRUE);

     }  

}

21.4.6 最后特别注意优先级安排

最后,用户要特别注意几个任务的优先级安排,非常重要。

  • RL-TCPnet的时间基准更新任务一定要是最高优先级任务。
  • RL-TCPnet的网络主任务,即调用函数main_TcpNet的任务是次高优先级任务。
  • 应用层的任务要比前面两个任务的优先级都低。

21.5 FreeRTOS系统实例修改方法

下面针对FreeRTOS系统要做的具体修改做个说明,我们以例程:V6-1026_RL-TCPnet实验_BSD Socket服务器之TCP(FreeRTOS)为例。通过修改函数send_frame,以太网中断和时间基准更新任务都给网络主任务发事件标志,让其得到实时执行,从而实现高效的事件触发框架。

21.5.1 创建事件标志组

创建FreeRTOS的事件标志组:

EventGroupHandle_t xCreatedTCPnetGroup = NULL;

/*

*********************************************************************************************************

*    函 数 名: AppObjCreate

*    功能说明: 创建任务通信机制

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

static void AppObjCreate (void)

{   

     /* 创建事件标志组 */

     xCreatedTCPnetGroup = xEventGroupCreate();

     if(xCreatedTCPnetGroup == NULL)

    {

        /* 没有创建成功,用户可以在这里加入创建失败的处理机制 */

    }

}

21.5.2 修改函数send_frame

修改ETH_STM32F4xx.c文件中的函数send_frame,此函数的末尾添加事件标志函数xEventGroupSetBits(宏定义FreeRTOS_EN在bsp.h文件里面使能,针对教程配套例子做的定义,方便管理。大家自己搞时,不必受此限制)。

/*

*********************************************************************************************************

*    函 数 名: send_frame

*    功能说明: 传递数据帧给MAC DMA发送描述符,并使能发送。

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

void send_frame (OS_FRAME *frame)

{

     U32 *sp,*dp;

     U32 i,j;

     j = TxBufIndex;

     /* 等待上一帧数据发送完成 */

     while (Tx_Desc[j].CtrlStat & DMA_TX_OWN);

     sp = (U32 *)&frame->data[];

     dp = (U32 *)(Tx_Desc[j].Addr & ~);

     /* 复制要发送的数据到DMA发送描述符中 */

     for (i = (frame->length + ) >> ; i; i--)

     {

         *dp++ = *sp++;

     }

     /* 设置数据帧大小 */

     Tx_Desc[j].Size      = frame->length;

     /* 发送描述符由DMA控制发送 */

     Tx_Desc[j].CtrlStat |= DMA_TX_OWN;

     if (++j == NUM_TX_BUF) j = ;

     TxBufIndex = j;

     /* 开始帧传输 */

     /*

        DMASR 以太网 DMA 状态寄存器

        向ETH_DMASR寄存器[16:0]中的(未保留)位写入1会将其清零,写入 0 则不起作用。

        位1 TPSS:发送过程停止状态 (Transmit process stopped status)

                 当发送停止时,此位置 1。

     */

     ETH->DMASR   = DSR_TPSS;

     /*

        DMATPDR 以太网DMA发送轮询请求寄存器

       应用程序使用此寄存器来指示DMA轮询发送描述符列表。

       位 31:0 TPD:发送轮询请求(Transmit poll demand)

                    向这些位写入任何值时,DMA都会读取ETH_DMACHTDR寄存器指向的当前描述符。如果

                    该描述符不可用(由CPU所有),则发送会返回到挂起状态,并将ETH_DMASR寄存器位2

                    进行置位。如果该描述符可用,则发送会继续进行。      

     */

     ETH->DMATPDR = ;

#if USE_FreeRTOS == 1

     xEventGroupSetBits(xCreatedTCPnetGroup, 0x0001);

#endif

}

21.5.3 修改以太网中断函数

修改ETH_STM32F4xx.c文件中的以太网中断函数,此函数的末尾添加事件标志函数:xEventGroupSetBitsFromISR(宏定义FreeRTOS_EN在bsp.h文件里面使能,针对教程配套例子做的定义,方便管理。大家自己搞时,不必受此限制)。

/*

*********************************************************************************************************

*    函 数 名: ETH_IRQHandler

*    功能说明: 以太网中断,主要处理从MAC DMA接收描述符接收到的数据帧以及错误标志的处理。

*    形    参: 无

*    返 回 值: 无

*********************************************************************************************************

*/

void ETH_IRQHandler (void)

{

     OS_FRAME *frame;

     U32 i, RxLen;

     U32 *sp,*dp;

     i = RxBufIndex;

#if USE_FreeRTOS == 1

     BaseType_t xResult;

     BaseType_t xHigherPriorityTaskWoken = pdFALSE;

#endif

     /* 循环所有接受描述符列表,遇到未接收到数据的退出循环 */

     do

     {

         /*

              #define DMA_RX_ERROR_MASK   (DMA_RX_ES | DMA_RX_LE | DMA_RX_RWT | \

                                              DMA_RX_RE | DMA_RX_CE)

              有错误,放弃此帧数据,错误类型包含如下:

              位15 DMA_RX_ES:错误汇总(Error summary),即CRC错误,接收错误,看门狗超时,延迟冲突等。

             位12 DMA_RX_LE:长度错误(Length error)

                             该位置1时,指示接收帧的实际长度与长度/类型字段的值不符。该字段仅在帧类

                             型位(RDES0[5])复位后有效。

              位4 DMA_RX_RWT:接收看门狗超时 (Receive watchdog timeout)

                             该位置1时,表示接收看门狗计时器在接收当前帧时超时,且当前帧在看门狗超

                             时后被截断了

              位3 DMA_RX_RE: 接收错误 (Receive error)

                            该位置1时,表示在帧接收期间,当发出RX_DV信号时,会发出RX_ERR信号。

              位1 DMA_RX_CE: CRC 错误(CRC error)

                            该位置1时,表示接收的帧发生循环冗余校验(CRC)错误。只有最后一个描述符

                             (RDES0[8])置1时,该字段才有效

         */

         if (Rx_Desc[i].Stat & DMA_RX_ERROR_MASK)

         {

              goto rel;

         }

          /*

              #define DMA_RX_SEG_MASK   (DMA_RX_FS | DMA_RX_LS)

             位9 FS:第一个描述符 (First descriptor)

                    该位置1时,指示此描述符包含帧的第一个缓冲区。如果第一个缓冲区的大小为0,则第二

                    个缓冲区将包含帧的帧头。如果第二个缓冲区的大小为0,则下一个描述符将包含帧的帧头。

             位8 LS:最后一个描述符 (Last descriptor)

                    该位置1时,指示此描述符指向的缓冲区为帧的最后一个缓冲区。

             下面的函数用于判断此帧数据是否只有一个缓冲,初始化接收描述符列表的时候,每个描述符仅设置了

             一个缓冲。

         */

         if ((Rx_Desc[i].Stat & DMA_RX_SEG_MASK) != DMA_RX_SEG_MASK)

         {

              goto rel;

         }

         RxLen = ((Rx_Desc[i].Stat >> ) & 0x3FFF) - ;

         if (RxLen > ETH_MTU)

         {

              /* 数据包太大,直接放弃 */

              goto rel;

         }

          /* 申请动态内存,RxLen或上0x80000000表示动态内存不足了不会调用函数sys_error() */

         frame = alloc_mem (RxLen | 0x80000000);

          /* 如果动态内存申请失败了,放弃此帧数据;成功了,通过函数put_in_queue存入队列中 */

         if (frame != NULL)

         {

              sp = (U32 *)(Rx_Desc[i].Addr & ~);

              dp = (U32 *)&frame->data[];

              for (RxLen = (RxLen + ) >> ; RxLen; RxLen--)

              {

                   *dp++ = *sp++;

              }

              put_in_queue (frame);

         }

          /* 设置此接收描述符继续接收新的数据 */

         rel: Rx_Desc[i].Stat = DMA_RX_OWN;

         if (++i == NUM_RX_BUF) i = ;

     }

     while (!(Rx_Desc[i].Stat & DMA_RX_OWN));

     RxBufIndex = i;

     /*

        DMASR DMA的状态寄存器(DMA status register)

        位7 RBUS:接收缓冲区不可用状态 (Receive buffer unavailable status)

                 此位指示接收列表中的下一个描述符由CPU所拥有,DMA无法获取。接收过程进入挂起状态。

                  要恢复处理接收描述符,CPU应更改描述符的拥有关系,然后发出接收轮询请求命令。如果

                  未发出接收轮询请求命令,则当接收到下一个识别的传入帧时,接收过程会恢复。仅当上一

                  接收描述符由DMA所拥有时,才能将ETH_DMASR[7]置1。

        DMAIER的接收缓冲区不可用中断RBUIE是bit7,对于的接收缓冲区不可用状态在DMA状态寄存器中也是bit7。

     */

     if (ETH->DMASR & INT_RBUIE)

     {

         /* 接收缓冲区不可用,重新恢复DMA传输 */

         ETH->DMASR = ETH_DMASR_RBUS;

         ETH->DMARPDR = ;

     }

     /*

        DMASR DMA的状态寄存器(DMA status register)

        这里实现清除中断挂起标志

        位16 ETH_DMASR_NIS:所有正常中断 (Normal interrupt summary)

        位15 ETH_DMASR_AIS:所有异常中断 (Abnormal interrupt summary)

        位6  ETH_DMASR_RS :接收状态 (Receive status)

                            此位指示帧接收已完成,具体的帧状态信息已经包含在描述符中,接收仍保持运行状态。

     */

     ETH->DMASR = ETH_DMASR_NIS | ETH_DMASR_AIS | ETH_DMASR_RS;

#if USE_FreeRTOS == 1

     xResult = xEventGroupSetBitsFromISR(xCreatedTCPnetGroup, /* 事件标志组句柄 */

                                              0x0001,              /* 设置bit0 */

                                              &xHigherPriorityTaskWoken );

     /* 消息被成功发出 */

     if( xResult != pdFAIL )

     {

         /* 如果xHigherPriorityTaskWoken = pdTRUE,那么退出中断后切到当前最高优先级任务执行 */

         portYIELD_FROM_ISR(xHigherPriorityTaskWoken);

     }

#endif

}

21.5.4 修改RL-TCPnet的时间基准更新任务

修改RL-TCPnet的时间基准更新任务,添加事件标志函数:xEventGroupSetBits。

/*

*********************************************************************************************************

*    函 数 名: vTaskStart

*    功能说明: 启动任务,也是最高优先级任务,这里实现RL-TCPnet的时间基准更新

*    形    参: pvParameters 是在创建该任务时传递的形参

*    返 回 值: 无

*   优 先 级: 6 

*********************************************************************************************************

*/

static void vTaskStart(void *pvParameters)

{

     TickType_t xLastWakeTime;

     const TickType_t xFrequency = ;

     /* 初始化RL-TCPnet */

     init_TcpNet ();

     /* 获取当前的系统时间 */

    xLastWakeTime = xTaskGetTickCount();

    while()

    {   

         /* RL-TCPnet时间基准更新函数 */

         timer_tick ();

         xEventGroupSetBits(xCreatedTCPnetGroup, 0x0001);

         /* vTaskDelayUntil是绝对延迟,vTaskDelay是相对延迟。*/

        vTaskDelayUntil(&xLastWakeTime, xFrequency);

    }

}

21.5.5 修改RL-TCPnet的网络主任务

修改RL-TCPnet的网络主任务,函数main_TcpNet的调用不再采用轮询方式,改成事件标志等待方式,即修改为如下形式:

/*

*********************************************************************************************************

*    函 数 名: vTaskTCPnet

*    功能说明: RL-TCPnet网络主任务

*    形    参: pvParameters 是在创建该任务时传递的形参

*    返 回 值: 无

*   优 先 级: 5 

*********************************************************************************************************

*/

static void vTaskTCPnet(void *pvParameters)

{

    while()

    {

         /* RL-TCPnet处理函数 */

         xEventGroupWaitBits(xCreatedTCPnetGroup, /* 事件标志组句柄 */

                                 0x0001,             /* 等待被设置 */

                                 pdTRUE,             /* 退出前bit0被清除 */

                                 pdFALSE,            /* 设置为pdFALSE表示仅等待bit0被设置*/

                                 portMAX_DELAY);     /* 永久等待 */

         while (main_TcpNet() == __TRUE);

    }

}

21.5.6 最后特别注意优先级安排

最后,用户要特别注意几个任务的优先级安排,非常重要。

  • RL-TCPnet的时间基准更新任务一定要是最高优先级任务。
  • RL-TCPnet的网络主任务,即调用函数main_TcpNet的任务是次高优先级任务。
  • 应用层的任务要比前面两个任务的优先级都低。

21.6 实验操作和实验例程说明

21.6.1 STM32F407开发板实验

由于本章节配套的例子是由第19章的例子简单修改而来的,所以操作说明和例程说明,直接看第19章即可。不同的地方仅仅是使能了本章节讲解的事件触发方式,本章节配套了如下三个例子:

【RL-TCPnet网络教程】第21章 RL-TCPnet之高效的事件触发框架

21.6.2 STM32F429开发板实验

由于本章节配套的例子是由第19章的例子简单修改而来的,所以操作说明和例程说明,直接看第19章即可。不同的地方仅仅是使能了本章节讲解的事件触发方式,本章节配套了如下三个例子:

【RL-TCPnet网络教程】第21章 RL-TCPnet之高效的事件触发框架

21.7 总结

本章节的项目实战性很高,望初学者务必掌握,在实际项目中也推荐采用事件触发方式。

上一篇:机器学习算法GBDT


下一篇:Android-应用的本地化及知识拓展之配置修饰符