From ab27194c2ccabb6915c95a5a8afd1337d8174961 Mon Sep 17 00:00:00 2001 From: Aloys Date: Sun, 2 Aug 2026 16:39:30 +0800 Subject: [PATCH 1/2] Add DingooEmu core documentation Add documentation for the DingooEmu libretro core, following the adding a new core instructions. DingooEmu emulates the Dingoo A320 handheld game console powered by the Ingenic JZ4740 MIPS SoC. The core supports .app game files from the Dingoo ecosystem. The core is written in Rust and licensed BSD-3-Clause. - Core source: https://github.com/jiangxincode/DingooEmu - Core info file PR (libretro-super): https://github.com/libretro/libretro-super/pull/2042 Changes: - Added docs/library/dingooemu.md - Updated mkdocs.yml with Dingoo Emulation entry - Updated docs/guides/core-list.md with DingooEmu row - Updated docs/development/licenses.md with BSD-3-Clause entry --- docs/development/licenses.md | 2 + docs/guides/core-list.md | 1 + docs/library/dingooemu.md | 116 +++++++++++++++++++++++++++++++++++ mkdocs.yml | 2 + 4 files changed, 121 insertions(+) create mode 100644 docs/library/dingooemu.md diff --git a/docs/development/licenses.md b/docs/development/licenses.md index 6cfee0521c..6965a2f357 100644 --- a/docs/development/licenses.md +++ b/docs/development/licenses.md @@ -18,6 +18,7 @@ See below for a summary of the licenses behind RetroArch and its cores: | [Opera](../library/opera.md) | [Non-commercial](https://github.com/libretro/opera-libretro/blob/master/libopera/opera_core.h) | Non-commercial | | [AmiArcadia](../library/amiarcadia.md) | [Non-commercial](https://amigan.1emu.net/releases/) | Non-commercial | | [Cannonball](../library/cannonball.md) | [Non-commercial](https://github.com/libretro/cannonball/blob/master/docs/license.txt) | Non-commercial | +| [DingooEmu](../library/dingooemu.md) | [BSD-3-Clause](https://github.com/jiangxincode/DingooEmu/blob/master/LICENSE) | | | [Dinothawr](../library/dinothawr.md) | [Non-commercial](https://github.com/libretro/Dinothawr/blob/master/LICENSE) | Non-commercial | | FB Alpha | [Non-commercial](https://github.com/libretro/fbalpha/blob/master/src/license.txt) | Non-commercial | | FB Alpha 2012 | [Non-commercial](https://github.com/libretro/fbalpha2012/blob/master/docs/license.txt) | Non-commercial | @@ -95,6 +96,7 @@ See below for a summary of the licenses behind RetroArch and its cores: | [DeSmuME 2015](../library/desmume_2015.md) | [GPLv2](https://github.com/libretro/desmume2015/blob/master/desmume/COPYING) | | | [DeSmuME](../library/desmume.md) | [GPLv2](https://github.com/TASVideos/desmume/blob/master/license.txt) | | | [DICE](../library/dice.md) | [GPLv3](https://github.com/mittonk/dice-libretro/blob/master/LICENSE.txt) | | +| [DingooEmu](../library/dingooemu.md) | [BSD-3-Clause](https://github.com/jiangxincode/DingooEmu/blob/master/LICENSE) | | | [Dinothawr](../library/dinothawr.md) | [Non-commercial](https://github.com/libretro/Dinothawr/blob/master/LICENSE) | Non-commercial | | Dolphin | [GPLv2](https://github.com/dolphin-emu/dolphin/blob/master/license.txt) | | | DOSBox | [GPLv2](https://github.com/libretro/dosbox-libretro/blob/master/COPYING) | | diff --git a/docs/guides/core-list.md b/docs/guides/core-list.md index d14cf981c7..1a67486e6f 100644 --- a/docs/guides/core-list.md +++ b/docs/guides/core-list.md @@ -51,6 +51,7 @@ | [CrocoDS](../library/crocods.md) | Amstrad CPC | | | Cruzes | Game | (Further information required) | | Daphne | Arcade | | +| [DingooEmu](../library/dingooemu.md) | Dingoo A320 | An emulator for the Dingoo A320 handheld game console powered by the Ingenic JZ4740 MIPS SoC | | [DeSmuME](../library/desmume.md) | Nintendo DS | | | [DeSmuME 2015](../library/desmume_2015.md) | Nintendo DS | | | [DICE](../library/dice.md) | Arcade | Pre-CPU games like Pong | diff --git a/docs/library/dingooemu.md b/docs/library/dingooemu.md new file mode 100644 index 0000000000..b1b8d451df --- /dev/null +++ b/docs/library/dingooemu.md @@ -0,0 +1,116 @@ +# Dingoo A320 (DingooEmu) + +## Background + +The Dingoo A320 is a handheld game console developed by Dingoo Digital Technology, featuring an Ingenic JZ4740 MIPS SoC running at 336-400 MHz, 32 MB RAM, and a 2.8" 320×240 TFT LCD screen. The device became popular for its open-source community firmware (Dingux/OpenDingux) and homebrew ecosystem. DingooEmu is an emulator for this platform written in Rust, with a libretro core front-end. + +The DingooEmu core has been authored by: + +- Aloys + +The DingooEmu core is licensed under: + +- [BSD-3-Clause](https://github.com/jiangxincode/DingooEmu/blob/master/LICENSE) + +A summary of the licenses behind RetroArch and its cores can be found [here](../development/licenses.md). + +## BIOS + +No BIOS or firmware files are required. + +## Extensions + +Content that can be loaded by the DingooEmu core have the following file extensions: + +- .app + +RetroArch database(s) that are associated with the DingooEmu core: + +- Dingoo A320 + +## Features + +Frontend-level settings or features that the DingooEmu core respects: + +| Feature | Supported | +|-------------------|:---------:| +| Restart | ✔ | +| Saves | ✔ | +| States | ✔ | +| Rewind | ✕ | +| Netplay | ✕ | +| Core Options | ✔ | +| [Memory Monitoring (achievements)](../guides/memorymonitoring.md) | ✕ | +| RetroArch Cheats | ✔ | +| Native Cheats | ✕ | +| Controls | ✔ | +| Remapping | ✔ | +| Multi-Mouse | ✕ | +| Rumble | ✕ | +| Sensors | ✕ | +| Camera | ✕ | +| Location | ✕ | +| Subsystem | ✕ | +| [Softpatching](../guides/softpatching.md) | ✕ | +| Disk Control | ✕ | +| Username | ✕ | +| Language | ✕ | +| Crop Overscan | ✕ | +| LEDs | ✕ | + +## Directories + +The DingooEmu core's library name is 'Dingoo A320 (DingooEmu)' + +## Core options + +The DingooEmu core has the following core options: + +- **Audio Volume** (`dingooemu_volume`) - Set the audio volume level. Default: 100%. +- **Key Auto-Repeat Delay** (`dingooemu_repeat_delay`) - Set the delay before key auto-repeat starts (in frames). Default: 24. +- **Key Auto-Repeat Period** (`dingooemu_repeat_period`) - Set the interval between key auto-repeat events (in frames). Default: 6. +- **Swap A/B Buttons** (`dingooemu_swap_ab`) - Swap the A and B button mappings. Default: disabled. +- **CPU/HLE Debug Logging** (`dingooemu_debug_logging`) - Enable debug logging for CPU and HLE operations. Default: disabled. +- **Unknown MIPS Instruction Policy** (`dingooemu_unknown_instruction`) - Set the behavior when encountering unknown MIPS instructions. Default: skip. + +## Usage + +The DingooEmu core loads .app game files from the Dingoo A320 handheld ecosystem. Video is output in the XRGB8888 pixel format at 320×240 resolution, and audio is output as stereo at 22050 Hz. Save states, cheats, and core options are fully implemented. + +## User 1 device types + +The DingooEmu core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s): + +- **RetroPad** - Gamepad + +## Joypad + +| RetroPad Inputs | User 1 input descriptors | +|------------------------------------------------|--------------------------| +| ![](../image/retropad/retro_dpad_up.png) | D-Pad Up | +| ![](../image/retropad/retro_dpad_down.png) | D-Pad Down | +| ![](../image/retropad/retro_dpad_left.png) | D-Pad Left | +| ![](../image/retropad/retro_dpad_right.png) | D-Pad Right | +| ![](../image/retropad/retro_a.png) | A | +| ![](../image/retropad/retro_b.png) | B | +| ![](../image/retropad/retro_x.png) | X | +| ![](../image/retropad/retro_y.png) | Y | +| ![](../image/retropad/retro_start.png) | Start | +| ![](../image/retropad/retro_select.png) | Select | +| ![](../image/retropad/retro_l1.png) | L | +| ![](../image/retropad/retro_r1.png) | R | + +## Memory + +The DingooEmu core exposes the following memory regions: + +| Memory Region | Description | +|---------------|-------------| +| System RAM | 32 MB main system memory | +| Video RAM | Framebuffer memory (320×240 RGB565) | + +## External links + +- [DingooEmu Repository](https://github.com/jiangxincode/DingooEmu) +- [Libretro DingooEmu Core info file](https://github.com/libretro/libretro-super/blob/master/dist/info/dingooemu_libretro.info) +- [Report Libretro DingooEmu Core Issues Here](https://github.com/jiangxincode/DingooEmu/issues) diff --git a/mkdocs.yml b/mkdocs.yml index a28cc8c1ff..924daa09ef 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -279,6 +279,8 @@ nav: - 'Sony - PlayStation Portable (PPSSPP)': 'library/ppsspp.md' - 'SpectraVision Emulation': - 'MSX/SVI/ColecoVision/SG-1000 (blueMSX)': 'library/bluemsx.md' + - 'Dingoo Emulation': + - 'Dingoo - A320 (DingooEmu)': 'library/dingooemu.md' - 'Sunplus Emulation': - 'Sunplus - Native32 (Native32Emu)': 'library/native32emu.md' - 'Sunplus - SPMP8000 (SPMP8000Emu)': 'library/spmp8000emu.md' From d6aa4190e1a352c1401ef699aa006df8878c6c80 Mon Sep 17 00:00:00 2001 From: Aloys Date: Sun, 2 Aug 2026 16:43:22 +0800 Subject: [PATCH 2/2] Fix Dingoo Emulation entry order in mkdocs.yml Move Dingoo Emulation entry to correct alphabetical position: - After DOS Emulation - Before Emerson --- mkdocs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 924daa09ef..1df040f71e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -156,6 +156,8 @@ nav: - 'MS - DOS (DOSBox)': 'library/dosbox.md' - 'MS - DOS (DOSBox Pure)': 'library/dosbox_pure.md' - 'MS - DOS (VirtualXT)': 'library/virtualxt.md' + - 'Dingoo Emulation': + - 'Dingoo - A320 (DingooEmu)': 'library/dingooemu.md' - 'Emerson': - 'Emerson - Arcadia 2001 / Interton VC 4000 (AmiArcadia)': 'library/amiarcadia.md' - 'Enterprise Emulation': @@ -279,8 +281,6 @@ nav: - 'Sony - PlayStation Portable (PPSSPP)': 'library/ppsspp.md' - 'SpectraVision Emulation': - 'MSX/SVI/ColecoVision/SG-1000 (blueMSX)': 'library/bluemsx.md' - - 'Dingoo Emulation': - - 'Dingoo - A320 (DingooEmu)': 'library/dingooemu.md' - 'Sunplus Emulation': - 'Sunplus - Native32 (Native32Emu)': 'library/native32emu.md' - 'Sunplus - SPMP8000 (SPMP8000Emu)': 'library/spmp8000emu.md'