Quickstart guide for SAM PDCA driver

This is the quickstart guide for the SAM PDCA driver, with step-by-step instructions on how to configure and use the driver in a selection of use cases.

The use cases contain several code fragments. The code fragments in the steps for setup can be copied into a custom initialization function, while the steps for usage can be copied into, e.g., the main application function.

Basic use case

In this basic use case, the PDCA module and channel are configured for:

• Select USART2 as peripheral
• Interrupt-based handling

Prerequisites

1. System Clock Management (Sysclock)

Setup steps

Example code

Add to application C-file:

void pdca_callback(void)
{
    //Get PDCA RX channel status and check if PDCA transfer complete
    if (status == PDCA_CH_TRANSFER_COMPLETED) {
        pdca_channel_write_load(PDCA_RX_CHANNEL, g_uc_pdc_buffer, BUFFER_SIZE);
        pdca_channel_write_load(PDCA_TX_CHANNEL, g_uc_pdc_buffer, BUFFER_SIZE);
    }
}
void pdca_setup(void)
{
    pdca_enable(PDCA);

    pdca_channel_write_config(PDCA_RX_CHANNEL, &PDCA_RX_CONFIGS);
    pdca_channel_write_config(PDCA_TX_CHANNEL, &PDCA_TX_CONFIGS);

    pdca_channel_set_callback(PDCA_RX_CHANNEL, pdca_tranfer_done, PDCA_0_IRQn, 1, PDCA_IER_TRC);

    pdca_channel_enable(PDCA_RX_CHANNEL);
    pdca_channel_enable(PDCA_TX_CHANNEL);
}

Workflow

1. Define the interrupt callback function in the application:

   • void pdca_callback(void)
     {
         //Get PDCA RX channel status and check if PDCA transfer complete
         if (status == PDCA_CH_TRANSFER_COMPLETED) {
             pdca_channel_write_load(PDCA_RX_CHANNEL, g_uc_pdc_buffer, BUFFER_SIZE);
             pdca_channel_write_load(PDCA_TX_CHANNEL, g_uc_pdc_buffer, BUFFER_SIZE);
         }
     }

2. Enable PDCA module:

   • pdca_enable(PDCA); 

   • Note

     Including enable module clock and lock sleep mode.

3. Configure PDCA channel with specified mode:

   • pdca_channel_write_config(PDCA_RX_CHANNEL, &PDCA_RX_CONFIGS);
        pdca_channel_write_config(PDCA_TX_CHANNEL, &PDCA_TX_CONFIGS);

4. Set the PDCA callback function and enable PDCA interrupt.

   • pdca_channel_set_callback(PDCA_RX_CHANNEL, pdca_tranfer_done, PDCA_0_IRQn, 1, PDCA_IER_TRC); 

5. Enable PDCA channel:

   • pdca_channel_enable(PDCA_RX_CHANNEL);
        pdca_channel_enable(PDCA_TX_CHANNEL);