In emulating guests with a simple, flat memory model, we frequently need to translate a guest physical address (GPA) into a host virtual address (HVA). This is a hot path operation that must be efficient as possible. This commit introduces gpa_to_hva(), a static inline helper function designed for this purpose. The implementation relies on the fundamental pre-condition that the guest's physical RAM is backed by a single, contiguous region of host virtual memory (typically acquired via mmap). It treats the GPA not as a pointer but as a direct byte offset from the base of this host mapping. This approach is optimal for performance for two key reasons: 1. The translation is a single pointer-offset calculation, which typically compiles to a single LEA intruction on x86-64. 2. It preserves memory access locality. When a guest performs sequential accesses, the host's accesses are also sequential, allowing the host CPU's hardware prefetcher to function effectively. This helper provides the fast path for simple RAM accesses. More complex address spaces involving discontiguous memory or MMIO regions will require a slower, lookup-based translation mechanism. This function is not intended for those cases. Signed-off-by: Ronald Caesar <github43132@proton.me> |
||
|---|---|---|
| .github/workflows | ||
| 3rd_Party | ||
| android/app/src/main/cpp/org/pound/poundemu | ||
| core | ||
| gui | ||
| resources | ||
| WIP/fs | ||
| .clang-format | ||
| .gitignore | ||
| .gitmodules | ||
| CMakeLists.txt | ||
| CMakeSettings.json | ||
| Compatibility | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.md | ||
Pound
“i think of getting pounded when i see that [name]” – Satisfied Customer
Note
This project is still being worked on, and we really need help as we only have a few developers.
If you know C++ and think you can help out, hop into the Discord and let us know. :)
Overview
Join the Pound Discord Server!
Pound is an early-stage emulator for the Nintendo Switch 2, targeting Windows, Linux and macOS ( Intel and Apple Silicon).
Initial focus is on implementing the architectural similarities to the original Nintendo Switch. Later stages of development will address differences in hardware between the two console generations.
Disclaimer
The goal of this project is to experiment, research, and educate on the topic of emulation of modern devices and operating systems. It is not for enabling illegal activity. All information is obtained via reverse engineering of legally purchased devices and games and information made public on the internet (you'd be surprised what's indexed on Google...). We are not any way affiliated with Nintendo or NVidia.
How to Compile Pound
See the compilation guide for detailed instructions on how to compile Pound.
Codebase
Pound reuses selected components from existing Nintendo Switch 1 emulators, primarily Yuzu.
All third-party code is clearly documented and properly attributed in the relevant parts of the repository.
Contributing
See here before submitting a pull request.
License
- Distributed under the GNU GPL-2.0 license
Credits
- Parts of the emulator are based on code from the Yuzu project.