mirror of
https://git.triforceproject.com/triforce/source
synced 2026-11-19 16:20:01 -04:00
2.6 KiB
2.6 KiB
host/: the standalone runtime
A fork of the Horizon OS layer of NotRexed's a64-kit (hos/, TOTKPort commit e88744a, 2026-10-31), the runtime
that runs Tears of the Kingdom natively. It replaces the Nintendo SDK at the nn:: boundary: an
HLE(<mangled name>) function here stands in for that SDK function wherever the game calls it
(nx2/standalone.py picks them up at lift time). The rest of the SDK runs as lifted code.
Taken unmodified except as noted:
hos.h, hos_main.c, hos_mem.c, hos_thread.c, hos_svc.c, hos_hostcall.c, nn_os_sync.c, nn_fs.c,
nn_hid.c, nn_libc.c, nn_diag.c, nn_applet.c, nn_audio.c, nvdrv.c.
mkw-recomp's changes:
- The guest window. It is 64-bit, 512 GB, reserved whole. The image sits at Eden's
0x80000000, the address the code was lifted for. The heap starts at 64 GB, and address regions grow down from 512 GB (hos.h). The runtime commits what it hands out (hos_commit), andmkw_glue.ccommits anything else on first touch. TOTK's whole 4 GB window was committed up front. hos_main.c: the image base comes fromgen/hos_image.c.hos_mem.c: the default memory size is a Switch 2 application's 9809 MB.hos_svc.c: MKW's program id, and the code region at the image base.- Graphics.
nvn_native.cis TOTKPort's native NVN layer for NVN2: the Switch 2 driver's device limits (read by running its nvnDeviceGetInteger under Unicorn), GPU addresses over the 64-bit window (identity below 1 TB, virtual pools above), program builders, native images, sparse tile layouts; procs it lacks log their first call and answer 0 (HOS_NVN_STRICT=1: stop, as in TOTKPort).display.cis TOTKPort's window without its emulated-GPU fallback. The replay wasgpu/render(seegpu/PROVENANCE.md); it is the Vulkan back end ingpu/vknow, withgpu/renderas the fallback (host/rx_backend.c).nn_vi.cis MKW's own, with the window's frame pacing. - Virtual cores (
hos_thread.c): on by default with six cores; a waiter's request reaches a holder at its next loop header too (mkw_glue.ca64_poll), and equal-priority holders yield after a 2 ms slice. - Left out: files bound to TOTK or its Maxwell GPU:
gpu.c,nvn_trace.c,hos_prof.c,mods.c,movie*.c,nn_image_debug.c,totk_*.c.mkw_glue.cstands in for the hooks the taken files call into them.mods.ccame back later as Hookshot'shost/mods.c: the RomFS part of Skybound's loader (NotRexed/SkyboundTotk, MIT).
Licensing follows a64-kit: GPL, through suyu's translator in the lifted code (see
third_party/a64-kit/NOTICE.TOTKPort.md).