Metadata-Version: 1.1
Name: can4python
Version: 0.1.0
Summary: A package for handling CAN bus signals on Linux SocketCAN, for Python 3.3 and later.
Home-page: https://github.com/caran/can4python
Author: Jonas Berg
Author-email: caranopensource@semcon.com
License: BSD
Description: ==========================
        Introduction to can4python
        ==========================
        
        .. comment  .. image:: https://img.shields.io/travis/caran/can4python.svg
        .. comment          :target: https://travis-ci.org/caran/can4python
        
        .. comment  .. image:: https://img.shields.io/pypi/v/can4python.svg
        .. comment          :target: https://pypi.python.org/pypi/can4python
        
        
        A package for handling CAN bus (Controller Area Network) signals on Linux SocketCAN, for Python 3.3 and later.
        
        * Free software: BSD license
        * Source code on GitHub: https://github.com/caran/can4python
        .. comment   * Documentation: https://can4python.readthedocs.org.
        .. comment   * PyPI: https://pypi.python.org/pypi/can4python
        
        
        Features
        --------
        * Sends and receives CAN frames.
        * Handles parsing of CAN signals from CAN frames.
        
        ..
        
        * Uses SocketCAN for Linux.
        * For Python 3.3 or later. Python 3.4 is required for some functionality.
        * Implemented as pure Python files, without any external dependencies.
        * Suitable for use with BeagleBone and Raspberry Pi embedded Linux boards.
        
        ..
        
        * Configuration using the open source KCD file format.
        * Throttle incoming frames to reduce frame rate.
        * Filtering of incoming frames on data changes. This is done via a bit mask in the Linux kernel.
        * Periodic frame transmission executed by the Linux kernel (not by Python code).
        
        
        Configuration file format
        -------------------------
        This CAN library uses the KCD file format for defining CAN signals and CAN messages. It is an open-source file format
        for describing CAN bus relationships. See https://github.com/julietkilo/kcd for details on the format, and example
        files.
        
        The licensing of the KCD file format is, according to the web page::
        
            The files that are describing the format are published under the Lesser GPL license.
            The KCD format is copyrighted by Jan-Niklas Meier (dschanoeh) and Jens Krueger (julietkilo).
            According to the authors this does not imply any licensing restrictions on
            software libraries implementing the KCD file format, or on software using those libraries.
        
        Traditionally CAN bus relationships are described in DBC files, a file format owned by Vector Informatik GmbH. There
        are open source DBC-to-KCD file format converters available, for example the CANBabel tool:
        https://github.com/julietkilo/CANBabel
        
        
        Known limitations
        -----------------
        * Not all CAN functionality is implemented. 'Error frames' and 'remote request frames' are not
          handled, and CAN multiplex signals are not supported.
        * Not all features of the KCD file format are implemented, for example 'Labels'.
        * It is assumed that each CAN signal name only is available in a single CAN frame ID.
        
        
        Installation and usage
        ----------------------
        See separate documentation pages.
        
        
        
        
        
        =======
        History
        =======
        
        0.1.0 (2015-09-22)
        ---------------------
        
        * First release on GitHub.
        
Keywords: can4python
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Embedded Systems
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Hardware :: Hardware Drivers
