This commit is contained in:
2026-03-24 13:40:11 +00:00
parent 98c9094eca
commit a9d06aaf86
6 changed files with 1039 additions and 261 deletions
+48 -21
View File
@@ -4,7 +4,7 @@
## 1. Visão Geral
A **PROMETEU VM** é uma máquina virtual:
A **PROMETEU VM** é uma máquina virtual obrigatória e sempre presente no hardware lógico:
* **stack-based**
* determinística
@@ -58,13 +58,14 @@ Propriedades:
## 3. Tipos Fundamentais
| Tipo | Descrição |
| --------- | ---------------------- |
| `number` | ponto flutuante 64-bit |
| `boolean` | verdadeiro/falso |
| `string` | UTF-8 imutável |
| `null` | ausência de valor |
| `ref` | referência ao heap |
| Tipo | Descrição |
| --------- | ----------------------- |
| `integer` | inteiro 64-bit (signed) |
| `float` | ponto flutuante 64-bit |
| `boolean` | verdadeiro/falso |
| `string` | UTF-8 imutável |
| `null` | ausência de valor |
| `ref` | referência ao heap |
Não existem:
@@ -200,19 +201,26 @@ Heap é:
### 6.8 Periféricos (Syscalls)
| Instrução | Ciclos | Descrição |
| ---------------- | -------- | ------------------- |
| `CALL_NATIVE id` | variável | Chamada ao hardware |
| Instrução | Ciclos | Descrição |
|--------------| -------- | ------------------- |
| `SYSCALL id` | variável | Chamada ao hardware |
Exemplos:
#### Syscalls Implementadas (v0.1)
* `gfx.clear`
* `gfx.fillRect`
* `gfx.present`
* `input.get`
* `audio.play`
| ID | Nome | Argumentos (Pilha) | Retorno |
| ---------- | ----------------- | ---------------------------- | ------- |
| `0x0001` | `system.has_cart` | - | `bool` |
| `0x0002` | `system.run_cart` | - | - |
| `0x1001` | `gfx.clear` | `color_idx` | - |
| `0x1002` | `gfx.draw_rect` | `x, y, w, h, color_idx` | - |
| `0x2001` | `input.get_pad` | `button_id` | `bool` |
| `0x3001` | `audio.play` | `s_id, v_id, vol, pan, pitch`| - |
O custo depende do periférico e entra no CAP.
**IDs de Botões:**
- `0`: Up, `1`: Down, `2`: Left, `3`: Right
- `4`: A, `5`: B, `6`: X, `7`: Y
- `8`: L, `9`: R
- `10`: Start, `11`: Select
---
@@ -361,7 +369,26 @@ Efeito prático:
---
## 13. Boot e Cartucho
## 13. Boot ROM e Estado Inicial
A **PROMETEU VM** nunca inicia em um estado totalmente "vazio" ou inativo.
### 13.1 O Boot ROM
Se a máquina for inicializada sem um cartucho específico carregado, a VM executa um **Boot ROM padrão**. Este é um pequeno programa em bytecode embutido no core que:
* Emite um som de "plim" ao iniciar.
* Realiza um ciclo básico de limpeza de tela (preto).
* Exibe um quadrado centralizado (índigo).
* Serve como indicador visual e auditivo de que o hardware lógico está operacional.
### 13.2 Ciclo de Boot
1. O Core é inicializado via `Machine::new()`.
2. A VM é carregada com o Boot ROM via `VirtualMachine::default()`.
3. O PC (Program Counter) é definido como `0`.
4. A execução começa imediatamente no primeiro `step_frame`.
---
## 14. Boot e Cartucho
O core:
@@ -379,7 +406,7 @@ O cartucho:
---
## 13. Extensibilidade
## 15. Extensibilidade
O Instruction Set é versionado.
@@ -394,7 +421,7 @@ Nenhuma instrução existente muda de significado.
---
## 14. Resumo
## 16. Resumo
* VM stack-based
* custo explícito