Faça o blink de um Blue Pill escrevendo os registradores você mesmo
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
pinMode e digitalWrite escondem três escritas em registradores. Em um STM32 essas três escritas valem a pena aprender, porque no dia em que você sair do core Arduino para a HAL do fabricante ou para bare metal, elas são o que toda função de GPIO está fazendo, e o bug STM32 mais comum de todos mora na primeira delas.
O circuito acima é um STM32F103 Blue Pill com um LED e um resistor de 1 k de 3.3 V para PC13, o mesmo pino do LED verde da própria placa. O sketch faz o blink sem pinMode nem digitalWrite e, antes de começar, imprime três valores de registradores. Aperte Rodar e o monitor serial mostra:
As três linhas são "CRH com o clock da porta C desligado: 0x0", depois "CRH após IOPCEN, valor de reset: 0x44444444", depois "CRH com PC13 como saída: 0x44244444". Depois disso os dois LEDs piscam uma vez por segundo.
Passo 1: ligue o clock da porta
Todo periférico em um STM32 começa com seu clock desligado para economizar energia, e um periférico sem clock não faz nada. O clock da porta GPIO C é o bit 4 de RCC->APB2ENR, chamado IOPCEN. Até que ele seja ativado, os registradores da porta leem zero e ignoram escritas.
O sketch prova isso. Ele escreve um valor em GPIOC->CRH antes de ativar o clock e lê de volta 0x0: a escrita não chegou a lugar nenhum. Depois de RCC->APB2ENR |= RCC_APB2ENR_IOPCEN, o mesmo registrador lê 0x44444444, seu valor de reset. Em hardware real, esquecer essa linha produz um programa que compila, roda e não faz absolutamente nada, sem erro algum. O Mokxi modela esse bloqueio do mesmo jeito, de propósito.
Passo 2: configure o pino no CRH
O F103 descreve cada pino com quatro bits: dois para MODE (entrada, ou saída a 10, 2 ou 50 MHz) e dois para CNF (push-pull, dreno aberto ou função alternativa). Os pinos 0 a 7 ficam no CRL e os pinos 8 a 15 no CRH. PC13 é o sexto nibble do CRH, bits 20 a 23.
O valor de reset 0x4 em cada nibble significa CNF 01, MODE 00: uma entrada flutuante. O sketch zera o nibble de PC13 e escreve 0x2, MODE 10 (saída, 2 MHz) e CNF 00 (push-pull), e é por isso que a terceira linha lê 0x44244444: um nibble mudou, os outros intactos. As famílias STM32 mais recentes, como a F4, usam um layout diferente (MODER, OTYPER, OSPEEDR), e essa é a primeira coisa que quebra quando código de F1 é levado para um F4.
const uint32_t PIN = 13;
const uint32_t CRH_SHIFT = (PIN - 8) * 4; // bits 20..23
const uint32_t OUT_2MHZ_PUSH_PULL = 0x2; // CNF 00, MODE 10
void setup() {
RCC->APB2ENR |= RCC_APB2ENR_IOPCEN; // 1. clock on
uint32_t crh = GPIOC->CRH;
crh &= ~(0xFUL << CRH_SHIFT);
crh |= OUT_2MHZ_PUSH_PULL << CRH_SHIFT;
GPIOC->CRH = crh; // 2. PC13 an output
}
void loop() {
GPIOC->BSRR = 1UL << (PIN + 16); // 3. reset: low, LED on
delay(500);
GPIOC->BSRR = 1UL << PIN; // set: high, LED off
delay(500);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Passo 3: BSRR, e por que não ODR
You could change the pin by reading ODR, the output register, flipping bit 13 and writing it back. BSRR is better. Writing a 1 to one of its low 16 bits sets that pin; writing a 1 to one of its high 16 bits resets it; zeros change nothing. It is a single write with no read first, so if an interrupt changes another pin on port C between your read and your write, BSRR cannot undo that change, and a read-modify-write of ODR can.
O LED no PC13 é ligado de 3,3 V até o pino, então o pino drena sua corrente e o LED acende quando o pino está em nível baixo. Isso é o oposto do pino 13 de um Uno, e é o motivo pelo qual o sketch redefine o pino para acender o LED.
Por que o resistor é de 1 k, e onde a HAL se encaixa
PC13, PC14 e PC15 são especiais no F103. Eles são alimentados pela chave de energia do domínio de backup, e a folha de dados da ST os limita a drenar cerca de 3 mA, a no máximo 2 MHz, e diz que eles não devem ser usados como fonte de corrente, por exemplo para acender um LED do pino até o terra. O LED da Blue Pill é ligado do outro jeito, de 3,3 V para dentro do pino, por um resistor de 1 k: (3,3 - 2) / 1000 dá cerca de 1,3 mA. Um resistor de 220 ohms ali pediria cerca de 6 mA, então este circuito usa 1 k para ficar dentro do limite. Para um LED mais brilhante em uma placa de verdade, escolha um pino comum como o PA5 e um resistor de 330 ohms.
A biblioteca HAL da ST faz os mesmos três passos com funções nomeadas: __HAL_RCC_GPIOC_CLK_ENABLE(), HAL_GPIO_Init() com um GPIO_InitTypeDef, e HAL_GPIO_WritePin() ou HAL_GPIO_TogglePin(), que escreve no BSRR por baixo. O Mokxi não roda binários da HAL, porque eles começam configurando a árvore de clock e os wait states da flash, que não são modelados; a Blue Pill aqui roda a 72 MHz fixos. Os registradores acima são exatamente o que aquelas chamadas da HAL acabam escrevendo.
Um aviso do mundo real: muitas placas vendidas como Blue Pills trazem um clone do STM32F103 em vez do chip da ST. Elas normalmente rodam código simples de GPIO como este sem problema, mas podem diferir no tamanho da flash e no suporte ao depurador, então confira a marcação do chip se uma placa se comportar de forma estranha.
Abra este circuito no editor. Blue Pill: piscar por registrador, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.
Perguntas
Por que meu código de GPIO do STM32 não faz nada?
De longe, a causa mais comum é o clock da porta deixado desligado no RCC. Na família F1 os clocks de GPIO estão em RCC->APB2ENR; no F4 estão em RCC->AHB1ENR. Com o clock desligado, as escritas são ignoradas e as leituras retornam zero.
O LED da Blue Pill é ativo em nível baixo?
Sim. Ele é ligado de 3,3 V por um resistor até o PC13, então acende quando o PC13 é levado ao nível baixo.
Qual é a diferença entre BSRR e BRR?
O BSRR pode setar pinos (metade baixa) e resetar pinos (metade alta) em uma escrita só. O BRR só pode resetá-los. Ambos deixam em paz todo pino que você não citou.
Posso usar as funções do Arduino e os registradores no mesmo sketch?
Sim. Este sketch ainda usa Serial e delay() do runtime. Só não deixe os dois mexerem na configuração do mesmo pino, ou o último a escrever no CRH vence.
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.