October 2022
This file contains installation instructions and compatibility information for ECU Measurement and Calibration Toolkit 2022 Q4.
You can find more release information on ni.com.
Product Security and Critical Updates
Supported Hardware and Software
XCP/CCP Custom Device for NI VeriStand
Using NI-XNET with the ECU Measurement and Calibration Toolkit
Additional Programming Topics and Known Issues
Automating the Installation of NI Products
Using NI Software with Microsoft Windows 11
Unsupported Windows Operating Systems
The ECU Measurement and Calibration Toolkit provides full-featured APIs, plus tools for viewing ASAM A2L database files and analyzing CCP and XCP communication. The ECU Measurement and Calibration APIs enable you to develop applications that are customized to your test and simulation requirements.
ECU Measurement and Calibration Toolkit 2022 Q4 supports the following operating systems:
Note ECU Measurement and Calibration Toolkit no longer supports any 32-bit Windows operating system. Refer to Unsupported Windows Operating Systems for more information about support for Microsoft Windows OSes.
ECU Measurement and Calibration Toolkit 2022 Q4 supports the following application software versions, including service packs. If you are not using NI application software, refer to Microsoft Visual Studio Support.
| Application Software | Versions Supported by ECU Measurement and Calibration Toolkit 2022 Q4 |
|---|---|
| LabVIEW | 2019 and later |
| LabVIEW Real-Time Module | 2019 and later |
| LabWindows™/CVI™ | 2017 and later |
| NI VeriStand | 2019 R3, 2020 R4, and 2021 R2 |
| Microsoft Visual C/C++ | 2008 and later |
Note ECU Measurement and Calibration Toolkit software does not support LabWindows™/CVI™ Real-Time Module.
Download the ECU Measurement and Calibration Toolkit installer from ni.com/downloads. NI software includes NI Package Manager to handle the installation. Refer to the NI Package Manager Manual for more information about installing, removing, and upgrading NI software using NI Package Manager.
After installing your software, you will need to activate it. Activating your software verifies the licenses associated with your NI account, so you can start using your software. You have different options for activation, based on your software and how it was purchased. Please visit ni.com/activate for more information on activation methods.
Notes
The "ECU Measurement and Calibration Toolkit Support for LabVIEW" package supports applications using ECU Measurement and Calibration Toolkit with LabVIEW 2022 or later. When installing ECU Measurement and Calibration Toolkit, this package will be recommended if you have already installed LabVIEW 2022 or later and installs to the LVAddons directory.
LVAddons directory location: C:\Program Files\NI\LVAddons
Visit ni.com/security to view and subscribe to receive security notifications about NI products. For information about critical updates from NI, refer to Available Critical and Security Updates for NI Software.
The following list details the hardware models supported in ECU Measurement and Calibration Toolkit 2022 Q4.
1 You can address NI-XNET Automotive Ethernet devices using their assigned IP addresses. To use a specific interface name (e.g., ENET1) together with a custom IP configuration, you can use an XNET IP Stack from ECUMC. The IP Stack feature requires NI-XNET 20.1 or later.
Note ECU Measurement and Calibration Toolkit software supports only NI Automotive Ethernet and CAN hardware products. For information about software for Automotive Ethernet and CAN hardware products from other vendors, refer to the documentation you received with those products.
Refer to the ECU Measurement and Calibration Toolkit documentation, accessible from Start»National Instruments»ECU Measurement and Calibration Toolkit Documentation, for information about the ECU Measurement and Calibration Toolkit.
The help includes an introduction to the CAN Calibration Protocol (CCP) and Measurement and Calibration Protocol (XCP). It also explains how to get started with application development and includes a complete reference for all ECU Measurement and Calibration Toolkit functions.
The ECU Measurement and Calibration Toolkit software simulates two types of ECUs. All ECU Measurement and Calibration Toolkit examples are preconfigured to communicate with the ECUMC Demo ECU XCP simulation using the ASAM 2MC XcpECU.a2l file.
Most of the examples can be used with the ECUMC Demo ECU CCP simulation. In that case, please, use the CCPECU.A2L file and the related protocol token "CCP:CANx".
LabVIEW users can find the ECU simulators, seedkey DLLs, and corresponding A2L files at <National Instruments>\<LabVIEW xxxx>\examples\ECUMC. Please, use the "XCPECU.llb\ECUMC Demo ECU XCP.vi" or "CCPECU.llb\ECUMC Demo ECU CCP.vi".
Microsoft Visual C/C++ and LabWindows/CVI users can find the ECUMC Demo ECU simulators (only 32-bit), seedkey DLLs, and corresponding A2L files at
LabWindows/CVI users may refer to copies of the A2L files and seedkey DLLs provided within the CVI examples folder.
The XCP/XCP/CCP Custom Device for NI VeriStand is no longer included with the ECU Measurement and Calibration Toolkit installer.
To use the ECU Measurement and Calibration Toolkit on a LabVIEW RT system, you must download your ASAM 2MC database (*.A2L) file to the RT target. The LabVIEW Real-Time Engine running on a PXI or CompactRIO system supports a File Transfer Protocol (FTP) server. You can access the LabVIEW RT target FTP server using any standard FTP utility for transferring files to and from the hard drive. For further information about how to download your A2L file to the RT target, refer to LabVIEW Real-Time (RT) Configuration in the ECU Measurement and Calibration Toolkit Help.
If you are using NI hardware that is supported by NI-XNET, it is recommended that you use NI-XNET 19.5 or later with this version of ECU Measurement and Calibration Toolkit.
CAN FD features are only supported with NI-XNET version 17.0.1 or later.
NI does not recommend cRIO-901x and cRIO-902x targets for CAN FD.
Custom baud rate for CAN in NI VeriStand is only supported with NI-XNET version 18.0 or later.
ECU Measurement and Calibration Toolkit 18.5 supports CCP Version 2.1.
NI-I/O Trace monitors function calls to the ECU Measurement and Calibration Toolkit API. This tool helps in debugging programming problems in the application. To launch this tool, open Tools in MAX, and select NI-I/O Trace. If more than one NI driver is installed on your computer, you can specify which APIs to trace at any time. By default, all installed APIs are enabled. To select the APIs to trace, select Tools»Options, select the View Selections tab, and select the APIs under Installed API Choices.
The following LabVIEW example VIs do not run under LabVIEW Real-Time and LabVIEW Base Development System:
To make these examples run, remove the subVI call from 3DDisplayWrapper.vi in MCCharacteristicsEditors.llb.
If you are using an NI USB-8473 or NI USB-8473s, the ECU Measurement and Calibration Toolkit is based internally on the NI-CAN Frame API. For this reason, the following properties are not available for the GetProperty function:
The LabVIEW project examples for CompactRIO and R-Series are configured for use with NI 985x C-Series only.
The ECU Measurement and Calibration ECU Simulators (ECU MC Demo ECU XCP or CCP) are not supported under CompactRIO.
The Basic Examples and some advanced examples are not supported under cRIO using XCP/TCP and XCP/UDP. To use these examples, you need to modify the communication parameters such as the IP Address.
The behavior of mcDAQListInitialize has changed. It now returns an error (NoMoreDAQLists) if the requested DAQ list cannot be assigned. Prior to this change, ECU MC attempted to automatically assign a different DAQ list, but the new DAQ list might have different properties than the requested one and thus cause undesired behavior.
Property DAQ:XCP:Meas Split Allowed was moved to ECU:XCP:Meas Split Allowed in the Set Property and Get Property VIs. Existing VIs that use this property will continue to work without any changes.
XCP supports only DAQ that has a CAN identifier of DTO_ID.
The following ASAM MCD-2MC (A2L) database features are not supported:
You can automate the installation of most NI products using command-line arguments to suppress some or all of the installer user interface and dialog boxes.
For more information about automating the installation of NI products, refer to Automating an Installer in the NI Package Manager manual.
Microsoft Windows 11 is the latest version of the Windows operating system and features significant changes compared to previous versions. For more information about NI support for Windows 11, refer to NI Product Compatibility for Microsoft Windows 11.
ECU Measurement and Calibration Toolkit no longer supports Windows Vista/XP/7/8.x, Windows Server 2003/2008/2012, or any 32-bit Windows operating system. Versions of this product that ship after May 1, 2021, may not install or execute correctly on these operating systems. For detailed information about NI operating system support, visit https://www.ni.com/r/win32bitsupport.
Copyright
© 2009–2022 National Instruments Corporation. All rights reserved.
Under the copyright laws, 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
You can find end-user license agreements (EULAs) and third-party legal notices in the following locations after installation:
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 appropriate location: Help»Patents in your software, the patents.txt file on your media, or the NI Patent Notice at ni.com/patents.