repository·master·Indexed 22 days ago
https://github.com/tasemulators/bizhawkA multi-system emulator designed for high-precision emulation and Tool-Assisted Speedruns (TAS). It features EmuHawk, a C#-based emulator providing advanced debugging, recording, and playback tools. BizHawk supports a wide array of platforms including Windows, Linux, and NixOS, and emulates systems ranging from Atari and Nintendo to Sega, Sony PlayStation, and various arcade machines. The project includes specialized components such as iso-parser for ISO9660 images, LibBizHash for CRC32 and SHA1 hashing, and chd-capi for CHD file format support.
iso-parser is a C# library designed for parsing ISO9660 format disk images. It allows for navigating the file system within an image to determine the sector offset and length of file data, enabling easy reading of file data directly from the disk image.
Limitations:
BizHawk is an emulation project featuring EmuHawk, a multi-system emulator written in C#. It is designed for both casual players and Tool-Assisted Speedrunners (TASers), providing advanced debugging, recording, and playback tools.
Key features common across all cores include:
CPCHawk is the Amstrad CPC emulation core for BizHawk. As of late 2024, development is active with a focus on improving hardware accuracy through gate array and CRTC re-writes.
.DSK image parsing and identification (includes automatic differentiation from ZX Spectrum disk bootloaders)blip_buf is a C library designed for waveform synthesis in classic video game sound chip emulation. It simplifies emulation by handling resampling details via a Band-Limited Step (BLEP) algorithm.
Key features:
LibBizHash provides the unmanaged implementation for BizHawk's hashing functions. It includes:
zlib-ng (licensed under the zlib license).SHA-Intrinsics (Public Domain)..CDT file handlingTo implement a debugger for a system in ares, you can register callbacks with the GDB::server object. The server is designed to be neutral, meaning operations like stopping, stepping, or reading memory should not affect the game's cycle-accurate behavior.
Interactions are categorized into:
For a minimal working session, you must implement register/memory reads and a way to report the Program Counter (PC).
// Example: Registering a register read hook
GDB::server.hooks.regRead = [](u32 regIdx) {
return hex(cpu.readRegister(regIdx), 16, '0');
};
// Example: Main execution loop with PC reporting
while(!endOfFrame && GDB::server.reportPC(cpu.getPC())) {
cpu.step();
}With a core and game loaded, check the status bar (toggle via View > Display Status Bar) for the following indicators:
When using Nix to build BizHawk, you can pass several arguments to customize the build without writing a full Nix expression:
--arg forNixOS false: Wraps the final executable with nixGL to allow it to run on non-NixOS distributions.--argstr buildConfig Debug: Builds the BizHawk solution using the Debug configuration.--argstr extraDefines "CoolFeatureFlag": Adds a specific flag to <DefineConstants/>.--arg initConfig {}: Used to set up keybinds and other configurations (though not recommended for routine use).For a complete list of available parameters, refer to default.nix in the repository.
To build the waterbox native side on Windows 10, use WSL2 with an Ubuntu distribution.
bizhawk repository.sudo apt-get update && sudo apt-get install make cmake clang lld llvm zstdsudo apt-get update && sudo apt-get install make cmake gcc-13 g++-13 llvm zstdclang 16+ or gcc 13 to successfully build libcxx.sudo apt-get update && sudo apt-get install make cmake clang lld llvm zstdDebian/Ubuntu based distributions (confirmed working with Debian 11) are supported. Ensure the following packages are installed via your package manager:
makecmakegcc/g++ or clang/clang++ld or lld (lld is required if using clang)gcc-ar/gcc-ranlib or llvm-ar/llvm-ranlibllvm-configzstdIf your distribution provides outdated compilers, use the LLVM apt repository to obtain recent versions of clang and other LLVM tools.