# Conectarse al panel

Esta es la parte donde, sin cuidado, la gente se atasca: la Raspberry funciona,
las visuales salen por el proyector, pero el usuario no sabe en qué dirección
está el panel de control. FOSFENO está pensado para que ese paso no exista
como problema.

## La idea: encender y ver

Cuando la Raspberry arranca, antes de ponerse a dibujar visuales, el proyector
muestra una pantalla de conexión durante unos segundos. En esa pantalla salen
tres cosas:

- Un código QR grande.
- La dirección del panel.
- Un recordatorio de que el móvil tiene que estar en la misma red.

Esa misma pantalla vuelve a aparecer siempre que apagas las visuales desde el
panel. Así, si en mitad de un evento alguien necesita la dirección, basta con
darle a apagar y la tiene delante en el proyector.

## Tres formas de entrar, de la más fácil a la menos

**Escanear el código QR.** Abre la cámara del móvil, apúntala al QR que sale en
el proyector y toca el aviso que aparece. Se abre el panel. No hay que escribir
nada. Es la forma recomendada.

**Escribir el nombre.** En el navegador del móvil, escribe:

```
http://fosfeno.local/
```

Esta dirección no cambia nunca, da igual el día o la red. El instalador le pone
a la Raspberry el nombre de red `fosfeno`, y `fosfeno.local` es la forma
estándar de localizar un equipo por su nombre en la red local.

**Escribir la dirección IP.** Es la que aparece en la pantalla de conexión del
proyector, algo como `http://192.168.1.XX/`. Funciona siempre, pero la IP puede
cambiar de un día para otro, así que es la opción de reserva.

## El móvil tiene que estar en la misma red

El panel es una página local: vive dentro de la Raspberry, no en internet. Para
abrirla, el móvil y la Raspberry tienen que estar conectados a la misma red:
el mismo router, ya sea por WiFi o por cable.

No funciona si el móvil está con datos móviles, ni si está en una red WiFi
distinta (por ejemplo, una red de invitados separada).

## Sobre `fosfeno.local`

El nombre `.local` funciona gracias a un sistema llamado mDNS, que ya viene
activado en Raspberry Pi OS. Lo entienden los iPhone, los Android modernos,
Windows y Mac sin instalar nada.

Si en algún móvil viejo `fosfeno.local` no abre, no pasa nada: usa el código QR
o la dirección IP, que aparecen igualmente en el proyector.

Puedes cambiar ese nombre. Edita `config.json`, el apartado `network.hostname`,
y vuelve a ejecutar `bash install.sh`. El panel quedará entonces en
`http://el-nombre-que-pongas.local/`.

## Sobre el router

No hace falta tocar nada en el router. FOSFENO no abre puertos hacia internet
ni necesita configuración especial. Solo usa la red local.

Un único ajuste es recomendable, aunque opcional: entrar en el router y
reservarle a la Raspberry siempre la misma IP (lo que se suele llamar reserva
DHCP o IP fija). Así la dirección IP no cambia nunca. De todas formas, como el
nombre `fosfeno.local` ya es fijo, puedes saltarte esto sin problema.

Para un evento, el cable de red entre la Raspberry y el router es más fiable
que el WiFi.

## Si no consigues conectar

Repasa estas cosas, en orden:

- El móvil está en la misma red WiFi que la Raspberry, no en datos móviles.
- Has escrito `http://` delante, y la barra `/` al final.
- Prueba las tres vías: primero el QR, si no el nombre, si no la IP.
- Mira la pantalla de conexión del proyector: la dirección que sale ahí es la
  buena en este momento.

Si el proyector no muestra ni siquiera la pantalla de conexión, el problema no
es de red sino de arranque; en ese caso mira la guía de
[solución de problemas](problemas.md).
