Seeed Studio XIAO RA4M1 与 NuttX(RTOS)
介绍
NuttX 是一个成熟的实时操作系统(RTOS),因其标准合规性和小占用空间而广受认可。NuttX 的主要特性之一是其可扩展性,这使得它可以在从 8 位微控制器到 64 位系统的各种环境中使用。这种灵活性是通过遵循 POSIX 和 ANSI 标准实现的,使您能够在来自不同架构、系列和半导体供应商的各种芯片上体验类似的 NuttX 功能。
此外,NuttX 提供了许多先进且有用的功能,如 USB、以太网、音频和图形子系统。这些特性使 NuttX 成为寻求能够在各种类型硬件上运行的多功能、强大 RTOS 的开发者的有吸引力的选择。
NuttX 支持大量且不断扩展的开发板。官方文档提供了按架构和片上系统(SoC)系列组织的支持开发板的完整列表。
例如,NuttX 文档中的 Seeed Studio XIAO RA4M1 页面提供了每个支持功能的详细描述和如何使用它们的说明。此外,在 NuttX 文档中还有一个专门针对 Renesas RA4M1 系列芯片的页面,您可以在其中找到支持的 MCU 和外设列表。
安装
Nuttx 文档为不同平台提供了指南。对于 Seeed Studio XIAO RA4M1,请按照以下步骤操作:
-
下载 Renesas rfp-cli(https://www.renesas.com/en/software-tool/renesas-flash-programmer-programming-gui):
~/nuttxspace/nuttx$ rfp-cli --help
Renesas Flash Programmer CLI V1.11
Module Version: V3.18.00.000
Usage: rfp-cli [options...] [<hex file>...] -
创建工作空间
mkdir nuttxspace
-
克隆仓库
cd nuttxspace
git clone https://github.com/apache/nuttx.git nuttx
git clone https://github.com/apache/nuttx-apps apps
Apache Nuttx 分为两个项目:
- Nuttx:包含已实现的内核、驱动程序和子系统。
- Apps:包含工具、shell、网络实用程序、库和解释器的集合。
应用程序
要启动应用程序,需要在 NuttX 上加载配置,调用命令:
./tools/configurate.sh board_name:your_application
也可以通过运行命令检查支持的开发板列表:
./tools/configurate.sh -L
-
构建 NuttX(构建过程将生成固件二进制文件,包括 nuttx.uf2):
cd nuttx
make distclean
./tools/configure.sh xiao-ra4m1:nsh
make V=1 -
RESET 和 BOOT 按钮可用于通过将 BOOT 短接到 GND 并重启开发板,然后按两次复位按钮(双击)来进入"Renesas RA USB Boot"模式。开发板将枚举为"Renesas RA USB Boot"。
-
使用 rfp-cli 加载固件:
rfp-cli -device ra -port /dev/ttyACM0 -p ./build/nuttx.hex
实践操作
现在是时候实际探索 NuttX 了。在本节中,提供了三个应用程序:NSH 和 COMBO。
NSH
NuttShell(NSH) 是一个用于 NuttX 的 shell 系统,类似于 bash 和其他类似选项。它支持丰富的内置命令集、脚本编写以及将您自己的应用程序作为"内置"(同一个 NuttX 二进制文件的一部分)运行的能力。NSH 配置使用 115200 bps 在 SCI2 上启用控制台。
我们可以通过清除之前的配置来开始构建过程
cd ~/nuttxspace/nuttx
make distclean
现在我们为 xiao-ra4m1 开发板选择 NSH 配置:
./tools/configurate.sh xiao-ra4m1:nsh
编译源代码。
make -j
将固件加载到您的开发板中,并将 USB 转串口连接到 TX 和 RX 引脚,然后运行串口通信程序,如 minicon 或 picocom:
picocom -b 115200 /dev/ttyUSB0
访问 NuttShell 控制台:
NuttShell (NSH) NuttX-12.8.0
nsh>
输入 ?
,您将访问命令和内置应用程序的可用选项。
nsh> ?
help usage: [-v] [<cmd>]
. cp exec ls reboot truncate
[ cmp exit mkdir rm uname
? dirname expr mkrd rmdir umount
alias date false mount set unset
unalias dd fdinfo mv sleep uptime
basename df free pidof source usleep
break dmesg help printf test xd
cat echo hexdump ps time
cd env kill pwd true
Builtin Apps:
getprime hello nsh ostest sh
让我们向 NuttX 问好,输入 hello
,然后它执行命令:
nsh> hello
Hello, World!!
恭喜,您与 NuttX 的第一次交互已完成。
COMBO
此配置启用三个示例应用程序:gpio 和 leds。通用输入/输出(GPIO)是微控制器最基本的部分,允许它连接到外部世界。这样我们将使用 NSH 来访问和配置这些引脚。但首先,让我们清除之前的配置。
cd ~/nuttxspace/nuttx
make distclean
为 xiao-ra4m1 开发板选择 combo 配置。
./tools/configurate.sh xiao-ra4m1:combo
编译源代码。
make -j
将固件加载到您的开发板中,运行串口通信程序,如 minicon 或 picocom:
picocom -b 115200 /dev/ttyUSB0
NuttShell (NSH) NuttX-12.8.0
nsh>
要检查与此应用程序交互接受哪些选项,输入 gpio -h
,它将返回参数列表。
NuttShell (NSH) NuttX-12.8.0
nsh> gpio -h
USAGE: gpio [-t <pintype>] [-w <signo>] [-o <value>] <driver-path>
gpio -h
Where:
<driver-path>: The full path to the GPIO pin driver.
-t <pintype>: Change the pin to this pintype (0-10):
-w <signo>: Wait for a signal if this is an interrupt pin.
-o <value>: Write this value (0 or 1) if this is an output pin.
mation and exit.
Pintypes:
0: GPIO_INPUT_PIN
1: GPIO_INPUT_PIN_PULLUP
IO_INPUT_PIN_PULLDOWN
3: GPIO_OUTPUT_PIN
4: GPIO_OUTPUT_PIN_OPENDRAIN
5: GPIO_INTERRUPT_PIN
6: GPIO_INTERRUPT_HIGH_PIN
7: GPIO_INTERRUPT_LOW_PIN
8: GPIO_INTERRUPT_RISING_PIN
9: GPIO_INTERRUPT_FALLING_PIN
10: GPIO_INTERRUPT_BOTH_PIN
要确认 GPIO 设备文件已创建,输入 ls/dev
。输入后,您可以看到一些 gpio 被声明定义在 boards/arm/ra/xiao-ra4m1/include/board.h 中,它们代表:
-
板载 LED:
- 黄色 -> P011
-
GPIO
- 1 个输入 -> P014
- 1 个输出 -> P000
nsh> ls /dev
/dev:
console
gpio0
gpio1
null
ttyS0
userleds
zero
nsh>
按照这些命令读取 gpio0 并写入 gpio1。目前,带中断的 GPIO 输入对于 RA4M1 芯片组不可用。
NuttShell (NSH) NuttX-12.8.0
nsh> gpio /dev/gpio0
Driver: /dev/gpio0
Input pin: Value=0
nsh> gpio /dev/gpio0
Driver: /dev/gpio0
Input pin: Value=1
nsh> gpio -o 1 /dev/gpio1
Driver: /dev/gpio1
Output pin: Value=0
Writing: Value=1
Verify: Value=1
nsh> gpio -o 0 /dev/gpio1
Driver: /dev/gpio1
Output pin: Value=1
Writing: Value=0
Verify: Value=0
USERLEDS 是一个允许通过单一操作控制 LED 的子系统。此外,您可以使用像 printf 这样的命令行。在此演示中,我们将每 1 秒打开和关闭板载黄色 LED。
输入 leds
,您观察到 LED 同时闪烁。
NuttShell (NSH) NuttX-12.8.0
nsh> leds
leds_main: Starting the led_daemon
leds_main: led_daemon started
led_daemon (pid# 7): Running
led_daemon: Opening /dev/userleds
led_daemon: Supported LEDs 0x01
led_daemon: LED set 0x01
nsh> led_daemon: LED set 0x00
led_daemon: LED set 0x01
led_daemon: LED set 0x00
led_daemon: LED set 0x01
led_daemon: LED set 0x00
led_daemon: LED set 0x01
led_daemon: LED set 0x00
查看下面的视频,了解 gpio 和 leds 的演示:
有关 NuttX RTOS 的更多信息,请访问 NuttX 文档
✨ 贡献者项目
技术支持与产品讨论
感谢您选择我们的产品!我们在这里为您提供不同的支持,以确保您使用我们产品的体验尽可能顺畅。我们提供多个沟通渠道,以满足不同的偏好和需求。