nuttx/Documentation/platforms
Yanfeng Liu 75d0c2946d risc-v: Initial support for CanMV-k230 board and K230 chip
The code is mainly derived from the NuttX qemu-rv/rv-virt codebase.

Major changes:

- boards/Kconfig:       add new BOARD_K230_CANMV
- arch/risc-v/Kconfig:  add new CHIP_K230 chip and ARCH_RV_MMIO_BITS
- arch/risc-v/src/common/riscv_mtimer.c: use ARCH_RV_MMIO_BITS to
                        select MMIO access width

New additions:

- arch/risc-v/include/k230/: k230 SoC definitions
- arch/risc-v/src/k230/:     k230 SoC sources
- boards/risc-v/k230/canmv230/:  CanMV-K230 board sources and configs
- Documentation/platforms/risc-v/k230/: simple doc

Note that only FLAT build works for canmv230 now.

This PR has changes in RiscV common layer thus may affect other RiscV ports
It changes the mtime/mtimecmp access control from using config ARCH_RV64 to
newly intorduced config ARCH_RV_MMIO_BITS.

Original design uses ARCH_RV64 to select 64bit MMIO in riscv_mtimer.c, this
can't cope with the situation with K230 --- it has ARCH_RV64 but only can do
32bit MMIO. So a new ARCH_RV_MMIO_BITS config has been introduced. Its value
depicts the MMIO width in bits. The MMIO_BITS defaults to 32/64 for RV32/
RV64 respectively. This allows the macro to replace current use of ARCH_RV64
in riscv_mtimer.c.

The new MMIO_BITS config is a derived one, and for RiscV chips with
equal CPU and MMIO widths there is no need to explicitly set it as the
default rule will do that. Only chips with different CPU and MMIO widths
need set it in Kconfig.

So by design this change should be safe but RiscV ports should be checked.

"ostest" verification has been done for:

- canmv230/nsh
- rv-vivt/nsh
- rv-virt/nsh64

configuration generation and manual check of derived RV_MMIO_BITS has been
done for:

- star64/nsh
- arty_a7/nsh
- bl602evb/nsh

Signed-off-by: Yanfeng Liu <yfliu2008@qq.com>
2023-12-17 01:10:57 -08:00
..
arm fix bug in gd32f4xx_serial.c, add romfsimg.h, gd32f4xx_reset and improve gd32f4xx_gpio.c for f470z board, add board decription for f470 2023-12-13 23:27:23 -08:00
arm64 Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
avr Documentation: Fix various typos 2023-11-23 16:38:19 -08:00
ceva Documentation: add missing platforms to platforms/ and remove introduction/platforms 2023-10-22 19:06:44 +08:00
hc Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
mips Documentation: Fix various typos 2023-11-23 16:38:19 -08:00
misco Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
or1k Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
renesas Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
risc-v risc-v: Initial support for CanMV-k230 board and K230 chip 2023-12-17 01:10:57 -08:00
sim Documentation: Fix typos 2023-10-29 10:35:51 +08:00
sparc Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
x86 Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
x86_64 Documentation: migrate the rest boards 2023-10-26 18:13:34 -03:00
xtensa doc: update an example to match the latest versions of the code 2023-12-07 19:48:51 -08:00
z16 Documentation: migrate boards/{z16|z80}/xxx/configs/README.txt 2023-10-28 13:55:22 +08:00
z80 Documentation: migrate boards/{z16|z80}/xxx/configs/README.txt 2023-10-28 13:55:22 +08:00
index.rst Documentation: migrate /arch 2023-10-26 00:08:54 +08:00