/**
 * @file main.c
 * @author WHXY
 * @brief DMA UART发送例程 - 硬件触发UART发送
 * @version 0.1
 * @date 2026-06-25
 *
 * @copyright Copyright (c) 2022
 *
 */
/*******************************************************************************
*
* 代码许可和免责信息
* 武汉芯源半导体有限公司授予您使用所有编程代码示例的非专属的版权许可，您可以由此
* 生成根据您的特定需要而定制的相似功能。根据不能被排除的任何法定保证，武汉芯源半
* 导体有限公司及其程序开发商和供应商对程序或技术支持（如果有）不提供任何明示或暗
* 含的保证或条件，包括但不限于暗含的有关适销性、适用于某种特定用途和非侵权的保证
* 或条件。
* 无论何种情形，武汉芯源半导体有限公司及其程序开发商或供应商均不对下列各项负责，
* 即使被告知其发生的可能性时，也是如此：数据的丢失或损坏；直接的、特别的、附带的
* 或间接的损害，或任何后果性经济损害；或利润、业务、收入、商誉或预期可节省金额的
* 损失。
* 某些司法辖区不允许对直接的、附带的或后果性的损害有任何的排除或限制，因此某些或
* 全部上述排除或限制可能不适用于您。
*
*******************************************************************************/
/******************************************************************************
 * Include files
 ******************************************************************************/
#include "main.h"
#include <stdio.h>
#include <string.h>

/******************************************************************************
 * Local pre-processor symbols/macros ('#define')
 ******************************************************************************/
// UART1用于DMA发送演示
#define  DMA_UARTx                     CW_UART1
#define  DMA_UART_CLK                  SYSCTRL_APB1_PERIPH_UART1
#define  DMA_UART_APBClkENx            SYSCTRL_APBPeriphClk_Enable1
#define  DMA_UART_BaudRate             115200
#define  DMA_UART_UclkFreq             8000000

// UART1 GPIO配置
#define  DMA_UART_GPIO_CLK             (SYSCTRL_AHB_PERIPH_GPIOA)
#define  DMA_UART_TX_GPIO_PORT         CW_GPIOA
#define  DMA_UART_TX_GPIO_PIN          GPIO_PIN_2
#define  DMA_UART_RX_GPIO_PORT         CW_GPIOA
#define  DMA_UART_RX_GPIO_PIN          GPIO_PIN_3

// GPIO复用功能
#define  DMA_UART_AFTX                 PA02_AFx_UART1TXD()
#define  DMA_UART_AFRX                 PA03_AFx_UART1RXD()

// DMA传输测试数据
#define  TEST_DATA_SIZE                50

/******************************************************************************
 * Local function prototypes ('static')
 ******************************************************************************/
static void RCC_Configuration(void);
static void GPIO_Configuration(void);
static void DMA_UART_Configuration(void);

/******************************************************************************
 * Local variable definitions ('static')                                      *
 ******************************************************************************/
// DMA发送缓冲区
static uint8_t s_dmaTxBuffer[TEST_DATA_SIZE];

/*****************************************************************************
 * Function implementation - global ('extern') and local ('static')
 ******************************************************************************/

/**
 ******************************************************************************
 ** \brief  Main function of project
 **
 ** \return int32_t return value, if needed
 **
 ******************************************************************************/
int32_t main(void)
{
    uint32_t i;
    UART_StatusTypeDef status;

    // 配置RCC
    RCC_Configuration();
    
    Bsp_Init(8000000);

    // 配置GPIO
    GPIO_Configuration();    

    printf("\r\n=== DMA UART Send Demo ===\r\n");
    printf("Mode: Hardware Trigger (UART TX Buffer Empty)\r\n");
    printf("DMA Channel: 1\r\n");
    printf("Transfer Mode: BLOCK\r\n\r\n");

    // 准备DMA发送数据
    printf("--- Preparing DMA TX Buffer ---\r\n");
    memset(s_dmaTxBuffer, 0, sizeof(s_dmaTxBuffer));
    for(i = 0; i < TEST_DATA_SIZE; i++)
    {
        // 填充可打印ASCII字符用于演示
        s_dmaTxBuffer[i] = (uint8_t)('A' + (i % 26));
    }
    printf("Buffer Size: %d bytes\r\n", TEST_DATA_SIZE);
    printf("Data: ");
    for(i = 0; i < TEST_DATA_SIZE; i++)
    {
        printf("%c", s_dmaTxBuffer[i]);
    }
    printf("\r\n\r\n");

    // 配置DMA UART
    DMA_UART_Configuration();

    // 通过DMA发送数据
    printf("--- Starting DMA UART Transmission ---\r\n");
    status = UART_TransmitDMA(DMA_UARTx, DMA_CHANNEL_1, s_dmaTxBuffer, TEST_DATA_SIZE);

    if(status == UART_STATUS_OK)
    {
        printf("DMA UART Transmit Started\r\n");

        // 等待UART发送完成（TXBUSY清零）
        while(DMA_UARTx->ISR_f.TXBUSY)
        {
            // 等待发送完成
        }

        printf("--- DMA UART Transmission Complete ---\r\n");
    }
    else
    {
        printf("DMA UART Transmit Failed (status: %d)\r\n", status);
    }

    printf("\r\n=== Demo Finished ===\r\n");

    while(1)
    {
        // 主循环空转
    }
}

/**
 * @brief 配置RCC
 *
 */
static void RCC_Configuration(void)
{
    // SYSCLK = HSI = 8MHz = HCLK = PCLK
    SYSCTRL_HSI_Enable(SYSCTRL_HSIOSC_DIV12);   

    // DMA UART1时钟使能
    DMA_UART_APBClkENx(DMA_UART_CLK, ENABLE);
}

/**
 * @brief 配置GPIO
 *
 */
static void GPIO_Configuration(void)
{
    GPIO_InitTypeDef GPIO_InitStructure = {0};   

    // 配置DMA UART1 TX引脚
    GPIO_WritePin(DMA_UART_TX_GPIO_PORT, DMA_UART_TX_GPIO_PIN, GPIO_Pin_SET);
    GPIO_InitStructure.Pins = DMA_UART_TX_GPIO_PIN;
    GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_Init(DMA_UART_TX_GPIO_PORT, &GPIO_InitStructure);

    GPIO_InitStructure.Pins = DMA_UART_RX_GPIO_PIN;
    GPIO_InitStructure.Mode = GPIO_MODE_INPUT_PULLUP;
    GPIO_Init(DMA_UART_RX_GPIO_PORT, &GPIO_InitStructure);

    // UART1 TX RX 复用
    DMA_UART_AFTX;
    DMA_UART_AFRX;
}

/**
 * @brief 配置DMA UART1用于发送
 *
 */
static void DMA_UART_Configuration(void)
{
    UART_InitTypeDef UART_InitStructure = {0};

    // 配置UART1
    UART_InitStructure.UART_BaudRate = DMA_UART_BaudRate;
    UART_InitStructure.UART_Over = UART_Over_16;
    UART_InitStructure.UART_Source = UART_Source_PCLK;
    UART_InitStructure.UART_UclkFreq = DMA_UART_UclkFreq;
    UART_InitStructure.UART_StartBit = UART_StartBit_FE;
    UART_InitStructure.UART_StopBits = UART_StopBits_1;
    UART_InitStructure.UART_Parity = UART_Parity_No;
    UART_InitStructure.UART_HardwareFlowControl = UART_HardwareFlowControl_None;
    UART_InitStructure.UART_Mode = UART_Mode_Tx;  // 仅使能发送
    UART_Init(DMA_UARTx, &UART_InitStructure);
}



/******************************************************************************
 * EOF (not truncated)
 ******************************************************************************/
#ifdef  USE_FULL_ASSERT
/**
  * @brief  Reports the name of the source file and the source line number
  *         where the assert_param error has occurred.
  * @param  file: pointer to the source file name
  * @param  line: assert_param error line source number
  * @retval None
  */
void assert_failed(uint8_t *file, uint32_t line)
{
    /* User can add his own implementation to report the file name and line number */
    printf("Wrong parameters value: file %s on line %ld\r\n", file, (long)line);
}
#endif /* USE_FULL_ASSERT */
