foxBMS - Unit Tests  1.2.1
The foxBMS Unit Tests API Documentation
spi_cfg.h File Reference

Headers for the configuration for the SPI module. More...

#include "general.h"
#include "battery_system_cfg.h"
#include "HL_het.h"
#include "HL_spi.h"
Include dependency graph for spi_cfg.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  SPI_INTERFACE_CONFIG
 

Macros

#define SPI_CSHOLD_BIT   (0x10000000U)
 
#define SPI_WDEL_BIT   (0x04000000U)
 
#define SPI_HARDWARE_CHIP_SELECT_FIELD_POSITION   (16U)
 
#define SPI_DATA_FORMAT_FIELD_POSITION   (24U)
 
#define SPI_TX_BUFFER_EMPTY_FLAG_POSITION   (9u)
 
#define SPI_PC0_CLEAR_HW_CS_MASK   (0xFFFFFF00u)
 
#define SPI_TX_EMPTY_TIMEOUT_ITERATIONS   (6000u)
 
#define SPI_MAX_NUMBER_HW_CS   (6u)
 
#define LTC_SPI_NODE   (spiREG1)
 
#define SPI_SPI1_INDEX   (0u)
 
#define SPI_SPI2_INDEX   (1u)
 
#define SPI_SPI3_INDEX   (2u)
 
#define SPI_SPI4_INDEX   (3u)
 
#define SPI_SPI5_INDEX   (4u)
 
#define SPS_SPI_CS_GIOPORT   (hetREG2->DOUT)
 
#define SPS_SPI_CS_GIOPORT_DIR   (hetREG2->DIR)
 
#define SPS_SPI_CS_PIN   (1u)
 
#define N775_SPI_TX_NODE   (spiREG1)
 
#define N775_SPI_TX_GIOPORT   (N775_SPI_TX_NODE->PC3)
 
#define N775_SPI_TX_CS_PIN   (2U)
 
#define N775_SPI_RX_NODE   (spiREG5)
 
#define N775_SPI_RX_GIOPORT   (N775_SPI_TX_NODE->PC3)
 
#define N775_SPI_RX_CS_PIN   (2U)
 

Typedefs

typedef enum SPI_BUSY_STATE SPI_BUSY_STATE_e
 
typedef enum SPI_CHIP_SELECT_TYPE SPI_CHIP_SELECT_TYPE_e
 
typedef struct SPI_INTERFACE_CONFIG SPI_INTERFACE_CONFIG_s
 

Enumerations

enum  SPI_BUSY_STATE { SPI_IDLE , SPI_BUSY }
 
enum  SPI_CHIP_SELECT_TYPE { SPI_CHIP_SELECT_HARDWARE , SPI_CHIP_SELECT_SOFTWARE }
 

Functions

void SPI_SpsInterfaceSwitchToHighSpeed (SPI_INTERFACE_CONFIG_s *pSpiSpsInterface)
 Switch the SPS spi handle to high speed. More...
 
void SPI_SpsInterfaceSwitchToLowSpeed (SPI_INTERFACE_CONFIG_s *pSpiSpsInterface)
 Switch the SPS spi handle to low speed. More...
 

Variables

SPI_INTERFACE_CONFIG_s spi_ltcInterface [BS_NR_OF_STRINGS]
 
SPI_INTERFACE_CONFIG_s spi_MxmInterface
 
SPI_INTERFACE_CONFIG_s spi_nxp775InterfaceTx [BS_NR_OF_STRINGS]
 
SPI_INTERFACE_CONFIG_s spi_nxp775InterfaceRx [BS_NR_OF_STRINGS]
 
SPI_INTERFACE_CONFIG_s spi_framInterface
 
SPI_INTERFACE_CONFIG_s spi_spsInterface
 
SPI_INTERFACE_CONFIG_s spi_adc0Interface
 
SPI_INTERFACE_CONFIG_s spi_adc1Interface
 
SPI_INTERFACE_CONFIG_s spi_kSbcMcuInterface
 
SPI_BUSY_STATE_e spi_busyFlags []
 
const uint8_t spi_nrBusyFlags
 

Detailed Description

Headers for the configuration for the SPI module.

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
2020-03-05 (date of creation)
Updated
2021-12-08 (date of last update)
Prefix
SPI

Definition in file spi_cfg.h.

Macro Definition Documentation

◆ LTC_SPI_NODE

#define LTC_SPI_NODE   (spiREG1)

SPI defines for LTC

Definition at line 102 of file spi_cfg.h.

◆ N775_SPI_RX_CS_PIN

#define N775_SPI_RX_CS_PIN   (2U)

SPI defines for NXP MC33775A

Definition at line 120 of file spi_cfg.h.

◆ N775_SPI_RX_GIOPORT

#define N775_SPI_RX_GIOPORT   (N775_SPI_TX_NODE->PC3)

SPI defines for NXP MC33775A

Definition at line 119 of file spi_cfg.h.

◆ N775_SPI_RX_NODE

#define N775_SPI_RX_NODE   (spiREG5)

SPI defines for NXP MC33775A

Definition at line 118 of file spi_cfg.h.

◆ N775_SPI_TX_CS_PIN

#define N775_SPI_TX_CS_PIN   (2U)

SPI defines for NXP MC33775A

Definition at line 116 of file spi_cfg.h.

◆ N775_SPI_TX_GIOPORT

#define N775_SPI_TX_GIOPORT   (N775_SPI_TX_NODE->PC3)

SPI defines for NXP MC33775A

Definition at line 115 of file spi_cfg.h.

◆ N775_SPI_TX_NODE

#define N775_SPI_TX_NODE   (spiREG1)

SPI defines for NXP MC33775A

Definition at line 114 of file spi_cfg.h.

◆ SPI_CSHOLD_BIT

#define SPI_CSHOLD_BIT   (0x10000000U)

Bit in SPIDAT1 register that activates hardware Chip Select hold

Definition at line 77 of file spi_cfg.h.

◆ SPI_DATA_FORMAT_FIELD_POSITION

#define SPI_DATA_FORMAT_FIELD_POSITION   (24U)

Position of DFSEL field in SPIDAT1 register

Definition at line 86 of file spi_cfg.h.

◆ SPI_HARDWARE_CHIP_SELECT_FIELD_POSITION

#define SPI_HARDWARE_CHIP_SELECT_FIELD_POSITION   (16U)

Position of CSNR field in SPIDAT1 register

Definition at line 83 of file spi_cfg.h.

◆ SPI_MAX_NUMBER_HW_CS

#define SPI_MAX_NUMBER_HW_CS   (6u)

Max number of hardware chip select pins

Definition at line 98 of file spi_cfg.h.

◆ SPI_PC0_CLEAR_HW_CS_MASK

#define SPI_PC0_CLEAR_HW_CS_MASK   (0xFFFFFF00u)

Mask used to clear all HW CS bits

Definition at line 92 of file spi_cfg.h.

◆ SPI_SPI1_INDEX

#define SPI_SPI1_INDEX   (0u)

Index for the SPI nodes

Definition at line 69 of file spi_cfg.h.

◆ SPI_SPI2_INDEX

#define SPI_SPI2_INDEX   (1u)

Index for the SPI nodes

Definition at line 70 of file spi_cfg.h.

◆ SPI_SPI3_INDEX

#define SPI_SPI3_INDEX   (2u)

Index for the SPI nodes

Definition at line 71 of file spi_cfg.h.

◆ SPI_SPI4_INDEX

#define SPI_SPI4_INDEX   (3u)

Index for the SPI nodes

Definition at line 72 of file spi_cfg.h.

◆ SPI_SPI5_INDEX

#define SPI_SPI5_INDEX   (4u)

Index for the SPI nodes

Definition at line 73 of file spi_cfg.h.

◆ SPI_TX_BUFFER_EMPTY_FLAG_POSITION

#define SPI_TX_BUFFER_EMPTY_FLAG_POSITION   (9u)

Position of TX buffer empty flag in SPIFLG register

Definition at line 89 of file spi_cfg.h.

◆ SPI_TX_EMPTY_TIMEOUT_ITERATIONS

#define SPI_TX_EMPTY_TIMEOUT_ITERATIONS   (6000u)

Time to avoid infinite loop when waiting for Tx empty flag in a while loop

Definition at line 95 of file spi_cfg.h.

◆ SPI_WDEL_BIT

#define SPI_WDEL_BIT   (0x04000000U)

Bit in SPIDAT1 register that activates delay between words

Definition at line 80 of file spi_cfg.h.

◆ SPS_SPI_CS_GIOPORT

#define SPS_SPI_CS_GIOPORT   (hetREG2->DOUT)

GIO defines for SPI for Smart Power Switches

Definition at line 105 of file spi_cfg.h.

◆ SPS_SPI_CS_GIOPORT_DIR

#define SPS_SPI_CS_GIOPORT_DIR   (hetREG2->DIR)

GIO defines for SPI for Smart Power Switches

Definition at line 106 of file spi_cfg.h.

◆ SPS_SPI_CS_PIN

#define SPS_SPI_CS_PIN   (1u)

GIO defines for SPI for Smart Power Switches

Definition at line 107 of file spi_cfg.h.

Typedef Documentation

◆ SPI_BUSY_STATE_e

enum for spi interface state

◆ SPI_CHIP_SELECT_TYPE_e

type of chip select for spi

◆ SPI_INTERFACE_CONFIG_s

configuration of the SPI interface

Enumeration Type Documentation

◆ SPI_BUSY_STATE

enum for spi interface state

Enumerator
SPI_IDLE 
SPI_BUSY 

Definition at line 124 of file spi_cfg.h.

◆ SPI_CHIP_SELECT_TYPE

type of chip select for spi

Enumerator
SPI_CHIP_SELECT_HARDWARE 
SPI_CHIP_SELECT_SOFTWARE 

Definition at line 131 of file spi_cfg.h.

Function Documentation

◆ SPI_SpsInterfaceSwitchToHighSpeed()

void SPI_SpsInterfaceSwitchToHighSpeed ( SPI_INTERFACE_CONFIG_s pSpiSpsInterface)

Switch the SPS spi handle to high speed.

Parameters
[out]pSpiSpsInterfacehandle of the SPS spi config

Definition at line 345 of file spi_cfg.c.

◆ SPI_SpsInterfaceSwitchToLowSpeed()

void SPI_SpsInterfaceSwitchToLowSpeed ( SPI_INTERFACE_CONFIG_s pSpiSpsInterface)

Switch the SPS spi handle to low speed.

Parameters
[out]pSpiSpsInterfacehandle of the SPS spi config

Definition at line 350 of file spi_cfg.c.

Variable Documentation

◆ spi_adc0Interface

SPI_INTERFACE_CONFIG_s spi_adc0Interface
extern

SPI interface configuration for ADC communication

Definition at line 302 of file spi_cfg.c.

◆ spi_adc1Interface

SPI_INTERFACE_CONFIG_s spi_adc1Interface
extern

SPI interface configuration for ADC communication

Definition at line 311 of file spi_cfg.c.

◆ spi_busyFlags

SPI_BUSY_STATE_e spi_busyFlags[]
extern

struct containing the lock state of the SPI interfaces

Definition at line 329 of file spi_cfg.c.

◆ spi_framInterface

SPI_INTERFACE_CONFIG_s spi_framInterface
extern

SPI interface configuration for FRAM communication

Definition at line 284 of file spi_cfg.c.

◆ spi_kSbcMcuInterface

SPI_INTERFACE_CONFIG_s spi_kSbcMcuInterface
extern

SPI interface configuration for SBC communication

Definition at line 320 of file spi_cfg.c.

◆ spi_ltcInterface

SPI_INTERFACE_CONFIG_s spi_ltcInterface[BS_NR_OF_STRINGS]
extern

SPI interface configuration for LTC communication This is a list of structs because of multistring

Definition at line 200 of file spi_cfg.c.

◆ spi_MxmInterface

SPI_INTERFACE_CONFIG_s spi_MxmInterface
extern

SPI interface configuration for MXM communication

Definition at line 225 of file spi_cfg.c.

◆ spi_nrBusyFlags

const uint8_t spi_nrBusyFlags
extern

size of spi_busyFlags

Definition at line 338 of file spi_cfg.c.

◆ spi_nxp775InterfaceRx

SPI_INTERFACE_CONFIG_s spi_nxp775InterfaceRx[BS_NR_OF_STRINGS]
extern

SPI interface configuration for N775 communication, Rx part

Definition at line 259 of file spi_cfg.c.

◆ spi_nxp775InterfaceTx

SPI_INTERFACE_CONFIG_s spi_nxp775InterfaceTx[BS_NR_OF_STRINGS]
extern

SPI interface configuration for N775 communication Tx part

Definition at line 234 of file spi_cfg.c.

◆ spi_spsInterface

SPI_INTERFACE_CONFIG_s spi_spsInterface
extern

SPI interface configuration for SPS communication

Definition at line 293 of file spi_cfg.c.