foxBMS  1.6.0
The foxBMS Battery Management System API Documentation
bender_ir155_cfg.h File Reference

Headers for the configuration for the insulation monitoring. More...

#include "HL_het.h"
#include "imd.h"
#include <stdint.h>
Include dependency graph for bender_ir155_cfg.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define IR155_WAIT_TIME_AFTER_GROUND_ERROR_ms   (25000u)
 
#define IR155_STARTUP_TIME_ms   (2200u)
 
#define IR155_MINIMUM_FREQUENCY_Hz   (5.0f) /* Define a minimum frequency as 0 Hz can not be measured by PWM module */
 
#define IR155_NORMAL_CONDITION_FREQUENCY_Hz   (10.0f)
 
#define IR155_UNDERVOLTAGE_FREQUENCY_Hz   (20.0f)
 
#define IR155_SPEED_START_FREQUENCY_Hz   (30.0f)
 
#define IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz   (40.0f)
 
#define IR155_GROUND_ERROR_FREQUENCY_Hz   (50.0f)
 
#define IR155_MEASUREMENT_INTERVAL_RANGE_Hz   (1.0f)
 
#define IR155_NORMAL_CONDITION_UPPER_FREQUENCY_Hz    (IR155_NORMAL_CONDITION_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_NORMAL_CONDITION_LOWER_FREQUENCY_Hz    (IR155_NORMAL_CONDITION_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_UNDERVOLTAGE_UPPER_FREQUENCY_Hz   (IR155_UNDERVOLTAGE_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_UNDERVOLTAGE_LOWER_FREQUENCY_Hz   (IR155_UNDERVOLTAGE_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_SPEED_START_UPPER_FREQUENCY_Hz   (IR155_SPEED_START_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_SPEED_START_LOWER_FREQUENCY_Hz   (IR155_SPEED_START_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_IMD_DEVICE_ERROR_UPPER_FREQUENCY_Hz    (IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_IMD_DEVICE_ERROR_LOWER_FREQUENCY_Hz    (IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_GROUND_ERROR_UPPER_FREQUENCY_Hz   (IR155_GROUND_ERROR_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_GROUND_ERROR_LOWER_FREQUENCY_Hz   (IR155_GROUND_ERROR_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)
 
#define IR155_SUPPLY_ENABLE_PORT   (hetREG1)
 
#define IR155_SUPPLY_ENABLE_PIN   (25u)
 
#define IR155_DIGITAL_STATUS_INPUT_PORT   (hetREG1)
 
#define IR155_DIGITAL_STATUS_INPUT_PIN   (27u)
 
#define IR155_PWM_SIGNAL_PORT   (hetREG2) /* TODO: this is correct? */
 
#define IR155_PWM_SIGNAL_PIN   (27u) /* TODO: this is correct? */
 

Detailed Description

Headers for the configuration 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
2021-09-17 (date of creation)
Updated
2023-10-12 (date of last update)
Version
v1.6.0
Prefix
IR155

Definition in file bender_ir155_cfg.h.

Macro Definition Documentation

◆ IR155_DIGITAL_STATUS_INPUT_PIN

#define IR155_DIGITAL_STATUS_INPUT_PIN   (27u)

Pin that the input status pin (IM_OK) is connected to.

Definition at line 153 of file bender_ir155_cfg.h.

◆ IR155_DIGITAL_STATUS_INPUT_PORT

#define IR155_DIGITAL_STATUS_INPUT_PORT   (hetREG1)

Register that the input status pin (OHKS) is connected to.

Definition at line 150 of file bender_ir155_cfg.h.

◆ IR155_GROUND_ERROR_FREQUENCY_Hz

#define IR155_GROUND_ERROR_FREQUENCY_Hz   (50.0f)

50 Hz -> Connection fault earth. Fault detected on the earth connection (Kl. 31), PWM 47.5...52.5 %

Definition at line 116 of file bender_ir155_cfg.h.

◆ IR155_GROUND_ERROR_LOWER_FREQUENCY_Hz

#define IR155_GROUND_ERROR_LOWER_FREQUENCY_Hz   (IR155_GROUND_ERROR_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 141 of file bender_ir155_cfg.h.

◆ IR155_GROUND_ERROR_UPPER_FREQUENCY_Hz

#define IR155_GROUND_ERROR_UPPER_FREQUENCY_Hz   (IR155_GROUND_ERROR_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 140 of file bender_ir155_cfg.h.

◆ IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz

#define IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz   (40.0f)

40 Hz -> Device error

Definition at line 112 of file bender_ir155_cfg.h.

◆ IR155_IMD_DEVICE_ERROR_LOWER_FREQUENCY_Hz

#define IR155_IMD_DEVICE_ERROR_LOWER_FREQUENCY_Hz    (IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 137 of file bender_ir155_cfg.h.

◆ IR155_IMD_DEVICE_ERROR_UPPER_FREQUENCY_Hz

#define IR155_IMD_DEVICE_ERROR_UPPER_FREQUENCY_Hz    (IR155_IMD_DEVICE_ERROR_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 135 of file bender_ir155_cfg.h.

◆ IR155_MEASUREMENT_INTERVAL_RANGE_Hz

#define IR155_MEASUREMENT_INTERVAL_RANGE_Hz   (1.0f)

The exact frequency of the pwm signal cannot be measured due to inaccuracies. Thus, a interval is used to detect any deviations. The interval is for example selected as 50 Hz +/- IR155_MEASUREMENT_INTERVAL_RANGE_Hz

Definition at line 121 of file bender_ir155_cfg.h.

◆ IR155_MINIMUM_FREQUENCY_Hz

#define IR155_MINIMUM_FREQUENCY_Hz   (5.0f) /* Define a minimum frequency as 0 Hz can not be measured by PWM module */

0 Hz -> Hi > short-circuit to Ub + (Kl. 15); Low > IMD off or short-circuit to Kl. 31

Definition at line 93 of file bender_ir155_cfg.h.

◆ IR155_NORMAL_CONDITION_FREQUENCY_Hz

#define IR155_NORMAL_CONDITION_FREQUENCY_Hz   (10.0f)

10 Hz -> Normal condition. Insulation measurement DCP starts two seconds after power on; First successful insulation measurement at ? 17.5 s. PWM active 5...95 %

Definition at line 98 of file bender_ir155_cfg.h.

◆ IR155_NORMAL_CONDITION_LOWER_FREQUENCY_Hz

#define IR155_NORMAL_CONDITION_LOWER_FREQUENCY_Hz    (IR155_NORMAL_CONDITION_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 126 of file bender_ir155_cfg.h.

◆ IR155_NORMAL_CONDITION_UPPER_FREQUENCY_Hz

#define IR155_NORMAL_CONDITION_UPPER_FREQUENCY_Hz    (IR155_NORMAL_CONDITION_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 124 of file bender_ir155_cfg.h.

◆ IR155_PWM_SIGNAL_PIN

#define IR155_PWM_SIGNAL_PIN   (27u) /* TODO: this is correct? */

Pin that the input PWM signal pin (IM_PWM) is connected to.

Definition at line 159 of file bender_ir155_cfg.h.

◆ IR155_PWM_SIGNAL_PORT

#define IR155_PWM_SIGNAL_PORT   (hetREG2) /* TODO: this is correct? */

Register that the input PWM signal (IM_PWM) is connected to.

Definition at line 156 of file bender_ir155_cfg.h.

◆ IR155_SPEED_START_FREQUENCY_Hz

#define IR155_SPEED_START_FREQUENCY_Hz   (30.0f)

30 Hz -> Speed start measurement. Insulation measurement (only good/bad evaluation), starts directly after power on ? 2 s; PWM 5...10 % (good) and 90...95 % (bad)

Definition at line 109 of file bender_ir155_cfg.h.

◆ IR155_SPEED_START_LOWER_FREQUENCY_Hz

#define IR155_SPEED_START_LOWER_FREQUENCY_Hz   (IR155_SPEED_START_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 133 of file bender_ir155_cfg.h.

◆ IR155_SPEED_START_UPPER_FREQUENCY_Hz

#define IR155_SPEED_START_UPPER_FREQUENCY_Hz   (IR155_SPEED_START_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 132 of file bender_ir155_cfg.h.

◆ IR155_STARTUP_TIME_ms

#define IR155_STARTUP_TIME_ms   (2200u)

Time after startup, until the first valid measurement result is available

Definition at line 87 of file bender_ir155_cfg.h.

◆ IR155_SUPPLY_ENABLE_PIN

#define IR155_SUPPLY_ENABLE_PIN   (25u)

Pin that the supply enable pin is connected to.

Definition at line 147 of file bender_ir155_cfg.h.

◆ IR155_SUPPLY_ENABLE_PORT

#define IR155_SUPPLY_ENABLE_PORT   (hetREG1)

Register that the supply enable pin is connected to.

Definition at line 144 of file bender_ir155_cfg.h.

◆ IR155_UNDERVOLTAGE_FREQUENCY_Hz

#define IR155_UNDERVOLTAGE_FREQUENCY_Hz   (20.0f)

20 Hz -> undervoltage condition. Insulation measurement DCP (continuous measurement); starts two seconds after power on; PWM active 5...95 %; First successful insulation measurement at ? 17.5 s, Undervoltage detection 0...500 V (Bender configurable)

Definition at line 104 of file bender_ir155_cfg.h.

◆ IR155_UNDERVOLTAGE_LOWER_FREQUENCY_Hz

#define IR155_UNDERVOLTAGE_LOWER_FREQUENCY_Hz   (IR155_UNDERVOLTAGE_FREQUENCY_Hz - IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 130 of file bender_ir155_cfg.h.

◆ IR155_UNDERVOLTAGE_UPPER_FREQUENCY_Hz

#define IR155_UNDERVOLTAGE_UPPER_FREQUENCY_Hz   (IR155_UNDERVOLTAGE_FREQUENCY_Hz + IR155_MEASUREMENT_INTERVAL_RANGE_Hz)

Definition at line 129 of file bender_ir155_cfg.h.

◆ IR155_WAIT_TIME_AFTER_GROUND_ERROR_ms

#define IR155_WAIT_TIME_AFTER_GROUND_ERROR_ms   (25000u)

During this time, the results of Bender Isometer aren't to be trusted wait time in [ms] <= 65535; IR155_WAIT_TIME_AFTER_GNDERROR

Type:
int
Range:
0 < x <=65535
Unit:
ms
Default:
25000

Definition at line 84 of file bender_ir155_cfg.h.