版本	日期	修改人	说明
v2.0	2026-07-06	—	重写，匹配当前架构

前言

本文档说明 lm620 平台的基本使用方法。关于 xt-sdk 框架本身的配置（安装 xt-cli、设置工具链路径等），请先阅读 xt-sdk README。

**相关文档**：

LM620_平台说明.md — 组件清单与使用方式
LM620_平台额外配置指南.md — build_profile 双级配置覆盖

一、平台概述

lm620 是基于 RISC-V 架构的嵌入式平台，提供两个构建目标：

目标	分区大小	说明
r4f4	xknl 0x2C0000 / zknl 0xD8400	较大分区，可容纳更多功能
r4f2	xknl 0x128000 / zknl 0x87000	较小分区，适用于精简配置

两个目标使用相同的组件和构建流程，区别在于分区表不同。切换目标参考 xt-sdk README 的 xt-cli 配置方式。

二、快速开始

2.1 前置条件

参照 xt-sdk README 完成：

xt-cli 安装
lm620 平台工具链配置

2.2 编译

# 设置默认 target
xt config --target lm620/r4f4
 
# 进入工程目录
cd examples/build_system/app_with_components
 
# 编译
xt clean build

如需指定板级配置：

xt --board e837n_v01 clean build

编译产物输出到 <project>/.build/lm620_r4f4/。

2.3 切换 target

# 切换到 r4f2
xt config --target lm620/r4f2
 
# 编译
xt clean build

切换 target 后 xt-cli 会自动处理缓存清理。

三、组件依赖模型

3.1 基础依赖（自动包含）

以下组件由 xt_core 自动包含，无需手动 add_deps：

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

3.2 按需添加

其余组件由用户按需 add_deps：

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

完整组件清单及使用方式详见 LM620_平台说明.md。

四、目录结构

lm620/
├── xmake.lua                        # 主构建脚本
├── configs.lua                      # 平台配置
├── toolchain.lua                    # 工具链
├── common/
│   └── core/
│       ├── lib/                     # 预编译库（--whole-archive 自动链接）
│       ├── include/                 # 头文件
│       ├── boot/                    # bootloader 镜像
│       ├── nv/                      # NV 参数基础文件
│       ├── cp/                      # CP 协处理器固件
│       └── version.txt              # 版本追溯信息
├── components/                      # 平台组件
├── r4f4/                            # r4f4 target 配置
│   └── build_profile/                     # 平台默认配置
├── r4f2/                            # r4f2 target 配置
├── tools/                           # 构建工具
└── docs/                            # 平台文档

五、平台额外配置

lm620 支持 build_profile 双级配置覆盖，允许自定义分区布局、链接脚本和 NV 参数。

**快速使用**：在项目目录下创建 build_profile/，放入要覆盖的文件即可。

详见 LM620_平台额外配置指南.md。

六、环境变量

变量	说明
XT_SDK_ROOT	xt-sdk 根目录（export.sh 或 xt-cli 自动设置）
XT_SDK_TOOLCHAIN	RISC-V 工具链路径（xt-cli 配置后自动设置）
XT_SDK_PROJECT_PATH	工程目录（xt-cli 根据当前目录自动设置）

使用 xt-cli 时，以上环境变量由 xt-cli 自动管理，无需手动设置。如不使用 xt-cli，参照 xt-sdk README 中"也可以直接用 xmake 编译"一节。

七、常见问题

编译报 "riscv64-unknown-elf-gcc not found"

确认工具链已配置：xt config --platform lm620 --toolchain-path <路径>

镜像超限 "exceeds partition"

分区大小不足以容纳编译产物。参照 LM620_平台额外配置指南.md 调整 xpartition.ini。

"undefined reference" 链接错误

检查是否缺少对应组件的 add_deps。参照 LM620_平台说明.md 确认组件是否存在。

切换 target 后编译异常

xt clean build