Placas

A STM32 Blue Pill

Uma STM32F103C8T6 no nosso núcleo Cortex-M3 a 72 MHz: GPIO via CRL e CRH, TIM1 a TIM4, USART1, um ADC de doze bits e SysTick.

A visão geral, com exemplos rodando, está na página da placa e O modelo da STM32 Blue Pill (todos os registradores).

O que é

The board everybody calls the Blue Pill, an STM32F103C8T6 running on our own Cortex-M core in its ARMv7-M profile. A Cortex-M3 is ARMv7-M without the M4's DSP extension and without an FPU, and the core refuses both here, so a program that reaches for them stops rather than quietly working.

Os registradores vêm do RM0008 e do datasheet STM32F103x8/xB nos endereços reais, então o mesmo firmware roda na placa da sua mesa. O clock é fixo: 72 MHz para a CPU e os timers, desde a energização.

Esta não é a Black Pill com números diferentes

A F1 é uma geração diferente da família, e as diferenças são as que um programa consegue ver. A F411 é uma Cortex-M4 a 84 MHz com 512 KB de flash; a F103 é uma Cortex-M3 a 72 MHz com 64 KB de flash e 20 KB de SRAM. A F411 configura um pino com MODER, OTYPER, PUPDR e AFRL/AFRH; a F103 usa um campo de quatro bits em CRL ou CRH, e tira a direção do pull-up de uma entrada do bit ODR desse pino. Nem um endereço de periférico é compartilhado.

Os pinos

40 pinos com passo de 0.1 polegada, 2 por 20, com o soquete micro-USB no topo.

Header esquerdo, de cima a baixo: VBAT, PC13, PC14, PC15, PA0 a PA7, PB0, PB1, PB10, PB11, NRST, 3V3, GND, 5V.

Header direito: GNDb, GNDc, 3V3b, PB12 a PB15, PA8 a PA12, PA15, PB3 a PB9.

Um pino aqui é uma porta e um número, não um número da placa: PA5, e não 5. A serigrafia imprime as formas curtas (VB, C13, R, A0); o catálogo escreve por extenso e adiciona sufixos às repetições (GNDb, GNDc, 3V3b) porque dois pinos de um mesmo componente não podem compartilhar um nome.

PA13 e PA14 estão no header SWD separado e PB2 é o jumper BOOT1, então nenhum fio os alcança aqui, exatamente como na placa.

Esta é uma placa de 3.3 volts, sempre alimentada por USB. 3V3 e 3V3b fornecem 3.3 V, 5V fornece 5 V, e os três terras são o retorno.

O LED está ao contrário, e não há botão

PC13 carrega o LED verde da placa com o anodo em 3.3 V através de 1 k e o cátodo no pino. Ele acende quando PC13 é levado ao nível baixo. 1 k em vez dos 470 ohms da Black Pill, e é por isso que o LED da Blue Pill é o mais fraco dos dois, e PC13 para PC15 ficam no domínio de alimentação de backup e conseguem drenar apenas 3 mA entre os dois: eles acionam um indicador e pouco mais.

Não há botão do usuário. O único botão da Blue Pill é o RESET. Um sketch que precisa de um botão tem que colocar um na protoboard, e é por isso que tantos tutoriais de Blue Pill começam ligando um.

Por que seu sketch não consegue controlar PA15, PB3 ou PB4

A porta de depuração SWJ segura esses pinos fora do reset: PA15 e PB4 com pull-up, PB3 flutuando. Escreva em SWJ_CFG no AFIO_MAPR uma vez em setup() e eles são seus. Essa é a surpresa mais comum na placa, e o modelo a reproduz em vez de escondê-la.

What is modeled

GPIO nas portas A a C através de CRL e CRH, TIM1 a TIM4 nos modos de contagem e PWM, USART1 em PA9 e PA10 ligada ao monitor serial, um ADC1 de doze bits em conversão única em dez pinos na própria taxa de conversão do componente, AFIO e EXTI, SysTick e a NVIC, e RCC o suficiente para responder às leituras de registrador que um programa faz no caminho de subida.

Todo periférico num STM32 de verdade começa com seu clock desligado, e isso vale aqui: habilitar o clock antes de tocar num periférico faz parte do exercício, não é uma formalidade que este modelo pula.

O que não é

A árvore de clock e a latência de flash, DMA, USB, CAN, I2C, SPI, o RTC e os registradores de backup, os watchdogs, o ADC2, o grupo injetado e o watchdog analógico do ADC, a entrada de break e as saídas complementares do TIM1, a captura de entrada, os modos de baixo consumo, os option bytes e a programação de flash. Os registradores deles não estão mapeados, então tocar em um deles gera um bus fault em vez de um zero silencioso.

As stacks de fabricante (a HAL STM32Cube, a libopencm3 e o core STM32duino) ficam de fora pelo mesmo motivo que o Pico SDK: elas inicializam hardware que não existe aqui. Escreva o sketch usando o runtime e aperte Rodar.

A árvore de clock não modelada tem dois lados. O núcleo roda a 72 MHz independente do que estiver programado no RCC, então um sketch que esquece de ligar o PLL marca o tempo certo aqui e roda nove vezes mais devagar numa placa real. O ADC1 também não tem erro nenhum: sem sample-and-hold, sem não linearidade, sem ruído e sem offset, e o bit de calibração do ADC_CR2 é aceito e não faz nada. E os pinos 3V3 e 5V são fontes ideais que não sofrem queda de tensão, o que importa mais nesta placa do que na maioria: o regulador de um clone de Blue Pill costuma ser o componente errado, e essa falha nada aqui consegue mostrar.

The register tables are in o modelo do STM32 Blue Pill, whose section 7 sorts every address and every approximation.

Bibliotecas do Arduino

Um tutorial que inclua Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h com Adafruit_SSD1306.h e DHT.h compila aqui como está. Cada uma é um cabeçalho próprio do Mokxi sob o nome upstream, escrito sobre os drivers dos componentes da caixa de componentes, e nada disso é o código da biblioteca upstream.

  • Wire.begin() coloca o barramento I2C em PB7 (SDA) e PB6 (SCL).
  • EEPROM.h funciona, mas o modelo desta placa não tem EEPROM nem flash gravável, então os bytes vivem em 4 KB de RAM: eles são lidos de volta dentro de uma execução e somem num reset.
  • Adafruit_NeoPixel.h stops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.

O editor de código e a compilação lista o que cada uma cobre e como difere da biblioteca upstream.

Os exemplos

Blink, Button, Fade e Serial.

Em outros lugares