Inheritance diagram for LibXR::STM32UART:

Collaboration diagram for LibXR::STM32UART:

[legend]

Public Member Functions
	STM32UART (UART_HandleTypeDef *uart_handle, RawData dma_buff_rx, RawData dma_buff_tx, uint32_t rx_queue_size=5, uint32_t tx_queue_size=5)

ErrorCode	SetConfig (UART::Configuration config)
	设置 UART 配置 / Sets the UART configuration

Public Member Functions inherited from LibXR::UART
	UART (size_t rx_queue_size, size_t rx_buffer_size, size_t tx_queue_size, size_t tx_buffer_size)
	UART 构造函数 / UART constructor.

Static Public Member Functions
static ErrorCode	WriteFun (WritePort &port)

static ErrorCode	ReadFun (ReadPort &port)

Data Fields
RawData	dma_buff_rx_

RawData	dma_buff_tx_

UART_HandleTypeDef *	uart_handle_

stm32_uart_id_t	id_ = STM32_UART_ID_ERROR

Data Fields inherited from LibXR::UART
ReadPort	read_port_
	读取端口 / Read port

WritePort	write_port_
	写入端口 / Write port

Static Public Attributes
static STM32UART *	map [STM32_UART_NUMBER] = {nullptr}

Additional Inherited Members
Public Types inherited from LibXR::UART
enum class	Parity : uint8_t { NO_PARITY = 0 , EVEN = 1 , ODD = 2 }
	奇偶校验模式 / Parity mode More...

Detailed Description

Definition at line 112 of file stm32_uart.hpp.

Constructor & Destructor Documentation

◆ STM32UART()

LibXR::STM32UART::STM32UART	(	UART_HandleTypeDef *	uart_handle,
		RawData	dma_buff_rx,
		RawData	dma_buff_tx,
		uint32_t	rx_queue_size = `5`,
		uint32_t	tx_queue_size = `5`
	)

inline

Definition at line 179 of file stm32_uart.hpp.

      : UART(rx_queue_size, dma_buff_rx.size_, tx_queue_size, dma_buff_tx.size_),
        dma_buff_rx_(dma_buff_rx),
        dma_buff_tx_(dma_buff_tx),
        uart_handle_(uart_handle),
        id_(STM32_UART_GetID(uart_handle_->Instance))
  {
    ASSERT(id_ != STM32_UART_ID_ERROR);
 
    map[id_] = this;
 
    if ((uart_handle->Init.Mode & UART_MODE_TX) == UART_MODE_TX)
    {
      ASSERT(uart_handle_->hdmatx != NULL);
      write_port_ = WriteFun;
    }
 
    if ((uart_handle->Init.Mode & UART_MODE_RX) == UART_MODE_RX)
    {
      ASSERT(uart_handle->hdmarx != NULL);
      __HAL_UART_ENABLE_IT(uart_handle, UART_IT_IDLE);
 
      HAL_UART_Receive_DMA(uart_handle, reinterpret_cast<uint8_t *>(dma_buff_rx_.addr_),
                           dma_buff_rx_.size_);
      read_port_ = ReadFun;
    }
  }

Member Function Documentation

◆ ReadFun()

static ErrorCode LibXR::STM32UART::ReadFun ( ReadPort & port )

inlinestatic

Definition at line 152 of file stm32_uart.hpp.

  {
    STM32UART *uart = CONTAINER_OF(&port, STM32UART, read_port_);
    UNUSED(uart);
    ReadInfoBlock block;
 
    if (port.queue_block_->Peek(block) != ErrorCode::OK)
    {
      return ErrorCode::EMPTY;
    }
 
    block.op_.MarkAsRunning();
 
    if (port.queue_data_->Size() >= block.data_.size_)
    {
      port.queue_data_->PopBatch(block.data_.addr_, block.data_.size_);
      port.queue_block_->Pop();
      port.read_size_ = block.data_.size_;
      block.op_.UpdateStatus(false, ErrorCode::OK);
      return ErrorCode::OK;
    }
    else
    {
      return ErrorCode::EMPTY;
    }
  }

◆ SetConfig()

ErrorCode LibXR::STM32UART::SetConfig ( UART::Configuration config )

inlinevirtual

设置 UART 配置 / Sets the UART configuration

Parameters

config UART 配置信息 / UART configuration settings

Returns: 返回操作状态，成功时返回 ErrorCode::OK，否则返回相应错误码 / Returns the operation status, ErrorCode::OK if successful, otherwise an error code

该方法为纯虚函数，子类必须实现具体的 UART 配置逻辑。 This is a pure virtual function. Subclasses must implement the specific UART configuration logic.

Implements LibXR::UART.

Definition at line 208 of file stm32_uart.hpp.

  {
    uart_handle_->Init.BaudRate = config.baudrate;
 
    switch (config.parity)
    {
      case UART::Parity::NO_PARITY:
        uart_handle_->Init.Parity = UART_PARITY_NONE;
        uart_handle_->Init.WordLength = UART_WORDLENGTH_8B;
        break;
      case UART::Parity::EVEN:
        uart_handle_->Init.Parity = UART_PARITY_EVEN;
        uart_handle_->Init.WordLength = UART_WORDLENGTH_9B;
        break;
      case UART::Parity::ODD:
        uart_handle_->Init.Parity = UART_PARITY_ODD;
        uart_handle_->Init.WordLength = UART_WORDLENGTH_9B;
        break;
      default:
        ASSERT(false);
    }
 
    switch (config.stop_bits)
    {
      case 1:
        uart_handle_->Init.StopBits = UART_STOPBITS_1;
        break;
      case 2:
        uart_handle_->Init.StopBits = UART_STOPBITS_2;
        break;
      default:
        ASSERT(false);
    }
 
    if (HAL_UART_Init(uart_handle_) != HAL_OK)
    {
      return ErrorCode::INIT_ERR;
    }
    return ErrorCode::OK;
  }

◆ WriteFun()

static ErrorCode LibXR::STM32UART::WriteFun ( WritePort & port )

inlinestatic

Definition at line 115 of file stm32_uart.hpp.

  {
    STM32UART *uart = CONTAINER_OF(&port, STM32UART, write_port_);
    if (uart->uart_handle_->gState == HAL_UART_STATE_READY)
    {
      WritePort::WriteInfo info;
      if (port.queue_info_->Peek(info) != ErrorCode::OK)
      {
        return ErrorCode::EMPTY;
      }
 
      if (port.queue_data_->PopBatch(
              reinterpret_cast<uint8_t *>(uart->dma_buff_tx_.addr_), info.size) !=
          ErrorCode::OK)
      {
        ASSERT(false);
        return ErrorCode::EMPTY;
      }
 
      auto ans = HAL_UART_Transmit_DMA(uart->uart_handle_,
                                       static_cast<uint8_t *>(uart->dma_buff_tx_.addr_),
                                       info.size);
      if (ans != HAL_OK)
      {
        port.queue_info_->Pop(info);
        info.op.UpdateStatus(false, ErrorCode::FAILED);
        return ErrorCode::FAILED;
      }
      info.op.MarkAsRunning();
    }
    else
    {
    }
 
    return ErrorCode::OK;
  }

Field Documentation

◆ dma_buff_rx_

RawData LibXR::STM32UART::dma_buff_rx_

Definition at line 249 of file stm32_uart.hpp.

◆ dma_buff_tx_

RawData LibXR::STM32UART::dma_buff_tx_

Definition at line 249 of file stm32_uart.hpp.

◆ id_

stm32_uart_id_t LibXR::STM32UART::id_ = STM32_UART_ID_ERROR

Definition at line 253 of file stm32_uart.hpp.

◆ map

STM32UART * STM32UART::map = {nullptr}

static

Definition at line 255 of file stm32_uart.hpp.

◆ uart_handle_

UART_HandleTypeDef* LibXR::STM32UART::uart_handle_

Definition at line 251 of file stm32_uart.hpp.

The documentation for this class was generated from the following files:

driver/st/stm32_uart.hpp
driver/st/stm32_uart.cpp

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Additional Inherited Members