mcCCPSetSessionStatus

ECU Measurement and Calibration Toolkit Help

Edition Date: October 2018

Part Number: 371602T-01

»View Product Info
Download Help (Windows Only)

Purpose

Updates the ECU with the current state of the calibration session (CCP only).

Format

mcTypeStatus mcCCPSetSessionStatus(
mcTypeTaskRef ECURefNum,
u8 SessionStatus);

Input

ECURefNum

ECURefNum is the task reference which links to the selected ECU. This reference is originally returned from mcECUSelectEx.

SessionStatus

SessionStatus contains the new status to be set in the ECU.

Output

Return Value

The return value indicates the status of the function call as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.

Use the mcStatusToString function of the ECU M&C API to obtain a descriptive string for the return value.

Description

mcCCPSetSessionStatus implements the CCP command SET_S_STATUS and is used to keep the ECU informed about the current state of the calibration session. The session status bits of an ECU can be read and written. Possible conditions are: reset on power-up, session log-off, and in applicable error conditions. The calibration session status is organized as a bit mask with the following assignment:

BitNameDescription
0CALCalibration data initialized.
1DAQDAQ list(s) initialized.
2RESUMERequest to save DAQ set-up during shutdown in CCP slave. CCP slave automatically restarts DAQ after start-up.
3Reserved
4Reserved
5Reserved
6STORERequest to save calibration data during shut-down in CCP slave.
7RUNSession in progress.

WAS THIS ARTICLE HELPFUL?

Not Helpful