firmware-app-development/references/boundaries.md

应用层与底层边界

文件、字段或脚本可能影响硬件和底层固件时，按本说明判断。

应用组负责

• 用户态应用、服务进程和业务模块。
• 直播、事件、存储、网络、云服务、告警、设备管理等应用功能。
• 明确由应用管理的功能开关、产品能力和应用参数。
• 应用日志、诊断、校验脚本和说明文档。
• 应用构建、打包、样机联调、平台联调、发布、认证配合及量产应用功能。
• Bug 修复和回归处理。

应用组负责上述工作，但只执行当前需求明确要求的内容。外部操作必须先单独确认。

应用组不得修改

• psp/ 目录、psp.json 及其他 PSP 配置。
• BSP、Bootloader、内核、内核模块和驱动。
• 设备树、板级配置、引脚复用、寄存器、时钟和电源控制。
• Flash 分区、启动槽、内存布局和底层镜像格式。
• GPIO/PQ、传感器初始化、ISP、底层媒体实现和硬件编解码。
• 电机电气控制、Wi-Fi 驱动选择和其他硬件初始化。

可以读取和使用已有底层文件或产物，但不能修改它们。复制、链接、打包已有底层产物，也不代表可以编辑它们。

混合配置

PSP 文件整份都不属于应用组修改范围，即使其中某个字段看起来与应用有关，也不能直接修改。

其他产品清单、镜像清单、传感器配置、GPIO/PQ 参数和驱动映射也可能同时包含应用和底层内容。只有项目资料明确说明由应用组维护时，才能修改其中的应用字段。

无法确认归属时：

1. 先按底层内容处理。
2. 保持文件不变。
3. 列出需要底层处理的内容及其影响。

底层未处理内容

发现需要底层修改时，只输出必要信息：

• 相关应用任务。
• 需要处理的底层文件、模块或能力。
• 当前情况。
• 需要达到的结果。
• 对应用代码、编译或联调的影响。

不建立中心转交或跟踪流程。能独立完成的应用代码继续完成；依赖底层的部分标记为“底层未处理”。

禁止假实现

底层能力缺失时，不得使用以下方式冒充完成：

• Mock、Stub、假接口或假数据。
• 固定返回成功。
• 临时兜底或静默跳过。
• 复制一套替代流程绕开正式接口。
• 用注释或配置开关掩盖未实现内容。

产品需求明确要求的兼容、降级或模拟功能不属于假实现，但必须在任务清单和实现方案中写清楚并由用户确认。