bitborn — software nascido de bits

Experimentar o site · README completo · Idiomas

Escreva os bytes reais de um programa x86 usando zeros e uns. As instruções do Bitborn são escritas à mão em arquivos .bits: nenhum montador ou compilador escolhe os opcodes, operandos ou deslocamentos de salto. Os nomes das instruções nos comentários explicam os bytes; não os geram. Python empacota os bytes e adiciona cabeçalhos ou estruturas de setores. JavaScript alimenta o site educativo.

Sua primeira instrução

10111000 00101010 00000000

Com operandos de 16 bits, estes três bytes significam MOV AX,42. B8 seleciona o registrador; 2A 00 armazena 42 com o byte menos significativo primeiro. O modo de execução importa: com operandos de 32 bits, B8 precisa de quatro bytes de valor imediato em vez de dois. O CPU Lab do navegador executa somente o subconjunto documentado de instruções de 16 bits.

Experimente

No CPU Lab, execute passo a passo, inspecione registradores, flags, pilha e memória, ou restaure estados gravados com Back e Forward. O editor de setores de inicialização permite editar e exportar uma imagem completa de 512 bytes. Os desafios ensinam a modificar bytes literais; seu progresso fica no navegador.

Para construir e testar os programas reais, instale Python 3.10+, Make e QEMU. No macOS: brew install qemu. No Ubuntu: sudo apt-get install python3 make qemu-system-x86.

git clone https://github.com/OthmaneBlial/bitborn.git
cd bitborn
make test
make run

make test verifica os bytes revisados e o comportamento da máquina virtual no QEMU sem interface gráfica. make run abre a imagem de inicialização BIOS. Os exemplos BIOS funcionam no QEMU em Apple Silicon; os ELF nativos precisam de Linux x86-64. Os testes de desenvolvimento do navegador também precisam de Node.js e Playwright; consulte o guia de contribuição.

Escopo e progresso

O repositório inclui programas BIOS, experimentos de teclado/VGA/disco, um shell interativo, um experimento separado de interrupção em modo protegido e exemplos ELF para Linux. O navegador usa um modelo educativo limitado a 1 MiB de memória e 4.096 passos, não uma CPU ou BIOS completa. Programas importados são interpretados, nunca executados como código nativo do host. O suporte a hardware físico, UEFI ou um sistema de produção não foi comprovado. Use emuladores descartáveis para os experimentos nativos.

Roteiro e evidências · Progresso no site · Histórico de mudanças

Comece pelo tutorial e pelo guia de arquitetura. Siga as regras de contribuição e o código de conduta. Relate vulnerabilidades em privado. Código e documentação usam a licença MIT. A introdução em inglês é a fonte desta tradução; os guias técnicos detalhados continuam em inglês.