LFS-Ayats

Guia d’Inici Ràpid

Aquesta guia t’ajudarà a posar en funcionament el sistema LFS-Ayats en 5-10 minuts.

Prerequisits

• Python 3.8 o superior - Descarregar Python
• Live for Speed instal·lat (versió demo o completa) - Descarregar LFS
• Git (opcional, per clonar el repositori) - Descarregar Git

Pas 1: Instal·lació

Opció A: Clonar des de GitHub (recomanat)

git clone https://github.com/lfsplayer97/LFS-Ayats.git
cd LFS-Ayats

Opció B: Descarregar ZIP

1. Descarrega el repositori com ZIP
2. Extreu el contingut a una carpeta
3. Obre un terminal a la carpeta extreta

Instal·lar Dependències

# Crear entorn virtual (recomanat)
python -m venv venv

# Activar entorn virtual
source venv/bin/activate  # Linux/Mac
# o
venv\Scripts\activate  # Windows

# Instal·lar dependències
pip install -r requirements.txt

# Instal·lar el paquet en mode desenvolupament
pip install -e .

Temps estimat: 2-3 minuts (depenent de la velocitat d’Internet)

Pas 2: Configuració

Copia el fitxer de configuració d’exemple:

cp config.example.yaml config.yaml

Configuració per defecte (ja preparada per funcionar):

• Host: 127.0.0.1 (localhost)
• Port: 29999 (port InSim estàndard)
• No requereix contrasenya d’administrador per defecte

Si vols personalitzar la configuració, edita config.yaml:

insim:
  host: "127.0.0.1"
  port: 29999
  admin_password: ""  # Deixar buit si no cal
  app_name: "LFS-Ayats"
  interval: 100  # ms entre actualitzacions

Pas 3: Executar Live for Speed

1. Obre Live for Speed
2. Activa InSim:
   • Ves a Options > Misc
   • A la secció InSim, marca la casella
   • Introdueix el port: 29999
   • Fes clic a OK

   

3. Inicia una sessió de conducció:
   • Escull un circuit (per exemple, Blackwood GP - BL1)
   • Escull un cotxe (per exemple, XF GTI)
   • Fes clic a Drive

Important: InSim només funciona durant sessions de conducció actives, no al menú principal.

Pas 4: Connectar i Recollir Dades

Executa l’exemple de connexió bàsica:

python examples/basic_connection.py

Sortida esperada:

INFO - === Exemple Bàsic de Connexió InSim ===
INFO - Connectant a 127.0.0.1:29999...
INFO - Connexió establerta!
INFO - InSim inicialitzat!
INFO - Rebent paquets durant 10 segons...
INFO - Paquet rebut: IS_VER
INFO - Paquet rebut: IS_ISM

Condueix pel circuit durant aquest temps per veure paquets de telemetria!

Pas 5: Visualitzar Dades en Temps Real

Opció A: Monitor de Telemetria (consola)

python examples/telemetry_monitor.py

Veuràs dades actualitzades en temps real a la consola:

=== Telemetria en Temps Real ===
Jugador: YourName
Velocitat: 145.2 km/h
RPM: 6500
Marxa: 4
Posició: X=1234.5 Y=567.8 Z=12.3

Opció B: Dashboard Web Interactiu

python examples/dashboard_example.py

Obre el navegador a: http://localhost:8050

Funcions del dashboard:

• 📊 Gràfics de velocitat en temps real
• 🔄 Actualització cada 100ms
• 🎨 Interfície interactiva amb Plotly
• 📈 Historial de dades

Pas 6: Exportar Dades

Recull dades i exporta-les a CSV:

python examples/data_logger.py

Les dades es guardaran a:

• data/telemetry_YYYYMMDD_HHMMSS.csv
• data/telemetry_YYYYMMDD_HHMMSS.json

Format CSV:

timestamp,player_id,speed,rpm,gear,pos_x,pos_y,pos_z
2024-01-15 10:30:45.123,1,145.2,6500,4,1234.5,567.8,12.3

Verificar que Tot Funciona

✅ Checklist d’èxit:

• Dependències instal·lades sense errors
• LFS executa i InSim està activat
• Connexió bàsica establerta correctament
• Es reben paquets de telemetria
• Dashboard web mostra dades
• Dades exportades correctament

Pròxims Passos

Tutorials Avançats

1. Primera Sessió de Telemetria - Aprèn a recollir i analitzar dades d’una sessió completa
2. Anàlisi de Voltes - Compara voltes i troba àrees de millora
3. Dashboard en Temps Real - Personalitza el dashboard
4. Anàlisi Avançada - Detecció d’anomalies i prediccions
5. Integració amb Base de Dades - Emmagatzema sessions històriques

Aprendre Més

• Documentació d’Arquitectura - Com funciona el sistema internament
• Protocol InSim - Detalls del protocol de comunicació
• API REST - Integració amb altres aplicacions
• FAQ - Preguntes freqüents i solució de problemes

Contribuir

Vols millorar el projecte? Consulta:

• Guia de Contribució
• Configuració d’Entorn de Desenvolupament
• Estàndards de Codi

Solució de Problemes Ràpids

Error: “Connection refused”

Causa: LFS no està executant o InSim no està activat

Solució:

1. Verifica que LFS està en execució
2. Comprova que InSim està activat a Options > Misc
3. Confirma que el port és 29999
4. Assegura’t que estàs en una sessió de conducció activa

Error: “Module not found”

Causa: Dependències no instal·lades o entorn virtual no activat

Solució:

# Activa l'entorn virtual
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

# Reinstal·la dependències
pip install -r requirements.txt
pip install -e .

No es reben dades de telemetria

Causa: El cotxe està aturat o la configuració de l’interval és incorrecta

Solució:

1. Condueix activament pel circuit
2. Verifica que interval a config.yaml és > 0
3. Comprova que el sistema està subscrit als paquets correctes

Més problemes?

Consulta la guia completa de troubleshooting o obre un issue a GitHub.

Recursos Addicionals

Documentació Oficial de LFS

• Manual de Live for Speed
• Protocol InSim
• Fòrum de LFS

Comunitat

• GitHub Issues - Reporta problemes o suggereix millores
• GitHub Discussions - Preguntes i discussions

---

Temps total estimat: 5-10 minuts

Ara estàs preparat per començar a utilitzar LFS-Ayats! 🏎️ 💨

Per qualsevol dubte, consulta la documentació completa o contacta amb la comunitat.

This site is open source. Improve this page.