Elements of the module that are confined to the scope of the compilation unit. Perfectly corresponds to the module's source file, except the IRQ handlers. More...

Functions
static uint8_t	ReceiveData (HIERODULE_SPI_Wrapper *Wrapper)
	Reads and returns the data register content of the SPI peripheral.

void	Enable (HIERODULE_SPI_Wrapper *Wrapper)
	Enables the SPI peripheral.

static void	Disable (HIERODULE_SPI_Wrapper *Wrapper)
	Disables the SPI peripheral.

void	SPI_IRQ_Handler (HIERODULE_SPI_Wrapper *Wrapper)
	The base IRQ body to be used for all SPI IRQs.

Variables
static HIERODULE_SPI_Wrapper *	SPI1_Wrapper
	SPI wrapper pointer meant for SPI1.

static HIERODULE_SPI_Wrapper *	SPI2_Wrapper
	SPI wrapper pointer meant for SPI2. Requires the device specific macro __STM32F103xB_H or __STM32F401xC_H to be defined.

static HIERODULE_SPI_Wrapper *	SPI3_Wrapper
	SPI wrapper pointer meant for SPI3. Requires the device specific macro __STM32F401xC_H to be defined.

Detailed Description

Implements the routines defined in the header file and routines necessary for those in the background. Pointers of SPI wrappers are also defined here.
IRQ definitions with custom ISR implementations are also included at the end of the file.

Function Documentation

◆ Disable()

static void Disable ( HIERODULE_SPI_Wrapper * Wrapper )

static

Parameters

Wrapper Pointer to the SPI wrapper.

Returns: None

Defined as static to avoid the multiple definition error some compilers throw since a function with the same name also exists within another module; that will be fixed in a future release.

Definition at line 77 of file hierodule_spi.c.

{
    CLEAR_BIT(Wrapper->_SPI->CR1, SPI_CR1_SPE);
}

References Wrapper.

Referenced by SPI_IRQ_Handler().

◆ Enable()

void Enable ( HIERODULE_SPI_Wrapper * Wrapper )

Parameters

Wrapper Pointer to the SPI wrapper.

Returns: None

Self-explanatory code, nothing to elaborate.

Definition at line 65 of file hierodule_spi.c.

{
    SET_BIT(Wrapper->_SPI->CR1, SPI_CR1_SPE);
}

References Wrapper.

Referenced by HIERODULE_SPI_InitWrapper(), and HIERODULE_SPI_TransmitPackage().

◆ ReceiveData()

static uint8_t ReceiveData ( HIERODULE_SPI_Wrapper * Wrapper )

static

Parameters

Wrapper Pointer to the SPI wrapper.

Returns: uint8_t The byte returned.

Defined as static to avoid the multiple definition error some compilers throw since a function with the same name also exists within another module; that will be fixed in a future release.

Definition at line 54 of file hierodule_spi.c.

{
    return (uint8_t)(Wrapper->_SPI->DR);
}

References Wrapper.

Referenced by SPI_IRQ_Handler().

◆ SPI_IRQ_Handler()

void SPI_IRQ_Handler ( HIERODULE_SPI_Wrapper * Wrapper )

Parameters

Wrapper Pointer to the SPI wrapper.

Returns: None

Transmission completion callback routine gets Called at the end of an entire transmission in master mode. As for slave mode, the routine gets invoked at the end of each byte transmission.

Definition at line 230 of file hierodule_spi.c.

{
    if( Wrapper->Mode == 1 )
    {
        if( READ_BIT(Wrapper->_SPI->CR1, SPI_CR1_SPE) == (SPI_CR1_SPE) )
        {
            if( READ_BIT(Wrapper->_SPI->SR, SPI_SR_TXE) == (SPI_SR_TXE) )
            {
                HIERODULE_SPI_TransmitByte(Wrapper, Wrapper->TX_Buffer[Wrapper->TX_Counter++]);
                while( READ_BIT(Wrapper->_SPI->SR, SPI_SR_TXE) != (SPI_SR_TXE) );
 
                while( READ_BIT(Wrapper->_SPI->SR, SPI_SR_RXNE) != (SPI_SR_RXNE) );
                Wrapper->RX_Buffer[Wrapper->RX_Index++] = ReceiveData(Wrapper);
                Wrapper->RX_Index %= Wrapper->RX_BufferSize;
                if( Wrapper->RX_New < Wrapper->RX_BufferSize )
                    Wrapper->RX_New++;
 
                if( Wrapper->TX_Counter == Wrapper->TX_BufferSize )
                {
                    while( READ_BIT(Wrapper->_SPI->SR, SPI_SR_BSY) == (SPI_SR_BSY) );
                    Disable(Wrapper);
                    if( Wrapper->TC_Handler != NULL )
                        Wrapper->TC_Handler();
                }
            }
        }
    }
    else if( Wrapper->Mode == 0 )
    {
        if( READ_BIT(Wrapper->_SPI->SR, SPI_SR_RXNE) == (SPI_SR_RXNE) )
        {
            Wrapper->RX_Buffer[Wrapper->RX_Index++] = ReceiveData(Wrapper);
            Wrapper->RX_Index %= Wrapper->RX_BufferSize;
            if( Wrapper->RX_New < Wrapper->RX_BufferSize )
                Wrapper->RX_New++;
 
            HIERODULE_SPI_TransmitByte(Wrapper, Wrapper->TX_Buffer[Wrapper->TX_Counter++]);
 
            if( Wrapper->TC_Handler != NULL )
                Wrapper->TC_Handler();
        }
    }
}