嘉楠堪智 CanMV K230 双核系统C语言开发实战：从SCons构建到程序部署-平芜编程栈

1. 认识CanMV K230双核开发环境

第一次拿到嘉楠堪智CanMV K230开发板时，最让我惊讶的是它的双核异构架构设计。这款开发板搭载了两个RISC-V核心：一个运行Linux系统的小核（800MHz）和一个运行RT-Smart实时系统的大核（1.6GHz）。这种设计让开发者可以同时享受Linux丰富的软件生态和实时系统的确定性响应。

在实际项目中，我经常这样分工：用Linux小核处理网络通信、文件管理等复杂任务，而RT-Smart大核则负责实时性要求高的图像处理或控制逻辑。两个核心通过共享内存和/sharefs目录进行数据交换，这种协作模式在AI边缘计算场景中特别实用。

开发环境搭建有个小技巧：官方推荐使用Ubuntu 20.04 LTS系统，建议直接使用他们提供的Docker镜像。我试过在其他Linux发行版上搭建，经常会遇到工具链兼容性问题。安装好基础环境后，记得检查这两个关键路径：

小核工具链：k230_sdk/toolchain/Xuantie-900-gcc-linux-5.10.4-glibc-x86_64-V2.6.0/bin
大核工具链：k230_sdk/toolchain/riscv64-linux-musleabi_for_x86_64-pc-linux-gnu/bin

2. 双核程序的SCons构建实战

2.1 编写跨核兼容的代码

在K230上开发时，要注意大小核的系统差异。比如标准库函数，Linux小核使用glibc实现，而RT-Smart大核使用musl libc。我在一个图像处理项目中就踩过坑：大核上调用某些数学函数时需要额外链接-lm参数。

下面是个简单的双核兼容示例：

#include <stdio.h> #include <stdlib.h> // 双核通用的初始化函数 void common_init() { printf("Cross-core initialization\n"); } // 小核专用功能 #ifdef __linux__ void linux_specific_task() { system("date"); } #endif // 大核专用功能 #ifdef __RTTHREAD__ void rtt_specific_task() { printf("RT-Thread specific task\n"); } #endif int main() { common_init(); #ifdef __linux__ linux_specific_task(); #elif defined(__RTTHREAD__) rtt_specific_task(); #endif return 0; }

2.2 配置SCons构建系统

官方推荐使用SCons而不是直接调用gcc，确实有道理。我刚开始觉得配置麻烦，但用熟后发现比Makefile直观多了。下面是针对大核的SConscript示例：

# RT-Smart应用的SConscript示例 from building import * cwd = GetCurrentDir() src = Glob('*.c') + Glob('*.cpp') CPPPATH = [ cwd, '#rt-smart/userapps/sdk/include' ] LIBS = ['pthread', 'm'] group = DefineGroup('smart_app', src, depend = [''], CPPPATH = CPPPATH, LIBS = LIBS, LIBPATH = ['#rt-smart/userapps/sdk/lib'], LINKFLAGS = '-static') Return('group')

小核的配置更简单些，因为可以直接使用动态链接：

# Linux应用的SConscript示例 from building import * env = Environment(tools=['default', 'gcc']) env.Append(CCFLAGS=['-O2', '-Wall']) program = env.Program( target='linux_app', source=Glob('*.c'), LIBS=['pthread'] )

3. 解决交叉编译常见问题

3.1 工具链路径问题

我最常遇到的问题是工具链路径配置错误。建议在~/.bashrc中添加这些环境变量：

export K230_SDK_PATH=~/k230_sdk export PATH=$K230_SDK_PATH/toolchain/Xuantie-900-gcc-linux-5.10.4-glibc-x86_64-V2.6.0/bin:$PATH export PATH=$K230_SDK_PATH/toolchain/riscv64-linux-musleabi_for_x86_64-pc-linux-gnu/bin:$PATH

3.2 库依赖处理

大核程序需要静态链接，这点要特别注意。有次我忘记加-static参数，导致程序在板子上报"找不到动态库"错误。推荐使用riscv64-unknown-linux-musl-readelf -d检查生成的ELF文件依赖。

4. 程序部署与调试技巧

4.1 使用/sharefs共享目录

开发板挂载SD卡后，会自动创建/sharefs目录，这是大小核都能访问的共享区域。我通常这样部署：

# 在小核上挂载SD卡 mount /dev/mmcblk0p1 /sharefs # 部署大核程序 cp smart_app.elf /sharefs # 部署小核程序 cp linux_app /sharefs

4.2 双核调试方法

调试双核系统需要些技巧：

小核调试：直接用gdb连接

riscv64-unknown-linux-gnu-gdb linux_app target remote :1234

大核调试：需要先在内核配置中启用KGDB

riscv64-unknown-linux-musl-gdb smart_app.elf set serial baud 115200 target remote /dev/ttyUSB1

5. 实战：图像处理双核协作案例

最近做了一个车牌识别项目，分享一下架构设计：

大核：运行OpenCV算法，实时处理摄像头数据
小核：运行HTTP服务，提供识别结果查询

关键代码结构：

project/ ├── big_core/ │ ├── SConstruct │ ├── SConscript │ └── plate_detection.c # 图像处理代码 └── small_core/ ├── SConstruct └── web_service.c # 网络服务代码

大核通过共享内存将识别结果传给小核：

// 大核写入结果 void write_result(char* result) { int fd = open("/dev/mem", O_RDWR); void* shared_mem = mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0x80000000); strcpy((char*)shared_mem, result); munmap(shared_mem, 4096); close(fd); }

小核从相同位置读取：

void read_result(char* buffer) { int fd = open("/dev/mem", O_RDWR); void* shared_mem = mmap(NULL, 4096, PROT_READ, MAP_SHARED, fd, 0x80000000); strcpy(buffer, (char*)shared_mem); munmap(shared_mem, 4096); close(fd); }

这个项目让我深刻体会到K230双核设计的优势——大核确保图像处理的实时性，小核提供便捷的网络服务，两者通过共享内存高效协作。部署时记得在SConscript中添加-lrt链接参数，否则会报shm相关函数找不到的错误。