Add support for Anbernic H700-based devices

.github/workflows/ci.yaml

@@ -42,6 +42,7 @@ jobs:
         toolchain:
           - tg5040
           - tg5050
+          - h700
 
     steps:
       - name: Checkout
@@ -64,6 +65,7 @@ jobs:
         toolchain:
           - tg5040
           - tg5050
+          - h700
         core: ${{ fromJson(needs.core-matrix.outputs.cores) }}
     steps:
       - name: Checkout
@@ -124,6 +126,39 @@ jobs:
         env:
           PLATFORM: tg5050
 
+      - name: Download Cores (h700)
+        uses: actions/download-artifact@v4.3.0
+        with:
+          path: workspace/h700/cores/output/
+          pattern: core-h700-*
+          merge-multiple: true
+
+      - name: Build (h700)
+        run: make h700
+        env:
+          PLATFORM: h700
+
+      - name: Check H700 settings runtime links
+        run: |
+          docker run --rm --platform linux/arm64 -v "$PWD:/work" -w /work ubuntu:22.04 sh -ec '
+            apt-get update
+            apt-get install -y --no-install-recommends \
+              libegl1 \
+              libfreetype6 \
+              libgcc-s1 \
+              libglib2.0-0 \
+              libgles2 \
+              libjpeg-turbo8 \
+              liblzma5 \
+              libpng16-16 \
+              libstdc++6 \
+              libtiff5 \
+              libwebp7 \
+              libzstd1 \
+              zlib1g
+            sh ./workspace/h700/check-settings-ldd.sh
+          '
+
       - name: Special
         run: make special
 

.github/workflows/release.yaml

@@ -61,6 +61,7 @@ jobs:
         toolchain:
           - tg5040
           - tg5050
+          - h700
 
     steps:
       - name: Checkout
@@ -83,6 +84,7 @@ jobs:
         toolchain:
           - tg5040
           - tg5050
+          - h700
         core: ${{ fromJson(needs.core-matrix.outputs.cores) }}
     steps:
       - name: Checkout
@@ -143,6 +145,39 @@ jobs:
         env:
           PLATFORM: tg5050
 
+      - name: Download Cores (h700)
+        uses: actions/download-artifact@v4.3.0
+        with:
+          path: workspace/h700/cores/output/
+          pattern: core-h700-*
+          merge-multiple: true
+
+      - name: Build (h700)
+        run: make h700
+        env:
+          PLATFORM: h700
+
+      - name: Check H700 settings runtime links
+        run: |
+          docker run --rm --platform linux/arm64 -v "$PWD:/work" -w /work ubuntu:22.04 sh -ec '
+            apt-get update
+            apt-get install -y --no-install-recommends \
+              libegl1 \
+              libfreetype6 \
+              libgcc-s1 \
+              libglib2.0-0 \
+              libgles2 \
+              libjpeg-turbo8 \
+              liblzma5 \
+              libpng16-16 \
+              libstdc++6 \
+              libtiff5 \
+              libwebp7 \
+              libzstd1 \
+              zlib1g
+            sh ./workspace/h700/check-settings-ldd.sh
+          '
+
       - name: Special
         run: make special
 
@@ -225,4 +260,3 @@ jobs:
             ## How to install/update
             For a fresh installation, follow the instructions here: https://nextui.loveretro.games/getting-started/installation/
             When updating from a previous release: https://nextui.loveretro.games/getting-started/updating/
-

PAKS.md

@@ -6,7 +6,7 @@ There are two kinds of paks, emulators and tools. Emulator paks live in the Emus
 
 Paks are platform specific. Inside the Emus and Tools folders you will find (or need to create) platform folders. Some platform folders are named after the target device (eg. "rgb30" for the Powkiddy RGB30), others use the device's internal name (eg. "tg5040" for the Trimui Smart Pro), other use an arbitrary shortname (eg. "trimui" for the Trimui Model S), all are completely lowercase. See the extras bundle for up-to-date supported platform folder names.
 
-Some platforms have multiple devices with unique qualities. NextUI differentiates these devices from the base platform with the `DEVICE` envar. eg. the "rg35xxplus" platform has two unique devices "cube" for the RG CubeXX, and "wide" for the RG34xx. It also supports "hdmi" for when outputting to HDMI. A pak can choose to use or ignore this envar.
+Some platforms have multiple devices with unique qualities. NextUI differentiates these with the `DEVICE` envar. On tg5040 that is `brick`, `brickpro`, or `smartpro`. On h700 it is an exact SKU id such as `rg40xxv`, `rg34xxsp`, or `rgcubexx` (full list in the H700 Pak porting wiki page). A pak can choose to use or ignore this envar.
 
 # The types of emulator pak
 

makefile

@@ -12,7 +12,7 @@ endif
 
 ifeq (,$(PLATFORMS))
 #PLATFORMS = miyoomini trimuismart rg35xx rg35xxplus my355 tg5040 zero28 rgb30 m17 gkdpixel my282 magicmini
-PLATFORMS = tg5050 tg5040
+PLATFORMS = tg5050 tg5040 h700
 endif
 
 ###########################################################
@@ -103,15 +103,22 @@ endif
 	cp ./workspace/all/clock/build/$(PLATFORM)/clock.elf ./build/EXTRAS/Tools/$(PLATFORM)/Clock.pak/
 	cp ./workspace/all/minput/build/$(PLATFORM)/minput.elf ./build/EXTRAS/Tools/$(PLATFORM)/Input.pak/
 	cp ./workspace/all/settings/build/$(PLATFORM)/settings.elf ./build/EXTRAS/Tools/$(PLATFORM)/Settings.pak/
-ifneq (,$(filter $(PLATFORM),tg5040 tg5050))
+ifneq (,$(filter $(PLATFORM),tg5040 tg5050 h700))
 	cp ./workspace/all/ledcontrol/build/$(PLATFORM)/ledcontrol.elf ./build/EXTRAS/Tools/$(PLATFORM)/LedControl.pak/
-	cp ./workspace/all/bootlogo/build/$(PLATFORM)/bootlogo.elf ./build/EXTRAS/Tools/$(PLATFORM)/Bootlogo.pak/
 ifeq ($(PLATFORM), tg5040)
 	# Limbo fix
 	cp ./workspace/$(PLATFORM)/poweroff_next/build/$(PLATFORM)/poweroff_next.elf ./build/SYSTEM/$(PLATFORM)/bin/poweroff_next
 endif
 endif
-ifneq (,$(filter $(PLATFORM),tg5040 tg5050 my355))
+ifeq ($(PLATFORM), h700)
+	# Limbo fix (AXP2202 needs an explicit software power-off)
+	cp ./workspace/$(PLATFORM)/poweroff_next/build/$(PLATFORM)/poweroff_next.elf ./build/SYSTEM/$(PLATFORM)/bin/poweroff_next
+	cp ./workspace/$(PLATFORM)/poweroff_next/build/$(PLATFORM)/reboot_next.elf ./build/SYSTEM/$(PLATFORM)/bin/reboot_next
+endif
+ifneq (,$(filter $(PLATFORM),tg5040 tg5050 h700))
+	cp ./workspace/all/bootlogo/build/$(PLATFORM)/bootlogo.elf ./build/EXTRAS/Tools/$(PLATFORM)/Bootlogo.pak/
+endif
+ifneq (,$(filter $(PLATFORM),tg5040 tg5050 h700 my355))
 	# Audio resampling
 	cp ./workspace/all/minarch/build/$(PLATFORM)/libsamplerate.* ./build/SYSTEM/$(PLATFORM)/lib/
 
@@ -125,7 +132,7 @@ ifneq (,$(filter $(PLATFORM),tg5040 tg5050 my355))
 	cp ./workspace/all/minarch/build/$(PLATFORM)/libchdr.so.* ./build/SYSTEM/$(PLATFORM)/lib/
 	cp ./workspace/all/minarch/build/$(PLATFORM)/libcrypto.so.* ./build/SYSTEM/$(PLATFORM)/lib/
 
-ifeq ($(PLATFORM), tg5040)
+ifneq (,$(filter $(PLATFORM),tg5040 h700))
 	# liblz4 for Rewind support
 	cp -L ./workspace/all/minarch/build/$(PLATFORM)/liblz4.so.1 ./build/SYSTEM/$(PLATFORM)/lib/
 endif
@@ -265,7 +272,7 @@ package: tidy
 
 	# TODO: can I just add everything in BASE to zip?
 	# cd ./build/BASE && zip -r ../../releases/$(RELEASE_NAME)-base.zip Bios Roms Saves miyoo miyoo354 trimui rg35xx rg35xxplus gkdpixel miyoo355 magicx em_ui.sh MinUI.zip README.txt
-	cd ./build/BASE && zip -r ../../releases/$(RELEASE_NAME)-base.zip Bios Roms Saves Shaders Overlays trimui em_ui.sh MinUI.zip *.pakz README.txt
+	cd ./build/BASE && zip -r ../../releases/$(RELEASE_NAME)-base.zip Bios Roms Saves Shaders Overlays trimui h700 em_ui.sh MinUI.zip *.pakz README.txt
 	cd ./build/EXTRAS && zip -r ../../releases/$(RELEASE_NAME)-extras.zip Bios Emus Roms Saves Shaders Overlays Tools README.txt
 	echo "$(RELEASE_VERSION)" > ./build/latest.txt
 

makefile.toolchain

@@ -9,9 +9,11 @@ endif
 HOST_WORKSPACE=$(shell pwd)/workspace
 GUEST_WORKSPACE=/root/workspace
 
-GIT_IF_NECESSARY=toolchains/$(PLATFORM)-toolchain
-INIT_IF_NECESSARY=toolchains/$(PLATFORM)-toolchain/.build
-IMAGE_NAME=ghcr.io/loveretro/$(PLATFORM)-toolchain:latest
+TOOLCHAIN_NAME=$(PLATFORM)
+
+GIT_IF_NECESSARY=toolchains/$(TOOLCHAIN_NAME)-toolchain
+INIT_IF_NECESSARY=toolchains/$(TOOLCHAIN_NAME)-toolchain/.build
+IMAGE_NAME=ghcr.io/loveretro/$(TOOLCHAIN_NAME)-toolchain:latest
 
 CONTAINER_RUNTIME ?= $(shell command -v docker 2>/dev/null || command -v podman 2>/dev/null)
 ifeq (,$(CONTAINER_RUNTIME))
@@ -28,18 +30,18 @@ LAST_RUNTIME := $(shell cat $(RUNTIME_MARKER) 2>/dev/null)
 CURRENT_RUNTIME := $(notdir $(CONTAINER_RUNTIME))
 
 all: $(INIT_IF_NECESSARY)
-	$(CONTAINER_RUNTIME) run -it --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) $(IMAGE_NAME) /bin/bash
+	$(CONTAINER_RUNTIME) run -it --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e PLATFORM=$(PLATFORM) -e UNION_PLATFORM=$(PLATFORM) $(IMAGE_NAME) /bin/bash -lc 'export PLATFORM=$(PLATFORM) UNION_PLATFORM=$(PLATFORM); cd $(GUEST_WORKSPACE); exec /bin/bash'
 
 $(INIT_IF_NECESSARY): $(GIT_IF_NECESSARY)
-	cd toolchains/$(PLATFORM)-toolchain && make .build
+	cd toolchains/$(TOOLCHAIN_NAME)-toolchain && make .build
 
 $(GIT_IF_NECESSARY):
 	mkdir -p toolchains
-	git clone https://github.com/LoveRetro/$(PLATFORM)-toolchain/ toolchains/$(PLATFORM)-toolchain
-	$(CONTAINER_RUNTIME) pull $(IMAGE_NAME) && touch toolchains/$(PLATFORM)-toolchain/.build
+	git clone https://github.com/LoveRetro/$(TOOLCHAIN_NAME)-toolchain/ toolchains/$(TOOLCHAIN_NAME)-toolchain
+	$(CONTAINER_RUNTIME) pull $(IMAGE_NAME) && touch toolchains/$(TOOLCHAIN_NAME)-toolchain/.build
 
 clean:
-	cd toolchains/$(PLATFORM)-toolchain && make clean
+	cd toolchains/$(TOOLCHAIN_NAME)-toolchain && make clean
 
 _runtime_check:
 	@if [ -n "$(LAST_RUNTIME)" ] && [ "$(LAST_RUNTIME)" != "$(CURRENT_RUNTIME)" ]; then \
@@ -55,17 +57,24 @@ _runtime_check:
 		fi; \
 	fi
 
+# The platform reaches the guest build through the environment only, never as a
+# `make PLATFORM=...` argument. A command-line variable lands in MAKEOVERRIDES and
+# overrides same-named assignments in *every* recursive make, including each core's
+# own `PLATFORM = libretro` (picodrive, pcsx_rearmed) — those then build without
+# their libretro frontend and link to an entry-point-less stub. Environment values
+# lose to a makefile assignment, which is what workspace/makefile expects.
+
 build: $(INIT_IF_NECESSARY) _runtime_check
-	$(CONTAINER_RUNTIME) run --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make'
+	$(CONTAINER_RUNTIME) run --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) -e PLATFORM=$(PLATFORM) -e UNION_PLATFORM=$(PLATFORM) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && export PLATFORM=$(PLATFORM) UNION_PLATFORM=$(PLATFORM) && cd /root/workspace && make'
 	@echo "$(CURRENT_RUNTIME)" > $(RUNTIME_MARKER)
 
 build-cores: $(INIT_IF_NECESSARY) _runtime_check
-	$(CONTAINER_RUNTIME) run --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make cores'
+	$(CONTAINER_RUNTIME) run --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) -e PLATFORM=$(PLATFORM) -e UNION_PLATFORM=$(PLATFORM) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && export PLATFORM=$(PLATFORM) UNION_PLATFORM=$(PLATFORM) && cd /root/workspace && make cores'
 	@echo "$(CURRENT_RUNTIME)" > $(RUNTIME_MARKER)
 
 build-core: $(INIT_IF_NECESSARY) _runtime_check
 ifndef CORE
 	$(error CORE is not set)
 endif
-	$(CONTAINER_RUNTIME) run --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) -e CORE=$(CORE) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make core'
+	$(CONTAINER_RUNTIME) run --rm $(CONTAINER_MOUNT_OPTS) -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) -e CORE=$(CORE) -e PLATFORM=$(PLATFORM) -e UNION_PLATFORM=$(PLATFORM) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && export PLATFORM=$(PLATFORM) UNION_PLATFORM=$(PLATFORM) && cd /root/workspace && make core'
 	@echo "$(CURRENT_RUNTIME)" > $(RUNTIME_MARKER)

skeleton/BASE/README.txt

@@ -36,6 +36,14 @@ TRIMUI SMART PRO / TRIMUI BRICK
 
 Copy the "trimui" folder and "MinUI.zip" (without unzipping) to the root of the SD card.
 
+ANBERNIC RG XX (H700) DEVICES
+
+Copy "MinUI.zip" (without unzipping) to the root of the SD card.
+
+Copy the "dmenu.bin" file (found inside the "h700" folder) to the root of your stock OS card's ROMS partition. You can delete it later to uninstall and return to stock.
+
+IMPORTANT: In the stock OS, set the user interface theme to "old style" (default) — not "MU style 1" or "MU style 2", otherwise NextUI will not start.
+
 MIYOO FLIP
 
 Copy the "miyoo355" folder and "MinUI.zip" (without unzipping) to the root of the SD card. Put the SD card into the right slot (beneath the power button).
@@ -60,6 +68,11 @@ TRIMUI BRICK / BRICK PRO / SMART PRO S
 
   Buttons with no action of their own can be assigned a pak to launch: L3/R3 on the Brick, L4/R4 on the Brick Pro, and HOME on the Brick Pro and Smart Pro S. Assign them under Settings > Assignments. Assignments only apply in the main menu, not in-game. HOME no longer acts as a second menu button.
 
+ANBERNIC RG XX
+
+  Menu button: Quick menu
+  Select button: Game switcher
+
 ----------------------------------------
 Quicksave & auto-resume
 
@@ -153,7 +166,7 @@ Not simple enough for you (or maybe your kids)? NextUI has a simple mode that hi
 ----------------------------------------
 Advanced
 
-NextUI can automatically run a user-authored shell script on boot. Just place a file named "auto.sh" in "/.userdata/<DEVICE>/". If you're on Windows, make sure your text editor uses Unix line-endings (eg. `\n`), these devices usually choke on Windows line-endings (eg. `\r\n`).
+NextUI can automatically run a user-authored shell script on boot. Just place a file named "auto.sh" in "/.userdata/<PLATFORM>/" (eg. `/.userdata/h700/` or `/.userdata/tg5040/`). If you're on Windows, make sure your text editor uses Unix line-endings (eg. `\n`), these devices usually choke on Windows line-endings (eg. `\r\n`).
 
 ----------------------------------------
 Thanks

skeleton/BOOT/common/updater

@@ -3,6 +3,10 @@
 # NOTE: becomes .tmp_update/updater
 
 INFO=`cat /proc/cpuinfo 2> /dev/null`
+MODEL=`cat /proc/device-tree/model 2> /dev/null`
+if echo "$MODEL" | grep -q "sun50iw9"; then
+	PLATFORM="h700" # Anbernic RG XX, Allwinner H700
+fi
 case $INFO in
 *"sun8i"*)
 	if [ -d /usr/miyoo ]; then
@@ -21,7 +25,9 @@ case $INFO in
 	PLATFORM="tg5050" # Trimui Smart Pro S
 	;;
 *"0xd03"*)
-	PLATFORM="zero28" # MagicX Mini Zero 28
+	if [ -z "$PLATFORM" ]; then
+		PLATFORM="zero28" # MagicX Mini Zero 28
+	fi
 	;;
 *"0xd05"*)
 	PLATFORM="my355" # Miyoo Flip

skeleton/EXTRAS/Emus/h700/32X.pak/default.cfg

@@ -0,0 +1,19 @@
+-picodrive_drc = enabled
+-picodrive_sound_rate = 44100
+-picodrive_smstype = Auto
+-picodrive_smsfm = off
+-picodrive_smsmapper = Auto
+-picodrive_ggghost = off
+
+bind Up = UP
+bind Down = DOWN
+bind Left = LEFT
+bind Right = RIGHT
+bind Mode = SELECT
+bind Start = START
+bind A Button = Y
+bind B Button = X:B
+bind C Button = A
+bind X Button = B:L1
+bind Y Button = L1:X
+bind Z Button = R1

skeleton/EXTRAS/Emus/h700/32X.pak/launch.sh

@@ -0,0 +1,14 @@
+#!/bin/sh
+
+EMU_EXE=picodrive
+
+###############################
+
+EMU_TAG=$(basename "$(dirname "$0")" .pak)
+ROM="$1"
+mkdir -p "$BIOS_PATH/$EMU_TAG"
+mkdir -p "$SAVES_PATH/$EMU_TAG"
+mkdir -p "$CHEATS_PATH/$EMU_TAG"
+HOME="$USERDATA_PATH"
+cd "$HOME"
+minarch.elf "$CORES_PATH/${EMU_EXE}_libretro.so" "$ROM" > "$LOGS_PATH/$EMU_TAG.txt" 2>&1

skeleton/EXTRAS/Emus/h700/A2600.pak/default.cfg

@@ -0,0 +1,14 @@
+bind Up = UP
+bind Down = DOWN
+bind Left = LEFT
+bind Right = RIGHT
+bind Select = SELECT
+bind Start = START
+bind X Button = X
+bind Y Button = Y
+bind B Button = B
+bind A Button = A
+bind L1 Button = L1
+bind L2 Button = L2
+bind R1 Button = R1
+bind R2 Button = R2

skeleton/EXTRAS/Emus/h700/A2600.pak/launch.sh

@@ -0,0 +1,15 @@
+#!/bin/sh
+
+EMU_EXE=stella2014
+CORES_PATH=$(dirname "$0")
+
+###############################
+
+EMU_TAG=$(basename "$(dirname "$0")" .pak)
+ROM="$1"
+mkdir -p "$BIOS_PATH/$EMU_TAG"
+mkdir -p "$SAVES_PATH/$EMU_TAG"
+mkdir -p "$CHEATS_PATH/$EMU_TAG"
+HOME="$USERDATA_PATH"
+cd "$HOME"
+minarch.elf "$CORES_PATH/${EMU_EXE}_libretro.so" "$ROM" > "$LOGS_PATH/$EMU_TAG.txt" 2>&1

skeleton/EXTRAS/Emus/h700/A5200.pak/default.cfg

@@ -0,0 +1,14 @@
+bind Up = UP
+bind Down = DOWN
+bind Left = LEFT
+bind Right = RIGHT
+bind Select = SELECT
+bind Start = START
+bind X Button = X
+bind Y Button = Y
+bind B Button = B
+bind A Button = A
+bind L1 Button = L1
+bind L2 Button = L2
+bind R1 Button = R1
+bind R2 Button = R2