Add a SysBus model for the 64 K230 Function IO configuration registers documented by the K230 Technical Reference Manual.
Preserve the writable configuration fields across aligned 32-bit accesses, apply the documented reset values, and ignore writes to read-only and reserved fields. Offsets outside the documented register list read as zero and ignore writes. This provides the register behavior used by the Kendryte SDK U-Boot pinctrl-single driver and Linux IOMUX configuration code. Signed-off-by: Kangjie Huang <[email protected]> --- hw/misc/Kconfig | 3 + hw/misc/k230_iomux.c | 124 +++++++++++++++++++++++++++++++++++ hw/misc/meson.build | 2 + hw/misc/trace-events | 4 ++ include/hw/misc/k230_iomux.h | 34 ++++++++++ 5 files changed, 167 insertions(+) create mode 100644 hw/misc/k230_iomux.c create mode 100644 include/hw/misc/k230_iomux.h diff --git a/hw/misc/Kconfig b/hw/misc/Kconfig index 1543ee6653..573d24a9df 100644 --- a/hw/misc/Kconfig +++ b/hw/misc/Kconfig @@ -257,4 +257,7 @@ config XLNX_VERSAL_TRNG config XLNX_ZYNQ_DDRC bool +config K230_IOMUX + bool + source macio/Kconfig diff --git a/hw/misc/k230_iomux.c b/hw/misc/k230_iomux.c new file mode 100644 index 0000000000..cc40dc8ae4 --- /dev/null +++ b/hw/misc/k230_iomux.c @@ -0,0 +1,124 @@ +/* + * Kendryte K230 IOMUX + * + * Copyright (c) 2026 Kangjie Huang <[email protected]> + * + * SPDX-License-Identifier: GPL-2.0-or-later + * + * Provides the Function IO configuration registers documented by the K230 + * Technical Reference Manual. + * + * K230 Technical Reference Manual V0.3.1 (2024-11-18): + * https://github.com/revyos/external-docs/blob/master/K230/en-us/K230_Technical_Reference_Manual_V0.3.1_20241118.pdf + * + * For more information, see <https://www.kendryte.com/en/proDetail/230> + */ + +#include "qemu/osdep.h" +#include "hw/misc/k230_iomux.h" +#include "migration/vmstate.h" +#include "qemu/module.h" +#include "trace.h" + +/* TRM V0.3.1 section 12.9.2.1 Function IO register list. */ +static const uint32_t k230_iomux_reset_values[K230_IOMUX_NUM_REGS] = { + 0x944, 0x944, 0x929, 0x908, 0x888, 0x908, 0x948, 0x890, + 0x890, 0x890, 0x910, 0x890, 0x890, 0x8a9, 0xa9e, 0xabf, + 0xb9e, 0xb9e, 0xb9e, 0xb9e, 0xb9e, 0xb9e, 0xb9e, 0xb9e, + 0xb1e, 0xa90, 0xabf, 0xb9e, 0xb9e, 0xb9e, 0xb9e, 0xb9e, + 0xbd0, 0xbd0, 0xbd0, 0xbd0, 0xbd0, 0xbd0, 0x890, 0x910, + 0x890, 0x910, 0x890, 0x910, 0x890, 0x910, 0x890, 0x910, + 0x890, 0x910, 0x890, 0x910, 0x890, 0x910, 0x89e, 0x89f, + 0x99e, 0x99e, 0x99e, 0x99e, 0x890, 0x890, 0x8a9, 0x8a9, +}; + +static void k230_iomux_reset(DeviceState *dev) +{ + K230IomuxState *s = K230_IOMUX(dev); + + memcpy(s->regs, k230_iomux_reset_values, + sizeof(k230_iomux_reset_values)); +} + +static uint64_t k230_iomux_read(void *opaque, hwaddr offset, unsigned size) +{ + K230IomuxState *s = K230_IOMUX(opaque); + uint32_t value = 0; + + if (offset < K230_IOMUX_REGS_SIZE) { + value = s->regs[offset >> 2]; + } + + trace_k230_iomux_read(offset, value); + return value; +} + +static void k230_iomux_write(void *opaque, hwaddr offset, + uint64_t value, unsigned size) +{ + K230IomuxState *s = K230_IOMUX(opaque); + + trace_k230_iomux_write(offset, value); + if (offset < K230_IOMUX_REGS_SIZE) { + s->regs[offset >> 2] = value & K230_IOMUX_WRITABLE_MASK; + } +} + +static const MemoryRegionOps k230_iomux_ops = { + .read = k230_iomux_read, + .write = k230_iomux_write, + .endianness = DEVICE_LITTLE_ENDIAN, + .valid = { + .min_access_size = 4, + .max_access_size = 4, + .unaligned = false, + }, + .impl = { + .min_access_size = 4, + .max_access_size = 4, + .unaligned = false, + }, +}; + +static void k230_iomux_init(Object *obj) +{ + K230IomuxState *s = K230_IOMUX(obj); + + memory_region_init_io(&s->mmio, obj, &k230_iomux_ops, s, + TYPE_K230_IOMUX, K230_IOMUX_MMIO_SIZE); + sysbus_init_mmio(SYS_BUS_DEVICE(obj), &s->mmio); +} + +static const VMStateDescription vmstate_k230_iomux = { + .name = "k230.iomux", + .version_id = 1, + .minimum_version_id = 1, + .fields = (const VMStateField[]) { + VMSTATE_UINT32_ARRAY(regs, K230IomuxState, K230_IOMUX_NUM_REGS), + VMSTATE_END_OF_LIST() + } +}; + +static void k230_iomux_class_init(ObjectClass *klass, const void *data) +{ + DeviceClass *dc = DEVICE_CLASS(klass); + + dc->desc = "Kendryte K230 IOMUX"; + dc->vmsd = &vmstate_k230_iomux; + device_class_set_legacy_reset(dc, k230_iomux_reset); +} + +static const TypeInfo k230_iomux_info = { + .name = TYPE_K230_IOMUX, + .parent = TYPE_SYS_BUS_DEVICE, + .instance_size = sizeof(K230IomuxState), + .instance_init = k230_iomux_init, + .class_init = k230_iomux_class_init, +}; + +static void k230_iomux_register_types(void) +{ + type_register_static(&k230_iomux_info); +} + +type_init(k230_iomux_register_types) diff --git a/hw/misc/meson.build b/hw/misc/meson.build index 23265f6035..31e5145a35 100644 --- a/hw/misc/meson.build +++ b/hw/misc/meson.build @@ -168,3 +168,5 @@ system_ss.add(when: 'CONFIG_SBSA_REF', if_true: files('sbsa_ec.c')) # HPPA devices system_ss.add(when: 'CONFIG_LASI', if_true: files('lasi.c')) + +system_ss.add(when: 'CONFIG_K230_IOMUX', if_true: files('k230_iomux.c')) diff --git a/hw/misc/trace-events b/hw/misc/trace-events index c9a868b3ef..388967c9e1 100644 --- a/hw/misc/trace-events +++ b/hw/misc/trace-events @@ -405,6 +405,10 @@ djmemc_write(int reg, uint64_t value, unsigned int size) "reg=0x%x value=0x%"PRI iosb_read(int reg, uint64_t value, unsigned int size) "reg=0x%x value=0x%"PRIx64" size=%u" iosb_write(int reg, uint64_t value, unsigned int size) "reg=0x%x value=0x%"PRIx64" size=%u" +# k230_iomux.c +k230_iomux_read(uint64_t offset, uint32_t value) "offset=0x%" PRIx64 " value=0x%" PRIx32 +k230_iomux_write(uint64_t offset, uint64_t value) "offset=0x%" PRIx64 " value=0x%" PRIx64 + # aspeed_sli.c aspeed_sli_write(uint64_t offset, unsigned int size, uint32_t data) "To 0x%" PRIx64 " of size %u: 0x%" PRIx32 aspeed_sli_read(uint64_t offset, unsigned int size, uint32_t data) "To 0x%" PRIx64 " of size %u: 0x%" PRIx32 diff --git a/include/hw/misc/k230_iomux.h b/include/hw/misc/k230_iomux.h new file mode 100644 index 0000000000..15a16ef4de --- /dev/null +++ b/include/hw/misc/k230_iomux.h @@ -0,0 +1,34 @@ +/* + * Kendryte K230 IOMUX + * + * K230 Technical Reference Manual V0.3.1 (2024-11-18): + * https://github.com/revyos/external-docs/blob/master/K230/en-us/K230_Technical_Reference_Manual_V0.3.1_20241118.pdf + * + * Copyright (c) 2026 Kangjie Huang <[email protected]> + * + * SPDX-License-Identifier: GPL-2.0-or-later + */ + +#ifndef HW_MISC_K230_IOMUX_H +#define HW_MISC_K230_IOMUX_H + +#include "hw/core/sysbus.h" +#include "qom/object.h" + +#define TYPE_K230_IOMUX "riscv.k230.iomux" +OBJECT_DECLARE_SIMPLE_TYPE(K230IomuxState, K230_IOMUX) + +#define K230_IOMUX_MMIO_SIZE 0x800 +#define K230_IOMUX_NUM_REGS 64 +#define K230_IOMUX_REGS_SIZE \ + (K230_IOMUX_NUM_REGS * sizeof(uint32_t)) +#define K230_IOMUX_WRITABLE_MASK 0x00003fff + +struct K230IomuxState { + SysBusDevice parent_obj; + + MemoryRegion mmio; + uint32_t regs[K230_IOMUX_NUM_REGS]; +}; + +#endif /* HW_MISC_K230_IOMUX_H */ -- 2.43.0
