49 lines
2.5 KiB
Markdown
49 lines
2.5 KiB
Markdown
# 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.md`](01-time-model-and-cycles.md)
|
|
- [`02-vm-instruction-set.md`](02-vm-instruction-set.md)
|
|
- [`02a-vm-values-and-calling-convention.md`](02a-vm-values-and-calling-convention.md)
|
|
- [`02b-vm-function-values-and-closures.md`](02b-vm-function-values-and-closures.md)
|
|
- [`03-memory-stack-heap-and-allocation.md`](03-memory-stack-heap-and-allocation.md)
|
|
- [`04-gfx-peripheral.md`](04-gfx-peripheral.md)
|
|
- [`05-audio-peripheral.md`](05-audio-peripheral.md)
|
|
- [`06-input-peripheral.md`](06-input-peripheral.md)
|
|
- [`07-touch-peripheral.md`](07-touch-peripheral.md)
|
|
- [`08-save-memory-and-memcard.md`](08-save-memory-and-memcard.md)
|
|
- [`09-events-and-concurrency.md`](09-events-and-concurrency.md)
|
|
- [`09a-coroutines-and-cooperative-scheduling.md`](09a-coroutines-and-cooperative-scheduling.md)
|
|
- [`10-debug-inspection-and-profiling.md`](10-debug-inspection-and-profiling.md)
|
|
- [`11-portability-and-cross-platform-execution.md`](11-portability-and-cross-platform-execution.md)
|
|
- [`12-firmware-pos-and-prometeuhub.md`](12-firmware-pos-and-prometeuhub.md)
|
|
- [`13-cartridge.md`](13-cartridge.md)
|
|
- [`14-boot-profiles.md`](14-boot-profiles.md)
|
|
- [`15-asset-management.md`](15-asset-management.md)
|
|
- [`16-host-abi-and-syscalls.md`](16-host-abi-and-syscalls.md)
|
|
- [`16a-syscall-policies.md`](16a-syscall-policies.md)
|
|
|
|
Relação com outros docs:
|
|
|
|
- [`../virtual-machine/ARCHITECTURE.md`](../virtual-machine/ARCHITECTURE.md) define as invariantes canônicas da VM/runtime.
|
|
- [`../virtual-machine/ISA_CORE.md`](../virtual-machine/ISA_CORE.md) define 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.
|