# libcanbus

**Repository Path**: fulinux/libcanbus

## Basic Information

- **Project Name**: libcanbus
- **Description**: 支持canbus多包数据传输协议功能，函数封装简单，易于调用。
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 54
- **Forks**: 27
- **Created**: 2014-08-15
- **Last Updated**: 2025-04-23

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: None

## README

libcanbus
=========
# **canbus(CAN BUS V2.0 B)扩展格式库项目简析** #

*注: 本文假设你已经有linux开发环境*

请确保你使用本库时是tag版本。<br>
该库遵循的协议是SAE J1939-21-2006。<br>

> target=libcanbus-1.0

**本项目采用 GPL 授权协议，欢迎大家在这个基础上进行改进，并与大家分享，为开源事业贡献一点点力量。**<br>
**源码下载地址**<br>
**https://git.oschina.net/fulinux/libcanbus<br>

下面将简单的解析下项目：

## **一、项目的目录结构** ##
> 根目录<br>
> |-- src<br>
> |-- util<br>
> |-- docs<br>
> |-- build-aux<br>
>  `- m4<br>

**1、src目录**<br>
src目录用于存放项目的包及C源码文件。

下面是src目录的文件:
> src<br>
> |-- canbus.c<br>
> |-- canbus-private.h<br>
> `-- canbus.h<br>

- canbus.c —库中的主文件，定义函数 
- canbus-private.h —库中的私有头文件，声明个别结构体 
- canbus.h —库中的公共头文件，声明函数和结构体等

**2、util目录**<br>
util目录用于存放测试库的套件程序。

下面是test目录里的文件:
> util<br>
> |-- recv-test.c<br>
> |-- send-test.c<br>
> |-- server-cycle2snd.c<br>
> |-- client-cycle2snd.c<br>
> |-- test-recv-send.c<br>
> `-- test-send-recv.c<br>

- recv-test.c —CAN BUS扩展格式的接收测试程序, 与下面的程序配合使用
- send-test.c —CAN BUS扩展格式的发送测试程序, 与上面的程序配合使用
- server-cycle2snd.c —CAN BUS扩展格式中周期发送服务端测试程序, 与下面的程序配合使用
- client-cycle2snd.c —CAN BUS扩展格式中周期发送客户端测试程序, 与上面的程序配合使用
- test-recv-send.c —CAN BUS扩展格式中即周期发送又接收服务端测试程序, 与下面的程序配合使用
- test-send-recv.c —CAN BUS扩展格式中即周期发送又接收客户端测试程序, 与上面的程序配合使用

## **二、编译流程** ##
**1) 下载源代码**<br>
> $ git clone https://git.oschina.net/fulinux/libcanbus.git

**2) 进入libcanbus目录中**<br>
> $ cd libcanbus<br>

**3) 查看tag版本**<br>
> $ git tag

**4) 选择最新的tag**<br>
> $ git checkout vx.x.x

*注上面命令行中的"x"代表最新的tag版本中的版本号码*

**5) 配置选项, 检测环境、依赖关系等，然后编译**<br>
> $ ./configure && make<br>

*注: 当然你可以根据实际需要，为configure添加选项，例如加上--enable-static选项以使能静态库编译选项*

**6) 安装(可以不用安装)**<br>
> $ sudo make install

## **三、测试库套件使用** ##
**1) 进入util目录**<br>
> $ cd util<br>

**2) 首先加载虚拟can设备vcan0<br>
> $ sudo sh start.sh

**3) 在一个终端中运行接收函数<br>
> $ ./recv-test<br>

**4) 在另一个终端中运行发送函数<br>
> $ ./send-test<br>

**5) 静态编译<br>
*注：静态编译的好处是可以直接在其他平台上运行，而不需要库文件。*
> $ make CFLAGS+=--static LDFLAGS+=-static

## **四、libcanbus库主页以及邮件列表** ##

**库主页用于详细说明库的相关内容，大家亦可以在issues和博客下面反馈你使用过程中所遇到的问题和想法。希望大家能积极的改进该库，并在git@oschina上发起合并请求，如果确有改进，我会将其合并到master分支上来。当然你首先要是这个网站的用户，并且需要fork该库项目。**<br>
**你也可以直接通过邮件的方式将问题和想法发给我。**<br>

**1)库主页**<br>
**http://blog.csdn.net/fulinus/article/details/39938795**<br>

**2)BUG提交**<br>
**https://git.oschina.net/fulinux/libcanbus/issues
**3)邮件列表**<br>
**E-mail: fulinux@sina.com**<br>
**author: fulinux**<br>