mxm_cfg.c File Reference

Configuration for the MAX analog front-end. More...

#include "mxm_cfg.h"
#include "diag.h"
#include "io.h"
#include "spi.h"
#include <stdint.h>

Include dependency graph for mxm_cfg.c:

Go to the source code of this file.

Functions
void	MXM_InitializeMonitoringPins (void)
	Initialize the pins connected to the MAX17841B. More...
STD_RETURN_TYPE_e	MXM_GetSPIStateReady (void)
	Return whether SPI interface is ready. More...
STD_RETURN_TYPE_e	MXM_SendData (uint16_t *txBuffer, uint16_t length)
	Transmit data over SPI. More...
STD_RETURN_TYPE_e	MXM_ReceiveData (uint16_t *txBuffer, uint16_t *rxBuffer, uint16_t length)
	Send and Receive data over SPI. More...
void	MXM_ShutDownBridgeIc (void)
	Pulls the shutdown of the bridge IC low. More...
void	MXM_EnableBridgeIc (void)
	Pulls the shutdown of the bridge IC high. More...

Variables
const bool	mxm_allowSkippingPostInitSelfCheck = true

Detailed Description

Configuration for the MAX analog front-end.

Copyright

© 2010 - 2023, 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:

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

2019-01-09 (date of creation)

Updated

2023-02-03 (date of last update)

Version

v1.5.0

Prefix

MXM

Definition in file mxm_cfg.c.

Function Documentation

MXM_EnableBridgeIc()

void MXM_EnableBridgeIc

(

void

)

Pulls the shutdown of the bridge IC high.

The bridge IC used in this driver has a shutdown pin that allows to switch it off. This function tells the bridge IC to enable. (Pulls the shutdown high, bridge IC will start)

Definition at line 113 of file mxm_cfg.c.

Here is the call graph for this function:

MXM_GetSPIStateReady()

STD_RETURN_TYPE_e MXM_GetSPIStateReady

(

void

)

Return whether SPI interface is ready.

In the case of an DMA-based implementation this function can be used to check the state of the SPI interface and whether it can be accessed for writing.

Returns

STD_OK if the SPI interface is free

Definition at line 86 of file mxm_cfg.c.

Here is the call graph for this function:

MXM_InitializeMonitoringPins()

void MXM_InitializeMonitoringPins

(

void

)

Initialize the pins connected to the MAX17841B.

Initializes the pins that are needed by MAX17841B to a known state. The pins are:

• the interrupt pin
• the shutdown pin
• the chip select pin

Only the necessary pins are configured.

Definition at line 77 of file mxm_cfg.c.

Here is the call graph for this function:

MXM_ReceiveData()

STD_RETURN_TYPE_e MXM_ReceiveData	(	uint16_t *	txBuffer,
		uint16_t *	rxBuffer,
		uint16_t	length
	)

Send and Receive data over SPI.

Wraps the SPI_TransmitReceiveData API function in order to have one single point of access for the driver to the SPI interface.

Parameters

[in]	txBuffer	pointer to an array that is to be transmitted
[out]	rxBuffer	pointer to an array into which received data shall be written
[in]	length	length of both arrays

Returns

STD_NOT_OK for unsuccessful transmissions, STD_OK on success

Definition at line 99 of file mxm_cfg.c.

Here is the call graph for this function:

MXM_SendData()

STD_RETURN_TYPE_e MXM_SendData	(	uint16_t *	txBuffer,
		uint16_t	length
	)

Transmit data over SPI.

Wraps the SPI_TransmitData API function in order to have one single point of access for the driver to the SPI interface.

Parameters

[in]	txBuffer	pointer to an array that is to be transmitted
[in]	length	length of array

Returns

STD_NOT_OK for unsuccessful transmissions, STD_OK on success

Definition at line 90 of file mxm_cfg.c.

Here is the call graph for this function:

MXM_ShutDownBridgeIc()

void MXM_ShutDownBridgeIc

(

void

)

Pulls the shutdown of the bridge IC low.

The bridge IC used in this driver has a shutdown pin that allows to switch it off. This function tells the bridge IC to shut down.

Definition at line 109 of file mxm_cfg.c.

Here is the call graph for this function:

Variable Documentation

mxm_allowSkippingPostInitSelfCheck

const bool mxm_allowSkippingPostInitSelfCheck = true

if this flag is set, the post init self check will pass on even if the satellite numbers are not correct

Definition at line 69 of file mxm_cfg.c.