# ats-mini-pu2qtf

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

- URL: https://fernando.moretes.com/open-source/ats-mini-pu2qtf

- Markdown: https://fernando.moretes.com/open-source/ats-mini-pu2qtf/guide.md?lang=pt

- GitHub: https://github.com/fernandofatech/ats-mini-pu2qtf

- Language: C++

- Topics: ats-mini, esp32-s3, firmware, ham-radio, radioamador, shortwave, si4732

- Stars: 0

- Forks: 0

- Updated: 2026-10-26T21:08:21Z

---

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 (user)

### ATS-Mini

- Firmware PU2QTF ESP32-S3 (compute)
- Beacon schedule UTC clock (data)
- SI4732 receiver (network)

### Internet

- EiBi schedule (external)
- GitHub releases this fork (ci)

### Fluxos

- cli -> fw: comandos USB
- fw -> radio: sintoniza
- fw -> beacon: consulta beacon da vez
- fw -> eibi: baixa (comando J)
- fw -> gh: busca versões

## 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.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. **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 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. **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)](https://github.com/fernandofatech/ats-mini-pu2qtf)
- [Documentação da edição PU2QTF (pu2qtf/docs)](https://github.com/fernandofatech/ats-mini-pu2qtf/tree/HEAD/pu2qtf/docs)
- [Firmware oficial ATS Mini (esp32-si4732/ats-mini)](https://github.com/esp32-si4732/ats-mini)
- [Manual oficial do ATS Mini](https://esp32-si4732.github.io/ats-mini/manual.html)
- [PU2CLR SI4735 Arduino library](https://github.com/pu2clr/SI4735)
- [NCDXF/IARU International Beacon Project](https://www.ncdxf.org/beacon/)

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

## Links

- [GitHub repository](https://github.com/fernandofatech/ats-mini-pu2qtf)
