Instala una Cámara en tu Raspberry Pi: Guía Definitiva

Aún recuerdo la primera vez que intenté instalar una cámara en mi Raspberry Pi. Pensé que sería plug and play, pero rápidamente me di cuenta de que no tenía idea de qué habilitar o configurar. Si te sientes igual, no te preocupes. Te guiaré a través de cada paso para que puedas hacer que tu cámara funcione en minutos.

En una Raspberry Pi, el módulo de cámara oficial se conecta directamente al puerto CSI de la cámara. Con Raspberry Pi OS, la interfaz de la cámara está habilitada por defecto y se puede probar usando el comando rpicam-still para capturar una imagen.

En esta guía, explicaré la configuración completa paso a paso, desde elegir la cámara adecuada hasta capturar tu primera imagen. También cubriré errores comunes y algunos consejos prácticos para ayudarte a que todo funcione sin problemas.

Qué se necesita para instalar una cámara en Raspberry Pi

Veamos el panorama general de qué hardware conseguir y cómo preparar tu software para usar una cámara en Raspberry Pi.

Requisitos de hardware

Todos los modelos insignia de Raspberry Pi (Pi 5 / 4 / 3 / 2 / 1), así como las placas Raspberry Pi Zero (en inglés), admiten la adición de una cámara a través de un puerto integrado en la placa.

Si ya tienes una cámara para la Raspberry Pi, perfecto, estás listo para comenzar. Pero si aún no has pedido tus accesorios, aquí hay algunos consejos.

Modelos de cámara

A diferencia de las cámaras USB vendidas para PC, la cantidad de productos disponibles para Raspberry Pi es bastante limitada; sin embargo, aún hay opciones entre estas principales alternativas.

La Fundación Raspberry Pi ofrece algunos modelos de cámara:

¿Hay otras opciones disponibles?
Si buscas una solución asequible, no hay un mejor modelo que estos. Si solo quieres tener una para fines educativos, puedes encontrar una cámara más barata.

Por ejemplo, esta fue mi primera cámara, es perfecta para aprender a usar una cámara en Raspberry Pi, pero la calidad es inferior. Cuesta la mitad, pero si tienes que comprar otra unos meses después, no vale la pena.

Accesorios adicionales

Una cámara es un dispositivo externo que a menudo permanecerá fuera de la caja, así que dependiendo de cuáles sean tus proyectos, otros accesorios pueden ser útiles.

Te daré algunos enlaces adicionales para que puedas investigar fácilmente:

• Algunas cajas son compatibles con el módulo de cámara.
  Por ejemplo, el «Argon Neo» tiene un soporte incorporado para la cámara en la caja (mira la imagen en Amazon). Para más detalles, puedes leer mi reseña completa de esta caja aquí (en inglés).
• Otra solución es mantener tu caja actual para la Raspberry Pi y usar un soporte simple, para mantener la cámara en posición adecuada.
  
  Hay muchos productos similares, puedes ver este, por ejemplo.
  Además de la ventaja de mantener tu caja actual, también es más fácil usar la cámara si puedes simplemente ponerla sobre una mesa (por ejemplo), en lugar de intentar mantenerla en el lugar y orientación correctos.
• Lo último que puedes necesitar es otro cable de cámara.
  El cable incluido mide 15 cm de largo, lo cual está bien para un uso básico, pero puede que necesites un cable más corto o más largo para ajustarlo a tus necesidades.
  En este paquete en Amazon, tienes varias longitudes de cable que puedes usar y cambiar para cada proyecto (desde 30 cm hasta 1 m).

Nota: Asegúrate de tener el cable correcto para tu Raspberry Pi.
– Las Raspberry Pi 4 / Pi 3 / Pi 2 / Pi 1 utilizan el cable estándar de 15 pines. Este cable suele incluirse con cualquier cámara Pi que compres.
– Las Pi 5 y Pi Zero / Zero 2 requieren un cable DIFERENTE de 22 pines. Probablemente tendrás que comprar este cable por separado (compra aquí).

Cómo instalar una cámara en Raspberry Pi

Ahora que tienes todo lo que necesitas, podemos comenzar con la instalación de la cámara en sí.

Instalación del hardware

Instalar una cámara en Raspberry Pi es sencillo una vez que encuentras la ubicación del puerto:

• Toma la placa de Raspberry Pi en la mano.
  Desconecta todos los cables, la Raspberry Pi debe estar apagada y desconectada de la fuente de alimentación.
• Encuentra el puerto de la cámara en la Raspberry Pi.
  Esto está en diferentes lugares dependiendo de qué placa tengas.
  • En la Pi 4 / Pi 3 / Pi 2 / Pi 1 – está ubicado entre el HDMI y la entrada de audio.
    Lo encontrarás fácilmente porque es el único que se ajusta al ancho del cable, y debería estar escrito «CAMERA» en la placa principal.
    
  • En la Pi 5 – hay dos conectores de cámara, ubicados entre el HDMI y el puerto Ethernet. Verás «CAM/DISP0» y «CAM/DISP1» impresos junto a ellos.
    
  • En la Pi Zero / Zero 2 – está ubicado en el borde derecho, junto al puerto de alimentación.
    
• Antes de conectar el cable, es posible que debas quitar la película de plástico y tirar ligeramente del plástico negro.
• Conecta el cable y empuja el plástico negro para mantener el cable dentro.
  Asegúrate de alinear ambos conectores en el mismo lado.
  En Raspberry Pi 5, conéctalo de esta manera (lado negro hacia los puertos HDMI):
  
  En otros modelos, los conectores del cable están orientados hacia el lado del puerto HDMI, así que el lado azul de la cinta debe quedar hacia los puertos USB):
  
• Luego, recomiendo comenzar con una prueba rápida antes de volver a poner todo en la caja y/o en el soporte, solo para asegurarte de que esté funcionando.

Conecta todos los cables de nuevo (alimentación, HDMI, red, USB …) y enciende la Raspberry Pi.

Si tienes alguna duda, puedes ver el primer minuto de este video sobre cómo conectar tu cámara:

Habilitar el puerto de la cámara en Raspberry Pi OS

En las versiones recientes de Raspberry Pi OS, el puerto de la cámara está habilitado por defecto, por lo que no se necesita ninguna acción en la configuración.

Para versiones más antiguas, puede que necesite habilitarse a través de la herramienta raspi-config (Interface Options > Camera) o mediante la herramienta de configuración (en la pestaña Interfaces).

Si experimentas algún problema con la instalación de la cámara o, por cualquier motivo, no funciona como se esperaba, consulta esta guía de solución de problemas para el módulo de cámara de Raspberry Pi.

Comandos para interactuar con la cámara de Raspberry Pi

Ahora introduciré dos comandos útiles para grabar y ver qué sucede con tu cámara.

Nota: raspistill y raspivid ya no son compatibles en las versiones recientes de Raspberry Pi Bullseye y posteriores. Intenta cambiar a los nuevos comandos lo antes posible, es básicamente lo mismo. Pero si aún estás usando una versión antigua (RPI OS Legacy) o has habilitado el soporte heredado, aún tienes acceso a ellos.

Tomar una foto

Lo primero que puedes intentar es simplemente tomar una foto de la imagen que ve la cámara.
«rpicam-still» es el nuevo comando en Raspberry Pi OS Bookworm (reemplazando «raspistill» y «libcamera-still»).
Ya está instalado en tu sistema.

Para usarlo, la línea de comando básica es:
rpicam-still -o image.jpg

Al ejecutar este comando, deberías ver una vista previa durante unos segundos, y luego se guardará la imagen en el archivo de destino.

Con -o defines el nombre del archivo de destino (donde se guardarán las imágenes).
Es posible usar un nombre de archivo que incluya la ruta, por ejemplo:
rpicam-still -o ~/Pictures/mipicture.jpg

Usa el parámetro -h para mostrar todas las opciones posibles para este comando:
rpicam-still -h

Aquí hay algunas opciones interesantes que puedes probar:

• –width: Establecer el ancho de la imagen de salida (predeterminado: 0, usa el predeterminado de la cámara)
• –height: Establecer la altura de la imagen de salida (predeterminado: 0, usa el predeterminado de la cámara)
• -t / –timeout: Tiempo en milisegundos durante el cual se ejecuta el programa (predeterminado: 5000 ms)
• -o / –output: Establecer el nombre del archivo de salida
• -n / –nopreview: No mostrar una ventana de vista previa
• -p / –preview: Establecer las dimensiones de la ventana de vista previa como x,y,ancho,alto (por ejemplo, 0,0,640,480; predeterminado: 0,0,0,0)
• -f / –fullscreen: Usar una ventana de vista previa en pantalla completa
• –qt-preview: Usar una ventana de vista previa basada en Qt (advertencia: causa una carga pesada en la CPU; no se admite pantalla completa)
• –rotation: Solicitar una rotación de imagen; los valores aceptados son 0 o 180 (predeterminado: 0)
• –brightness: Ajustar el brillo de la imagen de salida en el rango -1.0 a 1.0 (predeterminado: 0)
• –contrast: Ajustar el contraste de la imagen de salida, donde 1.0 = contraste normal (predeterminado: 1)
• –saturation: Ajustar la saturación del color de la salida, donde 1.0 = normal y 0.0 = escala de grises (predeterminado: 1)
• -q / –quality: Establecer el parámetro de calidad JPEG (predeterminado: 93)

Para tu información, en la edición Legacy de Raspberry Pi OS, será:
raspistill -o image.jpg

Grabar un video

Para grabar un video, el comando es similar.
«rpicam-vid» es el nombre del comando correspondiente (reemplazando «raspivid» y «libcamera-vid»).

Así que, como en las fotos, para grabar un video usa el comando:
rpicam-vid -o video.h264
Usa el atajo CTRL+C para detener la grabación, o agrega la opción -t para especificar la duración de la grabación.

Los archivos H264 son compatibles con VLC.
Si es necesario, puedes instalarlo en Raspberry Pi OS Desktop con:
sudo apt install vlc

Es lo mismo para ver todos los parámetros disponibles, usa rpicam-vid -h para obtener todas las opciones con una breve descripción. Las opciones útiles son:

• –t: para elegir la duración del video en ms (ejemplo: 6000 para un video de 6 s). De esta manera no necesitas usar CTRL+C y puedes programar la captura de video con un script o cron.
• -w y -h: tamaño del video (ancho y alto).

Transferir imágenes y videos a tu computadora (Raspberry Pi OS)

Si deseas transferir las imágenes tomadas en la Raspberry Pi a tu computadora después de esto, la forma más fácil es usar software como FileZilla o WinSCP.

FileZilla es una herramienta gratuita disponible en Windows, Linux y macOS.
Se utiliza principalmente para conectarse a servidores FTP, pero hay una opción para usarla en transferencias SFTP.
Puedes descargar los archivos de instalación aquí. SFTP es un protocolo seguro para copiar archivos en la red a través de SSH. Así que no necesitas nada más en la Raspberry Pi (solo asegurarte de que SSH esté habilitado).

De todos modos, una vez que SSH esté habilitado, aquí tienes cómo usarlo:

• Abre FileZilla
• Para probarlo rápidamente, puedes usar la opción de conexión rápida en el menú:
  
  Pero también hay un «Administrador de sitios» para almacenar todos tus servidores y conectarte sin ingresar nada.
• Completa el host con la dirección IP de Raspberry Pi.
  Luego tu nombre de usuario y contraseña (la que creaste durante la instalación).
• Haz clic en «Quickconnect» cuando estés listo.
• En el lado izquierdo, está tu computadora, navega hasta la ruta donde deseas descargar los archivos (C:\Users\username\Pictures, por ejemplo).
• En el lado derecho, está la Raspberry Pi, navega hasta la ubicación donde guardaste las imágenes o videos.
• Haz doble clic en un archivo para descargarlo.
  O selecciona varios archivos, haz clic derecho y «Download files».

Controlar la cámara con Python

Lo último interesante que quiero mostrarte es cómo usar un lenguaje de programación avanzado (Python) para ir más allá con tu cámara e incluirla como parte de proyectos más grandes.

Si eres nuevo en Python y quieres hacer más cosas en Raspberry, creo que primero deberías aprender lo básico (escribí un libro especialmente para ayudarte a hacer esto, échale un vistazo si estás interesado).

Python es el principal lenguaje de programación en Raspberry Pi. Y la buena noticia es que todo ya está disponible para usar Python directamente en Raspberry Pi OS (editores, compiladores, bibliotecas básicas, …).

Si estás en Raspberry Pi OS Desktop, hay muchos editores que puedes usar como Thonny (preinstalado) u otros que puedes instalar con apt.

El código de Python combinado con el módulo de cámara de tu Pi significa que todo es posible. Por ejemplo, podrías escribir un script que espere 5 segundos para que sonrías, reproduzca un efecto de sonido para avisarte que la cámara está a punto de activarse y luego tome una fotografía.

Para aprender a programar estas funciones avanzadas, consulta nuestro tutorial completo aquí.
(Por cierto, si encuentras lo anterior demasiado complejo, hay un comando de cámara más fácil para principiantes: Cómo Usar Picamzero para Tomar Fotos y Videos, en inglés.)

Espero que hayas disfrutado esta introducción a usar una cámara en Raspberry Pi. Si haces proyectos más grandes con tu cámara, sería genial compartirlos aquí con nosotros, ¡me encantaría!

Si buscas más ideas de proyectos que puedes hacer con una cámara (en inglés), haz clic en el enlace para encontrar mis recomendaciones y verás que todo es posible.

Y si te gustaría probar una interfaz web para controlar tu cámara Raspberry Pi (pero también cámaras de seguridad estándar), consulta mis tutoriales sobre MotionEye o ZoneMinder (en inglés).

Preguntas relacionadas

¿Cómo solucionar el error «raspistill: comando no encontrado»?

Raspistill y raspivid ya no están disponibles en las versiones recientes de Raspberry Pi OS. Han sido reemplazados por comandos «rpicam» como rpicam-still y rpicam-vid.

Consulta las secciones anteriores sobre tomar fotos y videos para aprender los nuevos comandos e interactuar con tu cámara. No intentes habilitar raspistill o raspivid, son comandos del pasado :-).

¿Puedo conectar una cámara a una Raspberry Pi Zero?

Un módulo de cámara también se puede usar con una Raspberry Pi Zero, pero se requiere una cinta diferente. Asegúrate de comprar un módulo de cámara donde se proporcione una cinta correspondiente a tu modelo de Raspberry Pi (esta, por ejemplo).

¿Cómo sé si el módulo de cámara está correctamente conectado a la Raspberry Pi?

No hay un detector o herramienta para saber si una cámara está correctamente conectada. Solo sigue el procedimiento de instalación y toma una foto de prueba para ver si funciona o si encuentras algún error.

¿Puedo usar una cámara USB en mi Raspberry Pi?

En general, Raspberry Pi es compatible con la mayoría de las cámaras USB, por lo que debería ser posible usar una en lugar del módulo de cámara. Simplemente conéctala a un puerto USB y comienza una aplicación compatible.

Puedes usarla, por ejemplo, en OBS Studio (en inglés), para grabar o transmitir el video.