Armbian for MXQ-Pro 5g 4k H313

[sicxnull]

Hello Everyone, I've seen a few threads on these boards but wanted to create a centralized source for information. 

It's my understanding there are multiple variants of these boards, the one I have and used is IK316Q-EMCP_V4.1

 

 

 

I know there are other versions without UART ports, mine was lucky enough to have them. 

To build this image (adjust the compile command to your liking)
 

git clone https://github.com/sicXnull/armbian-build
cd armbian-build
git checkout MXQ-PRO
./compile.sh build BOARD=mxqpro-h313 BRANCH=current BUILD_DESKTOP=yes BUILD_MINIMAL=no DESKTOP_APPGROUPS_SELECTED= DESKTOP_ENVIRONMENT=cinnamon DESKTOP_ENVIRONMENT_CONFIG_NAME=config_base EXPERT=yes KERNEL_BTF=no KERNEL_CONFIGURE=no KERNEL_GIT=shallow RELEASE=bookworm

 

Prebuilt Images

Armbian-unofficial_26.02.0-trunk_Mxqpro_bookworm_current_6.12.65_cinnamon_desktop.img

Armbian-unofficial_26.02.0-trunk_Mxqpro_bookworm_current_6.12.65_minimal.img


Unfortunately this board was already flashed with MiniArch by the time i got it, so i was unable to get the original DTB. Therefore, wifi does not work

Is someone able to get the DTB from this board so we can get wifi working?

[gabriel_altoe]

Hi, I could try to help, my board is exactly the same as yours. Can you provide me a source with instructions of how to do that?

[marcosdsdba]

@gabriel_altoe  Try this: https://brandolamarck.substack.com/p/como-extrair-e-decompilar-a-device. I'll take some time to try and follow the tips. I'll post any updates here.

[sicxnull]

Update on this box. 

Got wifi working fine. Everything works well with SD Boot. Installing to EMMC brings me to this error

 

U-Boot SPL 2024.01_armbian-2024.01-S866c-Pa67d-H5afb-Vc88c-B2eb2-R448a (Feb 15 2026 - 18:20:18 -0500)
DRAM base address is defined as 0x40000000
DRAM has 14 b/raw, 10 b/col, 4 B/width, 2 #rank and 8 #bank
DRAM top address must be less than 0x40000000
DRAM: 1024 MiB
Trying to boot from MMC2
MMC Device 1 not found
spl: could not find mmc device 1. error: -19
SPL: failed to boot from all boot devices
### ERROR ### Please RESET the board ###

Chasing down what could be causing this. 

[Kevin su]

@sicxnull

I ran into the same issue when flashing
"Armbian-unofficial_26.02.0-trunk_Mxqpro_bookworm_current_6.12.65_minimal" (worked only in SD Card).

The issue was gone when I switched to
"Armbian-unofficial_25.05.0-trunk_X96q-lpddr3-v1-3_bookworm_edge_6.12.11_server"
built by @Nick A
 

[sicxnull]

On 2/16/2026 at 8:53 PM, Kevin su said:

I ran into the same issue when flashing
"Armbian-unofficial_26.02.0-trunk_Mxqpro_bookworm_current_6.12.65_minimal" (worked only in SD Card).

The issue was gone when I switched to
"Armbian-unofficial_25.05.0-trunk_X96q-lpddr3-v1-3_bookworm_edge_6.12.11_server"
built by @Nick A

Hey @Nick A any idea which patch you're applying that fixes the EMMC boot?
 

[Nick A]

@sicxnull I would need to look at your sources. Not sure if it's a dts or u-boot patch fix.

[sicxnull]

1 hour ago, Nick A said:

@sicxnull I would need to look at your sources. Not sure if it's a dts or u-boot patch fix.

https://github.com/sicXnull/armbian-build/commit/347ffdb2e4ceb301140270fb106c2d0807151122

[Nick A]

@sicxnull This might be the patch that fixed it. It's in mainline u-boot now. I would use a newer u-boot.

https://lists.denx.de/pipermail/u-boot/2025-March/582900.html

[sicxnull]

22 hours ago, Nick A said:

@sicxnull This might be the patch that fixed it. It's in mainline u-boot now. I would use a newer u-boot.

https://lists.denx.de/pipermail/u-boot/2025-March/582900.html

i took a look through your repo and used 2025.01 plus the patches in your u-boot-h616 directory and booting from EMMC works now. Thanks for the nudge! 

[sicxnull]

Here is the updated image with Wifi and EMMC boot

https://github.com/sicXnull/armbian-build/releases/download/mxqpro/Armbian-unofficial_26.02.0-trunk_Mxqpro-h313_trixie_current_6.12.74_cinnamon_desktop.img.xz