Haz visible la cadena completa
Escribe cinco pasos distintos: fuente → valor recibido → conversión → regla de salida → resultado físico o visible. Añade qué puedes observar en cada uno. Así distinguirás un dato original erróneo de un fallo que aparece al presentar el resultado.
Empieza por una función claramente observable en una situación repetible. Evita cambiar varios mandos y estados a la vez. La prueba local de un LED confirma la salida eléctrica; un dato aparentemente correcto no confirma toda la asignación. Comparar cada etapa une ambas evidencias.
Distingue entradas, estados y eventos
Una entrada solicita una acción. La telemetría comunica lo que el simulador expone realmente. Por eso, un testigo debería seguir un estado confirmado cuando sea posible, no solo la última orden enviada. Una orden puede no tener efecto o significar algo distinto en la situación actual.
Un estado persiste hasta cambiar o perder validez. Un evento describe una ocurrencia. Un número necesita unidad y rango. No los trates igual: un estado continuamente verdadero no debería generar una pulsación nueva con cada paquete, ni un evento puntual convertirse en un encendido permanente sin una regla expresa.
Conserva una ficha completa para cada función
| Campo | Qué registrar | Pregunta de comprobación |
|---|---|---|
| Fuente | Simulador, vehículo/aeronave, adaptador y versión | ¿La documentación corresponde a esta combinación? |
| Dato | Identificador verificado y significado | ¿Es estado, número o evento? |
| Formato | Tipo, unidad y rango válido | ¿Qué significa cero y cómo se informa la invalidez? |
| Conversión | Fórmula y redondeo | ¿Se convierte una sola vez? |
| Condición | Activación y requisitos | ¿Deben cumplirse varias condiciones? |
| Destino | Dispositivo, canal, formato y perfil | ¿Es la salida deseada? |
| Fallo | Inicio, pausa, antigüedad y desconexión | ¿Puede engañar una cifra antigua? |
| Evidencia | Resultados esperados/reales y fecha | ¿Qué etapas se han probado? |
Los nombres inventados solo sirven para diseñar si se identifican como términos propios. No copies identificadores DCS, máscaras BMS o variables ajenas porque el nombre parezca adecuado. Su significado puede depender de aeronave, adaptador y versión.
Un ejemplo conceptual con cifras verificables
Supón que una fuente confirmada entrega velocidad en metros por segundo y quieres kilómetros por hora. La relación es km/h = m/s × 3,6. Un dato de prueba de 25 m/s debe producir 90 km/h; 0 m/s debe dar 0 km/h. Es un cálculo ilustrativo, no la unidad afirmada de un campo concreto de Cockpit Suite.
Si una escala gráfica transforma 0–180 km/h en 0–100 %, 90 / 180 × 100 resulta 50 %. Comprueba mínimo, mitad y máximo. Decide qué hacer fuera de rango: señalarlo, limitar la salida o usar otra escala. Limitar una aguja no debería ocultar silenciosamente una entrada inválida.
Redondea para mostrar el resultado cuando sea posible. Una conversión duplicada o un signo perdido puede parecer convincente en algunos valores. Probar solo un valor habitual resulta insuficiente. La guía de telemetría ayuda a aclarar la fuente antes de elegir la fórmula.
En firmware Arduino propio también importa el tipo de dato: map() usa aritmética entera, trunca los decimales y no limita automáticamente el resultado al intervalo de destino. Comprueba estas propiedades de la función utilizada; esto no describe la implementación interna de Cockpit Suite.
Define condiciones y umbrales conscientemente
Un aviso puede requerir una medida y un estado operativo confirmado. Escribe primero la regla en lenguaje normal: “Activar el testigo cuando el valor cumpla el límite y el sistema correspondiente esté activo”. Comprueba antes si la fuente ya entrega el aviso completo; reconstruirlo no lo hace automáticamente más exacto.
Como ejemplo puramente conceptual, un indicador podría encenderse al subir hasta 80 y apagarse al bajar de 78. Los dos límites introducen histéresis para evitar conmutaciones continuas cerca de una frontera. No son valores de un vehículo ni de una advertencia reales. Define inicio y comportamiento exactamente en los límites. Los retrasos o filtros no deben eliminar transiciones importantes sin que lo adviertas.
Separa cero, ausencia y datos antiguos
Cero puede ser un valor válido. La ausencia significa que no puedes afirmar un estado fiable; el último dato válido también puede haberse quedado antiguo. Define inicio, pausa, desconexión y recuperación por separado. Un mensaje neutro o una indicación de invalidez suele ser más claro que una cifra aparentemente actual.
Si hay marcas de tiempo, elige un criterio de antigüedad adecuado. Un único tiempo límite no sirve para todas las fuentes. Registra si durante la pausa siguen llegando datos y si conservan su significado. Al reconectar no debe repetirse accidentalmente una pulsación antigua; los indicadores deben reconstruirse a partir de información actual.
Usa la combinación correcta de simulador y perfil
Un entorno común reduce trabajo repetido, pero no sustituye una fuente adecuada. Cockpit Suite dispone de integraciones para Falcon BMS y DCS F-16C; War Thunder, ETS2 y ATS están en beta, LS25 en desarrollo. No hay adaptadores disponibles para MSFS o X-Plane. Los ejemplos de otros proyectos no amplían ese soporte.
Nombra los perfiles por simulador, vehículo o aeronave y finalidad. Comprueba una asignación antes de transferirla a otro modelo. Cabinas parecidas pueden exponer datos distintos. Perfiles separados y fuentes documentadas permiten compartir software entre simuladores sin mezclar significados.
Compara resultados esperados y reales
- Prueba la salida local con un patrón fijo e identifica su destino.
- Observa el dato confirmado sin conversión y contrasta su significado con la documentación.
- Pasa mínimos, intermedios, máximos y entradas inválidas controlados por tu conversión.
- Prueba condiciones por separado y juntas, incluidos límites exactos y cambios de dirección.
- Modifica la misma función de forma controlada en el simulador y compara dato, resultado y salida.
- Comprueba inicio, pausa, desconexión, recuperación y cambio de perfil; guarda resultados y versiones.
Esto es un plan de prueba, no una afirmación de ensayos físicos ya realizados. Si falla una etapa, examina primero sus entradas y salidas. No cambies firmware, fórmula y perfil simultáneamente.
Sigue cada fallo hasta su origen
Un factor constante sugiere unidades o escala incorrectas. Un desplazamiento puede deberse a una compensación. Una lámpara invertida exige comprobar por separado significado lógico y polaridad eléctrica. Un umbral inestable requiere estudiar dato, regla y respuesta deseada. Una pantalla congelada pide comprobar actualización antes de aumentar brillo.
La primera asignación está lista cuando su fuente está verificada, la fórmula se entiende y los casos normales y de fallo previstos producen estados claros. En el foro comparte dato original, resultado esperado, salida real y versiones. Intentamos ayudar en el mismo día cuando es posible. Los ejemplos documentados de Europa y de la comunidad internacional muestran qué funciona y dónde puede avanzar conjuntamente este proyecto joven.
Fuentes y documentación para ampliar información
La documentación de fabricantes y proyectos respalda los principios técnicos. Los foros muestran preguntas individuales, no su frecuencia. Los ejemplos y las comprobaciones son orientaciones propias y no se han probado en tu montaje. Fuentes consultadas el 18 de octubre de 2026.
- Telemetria juego ETS2Pregunta sobre adaptar instrumentos de ETS2 y añadir pulsadores; muestra la necesidad de separar escala de salida y entrada.
- Documentation/Engine/SDK/Telemetry — SCS Modding WikiFuente oficial de documentación de telemetría SCS; los campos concretos requieren verificar SDK y adaptador.
- Arduino: map() referenceReferencia oficial de Arduino sobre conversión de intervalos, aritmética entera y ausencia de limitación automática; no acredita una implementación de Cockpit Suite.