mirror/uvm32
1
Fork 0
mirror of https://github.com/ringtailsoftware/uvm32.git synced 2026-06-06 06:53:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

README style tweak

Browse source
This commit is contained in:
Toby Jaffey 2025-12-06 16:45:23 +00:00
parent c9d30b6d28
commit 51494ec10d
1 changed files with 57 additions and 55 deletions
Download patch file Download diff file Expand all files Collapse all files

96
README.md
View file

@ -90,61 +90,63 @@ Here is a full example of a working VM host from [apps/emulator-mini](apps/emula
-- --
#include <stdio.h> ```c
#include <string.h> #include <stdio.h>
#include <stdlib.h> #include <string.h>
#include "uvm32.h" #include <stdlib.h>
#include "../common/uvm32_common_custom.h" #include "uvm32.h"
#include "../common/uvm32_common_custom.h"
// Precompiled binary program to print integers // Precompiled binary program to print integers
// This code expects to print via CSR 0x13C (IOREQ_PRINTD in common/uvm32_common_custom.h) // This code expects to print via CSR 0x13C (IOREQ_PRINTD in common/uvm32_common_custom.h)
uint8_t rom[] = { uint8_t rom[] = {
0x23, 0x26, 0x11, 0x00, 0xef, 0x00, 0x00, 0x01, 0x73, 0x50, 0x80, 0x13, 0x23, 0x26, 0x11, 0x00, 0xef, 0x00, 0x00, 0x01, 0x73, 0x50, 0x80, 0x13,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x93, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x93, 0x07, 0x00, 0x00,
0x13, 0x07, 0xa0, 0x00, 0x73, 0x90, 0xc7, 0x13, 0x93, 0x87, 0x17, 0x00, 0x13, 0x07, 0xa0, 0x00, 0x73, 0x90, 0xc7, 0x13, 0x93, 0x87, 0x17, 0x00,
0xe3, 0x9c, 0xe7, 0xfe, 0x67, 0x80, 0x00, 0x00 0xe3, 0x9c, 0xe7, 0xfe, 0x67, 0x80, 0x00, 0x00
}; };
// Create an identifier for our host handler // Create an identifier for our host handler
typedef enum { typedef enum {
F_PRINTD, F_PRINTD,
} f_code_t; } f_code_t;
// Map VM ioreq IOREQ_PRINTD (0x13C) to F_PRINTD, tell VM to expect write of a U32 // Map VM ioreq IOREQ_PRINTD (0x13C) to F_PRINTD, tell VM to expect write of a U32
const uvm32_mapping_t env[] = { const uvm32_mapping_t env[] = {
{ .csr = IOREQ_PRINTD, .typ = IOREQ_TYP_U32_WR, .code = F_PRINTD }, { .csr = IOREQ_PRINTD, .typ = IOREQ_TYP_U32_WR, .code = F_PRINTD },
}; };
int main(int argc, char *argv[]) { int main(int argc, char *argv[]) {
uvm32_state_t vmst; uvm32_state_t vmst;
uvm32_evt_t evt; uvm32_evt_t evt;
bool isrunning = true; bool isrunning = true;
uvm32_init(&vmst, env, sizeof(env) / sizeof(env[0])); uvm32_init(&vmst, env, sizeof(env) / sizeof(env[0]));
uvm32_load(&vmst, rom, sizeof(rom)); uvm32_load(&vmst, rom, sizeof(rom));
while(isrunning) { while(isrunning) {
uvm32_run(&vmst, &evt, 100); // num instructions before vm considered hung uvm32_run(&vmst, &evt, 100); // num instructions before vm considered hung
switch(evt.typ) { switch(evt.typ) {
case UVM32_EVT_END: case UVM32_EVT_END:
isrunning = false; isrunning = false;
break; break;
case UVM32_EVT_IOREQ: // vm has paused to handle IOREQ case UVM32_EVT_IOREQ: // vm has paused to handle IOREQ
switch((f_code_t)evt.data.ioreq.code) { switch((f_code_t)evt.data.ioreq.code) {
case F_PRINTD: case F_PRINTD:
// Type of F_PRINTD is IOREQ_TYP_U32_WR, so expect value in evt.data.ioreq.val.u32 // Type of F_PRINTD is IOREQ_TYP_U32_WR, so expect value in evt.data.ioreq.val.u32
printf("%d\n", evt.data.ioreq.val.u32); printf("%d\n", evt.data.ioreq.val.u32);
break; break;
} }
break; break;
default: default:
break; break;
} }
} }
return 0; return 0;
} }
```
## Samples ## Samples