Files
TC264_300W_Power/libraries/zf_driver/zf_driver_spi.h
2025-10-15 00:22:56 +08:00

174 lines
8.1 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*********************************************************************************************************************
* TC264 Opensourec Library 即TC264 开源库)是一个基于官方 SDK 接口的第三方开源库
* Copyright (c) 2022 SEEKFREE 逐飞科技
*
* 本文件是 TC264 开源库的一部分
*
* TC264 开源库 是免费软件
* 您可以根据自由软件基金会发布的 GPLGNU General Public License即 GNU通用公共许可证的条款
* 即 GPL 的第3版即 GPL3.0)或(您选择的)任何后来的版本,重新发布和/或修改它
*
* 本开源库的发布是希望它能发挥作用,但并未对其作任何的保证
* 甚至没有隐含的适销性或适合特定用途的保证
* 更多细节请参见 GPL
*
* 您应该在收到本开源库的同时收到一份 GPL 的副本
* 如果没有,请参阅<https://www.gnu.org/licenses/>
*
* 额外注明:
* 本开源库使用 GPL3.0 开源许可证协议 以上许可申明为译文版本
* 许可申明英文版在 libraries/doc 文件夹下的 GPL3_permission_statement.txt 文件中
* 许可证副本在 libraries 文件夹下 即该文件夹下的 LICENSE 文件
* 欢迎各位使用并传播本程序 但修改内容时必须保留逐飞科技的版权声明(即本声明)
*
* 文件名称 zf_driver_spi
* 公司名称 成都逐飞科技有限公司
* 版本信息 查看 libraries/doc 文件夹内 version 文件 版本说明
* 开发环境 ADS v1.10.2
* 适用平台 TC264D
* 店铺链接 https://seekfree.taobao.com/
*
* 修改记录
* 日期 作者 备注
* 2022-09-15 pudding first version
* 2023-04-28 pudding 修复多个SPI同时使用可能产生冲突的问题
********************************************************************************************************************/
#ifndef _zf_driver_spi_h_
#define _zf_driver_spi_h_
#include "zf_common_typedef.h"
typedef enum // SPI模块号
{
SPI_0,
SPI_1,
SPI_2,
SPI_3,
}spi_index_enum;
typedef enum // 枚举 SPI 模式 此枚举定义不允许用户修改
{
SPI_MODE0,
SPI_MODE1,
SPI_MODE2,
SPI_MODE3,
}spi_mode_enum;
typedef enum // 枚举SPI CLK引脚 此枚举定义不允许用户修改
{
SPI0_SCLK_P20_11 = 0*102+0*6 , SPI0_SCLK_P20_13, // SPI0 CLK 引脚可选范围
SPI1_SCLK_P10_2 = 1*102+0*6 , SPI1_SCLK_P11_6, // SPI1 CLK 引脚可选范围
SPI2_SCLK_P13_0 = 2*102+0*6 , SPI2_SCLK_P13_1, SPI2_SCLK_P15_3, SPI2_SCLK_P15_6, SPI2_SCLK_P15_8, // SPI2 CLK 引脚可选范围
SPI3_SCLK_P02_7 = 3*102+0*6 , SPI3_SCLK_P22_0, SPI3_SCLK_P22_1, SPI3_SCLK_P22_3, SPI3_SCLK_P33_11, // SPI3 CLK 引脚可选范围
}spi_sck_pin_enum;
typedef enum // 枚举SPI MOSI引脚 此枚举定义不允许用户修改
{
SPI0_MOSI_P20_12 = 0*102+1*6 , SPI0_MOSI_P20_14, // SPI0 MOSI引脚可选范围
SPI1_MOSI_P10_1 = 1*102+1*6 , SPI1_MOSI_P10_3, SPI1_MOSI_P11_9, // SPI1 MOSI引脚可选范围
SPI2_MOSI_P13_3 = 2*102+1*6 , SPI2_MOSI_P15_5, SPI2_MOSI_P15_6, // SPI2 MOSI引脚可选范围
SPI3_MOSI_P02_6 = 3*102+1*6 , SPI3_MOSI_P10_6, SPI3_MOSI_P22_0, SPI3_MOSI_P22_3, SPI3_MOSI_P33_12, // SPI3 MOSI引脚可选范围
}spi_mosi_pin_enum;
typedef enum // 枚举SPI MISO引脚 此枚举定义不允许用户修改
{
SPI0_MISO_P20_12 = 0*102+2*6 , // SPI0 MISO引脚可选范围
SPI1_MISO_P10_1 = 1*102+2*6 , SPI1_MISO_P11_3, // SPI1 MISO引脚可选范围
SPI2_MISO_P15_2 = 2*102+2*6 , SPI2_MISO_P15_4, SPI2_MISO_P15_7, SPI2_MISO_P21_2, SPI2_MISO_P21_3, // SPI2 MISO引脚可选范围
SPI3_MISO_P02_5 = 3*102+2*6 , SPI3_MISO_P22_1, SPI3_MISO_P21_2, SPI3_MISO_P21_3, SPI3_MISO_P33_13, // SPI3 MISO引脚可选范围
}spi_miso_pin_enum;
typedef enum // 枚举SPI CS引脚 此枚举定义不允许用户修改
{
SPI0_CS0_P20_8 = 0*102+3*6 , // SPI0 CS0 引脚可选范围
SPI0_CS1_P20_9 = 0*102+4*6 ,
SPI0_CS2_P20_13 = 0*102+5*6 ,
SPI0_CS3_P11_10 = 0*102+6*6 ,
SPI0_CS4_P11_11 = 0*102+7*6 ,
SPI0_CS5_P11_2 = 0*102+8*6 ,
SPI0_CS6_P20_10 = 0*102+9*6 ,
SPI0_CS7_P33_5 = 0*102+10*6,
SPI0_CS8_P20_6 = 0*102+11*6,
SPI0_CS9_P20_3 = 0*102+12*6,
SPI0_CS13_P15_0 = 0*102+16*6,
SPI1_CS0_P20_8 = 1*102+3*6 ,
SPI1_CS1_P20_9 = 1*102+4*6 ,
SPI1_CS2_P20_13 = 1*102+5*6 ,
SPI1_CS3_P11_10 = 1*102+6*6 ,
SPI1_CS4_P11_11 = 1*102+7*6 ,
SPI1_CS5_P11_2 = 1*102+8*6 ,
SPI1_CS6_P33_10 = 1*102+9*6 ,
SPI1_CS7_P33_5 = 1*102+10*6,
SPI1_CS8_P10_4 = 1*102+11*6,
SPI1_CS9_P10_5 = 1*102+12*6,
SPI2_CS0_P15_2 = 2*102+3*6 ,
SPI2_CS1_P14_2 = 2*102+4*6 ,
SPI2_CS2_P14_6 = 2*102+5*6 ,
SPI2_CS3_P14_3 = 2*102+6*6 ,
SPI2_CS5_P15_1 = 2*102+8*6 ,
SPI2_CS6_P33_13 = 2*102+9*6 ,
SPI2_CS7_P20_10 = 2*102+10*6,
SPI2_CS8_P20_6 = 2*102+11*6,
SPI2_CS9_P20_3 = 2*102+12*6,
SPI3_CS0_P02_4 = 3*102+3*6 ,
SPI3_CS1_P02_0 = 3*102+4*6 , SPI3_CS1_P33_9,
SPI3_CS2_P02_1 = 3*102+5*6 , SPI3_CS2_P33_8,
SPI3_CS3_P02_2 = 3*102+6*6 ,
SPI3_CS4_P02_3 = 3*102+7*6 ,
SPI3_CS5_P02_8 = 3*102+8*6 ,
SPI3_CS6_P00_8 = 3*102+9*6 ,
SPI3_CS7_P00_9 = 3*102+10*6, SPI3_CS7_P33_7,
SPI3_CS8_P10_5 = 3*102+11*6,
SPI3_CS11_P33_10 = 3*102+14*6,
SPI3_CS12_P22_2 = 3*102+15*6,
SPI3_CS13_P23_1 = 3*102+16*6,
SPI_CS_NULL,
}spi_cs_pin_enum;
//====================================================SPI 基础函数====================================================
void spi_write_8bit (spi_index_enum spi_n, const uint8 data);
void spi_write_8bit_array (spi_index_enum spi_n, const uint8 *data, uint32 len);
void spi_write_16bit (spi_index_enum spi_n, const uint16 data);
void spi_write_16bit_array (spi_index_enum spi_n, const uint16 *data, uint32 len);
void spi_write_8bit_register (spi_index_enum spi_n, const uint8 register_name, const uint8 data);
void spi_write_8bit_registers (spi_index_enum spi_n, const uint8 register_name, const uint8 *data, uint32 len);
void spi_write_16bit_register (spi_index_enum spi_n, const uint16 register_name, const uint16 data);
void spi_write_16bit_registers (spi_index_enum spi_n, const uint16 register_name, const uint16 *data, uint32 len);
uint8 spi_read_8bit (spi_index_enum spi_n);
void spi_read_8bit_array (spi_index_enum spi_n, uint8 *data, uint32 len);
uint16 spi_read_16bit (spi_index_enum spi_n);
void spi_read_16bit_array (spi_index_enum spi_n, uint16 *data, uint32 len);
uint8 spi_read_8bit_register (spi_index_enum spi_n, const uint8 register_name);
void spi_read_8bit_registers (spi_index_enum spi_n, const uint8 register_name, uint8 *data, uint32 len);
uint16 spi_read_16bit_register (spi_index_enum spi_n, const uint16 register_name);
void spi_read_16bit_registers (spi_index_enum spi_n, const uint16 register_name, uint16 *data, uint32 len);
void spi_transfer_8bit (spi_index_enum spi_n, const uint8 *write_buffer, uint8 *read_buffer, uint32 len);
void spi_transfer_16bit (spi_index_enum spi_n, const uint16 *write_buffer, uint16 *read_buffer, uint32 len);
void spi_init (spi_index_enum spi_n, spi_mode_enum mode, uint32 baud, spi_sck_pin_enum sck_pin, spi_mosi_pin_enum mosi_pin, spi_miso_pin_enum miso_pin, spi_cs_pin_enum cs_pin);
//====================================================SPI 基础函数====================================================
#endif