Primeiros passos com STM32

Esta é a contraparte embarcada do Início rápido: um exemplo prático completo que leva um projeto embarcado novo a um .ioc STM32 gerado (o arquivo de projeto do CubeMX) commitado no seu repositório. Ele usa a superfície de planejamento de pinos do Subaya (suya arch), que é apoiada por um motor CubeMX headless na nuvem.

Você não precisa do CubeMX instalado localmente — a validação autoritativa e a geração de código rodam no backend do Subaya.

1. Criar um projeto embarcado

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

2. Criar um pin-plan

Um pin-plan captura o MCU/placa, as atribuições de pinos, as configurações de periféricos e a intenção de árvore de clock. Comece a partir de uma placa de desenvolvimento (o contrato da placa fornece de graça os pinos de LED, botão e porta-COM-virtual) ou a partir de um componente MCU avulso:

# 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

Liste e inspecione os planos:

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

3. Atribuir pinos e configurar periféricos

# 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. Validar

suya arch validate --plan <plan-id>

Isto executa uma validação estrutural; o motor CubeMX headless no backend é a verificação autoritativa.

5. Gerar e commitar o .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

O .ioc chega no seu repositório GitHub, pronto para ser aberto no STM32CubeMX ou para conduzir geração de código adicional.

Revisar o plano

Renderize o plano em um documento de revisão e passe-o pela revisão como qualquer outro artefato de design:

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

Próximos passos

• Ferramentas e CubeMX — como as toolchains de nuvem e o CubeMX são conectados.
• CLI: arch — a referência completa de suya arch.