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.
Related
- La página de la placa: /boards/raspberry-pi
- Proyectos para empezar: Encender un LED con gpiozero y Sensor de distancia HC-SR04 con gpiozero
- Un microcontrolador con opción de Python: la Raspberry Pi Pico