========================================================
LiveQSO - Integração com N1MM (Bridge Local)
Guia de Instalação e Uso
========================

Este guia explica como configurar a integração entre o LiveQSO e o software N1MM para captura automática de QSOs.

---

1. OBJETIVO

---

Permitir que o LiveQSO receba automaticamente:

* Frequência do rádio
* Modo de operação
* Indicativo trabalhado
* Exchange e RST

Tudo diretamente do N1MM, sem digitação manual.

---

2. PRÉ-REQUISITOS

---

Antes de iniciar, você deve ter:

✔ N1MM Logger+ instalado e funcionando
✔ Rádio configurado no N1MM (ou modo manual)
✔ LiveQSO acessível pelo navegador

---

3. INSTALAÇÃO DA BRIDGE

---

1. Baixe o arquivo:
   LiveQsoBridge.exe

2. Execute o arquivo (duplo clique)

3. Uma janela preta será exibida com a mensagem:

   [OK] Bridge iniciado com sucesso

IMPORTANTE:
Mantenha esta janela aberta durante o uso.

---

4. CONFIGURAÇÃO DO N1MM

---

No N1MM:

1. Acesse:
   Config → Configure Ports, Mode Control, Audio, Other...

2. Localize a seção:
   "UDP Broadcast Data"

3. Configure:

   ✔ Enable UDP Broadcast  → ATIVADO
   ✔ IP Address            → 127.0.0.1
   ✔ Port                  → 12060

4. Salve as configurações

---

5. TESTE DA BRIDGE

---

Abra o navegador e acesse:

http://127.0.0.1:8734/status

Se tudo estiver correto, você verá informações como:

* frequency_hz
* mode
* is_connected

Se não aparecer nada:
→ Verifique se o N1MM está aberto
→ Verifique se o UDP Broadcast está ativado

---

6. USO NO LIVEQSO

---

1. Acesse o LiveQSO

2. Vá em "Novo QSO"

3. Clique em:

   Conectar → Software (N1MM)

4. Se conectado corretamente, aparecerá:

   Conectado N1MM | Frequência | Modo

---

7. OPERAÇÃO AUTOMÁTICA

---

Ao usar o N1MM:

✔ Ao mudar frequência → atualiza no LiveQSO
✔ Ao registrar QSO → preenche automaticamente
✔ Exchange e RST → importados automaticamente

---

8. COMPORTAMENTO ESPERADO

---

## Situação                      | Resultado no LiveQSO

Bridge ativa + rádio ativo    | Conectado N1MM
Bridge ativa sem rádio        | Bridge ativo, sem conexão
Bridge desligada              | Não conectado
Sem internet                  | Modo offline disponível

---

9. PROBLEMAS COMUNS

---

NÃO CONECTA:
→ Verifique se a Bridge está aberta
→ Verifique se o N1MM está rodando

STATUS VAZIO:
→ UDP Broadcast não ativado

FREQUÊNCIA NÃO ATUALIZA:
→ Rádio não configurado no N1MM

---

10. ENCERRAMENTO

---

Para encerrar:

✔ Feche a janela da Bridge

---

11. SUPORTE

---

Em caso de dúvidas, entre em contato com a organização do evento.

========================================================
LiveQSO - Sistema de Log em Tempo Real
======================================