Main driver state machine for insulation monitoring driver. More...

#include "imd.h"
#include "diag.h"
#include "os.h"

Include dependency graph for imd.c:

Data Structures
struct	IMD_INFORMATION_s

struct	IMD_STATE_s

Macros
#define	IMD_FSM_SHORT_TIME (1u)

Enumerations
enum	IMD_FSM_SUBSTATES_e { IMD_FSM_SUBSTATE_DUMMY , IMD_FSM_SUBSTATE_ENTRY , IMD_FSM_SUBSTATE_INITIALIZATION_0 , IMD_FSM_SUBSTATE_INITIALIZATION_1 , IMD_FSM_SUBSTATE_INITIALIZATION_EXIT , IMD_FSM_SUBSTATE_RUNNING_0 , IMD_FSM_SUBSTATE_RUNNING_1 , IMD_FSM_SUBSTATE_RUNNING_2 }

enum	IMD_CHECK_MULTIPLE_CALLS_e { IMD_MULTIPLE_CALLS_NO , IMD_MULTIPLE_CALLS_YES }

Functions
static IMD_RETURN_TYPE_e	IMD_SetStateRequest (IMD_STATE_s *pImdState, IMD_STATE_REQUEST_e stateRequest)
	sets the current state request of the state variable imd_state. More...

static IMD_RETURN_TYPE_e	IMD_CheckStateRequest (IMD_STATE_s *pImdState, IMD_STATE_REQUEST_e stateRequest)
	checks the state requests that are made. More...

static IMD_STATE_REQUEST_e	IMD_TransferStateRequest (IMD_STATE_s *pImdState)
	transfers the current state request to the state machine. More...

static IMD_CHECK_MULTIPLE_CALLS_e	IMD_CheckMultipleCalls (IMD_STATE_s *pImdState)
	check for multiple calls of state machine trigger function More...

static void	IMD_SetState (IMD_STATE_s *pImdState, IMD_FSM_STATES_e nextState, IMD_FSM_SUBSTATES_e nextSubstate, uint16_t idleTime)
	Sets the next state, the next substate and the timer value of the state variable. More...

static void	IMD_SetSubstate (IMD_STATE_s *pImdState, IMD_FSM_SUBSTATES_e nextSubstate, uint16_t idleTime)
	Sets the next substate and the timer value of the state variable. More...

static STD_RETURN_TYPE_e	IMD_RunStateMachine (IMD_STATE_s *pImdState)
	Defines the state transitions. More...

static STD_RETURN_TYPE_e	IMD_EvaluateInsulationMeasurement (DATA_BLOCK_INSULATION_MONITORING_s *pTableInsulationMonitoring)
	Evaluates measurement perform by IMD driver. More...

IMD_RETURN_TYPE_e	IMD_RequestInitialization (void)
	Request initialization of IMD statemachine. More...

IMD_RETURN_TYPE_e	IMD_RequestInsulationMeasurement (void)
	Request to activate the actual IMD measurement. More...

IMD_RETURN_TYPE_e	IMD_RequestMeasurementStop (void)
	Request to deactivate the actual IMD measurement. More...

bool	IMD_GetInitializationState (void)
	Gets the initialization state. More...

STD_RETURN_TYPE_e	IMD_Trigger (void)
	trigger function for the IMD driver state machine. More...

Variables
static DATA_BLOCK_INSULATION_MONITORING_s	imd_tableInsulationMonitoring

static IMD_STATE_s	imd_state

Detailed Description

Main driver state machine for insulation monitoring driver.

Copyright: © 2010 - 2022, Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V. All rights reserved.

SPDX-License-Identifier: BSD-3-Clause

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

We kindly request you to use one or more of the following phrases to refer to foxBMS in your hardware, software, documentation or advertising materials:

″This product uses parts of foxBMS®″
″This product includes parts of foxBMS®″
″This product is derived from foxBMS®″

Author: foxBMS Team

Date: 2021-11-04 (date of creation)

Updated: 2022-10-27 (date of last update)

Version: v1.4.1

Prefix: IMD

This superimposed state machine initializes, enables and disables the selected Insulation Monitoring Device. Furthermore, the measurement results are evaluated and saved in the database. Requests are used to control the IMD state machine and with that the behavior of the IMDs.

Definition in file imd.c.

Macro Definition Documentation

◆ IMD_FSM_SHORT_TIME

#define IMD_FSM_SHORT_TIME (1u)

state machine short time definition in IMD_Trigger calls until next state is processed

Definition at line 72 of file imd.c.

Enumeration Type Documentation

◆ IMD_CHECK_MULTIPLE_CALLS_e

enum IMD_CHECK_MULTIPLE_CALLS_e

Symbolic names to check for multiple calls of IMD_Trigger

Enumerator
IMD_MULTIPLE_CALLS_NO	no multiple calls, OK
IMD_MULTIPLE_CALLS_YES	multiple calls, not OK

Definition at line 87 of file imd.c.

◆ IMD_FSM_SUBSTATES_e

enum IMD_FSM_SUBSTATES_e

Substates of the state machine

Enumerator
IMD_FSM_SUBSTATE_DUMMY	dummy state - always the first substate
IMD_FSM_SUBSTATE_ENTRY	entry state - always the second substate
IMD_FSM_SUBSTATE_INITIALIZATION_0	fist initialization substate
IMD_FSM_SUBSTATE_INITIALIZATION_1	second initialization substate
IMD_FSM_SUBSTATE_INITIALIZATION_EXIT	last initialization substate
IMD_FSM_SUBSTATE_RUNNING_0	fist running substate
IMD_FSM_SUBSTATE_RUNNING_1	second running substate
IMD_FSM_SUBSTATE_RUNNING_2	third running substate

Definition at line 75 of file imd.c.

Function Documentation

◆ IMD_CheckMultipleCalls()

static IMD_CHECK_MULTIPLE_CALLS_e IMD_CheckMultipleCalls ( IMD_STATE_s * pImdState )

static

check for multiple calls of state machine trigger function

The trigger function is not reentrant, which means it cannot be called multiple times. This functions increments the triggerEntry counter once and must be called each time the trigger function is called. If triggerEntry is greater than one, there were multiple calls. For this function to work, triggerEntry must be decremented each time the trigger function is called, even if no processing do because the timer is non-zero.

Parameters

[in,out] pImdState pointer to state variable of IMD state machine

Returns: IMD_MULTIPLE_CALLS_YES if there were multiple calls, IMD_MULTIPLE_CALLS_NO otherwise

Definition at line 287 of file imd.c.

Here is the call graph for this function:

◆ IMD_CheckStateRequest()

static IMD_RETURN_TYPE_e IMD_CheckStateRequest	(	IMD_STATE_s *	pImdState,
		IMD_STATE_REQUEST_e	stateRequest
	)

static

checks the state requests that are made.

This function checks the validity of the state requests. The results of the checked state request is returned immediately.

Parameters

[in]	stateRequest	state request to be checked
[in,out]	pImdState	pointer to state variable of IMD state machine

Returns: result of the state request that was made

Definition at line 249 of file imd.c.

◆ IMD_EvaluateInsulationMeasurement()

static STD_RETURN_TYPE_e IMD_EvaluateInsulationMeasurement ( DATA_BLOCK_INSULATION_MONITORING_s * pTableInsulationMonitoring )

static

Evaluates measurement perform by IMD driver.

This function evaluates the insulation measurement performed by the selected IMD driver and updates the database entry.

Parameters

[in,out] pTableInsulationMonitoring pointer to insulation monitoring database entry

Returns: Always IMD_REQUEST_OK

Definition at line 458 of file imd.c.

Here is the call graph for this function:

◆ IMD_GetInitializationState()

bool IMD_GetInitializationState ( void )

Gets the initialization state.

This function is used for getting the IMD initialization state.

Returns: true if statemachine initialized, otherwise false

Definition at line 521 of file imd.c.

◆ IMD_RequestInitialization()

IMD_RETURN_TYPE_e IMD_RequestInitialization ( void )

Request initialization of IMD statemachine.

Returns: Always IMD_REQUEST_OK

Definition at line 509 of file imd.c.

Here is the call graph for this function:

◆ IMD_RequestInsulationMeasurement()

IMD_RETURN_TYPE_e IMD_RequestInsulationMeasurement ( void )

Request to activate the actual IMD measurement.

Returns: Always IMD_REQUEST_OK

Definition at line 513 of file imd.c.

Here is the call graph for this function:

◆ IMD_RequestMeasurementStop()

IMD_RETURN_TYPE_e IMD_RequestMeasurementStop ( void )

Request to deactivate the actual IMD measurement.

Returns: Always IMD_REQUEST_OK

Definition at line 517 of file imd.c.

Here is the call graph for this function:

◆ IMD_RunStateMachine()

static STD_RETURN_TYPE_e IMD_RunStateMachine ( IMD_STATE_s * pImdState )

static

Defines the state transitions.

This function contains the implementation of the state machine, i.e., the sequence of states and substates. It is called by the trigger function every time the state machine timer has a non-zero value.

Parameters

[in,out] pImdState state of the example state machine

Returns: Always STD_OK

Definition at line 348 of file imd.c.

Here is the call graph for this function:

◆ IMD_SetState()

static void IMD_SetState	(	IMD_STATE_s *	pImdState,
		IMD_FSM_STATES_e	nextState,
		IMD_FSM_SUBSTATES_e	nextSubstate,
		uint16_t	idleTime
	)

static

Sets the next state, the next substate and the timer value of the state variable.

Parameters

[in,out]	pImdState	state of the example state machine
[in]	nextState	state to be transferred into
[in]	nextSubstate	substate to be transferred into
[in]	idleTime	wait time for the state machine

Definition at line 300 of file imd.c.

Here is the call graph for this function:

◆ IMD_SetStateRequest()

static IMD_RETURN_TYPE_e IMD_SetStateRequest	(	IMD_STATE_s *	pImdState,
		IMD_STATE_REQUEST_e	stateRequest
	)

static

sets the current state request of the state variable imd_state.

This function is used to make a state request to the state machine, e.g, initialize state machine or shut-down state machine. It calls IMD_CheckStateRequest() to check if the request is valid. The state request is rejected if is not valid. The result of the check is returned immediately, so that the requester can act in case it made a non-valid state request.

Parameters

[in]	stateRequest	state request to set
[in,out]	pImdState	pointer to state variable of IMD state machine

Returns: OK if request has been accepted, otherwise error reason

Definition at line 233 of file imd.c.

Here is the call graph for this function:

◆ IMD_SetSubstate()

static void IMD_SetSubstate	(	IMD_STATE_s *	pImdState,
		IMD_FSM_SUBSTATES_e	nextSubstate,
		uint16_t	idleTime
	)

static

Sets the next substate and the timer value of the state variable.

Parameters

[in,out]	pImdState	state of the example state machine
[in]	nextSubstate	substate to be transferred into
[in]	idleTime	wait time for the state machine

Definition at line 338 of file imd.c.

◆ IMD_TransferStateRequest()

static IMD_STATE_REQUEST_e IMD_TransferStateRequest ( IMD_STATE_s * pImdState )

static

transfers the current state request to the state machine.

This function takes the current state request from imd_state transfers it to the state machine. It resets the value from imd_state to IMD_STATE_NO_REQUEST

Parameters

[in,out] pImdState pointer to state variable of IMD state machine

Returns: current state request

Definition at line 278 of file imd.c.

Here is the call graph for this function:

◆ IMD_Trigger()

STD_RETURN_TYPE_e IMD_Trigger ( void )

trigger function for the IMD driver state machine.

This function contains the sequence of events in the IMD state machine. It must be called time-triggered, every 100ms.

Returns: returns STD_OK if trigger called successfully

Definition at line 525 of file imd.c.

Here is the call graph for this function:

Variable Documentation

◆ imd_state

IMD_STATE_s imd_state

static

Initial value:

= {
    .timer                                 = 0u,
    .triggerEntry                          = 0u,
    .nextState                             = IMD_FSM_STATE_DUMMY,
    .stateRequest                          = IMD_STATE_NO_REQUEST,
    .currentState                          = IMD_FSM_STATE_HAS_NEVER_RUN,
    .previousState                         = IMD_FSM_STATE_DUMMY,
    .nextSubstate                          = IMD_FSM_SUBSTATE_DUMMY,
    .currentSubstate                       = IMD_FSM_SUBSTATE_DUMMY,
    .previousSubstate                      = IMD_FSM_SUBSTATE_DUMMY,
    .information.isStatemachineInitialized = false,
    .information.switchImdDeviceOn         = false,
    .pTableImd                             = &imd_tableInsulationMonitoring,
}

global IMD state

Definition at line 119 of file imd.c.

◆ imd_tableInsulationMonitoring

DATA_BLOCK_INSULATION_MONITORING_s imd_tableInsulationMonitoring

static

Initial value:

= {

.header.uniqueId = DATA_BLOCK_ID_INSULATION_MONITORING}

DATA_BLOCK_ID_INSULATION_MONITORING

@ DATA_BLOCK_ID_INSULATION_MONITORING

Definition: database_cfg.h:104

Definition at line 115 of file imd.c.

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ IMD_FSM_SHORT_TIME

Enumeration Type Documentation

◆ IMD_CHECK_MULTIPLE_CALLS_e

◆ IMD_FSM_SUBSTATES_e

Function Documentation

◆ IMD_CheckMultipleCalls()

◆ IMD_CheckStateRequest()

◆ IMD_EvaluateInsulationMeasurement()

◆ IMD_GetInitializationState()

◆ IMD_RequestInitialization()

◆ IMD_RequestInsulationMeasurement()

◆ IMD_RequestMeasurementStop()

◆ IMD_RunStateMachine()

◆ IMD_SetState()

◆ IMD_SetStateRequest()

◆ IMD_SetSubstate()

◆ IMD_TransferStateRequest()

◆ IMD_Trigger()

Variable Documentation

◆ imd_state

◆ imd_tableInsulationMonitoring