zephyr/drivers/serial/usart_gd32.c

342 lines
8.8 KiB
C

/*
* Copyright (c) 2021, ATL Electronics
* SPDX-License-Identifier: Apache-2.0
*/
#define DT_DRV_COMPAT gd_gd32_usart
#include <errno.h>
#include <zephyr/drivers/clock_control.h>
#include <zephyr/drivers/clock_control/gd32.h>
#include <zephyr/drivers/pinctrl.h>
#include <zephyr/drivers/reset.h>
#include <zephyr/drivers/uart.h>
#include <zephyr/irq.h>
#include <gd32_usart.h>
/* Unify GD32 HAL USART status register name to USART_STAT */
#ifndef USART_STAT
#define USART_STAT USART_STAT0
#endif
struct gd32_usart_config {
uint32_t reg;
uint16_t clkid;
struct reset_dt_spec reset;
const struct pinctrl_dev_config *pcfg;
uint32_t parity;
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
uart_irq_config_func_t irq_config_func;
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
};
struct gd32_usart_data {
uint32_t baud_rate;
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
uart_irq_callback_user_data_t user_cb;
void *user_data;
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
};
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
static void usart_gd32_isr(const struct device *dev)
{
struct gd32_usart_data *const data = dev->data;
if (data->user_cb) {
data->user_cb(dev, data->user_data);
}
}
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
static int usart_gd32_init(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
struct gd32_usart_data *const data = dev->data;
uint32_t word_length;
uint32_t parity;
int ret;
ret = pinctrl_apply_state(cfg->pcfg, PINCTRL_STATE_DEFAULT);
if (ret < 0) {
return ret;
}
/**
* In order to keep the transfer data size to 8 bits(1 byte),
* append word length to 9BIT if parity bit enabled.
*/
switch (cfg->parity) {
case UART_CFG_PARITY_NONE:
parity = USART_PM_NONE;
word_length = USART_WL_8BIT;
break;
case UART_CFG_PARITY_ODD:
parity = USART_PM_ODD;
word_length = USART_WL_9BIT;
break;
case UART_CFG_PARITY_EVEN:
parity = USART_PM_EVEN;
word_length = USART_WL_9BIT;
break;
default:
return -ENOTSUP;
}
(void)clock_control_on(GD32_CLOCK_CONTROLLER,
(clock_control_subsys_t)&cfg->clkid);
(void)reset_line_toggle_dt(&cfg->reset);
usart_baudrate_set(cfg->reg, data->baud_rate);
usart_parity_config(cfg->reg, parity);
usart_word_length_set(cfg->reg, word_length);
/* Default to 1 stop bit */
usart_stop_bit_set(cfg->reg, USART_STB_1BIT);
usart_receive_config(cfg->reg, USART_RECEIVE_ENABLE);
usart_transmit_config(cfg->reg, USART_TRANSMIT_ENABLE);
usart_enable(cfg->reg);
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
cfg->irq_config_func(dev);
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
return 0;
}
static int usart_gd32_poll_in(const struct device *dev, unsigned char *c)
{
const struct gd32_usart_config *const cfg = dev->config;
uint32_t status;
status = usart_flag_get(cfg->reg, USART_FLAG_RBNE);
if (!status) {
return -EPERM;
}
*c = usart_data_receive(cfg->reg);
return 0;
}
static void usart_gd32_poll_out(const struct device *dev, unsigned char c)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_data_transmit(cfg->reg, c);
while (usart_flag_get(cfg->reg, USART_FLAG_TBE) == RESET) {
;
}
}
static int usart_gd32_err_check(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
uint32_t status = USART_STAT(cfg->reg);
int errors = 0;
if (status & USART_FLAG_ORERR) {
usart_flag_clear(cfg->reg, USART_FLAG_ORERR);
errors |= UART_ERROR_OVERRUN;
}
if (status & USART_FLAG_PERR) {
usart_flag_clear(cfg->reg, USART_FLAG_PERR);
errors |= UART_ERROR_PARITY;
}
if (status & USART_FLAG_FERR) {
usart_flag_clear(cfg->reg, USART_FLAG_FERR);
errors |= UART_ERROR_FRAMING;
}
usart_flag_clear(cfg->reg, USART_FLAG_NERR);
return errors;
}
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
int usart_gd32_fifo_fill(const struct device *dev, const uint8_t *tx_data,
int len)
{
const struct gd32_usart_config *const cfg = dev->config;
uint8_t num_tx = 0U;
while ((len - num_tx > 0) &&
usart_flag_get(cfg->reg, USART_FLAG_TBE)) {
usart_data_transmit(cfg->reg, tx_data[num_tx++]);
}
return num_tx;
}
int usart_gd32_fifo_read(const struct device *dev, uint8_t *rx_data,
const int size)
{
const struct gd32_usart_config *const cfg = dev->config;
uint8_t num_rx = 0U;
while ((size - num_rx > 0) &&
usart_flag_get(cfg->reg, USART_FLAG_RBNE)) {
rx_data[num_rx++] = usart_data_receive(cfg->reg);
}
return num_rx;
}
void usart_gd32_irq_tx_enable(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_interrupt_enable(cfg->reg, USART_INT_TC);
}
void usart_gd32_irq_tx_disable(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_interrupt_disable(cfg->reg, USART_INT_TC);
}
int usart_gd32_irq_tx_ready(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
return usart_flag_get(cfg->reg, USART_FLAG_TBE) &&
usart_interrupt_flag_get(cfg->reg, USART_INT_FLAG_TC);
}
int usart_gd32_irq_tx_complete(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
return usart_flag_get(cfg->reg, USART_FLAG_TC);
}
void usart_gd32_irq_rx_enable(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_interrupt_enable(cfg->reg, USART_INT_RBNE);
}
void usart_gd32_irq_rx_disable(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_interrupt_disable(cfg->reg, USART_INT_RBNE);
}
int usart_gd32_irq_rx_ready(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
return usart_flag_get(cfg->reg, USART_FLAG_RBNE);
}
void usart_gd32_irq_err_enable(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_interrupt_enable(cfg->reg, USART_INT_ERR);
usart_interrupt_enable(cfg->reg, USART_INT_PERR);
}
void usart_gd32_irq_err_disable(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
usart_interrupt_disable(cfg->reg, USART_INT_ERR);
usart_interrupt_disable(cfg->reg, USART_INT_PERR);
}
int usart_gd32_irq_is_pending(const struct device *dev)
{
const struct gd32_usart_config *const cfg = dev->config;
return ((usart_flag_get(cfg->reg, USART_FLAG_RBNE) &&
usart_interrupt_flag_get(cfg->reg, USART_INT_FLAG_RBNE)) ||
(usart_flag_get(cfg->reg, USART_FLAG_TC) &&
usart_interrupt_flag_get(cfg->reg, USART_INT_FLAG_TC)));
}
void usart_gd32_irq_callback_set(const struct device *dev,
uart_irq_callback_user_data_t cb,
void *user_data)
{
struct gd32_usart_data *const data = dev->data;
data->user_cb = cb;
data->user_data = user_data;
}
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
static const struct uart_driver_api usart_gd32_driver_api = {
.poll_in = usart_gd32_poll_in,
.poll_out = usart_gd32_poll_out,
.err_check = usart_gd32_err_check,
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
.fifo_fill = usart_gd32_fifo_fill,
.fifo_read = usart_gd32_fifo_read,
.irq_tx_enable = usart_gd32_irq_tx_enable,
.irq_tx_disable = usart_gd32_irq_tx_disable,
.irq_tx_ready = usart_gd32_irq_tx_ready,
.irq_tx_complete = usart_gd32_irq_tx_complete,
.irq_rx_enable = usart_gd32_irq_rx_enable,
.irq_rx_disable = usart_gd32_irq_rx_disable,
.irq_rx_ready = usart_gd32_irq_rx_ready,
.irq_err_enable = usart_gd32_irq_err_enable,
.irq_err_disable = usart_gd32_irq_err_disable,
.irq_is_pending = usart_gd32_irq_is_pending,
.irq_callback_set = usart_gd32_irq_callback_set,
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
};
#ifdef CONFIG_UART_INTERRUPT_DRIVEN
#define GD32_USART_IRQ_HANDLER(n) \
static void usart_gd32_config_func_##n(const struct device *dev) \
{ \
IRQ_CONNECT(DT_INST_IRQN(n), \
DT_INST_IRQ(n, priority), \
usart_gd32_isr, \
DEVICE_DT_INST_GET(n), \
0); \
irq_enable(DT_INST_IRQN(n)); \
}
#define GD32_USART_IRQ_HANDLER_FUNC_INIT(n) \
.irq_config_func = usart_gd32_config_func_##n
#else /* CONFIG_UART_INTERRUPT_DRIVEN */
#define GD32_USART_IRQ_HANDLER(n)
#define GD32_USART_IRQ_HANDLER_FUNC_INIT(n)
#endif /* CONFIG_UART_INTERRUPT_DRIVEN */
#define GD32_USART_INIT(n) \
PINCTRL_DT_INST_DEFINE(n); \
GD32_USART_IRQ_HANDLER(n) \
static struct gd32_usart_data usart_gd32_data_##n = { \
.baud_rate = DT_INST_PROP(n, current_speed), \
}; \
static const struct gd32_usart_config usart_gd32_config_##n = { \
.reg = DT_INST_REG_ADDR(n), \
.clkid = DT_INST_CLOCKS_CELL(n, id), \
.reset = RESET_DT_SPEC_INST_GET(n), \
.pcfg = PINCTRL_DT_INST_DEV_CONFIG_GET(n), \
.parity = DT_INST_ENUM_IDX_OR(n, parity, UART_CFG_PARITY_NONE), \
GD32_USART_IRQ_HANDLER_FUNC_INIT(n) \
}; \
DEVICE_DT_INST_DEFINE(n, &usart_gd32_init, \
NULL, \
&usart_gd32_data_##n, \
&usart_gd32_config_##n, PRE_KERNEL_1, \
CONFIG_SERIAL_INIT_PRIORITY, \
&usart_gd32_driver_api);
DT_INST_FOREACH_STATUS_OKAY(GD32_USART_INIT)