ats-mini-pu2qtf
Firmware ATS-Mini para escuta em SP: beacons NCDXF ao vivo, EiBi e controle por USB
git clone https://github.com/fernandofatech/ats-mini-pu2qtf.gitcerca de 4 min · áudio gerado ao tocar
Este repositório é o meu fork do firmware oficial do ATS-Mini (ESP32-S3 + SI4732), versão 2.45, ajustado para o shack de escuta que mantenho em São Bernardo do Campo/SP (grid GG66rh): identifica beacons NCDXF em tempo real, baixa a EiBi por comando remoto, vem com 96 memórias medidas no local e traz uma ferramenta de controle pelo USB para Mac e Linux.
Por que este fork existe
O firmware oficial do ATS-Mini já é completo: FM com RDS, AM, SSB, ondas curtas, EiBi, Wi-Fi, memórias e temas. Não mexi em nada disso. A pergunta que me levou a criar o fork não foi "o rádio funciona?", foi "o rádio responde o que eu preciso saber no meu shack sem abrir um notebook?".
Três perguntas se repetiam toda noite de escuta:
- Qual beacon está no ar agora em 20 m? O ciclo NCDXF/IARU tem 18 estações se revezando em cinco frequências. Sem tabela na mão, um sinal fraco em 14100 kHz é só um sinal fraco.
- Que estação é essa na Grande SP? O dial de FM e AM daqui é congestionado. Montar memórias à mão, uma a uma, pelo knob, custa uma tarde.
- Como opero o rádio do computador? Varrer uma faixa e anotar nível de sinal pelo knob não escala.
O fork responde às três e mantém o resto idêntico ao oficial. Um detalhe que pesa na manutenção: em Settings → Update FW o rádio busca as versões deste repositório. Se apontasse para o oficial, cada atualização pelo Wi-Fi apagaria a personalização sem avisar.
O que a edição PU2QTF acrescenta
Beacon LU4AA Buenos Aires.J baixa a programação mundial de ondas curtas e informa o resultado; ? mostra o status do relógio e da EiBi.ats-mini: controle pelo USB a partir do Mac ou Linux: status, sintonia, varredura de FM/AM/ondas curtas com medição de sinal, gravação de memórias e screenshots.Onde a edição PU2QTF encosta no rádio
O diagrama responde a uma pergunta: o que entra e sai do firmware nesta edição. O computador fala com o rádio pelo USB; o firmware controla o SI4732 e calcula o beacon da vez pelo relógio UTC. As ligações tracejadas são sob demanda: o download da EiBi depois do comando J e a busca de versões em Update FW. Simplificação: temas, RDS e o resto do firmware oficial ficam dentro do nó do firmware.
- ats-mini tool · macOS / Linux
- Firmware PU2QTF · ESP32-S3
- Beacon schedule · UTC clock
- SI4732 · receiver
- EiBi schedule
- GitHub releases · this fork
Como funciona por dentro
Fronteira com o oficial: o firmware continua em ats-mini/ (Arduino). O código novo da abertura mora em Intro.cpp e Intro.h, separado de propósito: quanto menos arquivos do upstream eu edito, menor o conflito no próximo merge.
Beacons: o rádio não decodifica o CW do beacon, ele calcula. O sistema NCDXF/IARU é uma escala fixa: cada um dos 18 beacons transmite 10 segundos por banda, num ciclo de 3 minutos, sincronizado em UTC. Sabendo a hora UTC e a frequência sintonizada, o firmware sabe quem deveria estar no ar. Por isso o relógio é a dependência crítica dessa função.
EiBi: o comando J dispara o download da programação mundial e devolve o resultado pela serial, o que permite atualizar a base sem mexer no menu. O nome da estação em ondas curtas vem dessa base.
Memórias: as 96 memórias não saíram de lista na internet. Vieram das varreduras de FM, AM e ondas curtas que estão em pu2qtf/scans/, feitas com a própria ferramenta ats-mini em São Bernardo do Campo. Em pu2qtf/memorias/ fica a pesquisa das estações locais.
Abertura silenciosa: a tela simula CW, mas o rádio não emite o áudio. O motivo está documentado em pu2qtf/docs/experimento-audio-rf.md.
Relógio errado, beacon errado, sem aviso
A identificação do beacon é cálculo sobre a hora UTC, não leitura do sinal. Com o relógio deslocado em 10 segundos, o display mostra o beacon vizinho na escala com a mesma confiança. Antes de confiar no nome exibido, rode ? pela USB e confira o status do relógio.
Instalar e usar
- 1
Escolha o caminho de gravação
pu2qtf/docs/instalacao.mdcobre três caminhos: pelo navegador, pela linha de comando ou pelo Wi-Fi. Pelo navegador é o mais rápido para quem nunca gravou um ESP32-S3. - 2
Ligue e confira a abertura
Ao ligar, a abertura em CW roda na tela. Clique no knob para pular. Se ela aparece, a gravação deu certo.
- 3
Sintonize um beacon
Vá para 14100 kHz (ou 18110, 21150, 24930, 28200). O display passa a mostrar qual beacon está no ar naquele instante.
- 4
Conecte pelo USB
Use
?para ver relógio e EiBi eJpara baixar a programação de ondas curtas. A ferramentapu2qtf/tools/ats-minifaz status, sintonia, varredura, gravação de memórias e screenshots; os comandos estão empu2qtf/docs/uso.md. - 5
Atualize pelo próprio rádio
Settings → Update FW busca as versões deste fork. Não precisa regravar pelo cabo para receber a próxima versão.
git clone https://github.com/fernandofatech/ats-mini-pu2qtf.git
cd ats-mini-pu2qtf
ls pu2qtf/docs # instalacao.md, uso.md, desenvolvimento.md, experimento-audio-rf.md
ls pu2qtf/tools # ats-mini (controle pelo USB)
ls ats-mini/Intro.* # código da abertura PU2QTFO custo real: acompanhar o upstream
Escrever as funções novas levou pouco tempo. O custo de um fork de firmware não é o de criar, é o de manter cada versão oficial entrando sem quebrar a personalização. Organizei o repositório em volta disso:
- Código novo isolado em
Intro.cpp/Intro.h, para o merge com o oficial tocar o mínimo de arquivos compartilhados. - Changelog por fragmentos (towncrier) em
changelog/: cada mudança da edição PU2QTF fica registrada separada das notas do upstream, o que deixa claro o que é meu na hora de rebasear. - Documentação em duas camadas:
docs/é a documentação oficial (Sphinx), intocada;pu2qtf/docs/é a desta edição, em pt-BR.
pu2qtf/docs/desenvolvimento.md descreve o ciclo inteiro: compilar, testar, trocar o indicativo, acompanhar o firmware oficial e publicar versões. Trocar o indicativo é o ponto de partida para quem quiser a mesma abertura com o próprio callsign.
Perguntas frequentes
A abertura transmite CW de verdade?
Não. O ATS-Mini é receptor; o CQ aparece só na tela e a abertura é silenciosa. O porquê está em experimento-audio-rf.md.
Serve para quem não está em São Paulo?
Sim, com uma ressalva. Beacons, EiBi pelo USB e a ferramenta ats-mini valem em qualquer lugar. As memórias de FM e AM foram medidas na Grande SP; fora daqui, use a ferramenta para varrer o seu dial e gravar as suas.
Atualizar pelo Wi-Fi apaga a personalização?
Não. Update FW busca as versões deste fork, não as do oficial.
Posso trocar PU2QTF pelo meu indicativo?
Pode. O procedimento está em pu2qtf/docs/desenvolvimento.md, junto com compilação e publicação de versões.
Referências
Para quem é
Use esta edição se você tem um ATS-Mini, escuta beacons ou radioamador em HF e quer operar o rádio pelo computador; se mora na Grande SP, as memórias poupam uma tarde de varredura. Fique no firmware oficial se você só ouve FM e AM e não quer depender de um fork pessoal para receber correções: cada versão nova chega aqui só depois que eu faço o merge.
Deep dives de arquitetura, AWS, IA e mercado: direto no seu email. Grátis.
Sem spam · cancele quando quiser