🛠 Premier script Python : fiche signalétique de la carte et LED

Objetivos

Escribir su primer script Python en la Orange Pi 5 Plus: leer la ficha técnica de la placa (modelo del device-tree, número de núcleos, temperatura de la CPU) desde /sys y /proc, y luego hacer parpadear el LED del tutorial 1 desde Python mediante libgpiod. El RK3588 expone 8 núcleos (4 Cortex-A76 hasta 2,4 GHz + 4 Cortex-A55 hasta 1,8 GHz): el script los cuenta automáticamente.

Material

• Orange Pi 5 Plus con Armbian o imagen Orange Pi OS (ARM64 Debian/Ubuntu)
• LED + resistencia de 330 Ω en el pin 7 (tutorial opi5p-led-gpio)
• Paquetes: sudo apt install -y python3 python3-gpiod

Código completo

#!/usr/bin/env python3
"""Fiche signalétique Orange Pi 5 Plus + clignotement LED (broche 7)."""
import pathlib, platform, time
import gpiod  # API v1 (libgpiod 1.x, images Debian 11 / Ubuntu 22.04 / Armbian)

def read(path):
    try:
        return pathlib.Path(path).read_text.strip("\x00").strip
    except OSError:
        return "n/a"

print("Modèle  :", read("/proc/device-tree/model"))
print("Machine :", platform.machine)
print("Cœurs   :", len(list(pathlib.Path("/sys/devices/system/cpu").glob("cpu[0-9]*"))))
for z in sorted(pathlib.Path("/sys/class/thermal").glob("thermal_zone*/temp")):
    print("Temp    :", z.parent.name, int(z.read_text) / 1000.0, "°C")

chip = gpiod.Chip("gpio1")
line = chip.get_line(30)  # broche 7 = GPIO1_D6
line.request(consumer="tuto", type=gpiod.LINE_REQ_DIR_OUT)
for _ in range(3):
    line.set_value(1); time.sleep(0.3)
    line.set_value(0); time.sleep(0.3)
line.release
print("Terminé.")

Verificación esperada

python3 fiche.py muestra «Xunlong Orange Pi 5 Plus», aarch64, 8 núcleos, una o varias temperaturas (30 a 50 °C en reposo), y luego el LED parpadea 3 veces. El device-tree mainline tiene como compatible xunlong,orangepi-5-plus.

Errores frecuentes

• API libgpiod: el ejemplo utiliza la API v1 (get_line/request) de las distribuciones incluidas; las imágenes recientes con libgpiod 2.x tienen una API diferente (chip.find_line, solicitudes por líneas).
• Ejecutar sin permisos GPIO: lance con sudo si el usuario no pertenece al grupo gpio/render.
• Olvidar line.release: la línea permanece reclamada y gpioset falla después con GPIOBUSY.
• >