/****************************************************************************** * Copyright (C) 2017, Xiaohua Semiconductor Co.,Ltd All rights reserved. * * This software is owned and published by: * Xiaohua Semiconductor Co.,Ltd ("XHSC"). * * BY DOWNLOADING, INSTALLING OR USING THIS SOFTWARE, YOU AGREE TO BE BOUND * BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT. * * This software contains source code for use with XHSC * components. This software is licensed by XHSC to be adapted only * for use in systems utilizing XHSC components. XHSC shall not be * responsible for misuse or illegal use of this software for devices not * supported herein. XHSC is providing this software "AS IS" and will * not be responsible for issues arising from incorrect user implementation * of the software. * * Disclaimer: * XHSC MAKES NO WARRANTY, EXPRESS OR IMPLIED , ARISING BY LAW OR OTHERWISE, * REGARDING THE SOFTWARE (INCLUDING ANY ACOOMPANYING WRITTEN MATERIALS), * ITS PERFORMANCE OR SUITABILITY FOR YOUR INTENDED USE, INCLUDING, * WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, THE IMPLIED * WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE, AND THE IMPLIED * WARRANTY OF NONINFRINGEMENT. * XHSC SHALL HAVE NO LIABILITY (WHETHER IN CONTRACT, WARRANTY, TORT, * NEGLIGENCE OR OTHERWISE) FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT * LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, * LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING FROM USE OR * INABILITY TO USE THE SOFTWARE, INCLUDING, WITHOUT LIMITATION, ANY DIRECT, * INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS OF DATA, * SAVINGS OR PROFITS, * EVEN IF Disclaimer HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. * YOU ASSUME ALL RESPONSIBILITIES FOR SELECTION OF THE SOFTWARE TO ACHIEVE YOUR * INTENDED RESULTS, AND FOR THE INSTALLATION OF, USE OF, AND RESULTS OBTAINED * FROM, THE SOFTWARE. * * This software may be replicated in part or whole for the licensed use, * with the restriction that this Disclaimer and Copyright notice must be * included with each copy of this software, whether used in part or whole, * at all times. */ /*****************************************************************************/ /** \file spi.h ** ** Headerfile for SPI functions ** ** ** History: ** - 2017-05-17 1.0 Devi First Version ** *****************************************************************************/ #ifndef __SPI_H__ #define __SPI_H__ /****************************************************************************** * Include files *****************************************************************************/ #include "ddl.h" /* C binding of definitions if building with C++ compiler */ #ifdef __cplusplus extern "C" { #endif //@{ /****************************************************************************** * Global type definitions *****************************************************************************/ /** ****************************************************************************** ** \brief SPI 功能通道选择设置 ******************************************************************************/ /** ****************************************************************************** ** \brief SPI 功能使能设置 ******************************************************************************/ typedef enum en_spi_en { SpiMskEnable = 0x4u, ///< SPI模块使能 SpiMskDisable = 0u, ///< SPI模块禁止 }en_spi_en_t; /** ****************************************************************************** ** \brief SPI 模式配置 ******************************************************************************/ typedef enum en_spi_mode { SpiMskMaster = 0x10u, ///<主机 SpiMskSlave = 0x00u, ///<从机 }en_spi_mode_t; /** ****************************************************************************** ** \brief SPI 时钟极性设置 ******************************************************************************/ typedef enum en_spi_cpol { SpiMskcpollow = 0u, ///<极性为低 SpiMskcpolhigh = 0x08u, ///<极性为高 }en_spi_cpol_t; /** ****************************************************************************** ** \brief SPI 时钟相位设置 ******************************************************************************/ typedef enum en_spi_cpha { SpiMskCphafirst = 0u, ///<第一边沿采样 SpiMskCphasecond = 0x4u, ///<第二边沿采样 }en_spi_cpha_t; /** ****************************************************************************** ** \brief SPI 时钟分频配置 *****************************************************************************/ typedef enum en_spi_clk_div { SpiClkMskDiv2 = 0x00u, ///<2分频 SpiClkMskDiv4 = 0x01u, ///<4分频 SpiClkMskDiv8 = 0x02u, ///<8分频 SpiClkMskDiv16 = 0x03u, ///<16分频 SpiClkMskDiv32 = 0x80u, ///<32分频 SpiClkMskDiv64 = 0x81u, ///<64分频 SpiClkMskDiv128 = 0x82u, ///<128分频 }en_spi_clk_div_t; /** ****************************************************************************** ** \brief SPI 片选脚电平选择 *****************************************************************************/ typedef enum en_spi_cspin { SpiCsLow = 0u, ///<片选低电平 SpiCsHigh = 1u, ///<片选高电平 }en_spi_cspin_t; /** ****************************************************************************** ** \brief SPI 状态 *****************************************************************************/ typedef enum en_spi_status { SpiIf = 0x80u, ///<传输结束中断标志 SpiSserr = 0x20u, ///<从机模式错误标志 SpiMdf = 0x10u, ///<主机模式错误标志 SpiBusy = 0x08u, ///