From cc432b761c884a0bd8e9d83db0a4e26109fc08b1 Mon Sep 17 00:00:00 2001 From: chen <15335560115@163.com> Date: 星期五, 08 十一月 2024 15:35:38 +0800 Subject: [PATCH] 安邦手环GPS删除部分无用数据和修改4G波特率9600出厂测试固件 --- keil/include/drivers/mk_spi.h | 318 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 318 insertions(+), 0 deletions(-) diff --git a/keil/include/drivers/mk_spi.h b/keil/include/drivers/mk_spi.h new file mode 100644 index 0000000..5f41bd1 --- /dev/null +++ b/keil/include/drivers/mk_spi.h @@ -0,0 +1,318 @@ +/* + * Copyright (c) 2019-2023 Beijing Hanwei Innovation Technology Ltd. Co. and + * its subsidiaries and affiliates (collectly called MKSEMI). + * + * All rights reserved. + * + * 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, except as embedded into an MKSEMI + * integrated circuit in a product or a software update for such product, + * 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 MKSEMI nor the names of its contributors may be used + * to endorse or promote products derived from this software without + * specific prior written permission. + * + * 4. This software, with or without modification, must only be used with a + * MKSEMI integrated circuit. + * + * 5. Any software provided in binary form under this license must not be + * reverse engineered, decompiled, modified and/or disassembled. + * + * THIS SOFTWARE IS PROVIDED BY MKSEMI "AS IS" AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL MKSEMI 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. + */ + +#ifndef MK_SPI_H_ +#define MK_SPI_H_ + +#include "mk_common.h" +#include "mk_dma.h" + +#ifndef SPI_INT_MODE_EN +#define SPI_INT_MODE_EN (1) +#endif + +#ifndef SPI_DMA_MODE_EN +#define SPI_DMA_MODE_EN (1) +#endif + +#ifndef SPI_POLL_MODE_EN +#define SPI_POLL_MODE_EN (1) +#endif + +/** + * @addtogroup MK8000_SPI + * @{ + */ + +#define SPI_SCR_MAX (255) +#define SPI_SCR_MIN (0) + +#define SPI_CPSDVSR_MAX (254) +#define SPI_CPSDVSR_MIN (2) + +#define SPI_DATA_BITS_MAX (16) +#define SPI_DATA_BITS_MIN (4) + +#define SPI_DMA_ABORT_TX (1 << 0) +#define SPI_DMA_ABORT_RX (1 << 1) + +/** + * @brief SPI device IDs enumeration + */ +enum SPI_DEV_T +{ + SPI_ID0 = 0, + SPI_ID1, + SPI_MAX_NUM +}; + +/** + * @brief SPI state enumeration + */ +enum SPI_STATE_T +{ + SPI_STATE_RESET = 0x00U, /*!< Peripheral not Initialized */ + SPI_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */ + SPI_STATE_BUSY_TX = 0x10U, /*!< Data Transmission process is ongoing */ + SPI_STATE_BUSY_RX = 0x20U, /*!< Data Reception process is ongoing */ + SPI_STATE_BUSY_TX_RX = 0x30U, /*!< Data Transmission and Reception process is ongoing */ + SPI_STATE_TIMEOUT = 0x40U, /*!< SPI timeout */ + SPI_STATE_ERROR = 0x80U, /*!< SPI error state */ +}; + +/** + * @brief SPI config structure + */ +struct SPI_CFG_T +{ + uint32_t bit_rate; /*!< Specifies the bit rate */ + uint8_t data_bits; /*!< Specifies the data bits. \n + This parameter ranges from SPI_DATA_BITS_MIN to SPI_DATA_BITS_MAX. + */ + uint8_t slave : 1; /*!< Specifies the SPI operating mode. \n + This parameter will be one of the following values: + @arg 0 master mode + @arg 1 slave mode + */ + uint8_t clk_phase : 1; /*!< Specifies the clock active edge for the bit capture. \n + This parameter will be one of the following values: + @arg 0 first edge + @arg 1 second edge + */ + uint8_t clk_polarity : 1; /*!< Specifies the serial clock steady state. \n + This parameter will be one of the following values: + @arg 0 low level + @arg 1 high level + */ + uint8_t ti_mode : 1; /*!< Specifies whether the TI mode is enabled or disabled. \n + This parameter will be one of the following values: + @arg 0 disabled + @arg 1 enabled + */ + uint8_t dma_rx : 1; /*!< Specifies whether the dma Rx is enabled or disabled. \n + This parameter will be one of the following values: + @arg 0 disabled + @arg 1 enabled + */ + uint8_t dma_tx : 1; /*!< Specifies whether the dma Tx is enabled or disabled. \n + This parameter will be one of the following values: + @arg 0 disabled + @arg 1 enabled + */ + uint8_t int_rx : 1; /*!< Specifies whether Rx interupt in the NVIC interrupt controller is enabled or disabled. \n + This parameter will be one of the following values: + @arg 0 disabled + @arg 1 enabled + */ + uint8_t int_tx : 1; /*!< Specifies whether Tx interupt in the NVIC interrupt controller is enabled or disabled. \n + This parameter will be one of the following values: + @arg 0 disabled + @arg 1 enabled + */ + uint8_t reserved[2]; /*!< reserved */ +}; + +/** + * @brief SPI handle Structure + */ +struct SPI_HANDLE_T +{ + SPI_TypeDef *const base; /*!< SPI registers base address */ + const IRQn_Type irq; /*!< SPI interupt number */ + enum DMA_CH_T dma_rx_ch; /*!< SPI dma Rx channel */ + enum DMA_CH_T dma_tx_ch; /*!< SPI dma Tx channel */ + __IOM enum SPI_STATE_T state; /*!< SPI state */ + uint8_t slave : 1; /*!< SPI operating mode switch */ + uint8_t dma_rx : 1; /*!< SPI dma Rx switch */ + uint8_t dma_tx : 1; /*!< SPI dma Tx switch */ + uint8_t int_rx : 1; /*!< SPI Rx interupt switch */ + uint8_t int_tx : 1; /*!< SPI Tx interupt switch */ + uint8_t reserved0 : 3; /*!< reserved */ + uint8_t reserved1; /*!< reserved */ + uint16_t tx_dummy; /*!< SPI send data when receive data only */ + uint8_t *tx_buff; /*!< Pointer to SPI Tx transfer Buffer */ + uint32_t tx_size; /*!< SPI Tx Transfer size */ + __IOM uint32_t tx_count; /*!< SPI Tx Transfer Counter */ + uint8_t *rx_buff; /*!< Pointer to SPI Rx transfer Buffer */ + uint32_t rx_size; /*!< SPI Rx Transfer size */ + __IOM uint32_t rx_count; /*!< SPI Rx Transfer Counter */ + drv_callback_t tx_callback; /*!< Pointer to SPI Tx Callback function */ + drv_callback_t rx_callback; /*!< Pointer to SPI Rx Callback function */ + drv_callback_t tx_abort_callback; /*!< Pointer to SPI Tx abort Callback function */ + drv_callback_t rx_abort_callback; /*!< Pointer to SPI Rx abort Callback function */ +}; + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @brief open SPI + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @param[in] config pointer to a SPI_CFG_T structure that contains the configuration information for SPI. \n + * @return + * @arg DRV_ERROR error id + * @arg DEV_OK open succeed + */ +int spi_open(enum SPI_DEV_T id, struct SPI_CFG_T *config); + +/** + * @brief close SPI + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @return + * @arg DRV_ERROR error id + * @arg DEV_OK open succeed + */ +int spi_close(enum SPI_DEV_T id); + +/** + * @brief Sends an amount of data. + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @param[in] tx_buf Pointer to data buffer + * @param[in] len Bytes of data to be sent + * @param[in] callback Pointer to SPI Tx Callback function. + * @return + * @arg DRV_ERROR error id + * @arg DRV_BUSY send failed because of SPI Tx is busy + * @arg DEV_OK send succeed + */ +int spi_send(enum SPI_DEV_T id, uint8_t *tx_buf, uint32_t len, drv_callback_t callback); + +/** + * @brief Receive an amount of data. + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @param[out] rx_buf Pointer to data buffer + * @param[in] len Bytes of data to be received + * @param[in] callback Pointer to SPI Rx Callback function. + * @return + * @arg DRV_ERROR error id + * @arg DRV_BUSY send failed because of SPI Tx is busy + * @arg DEV_OK send succeed + */ +int spi_receive(enum SPI_DEV_T id, uint8_t *rx_buf, uint32_t len, drv_callback_t callback); + +/** + * @brief Send and Receive an amount of data. + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @param[in] tx_buf Pointer to data buffer + * @param[out] rx_buf Pointer to data buffer + * @param[in] len Bytes of data to be sent and received + * @param[in] callback Pointer to SPI transfter Callback function. + * @return + * @arg DRV_ERROR error id + * @arg DRV_BUSY send failed because of SPI Tx is busy + * @arg DEV_OK send succeed + */ +int spi_transfer(enum SPI_DEV_T id, uint8_t *tx_buf, uint8_t *rx_buf, uint32_t len, drv_callback_t callback); + +/** + * @brief Check whether the SPI is busy + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @return + * @arg true SPI is busy + * @arg false SPI is idle + */ +bool spi_is_busy(enum SPI_DEV_T id); + +/** + * @brief Get SPI state + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 uart0 + * @arg SPI_ID1 uart1 + * @return + * @arg SPI_STATE_T SPI state + */ +enum SPI_STATE_T spi_state_get(enum SPI_DEV_T id); + +/** + * @brief Abort ongoing transfer + * @param[in] id SPI device ID. \n + * This parameter should be one of the SPI_DEV_T enum values as below + * @arg SPI_ID0 spi0 + * @arg SPI_ID1 spi1 + * @note This function is used to terminate the ongoing spi tx and rx communication, + * if the tx or rx communication is completed before spi dma abort, the callback function + * will not be called. + * @param[in] abort_direction SPI_DMA_ABORT_TX abort spi dma tx, SPI_DMA_ABORT_RX abort spi dma rx + * @param[in] abort_tx_callback DMA SPI tx communication abort callback + * @param[in] abort_rx_callback DMA SPI rx communication abort callback + * @return @arg DRV_ERROR Abort error + * @arg DEV_OK Disable SPI DMA tx/rx request succeed + */ +int spi_abort_dma(enum SPI_DEV_T id, uint32_t abort_direction, drv_callback_t abort_tx_callback, drv_callback_t abort_rx_callback); + +/** + * @brief This function handles SP0 interrupt. + */ +void SPI0_IRQHandler(void); + +/** + * @brief This function handles SP1 interrupt. + */ +void SPI1_IRQHandler(void); + +#ifdef __cplusplus +} +#endif + +/** + * @} + */ + +#endif /* MK_SPI_H_ */ -- Gitblit v1.9.3