LM620 平台说明

版本	日期	修改人	说明
v1.0	2026-07-06	—	初版

---

前言

本文档面向 lm620 平台的应用开发者，说明平台提供的组件清单、使用方式和注意事项。

**前置阅读**：建议先阅读 LM620_平台使用指南.md 了解平台构建流程。

---

一、组件清单与形式

lm620 平台的组件分为以下形式：

形式	说明
库形式	直接链接预编译库，无源码
纯源码形式	始终从源码编译
headeronly	仅头文件，无需链接

1.1 库形式组件

组件	说明
xt_soc	SoC 接口抽象层
platform_entry	平台入口
pt8311	PT8311 芯片支持层
xt_audio （音频组件）	音频框架
xt_hal（HAL 驱动总入口）	HAL 硬件抽象层
xt_log	日志系统
xt_mem（内存管理）	内存管理
xt_mobile（蜂窝网络）	移动网络
xt_ota（OTA 升级）	OTA 升级
xt_safe（安全功能）	安全模块
xt_vfs_lm620	虚拟文件系统
xt_wifiscan（Wi-Fi 扫描）	WiFi 扫描
xt_platform_version（平台版本号）	平台版本信息
amr	AMR 音频编解码
http	HTTP 客户端
lwip	LwIP 网络协议栈
mbedtls	TLS 加密库
mqtt	MQTT 客户端
xt_at_ext	AT 扩展命令
tts	TTS 语音合成（仅 r4f4）

1.2 纯源码组件

组件	说明
xt_platform_preinit	平台预初始化

1.3 headeronly 组件

组件	说明
cmsis_os2	CMSIS OS2 头文件
slog	SLOG 编译时标记，使 xt_log_* 宏生成 SLOG ID

---

二、组件依赖模型

2.1 基础依赖（自动包含）

xt_core target 自动包含以下 7 个基础组件，**无需手动 add_deps**：

xt_soc platform_entry cmsis_os2 xtiny xt_hal（HAL 驱动总入口） xt_log xt_mem（内存管理）

2.2 按需添加依赖

其余组件需要用户在工程 xmake.lua 中手动 add_deps：

target("my_app")
    add_deps("lwip")      -- 网络协议栈
    add_deps("amr")       -- AMR 音频编解码
target_end()

依赖方无需关心组件内部实现——写法始终不变。

---

三、r4f4 与 r4f2 的差异

r4f4 和 r4f2 使用相同的组件集合，区别仅在于分区表（build_profile/xpartition.ini）不同：

目标	xknl 分区	zknl 分区	说明
r4f4	0x2C0000	0xD8400	较大分区，可容纳更多代码和数据
r4f2	0x128000	0x87000	较小分区，适用于精简固件

切换 target：

xt config --target lm620/r4f4
xt config --target lm620/r4f2
xt clean build

---

四、注意事项

4.1 add_deps 名称与组件目录名一致

add_deps("lwip")     -- ✅ 正确
add_deps("liblwip")  -- ❌ 错误

4.2 切换 target 后需清理构建

xt clean build

4.3 版本追溯

导出版本信息记录在 common/core/version.txt，可用于追溯当前平台的版本号。

---

五、常见问题

"unknown target" 错误

add_deps 了不存在的 target。检查组件清单（§一），确认该组件在公开平台是否存在。

"undefined reference" 链接错误

缺少 add_deps。检查链接错误中的符号名称，添加对应组件依赖。

构建后镜像超限

代码体积超出分区大小。参照 LM620_平台额外配置指南.md 调整 xpartition.ini。

---

附录：组件速查表

组件	形式	r4f4	r4f2
amr	库形式	✅	✅
cmsis_os2	headeronly	✅	✅
http	库形式	✅	✅
lwip	库形式	✅	✅
mbedtls	库形式	✅	✅
mqtt	库形式	✅	✅
platform_entry	库形式	✅	✅
pt8311	库形式	✅	✅
slog	headeronly	✅	✅
tts	库形式	✅	✅
xt_at_ext	库形式	✅	✅
xt_audio （音频组件）	库形式	✅	✅
xt_hal（HAL 驱动总入口）	库形式	✅	✅
xt_log	库形式	✅	✅
xt_mem（内存管理）	库形式	✅	✅
xt_mobile（蜂窝网络）	库形式	✅	✅
xt_ota（OTA 升级）	库形式	✅	✅
xt_platform_preinit	纯源码	✅	✅
xt_platform_version（平台版本号）	库形式	✅	✅
xt_safe（安全功能）	库形式	✅	✅
xt_soc	库形式	✅	✅
xt_vfs_lm620	库形式	✅	✅
xt_wifiscan（Wi-Fi 扫描）	库形式	✅	✅