如何将ThreadX移植到STM32平台

发布时间:2023-09-25  

现在一些小型系统中也往往有多任务处理的需求,这就为实时操作系统提供了用武之地。事实上国内外各种各样的RTOS有很多,而且基本都在走开源的路线,ThreadX也不例外,在这一篇中我们就来学习ThreadX初步应用并将其移植到STM32平台中。


1 、前期准备

在开始将ThreadX一直到STM32平台之间我们需要做一些前期准备。首先我们需要准备一个硬件平台,这次我们采用STM32F407IG控制单元来作为目标平台。其次我们需要准备一个该硬件平台下可以正常运行的裸机项目。这两点其实我们都已经具备了。


最主要的我们需要获得ThreadX的源码,这是我们移植它的基础。ThreadX的源码已经开源到Github上,其地址为:https://github.com/azure-rtos/threadx,直接下载源码就可以了。目前发布的最新版本是6.0.1,在我们的移植中我们使用6.0.0的版本来实现。


2 、系统移植

首先我们先来了解一下获得的ThreadX源码。解压下载下来的压缩包,其包含有以下文件及文件夹,我们先来具体看一看都有哪些文件,如下图

上图中一目了然,无需做太多解释。我们需要用到的文件主要存放在common文件夹和ports文件夹。其中common文件夹存放的是内核源码,ports文件夹存放的是不同平台的接口文件。我们的硬件采用的是STM32F407IG,软件开发环境用的是IAR EWARM,所以我们选择ports文件夹下cortex_m4下的IAR文件夹中的接口文件。


接下来我们需要在项目中添加ThreadX的相关源码文件。所以我们在项目下添加ThreadX组、并在ThreadX组下添加Source和Ports两个组用于添加文件。并将common文件夹和ports文件夹中的文件添加到对应的分组。如下所示:

然后要在项目属性中为编译器指定头文件的引用路径,主要是内核函数的头文件以及接口文件的头文件两个路径,在我们这个项目中配置如下:


PROJ_DIR....ThreadXcommoninc


PROJ_DIR....ThreadXportscortex_m4iarinc


事实上到这了,我们已经完成了对ThreadX内核文件以及接口文件的移植,但现在ThreadX不会运行,我们还需要做一些工作。我们要将内核与主函数联系起来,首先我们要在调用内核的地方添加头文件“tx_api.h”,我们这里将其添加到主函数文件中。


然后有两个函数我们需要处理,分别是:tx_kernel_enter和tx_application_define,这两个函数在头文件“tx_api.h”中被声明。tx_kernel_enter实际是一个宏,真正的函数是_tx_initialize_kernel_enter,用于启动内核,这个函数需要我们在主函数中调用。而tx_application_define函数只有声明没有实现,在_tx_initialize_kernel_enter函数中被调用,用于任务的创建。这个函数的实现是我们的主要工作,后续将详细说明。


3 、任务实现


我们已经说过了tx_application_define用于任务的创建,它的具体内容需要我们来实现,接下来我们就来实现tx_application_define这个函数。


我们先来规划一下我们将要实现的内容。我们计划实现5个任务,包括启动任务、红灯闪烁任务、绿灯闪烁任务、空闲任务及统计任务。其中为启动任务用于初始化一些配置并执行一些如系统心跳、看门狗之类的工作;用于红灯闪烁任务和绿灯闪烁任务用于实现我们要操作的指示灯控制;空闲任务在其他任务不运行时其运行,优先级最低。统计任务再次我们实现系统空闲率的统计。接下来我们就按此思路来实现之。


/*tx_application_define函数实现*/

void tx_application_define(void *first_unused_memory)

{

 /**************创建启动任务*********************/

 tx_thread_create(&AppTaskStartTCB,              /* 任务控制块地址 */  

               "App Task Start",             /* 任务名 */

               AppTaskStart,                  /* 启动任务函数地址 */

               0,                             /* 传递给任务的参数 */

               &AppTaskStartStk[0],           /* 堆栈基地址 */

               APP_CFG_TASK_START_STK_SIZE,  /* 堆栈空间大小 */ 

               APP_CFG_TASK_START_PRIO,      /* 任务优先级*/

               APP_CFG_TASK_START_PRIO,      /* 任务抢占阀值 */

               TX_NO_TIME_SLICE,              /* 不开启时间片 */

               TX_AUTO_START);                /* 创建后立即启动 */

 

 /**************创建红灯闪烁任务*********************/

 tx_thread_create(&AppTaskRedLedTCB,           /* 任务控制块地址 */

               "App Msp Pro",                /* 任务名 */

               AppTaskRedLED,              /* 启动任务函数地址 */

               0,                           /* 传递给任务的参数 */

               &AppTaskMsgProStk[0],       /* 堆栈基地址 */

               APP_CFG_TASK_RedLED_STK_SIZE,  /* 堆栈空间大小 */

               APP_CFG_TASK_REDLED_PRIO,      /* 任务优先级*/

               APP_CFG_TASK_REDLED_PRIO,     /* 任务抢占阀值 */

               TX_NO_TIME_SLICE,               /*不开启时间片 */

               TX_AUTO_START);                /* 创建后立即启动 */

 

 /**************创建绿灯闪烁任务*********************/

 tx_thread_create(&AppTaskGreenLEDTCB,        /* 任务控制块地址 */

               "App Task UserIF",             /* 任务名 */

               AppTaskGreenLED,             /* 启动任务函数地址 */

               0,                         /* 传递给任务的参数 */

               &AppTaskUserIFStk[0],        /* 堆栈基地址 */

               APP_CFG_TASK_GreenLED_STK_SIZE, /* 堆栈空间大小 */

               APP_CFG_TASK_GREENLED_PRIO,     /* 任务优先级*/

               APP_CFG_TASK_GREENLED_PRIO,   /* 任务抢占阀值 */

               TX_NO_TIME_SLICE,               /*不开启时间片 */

               TX_AUTO_START);             /* 创建后立即启动 */

 

 /**************创建统计任务*********************/

 tx_thread_create(&AppTaskStatTCB,               /* 任务控制块地址 */   

                  "App Task STAT",             /* 任务名 */

                  AppTaskStat,                  /* 启动任务函数地址 */

                  0,                           /* 传递给任务的参数 */

                  &AppTaskStatStk[0],          /* 堆栈基地址 */

                  APP_CFG_TASK_STAT_STK_SIZE,  /* 堆栈空间大小 */ 

                  APP_CFG_TASK_STAT_PRIO,      /* 任务优先级*/

                  APP_CFG_TASK_STAT_PRIO,     /* 任务抢占阀值 */

                  TX_NO_TIME_SLICE,            /* 不开启时间片 */

                  TX_AUTO_START);             /* 创建后立即启动 */

 

 /**************创建空闲任务*********************/

 tx_thread_create(&AppTaskIdleTCB,               /* 任务控制块地址 */   

                  "App Task IDLE",             /* 任务名 */

                  AppTaskIDLE,               /* 启动任务函数地址 */

                  0,                          /* 传递给任务的参数 */

                  &AppTaskIdleStk[0],         /* 堆栈基地址 */

                  APP_CFG_TASK_IDLE_STK_SIZE,  /* 堆栈空间大小 */

                  APP_CFG_TASK_IDLE_PRIO,       /* 任务优先级*/

                  APP_CFG_TASK_IDLE_PRIO,     /* 任务抢占阀值 */

                  TX_NO_TIME_SLICE,           /* 不开启时间片 */

                  TX_AUTO_START);            /* 创建后立即启动 */

}

我们实现了tx_application_define函数,在其中创建了任务,理所当然我们还需要实现相应的任务函数。


/*系统启动任务*/

static void  AppTaskStart (ULONGthread_input)

{

 (void)thread_input;

 

  /* 任务统计前先挂起其它任务 */

 tx_thread_suspend(&AppTaskRedLedTCB);

 tx_thread_suspend(&AppTaskGreenLEDTCB);

 

 OSStatInit();

 

  /* 任务统计完毕后,恢复其它任务 */      

 tx_thread_resume(&AppTaskRedLedTCB);

 tx_thread_resume(&AppTaskGreenLEDTCB);

 

  /* 内核开启后,恢复HAL里的时间基准 */

 HAL_ResumeTick();

 

  while (1)

  { 

   sysHeartBeat++;

   tx_thread_sleep(1000);

  }

}

 

/*红灯闪烁控制*/

static void AppTaskRedLED(ULONG thread_input)

{

 (void)thread_input;

 

  while(1)

  {

   HAL_GPIO_TogglePin(GPIOI,GPIO_PIN_8);

   tx_thread_sleep(500);

  }  

}

 

/*绿灯闪烁控制*/

static void AppTaskGreenLED(ULONG thread_input)

{

 (void)thread_input;

 

  while(1)

  {       

   

   HAL_GPIO_TogglePin(GPIOC,GPIO_PIN_13);

   tx_thread_sleep(2000);

  }

}

 

/*统计任务函数*/

static void AppTaskStat(ULONG thread_input)

{

 (void)thread_input;

 

  while(OSStatRdy == false)

  {

   tx_thread_sleep(200);     /* 等待统计任务就绪 */

  }

 

 OSIdleCtrMax /= 100uL;

  if(OSIdleCtrMax == 0uL)

  {

   OSCPUUsage = 0u;

  }

 

  OSIdleCtr= OSIdleCtrMax * 100uL;  /* 设置初始CPU利用率 0% */

 

  for (;;)

  {

   OSIdleCtrRun = OSIdleCtr;    /* 获得100ms内空闲计数 */

   OSIdleCtr    = 0uL;          /* 复位空闲计数 */

文章来源于:电子工程世界    原文链接
本站所有转载文章系出于传递更多信息之目的,且明确注明来源,不希望被转载的媒体或个人可与我们联系,我们将立即进行删除处理。

我们与500+贴片厂合作,完美满足客户的定制需求。为品牌提供定制化的推广方案、专属产品特色页,多渠道推广,SEM/SEO精准营销以及与公众号的联合推广...详细>>

利用葫芦芯平台的卓越技术服务和新产品推广能力,原厂代理能轻松打入消费物联网(IOT)、信息与通信(ICT)、汽车及新能源汽车、工业自动化及工业物联网、装备及功率电子...详细>>

充分利用其强大的电子元器件采购流量,创新性地为这些物料提供了一个全新的窗口。我们的高效数字营销技术,不仅可以助你轻松识别与连接到需求方,更能够极大地提高“闲置物料”的处理能力,通过葫芦芯平台...详细>>

我们的目标很明确:构建一个全方位的半导体产业生态系统。成为一家全球领先的半导体互联网生态公司。目前,我们已成功打造了智能汽车、智能家居、大健康医疗、机器人和材料等五大生态领域。更为重要的是...详细>>

我们深知加工与定制类服务商的价值和重要性,因此,我们倾力为您提供最顶尖的营销资源。在我们的平台上,您可以直接接触到100万的研发工程师和采购工程师,以及10万的活跃客户群体...详细>>

凭借我们强大的专业流量和尖端的互联网数字营销技术,我们承诺为原厂提供免费的产品资料推广服务。无论是最新的资讯、技术动态还是创新产品,都可以通过我们的平台迅速传达给目标客户...详细>>

我们不止于将线索转化为潜在客户。葫芦芯平台致力于形成业务闭环,从引流、宣传到最终销售,全程跟进,确保每一个potential lead都得到妥善处理,从而大幅提高转化率。不仅如此...详细>>