mcCCPSetSessionStatus
- Updated2023-02-21
- 1 minute(s) read
mcCCPSetSessionStatus
Purpose
Updates the ECU with the current state of the calibration session (CCP only).
Format
| mcTypeStatus | mcCCPSetSessionStatus(
|
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:
| Bit | Name | Description |
|---|---|---|
| 0 | CAL | Calibration data initialized. |
| 1 | DAQ | DAQ list(s) initialized. |
| 2 | RESUME | Request to save DAQ set-up during shutdown in CCP slave. CCP slave automatically restarts DAQ after start-up. |
| 3 | Reserved | — |
| 4 | Reserved | — |
| 5 | Reserved | — |
| 6 | STORE | Request to save calibration data during shut-down in CCP slave. |
| 7 | RUN | Session in progress. |