fosfeno/docs/requisitos.md
hacklab ff4d47c621 Documentacion: imagenes de Raspberry Pi 5, MilkDrop y Hydra
Anade tres imagenes a docs/assets/ y las enlaza en la documentacion: raspberry-pi-5.jpg en requisitos.md, y milkdrop.jpg e hydra.png en uso.md, junto a la descripcion de los motores. Actualiza docs/assets/README.md con la lista de imagenes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 18:27:38 +02:00

99 lines
4.5 KiB
Markdown

# 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
![Raspberry Pi 5](assets/raspberry-pi-5.jpg)
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.