On Sat, Jul 11, 2026 at 09:18:34PM +0800, Junze Cao wrote:
> 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 <[email protected]>
Reviewed-by: Chao Liu <[email protected]>
Thanks,
Chao
> ---
> MAINTAINERS | 1 +
> tests/functional/riscv64/meson.build | 2 +
> tests/functional/riscv64/test_k230.py | 108 ++++++++++++++++++++++++++
> 3 files changed, 111 insertions(+)
> create mode 100755 tests/functional/riscv64/test_k230.py
>
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 6171cc7494..fcf87609cb 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -1828,6 +1828,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()
> --
> 2.53.0
>
