# posty_mcu

**Repository Path**: AAAliangcheng/posty_mcu

## Basic Information

- **Project Name**: posty_mcu
- **Description**: posty_mcu 是一个非常牛逼的仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-19
- **Last Updated**: 2026-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# posty_mcu

Posty MCU 是面向多产品、多 MCU、多 RTOS 的嵌入式产品平台仓库。当前仅有一个真实产品 `posty_edge_sentinel`；跨产品复用不是已完成的资格。参考 `example_product` 只证明接口、构建和测试消费。

## 快速验证

在 Ubuntu/WSL 中初始化已有子模块并运行完整 Host 门禁：

```sh
git submodule update --init --recursive
make all
```

`make all` 包括 Host 测试、Sanitizer、格式、架构、仓库约定和文档检查。独立参考组合可用 `cmake --preset host-reference`、`cmake --build --preset host-reference` 和 `ctest --test-dir out/host-reference-wsl --output-on-failure`。Windows 原生预设只作补充检查，不能替代 WSL 门禁。

真实手表 UI 的交互预览和自动回归入口：

```sh
make watch_lvgl
make watch_lvgl_test
```

Windows 下同名目标转到 WSL；预览使用当前生产 UI、锁定 LVGL 9.2.0 和 SDL2，支持鼠标点按/拖动/左滑，F1/F2 模拟两键，F12 保存软件截图。首次需要显式指定已有 SDK，依赖不会自动安装。工具使用 Host mock owner，不烧录、不连接真实硬件；配置及操作说明见 [产品 README](products/posty_edge_sentinel/README.md#interactive-watch-preview)。全仓质量门禁的未收敛项见 `CURRENT.md`，预览测试通过不代表全部门禁通过。

## 目录与资格

- `hal/`、`osal/`、`driver/`、`bsp/`：可移植契约、运行时语义和目标 provider/板级事实。
- `platform/`：F103 裸机/FreeRTOS/Zephyr 与 F407 裸机等目标绑定；目录存在不等于板上通过。H750 仍只有芯片级资产，没有正式 Board/Platform。
- `products/example_product/`：参考业务的私有 App、Service、Adapter 和组合；不是公共 Framework 能力。
- `products/posty_edge_sentinel/`：SF32/RT-Thread 产品及可移植 Motion core、私有 UI、F407 replay 接入。SF32 官方真实传感器镜像及 F407 replay 已取得 BUILD 级资格，当前镜像的目标运行/HIL 仍待验收。
- `test/`、`tools/`：公共契约/SIL、构建与边界守卫；`third_party/`、`utils/`：固定版本外部依赖及 gitlink。

BUILD、Programming、目标运行、HIL 是不同证据层级。当前状态和下一 Gate 见 [CURRENT](docs/develop_md/CURRENT.md) 与 [ROADMAP](docs/develop_md/ROADMAP.md)；代码归属规则见 [RULES](docs/develop_md/RULES.md)。正式技术契约和 ADR 从 [文档索引](docs/README.md) 进入。历史任务、日志和旧设计稿由 Git 历史保留，不在当前工作树充当真源。