/**
 @page SPI_PDMA

 @verbatim
 * @file    SPI/PDMA/readme.txt
 * @version V2.00
 * @date    2021-02-25
 * @brief   Description of the SPI PDMA example.
 @endverbatim

@par Example Description:

This example describes how to configure SPI transmission by PDMA.

Transmission behavior implies as following:

This example configures SPI0 as master and SPI1 as slave, remember to set SEL as output mode 
for slave select. Both SPIs are configured with 8 bits mode, non-FIFO mode, (PCLK_SPI/4) transmission speed.

PDMA channel 1 is configured to transmit data from SPI0_Buffer_Tx to HT_SPI0->DR for SPI0 transmitter,
PDMA channel 0 is configured to transmit data from HT_SPI0->DR to SPI0_Buffer_Rx for SPI0 receiver.

PDMA channel 5 is configured to transmit data from SPI1_Buffer_Tx to HT_SPI1->DR for SPI1 transmitter,
PDMA channel 4 is configured to transmit data from HT_SPI1->DR to SPI1_Buffer_Rx for SPI1 receiver.

After the related configuration are done, the transmission will start once the PDMA Rx and Tx request
in SPI0 & SPI1 are enabled, SPI0 transmits and receives data by PDMA channel 1 & channel 0, the same
behavior slave SPI1 does simultaneously, the transmission will end after 16 data are sent and received
for each SPI, program will compare the received data to the transferred data to check on data validation.

@par Directory Contents:

- SPI/PDMA/main.c                 Main program
- SPI/PDMA/ht32fxxxx_it.c         Interrupt handlers

@par Hardware and Software Environment:

- This example can be run on the HT32 series development kit.
- Refer "ht32_board_config.h" for pin assignment.
- This example shows the result by LED1 and LED2.

@par Firmware Disclaimer Information

1. The customer hereby acknowledges and agrees that the program technical documentation, including the
   code, which is supplied by Holtek Semiconductor Inc., (hereinafter referred to as "HOLTEK") is the
   proprietary and confidential intellectual property of HOLTEK, and is protected by copyright law and
   other intellectual property laws.

2. The customer hereby acknowledges and agrees that the program technical documentation, including the
   code, is confidential information belonging to HOLTEK, and must not be disclosed to any third parties
   other than HOLTEK and the customer.

3. The program technical documentation, including the code, is provided "as is" and for customer reference
   only. After delivery by HOLTEK, the customer shall use the program technical documentation, including
   the code, at their own risk. HOLTEK disclaims any expressed, implied or statutory warranties, including
   the warranties of merchantability, satisfactory quality and fitness for a particular purpose.

 * <h2><center>Copyright (C) Holtek Semiconductor Inc. All rights reserved</center></h2>
 */
