iRacing Coach — versão de teste
================================

Coach de pilotagem por voz, em português. Compara cada curva sua com a volta
de um piloto de referência e fala o que fazer com freio, acelerador e câmbio:
avisa antes da curva e dá retorno depois.


O QUE PRECISA
-------------
- Windows 10 ou 11 e iRacing.
- Internet para a voz natural do coach (Antonio ou Francisca; escolha no
  painel, em "Voz do coach"). Sem internet, ele fala com a voz do Windows
  (Maria) — se não tiver: Configurações > Hora e idioma > Fala > Adicionar
  vozes > Português (Brasil).
- Um microfone e um botão livre no volante, se quiser falar com o coach.
- Internet na primeira vez que o microfone liga: o app baixa o modelo de
  reconhecimento de voz (~460 MB). Depois funciona offline.


COMO USAR
---------
1. Descompacte a pasta inteira em qualquer lugar e abra iRacingCoach.exe.
   O Windows pode avisar "O Windows protegeu o computador" (o programa não é
   assinado): clique em "Mais informações" > "Executar assim mesmo".

2. Clique em "Carregar telemetria do piloto (.ibt)" e escolha o arquivo .ibt
   do piloto que você quer seguir, NA MESMA PISTA E CARRO em que vai andar.
   O coach usa a volta mais rápida do arquivo. Pode carregar várias (uma por
   combinação de pista e carro).

3. Entre na pista no iRacing. O coach diz "Referência carregada" e começa a
   dar dicas a partir da 2ª volta.

Na primeira vez, o coach cria o atalho "iRacing Coach" na área de trabalho e no
menu Iniciar: das próximas vezes, abra por ali.

Fechar a janela (X) não fecha o coach: ele continua rodando no ícone perto do
relógio do Windows. Clique no ícone para abrir; para fechar de vez, botão
direito > Sair.

Quando sai versão nova, o painel avisa no topo. Em "Atualizar agora", o coach
baixa a versão nova, fecha, troca os arquivos e abre de novo sozinho; as
configurações, o login e as referências continuam (ficam em
%LOCALAPPDATA%\iRacingCoach, fora da pasta do programa).


FALAR COM O COACH (BOTÃO DO VOLANTE)
------------------------------------
O microfone só escuta enquanto você segura um botão do volante (ou uma tecla).
1. No painel, em "Botão para falar", clique em "Mapear" e aperte o botão do
   volante que vai usar (escolha um que o iRacing não use). Vale qualquer
   botão do volante, inclusive os de número alto, ou uma tecla do teclado.
2. Na pista: segure o botão, fale a frase e solte. O coach confirma em voz alta.

Esta versão não tem IA: ela entende só as frases abaixo (outra frase recebe a
lista falada). O painel mostra a mesma lista em "Como falar com o coach".
- "Modo coach": dicas de pilotagem em cada curva (o normal).
- "Modo engenheiro": sem dicas de pilotagem, para trabalhar no setup.
- "Quieto" / "Silêncio": as dicas param.
- "Pode falar": as dicas voltam.
- "Foca na curva 7": só essa curva recebe dica (aceita "nas curvas dois e
  três").
- "Todas as curvas": desliga o foco.
- "Explica a curva 8": a curva inteira — como a referência faz (freio,
  marcha, quando solta o freio, quando acelera) e como você faz.
- "Traçado": no box, compara a sua linha com a da referência. Precisa gravar
  a telemetria no iRacing com Alt+L (aperte de novo para parar a gravação
  antes de pedir).
- "Pula as molas": oval, o coach não mexe nas molas do box nesta parada.

As curvas são numeradas na ordem em que o coach as detecta, que pode não bater
com a numeração oficial da pista.


IDIOMA
------
O app fala português ou inglês (canto de cima do painel: "Idioma /
Language"). Trocar reinicia o app. Em inglês, ele usa a voz em inglês do
Windows (Zira ou David).


DASHBOARD SUPER FORMULA SF23
----------------------------
Display copiando o volante do Super Formula SF23:
- luzes de troca em cima;
- OT ReTime (barra à esquerda): recarga do overtake entre um uso e outro;
- LAP e TIME: voltas completadas e tempo da última volta;
- REF e DIFF: sua melhor volta e a diferença para ela;
- ECT e EOP: temperatura da água e pressão do óleo;
- marcha, SPEED e FUEL (combustível gasto desde a saída do box);
- bolinhas: throttle shape, brake bias, launch control (Start Limit) e seus
  incidentes;
- à esquerda delas, o iRating: em corrida oficial, o projetado se a corrida
  acabasse agora (verde ganhando, vermelho perdendo).
Com o push-to-pass ativo, a tela fica verde com "Overtake ON" e o tempo
restante (vermelha abaixo de 20 s); com o limitador do box, laranja piscando
"PIT LIMIT".
Com o Start Limit armado, as laterais ficam verdes com "START LIMIT ON". O iRacing
não informa esse estado: mapeie no painel (Road > Super Formula SF23 > Overlays)
o mesmo botão do Traction Control Arm. Apaga a uns 70 km/h, como no carro.
Começa desligado: ligue no painel. Use num segundo monitor: janela por cima do
jogo em tela cheia pode jogar o iRacing para modo janela. Abre ao lado da
janela do app, no mesmo monitor; dá para arrastar com o mouse.


OVAL: MOLAS DO BOX
------------------
Em pista oval, quando você marca o combustível da parada no black box, o
coach soma o que já está no tanque (ao entrar no pit lane, confere de novo), fala os valores e ajusta sozinho o LR e o RR Spring Offset (cliques de
1/32 pol.), pela tabela de 0 a 20 galões do painel: cada linha tem LR e RR
com botões - e +, positivos ou negativos. Começa com:
  20-18 galões: LR +1, RR 0       11-10: LR +5, RR -5
  17-16: LR +2, RR -2             9-8:   LR +6, RR -6
  15-14: LR +3, RR -3             0-7 (short run): LR +10, RR -10
  13-12: LR +4, RR -4
Para isso, cadastre no iRacing (Options > Controls > Shocks & Springs) uma
tecla do teclado para cada ação e aperte a mesma no "Mapear" do painel. Padrão,
com os números de cima do teclado (não os do teclado numérico):
- Left Spring Set: aumenta 0, diminui 7.
- Right Spring Set: aumenta 3, diminui 1.
A tecla toma o lugar do botão do volante nessas duas funções. O coach só
aperta as teclas com o iRacing na frente e confere cada clique pela
telemetria. Não precisa de IA.

Ligar e desligar: chave "Ajuste automático" no painel. Em "Mapear", ao lado,
dá para escolher um botão do volante ou uma tecla que liga/desliga com o
iRacing na frente (o coach confirma falando). Para uma parada só, use
"Pular esta parada" (também com botão do volante ou tecla em "Mapear": aperta
pula, aperta de novo desfaz) ou diga "pula as molas" pelo botão de falar. Ao
sair do pit lane, ele volta a ajustar.

Presets: dá para ter várias tabelas com nome (ex.: "A open Martinsville"). Escolha
no menu "Preset"; para criar, escreva o nome e clique em "Salvar como novo"
(copia a tabela de agora). Com o carro numa pista oval, "Abrir sozinho em
<pista>" faz esse preset ser carregado sempre que você entrar nela.

Compartilhar a tabela: "Exportar tabela" grava um arquivo .json; quem recebe
usa "Importar tabela" (vira um preset novo).


PLANO DE TREINO AUTOMÁTICO
--------------------------
Em sessão de treino, depois de 3 voltas inteiras de cada saída do box, o coach
escolhe até 3 curvas que mais custam e trabalha uma por vez: diz o que fazer, mede
a cada passagem e só passa para a próxima quando o seu tempo baixa ou depois de 5
passagens sem progresso. As outras curvas ficam em silêncio. O alvo sai das suas
voltas daquele stint, então vale para qualquer pista, carro e combustível. Em
corrida não há plano, e na classificação o coach fica em silêncio.


BALANÇO DE FREIO AUTOMÁTICO
---------------------------
Na aba Road, em Super Formula SF23, o coach muda o brake bias por trecho da pista, seguindo o .ibt da
sua referência. Só com o Super Formula SF23. Começa desligado; ligado, age em todas as
sessões e nunca aperta com o pé no freio. Ao carregar um .ibt, o coach já diz se ele serve.

Para usar:
1. Carregue um .ibt com pelo menos 3 voltas rápidas seguidas em que o piloto muda
   o brake bias. Sem isso não há mapa e nada acontece.
2. No iRacing (Options > Controls), cadastre em Brake Bias uma combinação Ctrl+Shift+tecla
   em "Increase value" e outra em "Decrease value", por exemplo Ctrl+Shift+A e
   Ctrl+Shift+S. Botão do volante não funciona: o coach não consegue apertá-lo, e a
   combinação pode tomar o lugar do botão nessa função.
3. No painel, em "Mapear", aperte em cada linha a combinação cadastrada com o mesmo nome.
4. Ligue "Ajuste automático" ou diga "liga o balanço" pelo botão de falar.

Ajuste fino: em cliques, por trecho; fica salvo por pista e carro. O iRacing
precisa estar na frente. Se uma tecla não mudar o balanço, o coach para e avisa.

Sem um .ibt com esses dados, entre com os valores à mão: dentro da pista, em "Entrar
com valores", cada linha diz a partir de quantos metros da volta vale qual balanço, com
quantas linhas a pista pedir. O mapa manual não é trocado por um .ibt novo; para voltar a
usar o .ibt, clique em "Apagar mapa manual". "Exportar mapa" grava um arquivo com o nome
da pista e do carro, que outra pessoa abre em "Importar mapa"; ele vale para essa pista e
esse carro. Para outra pista, clique em "Nova pista" e escolha a pista, sem precisar entrar nela. Os mapas ficam guardados: no menu "Pista" do cartão, abra qualquer um para ver,
editar ou exportar. Na pista, vale sempre o mapa da pista e do carro em que você está.

ATENÇÃO: as regras do iRacing proíbem automatizar entradas de controle em tempo real.
Use por sua conta.


PROBLEMAS
---------
No painel, em "Detalhes técnicos", "Abrir pasta de dados e logs" abre a pasta com coach.log e
ouvir.log. Mande esses arquivos junto com a descrição do problema.
