foxBMS - Unit Tests  1.6.0
The foxBMS Unit Tests API Documentation
bender_ir155.c File Reference

Driver for the insulation monitoring. More...

#include "bender_ir155.h"
#include "bender_ir155_cfg.h"
#include "bender_ir155_helper.h"
#include "database.h"
#include "fram.h"
#include "io.h"
#include <stdbool.h>
#include <stdint.h>
Include dependency graph for bender_ir155.c:

Go to the source code of this file.

Macros

#define IR155_MINIMUM_INSULATION_RESISTANCE_kOhm   (0u)
 

Functions

static IMD_FSM_STATES_e IR155_InitializeModule (void)
 
static IMD_FSM_STATES_e IR155_MeasureInsulation (DATA_BLOCK_INSULATION_MONITORING_s *pTableInsulationMonitoring)
 
IMD_FSM_STATES_e IMD_ProcessInitializationState (void)
 Processes the initialization state. More...
 
IMD_FSM_STATES_e IMD_ProcessEnableState (void)
 Processes the IMD enable state. More...
 
IMD_FSM_STATES_e IMD_ProcessRunningState (DATA_BLOCK_INSULATION_MONITORING_s *pTableInsulationMonitoring)
 Processes the running state. More...
 
IMD_FSM_STATES_e IMD_ProcessShutdownState (void)
 Processes the shutdown state. More...
 

Detailed Description

Driver for the insulation monitoring.

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:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. 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.
  3. 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
2014-02-11 (date of creation)
Updated
2023-10-12 (date of last update)
Version
v1.6.0
Prefix
IR155

Definition in file bender_ir155.c.

Macro Definition Documentation

◆ IR155_MINIMUM_INSULATION_RESISTANCE_kOhm

#define IR155_MINIMUM_INSULATION_RESISTANCE_kOhm   (0u)

Duty cycle - resistance table for Bender IR155-3204 (Art. No. B91068139)

dc resistance/kOhm description
100 -63,16 not valid
98 -38,71 invalid
95 =0,00 invalid
95 >0,00 shortcut
90 70,59 very low resistance
80 240,00 low resistance
70 461,54 low resistance
60 763,64 lowmid resistance
50 1200,00 highmid resistance
40 1885,71 highmid resistance
30 3120,00 high resistance
20 6000,00 high resistance
10 20400,00 very high resistance
5 oo very high resistance
3 -55200,00 invalid
0 -22800,00 invalid

Definition at line 93 of file bender_ir155.c.

Function Documentation

◆ IMD_ProcessEnableState()

IMD_FSM_STATES_e IMD_ProcessEnableState ( void  )

Processes the IMD enable state.

This function needs to be implemented in the dedicated driver. This function enables the actual IMD device to start the insulation measurement. Functionality need to be fulfilled after one call.

Returns
IMD_FSM_STATE_RUNNING if startup has been completed. Returns IMD_FSM_STATE_ERROR if an error is detected that prohibits a working IMD driver.

Definition at line 214 of file bender_ir155.c.

Here is the call graph for this function:

◆ IMD_ProcessInitializationState()

IMD_FSM_STATES_e IMD_ProcessInitializationState ( void  )

Processes the initialization state.

This function needs to be implemented in the dedicated driver. This function initializes the required SW modules and peripherals but does not start the actual IMD measurement.

Returns
IMD_FSM_STATE_INITIALIZATION if initialization not finished and another call is required. IMD_FSM_STATE_IMD_ENABLE if initialization is finished and IMD_FSM_STATE_ERROR if an error is detected that prohibits a working IMD driver.

Definition at line 210 of file bender_ir155.c.

Here is the call graph for this function:

◆ IMD_ProcessRunningState()

IMD_FSM_STATES_e IMD_ProcessRunningState ( DATA_BLOCK_INSULATION_MONITORING_s pTableInsulationMonitoring)

Processes the running state.

This function needs to be implemented in the dedicated driver

Parameters
pTableInsulationMonitoringpointer to insulation monitoring database entry
Returns
IMD_FSM_STATE_RUNNING if measurement works as expected, otherwise IMD_FSM_STATE_ERROR if an error is detected that prohibits a further execution of the IMD driver.

Definition at line 220 of file bender_ir155.c.

Here is the call graph for this function:

◆ IMD_ProcessShutdownState()

IMD_FSM_STATES_e IMD_ProcessShutdownState ( void  )

Processes the shutdown state.

This function needs to be implemented in the dedicated driver. This function disables the actual IMD device to stop the insulation measurement.

Returns
IMD_FSM_STATE_SHUTDOWN if shutdown state is not finished and another call is required. IMD_FSM_STATE_IMD_ENABLE if shut down has been completed and IMD_FSM_STATE_ERROR if an error is detected that prohibits a working IMD driver.

Definition at line 225 of file bender_ir155.c.

Here is the call graph for this function:

◆ IR155_InitializeModule()

static IMD_FSM_STATES_e IR155_InitializeModule ( void  )
static

Initialize function for Bender IR155 driver

Definition at line 107 of file bender_ir155.c.

Here is the call graph for this function:

◆ IR155_MeasureInsulation()

static IMD_FSM_STATES_e IR155_MeasureInsulation ( DATA_BLOCK_INSULATION_MONITORING_s pTableInsulationMonitoring)
static

Acquire measurement results from Bender IR155 and write them into the database

Definition at line 113 of file bender_ir155.c.

Here is the call graph for this function: