Skip to main content

Controller Area Network interface module for Python

Project description

Latest Version Documentation Status CI Server

The Controller Area Network is a bus standard designed to allow microcontrollers and devices to communicate with each other. It has priority based bus arbitration, reliable deterministic communication. It is used in cars, trucks, wheelchairs and more. See wikipedia for more info.

This module provides controller area network support for Python.

Configuration File

In order to use this library a CAN interface needs to be specified. A method to do this is to create a configuration file. On Linux systems the config file is searched in the following paths:

  1. /etc/can.conf

  2. $HOME/.can

  3. $HOME/.canrc

On Windows systems the config file is searched in the following paths: 1. can.ini (current working directory) 2. $APPDATA/can.ini

The configuration file sets the default interface and channel:

[default]
interface = <the name of the interface to use>
channel = <the channel to use by default>

Interfaces

The interface available are:

kvaser

Kvaser’s CANLib SDK for Windows (also available on Linux)

socketcan

On linux the socketcan interface is exposed via either:

  • socketcan_ctypes

  • socketcan_native

serial

A text based interface. For example use over bluetooth with /dev/rfcomm0

pcan

Peak-System’s PCAN-Basic API.

IXXAT

IXXAT’s Virtual CAN Interface V3 SDK ONLY on Windows. The Linux ECI SDK is currently unsupported. On Linux some devices are supported with socketcan.

Installation

GNU/Linux dependencies

Reasonably modern Linux Kernels (2.6.25 or newer) have an implementation of socketcan. This version of python-can will directly use socketcan if called with Python 3.3 or greater, otherwise that interface is used via ctypes.

Windows dependencies

Kvaser

To install python-can using the Kvaser CANLib SDK as the backend:

  1. Install the latest stable release of Python.

  2. Install Kvaser’s latest Windows CANLib drivers.

  3. Test that Kvaser’s own tools work to ensure the driver is properly installed and that the hardware is working.

PCAN

To use the PCAN-Basic API as the backend (which has only been tested with Python 2.7):

  1. Download the latest version of the PCAN-Basic API.

  2. Extract PCANBasic.dll from the Win32 subfolder of the archive or the x64 subfolder depending on whether you have a 32-bit or 64-bit installation of Python.

  3. Copy PCANBasic.dll into the working directory where you will be running your python script. There is probably a way to install the dll properly, but I’m not certain how to do that.

Note that PCANBasic API timestamps count seconds from system startup. To convert these to epoch times, the uptime library is used. If it is not available, the times are returned as number of seconds from system startup. To install the uptime library, run pip install uptime.

IXXAT

To install python-can using the IXXAT VCI V3 SDK as the backend:

  1. Install the latest stable release of Python.

  2. Install IXXAT’s latest Windows VCI V3 SDK drivers.

  3. Test that IXXAT’s own tools (i.e. MiniMon) work to ensure the driver is properly installed and that the hardware is working.

Install python-can

You may need to install pip and setuptools first.

Two options, install normally with:

python setup.py install

Or to do a “development” install of this package to your machine (this allows you to make changes locally or pull updates from the Mercurial repository and use them without having to reinstall):

python setup.py develop

On linux you will need sudo rights.

Documentation

The documentation for python-can has been generated with Sphinx they can be viewed online at python-can.readthedocs.org

Generation

With sphinx installed the documentation can be generated locally with:

python setup.py build_sphinx

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-can-1.5.0.tar.gz (72.5 kB view hashes)

Uploaded Source

Built Distribution

python_can-1.5.0-py3-none-any.whl (77.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page