190 lines
4.7 KiB
C
190 lines
4.7 KiB
C
/*
|
|
* Copyright (c) 2006-2018, RT-Thread Development Team
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Change Logs:
|
|
* Date Author Notes
|
|
* first version
|
|
*/
|
|
// 串口相关头文件
|
|
|
|
|
|
#ifndef __OPENLOONGSON_UART_H
|
|
#define __OPENLOONGSON_UART_H
|
|
|
|
|
|
#include "ls1c_public.h"
|
|
|
|
|
|
// 串口各寄存器相对基地址的偏移
|
|
#define LS1C_UART_DAT_OFFSET (0)
|
|
#define LS1C_UART_IER_OFFSET (1)
|
|
#define LS1C_UART_IIR_OFFSET (2)
|
|
#define LS1C_UART_FCR_OFFSET (2)
|
|
#define LS1C_UART_LCR_OFFSET (3)
|
|
#define LS1C_UART_MCR_OFFSET (4)
|
|
#define LS1C_UART_LSR_OFFSET (5)
|
|
#define LS1C_UART_MSR_OFFSET (6)
|
|
|
|
#define LS1C_UART_LSB_OFFSET (0) // 分频锁存器1
|
|
#define LS1C_UART_MSB_OFFSET (1) // 分频锁存器2
|
|
|
|
/* interrupt enable register */
|
|
#define IER_IRxE 0x1 /* 接收有效数据中断使能 */
|
|
#define IER_ITxE 0x2 /* 传输保存寄存器为空中断使能 */
|
|
#define IER_ILE 0x4 /* 接收器线路状态中断使能 */
|
|
#define IER_IME 0x8 /* Modem状态中断使能 */
|
|
|
|
/* interrupt identification register */
|
|
#define IIR_IMASK 0xf /* mask */
|
|
#define IIR_RXTOUT 0xc /* receive timeout */
|
|
#define IIR_RLS 0x6 /* receive line status */
|
|
#define IIR_RXRDY 0x4 /* receive ready */
|
|
#define IIR_TXRDY 0x2 /* transmit ready */
|
|
#define IIR_NOPEND 0x1 /* nothing */
|
|
#define IIR_MLSC 0x0 /* modem status */
|
|
#define IIR_FIFO_MASK 0xc0 /* set if FIFOs are enabled */
|
|
|
|
/* fifo control register */
|
|
#define FIFO_ENABLE 0x01 /* enable fifo */
|
|
#define FIFO_RCV_RST 0x02 /* reset receive fifo */
|
|
#define FIFO_XMT_RST 0x04 /* reset transmit fifo */
|
|
#define FIFO_DMA_MODE 0x08 /* enable dma mode */
|
|
#define FIFO_TRIGGER_1 0x00 /* trigger at 1 char */
|
|
#define FIFO_TRIGGER_4 0x40 /* trigger at 4 chars */
|
|
#define FIFO_TRIGGER_8 0x80 /* trigger at 8 chars */
|
|
#define FIFO_TRIGGER_14 0xc0 /* trigger at 14 chars */
|
|
|
|
// 线路控制寄存器
|
|
/* character format control register */
|
|
#define CFCR_DLAB 0x80 /* divisor latch */
|
|
#define CFCR_SBREAK 0x40 /* send break */
|
|
#define CFCR_PZERO 0x30 /* zero parity */
|
|
#define CFCR_PONE 0x20 /* one parity */
|
|
#define CFCR_PEVEN 0x10 /* even parity */
|
|
#define CFCR_PODD 0x00 /* odd parity */
|
|
#define CFCR_PENAB 0x08 /* parity enable */
|
|
#define CFCR_STOPB 0x04 /* 2 stop bits */
|
|
#define CFCR_8BITS 0x03 /* 8 data bits */
|
|
#define CFCR_7BITS 0x02 /* 7 data bits */
|
|
#define CFCR_6BITS 0x01 /* 6 data bits */
|
|
#define CFCR_5BITS 0x00 /* 5 data bits */
|
|
|
|
/* modem control register */
|
|
#define MCR_LOOPBACK 0x10 /* loopback */
|
|
#define MCR_IENABLE 0x08 /* output 2 = int enable */
|
|
#define MCR_DRS 0x04 /* output 1 = xxx */
|
|
#define MCR_RTS 0x02 /* enable RTS */
|
|
#define MCR_DTR 0x01 /* enable DTR */
|
|
|
|
/* line status register */
|
|
#define LSR_RCV_FIFO 0x80 /* error in receive fifo */
|
|
#define LSR_TSRE 0x40 /* transmitter empty */
|
|
#define LSR_TXRDY 0x20 /* transmitter ready */
|
|
#define LSR_BI 0x10 /* break detected */
|
|
#define LSR_FE 0x08 /* framing error */
|
|
#define LSR_PE 0x04 /* parity error */
|
|
#define LSR_OE 0x02 /* overrun error */
|
|
#define LSR_RXRDY 0x01 /* receiver ready */
|
|
#define LSR_RCV_MASK 0x1f
|
|
|
|
|
|
// 串口模块编号
|
|
typedef enum
|
|
{
|
|
LS1C_UART00 = 0, // 全功能串口UART0可以分为两个四线串口UART00和UART01
|
|
LS1C_UART01,
|
|
LS1C_UART1,
|
|
LS1C_UART2,
|
|
LS1C_UART3,
|
|
LS1C_UART4,
|
|
LS1C_UART5,
|
|
LS1C_UART6,
|
|
LS1C_UART7,
|
|
LS1C_UART8,
|
|
LS1C_UART9,
|
|
LS1C_UART10,
|
|
LS1C_UART11
|
|
}ls1c_uart_t;
|
|
|
|
|
|
// 串口信息
|
|
typedef struct
|
|
{
|
|
ls1c_uart_t UARTx; // 串口模块编号
|
|
unsigned int baudrate; // 波特率
|
|
BOOL rx_enable; // 是否需要使用串口接收数据(使能接收中断)，发送默认使能
|
|
}ls1c_uart_info_t;
|
|
|
|
|
|
|
|
/*
|
|
* 获取指定串口模块的基地址
|
|
* @UARTx 串口编号
|
|
* @ret 基地址
|
|
*/
|
|
void *uart_get_base(ls1c_uart_t UARTx);
|
|
|
|
|
|
/*
|
|
* 初始化指定的串口模块
|
|
* @uart_info_p 串口模块信息
|
|
*/
|
|
void uart_init(ls1c_uart_info_t *uart_info_p);
|
|
|
|
|
|
/*
|
|
* 初始化串口2
|
|
*/
|
|
void uart2_init(void);
|
|
|
|
|
|
/*
|
|
* 在串口2上打印字符串
|
|
* @str 待打印的字符串
|
|
*/
|
|
void uart2_print(const char *str);
|
|
|
|
|
|
/*
|
|
* 在调试串口打印字符串
|
|
* @str 待打印的字符串
|
|
*/
|
|
void uart_debug_print(const char *str);
|
|
|
|
|
|
/*
|
|
* 在调试串口打印一个字符
|
|
* @ch 待打印的字符
|
|
*/
|
|
void uart_debug_putc(unsigned char ch);
|
|
|
|
|
|
/*
|
|
* 把中断号转换为串口号
|
|
* @IRQn 中断号
|
|
* @ret 串口号
|
|
*/
|
|
ls1c_uart_t uart_irqn_to_uartx(int IRQn);
|
|
|
|
|
|
/*
|
|
* 发送一个字节
|
|
* @uartx 串口号
|
|
* @ch 待发送的字符串
|
|
*/
|
|
void uart_putc(ls1c_uart_t uartx, unsigned char ch);
|
|
|
|
|
|
/*
|
|
* 打印一个字符串到指定串口
|
|
* @uartx 串口号
|
|
* @str 待打印的字符串
|
|
*/
|
|
void uart_print(ls1c_uart_t uartx, const char *str);
|
|
|
|
|
|
#endif
|
|
|