added vm
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user