Files
QD4C-firmware/libraries/zf_driver/zf_driver_uart.h
2023-12-11 21:45:06 +08:00

232 lines
7.0 KiB
C
Raw Permalink 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.

/*********************************************************************************************************************
* CH32V307VCT6 Opensourec Library 即CH32V307VCT6 开源库)是一个基于官方 SDK 接口的第三方开源库
* Copyright (c) 2022 SEEKFREE 逐飞科技
*
* 本文件是CH32V307VCT6 开源库的一部分
*
* CH32V307VCT6 开源库 是免费软件
* 您可以根据自由软件基金会发布的 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_uart
* 公司名称 成都逐飞科技有限公司
* 版本信息 查看 libraries/doc 文件夹内 version 文件 版本说明
* 开发环境 MounRiver Studio V1.8.1
* 适用平台 CH32V307VCT6
* 店铺链接 https://seekfree.taobao.com/
*
* 修改记录
* 日期 作者 备注
* 2022-09-15 大W first version
********************************************************************************************************************/
#ifndef _zf_driver_uart_h
#define _zf_driver_uart_h
#include "ch32v30x.h"
#include "ch32v30x_gpio.h"
#include "ch32v30x_rcc.h"
#include "ch32v30x_usart.h"
#include "zf_common_interrupt.h"
#include "zf_common_debug.h"
#include "zf_driver_gpio.h"
// 此枚举定义不允许用户修改
// 初始化的时候必须使用同一组引脚例如UART1_MAP_TX_A9和UART1_MAP_RX_A10是一组引脚
//
typedef enum // 此枚举定义不允许用户修改
{
// MAP0 默认映射
// MAP1 重映射
// MAP2 部分映射
// MAP3 完全映射
//----------UART1-----------//
// 以下为串口1的一组映射引脚不允许映射引脚混用。
// 例如UART1_MAP0_TX_A9与UART1_MAP1_TX_B6不能一起使用。
// 默认映射
UART1_MAP0_TX_A9 = 0x0000 | A9 ,
UART1_MAP0_RX_A10 = 0x0000 | A10,
// 以下为串口1的一组映射引脚不允许映射引脚混用。
// 重映射
UART1_MAP1_TX_B6 = 0x0100 | B6 ,
UART1_MAP1_RX_B7 = 0x0100 | B7 ,
// 以下为串口1的一组映射引脚不允许映射引脚混用。
// 部分映射
UART1_MAP2_TX_B15 = 0x0200 | B15,
UART1_MAP2_RX_A8 = 0x0200 | A8 ,
// 以下为串口1的一组映射引脚不允许映射引脚混用。
// 完全映射
UART1_MAP3_TX_A6 = 0x0300 | A6 ,
UART1_MAP3_RX_A7 = 0x0300 | A7 ,
//----------UART2-----------//
// 以下为串口2的一组映射引脚不允许映射引脚混用。
// 默认映射
UART2_MAP0_TX_A2 = 0x1000 | A2 ,
UART2_MAP0_RX_A3 = 0x1000 | A3 ,
// 以下为串口2的一组映射引脚不允许映射引脚混用。
// 重映射
UART2_MAP1_TX_D5 = 0x1100 | D5 ,
UART2_MAP1_RX_D6 = 0x1100 | D6 ,
//----------UART3--------------//
// 以下为串口3的一组映射引脚不允许映射引脚混用。
// 默认映射
UART3_MAP0_TX_B10 = 0x2000 | B10, // 下载器串口默认引脚
UART3_MAP0_RX_B11 = 0x2000 | B11, // 下载器串口默认引脚
// 以下为串口3的一组映射引脚不允许映射引脚混用。
// 重映射
UART3_MAP1_TX_C10 = 0x2100 | C10,
UART3_MAP1_RX_C11 = 0x2100 | C11,
// 以下为串口3的一组映射引脚不允许映射引脚混用。
// 完全映射
UART3_MAP2_TX_D8 = 0x2300 | D8 ,
UART3_MAP2_RX_D9 = 0x2300 | D9 ,
//----------UART4-----------//
// 以下为串口4的一组映射引脚不允许映射引脚混用。
// 默认映射
UART4_MAP0_TX_C10 = 0x3000 | C10,
UART4_MAP0_RX_C11 = 0x3000 | C11,
// 以下为串口4的一组映射引脚不允许映射引脚混用。
// 重映射
UART4_MAP1_TX_B0 = 0x3100 | B0 ,
UART4_MAP1_RX_B1 = 0x3100 | B1 ,
// 以下为串口4的一组映射引脚不允许映射引脚混用。
// 完全映射
UART4_MAP3_TX_E0 = 0x3300 | E0 ,
UART4_MAP3_RX_E1 = 0x3300 | E1 ,
//----------UART5-----------//
// 以下为串口5的一组映射引脚不允许映射引脚混用。
// 默认映射
UART5_MAP0_TX_C12 = 0x4000 | C12,
UART5_MAP0_RX_D2 = 0x4000 | D2,
// 以下为串口5的一组映射引脚不允许映射引脚混用。
// 重映射
UART5_MAP1_TX_B4 = 0x4100 | B4,
UART5_MAP1_RX_B5 = 0x4100 | B5,
// 以下为串口5的一组映射引脚不允许映射引脚混用。
// 完全映射
UART5_MAP3_TX_E8 = 0x4300 | E8,
UART5_MAP3_RX_E9 = 0x4300 | E9,
//----------UART6-----------//
// 以下为串口6的一组映射引脚不允许映射引脚混用。
// 默认映射
UART6_MAP0_TX_C0 = 0x5000 | C0 ,
UART6_MAP0_RX_C1 = 0x5000 | C1 ,
// 以下为串口6的一组映射引脚不允许映射引脚混用。
// 重映射
UART6_MAP1_TX_B8 = 0x5100 | B8 ,
UART6_MAP1_RX_B9 = 0x5100 | B9 ,
// 以下为串口6的一组映射引脚不允许映射引脚混用。
// 完全映射
UART6_MAP3_TX_E10 = 0x5300 | E10,
UART6_MAP3_RX_E11 = 0x5300 | E11,
//----------UART7-----------//
// 以下为串口7的一组映射引脚不允许映射引脚混用。
// 默认映射
UART7_MAP0_TX_C2 = 0x6000 | C2 ,
UART7_MAP0_RX_C3 = 0x6000 | C3 ,
// 以下为串口7的一组映射引脚不允许映射引脚混用。
// 重映射
UART7_MAP1_TX_A6 = 0x6100 | A6 ,
UART7_MAP1_RX_A7 = 0x6100 | A7 ,
// 以下为串口7的一组映射引脚不允许映射引脚混用。
// 完全映射
UART7_MAP3_TX_E12 = 0x6300 | E12,
UART7_MAP3_RX_E13 = 0x6300 | E13,
//----------UART8-----------//
// 以下为串口8的一组映射引脚不允许映射引脚混用。
// 默认映射
UART8_MAP0_TX_C4 = 0x7000 | C4 ,
UART8_MAP0_RX_C5 = 0x7000 | C5 ,
// 以下为串口8的一组映射引脚不允许映射引脚混用。
// 重映射
UART8_MAP1_TX_A14 = 0x7100 | A14,
UART8_MAP1_RX_A15 = 0x7100 | A15,
// 以下为串口8的一组映射引脚不允许映射引脚混用。
// 完全映射
UART8_MAP3_TX_E14 = 0x7300 | E14,
UART8_MAP3_RX_E15 = 0x7300 | E15,
}uart_pin_enum;
typedef enum// 此枚举定义不允许用户修改
{
UART_1,
UART_2,
UART_3,
UART_4,
UART_5,
UART_6,
UART_7,
UART_8,
}uart_index_enum;
extern const uint32 uart_index[];
void uart_write_byte (uart_index_enum uart_n, const uint8 dat);
void uart_write_buffer (uart_index_enum uart_n, const uint8 *buff, uint32 len);
void uart_write_string (uart_index_enum uart_n, const char *str);
uint8 uart_read_byte (uart_index_enum uartn);
uint8 uart_query_byte (uart_index_enum uartn, uint8 *dat);
void uart_tx_interrupt (uart_index_enum uart_n, uint8 status);
void uart_rx_interrupt (uart_index_enum uart_n, uint8 status);
void uart_init (uart_index_enum uart_n, uint32 baud, uart_pin_enum tx_pin, uart_pin_enum rx_pin);
#endif