-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
hal: renesas: ra: Initial support for SPI
Initial HAL layer support for SPI driver Signed-off-by: TriNguyen <[email protected]> Signed-off-by: Thao Luong <[email protected]>
- Loading branch information
1 parent
7a6ef38
commit 6ebe2c4
Showing
4 changed files
with
1,511 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,187 @@ | ||
| /* | ||
| * Copyright (c) 2020 - 2024 Renesas Electronics Corporation and/or its affiliates | ||
| * | ||
| * SPDX-License-Identifier: BSD-3-Clause | ||
| */ | ||
|
|
||
| #ifndef R_SPI_H | ||
| #define R_SPI_H | ||
|
|
||
| /*******************************************************************************************************************//** | ||
| * @addtogroup SPI | ||
| * @{ | ||
| **********************************************************************************************************************/ | ||
|
|
||
| /*********************************************************************************************************************** | ||
| * Includes | ||
| **********************************************************************************************************************/ | ||
| #include "r_spi_api.h" | ||
|
|
||
| /* Common macro for FSP header files. There is also a corresponding FSP_FOOTER macro at the end of this file. */ | ||
| FSP_HEADER | ||
|
|
||
| /*********************************************************************************************************************** | ||
| * Macro definitions | ||
| **********************************************************************************************************************/ | ||
|
|
||
| /************************************************************************************************* | ||
| * Type defines for the SPI interface API | ||
| *************************************************************************************************/ | ||
|
|
||
| /** 3-Wire or 4-Wire mode. */ | ||
| typedef enum e_spi_ssl_mode | ||
| { | ||
| SPI_SSL_MODE_SPI, ///< SPI operation (4-wire method) | ||
| SPI_SSL_MODE_CLK_SYN ///< Clock Synchronous operation (3-wire method) | ||
| } spi_ssl_mode_t; | ||
|
|
||
| /** Transmit Only (Half Duplex), or Full Duplex. */ | ||
| typedef enum e_spi_communication | ||
| { | ||
| SPI_COMMUNICATION_FULL_DUPLEX, ///< Full-Duplex synchronous serial communication | ||
| SPI_COMMUNICATION_TRANSMIT_ONLY ///< Transit only serial communication | ||
| } spi_communication_t; | ||
|
|
||
| /** Slave Select Polarity. */ | ||
| typedef enum e_spi_sslp | ||
| { | ||
| SPI_SSLP_LOW, ///< SSLP signal polarity active low | ||
| SPI_SSLP_HIGH ///< SSLP signal polarity active high | ||
| } spi_ssl_polarity_t; | ||
|
|
||
| /** The Slave Select Line */ | ||
| typedef enum e_spi_ssl_select | ||
| { | ||
| SPI_SSL_SELECT_SSL0, ///< Select SSL0 | ||
| SPI_SSL_SELECT_SSL1, ///< Select SSL1 | ||
| SPI_SSL_SELECT_SSL2, ///< Select SSL2 | ||
| SPI_SSL_SELECT_SSL3 ///< Select SSL3 | ||
| } spi_ssl_select_t; | ||
|
|
||
| /** MOSI Idle Behavior. */ | ||
| typedef enum e_spi_mosi_idle_value_fixing | ||
| { | ||
| SPI_MOSI_IDLE_VALUE_FIXING_DISABLE, ///< MOSI output value=value set in MOIFV bit | ||
| SPI_MOSI_IDLE_VALUE_FIXING_LOW, ///< MOSIn level low during MOSI idling | ||
| SPI_MOSI_IDLE_VALUE_FIXING_HIGH ///< MOSIn level high during MOSI idling | ||
| } spi_mosi_idle_value_fixing_t; | ||
|
|
||
| /** Parity Mode */ | ||
| typedef enum e_spi_parity_mode | ||
| { | ||
| SPI_PARITY_MODE_DISABLE, ///< Disable parity | ||
| SPI_PARITY_MODE_ODD, ///< Select even parity | ||
| SPI_PARITY_MODE_EVEN ///< Select odd parity | ||
| } spi_parity_t; | ||
|
|
||
| /** Byte Swapping Enable/Disable. */ | ||
| typedef enum | ||
| { | ||
| SPI_BYTE_SWAP_DISABLE = 0, ///< Disable Byte swapping for 16/32-Bit transfers | ||
| SPI_BYTE_SWAP_ENABLE ///< Enable Byte swapping for 16/32-Bit transfers | ||
| } spi_byte_swap_t; | ||
|
|
||
| /** Delay count for SPI delay settings. */ | ||
| typedef enum e_spi_clock_delay_count | ||
| { | ||
| SPI_DELAY_COUNT_1, ///< Set RSPCK delay count to 1 RSPCK | ||
| SPI_DELAY_COUNT_2, ///< Set RSPCK delay count to 2 RSPCK | ||
| SPI_DELAY_COUNT_3, ///< Set RSPCK delay count to 3 RSPCK | ||
| SPI_DELAY_COUNT_4, ///< Set RSPCK delay count to 4 RSPCK | ||
| SPI_DELAY_COUNT_5, ///< Set RSPCK delay count to 5 RSPCK | ||
| SPI_DELAY_COUNT_6, ///< Set RSPCK delay count to 6 RSPCK | ||
| SPI_DELAY_COUNT_7, ///< Set RSPCK delay count to 7 RSPCK | ||
| SPI_DELAY_COUNT_8 ///< Set RSPCK delay count to 8 RSPCK | ||
| } spi_delay_count_t; | ||
|
|
||
| /** SPI Clock Divider settings. */ | ||
| typedef struct | ||
| { | ||
| uint8_t spbr; ///< SPBR register setting | ||
| uint8_t brdv : 2; ///< BRDV setting in SPCMD0 | ||
| } rspck_div_setting_t; | ||
|
|
||
| /** Extended SPI interface configuration */ | ||
| typedef struct st_spi_extended_cfg | ||
| { | ||
| spi_ssl_mode_t spi_clksyn; ///< Select spi or clock syn mode operation | ||
| spi_communication_t spi_comm; ///< Select full-duplex or transmit-only communication | ||
| spi_ssl_polarity_t ssl_polarity; ///< Select SSLn signal polarity | ||
| spi_ssl_select_t ssl_select; ///< Select which slave to use: 0-SSL0, 1-SSL1, 2-SSL2, 3-SSL3 | ||
| spi_mosi_idle_value_fixing_t mosi_idle; ///< Select MOSI idle fixed value and selection | ||
| spi_parity_t parity; ///< Select parity and enable/disable parity | ||
| spi_byte_swap_t byte_swap; ///< Select byte swap mode | ||
| rspck_div_setting_t spck_div; ///< Register values for configuring the SPI Clock Divider. | ||
| spi_delay_count_t spck_delay; ///< SPI Clock Delay Register Setting | ||
| spi_delay_count_t ssl_negation_delay; ///< SPI Slave Select Negation Delay Register Setting | ||
| spi_delay_count_t next_access_delay; ///< SPI Next-Access Delay Register Setting | ||
| } spi_extended_cfg_t; | ||
|
|
||
| /** Channel control block. DO NOT INITIALIZE. Initialization occurs when @ref spi_api_t::open is called. */ | ||
| typedef struct st_spi_instance_ctrl | ||
| { | ||
| uint32_t open; ///< Indicates whether the open() API has been successfully called. | ||
| spi_cfg_t const * p_cfg; ///< Pointer to instance configuration | ||
| R_SPI0_Type * p_regs; ///< Base register for this channel | ||
| void const * p_tx_data; ///< Buffer to transmit | ||
| void * p_rx_data; ///< Buffer to receive | ||
| uint32_t tx_count; ///< Number of Data Frames to transfer (8-bit, 16-bit, 32-bit) | ||
| uint32_t rx_count; ///< Number of Data Frames to transfer (8-bit, 16-bit, 32-bit) | ||
| uint32_t count; ///< Number of Data Frames to transfer (8-bit, 16-bit, 32-bit) | ||
| spi_bit_width_t bit_width; ///< Bits per Data frame (8-bit, 16-bit, 32-bit) | ||
|
|
||
| /* Pointer to callback and optional working memory */ | ||
| void (* p_callback)(spi_callback_args_t *); | ||
| spi_callback_args_t * p_callback_memory; | ||
|
|
||
| /* Pointer to context to be passed into callback function */ | ||
| void const * p_context; | ||
| } spi_instance_ctrl_t; | ||
|
|
||
| /********************************************************************************************************************** | ||
| * Exported global variables | ||
| **********************************************************************************************************************/ | ||
|
|
||
| /** @cond INC_HEADER_DEFS_SEC */ | ||
| /** Filled in Interface API structure for this Instance. */ | ||
| extern const spi_api_t g_spi_on_spi; | ||
|
|
||
| /** @endcond */ | ||
|
|
||
| /*********************************************************************************************************************** | ||
| * Public APIs | ||
| **********************************************************************************************************************/ | ||
| fsp_err_t R_SPI_Open(spi_ctrl_t * p_api_ctrl, spi_cfg_t const * const p_cfg); | ||
|
|
||
| fsp_err_t R_SPI_Read(spi_ctrl_t * const p_api_ctrl, | ||
| void * p_dest, | ||
| uint32_t const length, | ||
| spi_bit_width_t const bit_width); | ||
|
|
||
| fsp_err_t R_SPI_Write(spi_ctrl_t * const p_api_ctrl, | ||
| void const * p_src, | ||
| uint32_t const length, | ||
| spi_bit_width_t const bit_width); | ||
|
|
||
| fsp_err_t R_SPI_WriteRead(spi_ctrl_t * const p_api_ctrl, | ||
| void const * p_src, | ||
| void * p_dest, | ||
| uint32_t const length, | ||
| spi_bit_width_t const bit_width); | ||
|
|
||
| fsp_err_t R_SPI_Close(spi_ctrl_t * const p_api_ctrl); | ||
|
|
||
| fsp_err_t R_SPI_CalculateBitrate(uint32_t bitrate, rspck_div_setting_t * spck_div); | ||
| fsp_err_t R_SPI_CallbackSet(spi_ctrl_t * const p_api_ctrl, | ||
| void ( * p_callback)(spi_callback_args_t *), | ||
| void const * const p_context, | ||
| spi_callback_args_t * const p_callback_memory); | ||
|
|
||
| /*******************************************************************************************************************//** | ||
| * @} (end ingroup SPI) | ||
| **********************************************************************************************************************/ | ||
|
|
||
| /** Common macro for FSP header files. There is also a corresponding FSP_HEADER macro at the top of this file. */ | ||
| FSP_FOOTER | ||
|
|
||
| #endif |
Oops, something went wrong.