Pular para o conteúdo
fernando.moretes.com
BlogEstudosCursosE-booksOpen SourcePodcasts
Loading…
Fernando Azevedo

Arquiteto de TI Especialista

Arquitetura, AWS, IA em produção, sistemas financeiros e FinOps, escritos a partir do que foi operado, com os números.

  • LinkedIn
  • GitHub
  • E-mail

Conteúdo

  • Blog
  • Estudos de arquitetura
  • Cursos
  • E-books
  • Open Source
  • Podcasts
  • Assuntos
  • Trilhas

Ferramentas

  • Moretes Architect MCP
  • Well-Architected self-check
  • Arquitetura deste site
  • Números públicos
  • Histórico de estudo

Sobre

  • Comunidade
  • Hugging Face
  • IA Builder
  • Perfil
  • Currículo (CV)
  • Trabalhe comigo
  • Media kit
  • RSS do blog
  • RSS dos estudos
  • Artigos narrados (podcast)
  • llms.txt
  • Termos, privacidade e uso de IA

(c) 2026 Fernando Francisco Azevedo

Open Source/ats-mini-pu2qtf
C++ fork

ats-mini-pu2qtf

Firmware ATS-Mini para escuta em SP: beacons NCDXF ao vivo, EiBi e controle por USB

MITAtualizado em 26 de out. de 2026000 visualizações00 reproduções
Compartilhar:LinkedInWhatsAppXBaixar em Markdown
#ats-mini#esp32-s3#firmware#ham-radio#radioamador#shortwave#si4732
Ver no GitHub
git clone https://github.com/fernandofatech/ats-mini-pu2qtf.git
Ouvir guia

cerca 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

Abertura em CW na tela: "CQ CQ CQ DE PU2QTF K" aparece letra a letra como num decodificador, com pontos e traços, waterfall e faixa de mensagem. Um clique no knob pula.
Beacons NCDXF/IARU ao vivo: em 14100, 18110, 21150, 24930 e 28200 kHz o display mostra qual dos 18 beacons está transmitindo, por exemplo Beacon LU4AA Buenos Aires.
EiBi pelo USB: o comando remoto J baixa a programação mundial de ondas curtas e informa o resultado; ? mostra o status do relógio e da EiBi.
Ferramenta 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.
96 memórias prontas: FM e AM da Grande SP medidas no local, ondas curtas e 26 frequências de radioamador (CW, FT8, SSB, beacons, SSTV, WWV).
Update pelo Wi-Fi a partir do fork: atualizar o firmware não devolve o rádio à versão oficial.

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.

Computador
  • ats-mini tool · macOS / Linux
ATS-Mini
  • Firmware PU2QTF · ESP32-S3
  • Beacon schedule · UTC clock
  • SI4732 · receiver
Internet
  • 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. 1

    Escolha o caminho de gravação

    pu2qtf/docs/instalacao.md cobre 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. 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. 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. 4

    Conecte pelo USB

    Use ? para ver relógio e EiBi e J para baixar a programação de ondas curtas. A ferramenta pu2qtf/tools/ats-mini faz status, sintonia, varredura, gravação de memórias e screenshots; os comandos estão em pu2qtf/docs/uso.md.

  5. 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.

Clonar e localizar o que importa
bash
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 PU2QTF

O 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

fernandofatech/ats-mini-pu2qtf (GitHub)Documentação da edição PU2QTF (pu2qtf/docs)Firmware oficial ATS Mini (esp32-si4732/ats-mini)Manual oficial do ATS MiniPU2CLR SI4735 Arduino libraryNCDXF/IARU International Beacon Project

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.

Curte open source e arquitetura? Receba mais.

Deep dives de arquitetura, AWS, IA e mercado: direto no seu email. Grátis.

Sem spam · cancele quando quiser

Guia gerado com IA a partir do repositório e do README. · Fonte

Continue lendo

C++M5Cardputer-SSHClientCliente SSH de bolso no M5Cardputer: ESP32, teclado físico e um shell remotoLer C++DeskbuddyPainel inteligente para mesa com ESP32 e touchscreen, firmware, web e instalador em um só repo.Ler