# 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 en Latinoamérica y con las fuentes regionales primero. Planificás la ruta en el mapa, presentás el plan de vuelo, consultás la meteorología, los NOTAM y la información de aeródromos, recorrés tus listas de chequeo, llevás tu libro de vuelo y te llevás 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 creás 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.38 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: mirá **Usarlo con RogerATC** más abajo.

## Creá tu cuenta

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

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

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

> Para iniciar sesión necesitás conexión. Una vez dentro, la app sigue funcionando sin señal, y en Ajustes podés elegir cuánto tiempo seguís con la sesión iniciada sin conexión.

## Instalalo en tus dispositivos

Copilot EFB es una app web progresiva: abrís [copilot.rogeratc.app](https://copilot.rogeratc.app) en el navegador y la agregás 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 | Abrí la dirección en **Safari**, tocá **Compartir** y elegí **Agregar a inicio**. |
| Android | Abrila en **Chrome**, abrí el menú y elegí **Instalar app** (o **Agregar a la pantalla principal**). |
| Computadora | Usala 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. |

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

## Primeros pasos

La primera vez que iniciás sesión, un breve recorrido de bienvenida muestra las pantallas principales; cerralo cuando quieras y volvé 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. Agregá 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. Creá 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. Recorré Ajustes

- **Dónde volás:** 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; elegí DD/MM o MM/DD y 24 o 12 horas.
- **Fuentes de datos:** qué proveedor responde por cada tipo de dato. Mirá **Claves y fuentes de datos** más abajo.

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

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

## Qué podés hacer con la app

### Planificar en el mapa

Tocá un aeródromo, un VOR, un NDB o un punto significativo y elegí **Salir desde acá**; cada lugar que agregás 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 podés 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 escribís, con tu aeronave y tu perfil completando la mayoría de las casillas. Lo revisás en pantalla, lo firmás con el dedo y lo enviás por correo a la oficina ARO/AIS, con copia para vos. 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. O traé tu último plan de SimBrief con **Importar de SimBrief**: tu usuario de SimBrief queda en tu perfil de piloto, el plan se consulta solo cuando tocás y ves cada casilla antes de que se guarde. Revisá 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 volás: 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.

### Educación teórica

La teoría del vuelo como un recorrido de lecciones, desde cero hasta instrumentos y comercial: hoy 123 lecciones con contenido, con figuras animadas que podés mover, ejemplos resueltos, controles rápidos, tarjetas, práctica y un cuestionario que se aprueba con 80 %. Tu lugar y cada respuesta se guardan en todos tus dispositivos, y con RogerATC conectado las lecciones muestran valores en vivo de X-Plane. Las lecciones que todavía se escriben aparecen como **Próximamente**. Es universal y educativa: **no es el programa oficial de ningún país ni reproduce preguntas de examen**; para tu licencia valen el material y el examen de tu autoridad.

### Notificaciones

Se activan dispositivo por dispositivo y te avisan cuando algo cambia en tus aeródromos: un NOTAM nuevo, o un aeródromo que queda por debajo de VFR. Para silenciar un aeródromo, elegilo en **Notificaciones** o directamente desde una de sus alertas; los demás siguen avisándote. Los administradores también pueden elegir recibir alertas de nuevos registros e inicios de sesión.

### El asistente

Preguntale 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 del proveedor de IA que elijas, que cargás en **Ajustes → Asistente**; las llamadas van de tu dispositivo directamente a ese proveedor. Es opcional: todo lo demás funciona sin él.

### Copilotos

Invitá a los pilotos con los que volás 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 escribís se guarda solo, con o sin señal, y sube a tu cuenta cuando vuelve la conexión. Antes de salir, con Wi-Fi, prepará el dispositivo:

- Tocá **Sincronizar ahora** para que todo lo que guardaste en otros dispositivos esté en este.
- Usá 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, instalá 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 vos en **Ajustes → Almacenamiento**.

## Claves y fuentes de datos

En **Ajustes → Fuentes de datos** elegís un proveedor para cada tipo de dato —METAR, TAF, NOTAM, vientos en altura, capas del mapa, radar, tránsito— y cargás 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 volás 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 escribís 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. |
| Otros proveedores de IA | Opcional. El modelo de lenguaje, si en RogerATC elegís otro proveedor. Son las mismas claves del asistente. |

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, planificaciones, planes de vuelo, libro de vuelo y perfil. De entrada no cambia nada de lo que cargaste: lo único que escribe son las sesiones y el estado en vivo del propio RogerATC. Cada consulta lleva la clave en un encabezado:

*Forma de una consulta*

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

- Copiala 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, tocá **Rotar clave**. La anterior deja de funcionar al instante, así que dale la nueva a RogerATC Setup y a cualquier otra integración.
- **Permitir cambios por la API**, en la misma pantalla, deja que la clave también cargue horas en tu libro de vuelo, arme un plan de vuelo de punta a punta — planificación, navlog, plan OACI, validación, presentado — y cree o cambie aeronaves, fichas de aeródromo, notas y checklists. Cada cambio llega a todos tus dispositivos como uno hecho en la app. Dejalo apagado salvo que un script tuyo lo necesite; al apagarlo vale de inmediato. RogerATC no lo necesita.
- 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 cuatro pasos:

- Leé la [página de RogerATC](https://rogeratc.app/descargar/) y descargá el instalador para tu sistema operativo (macOS o Windows). La pantalla RogerATC del EFB tiene el mismo enlace.
- Copiá tu clave en **Ajustes → Acceso a la API**.
- Cargá tu clave de OpenAI, y las opcionales que quieras, en **Ajustes → Claves que usa RogerATC**.
- Pegá la clave del EFB en **RogerATC Setup** en tu computadora y vinculala.

### 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.
- **Uso de IA y costo estimado:** para qué se usaron tus propias claves en los últimos 30 días, por RogerATC y por el asistente del EFB, modelo por modelo, con una estimación según precios públicos con fecha. Es una estimación: la factura de tu proveedor es la que vale.
- **Tu vuelo, en vivo:** con el enlace en vivo activado en RogerATC, un mapa centrado en tu avión que lo sigue y dibuja la traza que vas volando. La traza se guarda solo en ese dispositivo, durante la sesión. Una etiqueta siempre visible junto al avión muestra su altitud, velocidades, rumbo y código de transpondedor; también se dibuja el tránsito que muestra tu simulador, y se puede activar una capa de tránsito real.
- **Perfil vertical:** tu altitud sobre el terreno, dibujada en vivo a lo largo del vuelo.
- **Altímetro y QNH:** el ajuste del altímetro de tu cabina junto al QNH, con un aviso cuando no coinciden. Todos los valores se actualizan mientras volás: las dos radios, el modo del transpondedor, combustible, flaps, tren y piloto automático.
- **Consola en vivo:** 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.
- **Mensajes, leídos en voz alta:** cuando volás con RogerATC, su instructor puede leerte en el simulador tus mensajes sin leer; cuando escuchaste uno, aquí también queda leído.

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

## Sesiones de tránsito instruidas

Una sesión de tránsito es un vuelo de entrenamiento que armás paso a paso en el EFB y volás en X-Plane con RogerATC: el controlador te da una parte, la volás y notificás, y te da la siguiente, hasta completar la sesión. Necesita RogerATC vinculado a tu cuenta y con el **enlace en vivo** activado. Con **Sesión a medida** podés nombrar tus ejercicios en orden (radial, fijo, arco DME, espera, inversión, aproximación), salir y volver al mismo aeródromo, y elegir **Principiante** para que cada paso diga cómo se vuela.

### Crear una sesión

- Andá a **RogerATC → Sesiones de tránsito** y tocá **Nueva sesión**.
- Elegí la aeronave, las reglas de vuelo (VFR, VFR controlado o IFR), la salida y el destino.
- Armala desde una ruta: los puntos en el camino con sus altitudes, qué hacer en cada aeródromo intermedio (sobrevolar, tocar y despegar, pasada baja, aterrizaje completo o maniobras), las maniobras que querés practicar y la llegada. También podés partir de la planificación abierta en el mapa.
- El EFB arma los pasos en el orden en que se trabaja un tránsito en la frecuencia. Las pistas quedan a cargo del controlador salvo que elijas una.

### Editar los pasos

Tocá un paso para editarlo; las flechas lo suben o bajan y el menú agrega uno después, lo duplica o lo elimina (con **Deshacer**). Cada paso dice qué es —autorización, fase, instrucción o maniobra—, quién lo da —el controlador por COM1 o el instructor por el intercomunicador— y cómo termina: tu colación, tu notificación o una medición. Una espera lleva su cantidad de vueltas; una aproximación es un tipo y una pista, con los **mínimos de tu carta** y, si querés, la meteorología del simulador bajada a esos mínimos. Si algo no es válido, la sesión no se guarda y el indicador te dice qué campo corregir.

En la sesión también elegís si querés **pedidos de posición** y **emergencias** al azar, y cuáles: falla de motor (también después del despegue), fuego, magneto, alternador, eléctrica, vacío, pitot, estática, horizonte artificial e indicador de rumbo, radio, humo, flaps, viento, ráfagas, turbulencia o visibilidad.

### Listo, y en vivo

- Cuando estés por volarla, tocá **Listo**. No se dice nada hasta que pidas el tránsito en X-Plane.
- Durante la sesión, la pantalla RogerATC muestra todos los pasos —en verde los cumplidos dentro de tolerancia, en rojo los que no, y el paso en curso en verde o rojo según tu simulador en ese momento—, qué se espera de vos y las últimas líneas de la radio. La transcripción de radio se pliega, y en una sesión larga se pliega sola con la cantidad de turnos en rojo.
- Desde ahí podés **saltear el paso** activo, **terminar la sesión** o **inyectar una emergencia** en ese momento.

### El debriefing

Cada sesión queda en el historial con su chat por paso, lo que se dijo, los pasos rechazados con su motivo y las mediciones. El debriefing compara cada paso con las tolerancias del examen práctico —altitud ±100 ft, rumbo ±10°, velocidad ±10 kt, inclinación en el viraje escarpado ±5°, no descender por debajo de los mínimos— y te dice si declaraste cada emergencia y cuánto tardaste. Lo que no se midió no se juzga, y si editaste la sesión después de volarla, los controles contra objetivos quedan en suspenso.

### Borrar una sesión

Borrar una sesión borra también todos sus vuelos, con sus chats y debriefings, en todos tus dispositivos y en el servidor.

> Es práctica en simulador: no es un dispositivo de instrucción aprobado ni reemplaza la instrucción de vuelo certificada.

## 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 activás, 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. Abrí **Ajustes → Versión de la aplicación** y tocá **Buscar actualizaciones**; **Actualizar ahora** aparece solo cuando hay algo nuevo, y un aviso también te indica cuando hay una versión nueva disponible. Actualizá en tierra, con buena conexión.

#### No puedo iniciar sesión

Para iniciar sesión necesitás conexión. Revisá el correo y la contraseña, usá **Olvidé mi contraseña** si hace falta y, si la cuenta nunca se confirmó, ingresá 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, sincronizá antes de salir, instalá la app en la pantalla de inicio y asegurate de que el almacenamiento sea persistente.

#### Dos dispositivos no coinciden

Tocá **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. Abrí **Ajustes → Fuentes de datos**, cargá la clave y usá el botón de prueba de esa fuente.

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

Copiá la clave actual de **Ajustes → Acceso a la API** —si la rotaste, la anterior ya no funciona— y pegala 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
