File FIT

Cosa cambia in un file FIT quando Nabe lo invia a Garmin?

Cambiano sedici byte, e nient’altro. Nella nostra pedalata di riferimento, 14 byte stanno nei due punti che indicano il dispositivo di registrazione, e gli ultimi 2 byte sono il checksum del file, che va ricalcolato perché il contenuto è cambiato.

Lo abbiamo misurato il 12 settembre 2026 con una pedalata registrata su un Wahoo ELEMNT ROAM: 51,8 km, 2 h 07 min in movimento, 227.041 byte. Abbiamo scritto una copia con l’identità di un Garmin Forerunner 570 e confrontato i due file con cmp -l, che elenca ogni byte diverso.

Quali campi cambiano?

Cambiano produttore, prodotto, numero di serie e versione software, in due messaggi: File ID, con cui inizia ogni file FIT, e Device Info del dispositivo di registrazione (indice dispositivo 0). L’ora di creazione del file, il tipo di file e il tipo di dispositivo restano com’erano.

Campo Originale Wahoo Dopo la riscrittura
File ID, produttore 32 (Wahoo Fitness) 1 (Garmin)
File ID, prodotto 47 4570 (Forerunner 570)
File ID, numero di serie quello dell’unità Wahoo quello dell’orologio
File ID, ora di creazione ora della registrazione invariata
Device Info 0, produttore 255 (sviluppo) 1 (Garmin)
Device Info 0, prodotto 47 4570
Device Info 0, numero di serie quello dell’unità Wahoo quello dell’orologio
Device Info 0, versione software 170,81 quella dell’orologio

Quattordici dei byte modificati stanno tra l’offset 42 e l’offset 106 del file; gli altri due sono il checksum alla fine del file, agli offset 227.039 e 227.040 di 227.041 byte. Il formato FIT salva questi valori in campi a larghezza fissa, quindi un nuovo valore occupa lo spazio del vecchio e il file non cresce né si riduce.

Cosa resta esattamente uguale?

Tutto ciò che hai pedalato resta identico byte per byte: 7.632 record con frequenza cardiaca, potenza, velocità, distanza e altitudine, 1 giro, 1 sessione, 40 eventi, 1 messaggio di attività e i campi sviluppatore con le loro 4 descrizioni di campo. Entrambi i file sono lunghi 227.041 byte. Il protocollo FIT mette ogni record dopo l’intestazione e le definizioni, e in questo file il dispositivo è indicato esattamente nei due messaggi sopra, che vengono prima del primo record.

Perché cambia il checksum?

Un file FIT termina con un CRC di 2 byte calcolato su tutti i byte precedenti, come descritto nel protocollo FIT. Se cambi un byte in qualsiasi punto, il vecchio CRC non corrisponde più, e ogni programma che lo verifica vede un file danneggiato. Il nostro file riscritto ha superato la verifica sull’intero file, condizione perché Garmin Connect lo accetti.

Da dove prende Nabe i valori?

Nabe prende produttore, prodotto, numero di serie e versione software del tuo orologio, dall’elenco dei dispositivi di Garmin Connect. Il 13 settembre 2026 quell’elenco ci ha dato esattamente gli stessi quattro valori per il nostro Forerunner 570 di un file FIT registrato dall’orologio. Nabe li scrive solo con l’identità del tuo orologio attivata e solo quando invia una pedalata a Garmin Connect, mai quando scrive in Apple Health.

Perdo il file originale?

No. Nabe conserva una copia della registrazione originale sul tuo iPhone, e «Esporta FIT» esporta quell’originale, mai la copia riscritta. La riscrittura esiste solo nel file che va a Garmin. Solo se non c’è una copia locale il file arriva da un servizio collegato, per esempio Garmin, e solo un file che Nabe ha caricato su Garmin con l’identità del tuo orologio porta quell’identità.

Cosa ne ha fatto Garmin?

Garmin Connect ha accettato il file riscritto tramite la sua pagina di importazione e da allora lo elenca con l’immagine di un Forerunner 570, la sua versione software e l’indicazione che i dati di riepilogo sono originali. Un giorno dopo l’app stessa ha caricato allo stesso modo una pedalata di prova, e la scheda attività di Garmin indicava l’orologio come dispositivo di registrazione e Garmin come produttore. Perché il dispositivo conta per il tuo orologio è spiegato in perché una pedalata caricata non conta per il Training Status.