本帖最后由 HIZYUAN 于 2024-9-20 18:23 编辑
AG32 下使用 freeRTOS 的参考
在 SDK 下已经有移植好的 FreeRTOS Kernel V10.4.6 版本,可供用户使用。
源码位于:\AgRV_pio\packages\framework-agrv_freertos\
用户使用时,不必关注该源码,只需关注 API 使用即可。
一、简单验证:
使用时,从 VSCODE 中直接打开工程:\AgRV_pio\platforms\AgRV\examples\freeRTOS
打开工程后,可以先验证简单的运行情况。
这个工程中,并没有 ve 文件(而是使用了默认的 ve 文件)。
便于后续开发,可以先建立一份 ve。
步骤:
1. 从 example 路径下 copy 一份 example_board.ve 过来;
2. 打开该 example_board.ve,删除掉里边除 clk 和 led 灯以外的其他引脚配置;
3. 在 platformio.ini 中添加对该 ve 的引用:board_logic.ve = example_board.ve
接下来,编译 ve 并烧录,然后编译 code 并烧录。
两项都烧录成功后,就可以看到 led 灯的闪烁了。
二、使用样例:
打开 main.c,可以看到在 main 函数中使用了几种元素:xQueue、xSemaphore、xTask、xTimer。同时在 main.c 中对接的 hook 回调中,会配合使用这些元素。
这里注意,如果要精简样例,比如只跑一个 task 时,删除其他元素时,要同时把 hook 里对应的调用也删除。
main() 函数中,可精简到调用3个函数:
int main(void)
{
prvSetupHardware();
xTaskCreate(led_task,
"led_task",
configMINIMAL_STACK_SIZE,
NULL,
mainEVENT_SEMAPHORE_TASK_PRIORITY,
&xGPTimerTask);
vTaskStartScheduler();
for(;;);
}
其中,prvSetupHardware()函数中有 init 函数是必须的:
在 led_task 中可写闪灯代码如下:
另外,由于不再使用 xEventSemaphore,也需要在 vApplicationTickHook 中去除对 xSemaphore 的操作:
可尝试编译运行,查看效果。
除了以上简化过程,还有用户会使用到 freeRTOS 的静态方法。
如果使用静态方法,即打开了宏:configSUPPORT_STATIC_ALLOCATION,需要新增两个 hook 函数,可参考:https://blog.csdn.net/m0_46451722/article/details/113053257 中的描述。
使用如:
编译通过后,可在函数中使用 static 那组函数。
用法和动态那组函数相似,注意参数使用静态分配好的即可。
三、使用自建工程:
如果用户希望在自建工程中使用 freeRTOS,该如何把它添加进来?
比如,在 example 下要把 freeRTOS 加进来。步骤如下:
1. 在 platformio.ini 中增加对 freertos 的引用:
注意,多个库之间用“逗号+空格”来隔开。
2. 确认 ve 文件里的配置正常(时钟+led 引脚);
3. 在 example.c 中引入 freertos 的头文件及用到的宏定义:
4. 在 example.c 中新增几个函数:
5. 在 main.c 中 init 后直接启动 freeRTOS:
然后,编译 ve 并烧录,再编译 code 并烧录,就可以看到 led 的闪烁了。
更多使用技巧可在www.agm-micro.com或hizyuan.com上查看
AG32下使用freeRTOS的参考. ...
|