STM32 快速开始

这是 快速开始 的嵌入式对应版本：一个完整的实战示例，把一个全新的 嵌入式项目带到一个已生成的、被提交到你仓库的 STM32 .ioc（CubeMX 项目文件）。它使用 Subaya 的引脚规划界面（suya arch），该界面由云端的无头 CubeMX 引擎支撑。

你无需在本地安装 CubeMX——权威的验证和代码生成都在 Subaya 的后端运行。

1. 创建一个嵌入式项目

suya project create --name blinky --workspace <workspace-id> --type embedded
suya repo create --installation <installation-id>   # back it with Git

2. 创建引脚规划

引脚规划捕获 MCU/开发板、引脚分配、外设配置和时钟树意图。从一块开发板入手（开发板契约会 免费提供 LED、按钮和虚拟 COM 端口引脚），或从一个裸 MCU 型号入手：

# From a supported dev board
suya arch pin-plan create --board NUCLEO-L433RC-P

# …or from a bare MCU part
suya arch pin-plan create --mcu STM32F407VGTx

列出并检查规划：

suya arch pin-plan list
suya arch pin-plan show --plan <plan-id>

3. 分配引脚并配置外设

# Pin a signal to a physical pin
suya arch pin set --plan <plan-id> --pin PA5 --signal GPIO_Output --label LED

# Configure a peripheral (mode + params)
suya arch peripheral configure --plan <plan-id> --peripheral USART2 --mode Asynchronous

# Express clock-tree intent
suya arch clock set --plan <plan-id> ...

4. 验证

suya arch validate --plan <plan-id>

这会运行一次结构性验证；后端的无头 CubeMX 引擎才是权威检查。

5. 生成并提交 .ioc

suya arch generate --plan <plan-id>   # produce the .ioc from the pin-plan
suya arch ioc commit                  # generate + commit the .ioc to the connected repo

.ioc 会落在你的 GitHub 仓库中，可在 STM32CubeMX 中打开或驱动进一步的代码生成。

审查规划

把规划渲染为一份审查文档，并像对待任何其他设计产物一样让它走完审查流程：

suya arch pin-plan review-doc --plan <plan-id>
suya review create <document-id>

后续步骤

• 工具与 CubeMX — 云端工具链和 CubeMX 是如何接线的。
• CLI: arch — 完整的 suya arch 参考。