Memora8 Documentation

Memora8 Application Binary Interface Document version: 1.0 Status: Specification Compiler implementation baseline: SekuraJS 6dd5716 This document describes the function-call and data-layout conventions used by the SekuraJS Memora8 backend. It defines how compatible functions exchange scalar arguments and results, preserve registers, and use the stack. It supplements the Memora8 ISA specification; it does not change instruction behavior. Data model Property Convention General-purpose register width 32 bits ABI word size 4 bytes Pointer size 4 bytes Stack alignment at function boundaries 4 bytes Stack direction Grows toward lower addresses The compiler’s integer scalar types are i8, u8, i16, u16, i32, and u32. Their storage sizes and natural alignments are 1, 2, or 4 bytes. Pointers occupy 4 bytes. Structure fields are placed at their natural alignment, and the complete structure size is rounded up to the greatest field alignment. Arrays contain consecutive elements. ...

Memora8 Instruction Set Architecture Document version: 0.1 Status: Published specification Implementation baseline: Memora8 commit 61039f1 Overview Memora8 is a 32-bit processor architecture with 32 general-purpose registers and fixed-width, 32-bit instruction words. Its 5-bit opcode field defines 32 opcode values. The instruction set includes integer arithmetic and logic, shifts, comparisons, branches and jumps, 32-bit loads and stores, multiplication, division and remainder, bit search, and privileged System Bus access. MTR is not a program instruction or opcode; trap handling is a processor mechanism. ...

Memora8 System Bus and SB/SBI Instructions Document version: 1.0 Status: Specification Purpose The System Bus is Memora8’s privileged control interface for processor and device operations. It is separate from ordinary program memory: LW and SW access addresses through the CPU’s memory and MMU path, while SB and SBI access the System Bus contract directly. The System Bus is intended for control and status exchange, device commands, and platform services rather than general-purpose data storage. ...

mr8sim Command-Line Reference Document version: 1.0 Status: Published specification mr8sim starts from a JSON launch file. The file selects the startup mode and describes the system and workload. The command line provides help and optional values for module arguments. Invocation mr8sim [--r2=VALUE ... --r7=VALUE] <launch.json> The JSON launch file is required for every run. The path is resolved from the current working directory. Run the maintained examples from the root of the Memora8 repository. ...

mr8sim Launch Configuration Format Document version: 1.0 Status: Specification Implementation baseline: Memora8 commit 61039f1 mr8sim reads a JSON launch file passed as its positional command-line argument. The file must contain a JSON object. There is no schema_version property in the current format; this document version identifies this description, not a field that should be added to the JSON file. A launch file may use decimal JSON numbers. Unsigned 32-bit fields also accept numeric strings such as "0x200", which is useful for address-like values. Boolean fields must be JSON true or false, and string fields must be quoted. Paths are resolved from the process working directory. ...

MR8Sim Proprietary Software License Document version: 1.0 Copyright: © 2026 Jupiter Soft. All rights reserved. These are the license terms for proprietary MR8Sim software. Third-party components remain subject to their own license terms; see the separate third-party notices supplied with MR8Sim. In particular, MR8Sim’s FTXUI dependency is under the MIT License. 1. Scope This License applies to proprietary MR8Sim software distributed by Jupiter Soft, including: the mr8sim simulator; associated executable files, libraries, resources, documentation, and other materials distributed as part of MR8Sim, except for third-party components that are subject to their own license terms. ...