Skip to content

Add DingooEmu core documentation #1172

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fpscan merged 2 commits into from
Aug 4, 2026
+121 −0
Merged

Add DingooEmu core documentation #1172

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ab27194
Add DingooEmu core documentation
jiangxincode Aug 2, 2026
d6aa419
Fix Dingoo Emulation entry order in mkdocs.yml
jiangxincode Aug 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/development/licenses.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down Expand Up @@ -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) | |
Expand Down
1 change: 1 addition & 0 deletions docs/guides/core-list.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
116 changes: 116 additions & 0 deletions docs/library/dingooemu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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)
2 changes: 2 additions & 0 deletions mkdocs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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':
Expand Down
Loading