Placas

A Raspberry Pi 4, Pi 5 e Zero 2 W

A Raspberry Pi's 40-pin header, driven by your main.py in Python with gpiozero or RPi.GPIO.

A visão geral, com exemplos rodando, está na página da placa.

O que é

Three boards with the same 40-pin header: the Raspberry Pi 4 Model B, the Raspberry Pi 5 and the Raspberry Pi Zero 2 W. On a desk each runs Linux and your Python program runs on it. Here there is no Linux: your main.py runs in a Python engine in the page (MicroPython), and its gpiozero and RPi.GPIO drive the header in the circuit. Adafruit Blinka's board, digitalio, busio, pwmio and adafruit_dht work too, so the Adafruit DHT11 and DHT22 tutorial (adafruit_dht.DHT22(board.D4)) runs as written. adafruit_bme280 works too (Adafruit_BME280_I2C(i2c, address=0x76) for the BME280 part's default address; Adafruit's own default is 0x77). hx711 works too, with the methods of both popular HX711 libraries (from hx711 import HX711), so a load cell tutorial runs as written. LCD1602 works too, Freenove's kit module (from LCD1602 import CharLCD1602, init_lcd(), write(x, y, text), clear()), over smbus to an I2C LCD1602 on SDA and SCL, so the Freenove I2C LCD1602 tutorial runs as written. analogio, neopixel and the other Adafruit CircuitPython libraries are not installed.

Escrevendo o programa

Escolha a placa e o editor cria um main.py para ela. Rodar inicia o programa, como python3 main.py faz num Pi. O print() vai para o Monitor Serial, o que você digita lá vai para o input(), e Ctrl-C para o programa com KeyboardInterrupt.

from gpiozero import LED
from time import sleep

led = LED(17)
while True:
    led.toggle()
    sleep(0.5)

time.sleep(1) é um segundo simulado, então um blink, um tempo de debounce ou um pulso de eco medem o mesmo que numa placa de verdade.

O cabeçalho

Os pinos são nomeados pelos números BCM, os que o gpiozero usa: GPIO17 é o pino físico 11. O RPi.GPIO aceita os dois, depois de GPIO.setmode(GPIO.BCM) ou GPIO.setmode(GPIO.BOARD).

Pinos físicos O quê
1, 17 3V3, 3.3 V
2, 4 5V, da fonte
6, 9, 14, 20, 25, 30, 34, 39 GND
os outros 28 GPIO 0 a 27, lógica de 3,3 V

GPIO 2 e 3 (pinos 3 e 5) têm os pull-ups de 1,8 kΩ da placa, então leem nível alto sem nada ligado. Um pino não tolera 5 V: o eco de um HC-SR04 precisa de um divisor de tensão, e o Checkup avisa isso.

I2C and SPI

O barramento I2C do cabeçalho (SDA no GPIO 2, pino 3; SCL no GPIO 3, pino 5) é o /dev/i2c-1, e o SPI0 (SCLK GPIO 11, MOSI GPIO 10, MISO GPIO 9, CE0 GPIO 8, CE1 GPIO 7) é /dev/spidev0.0 e /dev/spidev0.1, como no Raspberry Pi OS com ambos ativados no raspi-config. smbus, smbus2 e spidev (e o busio da Blinka) conversam com os componentes neles, e o MCP3008 do gpiozero lê um potenciômetro pelo conversor:

from smbus2 import SMBus

with SMBus(1) as bus:
    print(hex(bus.read_byte_data(0x76, 0xD0)))   # a BME280 answers 0x60

O barramento roda nos 100 kHz padrão do Raspberry Pi OS, no relógio simulado, então uma chamada leva o tempo dos seus bits. Um endereço sem resposta gera OSError: [Errno 121] Remote I/O error, como num Pi.

Pi 5 e RPi.GPIO

O RPi.GPIO não funciona num Pi 5, aqui nem numa de verdade: o primeiro GPIO.setup gera RuntimeError: Cannot determine SOC peripheral base address. Use o gpiozero, que funciona nas três placas.

O que não é simulado

  • Linux, a área de trabalho, o shell e o sudo.
  • pip e apt: só os módulos que vêm com a placa estão lá.
  • Rede: sem Wi-Fi, Ethernet, Bluetooth ou socket.
  • A câmera, o display, HDMI e áudio.
  • Clock stretching em I2C (nenhum componente simulado faz isso), a configuração de velocidade do I2C (dtparam=i2c_arm_baudrate), e o SPI1 e os outros barramentos que um overlay ativaria.
  • threading. Os callbacks do gpiozero, o blink() e o PWM funcionam sem ele.