|
| 1 | +## Canmatrix is a python package to read and write several CAN (Controller Area Network) database formats. |
| 2 | + |
| 3 | +[](https://pypi.org/project/canmatrix/) |
| 4 | +[](https://pypi.org/project/canmatrix/) |
| 5 | +[](https://coveralls.io/github/ebroecker/canmatrix?branch=development) |
| 6 | +[](https://github.com/ebroecker/canmatrix/issues) |
| 7 | + |
| 8 | + |
| 9 | +## About |
| 10 | + |
| 11 | +***Canmatrix*** implements a "Python Can Matrix Object" which describes the can-communication and the needed objects (Boardunits, Frames, Signals, Values, ...) |
| 12 | +***Canmatrix*** also includes two **Tools** (canconvert and cancompare) for converting and comparing **CAN** databases. |
| 13 | + |
| 14 | +- Multiple formats automotive related communication matrix file parsing. |
| 15 | +- CAN message encoding and decoding. |
| 16 | + |
| 17 | +**Supported file formats for import:** |
| 18 | + |
| 19 | + .dbc candb / Vector |
| 20 | + .dbf Busmaster (open source!) |
| 21 | + .kcd kayak (open source!) |
| 22 | + .arxml autosar system description |
| 23 | + .yaml dump of the python object |
| 24 | + .xls(x) excel xls-import, works with .xls-file generated by this lib |
| 25 | + .sym peak pcan can description |
| 26 | + .xml (fibex or CANopen eds) |
| 27 | + .ldf (lin bus) |
| 28 | + .odx (diagnostic file) |
| 29 | + .eds |
| 30 | + |
| 31 | +**Supported file formats for export:** |
| 32 | + |
| 33 | + .dbc |
| 34 | + .dbf |
| 35 | + .kcd |
| 36 | + .xls(x) |
| 37 | + .json Canard (open source!) |
| 38 | + .arxml (very basic implementation) |
| 39 | + .yaml (dump of the python object) |
| 40 | + .sym |
| 41 | + .xml (fibex) |
| 42 | + .lua (wireshark script) |
| 43 | + .scapy |
| 44 | + |
| 45 | +Project Homepage: https://github.com/ebroecker/canmatrix |
| 46 | + |
| 47 | +Documentation: https://canmatrix.readthedocs.io |
| 48 | + |
| 49 | + |
| 50 | +## Installation |
| 51 | + |
| 52 | +https://canmatrix.readthedocs.io/en/latest/installation.html |
| 53 | + |
| 54 | +[Chinese Translation / 安装中文方法解释及注意事项](https://github.com/ebroecker/canmatrix/wiki/%E5%AE%89%E8%A3%85%E4%B8%AD%E6%96%87%E6%96%B9%E6%B3%95%E8%A7%A3%E9%87%8A%E5%8F%8A%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9) |
| 55 | + |
| 56 | + |
| 57 | +## Contributing |
| 58 | + |
| 59 | +Source Code, Documentation, Examples, Report issues and Any other contributions are **extremely appreciated**. |
| 60 | + |
| 61 | +1. Fork the Project |
| 62 | +2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) |
| 63 | +3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) |
| 64 | +4. Push to the Branch (`git push origin feature/AmazingFeature`) |
| 65 | +5. Open a Pull Request |
0 commit comments