From Friday, April 19th (11:00 PM CDT) through Saturday, April 20th (2:00 PM CDT), 2024, ni.com will undergo system upgrades that may result in temporary service interruption.
We appreciate your patience as we improve our online experience.
From Friday, April 19th (11:00 PM CDT) through Saturday, April 20th (2:00 PM CDT), 2024, ni.com will undergo system upgrades that may result in temporary service interruption.
We appreciate your patience as we improve our online experience.
June 2018
This file contains information about the ECU Measurement and Calibration Toolkit software.
Supported Software and Hardware
Additional Programming Topics and Known Issues
Additional Topics and Known Issues for use of XCP/CCP Custom Device for NI VeriStand
Automating the Installation of NI Products
Using NI Software with Microsoft Windows 10
Using NI Software with Microsoft Windows 8.1
Using NI-XNET with the ECU Measurement and Calibration Toolkit
The ECU Measurement and Calibration Toolkit provides full-featured APIs, plus tools for configuration and analysis within NI MAX. The ECU Measurement and Calibration APIs enable you to develop applications that are customized to your test and simulation requirements.
The ECU Measurement and Calibration Toolkit software supports Windows 10/8.11/7 SP12.
1 NI software installs VC2015 Runtime and .NET 4.6.2. Windows 8.1 and Windows Server 2012 R2 require Microsoft updates to support these items. Refer to Microsoft KB2919442 and KB2919355 for more information about how to install these updates.
2 NI software is signed with a SHA-256 certificate. Windows 7 SP1, Windows Embedded Standard 7 SP1, and Windows Server 2008 R2 SP1 require Microsoft updates to support SHA-256. Refer to Microsoft KB3033929 for more information about how to install this security update.
Note In 2016 National Instruments dropped support for Windows Vista, Windows XP, Windows Server 2003, and installations of Windows 7 without any service packs. ECU Measurement and Calibration Toolkit 18.0 will not install or run on an unsupported OS. You cannot deploy or distribute applications that use ECU Measurement and Calibration Toolkit 18.0 to an unsupported OS. Additionally, after installing ECU Measurement and Calibration Toolkit 18.0, you cannot use any installers built on this computer with any version of LabVIEW, LabWindows™/CVI™, NI TestStand™, or Measurement Studio on an unsupported OS.
For more information about the changes to our OS support, refer to KB 79UC78LS, Why Does My NI ADE Installer Fail on Windows XP/Vista and Windows Server 2003?.
Note Support for Windows 32-bit operating systems may require disabling physical address extension (PAE). To learn how this might affect your system and what actions you might need to take, visit ni.com/info and enter the Info Code PAESupport.
This version of the ECU Measurement and Calibration Toolkit supports the following application software versions, including service packs.
| Application Software | Versions Supported by ECU Measurement and Calibration Toolkit 18.0 |
|---|---|
| LabVIEW | 2015, 2016, 2017, 2018 |
| LabVIEW Real-Time (RT) | 2015, 2016, 2017, 2018 |
| LabWindows™/CVI™ | 2012 and later |
| NI VeriStand | 2015, 2016, 2017 |
| Microsoft Visual C/C++ | 2008 and later |
Note The ECU Measurement and Calibration Toolkit software does not support LabWindows™/CVI™ Real-Time Module.
This version of the ECU Measurement and Calibration Toolkit software supports the following software and hardware:
Note The ECU Measurement and Calibration Toolkit software supports only National Instruments CAN hardware products.
For information about software for CAN products from other vendors, refer to the documentation you received with those products.
Before installing the ECU Measurement and Calibration Toolkit software, log on as Administrator or as a user with Administrator privileges. The ECU Measurement and Calibration Toolkit software setup program must have Administrator privileges because the program modifies the configuration registry of your system. Complete the following steps to install the ECU M&C Toolkit software:
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 CCP Test ECU simulation using the ASAM 2MC CCPECU.A2L file.
Most of the examples can be used with the XCP Test ECU simulation. In that case, please, use the XCPECU.A2L file and the related protocol tokens "XCP:CAN", "XCP:UDP", or "XCP:TCP".
LabVIEW users using CCP can find the ECU simulator, seed-key DLL, and corresponding A2L file at <National Instruments>\<LabVIEW>\Examples\ECUMC.
LabVIEW users using XCP can find the ECU simulator, seed-key DLL, and corresponding A2L file at <National Instruments>\<LabVIEW>\Examples\ECUMC.
MS VC users using CCP can find the ECU simulator, seed-key DLL, and corresponding A2L file at \Users\Public\Documents\National Instruments\ECU Measurement and Calibration Toolkit\Examples\MS Visual C\CCPECU.
MS VC users using XCP can find the ECU simulator, seed-key DLL, and corresponding A2L file at \Users\Public\Documents\National Instruments\ECU Measurement and Calibration Toolkit\Examples\MS Visual C\XCPECU.
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.
Visit ni.com/security to view and subscribe to receive security notifications about NI products. Visit ni.com/critical-updates for information about critical updates from NI.
The ECU Measurement and Calibration Toolkit 18.0 release adds the following features:
The ECU Measurement and Calibration Toolkit 15.0 release adds the following features:
The ECU Measurement and Calibration Toolkit 14.0 release adds the following features:
ECU Measurement and Calibration Toolkit 18.0 supports CCP Version 2.1.
ECU Measurement and Calibration Toolkit 18.0 does support symbolic conversion tables for reading only. Refer to mcDoubleToText for further information.
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 National Instruments 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 Simulator (DemoECU) is not supported under CompactRIO.
The Basic Examples and some advanced examples are not supported under cRIO using XCP/TCP and XCP/UDP. To use those examples, you need to modify the communication parameters like the IP Address.
The behavior of mcDAQListInitialize has changed. It will now return an error (NoMoreDAQLists) if the requested DAQ list cannot be assigned. Before, ECU MC would try to assign a different DAQ list automatically, but this was considered inadequate as the new DAQ list might have different properties than the requested one and thus cause undesired behavior.
ECU Measurement and Calibration Toolkit 18.0 supports NI VeriStand 2015, 2016 and 2017.
Refer to the XCP/CCP Custom Device online help for information about using the NI XCP/CCP Custom device with VeriStand.
Upgrade Note: If you are upgrading your XCP/CCP Custom Device from the already-installed National Instruments Developer Zone download, you need to clear the XCP/CCP controls from the NI VeriStand project temporary screen files directory. VeriStand projects created with an older VeriStand version must be converted to the new version by loading the project in System Explorer and saving it. When loading an older project into a newer VeriStand revision, a message shows up informing about missing Driver VI files. This message can be ignored and skipped.
Upgrading Existing VeriStand System Definitions from a Previous Custom Device Version: You must migrate system definitions created with an earlier version of the XCP/CCP custom device to the current version before you can use them. Therefore, open and save the system definition file in the System Explorer.
The CCP/XCP on CAN communication introduces higher busloads on the CAN network: If you are using CCP or XCP on CAN, the NI VeriStand Custom Device can add flexible configurations for reading and writing Characteristics and Measurements from the ECU. It is allowed running multiple Characteristic as well as Measurement read or write tasks in parallel. If you set up such a complex system, every task introduces some amount of busload onto the CAN network, because those CCP/XCP commands are based on a handshake protocol. If you run the CCP/XCP on CAN a protocol to its limits, the introduced busload on the CAN network increases significantly, and the ECU may not respond in the predefined time anymore. The reason is that there may not be enough free network bandwidth. In such cases, we recommended analyzing the CAN busload on the CAN network and trying to keep CAN traffic below values of 60% to 70%, to keep the network in an operable state. A typical indicator of running into such CCP/XCP on CAN protocol limits is a timeout error when executing a Characteristic/Measurement read or write operation. Therefore, we recommend checking the XCP/CCP Custom Device error status variable, whether the error 0xFFFB67FE "A timeout occurred waiting for a response from the ECU" occurs.
The following items are a subset of issues fixed in ECU Measurement and Calibration Toolkit. If you have a CAR ID, you can search to validate that the issue has been fixed. This is not an exhaustive list of issues fixed in the current version of the ECU Measurement and Calibration Toolkit.
Issues fixed between ECU Measurement and Calibration Toolkit 15.0 and ECU Measurement and Calibration Toolkit 18.0.
| Bug ID | Fixed Issue |
|---|---|
| 533852 | XCP and CCP Trace will show incorrect byte length of message. |
| 580435 | "MC DAQ Read.vi" returns stale data warning 301005 even when fresh data has been received. |
| 580437 | "MC DAQ Read.vi" reports error when NumberOfSamplesToRead = 0, preventing "MC DAQ Start Stop.vi" from being called implicitly |
| 641455 | "MC Read NChan NSamp Time Dbl.vi" does not read configured number of channels - XCP on Ethernet. |
| 643072 | NChan NSamp Time-Value XY Array missing occasional frames. |
| 657509 | Custom device, default value for Connect not behaving as documented |
| 659618 | Custom device shows incorrect connection status when "Enable Measurement" channel is set to false. |
The ECU Measurement and Calibration Toolkit Help is the primary reference document for this product. 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.
To open the ECU Measurement and Calibration Toolkit Help, go to: Program Files (x86)»National Instruments»ECU Measurement and Calibration Toolkit»Documentation.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.
If the NI product you are installing uses Microsoft .NET 4.0, the .NET installer may run before any NI software installs and may require a reboot before the installation of NI software begins. To avoid a .NET reboot, install .NET 4.0 separately before you install NI software.
For more information about automating the installation of NI products, refer to the following KnowledgeBase articles:
Microsoft Windows 10 is the latest version of the Windows operating system and features significant changes compared to previous versions. Windows 10 introduces several new capabilities and also combines features from both Windows 7 and Windows 8. For more information about NI support for Windows 10, visit ni.com/windows10.
When you install NI software on Microsoft Windows 8.1, you will notice a few additional tiles in the Apps view, including shortcuts to NI application software products such as NI LabVIEW, Measurement & Automation Explorer (NI MAX), and NI Launcher. For more information about NI support for Windows 8.1, visit ni.com/windows8.
If you are using NI hardware that is supported by NI-XNET, it is recommended that you use NI-XNET 18.0 with ECU Measurement and Calibration Toolkit 18.0.
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.
Copyright
© 2009–2018 National Instruments. 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.
377542A-01