DR1 系列评估板 PS 端裸机与 FreeRTOS 开发案例手册

前 言

本文为PS端裸机与FreeRTOS案例开发的指引文档，主要对PS端裸机与FreeRTOS案例进行简要介绍。

开发环境

Windows开发环境：Windows10 64bit

开发工具：TD_5.9.1_DR1_2025.1_NL、FD_2025.1_SP1

术语表

为便于阅读，下表对文档出现的关键术语进行解释；对于广泛认同释义的术语，在此不做注释。

注意事项

（1）请先按照《开发环境搭建》文档安装TD、FD等软件以及进行JTAG驱动安装，使用下载器（厂家：安路科技，型号：AL-LINK-FT-V1.0）连接评估板JTAG接口至PC端USB接口。

（2）在进行本文操作前，请先参考《TD-FD工程编译与加载》，熟悉工程编译、镜像加载等方法。

（3）PS端裸机案例位于产品资料“4-软件资料DemoBaremetal-demos”目录下，FreeRTOS案例位于产品资料“4-软件资料DemoRTOS-demos”目录下。每个PS端的裸机与FreeRTOS案例包含project和bin两个目录，其中project目录下包含案例工程文件，bin目录下含有案例可执行文件。

1led_flash案例

1.1 案例说明

案例功能：控制评估底板PS端LED2，每隔0.5s将状态翻转一次。

图 1

1.2 案例测试

请参考《TD-FD端工程编译与加载》文档“FD工程的程序加载、创建与编译”章节，完成程序的加载。加载完成后看到串口终端打印如下信息，同时可观察到评估底板的LED2进行闪烁。

（1）裸机运行结果。

图 2

（2）FreeRTOS运行结果。

图 3

1.3 关键代码

（1）裸机FD工程代码

案例源码位于案例目录下"projectled_flash_a35led_flash"文件夹中。

a)进行硬件初始化，读取GPIO的值，控制LED引脚。

图 4

（2）FreeRTOS FD工程代码

案例源码位于案例目录下"projectled_flash_a35led_flash"文件夹中。

a)硬件初始化。

图 5

b)实现LED引脚控制。

图 6

c)硬件的初始化执行和队列创建、任务创建。

图 7

d)以下函数由FreeRTOS内核在特定事件发生时自动调用。

图 8

2key_led案例

2.1案例说明

案例功能：通过PS端按键USER1(KEY2)控制评估底板LED2亮灭。

图 9

图 10

2.2案例测试

请参考《TD-FD端工程编译与加载》文档“FD工程的程序加载、创建与编译”章节，完成程序的加载。加载完成后看到串口终端打印如下信息。按下评估板的USER1(KEY2)按键，可观察到LED2的亮灭。

（1）裸机运行结果。

图 11

（2）FreeRTOS运行结果。

图 12

2.3关键代码

（1）裸机FD工程代码。

案例源码位于案例目录下"projectkey_led_a35key_led"文件夹中。

a)进行硬件初始化，获取按键引脚值，实现按下按键LED点亮，松开按键LED熄灭。

图 13

（2）FreeRTOS FD工程代码。

案例源码位于案例目录下"projectkey_led_a35key_led"文件夹中。

a)硬件初始化。

图 14

b)实现按下按键LED点亮，松开按键LED熄灭功能。

图 15

c)硬件的初始化执行和队列创建、任务创建。

图 16

d)以下函数由FreeRTOS内核在特定事件发生时自动调用。

图 17

3uart_rw案例

3.1案例功能

案例功能：评估板通过USB TO UART1调试串口与上位机进行数据回显通信。

3.2案例测试

请使用Type-C线将评估板的USB TO UART1调试串口连接至PC机。参考《TD-FD端工程编译与加载》文档“FD工程的程序加载、创建与编译”章节，完成程序的加载。

加载完成后在串口终端点击"View->Command (Chat) Window"，选中并打开"Command (Chat) Window"窗口。

图 18

在窗口中手动输入10个字符数据，例如"0123456789"，再按回车键。评估板USB TO UART1接收到字符后，会将接收到的字符通过USB TO UART1回显至串口调试终端。

（1）裸机运行结果。

图 19

（2）FreeRTOS运行结果。

图 20

3.3关键代码

（1）设置串口设备相关参数。

图 21

（2）使UART处于阻塞状态，通过调用AlUart_Test_RecvAndSendIntrBlock函数执行测试，并记录结果。若测试失败，则记录错误消息并返回错误代码，否则，记录成功消息并返回AL_OK。

图 22

（3）接收到10个字符后，将字符进行回显。

图 23

审核编辑 黄宇