Common Questions 常见问题

[fanghuaqi]

Warning

很早之前的 freeloader版本配置L2 Cache使能的时候是直接写 CC_CTRL = 1 的，但是这样配置针对最新的 Nuclei CPU是不合适的，只需要配置 CC_CTRL.CC_EN=1 即可，其他位域例如 PF_NO_WB(PFNWB) 默认值是1，改成0，可能导致CPU压测运行(例如 stress-ng)的时候出现hang死，请及时关注 我们freeloader最新的修改记录 https://github.com/Nuclei-Software/freeloader/commits/dev_nuclei_next/ 以及我们各分支介绍 #2

Repo Branch Usage

• About branch naming and its support features, see 关于各分支功能介绍 About each branch feature #2

About OpenSBI/Uboot/Kernel

• Nuclei RISC-V Linux SDK: Software Stack Architecture and Device Tree Maintenance #33

How to use this repo

• About how to download source code, see below topics
  • 如何下载最新的源码(无git) How to download latest source code without git #4
  • how to do git clone clean source code 如何Clone下载干净的代码 #10
• About how to run it using docker/podman environment, see Using prebuilt linuxsdk docker image #8
• About how to bring up, see Linux Bringup suggestion when using Nuclei RISC-V CPU #21
• About how to port to your own target
  • For the doc below, you need to refer to selected branch version
  • Porting Guideline for most dev_nuclei_xxx_v3 branches: https://github.com/Nuclei-Software/nuclei-linux-sdk#port-to-your-target
  • Linux SDK quick porting script required SoC similiar to our evalsoc: https://github.com/Nuclei-Software/nuclei-linux-sdk/tree/dev_nuclei_6.6_v3/conf#linux-sdk-soc-configuration-generator
• About how to debug linux, see https://github.com/Nuclei-Software/nuclei-linux-sdk/wiki/Debug-Linuxsdk-using-NucleiStudio
• About how to use amp feature, see AMP Demo about Linux + FreeRTOS #18
• About how to use optee feature, see Questions on RISC-V OP-TEE solution #17 optee solution for RISC-V #16 shartid CSR #20
• About how to use dma_alloc_coherent API in Nuclei RISC-V Linux, see How to create dma coherent memory on Nuclei Linux Platform #22
• About Use gdb to download linux images and debug #23

About toolchain

• About Linux Toolchain 关于Linux工具链 #14
• buildroot_initramfs/host/bin/riscv-nuclei-linux-gnu-gdb: error while loading shared libraries: libgmp.so.3: cannot open shared object file: No such file or directory #5

Common issues or bugs met

You can also check the open or closed issues here https://github.com/Nuclei-Software/nuclei-linux-sdk/issues?q=is%3Aissue+

• [BUG] Probabilistic Segmentation Fault in haveged via vDSO cpu_relax() using static branches on RISC-V #34
• 【Compatibility】 Issues running Linux Kernel 5.18+ and 6.6+ on legacy 600/900 series RTL #35
• opensbi boot traped with a lot of sbi_trap_error #7
• qemu-system-riscv64: error while loading shared libraries: libpixman-1.so.0: cannot open shared object file: No such file or directory #6
• Add "depth=1" when git clone or git module update to save time. #3
• Build error optee_os/core/tee.bin Unknown e_machine "243" when try to build optee option  #11