forked from Ports/goldeneye-pc-port
Add PC port scaffolding (CMake build + port layer)
Initial scaffolding for a PC port of GoldenEye 007, modeled on the Perfect Dark PC port (same Rare "Indy" engine). The N64 build (Makefile + IDA) is untouched; the PC build is a parallel CMake build. Build: - CMakeLists.txt: SDL2 + zlib + OpenGL. Compiles src/game/*.c + curated engine files + libultra audio/gu + port/. Per-region macro sets (ROMID US/EU/JP) mirror the N64 Makefile's LCDEFS exactly. - build-pc.sh, cmake/: configure+build helper and target/SDL2 modules. Port layer (port/): - video/audio/input/fs/romdata/config/system/mixer: stubs with TODO(Phase N) markers and correct interfaces. - libultra.c: libultra OS shims (message queues, VI, PI, AI, EEPROM, controller, PFS/motor no-ops, region-gated osTvType). - gesched.c: software-RSP scheduler replacing src/sched.c task submission. - n64stubs.c: inert stubs for N64-boot + rmon symbols. - random.c: PRNG ported verbatim from src/random.s (bit-exact). - ucode.c: RSP/ASP/GSP microcode segment markers (dummies; Phase 3 TODO). Docs: - docs/PCPortResearch.md: architecture, GE-specific deltas, phased plan, and the scaffolding review (findings A1-A4/B1-B4/C1-C2 + resolutions). - PORTING.md: top-level entry point. See docs/PCPortResearch.md for the full plan.
This commit is contained in:
James Dansereau committed
1 parent
ef209c113c
commit
cd6cc158b6
37 files changed
+3092
-1
No files matched your search
+298
@@ -0,0 +1,298 @@
|
||||
# ============================================================================
|
||||
# GoldenEye 007 — PC port build
|
||||
#
|
||||
# This is a PARALLEL build system to the N64 `Makefile`. It compiles the same
|
||||
# game C sources (src/game, src) for a modern host (Windows/Linux/macOS)
|
||||
# against the PC shims in `port/`. The N64 build is untouched.
|
||||
#
|
||||
# See docs/PCPortResearch.md for the architecture and plan.
|
||||
# Modelled on the Perfect Dark PC port (perfect-dark-pc-port/perfect_dark).
|
||||
#
|
||||
# Usage:
|
||||
# cmake -S . -B build-pc -DROMID=ntsc-final
|
||||
# cmake --build build-pc -j
|
||||
# ============================================================================
|
||||
|
||||
cmake_minimum_required(VERSION 3.16)
|
||||
list(APPEND CMAKE_MODULE_PATH ${CMAKE_SOURCE_DIR}/cmake)
|
||||
|
||||
if(APPLE)
|
||||
if(CMAKE_OSX_ARCHITECTURES MATCHES "arm64")
|
||||
set(CMAKE_OSX_DEPLOYMENT_TARGET "11.0" CACHE STRING "" FORCE)
|
||||
else()
|
||||
set(CMAKE_OSX_DEPLOYMENT_TARGET "10.13" CACHE STRING "" FORCE)
|
||||
endif()
|
||||
endif()
|
||||
|
||||
project(ge007 C CXX)
|
||||
|
||||
include(TargetArch)
|
||||
include(FindPkgConfig)
|
||||
|
||||
set(CMAKE_C_STANDARD 11)
|
||||
set(CMAKE_C_EXTENSIONS OFF)
|
||||
set(CMAKE_CXX_STANDARD 20)
|
||||
set(CMAKE_CXX_EXTENSIONS OFF)
|
||||
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
|
||||
|
||||
# Default build type
|
||||
if(NOT CMAKE_BUILD_TYPE AND NOT EXISTS ${CMAKE_BINARY_DIR}/CMakeCache.txt)
|
||||
set(CMAKE_BUILD_TYPE "RelWithDebInfo" CACHE STRING "" FORCE)
|
||||
endif()
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# Options
|
||||
# ----------------------------------------------------------------------------
|
||||
# Which ROM the executable expects in the data/ dir.
|
||||
set(ROMID "ntsc-final" CACHE STRING "ROM id: ntsc-final (US), pal-final (EU), jpn-final (JP)")
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# Target arch / platform
|
||||
# ----------------------------------------------------------------------------
|
||||
target_architecture(TARGET_ARCH)
|
||||
if(TARGET_ARCH MATCHES "64")
|
||||
set(TARGET_IS_64BIT TRUE)
|
||||
else()
|
||||
set(TARGET_IS_64BIT FALSE)
|
||||
endif()
|
||||
message(STATUS "Target arch: ${TARGET_ARCH} (64bit=${TARGET_IS_64BIT})")
|
||||
|
||||
if(WIN32)
|
||||
set(TARGET_OS "windows")
|
||||
elseif(APPLE)
|
||||
set(TARGET_OS "osx")
|
||||
elseif(UNIX)
|
||||
set(TARGET_OS "linux")
|
||||
else()
|
||||
message(FATAL_ERROR "Unknown target OS")
|
||||
endif()
|
||||
set(TARGET_PLATFORM "${TARGET_ARCH}-${TARGET_OS}")
|
||||
message(STATUS "Target platform: ${TARGET_PLATFORM}")
|
||||
|
||||
# Region -> compile definitions.
|
||||
#
|
||||
# The game code #ifdefs a full per-region macro set (see the N64 Makefile,
|
||||
# the VERSION blocks). e.g. VERSION_EU is used in 60+ files, LEFTOVERDEBUG in
|
||||
# 26, BUGFIX_R1 in 21. We MUST emit the same set the N64 build uses for the
|
||||
# matching region, or the PC build takes different conditional branches and
|
||||
# silently diverges (and fails to link). These mirror Makefile LCDEFS exactly.
|
||||
if(ROMID STREQUAL "ntsc-final")
|
||||
set(VERSION_IS_PAL 0)
|
||||
set(BIN_REGION "")
|
||||
set(REGION_DEFS
|
||||
-DVERSION_US -DLANG_US -DREFRESH_NTSC
|
||||
-DLEFTOVERDEBUG -DLEFTOVERSPECTRUM -DBUGFIX_R0 -DBYTEMATCH)
|
||||
elseif(ROMID STREQUAL "pal-final")
|
||||
set(VERSION_IS_PAL 1)
|
||||
set(BIN_REGION ".pal")
|
||||
set(REGION_DEFS
|
||||
-DVERSION_EU -DLANG_EU -DREFRESH_PAL
|
||||
-DBUGFIX_R1 -DBUGFIX_R2 -DBYTEMATCH)
|
||||
elseif(ROMID STREQUAL "jpn-final")
|
||||
set(VERSION_IS_PAL 0)
|
||||
set(BIN_REGION ".jpn")
|
||||
set(REGION_DEFS
|
||||
-DVERSION_JP -DLANG_JP -DREFRESH_NTSC
|
||||
-DBUGFIX_R1 -DLEFTOVERDEBUG -DLEFTOVERSPECTRUM -DBYTEMATCH)
|
||||
else()
|
||||
message(FATAL_ERROR "Unknown ROMID: ${ROMID}")
|
||||
endif()
|
||||
|
||||
# git hash for version info
|
||||
execute_process(COMMAND git rev-parse --short HEAD
|
||||
WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
|
||||
OUTPUT_VARIABLE VERSION_HASH OUTPUT_STRIP_TRAILING_WHITESPACE
|
||||
ERROR_QUIET)
|
||||
if(NOT VERSION_HASH)
|
||||
set(VERSION_HASH "unknown")
|
||||
endif()
|
||||
configure_file(
|
||||
"${CMAKE_SOURCE_DIR}/port/include/versioninfo.h.in"
|
||||
"${CMAKE_BINARY_DIR}/port/include/versioninfo.h" @ONLY)
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# Compiler definitions & flags
|
||||
# ----------------------------------------------------------------------------
|
||||
add_definitions(
|
||||
-DPORT=1
|
||||
-D_LANGUAGE_C=1
|
||||
-DAVOID_UB=1
|
||||
-DPAL=${VERSION_IS_PAL}
|
||||
${REGION_DEFS}
|
||||
)
|
||||
if(TARGET_IS_64BIT)
|
||||
add_definitions(-DPLATFORM_64BIT=1)
|
||||
endif()
|
||||
|
||||
# The decomp is big-endian N64 code with unaligned accesses; these flags are
|
||||
# required to compile it cleanly on a little-endian host (same as the PD port).
|
||||
add_compile_options(
|
||||
-fno-strict-aliasing
|
||||
-funsigned-char
|
||||
-fwrapv
|
||||
-include "versioninfo.h"
|
||||
)
|
||||
if(NOT CMAKE_BUILD_TYPE STREQUAL "Debug")
|
||||
add_compile_options(-Og)
|
||||
endif()
|
||||
|
||||
add_compile_options(
|
||||
-Wall
|
||||
-Wno-address
|
||||
-Wno-misleading-indentation
|
||||
-Wno-missing-braces
|
||||
-Wno-multichar
|
||||
-Wno-tautological-compare
|
||||
-Wno-unused-but-set-variable
|
||||
-Wno-unused-value
|
||||
-Wno-unused-variable
|
||||
)
|
||||
add_compile_options($<$<COMPILE_LANGUAGE:C>:-Wno-pointer-sign>)
|
||||
add_compile_options($<$<COMPILE_LANGUAGE:CXX>:-Wno-unused-function>)
|
||||
|
||||
include_directories(
|
||||
"${CMAKE_SOURCE_DIR}"
|
||||
"${CMAKE_SOURCE_DIR}/include"
|
||||
"${CMAKE_SOURCE_DIR}/include/PR"
|
||||
"${CMAKE_SOURCE_DIR}/src"
|
||||
"${CMAKE_SOURCE_DIR}/src/game"
|
||||
"${CMAKE_SOURCE_DIR}/src/libultra"
|
||||
"${CMAKE_SOURCE_DIR}/src/libultra/audio"
|
||||
"${CMAKE_SOURCE_DIR}/port/include"
|
||||
"${CMAKE_BINARY_DIR}/port/include"
|
||||
)
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# Dependencies: SDL2, zlib, OpenGL
|
||||
# ----------------------------------------------------------------------------
|
||||
set(LIBS "")
|
||||
|
||||
find_package(SDL2 REQUIRED)
|
||||
include_directories(SYSTEM "${SDL2_INCLUDE_DIR}")
|
||||
list(APPEND LIBS "${SDL2_LIBRARY}")
|
||||
|
||||
find_package(ZLIB REQUIRED)
|
||||
if(ZLIB_INCLUDE_DIR)
|
||||
include_directories(SYSTEM "${ZLIB_INCLUDE_DIR}")
|
||||
endif()
|
||||
list(APPEND LIBS "${ZLIB_LIBRARY}")
|
||||
|
||||
if(NOT GL_LIBRARY)
|
||||
if(WIN32)
|
||||
set(GL_LIBRARY opengl32)
|
||||
elseif(APPLE)
|
||||
set(GL_LIBRARY "-framework OpenGL")
|
||||
else()
|
||||
set(GL_LIBRARY GL)
|
||||
endif()
|
||||
endif()
|
||||
list(APPEND LIBS "${GL_LIBRARY}")
|
||||
|
||||
if(NOT EXTRA_LIBRARIES)
|
||||
if(WIN32)
|
||||
set(EXTRA_LIBRARIES dbghelp -static-libstdc++)
|
||||
else()
|
||||
set(EXTRA_LIBRARIES stdc++ m dl pthread)
|
||||
endif()
|
||||
endif()
|
||||
list(APPEND LIBS "${EXTRA_LIBRARIES}")
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# Sources
|
||||
# ----------------------------------------------------------------------------
|
||||
# Port layer (shims + software RSP).
|
||||
file(GLOB_RECURSE SRC_PORT "${CMAKE_SOURCE_DIR}/port/src/*.c")
|
||||
file(GLOB_RECURSE SRC_PORT_CXX "${CMAKE_SOURCE_DIR}/port/src/*.cpp")
|
||||
file(GLOB_RECURSE SRC_FAST3D "${CMAKE_SOURCE_DIR}/port/fast3d/*.cpp")
|
||||
|
||||
# Game code — compiled unmodified.
|
||||
file(GLOB_RECURSE SRC_GAME "${CMAKE_SOURCE_DIR}/src/game/*.c")
|
||||
|
||||
# libaudio (AL) — runs on the CPU, platform independent.
|
||||
file(GLOB SRC_LIBAUDIO "${CMAKE_SOURCE_DIR}/src/libultra/audio/*.c")
|
||||
# Rare's audio "New" driver (drvrNew/env/reverb) — synthesizer.c calls
|
||||
# alSaveNew/alAuxBusNew/alMainBusNew/alLoadNew/alResampleNew/alEnvmixerNew/
|
||||
# alEnvmixerParam/alFxParam, all defined here. Runs on the CPU; must be linked.
|
||||
file(GLOB SRC_LIBULTRARE_AUDIO "${CMAKE_SOURCE_DIR}/src/libultrare/audio/*.c")
|
||||
# gu matrix helpers.
|
||||
file(GLOB SRC_GU "${CMAKE_SOURCE_DIR}/src/libultra/gu/*.c")
|
||||
|
||||
# VI mode table (DATA, not a driver): fr.c references osViModeTable ~15x.
|
||||
# This is the only libultra/io file we compile — the rest are hardware
|
||||
# drivers that get shimmed in port/src/libultra.c.
|
||||
set(SRC_LIBULTRARE_DATA
|
||||
src/libultrare/io/vitbl.c
|
||||
)
|
||||
list(PREPEND SRC_LIBULTRARE_DATA "${CMAKE_SOURCE_DIR}")
|
||||
|
||||
# Engine files in src/ that are platform independent.
|
||||
# NOTE: this list is a starting point and must be curated during Phase 1.
|
||||
#
|
||||
# INCLUDED here (platform-independent or CPU-side):
|
||||
# init.c — provides mainproc() (the game's real main entry) + the thread
|
||||
# setup helpers. Its N64-only init() is compiled but NOT called;
|
||||
# the N64 symbols init() references are stubbed in
|
||||
# port/src/n64stubs.c (see A3 in docs/PCPortResearch.md).
|
||||
# cfb.c — defines cfb_16 (the framebuffer), referenced by fr.c and game
|
||||
# code (bondview2.c, front.c). Pure data.
|
||||
# stacks.c — thread-stack arrays (sp_boot/sp_rmon/sp_idle/sp_shed/sp_main/
|
||||
# sp_audi + sp_debug under LEFTOVERDEBUG). Pure data; referenced
|
||||
# by init.c (thread setup) and audi.c (sp_audi). The SP_*_SZ
|
||||
# sizes in bondconstants.h match these exactly, so sizeof() is
|
||||
# correct. No duplicate-definition risk (all other refs are
|
||||
# extern decls in bondgame.h / audi.c).
|
||||
#
|
||||
# EXCLUDED (hardware drivers, replaced by port/ shims):
|
||||
# sched.c crash.c rmon.c usb.c tlb_*.c pi.c vi.c motor.c
|
||||
# (there is no src/spectrum.c in this decomp)
|
||||
# All of src/libultra/io/*.c and src/libultrare/io/*.c EXCEPT vitbl.c.
|
||||
# motor.c / pfsinit.c / pfsisplug.c are NOT compiled: joy.c calls
|
||||
# osMotorInit/Start/Stop and osPfsInit/osPfsIsPlug only for accessory
|
||||
# (Rumble Pak / Memory Pak) detection, so they are shimmed as no-ops in
|
||||
# port/src/libultra.c (see B2 — saves are EEPROM, not PFS).
|
||||
set(SRC_ENGINE
|
||||
src/init.c
|
||||
src/audi.c
|
||||
src/snd.c
|
||||
src/music.c
|
||||
src/joy.c
|
||||
src/fr.c
|
||||
src/cfb.c
|
||||
src/stacks.c
|
||||
src/boss.c
|
||||
src/mema.c
|
||||
src/memp.c
|
||||
src/deb.c
|
||||
src/debugmenu.c
|
||||
src/speed_graph.c
|
||||
src/token.c
|
||||
src/str.c
|
||||
src/sprintf.c
|
||||
src/ramrom.c
|
||||
)
|
||||
list(PREPEND SRC_ENGINE "${CMAKE_SOURCE_DIR}")
|
||||
|
||||
set(SRC
|
||||
${SRC_GAME}
|
||||
${SRC_PORT}
|
||||
${SRC_PORT_CXX}
|
||||
${SRC_FAST3D}
|
||||
${SRC_LIBAUDIO}
|
||||
${SRC_LIBULTRARE_AUDIO}
|
||||
${SRC_LIBULTRARE_DATA}
|
||||
${SRC_GU}
|
||||
${SRC_ENGINE}
|
||||
)
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# Target
|
||||
# ----------------------------------------------------------------------------
|
||||
set(BIN_NAME "ge007${BIN_REGION}.${TARGET_ARCH}")
|
||||
add_executable(ge007 ${SRC})
|
||||
target_link_libraries(ge007 ${LIBS})
|
||||
set_target_properties(ge007 PROPERTIES OUTPUT_NAME "${BIN_NAME}")
|
||||
if(WIN32)
|
||||
set_target_properties(ge007 PROPERTIES WIN32_EXECUTABLE TRUE)
|
||||
endif()
|
||||
|
||||
message(STATUS "Output binary: ${BIN_NAME}")
|
||||
Reference in new issue
Block a user