docs/hal_html/hal__spi_8h_source.html

#ifndef HAL_SPI_H

#define HAL_SPI_H


#include "hal_common.h"


#define HAL_SPI_DRIVER_VERSION (MAKE_VERSION(1, 1, 0))


#ifndef SPI_DUMMYDATA

#define SPI_DUMMYDATA (0xA5U)

#endif


#ifndef SPI_RETRY_TIMES

#define SPI_RETRY_TIMES 0U

#endif


enum spi_status {

    SPI_Status_Ok                   =  0,

    SPI_Status_Fail                 =  1,

    SPI_Status_ReadOnly             =  2,

    SPI_Status_InvalidArgument      =  3,

    SPI_Status_Timeout              =  4,

    SPI_Status_BaudrateNotSupport   =  5,

    SPI_Status_Busy                 =  6,

    SPI_Status_Idle                 =  9,

    SPI_Status_TxError              = 10,

    SPI_Status_RxError              = 11,

    SPI_Status_RxRingBufferOverrun  = 12,

    SPI_Status_RxFifoBufferOverrun  = 13,

    SPI_Status_NoTransferInProgress = 14,

    SPI_Status_IncorrectCall        = 15,

    SPI_Status_UnexpectedState      = 128U,

};


typedef enum {

    SPI_ShiftDirMsbFirst = 0,

    SPI_ShiftDirLsbFirst = 1,

} spi_shift_direction_t;


typedef enum {

    SPI_TxFifoWatermark0 = 0,

    SPI_TxFifoWatermark1 = 1,

    SPI_TxFifoWatermark2 = 2,

    SPI_TxFifoWatermark3 = 3,

    SPI_TxFifoWatermark4 = 4,

    SPI_TxFifoWatermark5 = 5,

    SPI_TxFifoWatermark6 = 6,

    SPI_TxFifoWatermark7 = 7,

} spi_txfifo_watermark_t;


typedef enum {

    SPI_RxFifoWatermark1 = 0,

    SPI_RxFifoWatermark2 = 1,

    SPI_RxFifoWatermark3 = 2,

    SPI_RxFifoWatermark4 = 3,

    SPI_RxFifoWatermark5 = 4,

    SPI_RxFifoWatermark6 = 5,

    SPI_RxFifoWatermark7 = 6,

    SPI_RxFifoWatermark8 = 7,

} spi_rxfifo_watermark_t;


typedef enum {

    SPI_Data4Bits  =  3,

    SPI_Data5Bits  =  4,

    SPI_Data6Bits  =  5,

    SPI_Data7Bits  =  6,

    SPI_Data8Bits  =  7,

    SPI_Data9Bits  =  8,

    SPI_Data10Bits =  9,

    SPI_Data11Bits = 10,

    SPI_Data12Bits = 11,

    SPI_Data13Bits = 12,

    SPI_Data14Bits = 13,

    SPI_Data15Bits = 14,

    SPI_Data16Bits = 15,

    SPI_Data17Bits = 16,

    SPI_Data18Bits = 17,

    SPI_Data19Bits = 18,

    SPI_Data20Bits = 19,

    SPI_Data21Bits = 20,

    SPI_Data22Bits = 21,

    SPI_Data23Bits = 22,

    SPI_Data24Bits = 23,

    SPI_Data25Bits = 24,

    SPI_Data26Bits = 25,

    SPI_Data27Bits = 26,

    SPI_Data28Bits = 27,

    SPI_Data29Bits = 28,

    SPI_Data30Bits = 29,

    SPI_Data31Bits = 30,

    SPI_Data32Bits = 31,

} spi_frame_width_t;


typedef enum {

    SPI_FfMotorola  = 0,

    SPI_FfTexas     = 1,

    SPI_FfMicrowire = 2,

} spi_frame_format_t;


typedef enum {

    SPI_MicrowireCtrlWordLen1Bit  =  0,

    SPI_MicrowireCtrlWordLen2Bit  =  1,

    SPI_MicrowireCtrlWordLen3Bit  =  2,

    SPI_MicrowireCtrlWordLen4Bit  =  3,

    SPI_MicrowireCtrlWordLen5Bit  =  4,

    SPI_MicrowireCtrlWordLen6Bit  =  5,

    SPI_MicrowireCtrlWordLen7Bit  =  6,

    SPI_MicrowireCtrlWordLen8Bit  =  7,

    SPI_MicrowireCtrlWordLen9Bit  =  8,

    SPI_MicrowireCtrlWordLen10Bit =  9,

    SPI_MicrowireCtrlWordLen11Bit = 10,

    SPI_MicrowireCtrlWordLen12Bit = 11,

    SPI_MicrowireCtrlWordLen13Bit = 12,

    SPI_MicrowireCtrlWordLen14Bit = 13,

    SPI_MicrowireCtrlWordLen15Bit = 14,

    SPI_MicrowireCtrlWordLen16Bit = 15,

} microwire_ctrlword_len_t;


typedef enum {

    SPI_MicrowireBusyReadyCheckDisable = 0,

    SPI_MicrowireBusyReadyCheckEnable  = 1,

} microwire_busy_ready_check_t;


typedef enum {

    SPI_MicrowireTx = 0,

    SPI_MicrowireRx = 1,

} microwire_tx_rx_t;


typedef enum {

    SPI_MicrowireSingle = 0,

    SPI_MicrowireSerial = 1,

} microwire_single_serial_t;


typedef struct {

    microwire_ctrlword_len_t     ctrl_word_len;

    microwire_busy_ready_check_t busy_ready_check;

    microwire_tx_rx_t            tx_rx;

    microwire_single_serial_t    single_serial;

} spi_microwire_cfg_t;


typedef enum {

    SPI_MotorolaClkPolLow = 0,

    SPI_MotorolaClkPolHi  = 1,

} spi_motorola_clk_pol_t;


typedef enum {

    SPI_MotorolaCapDataRising  = 0,

    SPI_MotorolaCapDataFalling = 1,

} spi_motorola_cap_data_t;


typedef struct {

    spi_motorola_clk_pol_t  clk_pol;

    spi_motorola_cap_data_t cap_data;

} spi_motorola_cfg_t;


enum spi_status_flags {

    SPI_TxNotFullFlag  = SPI_SR_TFNF_Msk,

    SPI_TxEmptyFlag    = SPI_SR_TFE_Msk,

    SPI_RxNotEmptyFlag = SPI_SR_RFNE_Msk,

    SPI_RxFullFlag     = SPI_SR_RFF_Msk,

};


typedef enum {

    SPI_ModeDuplex     = 0,

    SPI_ModeSimplexTx  = 1,

    SPI_ModeSimplexRx  = 2,

    SPI_ModeHalfDuplex = 3,

} spi_mode_t;


typedef struct {

    struct {

        bool              loopback_enable;

        uint32_t          baud_rate_bps;

    } master;

    spi_frame_width_t     data_width_bits;

    spi_shift_direction_t direction;

    spi_frame_format_t    frame_format;

    spi_microwire_cfg_t   microwire_cfg;

    spi_motorola_cfg_t    motorola_cfg;

} spi_config_t;


enum spi_trans_status {

    SPI_TransStatus_Busy    = 0,

    SPI_TransStatus_Idle    = 1,

    SPI_TransStatus_Error   = 128,

    SPI_TransStatus_Error_1 = 129,

    SPI_TransStatus_Error_2 = 130,

    SPI_TransStatus_Error_3 = 132,

    SPI_TransStatus_Error_4 = 144,

};


enum spi_interrupt_enable {

    SPI_IRQ_MultiMaster     = SPI_IMR_MSTIM_Msk,

    SPI_IRQ_RxFifoTrigger   = SPI_IMR_RXFIM_Msk,

    SPI_IRQ_RxFifoOverflow  = SPI_IMR_RXOIM_Msk,

    SPI_IRQ_RxFifoUnderflow = SPI_IMR_RXUIM_Msk,

    SPI_IRQ_TxFifoOverflow  = SPI_IMR_TXOIM_Msk,

    SPI_IRQ_TxFifoTrigger   = SPI_IMR_TXEIM_Msk,

    SPI_IRQ_TxOnly

        = SPI_IRQ_MultiMaster                       /* Мультимастер */

            | SPI_IRQ_TxFifoOverflow                /* Переполнение TxFIFO */

            | SPI_IRQ_TxFifoTrigger,                /* Прерывание по триггеру уровня TxFIFO */


    SPI_IRQ_RxOnly

        = SPI_IRQ_MultiMaster                       /* Мультимастер */

            | SPI_IRQ_RxFifoTrigger                 /* Прерывание по триггеру уровня RxFIFO */

            | SPI_IRQ_RxFifoOverflow                /* Переполнение RxFIFO */

            | SPI_IRQ_RxFifoUnderflow,              /* Чтение из пустого RxFIFO */


    SPI_IRQ_All

        = SPI_IRQ_MultiMaster

            | SPI_IRQ_RxFifoTrigger

            | SPI_IRQ_RxFifoOverflow

            | SPI_IRQ_RxFifoUnderflow

            | SPI_IRQ_TxFifoOverflow

            | SPI_IRQ_TxFifoTrigger,

};


typedef struct {

    uint8_t  *tx_data;

    uint8_t  *rx_data;

    size_t   data_size;

} spi_transfer_t;


typedef struct {

    uint8_t  *tx_data;

    uint8_t  *rx_data;

    size_t   tx_data_size;

    size_t   rx_data_size;

} spi_half_duplex_transfer_t;


typedef struct {

    spi_shift_direction_t shift_dir;

    uint8_t               frame_width_bits;

    uint8_t               frame_width_bytes;

} spi_config_internal_t;


struct spi_handle;


typedef struct spi_handle spi_master_handle_t;


typedef struct spi_handle spi_slave_handle_t;


typedef void (*spi_master_callback_t)(SPI_Type *base,

    spi_master_handle_t *handle, uint32_t status, void *user_data);


typedef void (*spi_slave_callback_t)(SPI_Type *base, spi_slave_handle_t *handle,

    uint32_t status, void *user_data);


struct spi_handle {

    volatile uint8_t      *tx_data;

    volatile uint8_t      *rx_data;

    volatile size_t       tx_remaining_bytes;

    volatile size_t       rx_remaining_bytes;

    int8_t                instance;

    size_t                total_byte_to_transfer;

    int32_t               state;

    spi_master_callback_t callback;

    void                  *user_data;

    uint8_t               frame_width_bits;

    uint8_t               frame_width_bytes;

    spi_mode_t            mode;

};


#if defined(__cplusplus)

extern "C" {

#endif


uint8_t SPI_GetInstance(SPI_Type *base);


void SPI_MasterGetDefaultConfig(spi_config_t *config);


enum spi_status SPI_MasterInit(SPI_Type *base, const spi_config_t *config,

    uint32_t src_clock_hz);


void SPI_SlaveGetDefaultConfig(spi_config_t *config);


enum spi_status SPI_SlaveInit(SPI_Type *base, const spi_config_t *config);


void SPI_Deinit(SPI_Type *base);


static inline void SPI_Enable(SPI_Type *base, bool enable)

{

    /* Включить/выключить SPI (SSIENR.SSI_EN). */

    SET_VAL_MSK(base->SSIENR, SPI_SSIENR_SSI_EN_Msk, SPI_SSIENR_SSI_EN_Pos,

        enable);

}


static inline bool SPI_IsEnable(SPI_Type *base)

{

    /*  SPI включено/выключено (SSIENR.SSI_EN). */

    return (bool)GET_VAL_MSK(base->SSIENR, SPI_SSIENR_SSI_EN_Msk,

        SPI_SSIENR_SSI_EN_Pos);

}


static inline void SPI_Reset(SPI_Type *base)

{

    /* Выключить SPI. */

    SET_VAL_MSK(base->SSIENR, SPI_SSIENR_SSI_EN_Msk, SPI_SSIENR_SSI_EN_Pos, 0U);


    /* Включить SPI. */

    SET_VAL_MSK(base->SSIENR, SPI_SSIENR_SSI_EN_Msk, SPI_SSIENR_SSI_EN_Pos, 1U);

}


static inline uint32_t SPI_GetStatusFlags(SPI_Type *base)

{

    assert(NULL != base);

    return base->SR;

}


static inline void SPI_EnableInterrupts(SPI_Type *base, uint32_t irqs)

{

    assert(NULL != base);


    /*

     * IMR - регистр маскирования прерываний:

     * 0 - прерывание замаскировано, 1 - активно.

     */

    base->IMR |= irqs;

}


static inline void SPI_DisableInterrupts(SPI_Type *base, uint32_t irqs)

{

    assert(NULL != base);


    /*

     * IMR - регистр маскирования прерываний:

     * 0 - прерывание замаскировано, 1 - активно.

     */

    base->IMR &= ~irqs;

}


static inline uint32_t SPI_CurrentStatusInterrupts(SPI_Type *base)

{


    assert(NULL != base);


    /* ISR - регистр статуса прерываний после маскирования. */

    return (base->ISR & SPI_IRQ_All);

}


static inline void SPI_TakeDownInterrupts(SPI_Type *base, uint32_t irqs)

{

    assert(NULL != base);

    assert(0 == (irqs & SPI_IRQ_RxFifoTrigger));

    assert(0 == (irqs & SPI_IRQ_TxFifoTrigger));


    volatile uint32_t temp = 0;

    UNUSED(temp);


    /* xxxICR - Регистры снятия прерываний. */


    /* Требуется сброс всех прерываний (допустимых для сброса таким образом). */

    if ((SPI_IRQ_MultiMaster

            | SPI_IRQ_RxFifoOverflow

            | SPI_IRQ_RxFifoUnderflow

            | SPI_IRQ_TxFifoOverflow) == irqs) {

        temp = GET_VAL_MSK(base->ICR, SPI_ICR_ICR_Msk, SPI_ICR_ICR_Pos);

    }

    /* Требуется сброс некоторых прерываний. */

    else {

        if (0 != (irqs & SPI_IRQ_MultiMaster)) {

            /* MSTICR - Регистр  сброса прерывания: “Возможный конфликт master устройств”. */

            temp = GET_VAL_MSK(base->MSTICR, SPI_MSTICR_MSTICR_Msk, SPI_MSTICR_MSTICR_Pos);

        }


        if (0 != (irqs & SPI_IRQ_RxFifoOverflow)) {

            /* RXOICR - Регистр сброса прерывания: “Переполнен FIFO приемника”. */

            temp = GET_VAL_MSK(base->RXOICR, SPI_RXOICR_RXOICR_Msk, SPI_RXOICR_RXOICR_Pos);

        }


        if (0 != (irqs & SPI_IRQ_RxFifoUnderflow)) {

            /* RXUICR - Регистр сброса прерывания: “FIFO приемника пуст”. */

            temp = GET_VAL_MSK(base->RXUICR, SPI_RXUICR_RXUICR_Msk, SPI_RXUICR_RXUICR_Pos);

        }


        if (0 != (irqs & SPI_IRQ_TxFifoOverflow)) {

            /* TXOICR - Регистр сброса прерывания: “Переполнен FIFO передатчика”.*/

            temp = GET_VAL_MSK(base->TXOICR, SPI_TXOICR_TXOICR_Msk, SPI_TXOICR_TXOICR_Pos);

        }

    }


    return;

}


void SPI_EnableTxDMA(SPI_Type *base, bool enable);


void SPI_EnableRxDMA(SPI_Type *base, bool enable);


spi_config_internal_t *SPI_GetConfig(SPI_Type *base);


enum spi_status SPI_MasterSetBaud(SPI_Type *base, uint32_t baudrate_bps,

    uint32_t src_clock_hz);


void SPI_WriteData(SPI_Type *base, uint32_t data);


uint32_t SPI_ReadData(SPI_Type *base);


void SPI_SetDummyData(SPI_Type *base, uint8_t dummy_data);


enum spi_status SPI_MasterTransferCreateHandle(SPI_Type *base,

    spi_master_handle_t *handle, spi_master_callback_t callback,

    void *user_data);


enum spi_status SPI_MasterTransferBlocking(SPI_Type *base,

    spi_transfer_t *xfer);


enum spi_status SPI_MasterTransferNonBlocking(SPI_Type *base,

    spi_master_handle_t *handle, spi_transfer_t *xfer);


enum spi_status SPI_MasterHalfDuplexTransferBlocking(SPI_Type *base,

    spi_half_duplex_transfer_t *xfer);


status_t SPI_MasterHalfDuplexTransferNonBlocking(SPI_Type *base,

    spi_master_handle_t *handle,

    spi_half_duplex_transfer_t *xfer);


status_t SPI_MasterTransferGetByte(spi_master_handle_t *handle, size_t *count);


status_t SPI_MasterTransferGetRemainingByte(spi_master_handle_t *handle,

    size_t *count);


status_t SPI_MasterTransferGetTotalByte(spi_master_handle_t *handle,

    size_t *count);


void SPI_MasterTransferAbort(SPI_Type *base, spi_master_handle_t *handle);


void SPI_MasterTransferHandleIRQ(SPI_Type *base, spi_master_handle_t *handle);


static inline status_t SPI_SlaveTransferCreateHandle(SPI_Type *base,

    spi_slave_handle_t *handle,

    spi_slave_callback_t callback,

    void *userData)

{

    return SPI_MasterTransferCreateHandle(base, handle, callback, userData);

}


static inline status_t SPI_SlaveTransferNonBlocking(SPI_Type *base,

    spi_slave_handle_t *handle, spi_transfer_t *xfer)

{

    return SPI_MasterTransferNonBlocking(base, handle, xfer);

}


static inline status_t SPI_SlaveHalfDuplexTransferNonBlocking(SPI_Type *base,

    spi_slave_handle_t *handle, spi_half_duplex_transfer_t *xfer)

{

    return SPI_MasterHalfDuplexTransferNonBlocking(base, handle, xfer);

}


static inline status_t SPI_SlaveTransferGetByte(spi_slave_handle_t *handle,

    size_t *count)

{

    return SPI_MasterTransferGetByte((spi_master_handle_t *) handle, count);

}


static inline void SPI_SlaveTransferAbort(SPI_Type *base, spi_slave_handle_t *handle)

{

    SPI_MasterTransferAbort(base, (spi_master_handle_t *) handle);

}


static inline void SPI_SlaveTransferHandleIRQ(SPI_Type *base,

    spi_slave_handle_t *handle)

{

    SPI_MasterTransferHandleIRQ(base, handle);

}


#if defined(__cplusplus)

}

#endif


#endif /* HAL_SPI_H */


UNUSED
#define UNUSED(x)
Definition hal_common.h:45

status_t
int32_t status_t
Тип, используемый для всех возвращаемых значений статуса и ошибок
Definition hal_common.h:61

spi_interrupt_enable
spi_interrupt_enable
Источники прерываний SPI.
Definition hal_spi.h:342

spi_trans_status
spi_trans_status
Состояния приемо-передачи SPI.
Definition hal_spi.h:324

spi_motorola_cap_data_t
spi_motorola_cap_data_t
Выбор фронта для захвата данных для формата кадра передачи данных Motorola SPI.
Definition hal_spi.h:255

SPI_SetDummyData
void SPI_SetDummyData(SPI_Type *base, uint8_t dummy_data)
Запись фиктивных данных для передачи

microwire_ctrlword_len_t
microwire_ctrlword_len_t
Выбор длины управляющего слова для формата кадра передачи данных National Semiconductor Micorwire.
Definition hal_spi.h:174

SPI_Reset
static void SPI_Reset(SPI_Type *base)
Останов всех операций SPI.
Definition hal_spi.h:604

SPI_MasterTransferBlocking
enum spi_status SPI_MasterTransferBlocking(SPI_Type *base, spi_transfer_t *xfer)
Блокирующая дуплексная передача данных (с ожиданием завершения операции)

SPI_MasterTransferGetTotalByte
status_t SPI_MasterTransferGetTotalByte(spi_master_handle_t *handle, size_t *count)
Получение общего количества байт на передачу и прием

spi_motorola_clk_pol_t
spi_motorola_clk_pol_t
Выбор полярности тактового сигнала при отсутствия передаваемых данных в режиме Master для формата кад...
Definition hal_spi.h:246

SPI_MasterGetDefaultConfig
void SPI_MasterGetDefaultConfig(spi_config_t *config)
Инициализация конфигурации SPI значениями по умолчанию

SPI_MasterSetBaud
enum spi_status SPI_MasterSetBaud(SPI_Type *base, uint32_t baudrate_bps, uint32_t src_clock_hz)
Установка скорости передачи для SPI Master.

SPI_MasterTransferCreateHandle
enum spi_status SPI_MasterTransferCreateHandle(SPI_Type *base, spi_master_handle_t *handle, spi_master_callback_t callback, void *user_data)
Инициализация дескриптора SPI Master.

SPI_MasterTransferGetRemainingByte
status_t SPI_MasterTransferGetRemainingByte(spi_master_handle_t *handle, size_t *count)
Получение количества оставшихся байт для передачи и приема

spi_frame_format_t
spi_frame_format_t
Формат кадра передачи данных
Definition hal_spi.h:159

SPI_SlaveInit
enum spi_status SPI_SlaveInit(SPI_Type *base, const spi_config_t *config)
Инициализация SPI заданной конфигурацией

SPI_DisableInterrupts
static void SPI_DisableInterrupts(SPI_Type *base, uint32_t irqs)
Отключение прерываний SPI.
Definition hal_spi.h:690

SPI_WriteData
void SPI_WriteData(SPI_Type *base, uint32_t data)
Запись данных в регистр данных SPI.

SPI_MasterTransferHandleIRQ
void SPI_MasterTransferHandleIRQ(SPI_Type *base, spi_master_handle_t *handle)

SPI_MasterTransferGetByte
status_t SPI_MasterTransferGetByte(spi_master_handle_t *handle, size_t *count)
Получение количества переданных и принятых байт

SPI_IsEnable
static bool SPI_IsEnable(SPI_Type *base)
Получение статуса модуля SPI включено/выключено
Definition hal_spi.h:589

SPI_EnableRxDMA
void SPI_EnableRxDMA(SPI_Type *base, bool enable)
Включение или отключение запроса DMA от SPI RxFIFO.

SPI_Enable
static void SPI_Enable(SPI_Type *base, bool enable)
Включение или отключение модуль SPI Master или Slave.
Definition hal_spi.h:574

SPI_EnableTxDMA
void SPI_EnableTxDMA(SPI_Type *base, bool enable)
Включение или отключение запроса DMA от SPI TxFIFO.

SPI_SlaveTransferGetByte
static status_t SPI_SlaveTransferGetByte(spi_slave_handle_t *handle, size_t *count)
Получение количества байт для обмена
Definition hal_spi.h:1073

spi_rxfifo_watermark_t
spi_rxfifo_watermark_t
Триггер уровня заполнения RxFIFO.
Definition hal_spi.h:92

spi_status
spi_status
Статусы возврата из функций для драйвера SPI.
Definition hal_spi.h:49

SPI_GetConfig
spi_config_internal_t * SPI_GetConfig(SPI_Type *base)
Получение внутренней конфигурации

spi_txfifo_watermark_t
spi_txfifo_watermark_t
Триггер уровня заполнения TxFIFO.
Definition hal_spi.h:78

SPI_GetStatusFlags
static uint32_t SPI_GetStatusFlags(SPI_Type *base)
Получение флага состояния SPI.
Definition hal_spi.h:632

SPI_SlaveGetDefaultConfig
void SPI_SlaveGetDefaultConfig(spi_config_t *config)
Заполнение структуры конфигурации SPI Slave-устройства значениями по умолчанию

spi_shift_direction_t
spi_shift_direction_t
Формат передачи данных (MSB или LSB)
Definition hal_spi.h:70

SPI_Deinit
void SPI_Deinit(SPI_Type *base)
Деинициализация SPI.

SPI_ReadData
uint32_t SPI_ReadData(SPI_Type *base)
Получение данных из регистра данных SPI.

spi_master_callback_t
void(* spi_master_callback_t)(SPI_Type *base, spi_master_handle_t *handle, uint32_t status, void *user_data)
Прототип пользовательской функции обратного вызова Master SPI для вызова по окончанию обмена
Definition hal_spi.h:420

microwire_single_serial_t
microwire_single_serial_t
Выбор типа передачи (одиночная или последовательная) для формата кадра передачи данных National Semic...
Definition hal_spi.h:218

SPI_SlaveTransferCreateHandle
static status_t SPI_SlaveTransferCreateHandle(SPI_Type *base, spi_slave_handle_t *handle, spi_slave_callback_t callback, void *userData)
Инициализация slave SPI дескриптор
Definition hal_spi.h:1033

SPI_EnableInterrupts
static void SPI_EnableInterrupts(SPI_Type *base, uint32_t irqs)
Включение прерываний SPI.
Definition hal_spi.h:663

SPI_TakeDownInterrupts
static void SPI_TakeDownInterrupts(SPI_Type *base, uint32_t irqs)
Сброс флагов прерывания
Definition hal_spi.h:730

SPI_MasterInit
enum spi_status SPI_MasterInit(SPI_Type *base, const spi_config_t *config, uint32_t src_clock_hz)
Инициализация SPI модуля как Master с заданной конфигурацией

SPI_SlaveTransferHandleIRQ
static void SPI_SlaveTransferHandleIRQ(SPI_Type *base, spi_slave_handle_t *handle)
Обработчик прерываний для SPI.
Definition hal_spi.h:1096

spi_mode_t
spi_mode_t
Режим передачи (CTRLR0.TMOD)
Definition hal_spi.h:299

SPI_GetInstance
uint8_t SPI_GetInstance(SPI_Type *base)
Получение индекса модуля SPI.

SPI_MasterTransferNonBlocking
enum spi_status SPI_MasterTransferNonBlocking(SPI_Type *base, spi_master_handle_t *handle, spi_transfer_t *xfer)
Неблокирующий SPI обмен по прерыванию

SPI_CurrentStatusInterrupts
static uint32_t SPI_CurrentStatusInterrupts(SPI_Type *base)
Получение статуса прерываний
Definition hal_spi.h:708

SPI_SlaveTransferNonBlocking
static status_t SPI_SlaveTransferNonBlocking(SPI_Type *base, spi_slave_handle_t *handle, spi_transfer_t *xfer)
Неблокирующая дуплексная передача данных (без ожидания завершения операции)
Definition hal_spi.h:1053

SPI_SlaveTransferAbort
static void SPI_SlaveTransferAbort(SPI_Type *base, spi_slave_handle_t *handle)
Останов передачи для режима Slave по прерыванию.
Definition hal_spi.h:1085

SPI_MasterTransferAbort
void SPI_MasterTransferAbort(SPI_Type *base, spi_master_handle_t *handle)
Останов передачи для мастер режима

spi_status_flags
spi_status_flags
SPI флаги статусов
Definition hal_spi.h:275

SPI_MasterHalfDuplexTransferBlocking
enum spi_status SPI_MasterHalfDuplexTransferBlocking(SPI_Type *base, spi_half_duplex_transfer_t *xfer)
Блокирующая полудуплексная передача данных (с ожиданием завершения операции)

microwire_busy_ready_check_t
microwire_busy_ready_check_t
Включить/отключить проверку busy/ready флага (регистр SR) для формата кадра передачи данных National ...
Definition hal_spi.h:200

spi_slave_callback_t
void(* spi_slave_callback_t)(SPI_Type *base, spi_slave_handle_t *handle, uint32_t status, void *user_data)
Прототип пользовательской функции обратного вызова Slave SPI для вызова по окончанию обмена
Definition hal_spi.h:426

spi_frame_width_t
spi_frame_width_t
Размер кадра данных в 32-х битном режиме передачи данных (CTRLR0.DFS_32)
Definition hal_spi.h:107

SPI_MasterHalfDuplexTransferNonBlocking
status_t SPI_MasterHalfDuplexTransferNonBlocking(SPI_Type *base, spi_master_handle_t *handle, spi_half_duplex_transfer_t *xfer)
Выполнение неблокирующего SPI обмена по прерыванию

microwire_tx_rx_t
microwire_tx_rx_t
Направление передачи слова данных для формата кадра передачи данных National Semiconductor Microwire.
Definition hal_spi.h:209

SPI_IRQ_MultiMaster
@ SPI_IRQ_MultiMaster
Definition hal_spi.h:343

SPI_IRQ_TxFifoOverflow
@ SPI_IRQ_TxFifoOverflow
Definition hal_spi.h:347

SPI_IRQ_RxFifoOverflow
@ SPI_IRQ_RxFifoOverflow
Definition hal_spi.h:345

SPI_IRQ_RxFifoUnderflow
@ SPI_IRQ_RxFifoUnderflow
Definition hal_spi.h:346

SPI_IRQ_RxOnly
@ SPI_IRQ_RxOnly
Definition hal_spi.h:355

SPI_IRQ_TxFifoTrigger
@ SPI_IRQ_TxFifoTrigger
Definition hal_spi.h:348

SPI_IRQ_TxOnly
@ SPI_IRQ_TxOnly
Definition hal_spi.h:350

SPI_IRQ_All
@ SPI_IRQ_All
Definition hal_spi.h:361

SPI_IRQ_RxFifoTrigger
@ SPI_IRQ_RxFifoTrigger
Definition hal_spi.h:344

SPI_TransStatus_Error_2
@ SPI_TransStatus_Error_2
Definition hal_spi.h:329

SPI_TransStatus_Idle
@ SPI_TransStatus_Idle
Definition hal_spi.h:326

SPI_TransStatus_Error_3
@ SPI_TransStatus_Error_3
Definition hal_spi.h:330

SPI_TransStatus_Busy
@ SPI_TransStatus_Busy
Definition hal_spi.h:325

SPI_TransStatus_Error_4
@ SPI_TransStatus_Error_4
Definition hal_spi.h:331

SPI_TransStatus_Error_1
@ SPI_TransStatus_Error_1
Definition hal_spi.h:328

SPI_TransStatus_Error
@ SPI_TransStatus_Error
Definition hal_spi.h:327

SPI_MotorolaCapDataFalling
@ SPI_MotorolaCapDataFalling
Definition hal_spi.h:257

SPI_MotorolaCapDataRising
@ SPI_MotorolaCapDataRising
Definition hal_spi.h:256

SPI_MicrowireCtrlWordLen7Bit
@ SPI_MicrowireCtrlWordLen7Bit
Definition hal_spi.h:181

SPI_MicrowireCtrlWordLen8Bit
@ SPI_MicrowireCtrlWordLen8Bit
Definition hal_spi.h:182

SPI_MicrowireCtrlWordLen11Bit
@ SPI_MicrowireCtrlWordLen11Bit
Definition hal_spi.h:185

SPI_MicrowireCtrlWordLen9Bit
@ SPI_MicrowireCtrlWordLen9Bit
Definition hal_spi.h:183

SPI_MicrowireCtrlWordLen2Bit
@ SPI_MicrowireCtrlWordLen2Bit
Definition hal_spi.h:176

SPI_MicrowireCtrlWordLen3Bit
@ SPI_MicrowireCtrlWordLen3Bit
Definition hal_spi.h:177

SPI_MicrowireCtrlWordLen5Bit
@ SPI_MicrowireCtrlWordLen5Bit
Definition hal_spi.h:179

SPI_MicrowireCtrlWordLen12Bit
@ SPI_MicrowireCtrlWordLen12Bit
Definition hal_spi.h:186

SPI_MicrowireCtrlWordLen4Bit
@ SPI_MicrowireCtrlWordLen4Bit
Definition hal_spi.h:178

SPI_MicrowireCtrlWordLen13Bit
@ SPI_MicrowireCtrlWordLen13Bit
Definition hal_spi.h:187

SPI_MicrowireCtrlWordLen6Bit
@ SPI_MicrowireCtrlWordLen6Bit
Definition hal_spi.h:180

SPI_MicrowireCtrlWordLen16Bit
@ SPI_MicrowireCtrlWordLen16Bit
Definition hal_spi.h:190

SPI_MicrowireCtrlWordLen14Bit
@ SPI_MicrowireCtrlWordLen14Bit
Definition hal_spi.h:188

SPI_MicrowireCtrlWordLen10Bit
@ SPI_MicrowireCtrlWordLen10Bit
Definition hal_spi.h:184

SPI_MicrowireCtrlWordLen1Bit
@ SPI_MicrowireCtrlWordLen1Bit
Definition hal_spi.h:175

SPI_MicrowireCtrlWordLen15Bit
@ SPI_MicrowireCtrlWordLen15Bit
Definition hal_spi.h:189

SPI_MotorolaClkPolHi
@ SPI_MotorolaClkPolHi
Definition hal_spi.h:248

SPI_MotorolaClkPolLow
@ SPI_MotorolaClkPolLow
Definition hal_spi.h:247

SPI_FfTexas
@ SPI_FfTexas
Definition hal_spi.h:161

SPI_FfMicrowire
@ SPI_FfMicrowire
Definition hal_spi.h:162

SPI_FfMotorola
@ SPI_FfMotorola
Definition hal_spi.h:160

SPI_RxFifoWatermark3
@ SPI_RxFifoWatermark3
Definition hal_spi.h:95

SPI_RxFifoWatermark2
@ SPI_RxFifoWatermark2
Definition hal_spi.h:94

SPI_RxFifoWatermark8
@ SPI_RxFifoWatermark8
Definition hal_spi.h:100

SPI_RxFifoWatermark6
@ SPI_RxFifoWatermark6
Definition hal_spi.h:98

SPI_RxFifoWatermark5
@ SPI_RxFifoWatermark5
Definition hal_spi.h:97

SPI_RxFifoWatermark4
@ SPI_RxFifoWatermark4
Definition hal_spi.h:96

SPI_RxFifoWatermark1
@ SPI_RxFifoWatermark1
Definition hal_spi.h:93

SPI_RxFifoWatermark7
@ SPI_RxFifoWatermark7
Definition hal_spi.h:99

SPI_Status_IncorrectCall
@ SPI_Status_IncorrectCall
Definition hal_spi.h:63

SPI_Status_RxRingBufferOverrun
@ SPI_Status_RxRingBufferOverrun
Definition hal_spi.h:60

SPI_Status_NoTransferInProgress
@ SPI_Status_NoTransferInProgress
Definition hal_spi.h:62

SPI_Status_Busy
@ SPI_Status_Busy
Definition hal_spi.h:56

SPI_Status_Timeout
@ SPI_Status_Timeout
Definition hal_spi.h:54

SPI_Status_RxError
@ SPI_Status_RxError
Definition hal_spi.h:59

SPI_Status_UnexpectedState
@ SPI_Status_UnexpectedState
Definition hal_spi.h:64

SPI_Status_TxError
@ SPI_Status_TxError
Definition hal_spi.h:58

SPI_Status_ReadOnly
@ SPI_Status_ReadOnly
Definition hal_spi.h:52

SPI_Status_Ok
@ SPI_Status_Ok
Definition hal_spi.h:50

SPI_Status_RxFifoBufferOverrun
@ SPI_Status_RxFifoBufferOverrun
Definition hal_spi.h:61

SPI_Status_Idle
@ SPI_Status_Idle
Definition hal_spi.h:57

SPI_Status_BaudrateNotSupport
@ SPI_Status_BaudrateNotSupport
Definition hal_spi.h:55

SPI_Status_InvalidArgument
@ SPI_Status_InvalidArgument
Definition hal_spi.h:53

SPI_Status_Fail
@ SPI_Status_Fail
Definition hal_spi.h:51

SPI_TxFifoWatermark0
@ SPI_TxFifoWatermark0
Definition hal_spi.h:79

SPI_TxFifoWatermark7
@ SPI_TxFifoWatermark7
Definition hal_spi.h:86

SPI_TxFifoWatermark2
@ SPI_TxFifoWatermark2
Definition hal_spi.h:81

SPI_TxFifoWatermark4
@ SPI_TxFifoWatermark4
Definition hal_spi.h:83

SPI_TxFifoWatermark3
@ SPI_TxFifoWatermark3
Definition hal_spi.h:82

SPI_TxFifoWatermark1
@ SPI_TxFifoWatermark1
Definition hal_spi.h:80

SPI_TxFifoWatermark6
@ SPI_TxFifoWatermark6
Definition hal_spi.h:85

SPI_TxFifoWatermark5
@ SPI_TxFifoWatermark5
Definition hal_spi.h:84

SPI_ShiftDirLsbFirst
@ SPI_ShiftDirLsbFirst
Definition hal_spi.h:72

SPI_ShiftDirMsbFirst
@ SPI_ShiftDirMsbFirst
Definition hal_spi.h:71

SPI_MicrowireSingle
@ SPI_MicrowireSingle
Definition hal_spi.h:219

SPI_MicrowireSerial
@ SPI_MicrowireSerial
Definition hal_spi.h:220

SPI_ModeSimplexRx
@ SPI_ModeSimplexRx
Definition hal_spi.h:302

SPI_ModeSimplexTx
@ SPI_ModeSimplexTx
Definition hal_spi.h:301

SPI_ModeHalfDuplex
@ SPI_ModeHalfDuplex
Definition hal_spi.h:303

SPI_ModeDuplex
@ SPI_ModeDuplex
Definition hal_spi.h:300

SPI_RxFullFlag
@ SPI_RxFullFlag
Definition hal_spi.h:279

SPI_TxEmptyFlag
@ SPI_TxEmptyFlag
Definition hal_spi.h:277

SPI_RxNotEmptyFlag
@ SPI_RxNotEmptyFlag
Definition hal_spi.h:278

SPI_TxNotFullFlag
@ SPI_TxNotFullFlag
Definition hal_spi.h:276

SPI_MicrowireBusyReadyCheckEnable
@ SPI_MicrowireBusyReadyCheckEnable
Definition hal_spi.h:202

SPI_MicrowireBusyReadyCheckDisable
@ SPI_MicrowireBusyReadyCheckDisable
Definition hal_spi.h:201

SPI_Data21Bits
@ SPI_Data21Bits
Definition hal_spi.h:125

SPI_Data17Bits
@ SPI_Data17Bits
Definition hal_spi.h:121

SPI_Data10Bits
@ SPI_Data10Bits
Definition hal_spi.h:114

SPI_Data16Bits
@ SPI_Data16Bits
Definition hal_spi.h:120

SPI_Data19Bits
@ SPI_Data19Bits
Definition hal_spi.h:123

SPI_Data24Bits
@ SPI_Data24Bits
Definition hal_spi.h:128

SPI_Data28Bits
@ SPI_Data28Bits
Definition hal_spi.h:132

SPI_Data25Bits
@ SPI_Data25Bits
Definition hal_spi.h:129

SPI_Data20Bits
@ SPI_Data20Bits
Definition hal_spi.h:124

SPI_Data6Bits
@ SPI_Data6Bits
Definition hal_spi.h:110

SPI_Data13Bits
@ SPI_Data13Bits
Definition hal_spi.h:117

SPI_Data7Bits
@ SPI_Data7Bits
Definition hal_spi.h:111

SPI_Data11Bits
@ SPI_Data11Bits
Definition hal_spi.h:115

SPI_Data15Bits
@ SPI_Data15Bits
Definition hal_spi.h:119

SPI_Data8Bits
@ SPI_Data8Bits
Definition hal_spi.h:112

SPI_Data22Bits
@ SPI_Data22Bits
Definition hal_spi.h:126

SPI_Data29Bits
@ SPI_Data29Bits
Definition hal_spi.h:133

SPI_Data27Bits
@ SPI_Data27Bits
Definition hal_spi.h:131

SPI_Data4Bits
@ SPI_Data4Bits
Definition hal_spi.h:108

SPI_Data18Bits
@ SPI_Data18Bits
Definition hal_spi.h:122

SPI_Data9Bits
@ SPI_Data9Bits
Definition hal_spi.h:113

SPI_Data26Bits
@ SPI_Data26Bits
Definition hal_spi.h:130

SPI_Data30Bits
@ SPI_Data30Bits
Definition hal_spi.h:134

SPI_Data32Bits
@ SPI_Data32Bits
Definition hal_spi.h:136

SPI_Data31Bits
@ SPI_Data31Bits
Definition hal_spi.h:135

SPI_Data5Bits
@ SPI_Data5Bits
Definition hal_spi.h:109

SPI_Data14Bits
@ SPI_Data14Bits
Definition hal_spi.h:118

SPI_Data12Bits
@ SPI_Data12Bits
Definition hal_spi.h:116

SPI_Data23Bits
@ SPI_Data23Bits
Definition hal_spi.h:127

SPI_MicrowireTx
@ SPI_MicrowireTx
Definition hal_spi.h:210

SPI_MicrowireRx
@ SPI_MicrowireRx
Definition hal_spi.h:211

spi_config_internal_t
Внутренняя структура конфигурации модуля SPI.
Definition hal_spi.h:396

spi_config_internal_t::shift_dir
spi_shift_direction_t shift_dir
Definition hal_spi.h:397

spi_config_internal_t::frame_width_bytes
uint8_t frame_width_bytes
Definition hal_spi.h:399

spi_config_internal_t::frame_width_bits
uint8_t frame_width_bits
Definition hal_spi.h:398

spi_config_t
Структура конфигурации для Master SPI.
Definition hal_spi.h:309

spi_config_t::baud_rate_bps
uint32_t baud_rate_bps
Definition hal_spi.h:312

spi_config_t::loopback_enable
bool loopback_enable
Definition hal_spi.h:311

spi_config_t::frame_format
spi_frame_format_t frame_format
Definition hal_spi.h:316

spi_config_t::direction
spi_shift_direction_t direction
Definition hal_spi.h:315

spi_config_t::motorola_cfg
spi_motorola_cfg_t motorola_cfg
Definition hal_spi.h:318

spi_config_t::data_width_bits
spi_frame_width_t data_width_bits
Definition hal_spi.h:314

spi_config_t::microwire_cfg
spi_microwire_cfg_t microwire_cfg
Definition hal_spi.h:317

spi_half_duplex_transfer_t
Структура SPI для полудуплексной приемо-передачи в режиме Master.
Definition hal_spi.h:386

spi_half_duplex_transfer_t::tx_data_size
size_t tx_data_size
Definition hal_spi.h:389

spi_half_duplex_transfer_t::tx_data
uint8_t * tx_data
Definition hal_spi.h:387

spi_half_duplex_transfer_t::rx_data_size
size_t rx_data_size
Definition hal_spi.h:390

spi_half_duplex_transfer_t::rx_data
uint8_t * rx_data
Definition hal_spi.h:388

spi_handle
SPI структура дескриптора для работы по прерыванию
Definition hal_spi.h:437

spi_handle::frame_width_bits
uint8_t frame_width_bits
Definition hal_spi.h:447

spi_handle::tx_data
volatile uint8_t * tx_data
Definition hal_spi.h:438

spi_handle::callback
spi_master_callback_t callback
Definition hal_spi.h:445

spi_handle::rx_data
volatile uint8_t * rx_data
Definition hal_spi.h:439

spi_handle::total_byte_to_transfer
size_t total_byte_to_transfer
Definition hal_spi.h:443

spi_handle::rx_remaining_bytes
volatile size_t rx_remaining_bytes
Definition hal_spi.h:441

spi_handle::tx_remaining_bytes
volatile size_t tx_remaining_bytes
Definition hal_spi.h:440

spi_handle::instance
int8_t instance
Definition hal_spi.h:442

spi_handle::mode
spi_mode_t mode
Definition hal_spi.h:449

spi_handle::frame_width_bytes
uint8_t frame_width_bytes
Definition hal_spi.h:448

spi_handle::user_data
void * user_data
Definition hal_spi.h:446

spi_handle::state
int32_t state
Definition hal_spi.h:444

spi_microwire_cfg_t
Конфигурация для протокола Microwire National Semiconductor.
Definition hal_spi.h:226

spi_microwire_cfg_t::busy_ready_check
microwire_busy_ready_check_t busy_ready_check
Definition hal_spi.h:228

spi_microwire_cfg_t::tx_rx
microwire_tx_rx_t tx_rx
Definition hal_spi.h:229

spi_microwire_cfg_t::single_serial
microwire_single_serial_t single_serial
Definition hal_spi.h:230

spi_microwire_cfg_t::ctrl_word_len
microwire_ctrlword_len_t ctrl_word_len
Definition hal_spi.h:227

spi_motorola_cfg_t
Конфигурация для протокола Motorola SPI.
Definition hal_spi.h:263

spi_motorola_cfg_t::clk_pol
spi_motorola_clk_pol_t clk_pol
Definition hal_spi.h:264

spi_motorola_cfg_t::cap_data
spi_motorola_cap_data_t cap_data
Definition hal_spi.h:265

spi_transfer_t
Структура SPI для приемо-передачи
Definition hal_spi.h:377

spi_transfer_t::rx_data
uint8_t * rx_data
Definition hal_spi.h:379

spi_transfer_t::tx_data
uint8_t * tx_data
Definition hal_spi.h:378

spi_transfer_t::data_size
size_t data_size
Definition hal_spi.h:380