# Configuración de Pedales y Gamepad

> Conecta y calibra tus pedales de carreras o gamepad para entrenamiento preciso de frenado en Braking Lab.

Braking Lab funciona con cualquier pedal de carreras o gamepad que soporte la API Gamepad del navegador. Esta guía cubre cómo conectar, calibrar y configurar tu hardware para la mejor experiencia de entrenamiento.

## Conectar tu Hardware

### Dispositivos Compatibles

Braking Lab soporta cualquier controlador compatible con la API Gamepad:

**Pedales de Carreras**
- Logitech (G29, G923, G Pro pedales, etc.)
- Thrustmaster (T-LCM, T3PA, etc.)
- Fanatec (CSL, ClubSport pedales)
- Heusinkveld
- Simucube
- Y muchos más

**Gamepads**
- Controles PlayStation (DualShock, DualSense)
- Controles Xbox
- Controles USB genéricos

### Conexión Inicial

Conecta tu hardware:

1. Conecta tus pedales de carreras o gamepad
2. Abre Braking Lab
3. Ve a **Configuración > Hardware**
4. Haz clic en **Conectar Dispositivo**
5. Tu navegador solicitará permiso
6. Presiona cualquier botón en tu dispositivo para activarlo
7. El dispositivo debería aparecer en la lista de conectados

### Requisitos de Permisos

La API Gamepad requiere:

- **Conexión HTTPS** - Braking Lab usa conexiones seguras
- **Interacción del usuario** - Presiona un botón para activar el dispositivo
- **Foco del navegador** - La ventana debe estar en foco para leer entrada

## Calibración

### Por Qué Calibrar?

La calibración asegura lecturas precisas de entrada:

- Corregir zonas muertas en tus pedales
- Establecer rangos mínimos y máximos apropiados
- Considerar diferencias en recorrido de pedales
- Compensar variaciones de sensores

### Proceso de Calibración

**Paso 1: Acceder a Calibración**

1. Ve a **Configuración > Hardware**
2. Selecciona tu dispositivo
3. Haz clic en **Calibrar**

**Paso 2: Posición de Liberación**

1. Asegúrate de que los pedales estén completamente liberados
2. Haz clic en **Establecer Mínimo**
3. La app registra tu posición cero

**Paso 3: Presión Completa**

1. Presiona el pedal de freno completamente
2. Mantén la presión máxima
3. Haz clic en **Establecer Máximo**
4. La app registra tu rango completo

**Paso 4: Prueba**

1. Presiona el pedal de freno gradualmente
2. Observa cómo responde la visualización
3. Asegúrate de que muestre 0% cuando está liberado
4. Asegúrate de que muestre 100% a presión completa

### Ajuste Fino

Ajusta la configuración de calibración:

| Configuración | Descripción |
|---------------|-------------|
| Zona Muerta (Mín) | Ignorar entrada bajo este umbral (0-20%) |
| Zona Muerta (Máx) | Tratar como 100% sobre este umbral (80-100%) |
| Curva de Sensibilidad | Lineal, Progresiva, o Personalizada |
| Invertir Eje | Voltear dirección de entrada si el pedal lee al revés |

### Curvas de Sensibilidad

Elige cómo se mapea la entrada:

**Lineal**
- Mapeo 1:1 de posición de pedal a valor de freno
- Mejor para pedales con celda de carga

**Progresiva**
- Respuesta más suave a baja presión
- Más resolución a alta presión
- Bueno para pedales con potenciómetro

**Personalizada**
- Dibuja tu propia curva de respuesta
- Ajusta fino a tu preferencia

## Visualización en Tiempo Real

### Indicador de Pedales

Ve la entrada en tiempo real durante ejercicios:

- **Medidor de freno** - Muestra presión actual del freno
- **Medidor de acelerador** - Muestra posición del acelerador (si está habilitado)
- **Valor numérico** - Visualización de porcentaje exacto
- **Trazo de historial** - Entrada reciente mostrada como estela

### Opciones de Visualización

Personaliza la pantalla:

- Mostrar/ocultar medidores específicos
- Elegir visualización de barra o circular
- Ajustar tamaño y posición
- Establecer colores para diferentes niveles de entrada

## Múltiples Dispositivos

### Usando Múltiples Controladores

Si tienes múltiples dispositivos conectados:

1. Conecta todos los dispositivos
2. Ve a **Configuración > Hardware**
3. Selecciona qué dispositivo usar para entrada de freno
4. Configura cada dispositivo independientemente

### Prioridad de Dispositivos

Establece qué dispositivo usar:

1. Haz clic en **Establecer como Principal** en el dispositivo preferido
2. Braking Lab usará este dispositivo para ejercicios
3. Cambia dispositivos en cualquier momento desde Configuración

## Solución de Problemas

### Dispositivo No Detectado

**Verifica conexiones:**
- Asegúrate de que el cable USB esté conectado firmemente
- Prueba un puerto USB diferente
- Prueba el dispositivo en otras aplicaciones

**Problemas del navegador:**
- Usa Chrome, Edge, o Firefox (Safari tiene soporte limitado)
- Asegúrate de que el navegador esté actualizado
- Prueba una ventana privada/incógnito

**Problemas de permisos:**
- Haz clic dentro de la ventana de Braking Lab
- Presiona un botón en tu dispositivo
- Verifica permisos del navegador en configuración

### Lecturas Incorrectas

**La entrada parece invertida:**
- Habilita **Invertir Eje** en configuración de calibración

**Los valores no llegan a 0% o 100%:**
- Recalibra con recorrido completo del pedal
- Ajusta configuración de zona muerta

**Lecturas inestables o saltantes:**
- Aumenta ligeramente la zona muerta
- Verifica problemas de hardware
- Actualiza drivers del dispositivo

### La Entrada Deja de Funcionar

**La ventana pierde foco:**
- La API Gamepad solo funciona cuando el navegador está enfocado
- Haz clic de nuevo en la ventana de Braking Lab

**Dispositivo desconectado:**
- Verifica conexión USB
- Reconecta y vuelve a habilitar en Configuración

### Problemas Específicos del Navegador

**Chrome:**
- Generalmente el mejor soporte de API Gamepad
- Asegúrate de que los permisos del sitio permitan acceso al gamepad

**Firefox:**
- Buen soporte, puede necesitar `dom.gamepad.enabled` en about:config

**Safari:**
- Soporte limitado de API Gamepad
- Usa Chrome o Firefox para mejor experiencia

**Edge:**
- Mismo soporte que Chrome (basado en Chromium)

## Consejos para Mejores Resultados

### Configuración de Hardware

- Usa pedales de carreras dedicados para mejor precisión
- Los pedales con celda de carga proporcionan retroalimentación más realista
- Asegura montaje estable para entrada consistente
- Calibra periódicamente conforme el hardware se desgasta

### Durante los Ejercicios

- Mantén posición de asiento consistente
- Aplica presión suavemente
- Usa la visualización en tiempo real para verificar entrada
- Si las lecturas parecen incorrectas, recalibra

### Mantenimiento

- Limpia los sensores de pedales periódicamente
- Actualiza el firmware del dispositivo cuando esté disponible
- Recalibra después de ajustes de hardware
- Prueba la calibración antes de sesiones de práctica importantes