incubator-nuttx/Documentation
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
..
ReleaseNotes Documentation: add NuttX-12.3.0 release notes 2023-10-06 23:12:03 +08:00
_extensions Documentation: port warnings_filter Sphinx extension from Zephyr 2023-11-28 09:18:29 -08:00
_static docs: reduce main content max width from 1200px to 1000px 2021-03-26 23:41:45 -05:00
_templates Documentation: support versioned docs 2020-11-26 10:58:44 -08:00
applications Documentation: add open_memstream test entry 2023-11-27 03:24:53 -08:00
components semaphore/_SEM_XX: Remove the _SEM redirection macros as unnecessary 2023-11-27 04:52:54 -08:00
contributing documentation/contributing: remove copyright notice in file header 2023-11-07 01:01:18 +08:00
faq Doc: Add how to configure network MTU size 2022-11-02 09:14:17 +08:00
guides Documentation:add Documentation for stack statistics 2023-12-11 02:06:51 -08:00
implementation Documentation: Fix various typos 2023-11-23 16:38:19 -08:00
introduction Documentation: various cosmetic changes 2023-10-30 20:29:54 +08:00
platforms risc-v: Initial support for CanMV-k230 board and K230 chip 2023-12-17 01:10:57 -08:00
quickstart Documentation: review quickstart/install.rst 2023-10-30 20:29:54 +08:00
reference Documentation: fix warning 2023-11-08 15:54:54 +08:00
.gitignore doc: add .python-version to .gitignore 2020-08-25 12:54:24 -07:00
Makefile Documentation: disable parallel build 2023-11-29 01:37:10 -08:00
Pipfile docs: Add copy button for code blocks 2023-05-20 12:58:32 +08:00
Pipfile.lock build(deps): bump certifi from 2023.5.7 to 2023.7.22 in /Documentation 2023-07-25 18:06:14 -07:00
conf.py Documentation: port warnings_filter Sphinx extension from Zephyr 2023-11-28 09:18:29 -08:00
glossary.rst rename doc/ -> Documentation/ 2020-08-24 10:29:55 -07:00
index.rst Documentation: migrate "Linux Processes vs NuttX Tasks" from wiki 2023-11-05 12:11:14 +08:00
known-warnings.txt Documentation: port warnings_filter Sphinx extension from Zephyr 2023-11-28 09:18:29 -08:00
legacy_README.md Documentation: fix warning 2023-10-30 20:29:54 +08:00
make.bat Documentation: Remove all tail spaces from *.rst and *.html 2020-10-18 10:51:22 -07:00
substitutions.rst Remove the double blank line from source files 2022-02-20 20:10:14 +01:00