# Primeros pasos con Copilot EFB

Cómo crear tu cuenta, instalar la app en tu teléfono, tableta o computadora, configurarla para tu aeronave y tus aeródromos, usarla sin señal, administrar tus claves y conectarla con RogerATC para X-Plane.

https://rogeratc.app/docs/copilot-efb/

## Qué es Copilot EFB

Copilot EFB es un maletín de vuelo electrónico para iPhone, iPad, Android y navegadores de escritorio, pensado para la aviación general y con las fuentes argentinas primero. Planificas la ruta en el mapa, presentas el plan de vuelo, consultas la meteorología, los NOTAM y la información de aeródromos, recorres tus listas de chequeo, llevas tu libro de vuelo y te llevas todo al aire sin señal.

- **Pensado para volar sin señal.** Después de la primera carga funciona sin conexión; lo que descargaste queda en el dispositivo con su antigüedad a la vista.
- **Sin tienda de aplicaciones.** Es una app web que se instala desde el navegador, y es la misma en todos los dispositivos.
- **Una cuenta, todos tus dispositivos.** Lo que creas aparece en tu teléfono, tu tableta y tu computadora.
- **En español y en inglés**, con los identificadores aeronáuticos —METAR, TAF, QNH, NOTAM, designadores de pista— nunca traducidos.
- **Gratis durante la beta.** Esta es la versión 1.0 beta.

Copilot EFB es un producto independiente y funciona perfectamente sin simulador. También es la cuenta que exige **RogerATC**, el controlador de tránsito aéreo con IA para X-Plane 12: mira **Usarlo con RogerATC** más abajo.

## Crea tu cuenta

```
https://copilot.rogeratc.app/sign-up
```

- Abre [copilot.rogeratc.app/sign-up](https://copilot.rogeratc.app/sign-up).
- Ingresa tu nombre (aparece en tus planes de vuelo; lo puedes cambiar después), tu correo y una contraseña de al menos 10 caracteres con mayúsculas, minúsculas y un número.
- Ingresa el código de seis dígitos que llega a tu correo para confirmar la cuenta, y después inicia sesión.

El idioma que elijas ahí es el que usan la app y sus correos. Si olvidas la contraseña, usa **Olvidé mi contraseña** en la pantalla de inicio de sesión y te llega un código por correo.

> Para iniciar sesión necesitas conexión. Una vez dentro, la app sigue funcionando sin señal, y en Ajustes puedes elegir cuánto tiempo sigues con la sesión iniciada sin conexión.

## Instálalo en tus dispositivos

Copilot EFB es una app web progresiva: abres [copilot.rogeratc.app](https://copilot.rogeratc.app) en el navegador y la agregas a tu pantalla de inicio. Así tiene su propio ícono y se abre a pantalla completa como cualquier otra app. Instalarla también hace mucho menos probable que el navegador borre sus datos sin conexión.

```
https://copilot.rogeratc.app
```

| Dispositivo | Cómo instalarla |
|---|---|
| iPhone y iPad | Abre la dirección en **Safari**, toca **Compartir** y elige **Agregar a inicio**. |
| Android | Ábrela en **Chrome**, abre el menú y elige **Instalar app** (o **Agregar a la pantalla principal**). |
| Computadora | Úsala en cualquier navegador moderno para planificar en pantalla grande. En **Chrome** o **Edge**, el botón de instalar de la barra de direcciones la convierte en una app. |

Inicia sesión en cada dispositivo con la misma cuenta y tus datos aparecen en todos.

## Primeros pasos

La primera vez que inicias sesión, un breve recorrido de bienvenida muestra las pantallas principales; ciérralo cuando quieras y vuelve a abrirlo desde el ícono de la gorra en el Inicio. El Inicio también tiene una **lista de configuración** con un botón a cada pantalla; sus pasos se marcan solos a medida que los completas.

### 1. Agrega tu aeronave

No viene nada precargado, a propósito: los datos de rendimiento y las listas deben salir del manual aprobado de tu propia aeronave. Crea un perfil por matrícula con sus pesos, combustible, velocidad y consumo de crucero, velocidades V, distancia de despegue, equipamiento para el plan de vuelo, colores y marcas. Todo lo demás —el plan de vuelo, el peso y balanceo, el asistente, el mapa, el libro de vuelo— lo usa.

### 2. Recorre Ajustes

- **Dónde vuelas:** tu región, tu aeródromo base (el Inicio y la meteorología parten de ahí), la variación magnética (automática por defecto, según el World Magnetic Model), la altitud de transición y la dirección de la oficina ARO/AIS a la que se envían los planes de vuelo.
- **Unidades, hora y formato numérico:** nudos y pies, la hora Zulu primero y el tema oscuro vienen por defecto; elige DD/MM o MM/DD y 24 o 12 horas.
- **Fuentes de datos:** qué proveedor responde por cada tipo de dato. Mira **Claves y fuentes de datos** más abajo.

### 3. Tu perfil de piloto, aeródromos y listas

Carga tu nombre, teléfono, licencia, habilitaciones y certificado médico con sus vencimientos: tu nombre y teléfono completan cada plan de vuelo. Busca tus aeródromos habituales para crear sus fichas, y transcribe tus listas desde el manual.

## Qué puedes hacer con la app

### Planificar en el mapa

Toca un aeródromo, un VOR, un NDB o un punto significativo y elige **Salir desde acá**; cada lugar que agregas después es el tramo siguiente. Cada tramo muestra el rumbo magnético con corrección de viento, la derrota, la distancia, la velocidad respecto al suelo, el tiempo y el combustible según tu aeronave y el viento pronosticado, y los totales te dicen el combustible mínimo a cargar y si se cumple la reserva. El mapa también muestra las aerovías argentinas del AIP, el espacio aéreo con su clase y límites, los puntos significativos, el radar, el tránsito y tu alcance de planeo. Las planificaciones se importan y exportan como GPX, y puedes planificar en vivo con un copiloto.

### El plan de vuelo

Una planificación se convierte en el plan de vuelo OACI en el formulario de EANA, validado contra el Doc 4444 mientras escribes, con tu aeronave y tu perfil completando la mayoría de las casillas. Lo revisas en pantalla, lo firmas con el dedo y lo envías por correo a la oficina ARO/AIS, con copia para ti. También se exporta a X-Plane, Microsoft Flight Simulator y clientes de VATSIM, y una hoja de ruta en PDF va a tu tablilla. Revisa siempre la vista previa: es una presentación a tu nombre.

### Meteorología, NOTAM y aeródromos

METAR y TAF decodificados junto al informe original, con una franja hora por hora; los NOTAM y el MADHEL directamente de ANAC; y una ficha para cada aeródromo al que vuelas: frecuencias, pistas, radioayudas, combustible, contactos, diagramas y tus notas, con la cabecera favorecida por el viento en verde. Busca por OACI, IATA, código nacional, nombre o localidad. Cada valor muestra su fuente y su antigüedad, y la app distingue "sin NOTAM" de "no se pudo consultar".

### En la cabina y después del vuelo

- **Listas de chequeo** de tu propio manual, recorridas ítem por ítem, con los críticos marcados. **Nuevo vuelo** las recorre todas en orden.
- **Peso y balanceo** y trece **calculadoras** —altitud de densidad y distancia de despegue, viento, descenso, combustible, niveles y más—, cada una con su desarrollo.
- **Anotaciones** para autorizaciones y el ATIS, con teclado, voz o el dedo.
- **Libro de vuelo** con las columnas de ANAC y totales que cierran.
- **Resiliencia:** ejercicios de respiración y concentración con sus estudios citados, y un registro privado de cómo sentiste cada fase de tus vuelos.

### El asistente

Pregúntale por escrito o por voz y responde con tus propios datos —tu aeronave, tus fichas, la meteorología guardada, tus notas—, mostrando cada consulta que hizo. Nunca da cifras de memoria y no guarda nada sin que lo aceptes. Usa tu propia clave de Claude, ChatGPT, Grok u OpenRouter, que cargas en **Ajustes → Asistente**; las llamadas van de tu dispositivo directamente a ese proveedor. Es opcional: todo lo demás funciona sin él.

### Copilotos

Invita a los pilotos con los que vuelas por correo o con un código QR. Pueden enviarse planes de vuelo, aeronaves con sus listas, fichas de aeródromo y notas —lo que llega es una copia propia del otro piloto—, escribirse en Mensajes y planificar una ruta juntos, en vivo. Tu licencia, tu libro de vuelo, tus ajustes y tus claves nunca viajan.

## Volar sin señal y mantener tus dispositivos al día

Todo lo que escribes se guarda solo, con o sin señal, y sube a tu cuenta cuando vuelve la conexión. Antes de salir, con Wi-Fi, prepara el dispositivo:

- Toca **Sincronizar ahora** para que todo lo que guardaste en otros dispositivos esté en este.
- Usa el botón de sincronización para descargar informes, NOTAM, MADHEL y diagramas de los aeródromos de tu briefing: hasta 40 de una vez.
- Si Ajustes avisa que el almacenamiento no es persistente, instala la app en la pantalla de inicio y solicita almacenamiento persistente, para que el navegador no borre tu caché.

Nada se borra por viejo: un METAR de hace una hora es mejor que ninguno, así que los datos viejos quedan, bien marcados con su antigüedad, hasta que los borres tú en **Ajustes → Almacenamiento**.

## Claves y fuentes de datos

En **Ajustes → Fuentes de datos** eliges un proveedor para cada tipo de dato —METAR, TAF, NOTAM, vientos en altura, capas del mapa, radar, tránsito— y cargas las claves de los que la necesitan. Solo se consulta la fuente que elegiste; si no puede responder, el valor aparece como faltante en lugar de completarse con otra. Cada fuente tiene un enlace **Dónde pedir la clave**, y la mayoría son gratuitas. Las fuentes argentinas van primero donde existen.

### Claves que usa RogerATC

Si vuelas con RogerATC, sus claves también están en esta sección, en **Claves que usa RogerATC**. El plugin las obtiene de tu cuenta cada vez que arranca, así que nunca las escribes en el simulador.

| Clave | Para qué la usa RogerATC |
|---|---|
| OpenAI | **Obligatoria.** Reconocimiento de voz, la voz del controlador y el modelo de lenguaje. |
| openAIP | Opcional. Espacio aéreo actualizado para el instructor. |
| Windy | Opcional. Pronósticos de viento en altura para el instructor. |
| Flightradar24 | Opcional. El movimiento en la frecuencia sigue al tránsito real (solo una cantidad). |
| Tavily | Opcional. Búsqueda web para el instructor, limitada a fuentes aeronáuticas. |

Cuando el propio EFB usa una clave que RogerATC también obtuvo en los últimos 30 días, aparece marcada como **usada por Copilot EFB y RogerATC**; una clave que solo necesita el plugin aparece como exclusiva de RogerATC. Cambiar una clave compartida la cambia para las dos aplicaciones.

> Tus claves se guardan en tu cuenta y viajan en tus propias copias de seguridad, pero nunca en nada que compartas con otro piloto. Cada clave se envía solo al proveedor que la emitió.

## Acceso a la API

Cada cuenta tiene una clave de API personal, que aparece en **Ajustes → Acceso a la API** junto con la URL base, cuándo se creó o se rotó por última vez y cuánto se usó por día. Empieza con:

```
rat_live_…
```

Con ella, un script, una planilla o RogerATC pueden leer tus propios datos: aeronaves, fichas de aeródromo, notas, planes de vuelo, libro de vuelo y perfil. Lo único que puede escribir son las sesiones que envía RogerATC. Cada consulta lleva la clave en un encabezado:

*Forma de una consulta*

```
GET https://api.rogeratc.app/v1/…
Authorization: Bearer rat_live_…
```

- Cópiala con el botón de copiar, nunca desde una captura, y nunca la pegues en un lugar público.
- Si crees que alguien la vio, toca **Rotar clave**. La anterior deja de funcionar al instante, así que dale la nueva a RogerATC Setup y a cualquier otra integración.
- La referencia completa está en rogeratc.app, en la documentación de la API.

## Usarlo con RogerATC

RogerATC es el controlador de tránsito aéreo con IA para X-Plane 12, y necesita una cuenta de Copilot EFB. Vincularlo lleva tres pasos:

- Copia tu clave en **Ajustes → Acceso a la API**.
- Carga tu clave de OpenAI, y las opcionales que quieras, en **Ajustes → Claves que usa RogerATC**.
- Pega la clave del EFB en **RogerATC Setup** en tu computadora y vincúlala.

### La pantalla RogerATC

- **Tu plugin:** si está vinculado, cuándo se vio por última vez, tus instalaciones (sistema operativo y versiones de RogerATC y de X-Plane), arranques, sesiones, tiempo en frecuencia y transmisiones en 7, 30 y 90 días, y un aviso cuando hay un RogerATC más nuevo.
- **Sesiones:** una por vuelo en X-Plane, la más nueva primero, con precisión de colaciones, pedidos de repetición, tiempos de respuesta, estaciones, aeródromos y aeronaves. Borrar una sesión la quita de todos tus dispositivos.
- **Consola en vivo:** con el enlace en vivo activado en RogerATC, la aeronave en un mapa con su altitud, velocidades, rumbo, código de transpondedor, COM1 y viento, y botones para pedirle instrucciones al controlador: esperas, virajes de reversión, radiales, arcos DME, aproximaciones de todo tipo, SID, STAR, trabajo en el circuito y más. El piloto las escucha por radio; una que no corresponde, o que no está en los datos de X-Plane del piloto, se rechaza con un motivo.

> RogerATC siempre envía a tu cuenta un resumen estadístico de cada sesión —horarios, aeronave, aeródromos y conteos— y, solo si eliges *Completo* en RogerATC, una transcripción recortada. Nunca envía audio, datos de navegación ni una trayectoria.

## Privacidad y tus datos

- Tus datos viven en tu cuenta y en tus dispositivos. En una tableta compartida, cada piloto inicia sesión con su cuenta y ve solo sus datos.
- Qué se sincroniza: aeronaves, listas, planes de vuelo, planificaciones, libro de vuelo, fichas de aeródromo, notas, documentos, conversaciones y memoria del asistente, mensajes, sesiones de RogerATC y tus ajustes y disposición.
- Las consultas del asistente van de tu dispositivo directamente al proveedor que elegiste, no por nuestros servidores. Tu número de licencia y tu certificado médico quedan fuera del alcance de todas las herramientas del asistente.
- Tus reflexiones de Resiliencia son privadas: no se comparten con copilotos y nunca salen por la API.
- Las notificaciones están apagadas hasta que las activas, dispositivo por dispositivo, y dicen quién escribió, nunca qué.
- **Ajustes** te permite hacer un archivo de respaldo, cerrar sesión (este dispositivo conserva su copia), restablecer la cuenta o eliminarla definitivamente.

## Solución de problemas

#### Falta una función o la app parece desactualizada

La app nunca se actualiza sola, así que nada recarga la pantalla en vuelo. Abre **Ajustes → Versión de la aplicación** y toca **Buscar actualizaciones**; **Actualizar ahora** aparece solo cuando hay algo nuevo, y un aviso también te indica cuando hay una versión nueva disponible. Actualiza en tierra, con buena conexión.

#### No puedo iniciar sesión

Para iniciar sesión necesitas conexión. Revisa el correo y la contraseña, usa **Olvidé mi contraseña** si hace falta y, si la cuenta nunca se confirmó, ingresa el código de seis dígitos de tu correo. Una cuenta pausada conserva sus datos; vuelve a funcionar cuando se reactiva.

#### Faltan datos sin señal

Solo está disponible lo que se descargó antes. La próxima vez, sincroniza antes de salir, instala la app en la pantalla de inicio y asegúrate de que el almacenamiento sea persistente.

#### Dos dispositivos no coinciden

Toca **Sincronizar ahora** en los dos, con conexión. La sección de la cuenta en Ajustes también tiene una verificación de integridad.

#### Una capa del mapa o una fuente no muestra nada

Probablemente la fuente elegida necesita una clave. Abre **Ajustes → Fuentes de datos**, carga la clave y usa el botón de prueba de esa fuente.

#### RogerATC dice que la cuenta no está vinculada

Copia la clave actual de **Ajustes → Acceso a la API** —si la rotaste, la anterior ya no funciona— y pégala en RogerATC Setup.

## Una ayuda, no la autoridad

Copilot EFB es una herramienta de consulta para planificar y verificar. **No es un dispositivo aprobado ni certificado**, su mapa no es navegación certificada y los sensores del teléfono se muestran como orientativos. El AIP, los NOTAM y el MADHEL oficiales, el manual de vuelo de tu aeronave y sus instrumentos son siempre la referencia principal, y la decisión es siempre del piloto.

---

© RogerATC · https://rogeratc.app
