UM0563 datasheet(9/46 Pages) STMICROELECTRONICS

9 / 46 page

UM0563

Architecture of the L9952GXP software driver

9/46

3.2

L9952GXP software driver error detection

Errors are detected in the software driver by checking library usage at runtime (see

flowchart in Figure 5).

When the L9952DRV_DEV_ERROR_DETECT preprocessor switch is defined, the

L9952GXP software driver function checks the initialization status of the library and the

value range of the input parameters at runtime. If an error is detected, the

L9952drv_ReportError() function is called.

Inside the L9952drv_ReportError() function, the

L9952DRV_DEV_ERROR_DETECT_EXEC_CONTINUE switch allows the user to define

the behavior of the library function.

If the L9952DRV_DEV_ERROR_DETECT_EXEC_CONTINUE switch is not activated, the

library function is terminated immediately.

If the L9952DRV_DEV_ERROR_DETECT_EXEC_CONTINUE switch is defined, the

function body of the library function is executed after exiting the L9952drv_ReportError()

function.

Figure 5.

Error detection flowchart of the software driver

L9952DRV_DEV_

ERROR_DETECT

defined ?

Error found ?

L9952DRV_DEV_ERROR_

DETECT_EXEC_CONTINUE

defined?

Check input

parameters

Return

Function body

Yes

Start of

L9952GXP

function

L9952drv_Report

Error ()

UM0563 Datenblatt(PDF) 9 Page - STMicroelectronics