Driver for the contactors. More...

#include "contactor.h"
#include "diag.h"
#include "mcu.h"
#include "sps.h"

Include dependency graph for contactor.c:

Functions
static void	CONT_GetFeedbackOfAllContactors (void)
	Reads the feedback of all contactors. More...

static void	CONT_InitializationCheckOfContactorRegistry (void)

void	CONT_CheckFeedback (void)
	checks the feedback of all contactors More...

STD_RETURN_TYPE_e	CONT_OpenContactor (uint8_t stringNumber, CONT_TYPE_e contactor)
	Opens the contactor. More...

STD_RETURN_TYPE_e	CONT_CloseContactor (uint8_t stringNumber, CONT_TYPE_e contactor)
	Closes the contactor. More...

STD_RETURN_TYPE_e	CONT_ClosePrecharge (uint8_t stringNumber)
	Closes precharge. More...

STD_RETURN_TYPE_e	CONT_OpenPrecharge (uint8_t stringNumber)
	Opens precharge. More...

void	CONT_OpenAllPrechargeContactors (void)
	Open all currently closed precharge contactors. More...

CONT_ELECTRICAL_STATE_TYPE_e	CONT_GetContactorState (uint8_t stringNumber, CONT_TYPE_e contactorType)
	Returns the current contactor state. More...

void	CONT_Initialize (void)
	initializes the contactor module More...

void	TEST_CONT_InitializationCheckOfContactorRegistry ()

Detailed Description

Driver for the contactors.

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: 2020-02-11 (date of creation)

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

Version: v1.4.1

Prefix: CONT

Definition in file contactor.c.

Function Documentation

◆ CONT_CheckFeedback()

void CONT_CheckFeedback ( void )

checks the feedback of all contactors

makes a DIAG entry for each contactor when the feedback does not match the set value

Definition at line 121 of file contactor.c.

Here is the call graph for this function:

◆ CONT_CloseContactor()

STD_RETURN_TYPE_e CONT_CloseContactor	(	uint8_t	stringNumber,
		CONT_TYPE_e	contactor
	)

Closes the contactor.

This function makes an close state request to the specific contactor

Parameters

stringNumber	String addressed
contactor	contactor adressed

Definition at line 180 of file contactor.c.

Here is the call graph for this function:

◆ CONT_ClosePrecharge()

STD_RETURN_TYPE_e CONT_ClosePrecharge ( uint8_t stringNumber )

Closes precharge.

This function makes a close state request to the precharge contactor.

Parameters

stringNumber String addressed

Returns: STD_OK if requested contactor exists and close requested, otherwise STD_NOT_OK

Definition at line 199 of file contactor.c.

Here is the call graph for this function:

◆ CONT_GetContactorState()

CONT_ELECTRICAL_STATE_TYPE_e CONT_GetContactorState	(	uint8_t	stringNumber,
		CONT_TYPE_e	contactorType
	)

Returns the current contactor state.

This function is used in the functioning of the CONT state machine.

Parameters

stringNumber	string in which the contactor is placed
contactorType	contactor type for which the feedback is requested

Returns: current state, taken from CONT_ELECTRICAL_STATE_TYPE_e

Definition at line 232 of file contactor.c.

◆ CONT_GetFeedbackOfAllContactors()

static void CONT_GetFeedbackOfAllContactors ( void )

static

Reads the feedback of all contactors.

Gathers the feedback of all contactors from the configured feedback source (CONT_FEEDBACK_TYPE_e). If CONT_HAS_NO_FEEDBACK is configured,it is assumed that the contactor has reached the requested state.

Definition at line 82 of file contactor.c.

Here is the call graph for this function:

◆ CONT_InitializationCheckOfContactorRegistry()

static void CONT_InitializationCheckOfContactorRegistry ( void )

static

conducts an initialization test of the contactor registry and asserts at failure

Definition at line 104 of file contactor.c.

Here is the call graph for this function:

◆ CONT_Initialize()

void CONT_Initialize ( void )

initializes the contactor module

Definition at line 247 of file contactor.c.

Here is the call graph for this function:

◆ CONT_OpenAllPrechargeContactors()

void CONT_OpenAllPrechargeContactors ( void )

Open all currently closed precharge contactors.

This function iterates over all contactors and opens all currently closed precharge contactors

Returns: none (void)

Definition at line 219 of file contactor.c.

Here is the call graph for this function:

◆ CONT_OpenContactor()

STD_RETURN_TYPE_e CONT_OpenContactor	(	uint8_t	stringNumber,
		CONT_TYPE_e	contactor
	)

Opens the contactor.

This function makes an open state request to the specific contactor

Parameters

stringNumber	String addressed
contactor	contactor adressed

Definition at line 161 of file contactor.c.

Here is the call graph for this function:

◆ CONT_OpenPrecharge()

STD_RETURN_TYPE_e CONT_OpenPrecharge ( uint8_t stringNumber )

Opens precharge.

This function makes an open state request to the precharge contactor.

Parameters

stringNumber String addressed

Definition at line 209 of file contactor.c.

Here is the call graph for this function:

◆ TEST_CONT_InitializationCheckOfContactorRegistry()

void TEST_CONT_InitializationCheckOfContactorRegistry ( void )

Definition at line 253 of file contactor.c.

Here is the call graph for this function:

Functions

Detailed Description

Function Documentation

◆ CONT_CheckFeedback()

◆ CONT_CloseContactor()

◆ CONT_ClosePrecharge()

◆ CONT_GetContactorState()

◆ CONT_GetFeedbackOfAllContactors()

◆ CONT_InitializationCheckOfContactorRegistry()

◆ CONT_Initialize()

◆ CONT_OpenAllPrechargeContactors()

◆ CONT_OpenContactor()

◆ CONT_OpenPrecharge()

◆ TEST_CONT_InitializationCheckOfContactorRegistry()