安装指南

本节介绍 KH-UCANFD_Linux_SDK 安装流程，以及交叉编译、通道绑定等操作说明。

SDK下载

方式一：命令行下载（推荐）

如果系统已安装 wget 和 unzip，可直接执行以下命令一键完成下载和解压：

# 下载SDK（如未安装wget，先执行: sudo apt install -y wget）
wget https://gitee.com/ChengDu-KunHong/KH-UCANFD_Linux_SDK/releases/download/latest/KH-UCANFD_Linux_SDK.zip

# 解压并进入SDK目录
unzip KH-UCANFD_Linux_SDK.zip && cd KH-UCANFD_Linux_SDK-*/

方式二：手动下载

1. 访问 Gitee 发行版页面：https://gitee.com/ChengDu-KunHong/KH-UCANFD_Linux_SDK/releases
2. 下载最新版 KH-UCANFD_Linux_SDK.zip 压缩包
3. 解压后进入SDK目录：

unzip KH-UCANFD_Linux_SDK.zip
cd KH-UCANFD_Linux_SDK-*/

提示：解压后的目录名包含版本号（如 KH-UCANFD_Linux_SDK-v1.2.3），可使用 cd KH-UCANFD_Linux_SDK-*/ 自动匹配。

依赖安装

安装驱动前，请先确认系统环境满足以下需求

• Linux系统运行32位或64位内核
• make、gcc编译工具
• Linux系统的内核头文件包（或Linux头文件包），或交叉编译内核的源码树
• g++编辑器及libstdc++库
• libpopt-dev包

可执行以下命令，自动完成对主要依赖的检测和安装：

./build.sh -p

编译与安装

脚本自动安装

进入SDK目录，执行以下命令完成一键安装：

# 执行编译脚本
./build.sh

build.sh 脚本使用说明：

安装选项：
  -p                 安装前置依赖
  -dkms              使用 DKMS 安装（推荐，系统内核更新时自动重新编译）
  -rules             安装驱动及 udev 规则
  -c                 交叉编译驱动（需手动配置）

卸载选项：
  -u, -uninstall     卸载驱动

通用选项：
  -h, --help         显示此帮助信息

手动安装

执行以下make指令完成驱动编译和安装：

# 清理历史编译文件
sudo make clean

# 编译驱动（若报错，检查依赖是否齐全、gcc版本是否匹配）
sudo make netdev

# 安装驱动
sudo make install

驱动加载验证

加载驱动：

# 加载kcan驱动模块（无报错）
sudo modprobe kcan

# 验证驱动是否加载成功（输出含"kcan"）
lsmod | grep kcan

重新拔插 CAN FD 设备后，执行以下命令确认设备被识别：

# 查看CAN接口信息（输出含"can0"、"can1"等接口）
ip -d link show

卸载驱动

方式一：使用脚本卸载

sudo ./build.sh -u

方式二：使用 make 卸载

sudo make uninstall

更多内容

• 交叉编译
• 通道绑定