forked from Ports/goldeneye-pc-port
859a777d61
Co-authored-by: f1zz1ec0ke <220638765+f1zz1ec0ke@users.noreply.github.com> Co-authored-by: danturn <7792186+danturn@users.noreply.github.com> Co-authored-by: JunielKatarn <4507319+JunielKatarn@users.noreply.github.com> Co-authored-by: italoarruda <3868006+italoarruda@users.noreply.github.com>
64 lines
2.7 KiB
C
64 lines
2.7 KiB
C
/*
|
|
* PC port shim for PR/os.h — DRAM address conversions (see docs/internals.md).
|
|
*
|
|
* The game's working RAM lives in the s32-safe DRAM view at 0x70000000
|
|
* ("V1"), with a byte-identical KSEG0 mirror at 0x80000000 ("V2"); see
|
|
* port/src/dram.c. Addresses with bit 31 set sign-extend to invalid
|
|
* pointers through s32 parameters (src/memp.c), so live pointers must stay
|
|
* in V1, while `offset | 0x80000000` rebuilds (src/game/bg.c) must land in
|
|
* V2. The two views share one backing store, so both are the same data.
|
|
*
|
|
* "Physical" addresses in GBI words and ROM data are therefore OFFSETS FROM
|
|
* THE V1 BASE, and the conversions become:
|
|
*
|
|
* OS_K0_TO_PHYSICAL(x) = (u32)((char *)x - 0x70000000)
|
|
* small offset P; fast3d's seg_addr() resolves it with +0x80000000,
|
|
* landing in V2. `P | 0x80000000` (bg.c et al.) also lands in V2.
|
|
* OS_PHYSICAL_TO_K0(x) = x (identity)
|
|
* Callers pass EITHER live V1 pointers (bondview2.c, front.c) — which
|
|
* then go into GBI words as full addresses that fast3d passes through
|
|
* — OR small physical offsets, which fast3d remaps to V2. Both forms
|
|
* resolve correctly.
|
|
* osVirtualToPhysical / osPhysicalToVirtual stay the identity (port/src/
|
|
* libultra.c): V1 addresses are already live host pointers < 4 GB.
|
|
*
|
|
* Inert in the N64 build (no -DPORT): pure pass-through.
|
|
*/
|
|
#ifndef _PORT_SHIM_OS_H_
|
|
#define _PORT_SHIM_OS_H_
|
|
#include "portaddr.h"
|
|
|
|
#if defined(PORT)
|
|
# if defined(__APPLE__)
|
|
/* Darwin exposes errno and sprintf as function-like macros. Suppress them
|
|
* while parsing the N64 API's errno fields and sprintf declaration. */
|
|
# pragma push_macro("errno")
|
|
# pragma push_macro("sprintf")
|
|
# undef errno
|
|
# undef sprintf
|
|
# endif
|
|
# include "include/PR/os.h"
|
|
# if defined(__APPLE__)
|
|
# pragma pop_macro("sprintf")
|
|
# pragma pop_macro("errno")
|
|
# endif
|
|
/* Offset of a DRAM V1 pointer from the V1 base. On macOS the V1 base is
|
|
* PORT_ADDR_BASE + 0x70000000 (PORT_DRAM_V1_BASE, portaddr.h — already
|
|
* included above), so the base must be subtracted too; the result
|
|
* is a small (< 8 MB) offset that fits s32 and that fast3d's seg_addr()
|
|
* re-bases into the V2/KSEG0 mirror. Identity behaviour at PORT_ADDR_BASE==0. */
|
|
# undef OS_K0_TO_PHYSICAL
|
|
# define OS_K0_TO_PHYSICAL(x) ((u32)((uintptr_t)(x) - (uintptr_t)PORT_DRAM_V1_BASE))
|
|
|
|
# undef OS_PHYSICAL_TO_K0
|
|
/* Identity: callers pass either a live V1 pointer (which is preserved with
|
|
* its full 64-bit value through the 64-bit GBI words) or a small physical
|
|
* offset (which fast3d re-bases). Both are unaffected by the window base. */
|
|
# define OS_PHYSICAL_TO_K0(x) ((void *)(x))
|
|
|
|
#else
|
|
# include <PR/os.h>
|
|
#endif
|
|
|
|
#endif /* _PORT_SHIM_OS_H_ */
|