ADIF Compatibility

Compatibilidade ADIF

O Digital Ham Radio Logbook suporta o subconjunto ADIF necessário ao produto e preserva campos desconhecidos quando possível.

Isso não significa suporte integral a todo o universo ADIF.

Campos comuns obrigatórios na importação

Para converter um registro em QSO:

• CALL
• QSO_DATE
• TIME_ON
• FREQ
• MODE

Campos comuns opcionais modelados

• BAND
• RST_SENT
• RST_RCVD
• GRIDSQUARE
• NAME
• QTH
• COMMENT

NOTES é aceito como alias de importação para comentário.

Normalização

Callsign, modo e grid são normalizados para uppercase.

A frequência é convertida sem depender de ponto flutuante e preserva resolução de 1 Hz.

Compatibilidade por modo

Modo	Import	Export
QSO comum	sim	sim
DMR	sim	sim
FT8	sim	sim
D-STAR	MODE=DSTAR ou DIGITALVOICE + DSTAR	DIGITALVOICE + DSTAR
YSF/C4FM	MODE=C4FM ou DIGITALVOICE + C4FM	DIGITALVOICE + C4FM

Campos desconhecidos

O contrato preserva, quando possível:

• nome;
• valor;
• tipo ADIF;
• duplicatas;
• ordem relativa entre os campos desconhecidos.

Campos conhecidos são emitidos em ordem canônica e os desconhecidos são anexados mantendo sua ordem relativa.

Unicode e linhas

• UTF-8: suportado;
• LF: suportado;
• CRLF: suportado na entrada;
• BOM UTF-8 inicial: suportado na entrada;
• exportação: LF canônico e sem BOM.

Extensões privadas

O projeto publica campos APP_DHRL_* para metadata específica.

Esses nomes publicados são tratados como contratos de compatibilidade.

DMR

Incluem IDs, talkgroup, timeslot, color code, rede, tipos de chamada/acesso, repetidora, hotspot e notas.

FT8

Incluem SNR enviado, frequência de áudio, software, protocolo e mensagem final. Campos padrão são usados quando apropriado para SNR recebido e potência.

D-STAR

Incluem reflector, module, URCALL, RPT1, RPT2 e notes. STATION_CALLSIGN é canônico para MYCALL.

YSF

Incluem room, WIRES-X node, repeater, network, access type, TX/RX DG-ID e notes.

Limitações atuais

• o documento ADIF é carregado integralmente em memória;
• tipos explícitos de campos conhecidos são canonicalizados;
• a posição original de unknown fields entre campos conhecidos não é preservada;
• TIME_OFF e QSO_DATE_OFF ainda ficam como campos desconhecidos em vez de colunas de domínio;
• não existe certificação de interoperabilidade com software externo específico.

Veja também

• Importar ADIF
• Exportar ADIF
• DMR
• FT8
• D-STAR
• YSF / System Fusion