code wiki / emu
topic: emu
43 modules sharing the emu name family (derived from the tree's prefix discipline).
The 'emu' topic family in the Nishi sovereign ecosystem provides a suite of interpreters and benchmarking tools for executing various instruction set architectures within the NX-EMU framework. Modules like nx_emu_arm64 and nx_emu_armv7a offer sovereign execution for aarch64 and ARMv7-A, respectively, while nx_emu_loongarch64 supports LoongArch64. Additional modules such as nx_emu_bench and nx_emu_exceed measure performance and compare the emulator's efficiency against existing solutions, ensuring reliable and transparent evaluation of its capabilities.
auto-narrated by the local model from this topic's module headers; links verified against the wiki index.
narrated overview -- maintained by the narration lane, module links verified against this wiki.
| module | description | lines | funcs |
|---|---|---|---|
| nx_emu_arm64.nx | sovereign aarch64 (A64) interpreter (NX-EMU). | 425 | 14 |
| nx_emu_arm64_main.nx | CLI for NX-EMU aarch64: load + run a static A64 ELF. | 23 | 1 |
| nx_emu_armv7a.nx | sovereign ARMv7-A (32-bit ARM) interpreter (NX-EMU). | 134 | 7 |
| nx_emu_bench.nx | MEASURE the sovereign rv64 emulator's throughput (instructions/sec) so the "behind QEMU on perf" | 95 | 4 |
| nx_emu_cortexm.nx | sovereign ARMv7-M / Cortex-M (Thumb-2) interpreter (NX-EMU). | 167 | 4 |
| nx_emu_exceed.nx | R0.5 MEASURED exceed census for the sovereign emulator vs the incumbent (Emscripten | 85 | 5 |
| nx_emu_exceed_gate.nx | R0.5 gate: proves the emulator exceed census is MEASURED + HONEST, not self-scored. | 142 | 7 |
| nx_emu_loongarch64.nx | sovereign LoongArch64 (LA64) interpreter (NX-EMU). | 143 | 6 |
| nx_emu_loongarch64_main.nx | CLI for NX-EMU loongarch64: load + run a | 17 | 1 |
| nx_emu_mips64.nx | sovereign MIPS64 (n64, big-endian) interpreter (NX-EMU). | 126 | 7 |
| nx_emu_mips64_main.nx | CLI for NX-EMU mips64: load + run a static MIPS64 | 16 | 1 |
| nx_emu_ppc64le.nx | sovereign PowerPC64 little-endian interpreter (NX-EMU). | 148 | 5 |
| nx_emu_ppc64le_main.nx | CLI for NX-EMU ppc64le: load + run a static | 17 | 1 |
| nx_emu_probe.nx | 110 | 13 | |
| nx_emu_probe_gate.nx | NATIVE correctness KAT for nx_emu_probe (R0.0). | 63 | 3 |
| nx_emu_probe_wasm_gate.nx | R0.0 WASM half, NISHI all the way up. | 76 | 2 |
| nx_emu_riscv32.nx | sovereign RV32IM interpreter (NX-EMU, 32-bit XLEN). | 110 | 5 |
| nx_emu_rv64.nx | sovereign RV64 interpreter (NX-EMU). Decodes + | 363 | 11 |
| nx_emu_rv64_main.nx | CLI for NX-EMU: load + run a static RV64 ELF. | 23 | 1 |
| nx_emu_rv64_test.nx | prove the sovereign RV64 interpreter runs real | 68 | 2 |
| nx_emu_s390x.nx | sovereign IBM Z (s390x) interpreter (NX-EMU). | 138 | 5 |
| nx_emu_sparc64.nx | sovereign SPARC V9 (sparc64) interpreter (NX-EMU). | 195 | 6 |
| nx_emu_sparc64_main.nx | CLI for NX-EMU sparc64: load + run a static | 18 | 1 |
| nx_emu_testbed.nx | THE EMU TEST-MATRIX organ: which common laptop configs can the Nishi emu | 244 | 13 |
| nx_emu_testbed_gate.nx | THE REFEREE for the emu testbed. | 132 | 7 |
| nx_emu_uefi.nx | the sovereign UEFI EXECUTION-PROOF harness (NOS execution gate). | 1332 | 32 |
| nx_emu_x86.nx | a minimal sovereign x86-64 interpreter (the THIRD target family, | 62 | 2 |
| nx_emu_x86_boot_kernel_test.nx | x86 full-system ladder R8: an x86 KERNEL BOOTS END-TO-END. | 101 | 9 |
| nx_emu_x86_boot_test.nx | the x86 analog of the rv64 boot: author a tiny x86-64 "boot stub" that | 48 | 5 |
| nx_emu_x86_cf_test.nx | x86 full-system ladder R2: CONTROL FLOW. A self-contained x86-64 | 83 | 7 |
| nx_emu_x86_dev_test.nx | x86 full-system ladder R7: DEVICE MODELS (the 16550 UART serial console). | 48 | 5 |
| nx_emu_x86_farjmp_test.nx | x86 full-system ladder R5 rung-5: PROTECTED-MODE ENTRY (GDT + selector | 47 | 6 |
| nx_emu_x86_k.nx | x86 full-system ladder R4: the CONSOLIDATED kernel-subset x86-64 interpreter | 55 | 4 |
| nx_emu_x86_k_test.nx | x86 ladder R4 KAT: a real FUNCTION CALL through a stack. | 42 | 5 |
| nx_emu_x86_mem_test.nx | x86 full-system ladder R3: MEMORY. Extends the R2 control-flow interp | 80 | 9 |
| nx_emu_x86_mode_test.nx | x86 full-system ladder R5 rung-1: the MODE-TRANSITION RULE. | 37 | 4 |
| nx_emu_x86_modes_test.nx | x86 full-system ladder R5 rung-2: MODE MACHINERY IN EXECUTION. | 98 | 7 |
| nx_emu_x86_paging_test.nx | x86 full-system ladder R6: PAGING (long-mode 4-level page walk). | 69 | 6 |
| nx_emu_x86_real16_test.nx | x86 ladder R9 rung-3: REALLY BOOT THE REAL IMAGE on the sovereign emu. | 79 | 5 |
| nx_emu_x86_rm16_test.nx | x86 full-system ladder R5 rung-3: 16-bit REAL-MODE decode. | 60 | 6 |
| nx_emu_x86_segoff_test.nx | x86 full-system ladder R5 rung-4: REAL-MODE SEGMENT:OFFSET ADDRESSING. | 46 | 6 |
| nx_emu_x86_stage2_test.nx | x86 ladder R9 rung-4: a REAL MULTI-STAGE LOADER, executed end-to-end. | 132 | 5 |
| nx_emu_x86_test.nx | (#3) prove the sovereign x86-64 interpreter, and use it as | 96 | 7 |