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

Una cámara es imprescindible para cualquier propietario de Raspberry Pi, ya que te permite probar decenas de proyectos nuevos e interesantes (en inglés). Pero recuerdo estar confundido con mi primera cámara, sin tener idea de cómo conectarla y configurarla en mi Raspberry Pi. Si ahora estás en la misma situación, este artículo responderá todas tus preguntas.

Aquí están los pasos principales requeridos para usar un módulo de cámara en una Raspberry Pi:

• Conectar el módulo al puerto de la cámara de la Raspberry Pi.
• Habilitar el puerto de la cámara en la herramienta de configuración de la Raspberry Pi (pestaña «Interfaces»).
• Confirmar que la cámara está funcionando con: rpicam-still -o test.jpg.

En esta guía, también te mostraré cómo elegir la cámara. Luego explicaré cada paso de la instalación y te daré algunos consejos que necesitas saber para disfrutar inmediatamente de tu nuevo dispositivo.

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

Requisitos de hardware

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í tienes 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, todavía hay una elección que hacer entre estas opciones principales:

	Official Raspberry Pi Camera Module	Raspberry Pi Camera Module 3 NoIR	Raspberry Pi HQ Camera
Especificaciones	12 megapíxeles 4608 × 2592 1080p50	12 megapíxeles 4608 × 2592 1080p50 Visión Nocturna Infrarroja	12.3 megapíxeles Se requiere lente 1080p
Precio	Enlace de compra	Enlace de compra	Ver en Amazon

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

• La cámara oficial fue la primera disponible y se ha actualizado en 2023 (para v3).
  Es una cámara de alta calidad con un sensor de 12 megapíxeles que te permite obtener fotos en HD (4608 × 2592 píxeles) y videos (1080p máx). Este modelo es compatible con cualquier modelo de Raspberry Pi y fácil de instalar en Raspberry Pi OS (veremos eso más adelante).
  
• La segunda (NoIR) es casi la misma. Es la cámara oficial excepto sin filtro IR, lo que te permite tomar fotografías nocturnas. Se utiliza a menudo para cámaras de seguridad o para tomar fotos en un entorno con poca luz.
  
• La tercera opción es un modelo de cámara de alta calidad. Es como una cámara réflex pequeña, y puedes ponerle lentes adicionales.
  
• Por último, aparte del Raspberry Pi AI Kit (en inglés), recientemente se ha lanzado una Cámara AI para Raspberry PI que funciona en todos los modelos de Pi. Se puede usar para proyectos de IA con TensorFlow (en inglés) y PyTorch, entre otras aplicaciones.

Accesorios adicionales

Una cámara es un dispositivo externo que a menudo se quedará fuera del estuche, así que dependiendo de cuáles sean tus proyectos, otros accesorios podrían ser útiles.

Solo te daré algunos enlaces adicionales para que los revises, así podrás hacer tu investigación fácilmente:

• Algunos estuches son compatibles con el módulo de la cámara.
  Por ejemplo, el “Argon Neo” tiene un soporte incorporado para la cámara en el estuche (mira la imagen en Amazon). Para más detalles, puedes leer mi reseña completa de este estuche aquí (en inglés).
• Otra solución es mantener tu carcasa actual para la Raspberry Pi y usar un soporte simple para asegurar la cámara.
  
  Hay muchos productos similares, mira este ejemplo.
  Además del beneficio de conservar tu carcasa actual, también es más fácil usar la cámara si puedes simplemente ponerla sobre una mesa —según sea el caso—, en lugar de intentar mantenerla en el lugar y orientación correctos.
• Lo último a considerar es otro cable de cámara.
  El cable incluido tiene 15 cm de largo, está bien para un uso básico, pero puede que necesites uno más corto o más largo que se adapte a tus necesidades.
  En este paquete en Amazon, tienes algunas longitudes disponibles para usar y cambiar, dependiendo del proyecto (de 30 cm a 1 m).

Cómo instalar una cámara en Raspberry Pi

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

Instalación de hardware

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

• Toma la placa 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 (entre los puertos HDMI y de audio).
  Lo encontrarás fácilmente porque es el único que se adapta al ancho del cable, y debería estar escrito “Camera” en la placa principal.
  
• Antes de enchufar el cable, es posible que debas quitar la película plástica y tirar ligeramente del plástico negro.
• Enchufa el cable y empuja el plástico negro para mantener el cable dentro.
  Asegúrate de alinear ambos conectores en el mismo lado (conectores del cable al lado del puerto HDMI, lado azul de la cinta hacia los puertos USB):
  
• Luego te recomiendo empezar con una prueba rápida antes de volver a poner todo en la caja y/o en el soporte, solo para asegurarte de que funciona.

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

Actualización: Si estás usando la última versión de Raspberry Pi OS, ya no necesitas seguir los pasos a continuación, ya que el puerto de la cámara ahora está habilitado por defecto. Mantengo las instrucciones para los archivos, pero puedes omitir este paso para una nueva instalación.

Antes de usar la cámara en tu Raspberry Pi, debes habilitarla en tu sistema. El puerto de la cámara está deshabilitado por defecto.

• Conectar a la Raspberry Pi vía SSH (puedes encontrar consejos útiles aquí para conectar vía SSH desde tu computadora).
  Si prefieres, puedes usar un terminal en el escritorio de Raspberry Pi OS, o incluso usar la versión Lite.
• Iniciar la herramienta raspi-config (en inglés):
  sudo raspi-config
• Ir a “Interface options” > “Camera”:
  
• “Would you like the camera interface to be enabled?”.
  «Yes!»
• Salir de «raspi-config» y aceptar reiniciar el dispositivo.

Eso es todo lo que necesitas hacer.
Después del reinicio, la cámara está lista para usar.

Nota: Si eres nuevo en esto y usas la versión de Escritorio, no tienes que escribir ningún comando. Simplemente abre la herramienta de Configuración de Raspberry Pi (en el menú principal > «Preferences»). Haz clic en la pestaña “Interfaces” y habilita la cámara.

Si experimentas algún problema con la instalación de la cámara o, por alguna razón, no funciona como esperabas, por favor revisa esta guía de solución de problemas para el módulo de cámara Raspberry Pi.

Comandos para interactuar con la cámara de Raspberry Pi

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

Nota: los comandos raspistill y raspivid ya no son compatibles en Raspberry Pi Bullseye y versiones más nuevas. Intenta cambiar a los nuevos comandos tan pronto como sea posible, básicamente es lo mismo. Pero si todavía usas 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 vista por la cámara.
“rpicam-still” es el nuevo comando en Raspberry Pi OS Bookworm (que reemplaza “raspistill” y “libcamera-still”).
Ya está instalado en tu sistema.

Para usarlo, el comando básico es:
rpicam-still -o image.jpg

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

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

Aquí hay unas cuantas opciones interesantes que puedes intentar:

--width arg (=0) Set the output image width (0 = use default value)
--height arg (=0) Set the output image height (0 = use default value)
-t [ --timeout ] arg (=5000) Time (in ms) for which program runs
-o [ --output ] arg Set the output file name
-n [ --nopreview ] =arg(=1) Do not show a preview window-p [ --preview ] arg (=0,0,0,0) Set the preview window dimensions, given as x,y,width,height e.g. 0,0,640,480
-f [ --fullscreen ] =arg(=1) Use a fullscreen preview window
--qt-preview =arg(=1) Use Qt-based preview window (WARNING: causes heavy CPU load, fullscreen not
supported)
--rotation arg (=0) Request an image rotation, 0 or 180
--brightness arg (=0) Adjust the brightness of the output images, in the range -1.0 to 1.0
--contrast arg (=1) Adjust the contrast of the output image, where 1.0 = normal contrast
--saturation arg (=1) Adjust the colour saturation of the output, where 1.0 = normal and 0.0 =
greyscale
-q [ --quality ] arg (=93) Set the JPEG quality parameter

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 (que reemplaza “raspivid” y “libcamera-vid”).

De la misma manera que con 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 añade 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. Opciones útiles:

• –t: para elegir la duración del video en ms (ej: 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: dimensiones del video (ancho y alto).

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

Tal vez te estés preguntando cómo descargar imágenes en tu computadora después de esto.

La forma más sencilla es usar software como FileZilla o WinSCP:

• FileZilla es una herramienta gratuita disponible en Windows, Linux y macOS.
  Se usa principalmente para conectar a servidores FTP, pero hay una opción para usarlo en transferencias SCP.
  Puedes descargar los archivos de instalación aquí.
  SCP es un protocolo seguro para copiar archivos en la red mediante SSH. Así que, no necesitas nada más en la Raspberry Pi (solo asegúrate de que SSH esté habilitado).
• Abre FileZilla
• Para probarlo, puedes usar la opción de conexión rápida bajo el menú:
  
  Igualmente, hay un “site manager” para almacenar todos tus servidores y conectarte sin ingresar nada.
• Rellena el host con la dirección IP de la 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 quieras 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”.
Obtiene mi hoja de trucos de comandos
Obtiene su archivo PDF gratuito con todos los comandos que necesitas saber sobre Raspberry Pi.
Descargar

Controlar la cámara con Python

La última cosa 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 deberías aprender lo básico primero. Escribí un libro especialmente para ayudarte a hacer esto, échale un vistazo si te interesa.

Python es el lenguaje de programación principal 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 (en inglés) como Thonny (preinstalado) u otros que puedes instalar con apt.



El código 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 a que sonrías, reproduzca un efecto de sonido para informarte que la cámara está a punto de activarse, y luego tome una fotografía.

Para aprender cómo programar estas características avanzadas, revisa nuestro tutorial completo aquí (en inglés).

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

Si buscas más ideas de proyectos 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 animas a probar una interfaz web para controlar tu cámara Raspberry Pi (o también cámaras de seguridad estándar), revisa mis tutoriales sobre MotionEye o ZoneMinder (en inglés).

Obtiene mi hoja de trucos de comandos
Obtiene su archivo PDF gratuito con todos los comandos que necesitas saber sobre Raspberry Pi.
Descargar

Preguntas relacionadas

¿Cómo solucionar el error “raspistill: command not found”?

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

Revisa las secciones anteriores sobre cómo 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 Raspberry Pi Zero?

Un módulo de cámara también se puede usar con Raspberry Pi Zero, pero se requiere un cable diferente. Asegúrate de comprar el módulo de cámara que traiga el cable correspondiente a tu modelo de Raspberry Pi (este, por ejemplo).

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

No hay detector ni 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. Solo tienes que conectarla a un puerto USB e iniciar una aplicación compatible.

Puedes usarla en OBS Studio (en inglés), por ejemplo, para grabar o hacer streaming de video.