Cangaroo 开源 CAN 总线分析软件安装和配置指南

1. 项目基础介绍

Cangaroo 是一个开源的 CAN 总线分析软件，支持标准帧和 FD 帧的收发，以及 DBC 解码功能。该项目使用 C++ 语言开发，基于 Qt 框架构建，提供了丰富的 CAN 总线分析功能。

2. 项目使用的关键技术和框架

• 编程语言: C++
• 构建工具: QMake
• 图形界面: Qt5 框架
• 依赖库:
  • Qt5Core、Qt5Gui、Qt5Widgets
  • libnl-3-dev 和 libnl-route-3-dev
  • libqt5serialport5 和 libqt5serialport5-dev
  • libqt5charts5 和 libqt5charts5-dev
• 支持的接口:
  • CANable 和 CANable2 SLCAN 接口
  • Candlelight 接口
  • SocketCAN 接口
  • CANblaster 基于 UDP 的 SocketCAN 服务器

3. 项目安装和配置的准备工作和详细安装步骤

3.1 准备工作

在开始安装之前，请确保您的系统已经安装了必要的依赖库：

Ubuntu/Debian 系统:

sudo apt-get update
sudo apt-get install build-essential git qt5-qmake qtbase5-dev libnl-3-dev libnl-route-3-dev cmake qt5-default libqt5serialport5 libqt5serialport5-dev libqt5charts5 libqt5charts5-dev

Windows 系统:

• 安装 Qt Creator（社区版）
• 安装必要的 Qt 库和开发工具

3.2 安装步骤

3.2.1 获取项目源码

git clone https://gitcode.com/gh_mirrors/ca/cangaroo.git
cd cangaroo

3.2.2 构建项目

Linux 系统构建:

qmake -qt=qt5
make
sudo make install

Windows 系统构建:

• 打开 Qt Creator
• 加载项目文件 cangaroo.pro
• 配置构建选项
• 构建项目

3.2.3 运行软件

Linux 系统:

cangaroo

Windows 系统:

• 运行生成的 cangaroo.exe 可执行文件

3.3 配置 CAN 设备

Cangaroo 支持多种 CAN 设备接口配置：

• CANable/CANable2: 通过 USB 连接设备，在软件中选择相应接口
• SocketCAN: 在 Linux 系统中配置网络接口（如 can0 或 vcan0）
• Candlelight: 支持 Windows 平台的 Candlelight 接口设备

4. 主要功能特性

• CAN FD 支持: 支持 CAN FD 帧的收发和处理
• DBC 解码: 支持 DBC 文件格式的消息解码
• 实时过滤: 在跟踪视图中实时过滤 CAN 消息
• 多窗口界面: 基于停靠窗口的系统界面
• 日志系统: 完善的日志记录和显示功能
• 信号处理: 支持复用信号的处理和显示

5. 项目结构说明

项目主要包含以下核心模块：

• core/: 核心功能模块，包括后端处理、CAN 数据库、日志系统等
• driver/: CAN 驱动模块，支持多种 CAN 接口设备
• window/: 界面窗口模块，包含各种功能窗口
• parser/: 解析器模块，支持 DBC 文件解析

6. 使用建议和注意事项

1. 设备兼容性: 确保使用的 CAN 设备与软件支持的接口类型匹配
2. 权限设置: Linux 系统下可能需要配置用户权限以访问 CAN 设备
3. DBC 文件: 准备正确的 DBC 文件以便进行消息解码
4. 性能优化: 在处理大量 CAN 消息时，注意系统资源使用情况

7. 总结

Cangaroo 是一个功能强大的开源 CAN 总线分析工具，提供了完善的 CAN 消息收发、解码和分析功能。通过本文的安装和配置指南，您可以快速搭建 CAN 总线分析环境，开始进行 CAN 总线相关的开发和测试工作。