.. highlightlang:: us .. index:: Import of CAN Databases .. index:: BLF Files .. index:: DBC Files .. index:: Vector BLF (Binary Log Format) .. index:: Vector CAN database file (*.dbc) .. _import-of-can-files: Import of CAN Files =================== The addin reads BINLOG files (``.blf``), Vector ASCII logfiles (``.asc``), MDF4 Bus Logging files (``.mf4``), G.i.N Can LOG files (``Data*F1`` and ``Data*F1.gz``) and A&D Can Log files (``.tdfa``) and converts the data into UniPlot data files into NC2 format. To interpret the Can messages, the addin needs the information from a CAN database file (DBC file). Only signals specified in the DBC file will be written to the NC2 file. Multiplex messages are supported. With multiplexing, different signals can be transmitted using one message id. In this version the import filter reads only CAN frames. .. note:: The addin is a beta version. .. _installation_can: Installation ------------ * Choose :ref:`tools-add-in-manager`. * Check the :guilabel:`CAN Import` addin. * Choose OK. .. _usage_can: Usage ----- * Choose **Tools=>CAN Configuration** to select a DBC files and to create a configuration. * Choose :ref:`fileimport-data`. * Choose Type ``"CAN File (*.blf; *.asc)"``. * Select one or more BLF/ASCII log files. * To create a dataset versus time: Choose the Type ``2D: y/t MDF/INCA/CAN``. If you select this type UniPlot will automatically select the correct time channel. .. _dbc_configuration: Can-Configuration ----------------- Goto the *Tools* menu to open the CAN Configuration dialog box. In this dialog box you can select one or more DBC files. The messages of all selected DBC files are listed in a separate list box. .. image:: S:/uniplot-obj/images/can-config-en.* If a message is selected all signals will be converted into the NC2 file. At least one DBC file and one message must be selected. For each DBC file a bus number (1 to 255) or "all" can be selected. For "all" all data for the selected messages are read. If a bus number in the range 1 to 255 is specified, only data that match the bus number will be read. In the NC file the Bus number will be displayed in the attribute "BusNumber", e.g. "CAN12". The configuration must be saved under a name. The last selected configuration will be used to load a BLF file. The configurations are saved as XML files in the sub directory ``can_dbc_ini`` in the UniPlot user directory. The ``Open Directory`` button opens the directory in the Windows Explorer. Vector ASCII Logfiles --------------------- The CAN import filter supports the import of Vector ASCII Logfiles in classical format as well as CAN FD format. The header data (maximum 50 lines) are saved as global attributes in the NC2-file. The records of the ASCII data files must have the following structure:: Timestamp Busnumber CanId "Rx|Tx" "d" Number-of-bytes Byte1, Byte2, ..., Byte8 or in the case of CAN FD::