Primeiros passos
Para a ESP32, a referência estável atual do projeto é a BRMiner 0.9.9.16b.
1. HardwareESP32-WROOM-32 / ESP32 Dev Module compatível e cabo USB de dados.
2. NavegadorUse Chrome ou Edge em um computador com acesso à porta USB.
3. InstalaçãoO Device Hub grava o firmware sem exigir Arduino IDE.
4. ConfiguraçãoApós instalar, conecte a ESP32 ao Wi-Fi e configure a pool desejada.
A versão 0.9.9.16b é o checkpoint estável atual. Versões experimentais não devem substituir a base Stable sem validação.
Instalação pelo navegador
A instalação oficial é feita pelo Device Hub em install.hashbr.online.
- Feche o Monitor Serial e qualquer programa que esteja usando a porta COM da ESP32.
- Conecte a ESP32 ao computador usando um cabo USB de dados.
- Abra
https://install.hashbr.online.
- Escolha ESP32 e clique em conectar/instalar.
- Selecione a porta USB Serial correspondente à placa.
- Para uma instalação realmente limpa, marque “Erase device”.
- Confirme e aguarde a gravação chegar a 100%.
“Erase device” apaga Wi-Fi, pool, worker e demais configurações salvas. Use quando você deseja uma instalação limpa.
Wi-Fi e primeiro acesso
Depois de uma instalação limpa, a placa entra em modo de configuração local.
Procure uma rede semelhante a BRMiner-Setup-XXXXXX. Conecte-se a ela e abra o endereço local de configuração.
http://192.168.4.1/
Depois de informar o Wi-Fi da sua rede, a ESP32 recebe um novo IP. O endereço exato aparece no Monitor Serial e também pode ser acessado via mDNS quando suportado.
http://IP-DA-PLACA/
http://brminer-xxxxxx.local/
O painel local usa HTTP. Se o navegador tentar HTTPS automaticamente, digite explicitamente http:// antes do IP.
Pool e worker
A BRMiner pode ser configurada para pools compatíveis com o protocolo esperado pelo firmware.
No painel local, informe host, porta, carteira/usuário, worker e senha conforme a documentação da pool escolhida. Não copie parâmetros de uma pool para outra sem confirmar o formato exigido.
O endereço de carteira e as credenciais pertencem ao usuário. A HashBR não precisa armazenar essas informações no portal público.
Painel Web local
A interface local permite acompanhar a ESP32 sem instalar programa adicional.
O painel principal é servido diretamente pela placa. Para diagnóstico rápido, a rota de saúde pode ser usada para verificar se o servidor HTTP está respondendo.
http://IP-DA-PLACA/
http://IP-DA-PLACA/health
Se /health responder e a página principal não, o problema está na WebUI. Se nem /health responder, verifique primeiro rede, IP e servidor HTTP.
Atualizações OTA
A versão 0.9.9.16b utiliza atualização OTA com manifesto assinado e verificação do firmware antes da troca de boot.
O fluxo validado verifica a assinatura ECDSA P-256 do manifesto, grava o firmware no slot inativo, confere o SHA-256 e só então seleciona o novo slot para o próximo boot.
Manifesto assinado → download → slot inativo → SHA-256 → boot validado
A chave privada usada para assinar atualizações nunca deve ser colocada no servidor público, no firmware ou em repositórios públicos.
Recuperação e instalação limpa
Se uma placa estiver com firmware antigo, configuração quebrada ou comportamento inesperado, a recuperação mais simples é uma instalação limpa.
- Tente primeiro o Device Hub com “Erase device” marcado.
- Se a porta estiver ocupada, feche Arduino IDE, Monitor Serial e outros programas.
- Se necessário, apague a flash pelo Arduino IDE e depois retorne ao Device Hub.
Depois de apagar a flash, Wi-Fi, pool e preferências antigas deixam de existir; a placa deve ser configurada novamente.
Segurança
A segurança atual protege a autenticidade das atualizações OTA. A futura HashBR Cloud terá uma camada separada de identidade e controle remoto.
- OTA e controle de dispositivos devem usar chaves diferentes.
- A ESP32 não deve exigir porta aberta no roteador para ser controlada remotamente.
- A futura conta HashBR será projetada com autenticação forte e 2FA.
- Secure Boot e Flash Encryption são etapas futuras e devem ser testadas em hardware de laboratório antes de qualquer ativação definitiva.
Compatibilidade
O Device Hub já lista famílias futuras, mas somente hardware validado deve aparecer como suportado.
| Hardware | Status | Observação |
|---|
| ESP32-WROOM-32 / ESP32 Dev Module | Suportado | BRMiner Stable 0.9.9.16b |
| ESP32 com visor / BRMiner TV | Planejado | Firmware dedicado em desenvolvimento futuro |
| Bitaxe | Em estudo | Exige validação por modelo |
| OCTAXE / NerdOCTAXE | Em estudo | Exige validação por modelo |
| NerdMiner | Em estudo | Exige validação por modelo |
| StarMiner | Em estudo | Exige validação por modelo |
FAQ
Respostas rápidas para os problemas mais comuns.
O navegador não mostra a ESP32. O que verificar?
Use Chrome ou Edge, confirme o cabo USB de dados e feche qualquer programa que esteja usando a mesma porta COM.
O painel não abre pelo IP.
Digite explicitamente http:// antes do IP e teste também /health para separar problema de rede de problema da interface.
Posso instalar por cima de uma versão antiga?
Sim, mas para eliminar configuração residual use uma instalação limpa com “Erase device”.
A versão Stable atual é qual?
BRMiner 0.9.9.16b.
