Funpack5-4 - 基于FRDM-MCXN236实现环境数据采集
该项目使用了FRDM-MCXN236,实现了环境数据采集的设计,它的主要功能为:通过 MCXN236 片上 LP_FLEXCOMM2/LPI2C 控制器周期性读取温度和相对湿度数据,并通过开发板板载 USB 虚拟串口实时输出采样结果。
标签
嵌入式系统
Funpack活动
bigzhu
更新2026-10-19
37

FRDM-MCXN236 SHT43 环境数据采集项目总结报告

一、项目介绍

本项目基于 NXP FRDM-MCXN236 开发板,实现了一个环境数据采集与串口显示系统。项目使用 Sensirion SHT43 温湿度传感器作为外部 I2C 设备,通过 MCXN236 片上 LP_FLEXCOMM2/LPI2C 控制器周期性读取温度和相对湿度数据,并通过开发板板载 USB 虚拟串口实时输出采样结果。

本项目的核心目标是完成“基于 FRDM-MCXN236 开发板,连接 I2C 传感器,实现环境数据采集与实时显示”的任务要求。最终实现的功能包括:通过 I2C 读取 SHT43 传感器数据;周期性采集环境温度和湿度;通过串口输出采集结果;使用 LED 指示系统运行状态;数据刷新周期小于 1 秒。系统运行后,用户可以在串口终端中看到类似 Sample 1: Temperature=25.34 C, Humidity=48.12 %RH 的输出,从而直观了解当前环境温湿度。

二、使用到的硬件介绍

本项目使用的主要硬件包括 FRDM-MCXN236 开发板、SHT43 温湿度传感器模块、USB 数据线以及若干杜邦线。

FRDM-MCXN236 是 NXP 面向 MCX N 系列 MCU 的 Freedom 开发板,板载 MCXN236 微控制器。MCXN236 内部包含 Cortex-M33 内核、丰富的 GPIO、LP_FLEXCOMM 外设、LPI2C、LPUART、定时和电源管理资源。开发板上还集成了 MCU-Link 调试下载器和 USB 虚拟串口,因此无需额外调试器即可完成程序下载和串口观察。本项目主要使用了板载 MCXN236、LP_FLEXCOMM2/LPI2C2、LPUART4 调试串口以及 RGB LED。

SHT43 是 Sensirion SHT4x 系列中的数字温湿度传感器,支持 I2C 通信,能够输出温度和相对湿度原始数据。根据 SHT4x 数据手册,本项目使用默认 I2C 地址 0x44,高精度测量命令 0xFD,发送命令后等待约 10 ms,再读取 6 字节数据。返回数据包含温度原始值、温度 CRC、湿度原始值和湿度 CRC。SHT43 输出的是数字量,不需要 MCU 外部 ADC,适合在开发板上快速验证环境数据采集功能。

USB 数据线用于为 FRDM-MCXN236 供电,同时提供调试下载通道和虚拟串口通道。杜邦线用于连接 SHT43 模块和开发板 I2C 引脚。工程中使用的 I2C 引脚如下:

FRDM-MCXN236 P4_0 / FC2_P0 -> SHT43 SDA
FRDM-MCXN236 P4_1 / FC2_P1 -> SHT43 SCL
FRDM-MCXN236 3V3         -> SHT43 VDD
FRDM-MCXN236 GND         -> SHT43 GND

如果使用的 SHT43 模块没有板载上拉电阻,则需要在 SDA、SCL 到 3.3 V 之间增加上拉电阻,常用阻值为 4.7 kOhm 到 10 kOhm。本工程在引脚配置中打开了内部上拉和开漏输出,但对于实际 I2C 总线,外部上拉通常更加可靠。

传感器特写

硬件连接

三、方案框图和项目设计思路

系统整体框图如下:

                 +-----------------------------+
                |       FRDM-MCXN236         |
                |                             |
USB 供电/调试 -> | MCU-Link / USB CDC 串口     | ----> PC 串口终端
                |                             |
                | +-----------------------+ |
                | | LPUART4 调试输出     | |
                | +-----------------------+ |
                |                             |
                | +-----------------------+ |
                | | LP_FLEXCOMM2 / LPI2C2 | |
                | | SDA: P4_0             | <----> SHT43 SDA
                | | SCL: P4_1             | <----> SHT43 SCL
                | +-----------------------+ |
                |                             |
                | +-----------------------+ |
                | | RGB LED 状态指示     | |
                | | Blue: 采样周期       | |
                | | Green: 成功采样       | |
                | | Red: 错误状态         | |
                | +-----------------------+ |
                +-----------------------------+
​
                +-----------------------------+
                |           SHT43           |
                | Temperature + Humidity     |
                | I2C Address: 0x44           |
                +-----------------------------+

设计思路分为四个层次。

第一层是板级初始化。程序启动后调用 BOARD_InitBootPins() 初始化调试串口、I2C 和 LED 相关引脚,调用 BOARD_InitBootClocks() 初始化系统时钟,再调用 BOARD_InitDebugConsole() 初始化 LPUART4。随后初始化 RGB LED,并配置 LP_FLEXCOMM2 为 LPI2C 主机模式。

第二层是 I2C 通信。项目使用 MCUX SDK 的 fsl_lpi2c.c/.h 驱动,调用 LPI2C_MasterGetDefaultConfig() 获取默认主机配置,将 I2C 速率设置为 100 kHz,然后调用 LPI2C_MasterInit() 初始化 LPI2C2。由于 SHT43 通信数据量很小,工程采用阻塞式传输 LPI2C_MasterTransferBlocking(),代码结构简单,便于理解和调试。

第三层是 SHT43 数据采集。每次采样时,MCU 先向地址 0x44 写入单字节命令 0xFD,表示启动高精度测量。然后延时 10 ms,等待传感器完成测量。之后 MCU 读取 6 字节数据,并分别对温度两字节和湿度两字节进行 CRC 校验。如果 I2C 传输失败或 CRC 不匹配,则认为本次采样失败;如果校验通过,则将原始值转换为摄氏温度和相对湿度。

第四层是显示和状态指示。采样成功时,串口输出样本序号、温度和湿度,绿灯翻转,红灯关闭;每一轮采样周期蓝灯都会翻转,用于表明主循环仍在运行;如果通信或校验失败,红灯点亮,串口输出错误状态码。整个周期包含 10 ms 测量等待和约 900 ms 周期延时,因此刷新周期小于 1 秒,满足任务要求。

四、调试软件介绍、软件流程图及关键代码介绍

本项目主要使用 VS Code、NXP MCUXpresso 插件、CMake/Ninja、ARM GNU Toolchain、NXP LinkServer 和串口终端工具完成开发调试。VS Code 和 MCUXpresso 插件用于工程导入、配置、构建和下载;ARM GNU Toolchain 用于编译 Cortex-M33 裸机程序;LinkServer 用于通过板载 MCU-Link 下载固件;串口终端用于观察采样输出和错误信息。

本项目所在 Git 分支为 i2c-sensor,构建目标名为 frdm-mcxn236-sht43-sensor.elf。工程保留了 FRDM-MCXN236 所需的 CMSIS、device、board、drivers、startup 等文件,并额外加入了 MCUX SDK 的 LPI2C 驱动 drivers/fsl_lpi2c.c 和 drivers/fsl_lpi2c.h。主程序位于 Common/main.c。

软件流程图如下:

开始
|
v
初始化引脚、系统时钟、调试串口
|
v
初始化 RGB LED
|
v
配置 LP_FLEXCOMM2 时钟和复位
|
v
初始化 LPI2C2 主机,100 kHz
|
v
打印启动信息
|
v
主循环
|
+--> 样本计数加 1,蓝灯翻转
|
+--> 向 SHT43 写入 0xFD 测量命令
|
+--> 等待 10 ms
|
+--> 读取 6 字节测量数据
|
+--> CRC 校验
|       |
|       +-- 成功 --> 原始值转换为温湿度
|       |           串口输出结果
|       |           绿灯翻转,红灯关闭
|       |
|       +-- 失败 --> 串口输出错误码
|                   红灯点亮,绿灯关闭
|
+--> 延时约 900 ms
|
v
继续下一轮采样

关键代码首先是 I2C 配置部分:

#define SHT43_I2C_BASE LPI2C2
#define SHT43_I2C_INSTANCE 2U
#define SHT43_I2C_CLK_FREQ 12000000U
#define SHT43_I2C_BAUDRATE 100000U
#define SHT43_I2C_ADDR 0x44U
#define SHT43_CMD_MEASURE_HIGH_PRECISION 0xFDU

这些宏定义明确了使用 LPI2C2、100 kHz 速率、SHT43 地址 0x44 和高精度测量命令 0xFD。I2C 初始化函数 SensorI2c_Init() 中设置 Flexcomm2 时钟分频和时钟源,释放外设复位,将 LP_FLEXCOMM2 初始化为 LPI2C 外设,再配置 LPI2C 主机模式:

CLOCK_SetClkDiv(kCLOCK_DivFlexcom2Clk, 1U);
CLOCK_AttachClk(kFRO12M_to_FLEXCOMM2);
RESET_ClearPeripheralReset(kFC2_RST_SHIFT_RSTn);
LP_FLEXCOMM_Init(SHT43_I2C_INSTANCE, LP_FLEXCOMM_PERIPH_LPI2C);
LPI2C_MasterGetDefaultConfig(&masterConfig);
masterConfig.baudRate_Hz = SHT43_I2C_BAUDRATE;
LPI2C_MasterInit(SHT43_I2C_BASE, &masterConfig, SHT43_I2C_CLK_FREQ);

传感器读取逻辑集中在 Sht43_Read() 中。函数先执行写操作发送命令:

transfer.slaveAddress = SHT43_I2C_ADDR;
transfer.direction = kLPI2C_Write;
transfer.data = &command;
transfer.dataSize = sizeof(command);
LPI2C_MasterTransferBlocking(SHT43_I2C_BASE, &transfer);

随后延时 10 ms,再执行读操作读取 6 字节。读取完成后使用 Sht43_CheckCrc() 校验两个数据段。SHT4x 的 CRC 使用初值 0xFF,多项式 0x31。工程实现了 Sht43_CalculateCrc(),逐字节、逐位计算 CRC,保证传感器数据可靠。

温湿度转换使用数据手册公式。为了避免当前工程关闭浮点 printf 后无法输出小数,代码将温度和湿度都转换为“百分之一单位”的整数。例如温度 2534 表示 25.34 C,湿度 4812 表示 48.12 %RH。输出时通过 PrintSignedCenti() 和 PrintUnsignedCenti() 打印整数部分和两位小数:

*temperatureCentiC = -4500 + (int32_t)((17500LL * temperatureTicks) / 65535LL);
humidity = -600 + (int32_t)((12500LL * humidityTicks) / 65535LL);

其中湿度转换后会限制在 0 到 100%RH 范围内,避免极端原始值导致显示出负湿度或超过 100%RH。

五、功能展示图及说明

固件编译和下载采用 vscode 插件MCUXpresso For VS Code

连接好开发板后,如果驱动没问题,会识别出一个调试串口和下载接口。

打开终端工具,系统启动后,串口终端首先输出启动信息:

FRDM-MCXN236 SHT43 environment sensor
I2C: LP_FLEXCOMM2, SDA=P4_0, SCL=P4_1, address=0x44, period < 1s
UART: 115200 8N1

当 SHT43 正常连接并通信成功后,每秒以内输出一行温湿度数据:

Sample 1: Temperature=25.34 C, Humidity=48.12 %RH
Sample 2: Temperature=25.35 C, Humidity=48.10 %RH
Sample 3: Temperature=25.35 C, Humidity=48.08 %RH

如果拔掉 SHT43、I2C 接线错误、地址不匹配或者 CRC 校验失败,串口会输出错误信息:

Sample 4: SHT43 read failed, status=...

传感器正常读取截图:

LED 指示说明如下:

蓝灯:每个采样周期翻转,表示主循环仍在运行
绿灯:每次成功读取 SHT43 后翻转,表示采样成功
红灯:I2C 传输失败或 CRC 校验失败时点亮

通过串口输出和 LED 状态,用户可以快速判断系统是否正在运行、是否成功读到传感器数据,以及故障大概发生在通信或数据校验环节。

六、项目中遇到的难题及解决方法

第一个难题是如何在原 RTC 工程基础上继续开发新功能,同时不破坏已经完成的 RTC 电子时钟。解决方法是创建独立 Git 分支 i2c-sensor。在该分支中,可以大胆整理 RTC 主逻辑并替换为 SHT43 采集程序,而主分支仍然保留 RTC 项目。这种分支管理方式让两个任务互不影响,也方便后续单独提交和演示。

第二个难题是当前工程最初只包含 UART、GPIO、时钟、复位等驱动,没有包含 LPI2C 驱动。由于本项目必须通过 I2C 读取传感器,因此需要从本机安装的 MCUX SDK 中引入 fsl_lpi2c.c 和 fsl_lpi2c.h,并将它们加入 CMakeLists 编译列表。这样工程不依赖外部 SDK 源码路径,源码自包含程度更高。

第三个难题是 I2C 引脚选择和复用配置。FRDM-MCXN236 开发板上有多个可复用为通信接口的引脚,本项目选择 P4_0/FC2_P0 作为 SDA,P4_1/FC2_P1 作为 SCL,对应 LP_FLEXCOMM2。需要在 pin_mux.c 中增加 BOARD_InitSHT43_I2CPins(),打开 PORT4 时钟,并将两个引脚配置为复用功能、开漏输出、输入使能和上拉。I2C 总线如果没有正确的引脚复用和上拉,很容易表现为读不到设备或一直 NACK。

第四个难题是 SHT43 数据读取不是简单读取两个字节,而是要按照数据手册执行完整流程:写入测量命令、等待测量完成、读取 6 字节、校验 CRC、再换算温湿度。刚开始如果忽略 10 ms 等待或 CRC 校验,可能会得到不稳定或无法判断可靠性的数据。最终代码严格按照 SHT4x 数据手册完成流程,并在 CRC 错误时直接报告失败。

第五个难题是串口小数输出。当前工程配置中 PRINTF_FLOAT_ENABLE=0,不适合直接使用 %f 打印浮点数。为避免引入浮点 printf 导致代码体积增加或链接问题,项目采用定点整数计算:温度和湿度都以百分之一为单位保存,打印时手动拆分整数部分和小数部分。这种方式在嵌入式系统中很常见,既节省资源,又能满足两位小数显示需求。

第六个难题是状态指示设计。任务要求使用 LED 指示系统运行状态,但仅仅点亮一个 LED 不够直观。最终设计为蓝灯表示采样节拍,绿灯表示成功,红灯表示错误。这样即使不看串口,也可以从 LED 上判断程序是否卡住、传感器是否正常通信。

七、心得体会

本项目相比 RTC 电子时钟,更强调外设通信和外部传感器数据处理。通过这个项目可以明显体会到,I2C 传感器开发的重点不仅是“能读到数据”,还包括硬件接线、引脚复用、总线上拉、设备地址、命令时序、等待时间、CRC 校验和数据换算等多个细节。任何一个环节出错,都可能导致读数失败或数据异常。

本项目中比较有收获的一点是定点数处理。很多入门程序喜欢使用浮点数和 %f 输出温湿度,但在裸机 MCU 工程中,浮点格式化会增加资源占用,也可能因为工程配置没有开启浮点 printf 而无法正常工作。使用百分之一单位进行整数计算,既能显示 25.34 C 这样的友好格式,又更加适合资源有限的嵌入式系统。

另一个收获是分支管理的重要性。前一个 RTC 功能已经完成并推送到主分支,如果直接在主分支修改,容易让两个任务混在一起。通过创建 i2c-sensor 分支,可以清晰地区分“RTC 电子时钟”和“SHT43 环境采集”两个项目。后续如果需要继续扩展,比如增加 OLED 显示、阈值报警、数据滤波或多传感器采集,也可以在该分支基础上继续开发。

最终,本项目完成了 FRDM-MCXN236 与 SHT43 传感器的 I2C 通信,实现了周期性温湿度采集、串口实时输出和 LED 状态指示,刷新周期小于 1 秒,满足任务要求。通过本项目,也进一步熟悉了 MCUX 工程结构、LP_FLEXCOMM 外设复用、LPI2C 驱动使用方式以及数字温湿度传感器的典型开发流程。

附件下载
mcxn236-sensor.zip
工程源代码
团队介绍
个人电子爱好者
评论
0 / 100
查看更多
硬禾服务号
关注最新动态
0512-67862536
info@eetree.cn
江苏省苏州市苏州工业园区新平街388号腾飞创新园A2幢815室
苏州硬禾信息科技有限公司
Copyright © 2026 苏州硬禾信息科技有限公司 All Rights Reserved 苏ICP备19040198号