1º Hackathon TV Box Unesp Sorocaba — Equipe 1

O MultiForge é uma plataforma open-source de preparação, provisionamento e gerenciamento de dispositivos ARM, voltada ao reaproveitamento de TV Boxes apreendidas como computadores de borda para uso educacional. A proposta é oferecer uma base reutilizável para diferentes aplicações, desde o catálogo de hardware e a gravação do sistema até a configuração de rede e a operação dos módulos.

Na BTV E10 (2 GB de RAM e 8 GB de eMMC), a plataforma reúne Linux otimizado, configuração Wi-Fi pelo celular via QR Code na TV, monitoramento do equipamento e recuperação automática de falhas de conexão. Assim, a infraestrutura de implantação fica separada das aplicações que o dispositivo executa.

Módulo principal: M.A.B.I (Mina — Assistente Baseada em Inteligência). A assistente acadêmica transforma a TV Box em um totem interativo de acesso a informações universitárias, com interface interativa na TV e consulta a dados acadêmicos locais. O coletor acadêmico RAG complementa essa aplicação com recursos de busca e indexação; funcionalidades conectadas dependem dos serviços disponíveis.

O MultiForge fornece a infraestrutura comum; a Mina demonstra seu uso principal na educação. Essa separação permite ampliar a plataforma com outros módulos sem refazer o processo de preparação e configuração do equipamento.

Repo principal (código completo): https://github.com/multi-forge/multi-forge

• Brenda Biral (@BrendaBiral)
• Adriel Henrique Souza (@AdrielH024)
• Marcos Oliveira e Silva (@marquinho20-bot)
• Isaac Andrade (@alguemaiYT)

Validar que uma TV Box apreendida e reaproveitada pode funcionar como um totem acadêmico autônomo, capaz de:

• Operar como ponto de acesso Wi-Fi para configuração inicial sem teclado, mouse ou monitor externo — apenas TV + celular;
• Provisionar conexão com redes universitárias (incluindo eduroam com EAP/802.1X);
• Recuperar-se automaticamente de falhas de conexão sem intervenção humana;
• Hospedar uma assistente virtual acadêmica com interface interativa na TV;
• Servir como plataforma extensível para outros módulos de aplicação;
• Funcionar dentro das restrições de 2 GB de RAM e armazenamento limitado.

Projetos de inclusão digital e informação acadêmica normalmente dependem de computadores convencionais, terminais dedicados ou aplicativos mobile — todos com custo ou dependência de infraestrutura que limita a implantação.

A Multi-Forge propõe reaproveitar TV Boxes apreendidas pela Anatel como computadores de borda de baixo custo. A M.A.B.I é a prova de que esse hardware, com as otimizações certas, pode entregar uma experiência útil e acessível.

O sistema opera em quatro camadas independentes:

flowchart TB
    subgraph Desktop["1. Preparação — Desktop"]
        FI["ForgeImager (Rust + Tauri)<br/>Grava a imagem no MicroSD<br/>Injeção de config Wi-Fi em ext4<br/>Verificação SHA-256"]
    end

    subgraph Borda["2. Borda — TV Box BTV E10 (S905X2)"]
        subgraph OS["ForgeOS — Sistema Base"]
            DTB["DTB Enterprise<br/>SDIO 25 MHz + CMA 64 MB<br/>ZRAM ZSTD + BBRv3"]
            AP["Ponto de Acesso<br/>192.168.4.1<br/>wpa_supplicant mode=2"]
            DISP["Tela HDMI /dev/fb0<br/>QR Code na TV (1080p)"]
            PORTAL["Portal Web :8080<br/>Scan Wi-Fi, provisioning,<br/>telemetria, logs, módulos"]
            WATCH["Watchdog 75 s<br/>Rollback automático para AP"]
        end
        subgraph Modules["ForgeModules — Aplicações"]
            MABI["M.A.B.I (Mina)<br/>Assistente acadêmica<br/>GUI PyQt5 + SQLite"]
            RAG["Coletor + RAG<br/>FastAPI + LangChain<br/>PostgreSQL/SQLite + Redis"]
        end
    end

    subgraph Dados["3. Dados"]
        FDB["ForgeDB<br/>Catálogo de dispositivos<br/>JSON Schema Draft 2020-12<br/>CDN jsDelivr + fallback offline"]
    end

    subgraph User["4. Usuário"]
        TV["TV (HDMI)"]
        CEL["Celular"]
    end

    FI -->|MicroSD| OS
    DISP -->|QR na tela| TV
    TV -->|Usuário lê QR| CEL
    CEL -->|Acessa portal| AP
    AP --> PORTAL
    PORTAL -->|Provisiona Wi-Fi| WATCH
    FDB -->|Manifesto de módulos| PORTAL

• Offline-first: todo o provisionamento funciona sem internet — a box cria sua própria rede.
• Sem periféricos: não precisa de teclado, mouse nem monitor. A TV mostra o QR, o celular faz o resto.
• Recuperação automática: se a senha do Wi-Fi estiver errada ou a rede cair, o watchdog restaura o ponto de acesso em 75 segundos.
• Modular: a Mina (M.A.B.I) é o módulo principal da proposta educacional; outras aplicações podem ampliar a plataforma por meio de manifestos module.yaml.

  TV Box lacrada
       ↓
  Grava MicroSD com ForgeImager (PC)
       ↓
  Insere o cartão, liga HDMI + energia
       ↓
  TV mostra QR Code do ponto de acesso
       ↓
  Celular lê o QR → conecta no Wi-Fi "ForgeOS-Setup-E10"
       ↓
  Abre http://192.168.4.1:8080 → portal web
       ↓
  Escolhe a rede Wi-Fi da universidade
       ↓
  Box conecta → TV mostra telemetria (IP, temp, RAM)
       ↓
  M.A.B.I inicia e fica pronta para uso

1. O portal faz scan das redes próximas e mostra na tela do celular, com intensidade de sinal (RSSI) e tipo de segurança.
2. O usuário escolhe a rede. Para redes WPA2-PSK, basta digitar a senha. Para redes EAP (eduroam), o portal pede método (PEAP/TTLS/PWD/TLS), identidade e credenciais.
3. A box aplica as credenciais via wpa_supplicant, testa a conexão (verifica IP + gateway) e informa o resultado na TV.
4. Se falhar, o watchdog restaura o ponto de acesso automaticamente em 75 segundos — sem precisar reiniciar.

  Box conecta na rede solicitada
       ↓
  Watchdog monitora a cada 75 s:
    - Verifica se há IP válido
    - Testa alcance do gateway
       ↓
  Se falhar:
    - Restaura modo AP (192.168.4.1)
    - TV volta a mostrar QR
    - Portal reabre para nova tentativa

1. O usuário envia uma pergunta pela interface na TV.
2. A M.A.B.I consulta os dados acadêmicos locais (SQLite) e, se disponível, complementa com recursos de IA conectados (LangChain + RAG).
3. A resposta aparece na tela da TV (PyQt5).

A TV Box renderiza diretamente no framebuffer Linux — não precisa de servidor gráfico.

QR Code do ponto de acesso

Visão geral	Rede	Serviços

Módulos	Logs RFC 5424	Mobile

Vista explodida: tampa superior, blindagem, PCB (SoC Amlogic S905X2, RAM, eMMC e conectores), chassi e tampa inferior.

A distribuição inclui patches em nível de kernel, device tree, rede e gerenciamento de memória para garantir estabilidade no hardware da TV Box:

Projeto Equipe 1/
├── readme.md                    # Este arquivo
├── ForgeOS/                     # Sistema base da TV Box
│   ├── bin/
│   │   ├── start-ap.sh            # Inicialização do ponto de acesso
│   │   ├── apply-sta.sh           # Aplicação de credenciais Wi-Fi
│   │   └── watchdog.sh            # Monitoramento + rollback (75 s)
│   ├── web/
│   │   ├── server.py              # Servidor HTTP REST (stdlib Python)
│   │   └── index.html             # Portal SPA responsivo
│   ├── display/
│   │   └── display_manager.py     # Renderização HDMI via /dev/fb0
│   ├── dtb/
│   │   ├── meson-g12a-btv-e10-enterprise.dts  # Device Tree (fonte)
│   │   └── meson-g12a-btv-e10-enterprise.dtb  # DTB compilado
│   ├── distro/
│   │   ├── build-image.sh         # Pipeline de construção de imagem
│   │   └── gcp-spot-launcher.py   # Compilação em instância Spot GCP
│   ├── systemd/                   # Units dos serviços
│   └── tests/                     # Testes do servidor e DTB
│
├── ForgeModules/                # Aplicações modulares
│   ├── totem/                     # M.A.B.I (Mina)
│   │   ├── main_gui.py             # Interface PyQt5 para TV
│   │   ├── main_cli.py             # Modo terminal
│   │   ├── src/                     # Core da assistente
│   │   ├── models/                  # Modelos da assistente
│   │   └── module.yaml              # Manifesto para ForgeOS
│   └── sub-modulos/
│       └── web-scraping/            # Coletor RAG acadêmico
│           ├── collector/             # Scraping assíncrono (aiohttp)
│           ├── api/                   # FastAPI + rotas REST
│           ├── agent/                 # LangChain + RAG
│           ├── database/              # PostgreSQL + SQLAlchemy
│           └── frontend/              # Dashboard web
│
├── ForgeDB/                     # Catálogo de dispositivos e módulos
│   ├── devices/                   # Especificações de hardware
│   ├── modules/                   # Catálogo de módulos (catalog.yaml)
│   └── schemas/                   # JSON Schema para validação
│
├── ForgeImager/                 # Gravador desktop (Rust + Tauri + React)
│   ├── src-tauri/                 # Backend Rust
│   ├── crates/
│   │   └── forge-write-conf/        # Injeção em ext4 sem mount
│   └── src/                       # Frontend React
│
├── docs/                        # Auditorias e documentação técnica
└── imagens/                     # Screenshots reais + logo

• Imagem pré-compilada do sistema
• ForgeImager — código-fonte e instruções de compilação

# Opção A: ForgeImager (interface gráfica)
cd ForgeImager && pnpm install && pnpm tauri dev

# Opção B: Linha de comando
xzcat forgeos-btv-e10.img.xz | sudo dd of=/dev/sdX bs=4M status=progress && sync

1. Insira o MicroSD na BTV E10.
2. Conecte o cabo HDMI na TV e ligue a energia.
3. Aguarde ~30 segundos — a TV mostra o QR Code do ponto de acesso.
4. No celular, leia o QR Code (ou conecte manualmente na rede ForgeOS-Setup-E10).
5. Abra http://192.168.4.1:8080 no navegador do celular.
6. Escolha a rede Wi-Fi, insira as credenciais e aguarde a confirmação na TV.

• Portal web: http://<ip-da-box>:8080
• SSH: ssh root@<ip-da-box>

• DTB meson-g12a-btv-e10-enterprise.dts: SDIO 25 MHz (RTL8189FTV), CMA 64 MB, watchdog habilitado.
• Portal 13 KB, zero dependência externa, EAP completo (PEAP/TTLS/PWD/TLS).
• ForgeDB validado em CI (JSON Schema Draft 2020-12) + CDN jsDelivr + fallback offline.
• 34 testes do Provisioner (unitários + integração + E2E Playwright).
• ForgeImager com injeção userspace em ext4 (forge-write-conf) sem necessidade de mount.
• Compilação de imagem automatizada em instância Spot do Google Cloud Platform.

• 📄 Artigo em PDF (neste repositório)
• Leia/editável no Overleaf

MIT — 1º Hackathon TV Box Unesp Sorocaba (2026).