1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
Installation
============
Install the ``can`` package from PyPi with ``pip`` or similar::
$ pip install python-can
.. warning::
As most likely you will want to interface with some hardware, you may
also have to install platform dependencies. Be sure to check any other
specifics for your hardware in :doc:`interfaces`.
Many interfaces can install their dependencies at the same time as ``python-can``,
for instance the interface ``serial`` includes the ``pyserial`` dependency which can
be installed with the ``serial`` extra::
$ pip install python-can[serial]
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 `Kvaser's latest Windows CANLib drivers <https://www.kvaser.com/download/>`__.
2. Test that Kvaser's own tools work to ensure the driver is properly
installed and that the hardware is working.
PCAN
~~~~
Download and install the latest driver for your interface:
- `Windows <https://www.peak-system.com/Downloads.76.0.html?&L=1>`__ (also supported on *Cygwin*)
- `Linux <https://www.peak-system.com/Downloads.76.0.html?&L=1>`__ (`also works without <https://www.peak-system.com/fileadmin/media/linux/index.htm>`__, see also :ref:`pcandoc linux installation`)
- `macOS <https://www.mac-can.com>`__
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 python-can[pcan]``.
This library can take advantage of the `Python for Windows Extensions
<https://github.com/mhammond/pywin32>`__ library if installed.
It will be used to get notified of new messages instead of
the CPU intensive polling that will otherwise have be used.
IXXAT
~~~~~
To install ``python-can`` using the IXXAT VCI V3 or V4 SDK as the backend:
1. Install `IXXAT's latest Windows VCI V3 SDK or VCI V4 SDK (Win10)
drivers <https://www.ixxat.com/technical-support/resources/downloads-and-documentation?ordercode=1.01.0281.12001>`__.
2. Test that IXXAT's own tools (i.e. MiniMon) work to ensure the driver
is properly installed and that the hardware is working.
NI-CAN
~~~~~~
Download and install the NI-CAN drivers from
`National Instruments <https://www.ni.com/de-de/support/downloads/drivers>`__.
Currently the driver only supports 32-bit Python on Windows.
neoVI
~~~~~
See :doc:`interfaces/neovi`.
Vector
~~~~~~
To install ``python-can`` using the XL Driver Library as the backend:
1. Install the `latest drivers <https://www.vector.com/latest_driver>`__ for your Vector hardware interface.
2. Install the `XL Driver Library <https://www.vector.com/xl-lib/11/>`__ or copy the ``vxlapi.dll`` and/or
``vxlapi64.dll`` into your working directory.
3. Use Vector Hardware Configuration to assign a channel to your application.
CANtact
~~~~~~~
CANtact is supported on Linux, Windows, and macOS.
To install ``python-can`` using the CANtact driver backend:
``python3 -m pip install "python-can[cantact]"``
If ``python-can`` is already installed, the CANtact backend can be installed separately:
``pip install cantact``
Additional CANtact documentation is available at `cantact.io <https://cantact.io>`__.
CanViewer
~~~~~~~~~
``python-can`` has support for showing a simple CAN viewer terminal application
by running ``python -m can.viewer``. On Windows, this depends on the
`windows-curses library <https://pypi.org/project/windows-curses/>`__ which can
be installed with:
``python -m pip install "python-can[viewer]"``
Installing python-can in development mode
-----------------------------------------
A "development" install of this package allows you to make changes locally
or pull updates from the Git repository and use them without having to
reinstall. Download or clone the source repository then:
::
# install in editable mode
cd <path-to-this-repo>
python3 -m pip install -e .
|
