foxBMS  1.1.0
The foxBMS Battery Management System API Documentation
mxm_cfg.c File Reference

Configuration for the MAX monitoring chip. More...

#include "mxm_cfg.h"
#include "io.h"
#include "spi.h"
Include dependency graph for mxm_cfg.c:

Go to the source code of this file.

Functions

void MXM_MonitoringPinInit (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...
 

Detailed Description

Configuration for the MAX monitoring chip.

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
2021-07-14 (date of last update)
Prefix
MXM

Definition in file mxm_cfg.c.

Function Documentation

◆ 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 81 of file mxm_cfg.c.

◆ MXM_MonitoringPinInit()

void MXM_MonitoringPinInit ( 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 72 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]txBufferpointer to an array that is to be transmitted
[out]rxBufferpointer to an array into which received data shall be written
[in]lengthlength of both arrays
Returns
STD_NOT_OK for unsuccessful transmissions, STD_OK on success

Definition at line 92 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]txBufferpointer to an array that is to be transmitted
[in]lengthlength of array
Returns
STD_NOT_OK for unsuccessful transmissions, STD_OK on success

Definition at line 86 of file mxm_cfg.c.

Here is the call graph for this function: