Skip to main content

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,请按照以下步骤操作:

  1. 下载 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>...]
  2. 创建工作空间

    mkdir nuttxspace
  3. 克隆仓库

    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
  1. 构建 NuttX(构建过程将生成固件二进制文件,包括 nuttx.uf2):

    cd nuttx
    make distclean
    ./tools/configure.sh xiao-ra4m1:nsh
    make V=1
  2. RESET 和 BOOT 按钮可用于进入"Renesas RA USB Boot"模式,方法是在 BOOT 短接到 GND 的情况下重启开发板并按两次复位按钮(双击)。开发板将枚举为"Renesas RA USB Boot"。

  3. 使用 rfp-cli 加载固件:

    rfp-cli -device ra -port /dev/ttyACM0 -p ./build/nuttx.hex

实践操作

现在是实际探索 NuttX 的时候了。在本节中,提供了三个应用程序:NSH 和 COMBO。

NSH

NuttShell(NSH) 是在 NuttX 中使用的 shell 系统,类似于 bash 和其他类似选项。它支持丰富的内置命令集、脚本编写以及将您自己的应用程序作为"内置"(同一个 NuttX 二进制文件的一部分)运行的能力。NSH 配置在 SCI2 上启用控制台,使用 115200 bps。

我们可以通过清除之前的配置来开始构建过程

cd ~/nuttxspace/nuttx
make distclean

现在我们将 NSH 配置选择到 xiao-ra4m1 开发板上:

./tools/configurate.sh xiao-ra4m1:nsh

Compile the source code.

make -j

将固件加载到您的开发板中,并将USB转串口连接到TX和RX引脚,然后运行串口通信程序,如minicon或picocom:

picocom -b 115200 /dev/ttyUSB0

Access the NuttShell console:

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 板。

./tools/configurate.sh xiao-ra4m1:combo

编译 translation 代码。

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 和 led 演示视频:

有关 NuttX RTOS 的更多信息,请访问 NuttX 文档

✨ 贡献者项目

技术支持与产品讨论

感谢您选择我们的产品!我们在这里为您提供不同的支持,以确保您使用我们产品的体验尽可能顺畅。我们提供多种沟通渠道,以满足不同的偏好和需求。

Loading Comments...