Saltar al contenido

Guía de inicio rápido: Raspberry Pi con Ultralytics YOLO11

Esta completa guía proporciona un recorrido detallado para implementar Ultralytics YOLO11 en dispositivos Raspberry Pi. Además, presenta pruebas de rendimiento para demostrar las capacidades de YOLO11 en estos pequeños y potentes dispositivos.



Observa: Actualizaciones y mejoras de la Raspberry Pi 5.

Nota

Esta guía se ha probado con Raspberry Pi 4 y Raspberry Pi 5 que ejecutan la última versión de Raspberry Pi OS Bookworm (Debian 12). Se espera que esta guía funcione con dispositivos Raspberry Pi más antiguos, como la Raspberry Pi 3, siempre que se instale el mismo Raspberry Pi OS Bookworm.

¿Qué es Raspberry Pi?

Raspberry Pi es un pequeño y asequible ordenador de placa única. Se ha hecho popular para una amplia gama de proyectos y aplicaciones, desde la domótica para aficionados hasta usos industriales. Las placas Raspberry Pi son capaces de ejecutar diversos sistemas operativos, y ofrecen pines GPIO (Entrada/Salida de propósito general) que permiten una fácil integración con sensores, actuadores y otros componentes de hardware. Existen diferentes modelos con distintas especificaciones, pero todos comparten la misma filosofía básica de diseño: ser baratos, compactos y versátiles.

Comparación de la serie Raspberry Pi

Raspberry Pi 3Raspberry Pi 4Raspberry Pi 5
CPUBroadcom BCM2837, SoC Cortex-A53 de 64 bitsSoC Broadcom BCM2711, Cortex-A72 de 64 bitsSoC Broadcom BCM2712, Cortex-A76 de 64 bits
CPU Frecuencia máxima1,4 GHz1,8 GHz2,4 GHz
GPUVideocore IVVideocore VIVideoCore VII
GPU Frecuencia máxima400Mhz500Mhz800Mhz
Memoria1GB LPDDR2 SDRAM1GB, 2GB, 4GB, 8GB LPDDR4-3200 SDRAM4GB, 8GB LPDDR4X-4267 SDRAM
PCIeN/AN/A1xInterfaz PCIe 2.0
Consumo máximo2,5A@5V3A@5V5A@5V (PD activada)

¿Qué es el SO Raspberry Pi?

Raspberry Pi OS (antes conocido como Raspbian) es un sistema operativo de tipo Unix basado en la distribución Debian GNU/Linux para la familia Raspberry Pi de ordenadores compactos de placa única distribuidos por la Fundación Raspberry Pi. Raspberry Pi OS está altamente optimizado para la Raspberry Pi con CPU ARM y utiliza un entorno de escritorio LXDE modificado con el gestor de ventanas apilables Openbox. Raspberry Pi OS está en desarrollo activo, con énfasis en mejorar la estabilidad y el rendimiento de tantos paquetes Debian como sea posible en Raspberry Pi.

Flashear Raspberry Pi OS a Raspberry Pi

Lo primero que tienes que hacer después de hacerte con una Raspberry Pi es flashear una tarjeta micro-SD con el SO Raspberry Pi, insertarla en el dispositivo y arrancar el SO. Sigue la detallada Documentación de inicio de Ras pberry Pi para preparar tu dispositivo para el primer uso.

Configurar Ultralytics

Hay dos formas de configurar el paquete Ultralytics en la Raspberry Pi para construir tu próximo proyecto de Visión por Computador. Puedes utilizar cualquiera de ellas.

Empieza con Docker

La forma más rápida de empezar a utilizar Ultralytics YOLO11 en Raspberry Pi es ejecutarlo con una imagen docker preconstruida para Raspberry Pi.

Ejecuta el siguiente comando para extraer el contenedor Docker y ejecutarlo en Raspberry Pi. Se basa en la imagen Docker arm64v8/debian, que contiene Debian 12 (Bookworm) en un entorno Python3.

t=ultralytics/ultralytics:latest-arm64 && sudo docker pull $t && sudo docker run -it --ipc=host $t

Una vez hecho esto, pasa a la sección Utilizar NCNN en Raspberry Pi.

Empezar sin Docker

Instala el paquete Ultralytics

Aquí instalaremos el paquete Ultralytics en la Raspberry Pi con dependencias opcionales para que podamos exportar los PyTorch modelos a otros formatos diferentes.

  1. Actualizar la lista de paquetes, instalar pip y actualizar a la última versión

    sudo apt update
    sudo apt install python3-pip -y
    pip install -U pip
    
  2. Instala ultralytics paquete pip con dependencias opcionales

    pip install ultralytics[export]
    
  3. Reinicia el dispositivo

    sudo reboot
    

Utiliza NCNN en Raspberry Pi

De todos los formatos de exportación de modelos admitidos por Ultralytics, NCNN ofrece el mejor rendimiento de inferencia cuando se trabaja con dispositivos Raspberry Pi porque NCNN está altamente optimizado para plataformas móviles/integradas (como la arquitectura ARM). Por lo tanto, nuestra recomendación es utilizar NCNN con Raspberry Pi.

Convierte el modelo a NCNN y ejecuta la inferencia

El modelo YOLO11n en formato PyTorch se convierte a NCNN para ejecutar la inferencia con el modelo exportado.

Ejemplo

from ultralytics import YOLO

# Load a YOLO11n PyTorch model
model = YOLO("yolo11n.pt")

# Export the model to NCNN format
model.export(format="ncnn")  # creates 'yolo11n_ncnn_model'

# Load the exported NCNN model
ncnn_model = YOLO("yolo11n_ncnn_model")

# Run inference
results = ncnn_model("https://ultralytics.com/images/bus.jpg")
# Export a YOLO11n PyTorch model to NCNN format
yolo export model=yolo11n.pt format=ncnn  # creates 'yolo11n_ncnn_model'

# Run inference with the exported model
yolo predict model='yolo11n_ncnn_model' source='https://ultralytics.com/images/bus.jpg'

Consejo

Para más detalles sobre las opciones de exportación admitidas, visita la página de documentaciónUltralytics sobre opciones de despliegue.

Raspberry Pi 5 YOLO11 Benchmarks

El equipo de Ultralytics ejecutó las pruebas de YOLO11 en nueve formatos de modelo diferentes, midiendo la velocidad y la precisión: PyTorch, TorchScript, ONNX, OpenVINO, TF SavedModel , TF GraphDef , TF Lite, PaddlePaddle, NCNN. Las pruebas se ejecutaron en una Raspberry Pi 5 con precisión FP32 y un tamaño de imagen de entrada por defecto de 640.

Cuadro comparativo

Sólo hemos incluido pruebas comparativas de los modelos YOLO11n y YOLO11s, porque los tamaños de otros modelos son demasiado grandes para ejecutarlos en la Raspberry Pis y no ofrecen un rendimiento decente.

Benchmarks de YOLO11 en RPi 5

Tabla comparativa detallada

La tabla siguiente representa los resultados de la prueba comparativa para dos modelos diferentes (YOLO11n, YOLO11s) en nueve formatos distintos (PyTorch, TorchScript, ONNX, OpenVINO, TF SavedModel , TF GraphDef , TF Lite, PaddlePaddle, NCNN), ejecutados en una Raspberry Pi 5, dándonos el estado, el tamaño, la métrica mAP50-95(B) y el tiempo de inferencia de cada combinación.

Rendimiento

FormatoEstadoTamaño en disco (MB)mAP50-95(B)Tiempo de inferencia (ms/im)
PyTorch5.40.61524.828
TorchScript10.50.6082666.874
ONNX10.20.6082181.818
OpenVINO10.40.6082530.224
TF SavedModel25.80.6082405.964
TF GraphDef10.30.6082473.558
TF Lite10.30.6082324.158
PaddlePaddle20.40.6082644.312
NCNN10.20.610693.938
FormatoEstadoTamaño en disco (MB)mAP50-95(B)Tiempo de inferencia (ms/im)
PyTorch18.40.75261226.426
TorchScript36.50.74161507.95
ONNX36.30.7416415.24
OpenVINO36.40.74161167.102
TF SavedModel91.10.7416776.14
TF GraphDef36.40.74161014.396
TF Lite36.40.7416845.934
PaddlePaddle72.50.74161567.824
NCNN36.20.7419197.358

Reproducir nuestros resultados

Para reproducir las pruebas anteriores de Ultralytics en todos los formatos de exportación, ejecuta este código:

Ejemplo

from ultralytics import YOLO

# Load a YOLO11n PyTorch model
model = YOLO("yolo11n.pt")

# Benchmark YOLO11n speed and accuracy on the COCO8 dataset for all all export formats
results = model.benchmarks(data="coco8.yaml", imgsz=640)
# Benchmark YOLO11n speed and accuracy on the COCO8 dataset for all all export formats
yolo benchmark model=yolo11n.pt data=coco8.yaml imgsz=640

Ten en cuenta que los resultados de las pruebas comparativas pueden variar en función de la configuración exacta de hardware y software de un sistema, así como de la carga de trabajo actual del sistema en el momento de ejecutar las pruebas comparativas. Para obtener resultados más fiables, utiliza un conjunto de datos con un gran número de imágenes, es decir data='coco8.yaml' (4 val images), ordata='coco.yaml'` (5000 imágenes val).

Utilizar la cámara Raspberry Pi

Cuando se utiliza la Raspberry Pi para proyectos de Visión por Computador, puede ser esencial tomar imágenes de vídeo en tiempo real para realizar inferencias. El conector MIPI CSI integrado en la Raspberry Pi te permite conectar módulos de cámara oficiales de la Raspberry PI. En esta guía, hemos utilizado un Módulo de Cámara 3 de Raspberry Pi para capturar las secuencias de vídeo y realizar inferencias utilizando modelos YOLO11.

Nota

La Raspberry Pi 5 utiliza conectores CSI más pequeños que la Raspberry Pi 4 (15 patillas frente a 22 patillas), por lo que necesitarás un cable adaptador de 15 patillas a 22 patillas para conectarla a una cámara Raspberry Pi.

Prueba la cámara

Ejecuta el siguiente comando después de conectar la cámara a la Raspberry Pi. Deberías ver un vídeo en directo de la cámara durante unos 5 segundos.

rpicam-hello

Inferencia con cámara

Hay 2 métodos de utilizar la Cámara de la Raspberry Pi para inferir modelos YOLO11.

Utilización

Podemos utilizar picamera2que viene preinstalado con Raspberry Pi OS para acceder a la cámara e inferir los modelos YOLO11.

Ejemplo

import cv2
from picamera2 import Picamera2

from ultralytics import YOLO

# Initialize the Picamera2
picam2 = Picamera2()
picam2.preview_configuration.main.size = (1280, 720)
picam2.preview_configuration.main.format = "RGB888"
picam2.preview_configuration.align()
picam2.configure("preview")
picam2.start()

# Load the YOLO11 model
model = YOLO("yolo11n.pt")

while True:
    # Capture frame-by-frame
    frame = picam2.capture_array()

    # Run YOLO11 inference on the frame
    results = model(frame)

    # Visualize the results on the frame
    annotated_frame = results[0].plot()

    # Display the resulting frame
    cv2.imshow("Camera", annotated_frame)

    # Break the loop if 'q' is pressed
    if cv2.waitKey(1) == ord("q"):
        break

# Release resources and close windows
cv2.destroyAllWindows()

Necesitamos iniciar un flujo TCP con rpicam-vid de la cámara conectada para que podamos utilizar esta URL de flujo como entrada cuando hagamos la inferencia más adelante. Ejecuta el siguiente comando para iniciar el flujo TCP.

rpicam-vid -n -t 0 --inline --listen -o tcp://127.0.0.1:8888

Más información rpicam-vid uso en la documentación oficial de Raspberry Pi

Ejemplo

from ultralytics import YOLO

# Load a YOLO11n PyTorch model
model = YOLO("yolo11n.pt")

# Run inference
results = model("tcp://127.0.0.1:8888")
yolo predict model=yolo11n.pt source="tcp://127.0.0.1:8888"

Consejo

Consulta nuestro documento sobre Fuentes de inferencia si quieres cambiar el tipo de entrada de imagen/vídeo

Buenas prácticas al utilizar Raspberry Pi

Hay un par de buenas prácticas que debes seguir para conseguir el máximo rendimiento en las Raspberry Pis que ejecutan YOLO11.

  1. Utiliza un SSD

    Cuando se utiliza la Raspberry Pi para un uso continuado 24x7, se recomienda utilizar un SSD para el sistema, ya que una tarjeta SD no podrá soportar escrituras continuas y podría romperse. Con el conector PCIe integrado en la Raspberry Pi 5, ahora puedes conectar SSD utilizando un adaptador como la Base NVMe para Raspberry Pi 5.

  2. Flash sin GUI

    Al flashear Raspberry Pi OS, puedes elegir no instalar el entorno de escritorio (Raspberry Pi OS Lite) y esto puede ahorrar un poco de RAM en el dispositivo, dejando más espacio para el procesamiento de la visión por ordenador.

Próximos pasos

¡Enhorabuena por haber configurado con éxito YOLO en tu Raspberry Pi! Para más información y ayuda, visita Ultralytics YOLO11 Docs y la Fundación Mundial Cachemira.

Agradecimientos y citas

Esta guía fue creada inicialmente por Daan Eeltink para la Fundación Mundial Cachemira, una organización dedicada al uso de YOLO para la conservación de especies en peligro de extinción. Reconocemos su labor pionera y su enfoque educativo en el ámbito de las tecnologías de detección de objetos.

Para más información sobre las actividades de la Fundación Mundial Cachemira, puedes visitar su sitio web.

PREGUNTAS FRECUENTES

¿Cómo configuro Ultralytics YOLO11 en una Raspberry Pi sin utilizar Docker?

Para configurar Ultralytics YOLO11 en una Raspberry Pi sin Docker, sigue estos pasos:

  1. Actualiza la lista de paquetes e instala pip:
    sudo apt update
    sudo apt install python3-pip -y
    pip install -U pip
    
  2. Instala el paquete Ultralytics con las dependencias opcionales:
    pip install ultralytics[export]
    
  3. Reinicia el dispositivo para aplicar los cambios:
    sudo reboot
    

Para obtener instrucciones detalladas, consulta la sección Iniciar sin Docker.

¿Por qué debería utilizar el formato NCNN de Ultralytics YOLO11 en Raspberry Pi para tareas de IA?

Ultralytics El formato NCNN de YOLO11 está altamente optimizado para plataformas móviles e integradas, lo que lo hace ideal para ejecutar tareas de IA en dispositivos Raspberry Pi. NCNN maximiza el rendimiento de la inferencia aprovechando la arquitectura ARM, proporcionando un procesamiento más rápido y eficiente en comparación con otros formatos. Para más detalles sobre las opciones de exportación admitidas, visita la página de documentaciónUltralytics sobre opciones de despliegue.

¿Cómo puedo convertir un modelo YOLO11 al formato NCNN para utilizarlo en la Raspberry Pi?

Puedes convertir un modelo PyTorch YOLO11 al formato NCNN utilizando los comandos Python o CLI :

Ejemplo

from ultralytics import YOLO

# Load a YOLO11n PyTorch model
model = YOLO("yolo11n.pt")

# Export the model to NCNN format
model.export(format="ncnn")  # creates 'yolo11n_ncnn_model'

# Load the exported NCNN model
ncnn_model = YOLO("yolo11n_ncnn_model")

# Run inference
results = ncnn_model("https://ultralytics.com/images/bus.jpg")
# Export a YOLO11n PyTorch model to NCNN format
yolo export model=yolo11n.pt format=ncnn  # creates 'yolo11n_ncnn_model'

# Run inference with the exported model
yolo predict model='yolo11n_ncnn_model' source='https://ultralytics.com/images/bus.jpg'

Para más detalles, consulta la sección Utilizar NCNN en Raspberry Pi.

¿Cuáles son las diferencias de hardware entre la Raspberry Pi 4 y la Raspberry Pi 5 relevantes para ejecutar YOLO11?

Las diferencias clave incluyen:

  • CPU: La Raspberry Pi 4 utiliza el SoC Broadcom BCM2711, Cortex-A72 de 64 bits, mientras que la Raspberry Pi 5 utiliza el SoC Broadcom BCM2712, Cortex-A76 de 64 bits.
  • Frecuencia máxima CPU : La Raspberry Pi 4 tiene una frecuencia máxima de 1,8GHz, mientras que la Raspberry Pi 5 alcanza los 2,4GHz.
  • Memoria: La Raspberry Pi 4 ofrece hasta 8 GB de SDRAM LPDDR4-3200, mientras que la Raspberry Pi 5 cuenta con SDRAM LPDDR4X-4267, disponible en variantes de 4 GB y 8 GB.

Estas mejoras contribuyen a mejorar los puntos de referencia de rendimiento de los modelos YOLO11 en la Raspberry Pi 5 en comparación con la Raspberry Pi 4. Consulta la tabla comparativa de las series Raspberry Pi para obtener más detalles.

¿Cómo puedo configurar un módulo de cámara Raspberry Pi para que funcione con Ultralytics YOLO11?

Hay dos métodos para configurar una cámara Raspberry Pi para la inferencia YOLO11:

  1. Utilizando picamera2:

    import cv2
    from picamera2 import Picamera2
    
    from ultralytics import YOLO
    
    picam2 = Picamera2()
    picam2.preview_configuration.main.size = (1280, 720)
    picam2.preview_configuration.main.format = "RGB888"
    picam2.preview_configuration.align()
    picam2.configure("preview")
    picam2.start()
    
    model = YOLO("yolo11n.pt")
    
    while True:
        frame = picam2.capture_array()
        results = model(frame)
        annotated_frame = results[0].plot()
        cv2.imshow("Camera", annotated_frame)
    
        if cv2.waitKey(1) == ord("q"):
            break
    
    cv2.destroyAllWindows()
    
  2. Utilizar un flujo TCP:

    rpicam-vid -n -t 0 --inline --listen -o tcp://127.0.0.1:8888
    
    from ultralytics import YOLO
    
    model = YOLO("yolo11n.pt")
    results = model("tcp://127.0.0.1:8888")
    

Para obtener instrucciones detalladas de configuración, visita la sección Inferencia con Cámara.

📅 C reado hace 1 año ✏️ Actualizado hace 1 mes

Comentarios