mirror/uvm32
1
Fork 0
mirror of https://github.com/ringtailsoftware/uvm32.git synced 2026-06-05 22:43: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

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