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 の完全なリファレンス。