XIAO SAMD21 与 Zephyr(RTOS)

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

什么是 RTOS

RTOS（实时操作系统）是当今嵌入式系统中最重要的组件之一，负责从任务调度到执行应用程序的所有工作。

RTOS 旨在提供可预测的执行模式。当处理必须满足系统的时间限制时，就会使用 RTOS。因此，与 GPOS（通用操作系统）相比，RTOS 通常重量轻、体积小，通常仅提供在特定硬件上运行特定类型应用程序所需的功能。在某些情况下，开发人员可以修改现有的 RTOS，将其缩减为仅提供特定应用程序所需的功能，和/或定制其功能或性能特性。

什么是 Zephyr

Zephyr 操作系统基于一个小型内核，专为资源受限和嵌入式系统设计：从简单的嵌入式环境传感器和 LED 可穿戴设备到复杂的嵌入式控制器、智能手表和物联网无线应用。

特性

Zephyr 提供了大量且不断增长的功能，包括：

广泛的内核服务套件

Zephyr 提供了许多熟悉的开发服务：

• 多线程服务：支持协作式、基于优先级的、非抢占式和抢占式线程，以及可选的时间片轮转。包括与 POSIX pthreads 兼容的 API 支持。
• 中断服务：用于在编译时注册中断处理程序。
• 内存分配服务：用于动态分配和释放固定大小或可变大小的内存块。
• 线程间同步服务：支持二进制信号量、计数信号量和互斥信号量。
• 线程间数据传递服务：支持基本消息队列、增强消息队列和字节流。
• 电源管理服务：包括全局、应用程序或策略定义的系统电源管理，以及细粒度、驱动程序定义的设备电源管理。

多种调度算法

Zephyr 提供了一套全面的线程调度选项：

• 协作式和抢占式调度
• 最早截止时间优先（EDF）
• Meta IRQ 调度，实现“中断下半部分”或“任务”行为
• 时间片轮转：在具有相同优先级的可抢占线程之间启用时间片轮转
• 多种队列策略：
  • 简单链表就绪队列
  • 红黑树就绪队列
  • 传统多队列就绪队列

支持蓝牙低功耗 5.0

符合蓝牙 5.0 标准（ESR10）并支持蓝牙低功耗控制器（LE 链路层）。包括蓝牙 Mesh 和蓝牙认证就绪的蓝牙控制器。

• 通用访问配置文件（GAP），支持所有可能的 LE 角色
• 通用属性配置文件（GATT）
• 配对支持，包括蓝牙 4.2 的安全连接功能
• 干净的 HCI 驱动抽象
• 原始 HCI 接口，可将 Zephyr 作为控制器运行，而不是完整的主机堆栈
• 已通过多个流行控制器验证
• 高度可配置

Mesh 支持：

• 中继、好友节点、低功耗节点（LPN）和 GATT 代理功能
• 支持两种配置承载（PB-ADV 和 PB-GATT）
• 高度可配置，适合至少 16k RAM 的设备

参考：Zephyr 项目

入门指南

本 Wiki 涵盖了 Zephyr 对 XIAO SAMD21 Zephyr(RTOS) 入门指南 的支持。通过本指南，您将能够利用该开发板提供的功能集。

使用 Zephyr 的第一步是设置本地开发所需的 SDK 和工具链。请参考 Zephyr 入门指南 以获取与您的环境相关的设置步骤。

一旦设置好 Zephyr 工具链并下载了相关的 SDK，您就可以开始应用程序开发。

要对 Xiao SAMD21 进行编程，可以按照以下步骤操作：

1. 构建示例或您的应用程序
2. 插入 Xiao SAMD21
3. 将 RST 引脚短接到 GND（使用可见的测试点）以将 MCU 引导到引导加载程序模式（或快速连续按两次扩展板上的 RESET 按钮）
4. 使用 west flash 将固件烧录到开发板

最简单的示例是在开发板上运行“Hello World”示例。在切换到 Zephyr 安装目录后，运行以下命令：

west build -p always -b seeeduino_xiao samples/subsys/usb/console

快速按两次 RESET 或将 RST 引脚短接到 GND：

west flash

通过输入 ls /dev/tty* 找到您的设备端口，并确认插入 USB 后出现的设备。

在我的示例中，我看到 /dev/ttyACM0 是新添加的设备。

使用 screen 连接并监控串口响应：

screen /dev/ttyACM0 115200

您应该会看到类似以下的响应：

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
Hello World! arm
Hello World! arm
Hello World! arm
Hello World! arm

为了帮助在 Xiao 和其扩展板上使用 Zephyr 的过程，已构建了一个包含多个覆盖和配置的代码库。本文中的命令假设它位于 Zephyr 根目录的 ../applications/xiao-zephyr-examples 路径下。可以通过更新路径为以下命令提供替代路径。

git clone https://github.com/Cosmic-Bee/xiao-zephyr-examples

硬件准备

Seeed Studio XIAO SAMD21	Seeed Studio 扩展板
立即购买 🖱️	立即购买 🖱️

开发者知识

XIAO 扩展板

为了使用 Grove 模块与 Seeed Studio XIAO SAMD21 配合，我们将使用 Seeed Studio XIAO 扩展底板 并将 XIAO SAMD21 连接到扩展板上。

之后，扩展板上的 Grove 接口可以用来连接 Grove 模块。

引脚定义

当将 Grove 模块连接到 Seeed Studio XIAO 的 Grove Shield 上的 Grove 接口时，需要根据下图使用适当的内部引脚编号。

主要功能

• 板载 LED
• USB HID
• LittleFS
• TFLite

板载 LED

在这个示例中，我们将使用 blinky 示例来让板载 LED 闪烁。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/basic/blinky

双击 RESET 或将 RST 引脚短接到 GND：

west flash

您将看到板载黄色 LED 开启和关闭，形成闪烁效果。

让我们深入了解这个示例为什么能够工作。

相关的示例代码引用了 led0：

#define LED0_NODE DT_ALIAS(led0)
static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios);

这是通过设备树代码中的别名在 Xiao SAMD21 中定义的：

    aliases {
        led0 = &led;
    };

    leds {
        compatible = "gpio-leds";
        led: led_0 {
            gpios = <&porta 17 GPIO_ACTIVE_LOW>;
            label = "LED";
        };
    };

它对应于板上的 PA17 引脚。这可以通过查看 Xiao SAMD21 的原理图并检查 MCU 上的引脚标记找到。

对于 Xiao 的引脚，您不需要直接使用 &porta 和 &portb 引脚映射，因为板文件提供了一个 Xiao 连接器，简化了接口。

例如，如果我要引用 D0，我可以将其引用为 &porta 2 或 &xiao_d 0。

/ {
    xiao_d: connector {
        compatible = "seeed,xiao-gpio";
        #gpio-cells = <2>;
        gpio-map-mask = <0xffffffff 0xffffffc0>;
        gpio-map-pass-thru = <0 0x3f>;
        gpio-map
            = <0 0 &porta 2 0>      /* D0 */
            , <1 0 &porta 4 0>      /* D1 */
            , <2 0 &porta 10 0>     /* D2 */
            , <3 0 &porta 11 0>     /* D3 */
            , <4 0 &porta 8 0>      /* D4 */
            , <5 0 &porta 9 0>      /* D5 */
            , <6 0 &portb 8 0>      /* D6 */
            , <7 0 &portb 9 0>      /* D7 */
            , <8 0 &porta 7 0>      /* D8 */
            , <9 0 &porta 5 0>      /* D9 */
            , <10 0 &porta 6 0>     /* D10 */
            ;
    };
};

USB HID

对于这个示例应用程序，我们将使用 USB HID Mouse 示例，让 Xiao SAMD21 触发主机电脑的鼠标点击。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/subsys/usb/hid-mouse --  -DDTC_OVERLAY_FILE=/home/nineso/zephyrproject/zephyr/boards/shields/seeed_xiao_expansion_board/seeed_xiao_expansion_board.overlay

双击 RESET 或将 RST 引脚短接到 GND：

west flash

在 Xiao 重置后，您现在应该能够通过扩展板上的按钮控制鼠标左键。尝试将鼠标悬停在一些文本上并快速双击按钮，您会看到文本被选中，就像使用普通鼠标左键点击一样。您还会注意到，当您点击按钮时，板载 LED 会亮起，因为示例还依赖于设备树中设置的 LED。

可以配置额外的按钮用于示例，因为它允许最多 4 个按钮被配置以触发鼠标的按钮和方向。

    buttons {
        compatible = "gpio-keys";
        xiao_button0: button_0 {
            gpios = <&xiao_d 1 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
            label = "SW0";
            zephyr,code = <INPUT_KEY_0>;
        };
    };

    aliases {
        sw0 = &xiao_button0;
    };

您可以看到这里的示例使用了 &xiao_d 1 来表示 D1 引脚。此映射由 Xiao SAMD21 板文件提供，使得连接到给定引脚变得方便，因为您不需要了解底层 MCU 映射，而可以依赖 Xiao 的引脚布局。

对于 HID Mouse 示例，按钮由是否 compatible = "gpio-keys"; 决定，以及是否有与相关键（鼠标的 0-3 键）映射。在这个示例中，我们使用 zephyr,code = <INPUT_KEY_0>;，它对应于鼠标左键。

led0 别名由板的设备树文件设置，如前一部分所述。

LittleFS

在这个示例中，我们将使用 LittleFS Zephyr 示例来创建一个 LittleFS 分区并将文件保存到文件系统中。然后我们将重新连接并通过串口输出确认文件仍然存在。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/subsys/fs/littlefs -- -DDTC_OVERLAY_FILE="$(dirname $(pwd))/applications/xiao-zephyr-examples/console.overlay" -DEXTRA_CONF_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/console.conf

双击 RESET 按钮或将 RST 引脚短接到 GND：

west flash

等待 MCU 在烧录后重置，并连接到监视器：

screen /dev/ttyACM0 115200

加载完成后，你应该会看到类似以下的内容：

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
Sample program to r/w files on littlefs
Area 2 at 0x3c000 on nvmctrl@41004000 for 16384 bytes
I: LittleFS version 2.8, disk version 2.1
I: FS at nvmctrl@41004000:0x3c000 is 64 0x100-byte blocks with 512 cycle
I: sizes: rd 16 ; pr 16 ; ca 64 ; la 32
E: WEST_TOPDIR/modules/fs/littlefs/lfs.c:1351: Corrupted dir pair at {0x0, 0x1}
W: can't mount (LFS -84); formatting
I: /lfs mounted
/lfs mount: 0
/lfs: bsize = 16 ; frsize = 256 ; blocks = 64 ; bfree = 62

Listing dir /lfs ...
/lfs/boot_count read count:0 (bytes: 0)
/lfs/boot_count write new boot count 1: [wr:1]
I: Test file: /lfs/pattern.bin not found, create one!
------ FILE: /lfs/pattern.bin ------
01 55 55 55 55 55 55 55 02 55 55 55 55 55 55 55
03 55 55 55 55 55 55 55 04 55 55 55 55 55 55 55
05 55 55 55 55 55 55 55 06 55 55 55 55 55 55 55
07 55 55 55 55 55 55 55 08 55 55 55 55 55 55 55
09 55 55 55 55 55 55 55 0a 55 55 55 55 55 55 55
0b 55 55 55 55 55 55 55 0c 55 55 55 55 55 55 55

screen /dev/ttyACM0 115200

再次连接到串口监视器时，我们不会看到格式化过程，也不需要创建文件：

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
Sample program to r/w files on littlefs
Area 2 at 0x3c000 on nvmctrl@41004000 for 16384 bytes
I: LittleFS version 2.8, disk version 2.1
I: FS at nvmctrl@41004000:0x3c000 is 64 0x100-byte blocks with 512 cycle
I: sizes: rd 16 ; pr 16 ; ca 64 ; la 32
/lfs mount: 0
/lfs: bsize = 16 ; frsize = 256 ; blocks = 64 ; bfree = 59

Listing dir /lfs ...
[FILE] boot_count (size = 1)
[FILE] pattern.bin (size = 547)
/lfs/boot_count read count:1 (bytes: 1)
/lfs/boot_count write new boot count 2: [wr:1]
------ FILE: /lfs/pattern.bin ------
02 55 55 55 55 55 55 55 03 55 55 55 55 55 55 55
04 55 55 55 55 55 55 55 05 55 55 55 55 55 55 55
06 55 55 55 55 55 55 55 07 55 55 55 55 55 55 55
08 55 55 55 55 55 55 55 09 55 55 55 55 55 55 55
0a 55 55 55 55 55 55 55 0b 55 55 55 55 55 55 55
0c 55 55 55 55 55 55 55 0d 55 55 55 55 55 55 55
0e 55 55 55 55 55 55 55 0f 55 55 55 55 55 55 55
10 55 55 55 55 55 55 55 11 55 55 55 55 55 55 55
12 55 55 55 55 55 55 55 13 55

TFLite - Hello World

启用 TFLite 与 Zephyr 并更新：

west config manifest.project-filter -- +tflite-micro
west update

在此示例中，我们将使用 TFLite 的 "Hello World" 示例，并结合我们的控制台 overlay 和配置文件，通过 USB 串口读取响应。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/modules/tflite-micro/hello_world -- -DDTC_OVERLAY_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/console.overlay -DEXTRA_CONF_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/console.conf

双击 RESET 按钮或将 RST 引脚短接到 GND：

west flash

等待 MCU 在烧录后重置，并连接到监视器：

screen /dev/ttyACM0 115200

你将在控制台中看到返回的结果：

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
x_value: 1.0*2^-127, y_value: 1.0*2^-127

x_value: 1.2566366*2^-2, y_value: 1.4910772*2^-2

x_value: 1.2566366*2^-1, y_value: 1.1183078*2^-1

x_value: 1.8849551*2^-1, y_value: 1.677462*2^-1

x_value: 1.2566366*2^0, y_value: 1.9316229*2^-1

x_value: 1.5707957*2^0, y_value: 1.0420598*2^0

x_value: 1.8849551*2^0, y_value: 1.9146791*2^-1

x_value: 1.0995567*2^1, y_value: 1.6435742*2^-1

x_value: 1.2566366*2^1, y_value: 1.0674761*2^-1

x_value: 1.4137159*2^1, y_value: 1.8977352*2^-3

附加组件

• Grove - 扩展板 - I2C 显示屏
• Grove - 扩展板 - 按钮
• Grove - 扩展板 - 蜂鸣器
• Grove - 扩展板 - SD 卡
• Grove - 温湿度传感器 (SHT31)
• 1.69 英寸 LCD 显示模块，240×280 分辨率，SPI 接口

Grove - 扩展板 - I2C 显示屏

为了测试此设置，我们可以使用 Zephyr 的现有示例：

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/drivers/display -- -DSHIELD=seeed_xiao_expansion_board

双击 RESET 按钮或将 RST 引脚短接到 GND：

west flash

你会看到显示屏显示多个黑色方块，并且角落有一个闪烁的方块，因为此显示屏仅支持两种颜色。

让我们深入研究这个示例，看看它为什么有效：

/ {
    chosen {
      zephyr,display = &ssd1306;
    };
};

&xiao_i2c {
  status = "okay";

  ssd1306: ssd1306@3c {
    compatible = "solomon,ssd1306fb";
    reg = <0x3c>;
    width = <128>;
    height = <64>;
    segment-offset = <0>;
    page-offset = <0>;
    display-offset = <0>;
    multiplex-ratio = <63>;
    segment-remap;
    com-invdir;
    prechargep = <0x22>;
  };

此示例中的 shield overlay 文件设置了一个 SSD1306 OLED 屏幕，地址为 0x3C。它在 chosen 部分中被选为 Zephyr 的显示设备。

Grove - 扩展板 - 按钮

为了测试此设置，我们可以使用 Zephyr 中的现有示例，并结合 USB 控制台的 overlay 和配置文件。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/basic/button -- -DDTC_OVERLAY_FILE="$(dirname $(pwd))/applications/xiao-zephyr-examples/console.overlay" -DEXTRA_CONF_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/console.conf -DSHIELD=seeed_xiao_expansion_board

双击 RESET 或将 RST 引脚短接到 GND：

west flash

在烧录后等待 MCU 重置片刻，然后连接到监视器：

screen /dev/ttyACM0 115200

按下按钮时，示例会触发板载 LED 点亮。

您将在控制台中看到返回的结果：

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
Set up button at gpio@41004400 pin 4
Set up LED at gpio@41004400 pin 17
Press the button
Button pressed at 420744116
Button pressed at 454208099
Button pressed at 484598863
Button pressed at 518217016
Button pressed at 550754013
Button pressed at 591496990

让我们深入了解这个示例为何能够正常工作：

/ {
    aliases {
      sw0 = &xiao_button0;
    };

    buttons {
      compatible = "gpio-keys";
      xiao_button0: button_0 {
        gpios = <&xiao_d 1 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
        label = "SW0";
        zephyr,code = <INPUT_KEY_0>;
      };
    };
};

应用 overlay 文件用于设置各种板载组件。通过使用此文件，按钮示例可以被利用，因为 overlay 允许 Zephyr 配置按钮并使其可用于相关代码。

在此示例中，它使用 &xiao_d 接口将 D1 关联为按钮。或者，我们也可以在这里使用 &porta 接口，例如 &porta 4，这是与 D1 相关联的 MCU 引脚。

Grove - 扩展板 - 蜂鸣器

我们将使用 blinky PWM 示例通过 PWM 信号控制蜂鸣器的激活。为此，我们将使用一个自定义 overlay 来启用 A3 引脚的 PWM。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/basic/blinky_pwm -- -DDTC_OVERLAY_FILE="$(dirname $(pwd))/applications/xiao-zephyr-examples/xiao-samd21/xiao_expansion_buzzer.overlay"

上传 uf2 文件后，您应该会听到一系列蜂鸣声，随着示例运行过程声音会发生变化。

让我们看看为什么这能正常工作：

/delete-node/ &pwm_led0;

/ {
    aliases {
        pwm-led = &pwm_led0;
    };

    pwm_leds {
        status = "okay";
        compatible = "pwm-leds";

        pwm_led0: pwm_led_0 {
            pwms = <&tcc1 1 PWM_HZ(880) >;
        };
    };
};

&pinctrl {
    pwm_default: pwm_default {
        group1 {
            pinmux = <PA11E_TCC1_WO1>;
        };
    };
};

&tcc1 {
    status = "okay";
    compatible = "atmel,sam0-tcc-pwm";
    /* 最大周期为 1.4 秒 */
    prescaler = <1024>;
    #pwm-cells = <2>;

    pinctrl-0 = <&pwm_default>;
    pinctrl-names = "default";
};

使用的 overlay 首先删除现有的 pwm_led0 节点，因为此板已配置了该别名。然后，它将 A3 引脚配置为 PWM。

我们使用的是 A3 引脚，它对应于 SAMD21 上的 GPIO PA11。由于其关联的 PWM pinmux 是 PA11E_TCC1_WO1，我们使用 tcc1 定时器来实现 PWM。

Grove - 扩展板 - SD 卡

我们将在此处使用文件系统示例以及 Xiao 扩展板 shield，尝试通过 SPI 与 SD 卡读卡器进行交互。扩展板 shield 已将 CS 引脚配置为与 &xiao_d 2 引脚关联，因此除了添加 shield 外，您无需进行任何额外工作即可将此功能与板关联。为了进一步准备，我们使用了一个启用 SD 卡功能的自定义配置。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/subsys/fs/fs_sample -- -DDTC_OVERLAY_FILE="$(dirname $(pwd))/applications/xiao-zephyr-examples/console.overlay $(dirname $(pwd))/applications/xiao-zephyr-examples/xiao_expansion_sd.overlay" -DEXTRA_CONF_FILE="$(dirname $(pwd))/applications/xiao-zephyr-examples/console.conf $(dirname $(pwd))/applications/xiao-zephyr-examples/xiao_expansion_sd.conf" -DSHIELD=seeed_xiao_expansion_board

上传 uf2 文件后，连接到监视器：

screen /dev/ttyACM0 115200

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
[00:00:00.197,000] <inf> sd: Maximum SD clock is under 25MHz, using clock of 10000000Hz
[00:00:00.198,000] <inf> main: Block count 15519744
Sector size 512
Memory Size(MB) 7578
Disk mounted.

Listing dir /SD: ...
[FILE] IMAGE1.JPG (size = 58422)
[FILE] IMAGE2.JPG (size = 97963)

在此示例中，我的 SD 卡中有两个文件。它们的名称和大小被输出到控制台。

让我们看看这里的相关元素：

CONFIG_SPI=y
CONFIG_DISK_DRIVER_SDMMC=y
CONFIG_GPIO=y

在关联的配置中，我们启用了 SPI、SDMMC 磁盘驱动程序和 GPIO。如果没有此配置，overlay 将导致错误，因为示例无法找到 SD 卡。

Xiao 扩展板 shield 的相关部分实际上在此示例中通过用于 Xiao SAMD21 的 xiao_expansion_sd.overlay 被覆盖，如下所示：

&xiao_spi {
    status = "okay";
    cs-gpios = <&xiao_d 2 GPIO_ACTIVE_LOW>;

    sdhc0: sdhc@0 {
        compatible = "zephyr,sdhc-spi-slot";
        reg = <0>;
        status = "okay";
        mmc {
            compatible = "zephyr,sdmmc-disk";
            status = "okay";
        };
        spi-max-frequency = <10000000>;
    };
};

如前所述，&xiao_d 2 引脚映射用于允许选择 D2 引脚，无论使用的板是什么，只要它支持 &xiao_d 引脚设置即可。

我们没有使用 shield 的 overlay，而是覆盖它的原因是 shield 设置的 spi-max-frequency 为 24000000，这个频率太高，导致 SAMD21 失败。

Grove - 温湿度传感器 (SHT31)

首先焊接引脚并将 Xiao SAMD21 连接到扩展板。然后将 Grove 连接器电缆连接到 Grove SHT31 和扩展板上的一个 I2C 端口。

为了测试此设置，我们可以使用 Zephyr 中的一个现有示例，并通过我们的 overlay 和配置文件启用 USB 控制台支持。

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/sensor/sht3xd -- -DDTC_OVERLAY_FILE="$(dirname $(pwd))/applications/xiao-zephyr-examples/sht31.overlay $(dirname $(pwd))/applications/xiao-zephyr-examples/console.overlay" -DEXTRA_CONF_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/console.conf

双击 RESET 按钮或将 RST 引脚短接到 GND：

west flash

在烧录后等待 MCU 重置，然后连接到监视器：

screen /dev/ttyACM0 115200

您将在控制台中看到返回的结果：

*** Booting Zephyr OS build v3.6.0-2566-gc9b45bf4672a ***
SHT3XD: 26.13 Cel ; 47.34 %RH
SHT3XD: 26.11 Cel ; 46.93 %RH
SHT3XD: 26.14 Cel ; 46.78 %RH
SHT3XD: 26.17 Cel ; 46.60 %RH
SHT3XD: 26.19 Cel ; 46.25 %RH
SHT3XD: 26.21 Cel ; 46.01 %RH
SHT3XD: 26.21 Cel ; 45.82 %RH
SHT3XD: 26.23 Cel ; 46.28 %RH
SHT3XD: 26.27 Cel ; 47.11 %RH
SHT3XD: 26.27 Cel ; 47.72 %RH

让我们深入了解此示例，看看它为何有效：

&xiao_i2c {
  status = "okay";

  ssd1306: ssd1306@3c {
    compatible = "solomon,ssd1306fb";
    reg = <0x3c>;
    width = <128>;
    height = <64>;
    segment-offset = <0>;
    page-offset = <0>;
    display-offset = <0>;
    multiplex-ratio = <63>;
    segment-remap;
    com-invdir;
    prechargep = <0x22>;
  };
};

应用 overlay 文件用于设置各种板载组件。通过此文件，SHT31 示例可以被利用，因为 overlay 文件告知 示例逻辑 如何为我们的开发板配置传感器。

1.69 英寸 LCD 显示模块，240×280 分辨率，SPI 接口

在此示例中，我们将使用 SPI 接口连接到一个 240x280 分辨率的 1.69 英寸 LCD。

首先，按照以下图片的指导，将开发板连接到 LCD 屏幕（在此示例中，我们使用 Xiao SAMD21，但连接的引脚布局相同）。

1.69 英寸 LCD SPI 显示屏	<<XIAO>> SAMD21
VCC	3V3
GND	GND
DIN	D10
CLK	D8
CS	D1
DC	D3
RST	D0
BL	D6

接下来，硬件准备就绪后，我们可以进行构建和烧录：

cd ~/zephyrproject/zephyr
west build -p always -b seeeduino_xiao samples/drivers/display -- -DDTC_OVERLAY_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/240x280_st7789v2.overlay -DEXTRA_CONF_FILE=$(dirname $(pwd))/applications/xiao-zephyr-examples/240x280_st7789v2.conf

双击 RESET 按钮或将 RST 引脚短接到 GND：

west flash

烧录新固件后，设备现在会显示与之前扩展板上的演示屏幕相同的内容，只是更新为通过 SPI 显示的彩色 LCD。

✨ 贡献者项目

• 此项目由 Seeed Studio 贡献者项目 支持。
• 感谢 Tim 的努力，您的工作将被 展示。

技术支持与产品讨论

感谢您选择我们的产品！我们为您提供多种支持渠道，以确保您使用我们的产品时体验顺畅。我们提供多种沟通方式，以满足不同的偏好和需求。