https://github.com/zyedidia/multiplix Skip to content Toggle navigation Sign up * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Resources + Customer Stories + White papers, Ebooks, Webinars + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} zyedidia / multiplix Public * Notifications * Fork 5 * Star 47 An operating system kernel for RISC-V and AArch64 SBCs License MIT license 47 stars 5 forks Activity Star Notifications * Code * Issues 0 * Pull requests 0 * Actions * Projects 0 * Security * Insights More * Code * Issues * Pull requests * Actions * Projects * Security * Insights zyedidia/multiplix This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. master Switch branches/tags [ ] Branches Tags Could not load branches Nothing to show {{ refName }} default View all branches Could not load tags Nothing to show {{ refName }} default View all tags Name already in use A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch? Cancel Create 21 branches 0 tags Code * Local * Codespaces * Clone HTTPS GitHub CLI [https://github.com/z] Use Git or checkout with SVN using the web URL. [gh repo clone zyedid] Work fast with our official CLI. Learn more about the CLI. * Open with GitHub Desktop * Download ZIP Sign In Required Please sign in to use Codespaces. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching Xcode If nothing happens, download Xcode and try again. Launching Visual Studio Code Your codespace will open once ready. There was a problem preparing your codespace, please try again. Latest commit @zyedidia zyedidia Update ... 13a7914 Aug 30, 2023 Update 13a7914 Git stats * 525 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time .github/workflows Update test workflow April 30, 2023 12:49 coremark Options for enabling coremark June 10, 2023 18:41 docs Add irq and spin guards May 23, 2023 12:45 firmware All cores on orange pi booting May 5, 2023 02:06 lib Add checkers August 23, 2023 13:46 link Add improved buddy allocator May 19, 2023 14:01 src Update August 30, 2023 06:52 tools Add support for open and stat August 16, 2023 15:29 user Minor updates August 29, 2023 18:43 .dscanner.ini Re-enable linter check January 31, 2023 15:51 .gitignore Add support for open and stat August 16, 2023 15:29 .knit.toml Start refactor April 28, 2023 16:19 Knitfile Fix deps August 16, 2023 17:11 LICENSE Add readme and license January 19, 2023 17:51 README.md Update August 30, 2023 06:52 View code Multiplix kernel Supported systems Building Acknowledgements README.md Multiplix kernel Test Workflow MIT License Multiplix is a small operating system serving as the foundation for some research projects in operating systems. It is currently designed as a monolithic kernel plus a special kernel monitor that runs at a higher privilege level. Multiplix is very much in-progress. The current status is that Multiplix can boot all cores, enable virtual memory and interrupts, supports multiple user-mode processes with a limited set of system calls, and has a simple Unix-like file system. Current work is focused on expanding the system call interface to support a shell and a basic user-mode environment. Supported systems Multiplix supports RISC-V and Armv8, specifically on the following hardware: * VisionFive: 2-core SiFive U74 1.0 GHz. * VisionFive 2: 4-core SiFive U74 1.25 GHz (plus a 5th SiFive S7 monitor core). * Raspberry Pi 3: 4-core ARM Cortex A53 1.4 GHz. * Raspberry Pi 4: 4-core ARM Cortex A72 1.5-1.8 GHz. Support for more boards is likely to be added in the future (we have experimental versions running on the Ox64 and Orange Pi Zero 2). Building To build multiplix you must have a GNU bare-metal toolchain and either LDC or GDC. You can get everything you need (prebuilt) from multiplix-toolchain-linux-amd64.tar.gz. You must also have Go installed to build the plboot tool (for creating bootloader payloads). You'll also need QEMU if you want to simulate the OS. Multiplix uses the Knit build tool. The Knitfile has the following targets: * kernel.bin: build the kernel binary. * kernel.boot.bin: build the bootable kernel binary (kernel binary embedded in the bootloader as a payload). * qemu: emulate the kernel using QEMU (requires qemu-system-riscv64 or qemu-system-aarch64). * bootloader.bin: build the kernel bootloader. * prog: send the kernel over UART to the bootloader. You can configure the build for a specific board by specifying setting the board variable to raspi3, raspi4, visionfive, visionfive2, or virt_riscv64 (e.g., knit board=raspi3). Specify the D compiler with dc. Supports dc=ldc or dc=gdc. For example: knit qemu board=virt_riscv64 dc=ldc will build a kernel targeting the QEMU virt machine with LDC and run it in QEMU. The profile option configures the optimization level and LTO. The main possible values are dev (O1 without LTO), and release (O3 with LTO). LTO with LDC requires a distribution of LDC that includes the LLVMgold linker plugin. The unified option controls whether the build is done as a single compilation unit (one invocation of the D compiler), or in parallel with multiple compilation units. You might also find it useful to read this blog post: https:// zyedidia.github.io/blog/posts/1-d-baremetal/. Acknowledgements Multiplix draws heavily from * xv6 (https://github.com/mit-pdos/xv6-riscv) About An operating system kernel for RISC-V and AArch64 SBCs Topics raspberry-pi kernel dlang osdev operating-system riscv aarch64 bare-metal Resources Readme License MIT license Activity Stars 47 stars Watchers 4 watching Forks 5 forks Report repository Releases No releases published Contributors 2 * @zyedidia zyedidia Zachary Yedidia * @Akshay-Srivatsan Akshay-Srivatsan Akshay Srivatsan Languages * D 58.6% * C 28.0% * Go 6.3% * Assembly 5.2% * Makefile 1.7% * Shell 0.2% Footer (c) 2023 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time.