Placas

La Raspberry Pi 4, Pi 5 y Zero 2 W

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

La descripción general, con ejemplos en ejecución, está en la página de la placa.

Qué es

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.

Escribir el programa

Elige la placa y el editor le crea un main.py. Ejecutar lo inicia, igual que python3 main.py en una Pi. print() va al monitor serie, lo que escribas ahí entra en input(), y Ctrl-C detiene el programa con KeyboardInterrupt.

from gpiozero import LED
from time import sleep

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

time.sleep(1) es un segundo simulado, así que un parpadeo, un tiempo de antirrebote o un pulso de eco miden lo mismo que en una placa real.

El encabezado

Los pines se nombran por sus números BCM, los que usa gpiozero: GPIO17 es el pin físico 11. RPi.GPIO acepta cualquiera de los dos, después de GPIO.setmode(GPIO.BCM) o GPIO.setmode(GPIO.BOARD).

Pines físicos Qué
1, 17 3V3, 3.3 V
2, 4 5V, provenientes de la fuente
6, 9, 14, 20, 25, 30, 34, 39 GND
los otros 28 GPIO 0 a 27, lógica de 3.3 V

GPIO 2 y 3 (pines 3 y 5) tienen las resistencias pull-up de 1.8 kΩ de la placa, así que leen alto si no hay nada conectado. Un pin no tolera 5 V: el echo de un HC-SR04 necesita un divisor de voltaje, y el Chequeo te lo avisa.

I2C and SPI

El bus I2C del header (SDA en GPIO 2, pin 3; SCL en GPIO 3, pin 5) es /dev/i2c-1, y SPI0 (SCLK GPIO 11, MOSI GPIO 10, MISO GPIO 9, CE0 GPIO 8, CE1 GPIO 7) es /dev/spidev0.0 y /dev/spidev0.1, como en Raspberry Pi OS con ambos activados en raspi-config. smbus, smbus2 y spidev (y el busio de Blinka) se comunican con los componentes conectados ahí, y el MCP3008 de gpiozero lee un potenciómetro a través del convertidor:

from smbus2 import SMBus

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

El bus funciona a los 100 kHz predeterminados de Raspberry Pi OS, sobre el reloj simulado, así que una llamada tarda lo que tardan sus bits. Una dirección que nadie responde lanza OSError: [Errno 121] Remote I/O error, como en una Pi.

Pi 5 y RPi.GPIO

RPi.GPIO no funciona en una Pi 5, ni aquí ni en una real: el primer GPIO.setup lanza RuntimeError: Cannot determine SOC peripheral base address. Usa gpiozero, que funciona en las tres placas.

Qué no está simulado

  • Linux, el escritorio, la shell y sudo.
  • pip y apt: solo están los módulos que vienen con la placa.
  • Red: no hay Wi-Fi, Ethernet, Bluetooth ni socket.
  • La cámara, la pantalla, el HDMI y el audio.
  • El estiramiento de reloj en I2C (ningún componente simulado lo hace), la configuración de velocidad de I2C (dtparam=i2c_arm_baudrate), el SPI1 y los demás buses que un overlay activaría.
  • threading. Las callbacks de gpiozero, blink() y el PWM funcionan sin él.