Antenna coupler rf

ant_control — antenna-coupler

Repositório oficial: Gecesars/ant_control.

Acoplador automático de antena HF, aberto e reparável, para estações de até 100 W PEP. O projeto usa uma rede L comutada por relés, medição direcional forward/reflected baseada em ponte tandem-match e controladora intercambiável: Raspberry Pi Pico H (RP2040) ou Pyboard v1.1 (STM32F405RG), com interface local e USB.

Estado: placas originais Rev A e controladora Pyboard Rev B — protótipos, ainda não validados em potência. Os arquivos foram verificados por ferramentas, simulação e testes de software, mas o conjunto ainda precisa ser montado e ensaiado com VNA, carga fictícia e potência crescente. Não conecte um transmissor ou amplificador antes de cumprir o plano de testes.

Escopo da Rev A

Galeria do projeto

As dez imagens abaixo são geradas diretamente das fontes KiCad e FreeCAD por ./tools/generate-readme-images.sh. Os esquemas são recortados ao conteúdo para manter o desenho legível; a vista Pyboard 3D vem da montagem FCStd/STEP dimensional verificada.

Pico H — esquema	Pyboard v1.1 — esquema

Pico H — PCB	Pyboard v1.1 — PCB

Pico H — vista 3D	Pyboard v1.1 — vista 3D

Placa RF — esquema	Placa RF — PCB

Placa RF — vista 3D	Gabinete — estrutura FreeCAD

Estrutura

• docs/: requisitos, arquitetura, segurança, teoria, fabricação, uso e o dossiê STM32F405RG/.
• hardware/: projetos KiCad, bibliotecas locais, BOM e saídas de fabricação.
• firmware/: firmware RP2040, bring-up Pyboard e núcleo testável no computador.
• mechanical/: fontes FreeCAD e exportações STEP/STL.
• simulation/: modelo da rede L, cargas e relatórios de cobertura.
• tools/: validações e exportações reproduzíveis.
• .github/: CI e checklist de revisão para colaboração.

Começo rápido para desenvolvimento

./tools/bootstrap-check.sh
./tools/run-checks.sh

run-checks.sh testa o núcleo no computador, a simulação, ERC/DRC, a igualdade entre as redes dos três esquemas/PCBs, ambas as BOMs, o binário RP2040 e a sintaxe do bring-up Pyboard. Os caminhos locais de KiCad, FreeCAD, Pico SDK e compilador Arm são detectados pelos wrappers em tools/. Nenhuma ferramenta proprietária é necessária.

Para regenerar fontes e entregáveis:

./tools/generate-hardware.sh
./tools/route-pcbs.sh all
./tools/generate-mechanical.sh
./tools/export-fabrication.sh
python3 tools/package_release.py

Para regenerar somente a variante STM32 sem substituir as PCBs originais:

./tools/generate-hardware.sh --pyboard-only
./tools/route-pcbs.sh pyboard

Antes de fabricar

1. Leia docs/safety.md, docs/manufacturing.md e docs/test-plan.md.
2. Revise o esquemático e rode ERC/DRC.
3. Confirme encapsulamentos, estoque e substitutos da BOM.
4. Fabrique somente unidades de protótipo: Rev A nas placas originais e Rev B na portadora Pyboard.
5. Faça testes sem RF, depois com VNA, 1 W, 5 W, 20 W e só então 100 W.

Licenças

• Hardware: CERN-OHL-S-2.0.
• Firmware e ferramentas: Apache-2.0.
• Documentação: CC-BY-SA-4.0.

Consulte LICENSES/ e os identificadores SPDX em cada fonte. Arquivos derivados de bibliotecas KiCad conservam os termos das bibliotecas de origem.