NI Automotive Diagnostic Command Set Toolkit 21.5 for Linux Readme

January 2022

This file contains late breaking news about Automotive Diagnostic Command Set Toolkit 21.5 and supersedes any information found in other documentation included in the distribution.

Refer to NI Linux Technology for the most recent information about Linux support at National Instruments.

Refer to the Automotive Diagnostic Command Set Toolkit Release Notes for known issues, bugs fixed since the last release, and other release details.

System Requirements

Installation Instructions

Supported Hardware

Accessing the Help

Finding Examples

Linux Limitations

Legal Information

System Requirements

Automotive Diagnostic Command Set Toolkit 21.5 software for Linux has been tested on the following distributions:

• openSUSE Leap 15.2
• openSUSE Leap 15.1
• Red Hat Enterprise Linux 8
• Red Hat Enterprise Linux 7
• CentOS 7
• Ubuntu 20.04
• Ubuntu 18.04

Automotive Diagnostic Command Set Toolkit requires a 64-bit distribution and does not support 32-bit applications.

Installation Instructions

NI provides a repository add-on for all supported drivers that you can install using your Linux distribution's native package manager.

1. Visit ni.com/info and enter the Info Code LinuxRepository.
2. Download the installer for the repository add-on for your Linux distribution.
3. Run the command (e.g., rpm, apt, etc.) to install the repository add-on.
4. Select and install the following Automotive Diagnostic Command Set Toolkit 21.5 driver packages through your Linux distribution's package manager:
   • ni-adcs (main meta package)
   • ni-adcs-demo-ecu-can-ethernet (Demo ECU app)
   • ni-adcs-demo-ecu-lin (Demo ECU app)
   • ni-adcs-examples-databases (Example databases)
   • ni-adcs-labview-20xx-support (LV support, available for 2019, 2020, and 2021)
   • ni-adcs-xnet-support (XNET Hardware Support)
   • libnidiagcs-devel (C API Development support)

After the driver package(s) are installed, you must rebuild the new packages for the system kernel. NI recommends that you run the command 'dkms autoinstall' after installation, and before rebooting the system, to install the latest revision of all modules that have been installed for other kernel revisions. After doing so, the installed device drivers will function immediately on the next system start.

Supported Hardware

The following list details the hardware models supported in Automotive Diagnostic Command Set Toolkit 21.5 for Linux.

• PCI-8511 Low‑Speed/Fault-Tolerant CAN Interface Device
• PCI-8512 High‑Speed/FD CAN Interface Device
• PCI-8513 Software‑Selectable/FD CAN Interface Device
• PCI-8516 PCI LIN Interface Device
• PCIe-8510 PCIe Vehicle Multi-Protocol Interface Device
• PXI-8511 Low-Speed/Fault Tolerant PXI CAN Interface Module
• PXI-8512 High-Speed, Flexible Data Rate PXI CAN Interface Module
• PXI-8513 Software-Selectable PXI CAN Interface Module
• PXI-8516 PXI LIN Interface Module
• PXIe-8510 PXI Vehicle Multiprotocol Interface Module
• TRC-8542 CAN HS/FD Transceiver Cable
• TRC-8543 CAN HS/FD or LS/FT Transceiver Cable
• TRC-8546 LIN Transceiver Cable
• NI 9860 C Series Vehicle Multiprotocol Interface Module¹
• NI 9861 Low-Speed/Fault Tolerant C Series CAN Interface Module
• NI 9862 High-Speed, Flexible Data Rate C Series CAN Interface Module
• NI 9866 C Series LIN Interface Module

Accessing the Help

Use a web browser to view the Automotive Diagnostic Command Set Toolkit 21.5 documentation at https://www.ni.com/r/adcshelp. You can also find a copy of the ADCS Toolkit Help installed at /usr/share/doc/ni-adcs.

Finding Examples

This release includes examples showing the use of Automotive Diagnostic Command Set Toolkit 21.5 in C and LabVIEW.

C examples are located in /usr/share/doc/ni-adcs/examples. Make files are provided that link to the necessary libraries.

The LabVIEW examples are located in the LabVIEW examples directory.

Linux Limitations

Some features discussed in the Automotive Diagnostic Command Set Toolkit 21.5 documentation are unavailable on Linux.

• Automotive Diagnostic Command Set Toolkit 21.5 supports two application development environments:
  • LabVIEW 2019, LabVIEW 2020, and LabVIEW 2021
  • C and C++ (gcc)
• Automotive Diagnostic Command Set Toolkit 21.5 does not support other ADEs, such as the LabVIEW Real-Time Module, LabWindows/CVI, Microsoft Visual C/C++, or Microsoft Visual Basic.
• Automotive Ethernet devices (i.e., PXIe-8521, PXIe-8522, PXIe-8523, and PXIe-8623) are not supported in this release.
• While Automotive Diagnostic Command Set Toolkit 21.5 includes LabVIEW VIs, it does not provide other graphical utilities that are available for other operating systems:
  • LabVIEW Express VIs.
  • Measurement and Automation Explorer (MAX) graphical configuration utility.
  • Soft front panels.
• When using Automotive Diagnostic Command Set Toolkit 21.5 in a PXI system, several restrictions apply:
  • Control through MXI-4 is supported
  • Control through MXI-3 is not supported
• External calibration functions are not supported. Refer to your hardware documentation for information about external calibration, and refer to ni.com/calibration. If your Automotive Diagnostic Command Set Toolkit 21.5 requires external calibration, either perform the calibration on a Windows system, or hire NI or an independent calibration laboratory to perform the calibration.

Legal Information

Copyright

© 2009–2022 National Instruments Corporation. All rights reserved.

This publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.

NI respects the intellectual property of others, and we ask our users to do the same. NI software is protected by copyright and other intellectual property laws. Where NI software may be used to reproduce software or other materials belonging to others, you may use NI software only to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction.

End-User License Agreements and Third-Party Legal Notices

Notices are located in the /usr/share/doc/ni-adcs/NOTICES directory. EULAs are located in the /usr/share/ni/licenses directory.

U.S. Government Restricted Rights

If you are an agency, department, or other entity of the United States Government ("Government"), the use, duplication, reproduction, release, modification, disclosure or transfer of the technical data included in this manual is governed by the Restricted Rights provisions under Federal Acquisition Regulation 52.227-14 for civilian agencies and Defense Federal Acquisition Regulation Supplement Section 252.227-7014 and 252.227-7015 for military agencies.

IVI Foundation Copyright Notice

Content from the IVI specifications reproduced with permission from the IVI Foundation.

The IVI Foundation and its member companies make no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The IVI Foundation and its member companies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Trademarks

Refer to the NI Trademarks and Logo Guidelines at ni.com/trademarks for information on NI trademarks. Other product and company names mentioned herein are trademarks or trade names of their respective companies.

Patents

For patents covering the NI products/technology, refer to the NI Patent Notice at ni.com/patents.

378696A-01