fosfeno/docs/requisitos.md

Requisitos y hardware

FOSFENO funciona en una Raspberry Pi conectada a un proyector. La Raspberry escucha el sonido de la sala a través de un micrófono USB y dibuja visuales que reaccionan a la música. Todo se gobierna desde el móvil con un navegador.

Raspberry Pi

Sirve una Raspberry Pi 4 o una Raspberry Pi 5. La Pi 5 va más holgada con los shaders y el mezclador de vídeo, así que es la recomendada si vas a usar esos modos a menudo. La Pi 4 cumple de sobra para Butterchurn e Hydra.

Necesitas además:

• La fuente de alimentación oficial. Los visuales exigen GPU y CPU; con cargadores genéricos la Pi puede reiniciarse sola.
• Una tarjeta microSD de 32 GB o más, o mejor un SSD por USB en la Pi 5.
• Disipador o ventilador. Mantener visuales en bucle calienta la placa, y si se calienta de más reduce su velocidad y las visuales van a tirones.
• Sistema operativo Raspberry Pi OS Bookworm de 64 bits, con escritorio.

Conexión con el proyector

La Pi 4 y la Pi 5 llevan salida micro-HDMI, no HDMI normal. Necesitas un cable micro-HDMI a HDMI, o un adaptador. Cualquier proyector con entrada HDMI vale. La resolución la ajusta el sistema; si el proyector es de 1280x720 las visuales irán más finas que a 1080p.

Red

El panel de control se abre desde el móvil, así que el móvil y la Raspberry tienen que estar en la misma red. El cable Ethernet es más estable que el WiFi para un evento, pero las dos opciones funcionan. Conviene fijar la IP de la Raspberry en el router para que no cambie entre un día y otro.

Micrófono USB y audio

La Raspberry Pi no tiene entrada de audio. El conector jack de la placa es solo salida. Para que FOSFENO oiga la música hay que añadir una entrada por USB.

Funcionan sin instalar nada los dispositivos que cumplen el estándar USB Audio Class. En la práctica eso es casi todo lo que se vende hoy:

• Tarjetas de sonido USB. Son adaptadores pequeños con un USB por un lado y conectores jack por el otro. Las que traen entrada de micrófono o entrada de línea sirven para enchufar el sonido desde una mesa de mezclas o desde un móvil. Dan la señal más limpia.
• Micrófonos USB. Los micrófonos de condensador tipo podcast (Fifine, Samson, Blue Snowball y similares) se conectan directos y captan el sonido de la sala. Es la opción más cómoda si no quieres tirar cables.
• Interfaces de audio USB y auriculares USB con micro. También valen mientras sean USB Audio Class, que es lo normal.

Evita los micrófonos Bluetooth. Tienen retardo y FOSFENO no los selecciona de forma automática. Evita también cualquier aparato que pida un driver del fabricante; con audio es raro, pero los hay.

FOSFENO elige la entrada automáticamente al arrancar. Busca entre las fuentes de audio del sistema la primera cuyo nombre contenga la palabra usb. Si tu dispositivo no se llama así, puedes cambiar esa palabra clave en config.json, en el apartado audio.matchSource. Desde el panel también puedes elegir a mano cualquier entrada detectada.

Recomendación práctica: para un evento con mesa de DJ, una tarjeta USB con entrada de línea conectada por jack a la salida de la mesa. Para algo casero o una fiesta, un micrófono USB que recoja el ambiente.

Cámara USB

La cámara solo hace falta para el modo Mezclador. FOSFENO está preparado para cámaras web USB.

Funcionan sin drivers las cámaras que cumplen el estándar USB Video Class, conocido como UVC. Prácticamente todas las cámaras web USB modernas lo cumplen: las de Logitech, las genéricas, las de portátil externas. Conéctala antes de encender la Raspberry y el sistema la reconoce sola. El navegador la ve a través de V4L2, el subsistema de vídeo de Linux.

Esta versión de FOSFENO no usa el módulo de cámara oficial de la Raspberry, el que va con cable plano al conector CSI. En Raspberry Pi OS Bookworm ese módulo funciona a través de libcamera y no aparece como cámara estándar para el navegador sin pasos extra. Si quieres cámara, usa una webcam USB UVC.

Recomendación práctica: cualquier webcam USB de 720p sirve. No hace falta nada caro. Si la cámara permite varias resoluciones, el navegador elige una compatible automáticamente.

Resumen de la lista de la compra

• Raspberry Pi 4 o 5 con su fuente oficial.
• microSD de 32 GB o SSD USB.
• Disipador o ventilador.
• Cable micro-HDMI a HDMI.
• Micrófono USB o tarjeta de sonido USB con entrada.
• Webcam USB UVC, solo si vas a usar el modo Mezclador.
• Cable de red, o WiFi.