Skip to content
This repository has been archived by the owner on Mar 21, 2022. It is now read-only.

team-raiju/raiju

Repository files navigation

STM32 Project Template

Template para projetos usando microcontroladores da ST e o STM32CubeMX. Consiste numa estrutura especifica de pastas, um Makefile e alguns arquivos de configuração.

Requisitos

Preparando

Projeto

Primeiro é necessário criar um projeto do Cube na pasta cube/ com o nome desejado, que deve ter as seguintes opções de projeto:

Project:

  • Application Structure: Basic
  • Do not generate the main()
  • Toolchain / IDE: Makefile

Code Generator:

  • STM32Cube Firmware Library Package: Copy only the necessary library files
  • Generated files:
    • Generate peripheral initialization as a pair of .c/.h files per peripheral
    • Delete previously generated files when not re-generated

Um arquivo de exemplo se encontra em cube/stm32_project_template.ioc com todas as configurações necessárias.

Para projetos existentes, basta mover o arquivo .ioc para a pasta cube/.

Gerando arquivos

Com o arquivo do projeto na pasta correta, os seguintes comandos devem ser executados (necessário apenas após dar checkout no repositório ou mudar o cube):

make cube     # Gera arquivos do cube (não funciona no momento por limitações no cube)
make prepare  # Apaga os arquivos do cube desnecessários e gera arquivos de configuração do VS Code

Se, após modificar os arquivos do cube, ocorrer algum erro nos comandos acima, pode rodar make clean_cube para apagar os arquivos gerados e então tentar novamente para que eles sejam gerados do zero.

O arquivo config.mk deve ser alterado de acordo com o projeto.

Para isso é necessário mudar o nome do projeto, o qual deve ter o mesmo do arquivo do Cube (por exemplo, stm32_project_template.ioc), porém sem a extensão .ioc.

# Cube file name without .ioc extension
PROJECT_NAME = stm32_project_template

Também é necessário alterar as seguintes configuraões:

DEVICE_FAMILY  := STM32F3xx
DEVICE_TYPE    := STM32F303xx
DEVICE_DEF     := STM32F303xE
DEVICE         := STM32F303RE

Basta pegar o nome completo do microcontrolador e colocar nessas configurações, seguindo o padrão, fazendo as substituições que forem precisas por x.

Em caso de dúvida, veja o nome do arquivo .ld gerado na pasta cube, ele contém o nome completo do microcontrolador.

Se estiver usando a família STM32G0, a variável DEVICE_DEF deverá ser igual à DEVICE_TYPE.

Além disso, deve-se colocar o nome completo do arquivo com extensão .ld em DEVICE_LD_FILE.

# Linker script file without .ld extension
# Find it on cube folder after code generation
DEVICE_LD_FILE := STM32F303RETx_FLASH

As seguintes configurações não precisam ser alteradas, elas definem nomes de diretórios e opções de compilação, sendo o sugerido permanecerem com seus valores padrão:

# Lib dir
LIB_DIR  := lib

# Cube Directory
CUBE_DIR := cube

# Default values, can be set on the command line or here
DEBUG   ?= 1
VERBOSE ?= 0

Compilando

Para compilar os arquivos rode

make

Às vezes, é necessário limpar os arquivos já compilados, se algum erro estiver acontecendo, para isso faça:

make clean

Isso apaga todos os arquivos de compilação gerados, exceto aqueles gerados a partir das bibliotecas da ST geradas pelo Cube, isso ocorre para agilizar um novo build, já que raramente será necessário recompilar esses arquivos, mas caso seja necessário, é possível limpar todos os arquivos de compilação com

make clean_all

Gravando

Para gravar os arquivos na placa, rode

make flash

Ou, caso use um gravador com J-Link:

make jflash

Tasks

No Visual Studio Code, pode pressionar CTRL+SHIFT+B e escolher uma das opções da lista para executar os comandos de compilação e gravação mais rapidamente.

  • Clean Project (make clean)
  • Build Project (make)
  • Rebuild Project (make clean && make)
  • Flash Program (make flash)
  • Build and Flash (make && make flash)

Adicionando um submódulo

Crie um diretório chamado lib e adicione o submódulo nele.

Exemplo:

mkdir lib
git submodule add --name STMSensors [email protected]:ThundeRatz/STMSensors.git lib/STMSensors

Debug

Em breve

About

Autonomous and RC sumo robot

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages