Commit a539bb911e for qemu.org
commit a539bb911ee1085c69ce00781acd2f13bd3cb82b
Author: Junze Cao <caojunze424@gmail.com>
Date: Sat Jul 11 20:53:20 2026 +0800
tests/functional/riscv64: Add K230 Linux boot tests
The K230 machine supports direct Linux boot and firmware boot through
the SDK U-Boot, but neither path has functional test coverage.
Add one test for each boot path. Both tests use the Yocto initramfs
assets and wait for the shell prompt to confirm a successful boot.
Fetch the boot assets from the k230-boot-assets repository maintained
by Chao Liu. Pin the URLs to a repository commit and verify each asset
with its SHA-256 digest.
Signed-off-by: Junze Cao <caojunze424@gmail.com>
Reviewed-by: Alistair Francis <alistair.francis@wdc.com>
Message-ID: <20260711125320.72319-1-caojunze424@gmail.com>
Signed-off-by: Alistair Francis <alistair.francis@wdc.com>
diff --git a/MAINTAINERS b/MAINTAINERS
index 611845c626..6bab70a7fa 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1830,6 +1830,7 @@ F: hw/riscv/k230.c
F: hw/watchdog/k230_wdt.c
F: include/hw/riscv/k230.h
F: include/hw/watchdog/k230_wdt.h
+F: tests/functional/riscv64/test_k230.py
F: tests/qtest/k230-wdt-test.c
RX Machines
diff --git a/tests/functional/riscv64/meson.build b/tests/functional/riscv64/meson.build
index c9d4c090fb..d1a3e6c2bf 100644
--- a/tests/functional/riscv64/meson.build
+++ b/tests/functional/riscv64/meson.build
@@ -2,6 +2,7 @@
test_riscv64_timeouts = {
'boston' : 120,
+ 'k230' : 120,
'tuxrun' : 120,
}
@@ -13,6 +14,7 @@ tests_riscv64_system_quick = [
tests_riscv64_system_thorough = [
'endianness',
'boston',
+ 'k230',
'sifive_u',
'tt_atlantis',
'tuxrun',
diff --git a/tests/functional/riscv64/test_k230.py b/tests/functional/riscv64/test_k230.py
new file mode 100755
index 0000000000..6ccbf2d581
--- /dev/null
+++ b/tests/functional/riscv64/test_k230.py
@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+#
+# Functional tests that boot Linux on a Kendryte K230 machine.
+#
+# The direct boot test lets QEMU load OpenSBI, Linux, the device tree, and the
+# initramfs. The firmware boot test starts the K230 SDK U-Boot and uses bootm
+# to launch OpenSBI and Linux from images preloaded into RAM.
+#
+# Author:
+# Junze Cao
+#
+# SPDX-License-Identifier: GPL-2.0-or-later
+
+import os
+
+from qemu_test import Asset, LinuxKernelTest
+from qemu_test import exec_command_and_wait_for_pattern
+from qemu_test import interrupt_interactive_console_until_pattern
+
+
+class K230Machine(LinuxKernelTest):
+
+ ASSET_KERNEL = Asset(
+ ('https://raw.githubusercontent.com/zevorn/k230-boot-assets/'
+ 'c3c32fb46e8307c5063f13e8f367c98bf9273cd1/'
+ 'yocto/direct-boot/Image'),
+ '3a44970213fa68ad318d308518adfc0bf4bee72ed1b2926f9b468f82ef7d7829')
+ ASSET_DTB = Asset(
+ ('https://raw.githubusercontent.com/zevorn/k230-boot-assets/'
+ 'c3c32fb46e8307c5063f13e8f367c98bf9273cd1/'
+ 'yocto/direct-boot/k230-canmv.dtb'),
+ '5050240b48ce0988c73eaefa73e4945a40abca503cf488d22a3adf6ef50bbe4c')
+ ASSET_INITRD = Asset(
+ ('https://raw.githubusercontent.com/zevorn/k230-boot-assets/'
+ 'c3c32fb46e8307c5063f13e8f367c98bf9273cd1/'
+ 'yocto/direct-boot/rootfs.cpio.gz'),
+ '4e1869a99a232ee60324f71f3a9e84a79b03ccabb5b73f8a727c5ff5be5c0914')
+ ASSET_UBOOT = Asset(
+ ('https://raw.githubusercontent.com/zevorn/k230-boot-assets/'
+ 'c3c32fb46e8307c5063f13e8f367c98bf9273cd1/common/u-boot'),
+ '0915b9a92a7c911846a8cf691866ef14ef050a51d04209f884ae8e9ec33f36d2')
+ ASSET_FW_JUMP = Asset(
+ ('https://raw.githubusercontent.com/zevorn/k230-boot-assets/'
+ 'c3c32fb46e8307c5063f13e8f367c98bf9273cd1/'
+ 'common/fw_jump.uImage'),
+ 'cf7788e470f1d6e8c85491ecdc2705518db1b6af54080e8c7a3464bad0d902b7')
+
+ def wait_for_linux_shell(self):
+ self.wait_for_console_pattern('meta-k230 initramfs starting...')
+ self.wait_for_console_pattern('~ #')
+
+ def test_k230_direct_boot(self):
+ self.set_machine('k230')
+ kernel_path = self.ASSET_KERNEL.fetch()
+ dtb_path = self.ASSET_DTB.fetch()
+ initrd_path = self.ASSET_INITRD.fetch()
+
+ self.vm.set_console()
+ self.vm.add_args('-kernel', kernel_path,
+ '-dtb', dtb_path,
+ '-initrd', initrd_path,
+ '-append', 'console=ttyS0,115200 earlycon=sbi',
+ '-no-reboot')
+ self.vm.launch()
+ self.wait_for_linux_shell()
+
+ def test_k230_uboot_boot(self):
+ self.set_machine('k230')
+ kernel_path = self.ASSET_KERNEL.fetch()
+ dtb_path = self.ASSET_DTB.fetch()
+ initrd_path = self.ASSET_INITRD.fetch()
+ uboot_path = self.ASSET_UBOOT.fetch()
+ fw_jump_path = self.ASSET_FW_JUMP.fetch()
+ initrd_end = 0x0a100000 + os.path.getsize(initrd_path)
+
+ self.vm.set_console()
+ self.vm.add_args(
+ '-bios', uboot_path,
+ '-device',
+ f'loader,file={fw_jump_path},addr=0xc100000,force-raw=on',
+ '-device',
+ f'loader,file={kernel_path},addr=0x8200000,force-raw=on',
+ '-device',
+ f'loader,file={initrd_path},addr=0xa100000,force-raw=on',
+ '-device',
+ f'loader,file={dtb_path},addr=0xa000000,force-raw=on',
+ '-no-reboot')
+ self.vm.launch()
+
+ interrupt_interactive_console_until_pattern(self, 'K230#')
+ commands = (
+ 'setenv bootargs console=ttyS0,115200 earlycon=sbi',
+ 'fdt addr 0xa000000',
+ 'fdt resize 8192',
+ 'fdt set /chosen linux,initrd-start <0x0 0xa100000>',
+ f'fdt set /chosen linux,initrd-end <0x0 0x{initrd_end:x}>',
+ )
+ for command in commands:
+ exec_command_and_wait_for_pattern(self, command, 'K230#')
+
+ exec_command_and_wait_for_pattern(
+ self, 'bootm 0xc100000 - 0xa000000',
+ 'Starting kernel ...', failure_message='ERROR')
+ self.wait_for_linux_shell()
+
+
+if __name__ == '__main__':
+ LinuxKernelTest.main()