目录结构

src/
├── application/
│   ├── ws53/              # 主应用工程入口（main.c）
│   └── samples/            # 示例代码（peripheral / bt / wifi）
├── kernel/
│   ├── liteos/             # WS53 应用固件使用的 LiteOS 内核
│   ├── non_os/             # Boot/辅助镜像使用的裸机运行库
│   ├── osal/               # OSAL 公共头文件及 LiteOS 实现
│   └── osal_adapt/         # SDK 子系统使用的 OSAL 适配辅助组件
├── drivers/
│   ├── chips/              # 芯片级驱动（WS53 寄存器基址、中断映射）
│   ├── drivers/driver/     # 外设驱动（gpio / uart / spi / i2c / pwm / adc / dma …）
│   ├── drivers/hal/        # 硬件抽象层
│   └── boards/             # 板级配置（引脚复用、IO 供电）
├── middleware/
│   ├── chips/              # 芯片适配（NV / 分区 / 异常处理）
│   ├── services/           # 能力封装（Wi-Fi 等系统服务）
│   └── utils/              # 通用工具（AT 命令 / DFX 诊断 / 升级 / CRC）
├── protocol/
│   ├── bt/                 # 蓝牙协议栈
│   └── wifi/               # Wi-Fi 协议栈
├── open_source/
│   ├── lwip/               # lwIP 协议栈
│   ├── mbedtls/            # mbedTLS 安全传输
│   ├── cjson/              # cJSON 解析
│   ├── mqtt/               # MQTT 客户端
│   ├── libcoap/            # CoAP 协议库
│   └── littlefs/           # LittleFS 文件系统
├── interim_binary/          # 预编译库及不可见源码组件
├── build/
│   ├── config/             # target 定义（config.py）与 Kconfig 菜单（.config）
│   └── cmake/               # CMake 模块
├── include/                 # 驱动 UAPI 与中间件公开头文件入口
├── bootloader/
│   ├── flashboot_ws53/     # FlashBoot 引导
│   └── commonboot/         # 通用引导逻辑
└── tools/                   # 工具链与打包脚本

应用层

路径	说明
`application/ws53/`	SDK 平台入口，含 `main.c`、`startup.S` 和系统任务初始化；产品应用通常不直接修改
`application/samples/`	SDK 内示例代码，按功能分 `peripheral/`、`bt/ble/`、`bt/sle/`、`wifi/`

中间件层

路径	说明
`middleware/chips/ws53/`	芯片适配（NV (Non-Volatile)、分区、异常处理）
`middleware/services/`	能力封装（Wi-Fi 等系统服务）
`middleware/utils/`	通用工具（AT 命令、DFX (Diagnostic & Feedback) 诊断、升级、CRC (Cyclic Redundancy Check)）
`protocol/bt/`	蓝牙协议栈
`protocol/wifi/`	Wi-Fi 协议栈
`open_source/`	开源组件：lwIP (Lightweight IP (Internet Protocol))、mbedTLS (mbed Transport Layer Security)、cJSON、MQTT (Message Queuing Telemetry Transport)、libcoap、LittleFS

内核与驱动层

路径	说明
`kernel/liteos/`	WS53 应用固件使用的 LiteOS (Huawei LiteOS) 内核
`kernel/non_os/`	FlashBoot、LoaderBoot 等辅助镜像使用的裸机运行库，不是产品应用的可选内核
`kernel/osal/`	OSAL (Operating System Abstraction Layer) 公共头文件和 LiteOS 实现；应用代码只包含公共头文件
`kernel/osal_adapt/`	SDK 其他子系统使用的 OSAL 适配辅助组件
`drivers/chips/ws53/`	芯片级驱动（寄存器基址、中断号映射）
`drivers/drivers/driver/`	外设驱动（gpio、uart、spi、i2c、pwm、adc、dma…）
`drivers/drivers/hal/`	HAL (Hardware Abstraction Layer) 抽象——芯片无关的外设操作接口
`drivers/boards/ws53/`	板级配置（引脚复用、内存布局）

可修改代码边界

区域	建议
外置工程 `main/`、`components/`	产品业务代码的推荐位置，可独立版本管理和升级 SDK
`include/driver/`、`include/middleware/`、`kernel/osal/include/`	应用可依赖的公开接口边界
`application/samples/`	学习和验证用途，可复制设计思路，不建议作为平台入口直接长期修改
`drivers/`、`middleware/`、`protocol/`、`kernel/`、`bootloader/`	SDK 内部实现；修改后需要自行承担升级合并、兼容性和系统验证
`interim_binary/`	预编译组件，没有可修改源码；通过公开 API、配置项或回调扩展
芯片 ROM (Read-Only Memory)	固化在芯片内，通过 ROM API、callback 和补丁机制使用，不能直接修改

调试时，.elf、.map 或调用栈中的地址可能落在 ROM 或预编译库中。此时应先判断符号所属边界，再决定查看源码、公开接口文档还是 ROM/库版本说明。

HAL、Porting、链接脚本和启动代码属于芯片或板级适配范围，不是产品应用接口。应用访问外设使用驱动 UAPI (Unified API)，操作系统能力使用 OSAL。

构建与配置

路径	说明
`build/config/target_config/ws53/`	target 定义（`config.py`）、Kconfig 菜单（`.config`）
`build/cmake/`	CMake 模块（`build_component.cmake` 等）
`include/`	公开头文件，按子系统分子目录

构建系统的详细说明见构建系统。