2.5 KiB
2.5 KiB
PROMETEU Runtime Specs
Este diretório reúne as specs da maquina PROMETEU no nível de sistema, hardware virtual, firmware, cartridge e ABI de host.
PROMETEU não é apenas a VM. A VM é um subsistema da fantasy handheld / fantasy console. As specs aqui descrevem a maquina maior e sua superfície técnica.
Princípios desta organização:
- estrutura plana;
- sem pasta
topics/; - sem navegação embutida
Back/Next/Summary; - nomes de arquivos semânticos;
- cada capítulo deve poder ser aberto isoladamente.
Arquivos atuais:
01-time-model-and-cycles.md02-vm-instruction-set.md02a-vm-values-and-calling-convention.md02b-vm-function-values-and-closures.md03-memory-stack-heap-and-allocation.md04-gfx-peripheral.md05-audio-peripheral.md06-input-peripheral.md07-touch-peripheral.md08-save-memory-and-memcard.md09-events-and-concurrency.md09a-coroutines-and-cooperative-scheduling.md10-debug-inspection-and-profiling.md11-portability-and-cross-platform-execution.md12-firmware-pos-and-prometeuhub.md13-cartridge.md14-boot-profiles.md15-asset-management.md16-host-abi-and-syscalls.md16a-syscall-policies.md
Relação com outros docs:
../virtual-machine/ARCHITECTURE.mddefine as invariantes canônicas da VM/runtime.../virtual-machine/ISA_CORE.mddefine a ISA no nível de bytecode.- As specs deste diretório podem aprofundar o modelo da máquina, mas não devem contradizer as invariantes canônicas da VM/runtime quando tratarem dessa camada.
Critério para novos capítulos:
- o nome do arquivo deve comunicar o domínio;
- o capítulo deve ser legível sem depender de trilha de navegação;
- links internos devem ser usados apenas quando agregarem contexto real, não como mecanismo obrigatório de leitura sequencial.