https://github.com/astuff/kvaser-linuxcan
Copy of Kvaser Linux Drivers and SDK from https://kvaser.com/download/
https://github.com/astuff/kvaser-linuxcan
Last synced: 12 months ago
JSON representation
Copy of Kvaser Linux Drivers and SDK from https://kvaser.com/download/
- Host: GitHub
- URL: https://github.com/astuff/kvaser-linuxcan
- Owner: astuff
- License: other
- Created: 2019-05-15T00:09:56.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-09T15:27:58.000Z (over 3 years ago)
- Last Synced: 2023-12-11T23:00:48.803Z (over 2 years ago)
- Language: C
- Size: 7 MB
- Stars: 6
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README
- License: COPYING
Awesome Lists containing this project
README
/*
** Copyright 2017 by Kvaser AB, Molndal, Sweden
** http://www.kvaser.com
**
** This software is dual licensed under the following two licenses:
** BSD-new and GPLv2. You may use either one. See the included
** COPYING file for details.
**
** License: BSD-new
** ==============================================================================
** Redistribution and use in source and binary forms, with or without
** modification, are permitted provided that the following conditions are met:
** * Redistributions of source code must retain the above copyright
** notice, this list of conditions and the following disclaimer.
** * Redistributions in binary form must reproduce the above copyright
** notice, this list of conditions and the following disclaimer in the
** documentation and/or other materials provided with the distribution.
** * Neither the name of the nor the
** names of its contributors may be used to endorse or promote products
** derived from this software without specific prior written permission.
**
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
** CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
** SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
** BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
** IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
** ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
** POSSIBILITY OF SUCH DAMAGE.
**
**
** License: GPLv2
** ==============================================================================
** This program is free software; you can redistribute it and/or modify
** it under the terms of the GNU General Public License as published by
** the Free Software Foundation; either version 2 of the License, or
** (at your option) any later version.
**
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU General Public License for more details.
**
** You should have received a copy of the GNU General Public License
** along with this program; if not, write to the Free Software
** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
**
**
** IMPORTANT NOTICE:
** ==============================================================================
** This source code is made available for free, as an open license, by Kvaser AB,
** for use with its applications. Kvaser AB does not accept any liability
** whatsoever for any third party patent or other immaterial property rights
** violations that may result from any usage of this source code, regardless of
** the combination of source code and various applications that it can be used
** in, or with.
**
** -----------------------------------------------------------------------------
*/
- Linux drivers for Kvaser PCIeFD, PCIcan, PCIcanII, USBcanII,
Leaf and Mhydra -
Interface Product Driver Name
-----------+------------------------+-------------
USB Leaf Light leaf
Leaf Light v2
Leaf SemiPro
Leaf Professional
Memorator Professional
BlackBird
-----------+------------------------+-------------
miniPCIe Mini PCI Express HS leaf
Mini PCI Express 2xHS
-----------+------------------------+-------------
miniPCIe Mini PCI Express HS v2 pciefd
Mini PCI Express 2xHS v2
-----------+------------------------+-------------
USB Eagle mhydra
BlackBird v2
BlackBird Pro HS v2
Hybrid 2xCAN/LIN
Hybrid CAN/LIN
Hybrid Pro 2xCAN/LIN
Hybrid Pro CAN/LIN
Leaf Pro HS v2
Memorator 2xHS v2
Memorator Light HS v2
Memorator Pro 2xHS v2
Memorator Pro 5xHS
USBcan Light 4xHS
USBcan Pro 2xHS v2
USBcan Pro 4xHS
USBcan Pro 5xHS
U100
U100P
U100S
-----------+------------------------+-------------
USB USBcanII usbcanII
Memorator
-----------+------------------------+-------------
PCI PCIcan pcican
PCIcanx
-----------+------------------------+-------------
PCIe PCIEcan HS pcican
PCIEcan HS/HS
-----------+------------------------+-------------
PCIe PCIEcan HS v2 pciefd
PCIEcan 2xHS v2
PCIEcan 4xHS
-----------+------------------------+-------------
PCI PC104 pcicanII
PC104+
PCIcan II
PCIcanx II
-----------+------------------------+-------------
System requirements:
* Linux 2.6.29 or later
* Header files and compiler for kernel compilation.
In Ubuntu 14.04 e.g. this is accomplished by issuing the command:
"sudo apt-get install build-essential"
On some systems you may also need to issue:
"sudo apt-get install linux-headers-`uname -r`"
NOTE! Having versions of the linux headers installed other than that of
the currently running kernel may cause conflicts and faulty drivers.
* DKMS if you want to the drivers to be built whenever the kernel is upgraded.
To install dkms on Ubuntu:
"sudo apt-get install dkms"
Compilation:
NOTE! Choose a path that doesn't contain any spaces for CANlib to build properly.
* To build all drivers:
"make"
To install all drivers:
"sudo make install"
Note: it is advised to call "sudo make uninstall" before replacing installed
drivers.
To unload and uninstall all drivers:
"sudo make uninstall"
To install and load, virtual and PCI drivers:
"sudo make load"
Note: running "sudo make load" will also cause the virtual and PCI drivers to
be loaded at boot time. This might be bad if experimenting with the
device drivers.
Note: it is never required to manually install or load any modules, create or
edit files. This is taken care of the Makefile, in the root of the
linuxcan directory.
Note: if there are multiple versions of linuxcan installed for different linux
headers, it is possible to remove them all by calling "sudo make purge".
Another way to install CANlib is by using DKMS which automatically recompiles
and reinstalls the CANlib drivers after a kernel upgrade.
To build and install CANlib and all drivers using DKMS:
"make dkms"
"sudo make dkms_install"
Note: this requires you to have dkms installed.
To uninstall CANlib and to unload and uninstall all linuxcan DKMS modules:
"sudo make dkms_uninstall"
* To build just a single driver, go to the corresponding subdirectory:
"make"
"sudo ./installscript.sh"
Note: All device drivers use the kvcommon driver. If you want to build and
install only particular device drivers, you will first need to build and
install the kvcommon driver from the linuxcan/common directory using the
method above.
* To build and load just a single driver (virtual or PCI), go to the
corresponding subdirectory:
"make"
"sudo ./installscript.sh load"
Note: See the note above, regarding the kvcommon driver.
* To build with debug printouts, and include gdb debug information on generated binaries:
"make KV_DEBUG_ON=1"
Debug levels and some other settings may be changed in config.mak.
Usage:
* USBcanII, Leaf and Mhydra will load/unload when inserting/removing the device
* For PCI-drivers (pciefd, pcican, and pcicanII), use modprobe to load and
unload the drivers, e.g.:
"modprobe pcican" to load pcican driver, and
"modprobe -r pcican" unload pcican driver.
* Try examples in /usr/doc/canlib/examples/
NOTE! Please read ReleaseNotes before using the driver.
Troubleshooting:
* See doc/faq
Installed Files:
* Driver modules
----------------------------------
/lib/modules/`uname -r`/kernel/drivers/char/kvpciefd.ko (PCIEcan)
/lib/modules/`uname -r`/kernel/drivers/char/kvpcican.ko (PCIcan)
/lib/modules/`uname -r`/kernel/drivers/char/kvpcicanII.ko (PCIcanII)
/lib/modules/`uname -r`/kernel/drivers/char/kvvirtualcan.ko (Virtualcan)
/lib/modules/`uname -r`/kernel/drivers/usb/misc/usbcanII.ko (USBcanII)
/lib/modules/`uname -r`/kernel/drivers/usb/misc/leaf.ko (Leaf)
/lib/modules/`uname -r`/kernel/drivers/usb/misc/mhydra.ko (Mhydra)
* Module setup
----------------------------------
On CentOS, RedHat, RHEL, Fedora and simlar systems, the following lines are
added to /etc/modprobe.conf, on Debian, Ubuntu, Trisquel and similar systems
they are added to /etc/modprobe.d/kvaser.conf.
for PCIEcan:
alias pciefd kvpciefd
install kvpciefd /usr/sbin/pciefd.sh start
remove kvpciefd /usr/sbin/pciefd.sh stop
for PCIcan:
alias pcican kvpcican
install kvpcican /usr/sbin/pcican.sh start
remove kvpcican /usr/sbin/pcican.sh stop
for PCIcan II:
alias pcicanII kvpcicanII
install kvpcicanII /usr/sbin/pcicanII.sh start
remove kvpcicanII /usr/sbin/pcicanII.sh stop
for Virtualcan:
alias virtualcan kvvirtualcan
install kvvirtualcan /usr/sbin/virtualcan.sh start
remove kvvirtualcan /usr/sbin/virtualcan.sh stop
In the same files, the following lines are added to blacklist SocketCAN:
blacklist kvaser_usb
blacklist kvaser_pci
blacklist kvaser_pciefd
* Module loading
----------------------------------
/usr/sbin/pciefd.sh (start/stop pciefd driver; by modprobe or manually)
/usr/sbin/pcican.sh (start/stop pcican driver; by modprobe or manually)
/usr/sbin/pcicanII.sh (start/stop pcicanII driver; by modprobe or manually)
/usr/sbin/virtualcan.sh (start/stop virtualcan driver; by modprobe or manually)
/usr/sbin/usbcanII.sh (start/stop usbcanII driver; by udev or manually)
/usr/sbin/leaf.sh (start/stop leaf driver; by udev or manually)
/usr/sbin/mhydra.sh (start/stop mhydra driver; by udev or manually)
* Module loading at boot
----------------------------------
If the modules are installed with "sudo make load", the virtual and the PCI
drivers are added to /etc/modules-load.d/kvaser.conf. This will cause the
modules to be loaded at boot time.
* udev rules
----------------------------------
/etc/udev/rules.d/10-kvaser.rules
* Include files for canlib library
----------------------------------
/usr/include/canlib.h
/usr/include/canstat.h
* Canlib library and links
----------------------------------
/usr/lib/libcanlib.so
/usr/lib/libcanlib.so.1.1.0
/usr/lib/libcanlib.so.1
* Canlib documentation
----------------------------------
/usr/doc/canlib/HTMLhelp
* Canlib examples
----------------------------------
/usr/doc/canlib/examples
* Canlib Makefile template
----------------------------------
/usr/doc/canlib/examples/Makefile