# Instalar y volar con RogerATC Todo lo que necesitas para pasar de la descarga a tu primera llamada: la cuenta gratuita de Copilot EFB, el instalador para macOS o Windows, RogerATC Setup, la tecla de transmisión en X-Plane y qué decirle al controlador y al instructor, con ejemplos en español y en inglés. https://rogeratc.app/docs/rogeratc/ ## Qué es RogerATC y qué necesitas RogerATC reemplaza el ATC de X-Plane 12 por un controlador de tránsito aéreo con IA al que le hablas por voz. Mantienes pulsada una tecla de transmisión, hablas como lo harías en una frecuencia real, sueltas, y el controlador te contesta por COM1 o COM2, en **español o en inglés**. Una segunda voz, el **instructor virtual**, va en el intercomunicador de cabina y responde preguntas sobre tu vuelo. La IA solo interpreta *lo que pediste*. Lo que dice el controlador lo decide un motor de reglas y se redacta con plantillas de fraseología escritas por personas, con sus fuentes. Pistas, calles de rodaje, frecuencias, fijos y procedimientos salen de **tu propia instalación de X-Plane**, incluidos los escenarios agregados: si algo no está en tus datos, el controlador nunca lo dice. ### Qué necesitas - **X-Plane 12.4 o posterior.** - **macOS 11 o posterior** (Apple Silicon o Intel) o **Windows 10/11 de 64 bits**. El soporte para Windows es nuevo en esta beta. - Una **cuenta gratuita de Copilot EFB**. RogerATC la usa para verificar tu cuenta y obtener tus claves. - Una **clave de API de OpenAI** con saldo, cargada en Copilot EFB. Le pagas directamente a OpenAI lo que uses. - Conexión a internet y unos **auriculares con micrófono** (muy recomendables: un micrófono integrado capta el sonido del propio simulador). > RogerATC y Copilot EFB son **gratuitos durante la beta**. Esta es la versión **1.0 beta**: es normal encontrar detalles por pulir; revisa el registro de cambios en rogeratc.app para ver qué cambió. ## Antes de instalar: tu cuenta de Copilot EFB y tus claves RogerATC no tiene un inicio de sesión propio. Tu cuenta de Copilot EFB es tu cuenta de RogerATC, y es donde se guardan todas las claves de proveedores. Haz estas tres cosas primero: llevan cinco minutos. ### 1. Crea tu cuenta de Copilot EFB Abre [copilot.rogeratc.app/sign-up](https://copilot.rogeratc.app/sign-up), ingresa tu nombre, tu correo y una contraseña, y confirma el código de seis dígitos que llega a tu correo. La cuenta es gratuita durante la beta, y el EFB es un maletín de vuelo completo que también puedes usar por sí solo. ### 2. Copia tu clave de API de Copilot EFB En Copilot EFB, abre **Ajustes → Acceso a la API**. Cada cuenta tiene una clave personal que empieza con `rat_live_`. Usa el botón de copiar. Es la **única** clave que vas a pegar en RogerATC. ### 3. Carga tu clave de OpenAI en Copilot EFB En Copilot EFB, abre **Ajustes → Claves que usa RogerATC** y pega tu clave de OpenAI. RogerATC la usa para el reconocimiento de voz, la voz del controlador y el modelo de lenguaje. El plugin obtiene tus claves desde tu cuenta cada vez que arranca, así que nunca escribes una clave de proveedor en RogerATC. Las demás claves de esa sección son opcionales. Sin ellas, la función simplemente no está: | Clave | ¿Obligatoria? | Qué te da | |---|---|---| | OpenAI | Sí | Reconocimiento de voz, las voces y el modelo de lenguaje que entiende lo que dijiste. | | openAIP | No | Espacio aéreo actualizado para el instructor, en lugar del que vino con X-Plane. | | Windy | No | Pronósticos de viento en altura para el instructor. | | Flightradar24 | No | El movimiento en tu frecuencia sigue al tránsito real a tu alrededor. Solo se consulta una cantidad. | | Tavily | No | Búsqueda web para el instructor, limitada a fuentes aeronáuticas como ANAC, FAA, OACI, EASA y SKYbrary. | > Cuando el propio Copilot EFB usa la misma clave (por ejemplo openAIP para su mapa), Ajustes la marca como **usada por Copilot EFB y RogerATC**. La cambias en un solo lugar y las dos aplicaciones usan la nueva; RogerATC la toma la próxima vez que arranca. ## Instalar en macOS - Descarga `RogerATC-1.0-beta-macOS.dmg` desde rogeratc.app y ábrelo. - Arrastra **RogerATC Setup** a la carpeta **Aplicaciones** en la misma ventana. - Abre **RogerATC Setup** desde Aplicaciones. ### La primera vez: "Abrir igualmente" Esta beta **no está notarizada por Apple**, así que la primera vez macOS se niega a abrirla y dice que no puede comprobar si contiene software malicioso. Para permitirla: - Cierra el mensaje. - Abre **Ajustes del Sistema → Privacidad y seguridad** y baja hasta la sección Seguridad. - Junto a la línea sobre RogerATC Setup, haz clic en **Abrir igualmente** y confirma con tu contraseña o Touch ID. ### El micrófono La primera vez que pulses la tecla de transmisión en X-Plane, macOS pide permiso para usar el micrófono. **Permítelo.** Si elegiste No permitir, abre **Ajustes del Sistema → Privacidad y seguridad → Micrófono**, activa X-Plane (o RogerCore, si aparece) y reinicia X-Plane. ## Instalar en Windows El soporte para Windows es nuevo en esta beta. El instalador trabaja solo para tu usuario y no pide permisos de administrador. - Descarga `RogerATC-1.0-beta-Windows-Setup.exe` desde rogeratc.app y ejecútalo. - En esta beta el instalador **no tiene firma de código**, así que Windows SmartScreen muestra *"Windows protegió tu PC"*. Haz clic en **Más información** y después en **Ejecutar de todas formas**. - Acepta la licencia, deja la carpeta sugerida y haz clic en Instalar. Al final, deja marcada la opción de **ejecutar RogerATC Setup**. ### El micrófono Abre **Configuración → Privacidad y seguridad → Micrófono** y comprueba que estén activados **Acceso al micrófono** y **Permitir que las aplicaciones de escritorio accedan al micrófono**. Si Windows pregunta la primera vez que pulsas la tecla de transmisión, permítelo. ## RogerATC Setup, paso a paso RogerATC Setup vincula tu cuenta, instala el plugin en X-Plane y guarda todos los ajustes, en español o en inglés. Desde el simulador, lo abres con **Plugins › Roger ATC AI › Open RogerATC Setup…** ### Vincula tu cuenta Pega tu clave de Copilot EFB (`rat_live_…`) y vincúlala. Setup la verifica, muestra el nombre de la cuenta y lista qué claves de proveedores tiene tu cuenta: solo los nombres, nunca los valores. Si falta OpenAI, cárgala en Copilot EFB antes de volar. La clave se guarda en el llavero de macOS o en el Administrador de credenciales de Windows, nunca en un archivo de texto. ### Instala el plugin en X-Plane Setup encuentra tus instalaciones de X-Plane 12 y muestra si RogerATC está instalado en cada una. Elige la tuya y haz clic en **Instalar**; en el mismo lugar están **Actualizar**, **Reparar** y **Desinstalar**. **Cierra X-Plane antes**: Setup no toca el plugin mientras está abierto. Después, **Iniciar X-Plane** abre el simulador. El plugin va a su propia carpeta; no se modifica nada más de X-Plane: ``` X-Plane 12/Resources/plugins/RogerATC ``` ### Ajustes Todos los ajustes se eligen en Setup. La mayoría también se puede cambiar en pleno vuelo desde **Plugins › Roger ATC AI › Settings**, y se aplica desde la transmisión siguiente. | Ajuste | Qué hace | Por defecto | |---|---|---| | Idioma | Español o inglés: la fraseología, la voz y lo que espera oír el reconocimiento. | Inglés | | Región | La fraseología de qué país escuchas. *Automática* sigue al aeródromo, así que cruzar una frontera cambia la fraseología. También puedes fijar OACI genérica o una de doce regiones. | Automática | | Voces | Las voces sintéticas del controlador y del instructor, distintas a propósito. | marin · cedar | | Velocidad de habla | Qué tan rápido habla el controlador, de 1,0× a 1,6×. | 1.15× | | Efecto de radio | Ancho de banda, ruido y el clic de una radio VHF. | Activado | | Meteorología del ATIS | La meteorología del simulador, o el METAR real si vuelas con meteorología real. | Simulador | | Modelo de lenguaje | OpenAI, o un modelo local con Ollama instalado en tu computadora. El reconocimiento y las voces siguen usando OpenAI. | OpenAI | | Instructor | *Desactivado*, *Activado* o *Proactivo* (además habla por su cuenta). | Activado | | Tránsito en frecuencia | Otras aeronaves en la frecuencia: desactivado, poco, normal o mucho. | Poco | | Meteorología en red | Trae METAR y TAF reales de NOAA (sin clave) cuando el simulador no los tiene. | Activado | | Tono de espera | Un tono corto mientras se prepara la respuesta: un pitido para el controlador, un doble tono para el instructor. | Activado | | Fuente de datos | *Simulador*: solo X-Plane. *Ambos*: agrega desde Copilot EFB tu plan de vuelo presentado, el perfil de la aeronave y las frecuencias que faltan. *EFB*: además tus fichas de aeródromo mandan en las frecuencias. | Simulador | | Sincronización con el EFB | *Estadísticas* (siempre activado) o *Completo*, que agrega una transcripción recortada. | Estadísticas | | Enlace en vivo con el EFB | Comparte la posición de tu aeronave con tu propio EFB para que un instructor te siga. | Desactivado | | Depuración visual | Una ventana que dice qué está haciendo RogerATC en este momento. | Desactivado | Setup también muestra un aviso cuando se publica un RogerATC más nuevo, y **Abrir la carpeta de registros** abre la carpeta con los registros y las sesiones. ## Tu primer vuelo ### Asigna las teclas En X-Plane, abre **Settings → Keyboard** (o **Joystick** para un botón del yugo), busca `Roger ATC` y asigna: | Comando | Qué hace | |---|---| | Roger ATC: push-to-talk on COM1 | Hablas con el controlador por COM1. La que necesitas. | | Roger ATC: push-to-talk on COM2 | Hablas con el controlador por COM2. | | Roger ATC: talk to the virtual instructor (intercom) | Hablas con el instructor por el intercomunicador de cabina, no por radio. | **Mantén pulsada** la tecla mientras hablas y suéltala al terminar: soltar es lo que termina la transmisión, así que una pausa en el medio nunca te corta. Un toque muy corto se ignora como pulsación accidental. ### Empieza un vuelo - Carga un vuelo en la plataforma de un aeródromo con frecuencia de torre o de rodaje, con motores apagados. - Mira **Plugins › Roger ATC AI › About** o **Diagnostics**: muestran que RogerATC está funcionando, qué aeródromo encontró y qué pista está en uso. - Sintoniza en COM1 la frecuencia de rodaje (o la de torre, si no hay rodaje): la frecuencia decide quién contesta. - Mantén pulsada la tecla y haz tu primera llamada: la estación y después tu indicativo. Suelta y espera la respuesta. > La respuesta tarda entre dos y tres segundos. Mientras se prepara escuchas el tono de espera; si no escuchas nada, mira **Solución de problemas**. ## Hablar con el controlador Habla como un piloto: estación, indicativo, posición y pedido en una sola llamada. La fraseología estándar es lo que mejor funciona, pero no hace falta que sea perfecta. El español es fraseología nativa, no inglés traducido. > Los intercambios de abajo son ilustrativos. La redacción exacta depende de tu aeródromo, de tu región y de la situación: el controlador recuerda lo que ya te dijo y no lo repite. ### Contacto, puesta en marcha y rodaje Una estación que todavía no habló contigo se presenta y saluda según la hora local del aeródromo. La ruta de rodaje se calcula sobre las calles reales del aeropuerto donde estás, según tu propio escenario. *En inglés* ``` PILOT Ezeiza Ground, LV-GKM, on the apron, information Delta, request start-up. ATC LV-GKM, Ezeiza Ground, good morning. Start-up approved, QNH 1013, squawk 4321. PILOT Start-up approved, QNH 1013, squawk 4321, LV-GKM. ATC LV-GKM, readback correct. PILOT LV-GKM, request taxi. ATC LV-GKM, taxi to holding point runway 11 via Juliett, Echo, Alfa, hold short of runway 17. PILOT Taxi to holding point runway 11 via Juliett, Echo, Alfa, hold short of runway 17, LV-GKM. ``` *En español* ``` PILOTO Ezeiza Rodaje, LV-GKM, en plataforma, información Delta, solicito puesta en marcha. ATC LV-GKM, Ezeiza Rodaje, buen día. Puesta en marcha aprobada, QNH 1013, transpondedor 4321. PILOTO Puesta en marcha aprobada, QNH 1013, transpondedor 4321, LV-GKM. ATC LV-GKM, correcto. PILOTO LV-GKM, solicito rodaje. ATC LV-GKM, Ezeiza Rodaje, ruede a punto de espera de pista 11 vía calle de rodaje Juliett, Echo, Alfa. Mantenga antes de pista. PILOTO Ruedo a punto de espera de pista 11 vía Juliett, Echo, Alfa, LV-GKM. ``` ### Despegue, circuito y aterrizaje *En inglés* ``` PILOT Ezeiza Tower, LV-GKM, holding point runway 11, ready for departure. ATC LV-GKM, Ezeiza Tower, runway 11, cleared for take-off, wind 270 degrees 8 knots. PILOT Runway 11, cleared for take-off, LV-GKM. ... ATC LV-GKM, number one, report final. PILOT LV-GKM, final runway 11. ATC LV-GKM, wind 270 degrees 8 knots, runway 11, cleared to land. ... ATC LV-GKM, vacate the runway, contact ground 121.9. ``` *En español* ``` PILOTO Ezeiza Torre, LV-GKM, punto de espera pista 11, listo a la salida. ATC LV-GKM, Ezeiza Torre, pista 11, autorizado a despegar, viento 270 grados 8 nudos. PILOTO Pista 11, autorizado a despegar, LV-GKM. ... ATC LV-GKM, número uno, notifique en final. PILOTO LV-GKM, en final pista 11. ATC LV-GKM, viento 270 grados 8 nudos. Pista 11, autorizado a aterrizar. ... ATC LV-GKM, libere pista, pase con rodaje 121.9. ``` El circuito se entiende como lo dice un piloto —inicial, a favor del viento, básica, final— y se contrasta con dónde estás de verdad. Si notificas un tramo que los datos desmienten, escuchas *"negativo"* y dónde estás realmente. ### Pedidos: ATIS, QNH, frecuencias y más *En inglés* ``` LV-GKM, request ATIS. LV-GKM, request QNH. LV-GKM, request the tower frequency for Rosario. LV-GKM, request the METAR for Rosario. LV-GKM, request the VOR frequency. LV-GKM, request touch and go. LV-GKM, request to cross runway 17. ``` *En español* ``` LV-GKM, solicito ATIS. LV-GKM, solicito QNH. LV-GKM, ¿cuál es la frecuencia de torre de Rosario? LV-GKM, solicito el METAR de Rosario. LV-GKM, solicito la frecuencia del VOR. LV-GKM, ¿me autoriza un toque y motor? LV-GKM, solicito cruzar pista 17. ``` Las respuestas salen de tus propios datos, para cualquier aeródromo; si algo no está, el controlador lo dice en lugar de adivinar. También se entienden el remolque, el deshielo, los tránsitos por la zona, el VFR especial, los planes de vuelo presentados o cerrados por radio y las notificaciones de posición y de nivel. ### Colaciones y "repita" Colaciona cada autorización. Una colación correcta se confirma con *"correcto"* (*"readback correct"* en inglés); una equivocada se corrige con el valor correcto. Si no entendiste algo, pide que lo repitan: la repetición viene marcada para que sepas que no cambió nada. *En inglés* ``` PILOT Taxi to holding point runway 29, LV-GKM. ATC LV-GKM, negative I say again, runway 11. PILOT Say again. ATC LV-GKM, I say again. Taxi to holding point runway 11 via Juliett, Echo, Alfa. ``` *En español* ``` PILOTO Ruedo a punto de espera de pista 29, LV-GKM. ATC LV-GKM, negativo repito, pista 11. PILOTO Repita. ATC LV-GKM, repito. Ruede a punto de espera de pista 11 vía Juliett, Echo, Alfa. ``` ### Tránsito, cruces e idas al aire Cuando hay alguien en final, tu pedido para ingresar a la pista puede quedar en espera y liberarse cuando el tránsito se fue. La torre también puede ordenarte una ida al aire, y tú puedes notificar una. *En inglés* ``` ATC LV-GKM, hold short runway 11, traffic on final, I will call you. ... ATC LV-GKM, cross runway 17, report runway vacated. ATC LV-GKM, go around, I say again, go around, runway occupied. Climb to 1500 feet, report downwind. ``` *En español* ``` ATC LV-GKM, mantenga fuera de pista 11, tránsito en final, lo llamo apenas quede libre. ... ATC LV-GKM, cruce pista 17, notifique pista libre. ATC LV-GKM, ida al aire, ida al aire, pista ocupada. Ascienda a 1500 pies, notifique tramo a favor del viento. ``` ### Emergencias MAYDAY y PAN PAN siempre se reconocen y se responden, nunca con "repita". PAN PAN no se trata como un MAYDAY, y combustible mínimo recibe *"no se prevé demora"*, no prioridad, como dicen las normas. *En inglés* ``` PILOT MAYDAY MAYDAY MAYDAY, Ezeiza Tower, LV-GKM, engine failure, four miles south, 2000 feet, returning to the field. ATC LV-GKM, Ezeiza Tower, roger. Emergency services alerted. Runway 11 available, wind 270 degrees 8 knots. Report your intentions and souls on board. PILOT PAN PAN PAN PAN PAN PAN, Ezeiza Tower, LV-GKM, passenger unwell, request priority. PILOT LV-GKM, minimum fuel. ``` *En español* ``` PILOTO MAYDAY MAYDAY MAYDAY, Ezeiza Torre, LV-GKM, falla de motor, cuatro millas al sur, 2000 pies, regreso al aeródromo. ATC LV-GKM, Ezeiza Torre, recibido. Servicios de emergencia alertados. Pista 11 a su disposición, viento 270 grados 8 nudos. Notifique intenciones y personas a bordo. PILOTO PAN PAN PAN PAN PAN PAN, Ezeiza Torre, LV-GKM, pasajero indispuesto, solicito prioridad. PILOTO LV-GKM, combustible mínimo. ``` ### Para que te entienda - **Usa auriculares.** Un micrófono integrado escucha el motor. - **Di tu indicativo** en cada transmisión; puede ir al principio o al final. - **Di los designadores, no los deletrees:** "vía Kilo Dos", no "vía K2". El controlador siempre contesta con el alfabeto OACI —Alfa, Juliett, Xray— y también entiende "Alpha" y "Juliet". - **La frecuencia es símplex:** si transmites mientras habla el controlador, lo cortas, como en una radio real. > Por voz, las estaciones que hoy te contestan son **Torre y Rodaje**. Aproximación y centro todavía no son estaciones a las que puedas llamar; las instrucciones IFR te llegan en cambio por el enlace en vivo con el EFB (mira **Práctica IFR** más abajo). ## Lo que el controlador hace por su cuenta Una torre real no espera a que le pregunten, y esta tampoco. Calcula dónde estás según tu posición y tu rumbo respecto de la pista en uso, y habla cuando lo haría un controlador: - Al entrar en el tramo a favor del viento: tu número en la secuencia y *"notifique en final"*; en final sin autorización, la autorización para aterrizar. - Al entrar a una pista sin autorización de despegue: *"mantenga posición"*. Pista liberada: te pasa con Rodaje. - Otra aeronave que se acerca, un cambio de pista en uso por el viento, un QNH nuevo: te lo avisan sin que preguntes. - Un código de transpondedor con tu autorización, y un aviso si el código está mal, si queda en standby en la pista o si pulsas IDENT. ### Otras aeronaves en la frecuencia Con **Tránsito en frecuencia** activado, escuchas a otros pilotos pedir puesta en marcha y rodaje, notificar a favor del viento y recibir autorización para aterrizar, con sus propias voces. Nunca te pisan y nada de lo que te dicen *a ti* se refiere a ellos: tu secuencia se cuenta solo con las aeronaves que tu simulador muestra. ## El instructor virtual Mantén pulsada la tecla del intercomunicador y habla con normalidad. El instructor responde en tu idioma, cerca y limpio, sin efecto de radio, con su propia voz. Sabe dónde estás, la meteorología, las frecuencias, el espacio aéreo y el estado de tu aeronave. *Cosas para preguntar, en inglés* ``` What's the crosswind on runway 11 right now? How far am I from Ezeiza, and which runway is in use? What is my pivotal altitude at this ground speed? Give me the frequency of the San Fernando VOR. How far out should I start down, and at what rate? Let's do a steep turn to the left. Remember that in this aeroplane we take the first stage of flap at 85 knots. ``` *Cosas para preguntar, en español* ``` ¿Cuál es el viento cruzado en la pista 11 ahora? ¿A cuánto estoy de Ezeiza y qué pista está en uso? ¿Cuál es mi altura pivotal a esta velocidad respecto al suelo? Dame la frecuencia del VOR de San Fernando. ¿A qué distancia empiezo el descenso y con qué régimen? Hagamos un viraje escarpado a la izquierda. Acuérdate de que en este avión sacamos el primer flap a 85 nudos. ``` - **Cada número se calcula, nunca se recuerda.** Viento cruzado, distancias, altura pivotal, el radial en el que estás, dónde empezar el descenso: todo calculado a partir del simulador y de tus datos. Cuando no hay forma de calcular algo, te lo dice. - **Normativa con fuente.** Con una clave de Tavily busca en una lista cerrada de fuentes aeronáuticas y te dice de dónde salió la respuesta; contrástala con la edición vigente antes de basarte en ella. - **Ejercicios.** Virajes escarpados, un 360 nivelado, vuelo lento, vuelo recto y nivelado, virajes alrededor de un punto, un viraje de reversión y una espera. Empieza uno por voz o desde **Plugins › Roger ATC AI › Instructor**: te lo explica, te corrige mientras lo vuelas y al final te da un puntaje. - **Su memoria es tuya.** Pídele que recuerde algo y lo anota, una nota por línea, en `Documents/RogerATC/instructor-memory.txt`, un archivo de texto que puedes editar a mano. ### Modo proactivo Pon el instructor en **Proactivo** y además habla sin que le preguntes: velocidad de flaps, un régimen de descenso alto cerca del suelo, tren arriba en final, un altímetro que no coincide con el QNH, viento cruzado fuerte, poco combustible, espacio aéreo controlado por delante. ## Práctica IFR con Copilot EFB Con el **enlace en vivo con el EFB** activado, un instructor —o un amigo que hace de ATC— sigue tu vuelo en Copilot EFB y le pide al controlador la próxima instrucción de la clase. La escuchas por COM1 del mismo controlador que todo lo demás, la colacionas y se verifica la colación. ### Cómo activarlo - En RogerATC Setup, activa el **enlace en vivo con el EFB**. Si quieres, pon la **sincronización con el EFB** en *Completo* para que la consola también muestre la transcripción de la radio. - Inicia X-Plane y vuela. En una tableta o computadora, abre [Copilot EFB](https://copilot.rogeratc.app) con la **misma cuenta** y ve a la pantalla **RogerATC**. - La aeronave aparece en un mapa con su altitud, velocidades, rumbo, código de transpondedor, COM1 y viento; la luz indica **LIVE** mientras el plugin informa. - Toca una instrucción, revisa los valores (se abren completados según dónde está la aeronave) y envíala. Debajo ves si se dijo, con las palabras exactas, o si se rechazó y por qué. ### Qué se puede pedir - Esperas con su entrada, virajes de reversión, radiales, arcos DME, rumbos, niveles, código de transpondedor y cambios de frecuencia. - Aproximaciones por tipo —ILS, GLS, LOC, VOR, NDB, TACAN, RNAV, RNP, visual y por contacto—, además de circulación, vectores a final y aproximaciones SRA y PAR guiadas milla por milla. - Aproximaciones frustradas, SID, STAR, directo a un fijo y desvíos, y también trabajo VFR en el circuito, aterrizaje, ida al aire y QNH. *Una aproximación con radar de precisión, en inglés* ``` ATC LV-GKM, this will be a precision radar approach runway 02, check your minima. ATC LV-GKM, six miles from touchdown, slightly left of track, slightly above glide path. ATC LV-GKM, four miles from touchdown, check gear down, on track, on glide path. ATC LV-GKM, approach completed, if runway not in sight, go around. ``` *La misma, en español* ``` ATC LV-GKM, esta será una aproximación con radar de precisión pista 02, verifique sus mínimos. ATC LV-GKM, seis millas del punto de toma de contacto, ligeramente a la izquierda del rumbo, ligeramente por encima de la senda de planeo. ATC LV-GKM, cuatro millas del punto de toma de contacto, verifique tren abajo, en el rumbo, en la senda de planeo. ATC LV-GKM, aproximación completada, si no tiene la pista a la vista, ida al aire. ``` ### El controlador sigue decidiendo Cada procedimiento, fijo y frecuencia se busca en **tus propios** datos de navegación de X-Plane. Si no está, se rechaza con un motivo que ve el instructor; el controlador nunca lo reemplaza por otro. No se dice nada con el simulador en pausa ni durante una emergencia, y un pedido que no se recoge en dos minutos vence en lugar de darse tarde. ## Qué envía RogerATC a Copilot EFB y qué nunca sale de tu computadora ### Cada vez que arranca RogerATC verifica tu cuenta con Copilot EFB y envía un identificador aleatorio de esta instalación, las versiones de RogerATC, del sistema operativo y de X-Plane, y algunos ajustes (idioma, región, modelo de lenguaje, instructor, tránsito, fuente de datos, opciones del EFB). Después obtiene tus claves de proveedores por una conexión cifrada. Si no puede contactar a Copilot EFB, sigue funcionando hasta **14 días** desde la última verificación correcta, con una copia de tus claves guardada en el llavero del sistema o en el Administrador de credenciales. ### Después de cada sesión RogerATC **siempre** envía un resumen de la sesión a tu propia cuenta de Copilot EFB, donde tú y los administradores del servicio pueden ver el uso del plugin: | Nivel | Qué se envía | |---|---| | Estadísticas (siempre) | Horarios, versiones, idioma y región, matrícula y tipo de tu aeronave, los aeródromos visitados y conteos: transmisiones, pedidos de repetición, colaciones correctas e incorrectas, emergencias, tiempos de respuesta. | | Completo (opcional) | Todo lo anterior, más hasta doscientas líneas recortadas de lo que se escuchó y lo que se dijo. | Si estás sin conexión, el resumen espera en el disco y se envía después. Una sesión que borras en el EFB se borra en todos tus dispositivos. ### Solo si los activas - **Enlace en vivo con el EFB:** cada pocos segundos, la posición y el estado actuales de tu aeronave, el aeródromo y la pista en uso. Cada informe reemplaza al anterior y el servidor lo olvida diez minutos después: una posición, nunca una trayectoria. - **Fuente de datos Ambos o EFB:** RogerATC *lee* de tu cuenta tu plan de vuelo presentado, el perfil de tu aeronave y las frecuencias de tus fichas de aeródromo. ### Lo que nunca sale de tu computadora hacia nosotros - **Tu voz.** El audio va de tu computadora directamente a OpenAI, con tu clave, para el reconocimiento. Nunca pasa por nuestros servidores y nunca se envía a Copilot EFB. - **Los datos de navegación.** Los datos de navegación de tu X-Plane tienen licencia para tu uso y se leen donde están. Nunca se suben, y nunca se envía una lista de pistas, frecuencias o radioayudas. - **Tus claves** se envían solo al proveedor que las emitió. Copilot EFB registra qué nombres de claves se obtuvieron y cuándo, nunca sus valores. Otros servicios —NOAA, Windy, openAIP, Flightradar24, Tavily— se contactan solo para lo que activaste, con tus propias claves. Los registros de sesión y los logs quedan en tu computadora: *macOS* ``` ~/Library/Application Support/RogerATC ``` *Windows* ``` %APPDATA%\RogerATC ``` ## Actualizar RogerATC busca una versión nueva cada vez que arranca: en X-Plane y cuando abres RogerATC Setup. Cuando la hay, X-Plane muestra un aviso con **Actualizar** y **Más tarde**, y RogerATC Setup muestra **Actualizar ahora**. En los dos casos, Setup descarga la versión nueva, comprueba que sea exactamente el archivo publicado en rogeratc.app, la instala y se reinicia. **Más tarde** oculta el aviso hasta mañana; **Ayuda y registros › Buscar actualizaciones** vuelve a buscar cuando quieras. - Haz clic en **Actualizar** en X-Plane (o en **Actualizar ahora** en RogerATC Setup). - Si X-Plane está abierto, RogerATC Setup dice **Cierra X-Plane para terminar de actualizar RogerATC** y actualiza el plugin en cuanto X-Plane se cierra. Nunca toca el plugin mientras X-Plane está en marcha. - Cuando diga **RogerATC está listo**, inicia X-Plane. Si la actualización no puede reemplazar RogerATC Setup donde está (por ejemplo, una carpeta Aplicaciones en la que no puedes escribir), abre la versión nueva en Finder: arrastra RogerATC Setup a Aplicaciones y reemplaza la anterior. Siempre puedes instalar a mano: descarga el instalador de este sitio y ejecútalo encima del anterior (macOS: arrástralo a Aplicaciones; Windows: ejecuta el .exe). Tus ajustes, tu cuenta vinculada y tus registros de sesión se conservan. ## Desinstalar ### macOS - Cierra X-Plane, abre RogerATC Setup y haz clic en **Desinstalar**. Esto quita la carpeta del plugin de X-Plane. - Arrastra RogerATC Setup de Aplicaciones a la Papelera. ### Windows Abre **Configuración → Aplicaciones → Aplicaciones instaladas**, busca RogerATC y elige **Desinstalar**. Te pregunta si también quieres quitar el plugin de X-Plane. ### Para borrar todo Tus ajustes, registros de sesión y claves guardadas se conservan a propósito, para que una reinstalación no los pierda. Para borrarlos también, elimina la carpeta de soporte de RogerATC que aparece en **Qué envía RogerATC**, más arriba, y la carpeta `RogerATC` de tus Documentos (la memoria del instructor). Después quita las claves guardadas: en macOS, abre Acceso a Llaveros y borra los elementos llamados `ai.rogeratc`; en Windows, abre el Administrador de credenciales → Credenciales de Windows y quita las entradas que empiezan con `ai.rogeratc`. ## Solución de problemas #### "Vincula tu cuenta de Copilot EFB en RogerATC Setup" El plugin no tiene una clave válida, o la clave se rotó en el EFB. Abre RogerATC Setup, pega la clave actual de **Ajustes → Acceso a la API** de Copilot EFB, vincúlala y reinicia X-Plane. Si la cuenta está pausada, el mensaje sigue hasta que se reactive. #### "RogerATC necesita contactar a Copilot EFB una vez cada 14 días" Conéctate a internet y reinicia X-Plane. Una verificación correcta lo habilita por otros 14 días. #### El controlador no responde - Comprueba que la tecla de transmisión esté asignada al comando de RogerATC y que la **mantengas pulsada** mientras hablas. - Comprueba el permiso del micrófono (mira las secciones de instalación) y que tus auriculares sean el dispositivo de entrada del sistema. - Comprueba que COM1 esté en una frecuencia del aeródromo. Si estás en la equivocada, la estación te dice qué frecuencia usar. - Abre **Plugins › Roger ATC AI › Diagnostics**: muestra si RogerATC está funcionando y, si no, por qué. - Si vuelas en VATSIM con xPilot conectado, RogerATC se hace a un lado a propósito y te lo avisa. #### Me escucha pero nunca contesta, o falta la voz Tu clave de OpenAI falta, es incorrecta o se quedó sin saldo. Revísala en Copilot EFB → **Ajustes → Claves que usa RogerATC** y tu saldo en la plataforma de OpenAI, y reinicia X-Plane: las claves se obtienen cuando arranca el plugin. #### Me dice "repita" todo el tiempo Usa auriculares, di tu indicativo, di los designadores en lugar de deletrearlos y mantente en el idioma que elegiste. Si una calle de rodaje o una pista no está en *tu* escenario, el controlador no la acepta: revisa el aeródromo en el mapa de X-Plane. #### Setup no encuentra X-Plane o no instala Abre X-Plane 12 una vez para que registre dónde está instalado y vuelve a abrir Setup, o indícale tú la carpeta de X-Plane. Instalar, actualizar y desinstalar solo funcionan con X-Plane cerrado. #### Dónde están los registros Haz clic en **Abrir la carpeta de registros** en RogerATC Setup, o abre la carpeta de soporte que aparece en **Qué envía RogerATC**, más arriba. La carpeta `sessions` guarda un registro por vuelo (se conservan los veinte más recientes); adjunta el último cuando reportes un problema. ## Solo para simulación y práctica RogerATC es para simulación de vuelo y práctica de comunicaciones. **No es un dispositivo de instrucción aprobado** y **no reemplaza la instrucción de vuelo certificada**. Su fraseología se basa en fuentes publicadas, pero los procedimientos reales cambian según el país, el aeródromo y el controlador: en una aeronave real, sigue a tu instructor, las publicaciones oficiales y las instrucciones del ATC real. --- © RogerATC · https://rogeratc.app