Skip to content

Stovent/CeDImu

Repository files navigation

CeDImu

CeDImu concept by jongg-eater

Experimental Philips CD-I emulator (I use a capital I instead of a lower case i because the Green Book capitalizes it)

Note: the project is still in a very early development stage, please open issues only to address problems in the existing code.

How to use

See the user manual.

Compatibility

DVC support will be added when CeDImu will have a good compatibility with the base case system on several boards.

BIOSes

Below are listed the known BIOSes that works in CeDImu along with their board settings. For more information, see the ICDIA website.

  • CDI 210/40 (Mono-3, 8 KB NVRAM)
  • CDI 220/60 (Mono-3, 32 KB NVRAM)
  • CDI 220/80 (Mono-4, 32 KB NVRAM)
  • CDI 470/00 (Mono-4, 8 KB NVRAM)
  • CDI 470/20 (Mono-4, 8 KB NVRAM)
  • CDI 490/00 (Mono-4, 32 KB NVRAM)

Some BIOSes (e.g. CDI 220/80) may not show graphics on their first boot. To boot them, let them run for around a thousand frames on the first boot so they initializes their NVRAM, then reload the emulator.

Boards

Compatible means it is capable of playing discs.

  • Mini-MMC

    ​ Not working. SCC66470 and Timekeeper mapped.

  • Mono-3, Mono-4

    BIOS boots to player shell. MCD212, Timekeeper (8KB and 32KB) and HLE IKAT mapped.

Chips

  • SCC68070
  • VDSCs
    • SCC66470 (Mini-MMC)
    • MCD212 (Mono-1, 2, 3, 4)
  • CD and Audio
    • CDIC (Mini-MMC, Mono-1)
    • DSP (Mono-2)
    • MCD221 CIAP (Mono-3, 4)
  • Slave MCUs
    • Slave (Mini-MMC, Mono-1, 2)
    • IKAT (Mono-3, 4)
  • Timekeepers
    • M48T08
    • DS1216

Features

  • CDI-related functions

    • CDI file system
    • Export files
    • Export audio
    • Export video
    • Export raw video
  • Tools

    • CPU Viewer
    • VDSC Viewer
    • Debug (memory access logs and exception and system call tracing)
    • RAM Search
    • Memory Viewer
    • Savestates

How to build

You need a compiler that supports C++20 and wxWidgets 3.1.

Build macros

ENABLE_LOG: if defined, allows the library to print some messages in the console and the use of OnLogMemoryAccess callback (default: OFF).

The official build of CeDImu always enables it.

CMake

CMake options

CEDIMU_BUILD_CDITOOL: If ON, builds the little cditool program (Linux only, requires libcdio) (default: OFF).

CEDIMU_ENABLE_LTO: If ON, compiles the executable with link-time optimisations (default: ON).

Windows

First install CMake and vcpkg, and use vcpkg to install wxWidgets: vcpkg.exe install wxwidgets:x64-windows-static

Then build CeDImu (make sure to change the DCMAKE_TOOLCHAIN_FILE to the path your vcpkg install):

cmake -B build -S . "-DCMAKE_TOOLCHAIN_FILE=C:/Dev/vcpkg/scripts/buildsystems/vcpkg.cmake" "-DVCPKG_TARGET_TRIPLET=x64-windows-static" -DCMAKE_BUILD_TYPE=Release -DCMAKE_CONFIGURATION_TYPES=Release -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded
cmake --build .\build\ --config Release

For a Debug build, execute these commands instead:

cmake -B build -S . "-DCMAKE_TOOLCHAIN_FILE=C:/Dev/vcpkg/scripts/buildsystems/vcpkg.cmake" "-DVCPKG_TARGET_TRIPLET=x64-windows-static" -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CONFIGURATION_TYPES=Debug -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDebug
cmake --build .\build\ --config Debug

The executable will be in the build directory.

Linux

First install cmake and wxWidgets-3.1 (or later).

With apt the command is: sudo apt install cmake libwxgtk3.2-dev

Install the dependency, then open a terminal in the root directory of the git and type:

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc --all)

The executable will be in the build directory.

macOS

Package dependency: wxwidgets and cmake (e.g. if using brew run: brew install wxwidgets cmake). Also make sure to have Xcode or just it's Command Line Tools installed.

For keyboard input to work properly, enable 'Keyboard Navigation' in macOS. See this support article.

Open a terminal in the root directory of the git and type:

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(sysctl -n hw.physicalcpu)

libCeDImu

If I get everything listed upper working, stable and fully functional, the goal is to create libCeDImu, a complete library (static and/or dynamic) to allow any program to implement CDI applications (other emulators like Bizhawk, MAME, etc).

Special Thanks

  • CD-i Fan for his help and his information that made me progress way faster than I could imagine.
  • jongg-eater for the logo.