~/spacelab-golds UTC NORAD DB NETWORK TLE SDR VHF SDR UHF
Author Ramon Mayor Martins, Ph.D. // @rmayormartins // IFSC SJ - Área de Telecomunicações // PU4MAY // spacelab-dashboard
NAMEspacelab-golds: Spacelab GOLDS-UFSC, painel de missão do GOLDS-UFSC, CubeSat 2U do SpaceLab/UFSC com o EDC do INPE SYNOPSISspacelab-golds [--satnogs NORAD] [--rtl vhf|uhf] [--arquivo áudio|IQ] [--simular] DESCRIPTIONRecebe os dois downlinks do satélite (VHF 145,900 MHz · 1200 bd e UHF 468,400 MHz · 4800 bd, 2GFSK com NGHam), decodifica no próprio navegador e distribui cada campo pelo módulo de origem (OBDH, EPS, TTC, antenas, EDC, Payload-X). As fontes são a rede SatNOGS (assim que o NORAD for publicado), um ou dois RTL-SDR ligados por WebUSB, arquivos de áudio ou IQ e um simulador de passagem. Nada transmite: comandos ficam no SpaceLab Transmitter; aqui só se escuta, registra e confere. STATUSaguardando NORAD SEE ALSOgolds-ufsc-doc, obdh2, spacelab-ufsc, Mission Operations Guide (SpaceLab.MOG.GOLDS.2026.08) e VVP do GOLDS-UFSC, MANUAL(10).

MISSAO(1) estado do satélite em uma olhada

fases da missão (MOG, tabela 2.1)
modo do OBDH (parâmetro 9, firmware v1.0)

SATELITE(2) arquitetura, cadeia de RF e barramentos; clique num módulo para abrir a telemetria dele

━ 145,9 MHz amador (TC ↑, beacon e serviço ↓) ━ 468,4 MHz UHF (telemetria e dados ↓) ━ 401,635 MHz SBCD (DCP → EDC) ┅ barramento interno ▢ dado recente (< 15 min)▢ dado antigo
Conectores RF do modelo de voo e notas de integração
enlacecaminhoconexões (diagrama RF do FM, slide 53)
401,635 MHzantena 401,635 → splitter RF → EDC; segunda porta do splitter no EDC redundante ou em terminação de 50 Ωantena MCX → cabo MCX macho angular/SMA macho reto → splitter SMA; splitter SMA → cabo SMA macho reto/MMCX macho angular → EDC MMCX; terminação 50 Ω SMA direto no splitter
468,4 MHzTTC rádio 0 (UHF) → antena 468-469 MHzrádio MCX → cabo MCX macho angular/MCX macho reto → antena MCX
145,9 MHzTTC rádio 1 (VHF) ↔ antena 145-146 MHz (dipolo com balun)rádio MCX ↔ cabo MCX macho angular/MCX macho reto ↔ antena MCX

Barramentos conferidos no firmware do OBDH2: TTC por SPI, EDC por UART (porta 1), EPS por I²C (porta 1), Payload-X por I²C (porta 0), antena ISIS por I²C. O beacon do EPS vai do EPS ao TTC rádio 1 pela UART (tarefa eps_server do TTC2) e sai em 145,9 MHz sem passar pelo OBDH.

ENLACES(3) o que trafega em cada frequência e como sintonizar

MODULOS(4) telemetria separada pelo módulo de origem

RECEPCAO(5) de onde vêm os pacotes

vigia de NORAD
credenciais e proxy

As APIs do SatNOGS não liberam CORS: passam pelo Worker do spacelab-dashboard. Áudio e waterfall vêm direto do armazenamento. O token fica só neste navegador.

observações do GOLDS-UFSC
As observações do satélite agrupadas por estação da rede SatNOGS: quem escutou, quem teve sinal, quem entregou pacote (e quantos só ela pegou) e quem está agendada, com a lista de países. O país de cada estação vem do data/stations.json do spacelab-dashboard; estação fora dessa lista tem o país estimado pela coordenada (marcado com ~). Usa o NORAD do GOLDS-UFSC; até ele sair, o do perfil de decodificação escolhido (o FloripaSat-1 serve para testar).
países (clique para filtrar)
mapa das estações
estações
RTL-SDR direto no navegador por WebUSB (Chrome, Edge ou Opera em desktop). Com dois dongles, ligue um em cada enlace e os dois downlinks ficam monitorados ao mesmo tempo, como pede o MOG (seção 3.2). Se a página não enxergar o dongle, veja MANUAL(10): no Linux é preciso tirar o driver DVB do kernel; no Windows, WinUSB pelo Zadig.
áudio FM demodulado (WAV, OGG, MP3, FLAC)

Saída do discriminador: áudio de observação do SatNOGS, gravação do GQRX/SDR++ em modo FM estreito (sem de-ênfase) ou o WAV do spacelab-decoder.

IQ bruto

Um quadro por linha, em hexadecimal: pacote SLP (começa pelo ID, ex.: 10 20 50 59 30 45 46 53 ...), quadro NGHam com ou sem preâmbulo e sync, ou linhas copiadas de log (o texto fora do hex é ignorado). Útil para saídas do GNU Radio, do spacelab-decoder e do terminal serial do flatsat.

simulador de passagem

Gera pacotes coerentes com os layouts do firmware e as faixas do VVP. Em via RF cada pacote é codificado em NGHam, modulado em GMSK, recebe ruído e Doppler e passa pelo mesmo demodulador do RTL-SDR: o painel inteiro é exercitado sem satélite. Pacotes simulados ficam marcados SIM.

resultado da última simulação
nada simulado ainda

PASSAGENS(6) estação, TLE, próximas janelas, Doppler e traço no mapa

estação
TLE
agora
próximas passagens (48 h)
passagem selecionada

OPERACOES(7) apoio ao diretor de passagem: procedimentos com evidência automática, retornos de TC e checklists

Painel só de escuta. Ele marca sozinho os passos cuja evidência chegou pelo ar (feedback 0x13, PING 0x02, valores 0x14, tabelas 0x12) a partir do início da passagem. Envio de telecomando, chaves HMAC e autorização ficam fora daqui, como exige o MOG (seção 1.1 e regra de ouro).
procedimento
    GO / HOLD / STOP (sugestão, MOG tabela 6.1)
    ?a decisão é do diretor de passagem
      retornos de telecomando recebidos
      parâmetros conhecidos (0x14, tabelas e telemetria)
      Catálogo de telecomandos do OBDH v1.0 (MOG tabela 8.1) e o retorno esperado de cada um
      Checklists da passagem (MOG apêndice A)

      PACOTES(8)

      selecione um pacote

      LOG(9) rede, SDR, decodificação

      MANUAL(10) como cada parte funciona

      1. Do sinal ao campo
      RTL-SDR (960 kS/s, LO a -120 kHz do sinal)        áudio do SatNOGS / WAV / microfone virtual
         │ NCO digital: +120 kHz + Doppler da TLE                   │ (já é a saída do discriminador)
         │ decimação em estágios até 48 kS/s + filtro de canal       │
         │ discriminador FM (atan2 de x[n]·x*[n-1], em Hz)            │
         └───────────────────────────────┬────────────────────────────┘
             filtro passa-baixa ~0,75 × taxa de símbolo
             nível DC = média centrada de 32 símbolos, congelada ao achar o sync (remove o Doppler residual)
             relógio: DPLL por cruzamento de zero + integra-e-descarta
             sync 5D E6 2A 7E com até 3 bits errados, nas duas polaridades
             size tag NGHam (7 tamanhos, até 6 bits errados) → desembaralha CCSDS → CRC-16/X-25
             se o CRC falhar: Reed-Solomon (0x187, fcr 112, prim 11; 8 ou 16 bytes corrigíveis)
             pacote SLP: ID (1 B) + indicativo (7 B, " PY0EFS") + dados → layout do firmware → módulo

      O demodulador foi conferido com o golds-ufsc_beacon.wav do spacelab-decoder (o mesmo pacote EPS de 65 bytes que o pyngham decodifica, 0 erros) e com sinais sintéticos: o codificador NGHam daqui gera exatamente os mesmos bytes que o pyngham.encode para 14 tamanhos de payload, e o Reed-Solomon corrige o máximo teórico. Sensibilidade medida em simulação, 12 quadros por ponto, IQ a 960 kS/s:

      enlacecanalsituaçãodecodifica até
      VHF 1200 bd3,6 kHzDoppler corrigido pela TLEEb/N0 de 17,5 dB sem erro (limite mais baixo não medido)
      VHF 1200 bd11 kHzsem correção, -3,4 kHz17,5 dB, com o RS corrigindo 54 bytes em 12 quadros
      UHF 4800 bd14 kHzDoppler corrigido11,5 dB (10 de 12 quadros)
      UHF 4800 bd36 kHzsem correção, +11 kHz16,5 dB (10 de 12); some abaixo de 14 dB

      Com TLE carregada, a correção de Doppler permite um canal estreito e ganha uns 5 dB na UHF. Por isso o painel liga a correção por padrão quando há TLE.

      2. Pacotes do GOLDS-UFSC (firmware OBDH2 v1.0, EPS2, TTC2)
      IDpacoteenlacetamanhovai para
      0x00beacon do EPS (60 s, do EPS direto para o TTC rádio 1)VHF65, 128 ou 120 BEPS
      0x01message broadcastVHFaté 60 Bserviço amador
      0x02PING answerVHF15 Bserviço amador, OP-02
      0x10telemetria geral (60 s)UHF111 BOBDH, EPS, TTC, antenas, cargas
      0x11Data Request answer: registro gravado na NOR (byte 16 em diante)UHF39 a 152 Bhistórico (OP-08), mensagens SBCD
      0x12tabela de subsistema: estado atual, mesmo formato do 0x11UHF39 a 152 Bmódulo da tabela
      0x13TC feedback: TC, hora a bordo, código de erro (0 a -5)UHF22 BOPERACOES
      0x14parameter value: subsistema, parâmetro, valor de 32 bitsUHF21 BOPERACOES e estado
      0x15packet broadcastUHFaté 53 Bserviço amador

      Valores fora das faixas do VVP aparecem em âmbar ou vermelho (temperaturas de µC 0 a 85 °C, RTD 0 a 45 °C, bateria 6,6 a 8,4 V com limiar crítico de 6500 mV do parâmetro 42, painéis 0 a 2700 mV e 0 a 1000 mA). As faixas ainda marcadas TBC no VVP valem como referência, não como critério.

      3. Divergências encontradas entre documentos e firmware
      • Beacon do EPS em três formatos. O spacelab-decoder e o WAV de amostra usam o formato compacto de 65 B (campos de 8, 16 e 32 bits). O EPS2 desde set/2024 manda 30 valores de 32 bits: no master (jun/2026) com ID 0x00 e indicativo (128 B); no commit a09673d citado na referência [7] do MOG, sem ID nem indicativo (120 B). O painel reconhece os três pelo tamanho e mostra qual chegou em MODULOS(4) › EPS. Vale fechar qual binário voa (item de validação do MOG) e atualizar o decoder.
      • Telemetria geral 0x10. O firmware atual tem 111 B: depois do último contato vêm o próximo TC agendado (105), a fila (109) e o modo (110). O layout do GOLDS no spacelab-decoder para no byte 104 e não traz o modo.
      • Registro do OBDH no Data Request. O VVP (tabela 6.3) descreve 95 B; o format_data_request atual gera 136 B (limiar da bateria, último evento de transição, beacon do EPS ligado, timeout do comissionamento, próximo TC, fila e TLE binária de 50 B). O painel segue o firmware.
      • Buffer da tabela de subsistema. Em process_tc.c (Get Subsystem Table, master 3f0ad36) cada resposta é montada em uint8_t pkt_raw[60], mas a tabela do OBDH tem 152 B, a do EPS 100 B e a do SBCD 64 B. O fsat_pkt_encode copia tudo sem limite, então pedir a tabela 0 ou 1 escreve além do buffer na pilha. O OP-02 pede justamente a tabela do OBDH no primeiro contato: vale conferir no flatsat antes do voo.
      • Índices do Data Request. O VVP fala em período em milissegundos; o firmware usa índices relativos às últimas páginas gravadas, como diz o MOG 8.5.1.
      • Indicativo. O firmware de OBDH, TTC e EPS usa PY0EFS (com espaço à esquerda nos 7 bytes). O painel usa esse indicativo para confirmar identidade.
      4. RTL-SDR no navegador (WebUSB)
      1. Use Chrome, Edge ou Opera em desktop. Firefox e Safari não têm WebUSB.
      2. Linux: o kernel prende o dongle no driver de TV. Crie /etc/modprobe.d/blacklist-rtl.conf com blacklist dvb_usb_rtl28xxu, rode sudo modprobe -r dvb_usb_rtl28xxu e dê permissão ao usuário com uma regra udev, por exemplo SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2838", MODE="0666" em /etc/udev/rules.d/20-rtlsdr.rules, seguida de sudo udevadm control --reload-rules e replugar.
      3. Windows: instale o driver WinUSB no dongle (Zadig, interface 0, "Bulk-In"). Programas que usam o mesmo driver (SDR#, SDR++) precisam estar fechados.
      4. macOS: funciona sem driver extra.
      5. Em RECEPCAO(5) › RTL-SDR, escolha o enlace, clique em "conectar" e selecione o dongle. Com dois dongles, conecte um em cada receptor (o navegador pergunta qual é qual).
      6. O sintonizador fica 120 kHz abaixo do sinal para fugir do pico de DC; o NCO digital traz o sinal ao centro e soma o Doppler da TLE a cada 0,5 s. "Offset medido" mostra o erro de frequência que sobrou (Doppler residual mais o erro do cristal): se ficar sempre perto de um valor fixo, corrija o ppm.
      7. Ganho: comece em 30 a 40 dB com LNA na antena; AGC tende a saturar perto de estações fortes.
      8. "Gravar áudio FM" salva o discriminador em WAV de 48 kHz, que o spacelab-decoder lê direto; "gravar IQ" salva a banda base de 48 kS/s em WAV estéreo, que este painel e o GQRX releem.

      Sem WebUSB, grave com rtl_sdr -f 145780000 -s 960000 -g 40 passagem.cu8 (sinal a +120 kHz) e use RECEPCAO › arquivos › IQ com "sinal a 120000 Hz".

      5. SatNOGS: o que acontece quando o NORAD sair
      1. A vigia consulta o SatNOGS DB a cada 15 min (ajustável). Quando aparece uma entrada GOLDS, o painel guarda o sat_id; quando ela ganha NORAD, vincula sozinho, avisa (toast e, se permitido, notificação do navegador), baixa a TLE e busca as observações.
      2. As observações vêm da Network API. Para cada uma, o painel baixa o áudio OGG (que já é a saída do demodulador FM, com Doppler corrigido pela estação) e roda o mesmo decodificador NGHam daqui, em 1200 bd para 145,9 MHz e 4800 bd para 468,4 MHz. Se a estação publicou quadros demodulados, eles também entram.
      3. A telemetria que outros usuários enviarem ao SatNOGS DB entra pelo botão "telemetria do DB" com o seu token.
      4. Pacotes iguais ouvidos por várias estações viram um só, com a lista de quem ouviu.
      5. No spacelab-dashboard, acrescente o NORAD em satellites.json para o coletor do GitHub Actions também guardar os quadros.

      Até lá, o perfil "FloripaSat-1 (44885)" exercita a mesma cadeia com um satélite real do SpaceLab, e a órbita de referência dele serve para testar passagens.

      6. Simulador e operações

      O simulador monta os pacotes com os mesmos layouts usados na decodificação (ida e volta pelo mesmo código), codifica em NGHam, modula em GMSK com BT 0,5, soma ruído para o Eb/N0 pedido e um Doppler residual aleatório, e passa tudo pelo demodulador do RTL-SDR. "Sequência de primeiro contato" reproduz o OP-02 (feedback do 0x44, PING, modo 0, tabelas 0, 2, 3 e 4, 0x4C, modo 1, beacon e telemetria) e marca o início da passagem, para ver o painel de OPERACOES fechando os passos sozinho. Os botões de WAV e IQ geram arquivos para treinar com GQRX e spacelab-decoder.

      O painel nunca transmite. Telecomandos, chaves HMAC e autorização ficam no SpaceLab Transmitter e com o diretor de passagem. A sugestão GO/HOLD/STOP usa só o que chegou pelo ar (identidade, idade da telemetria, bateria contra o parâmetro 42, temperaturas do VVP, resets, modo).

      7. Créditos e licenças
      • Layouts de pacotes: firmware obdh2, eps2, ttc2 e spacelab-decoder (perfis correlatos), SpaceLab/UFSC, GPLv3.
      • NGHam: protocolo de Jon Petter Skagmo (LA3JPA); codificador conferido contra o pyngham.
      • Driver RTL2832U/R820T por WebUSB: webrtlsdr de Jacobo Tarrio, Apache-2.0, embutido sem alterações.
      • SGP4: satellite.js, MIT, embutido.
      • Dados: SatNOGS / Libre Space Foundation, CC BY-SA. Documentos: MOG rev 0.3 e VVP 1.2 do GOLDS-UFSC (SpaceLab).

      Como embute layouts GPLv3, distribua sob GPLv3 ou compatível, como o spacelab-dashboard.