Home
3 API
3.3 Safe PLIB
Safe PLIBs are used for setting up and controlling the operation of the peripherals.
3.3.5 SAFE_PLIB_DMAC
Set of safe functions for setting up and controlling the DMAC peripheral.
3.3.5.2 DMAC_ChannelIsBusy
Reads the busy status of a channel.

1 Preface
2 Diagnostic Library for SAM C21
3 API
- 3.1 API Overview
- 3.2 Diagnostic Mechanisms
- 3.3 Safe PLIB
  Safe PLIBs are used for setting up and controlling the operation of the peripherals.
  - 3.3.1 SAFE_PLIB_ADC
    Set of safe functions for setting up and controlling the ADC peripheral.
  - 3.3.2 SAFE_PLIB_CAN
    Set of safe functions for setting up and controlling the CAN peripheral.
  - 3.3.3 SAFE_PLIB_DAC
    Set of safe functions for setting up and controlling the DAC peripheral.
  - 3.3.4 SAFE_PLIB_DIVAS
    Set of safe functions for setting up and controlling the DIVAS peripheral.
  - 3.3.5 SAFE_PLIB_DMAC
    Set of safe functions for setting up and controlling the DMAC peripheral.
    - 3.3.5.1 DMAC_ChannelCallbackRegister
      This function allows a DMAC PLIB client to set an event handler.
    - 3.3.5.2 DMAC_ChannelIsBusy
      Reads the busy status of a channel.
    - 3.3.5.3 DMAC_ChannelLinkedListTransfer
      The function submit a list of DMA transfers.
    - 3.3.5.4 DMAC_ChannelTransfer
      Returns the DMA channel's transfer status
    - 3.3.5.5 DMAC_ChannelTransferStatusGet
      Get the channel transfer status for the give channel
    - 3.3.5.6 DMAC_Initialize
      This function initializes the DMAC controller of the device.
  - 3.3.6 SAFE_PLIB_EIC
    Set of safe functions for setting up and controlling the EIC peripheral.
  - 3.3.7 SAFE_PLIB_FREQM
    Set of safe functions for setting up and controlling the FREQM peripheral.
  - 3.3.8 SAFE_PLIB_NVMCTRL
    Set of safe functions for setting up and controlling the NVMCTRL peripheral.
  - 3.3.9 SAFE_PLIB_PAC
    Set of safe functions for setting up and controlling the PAC peripheral.
  - 3.3.10 SAFE_PLIB_RSTC
    Set of safe functions for setting up and controlling the RSTC peripheral.
  - 3.3.11 SAFE_PLIB_RTC
    Set of safe functions for setting up and controlling the RTC peripheral.
  - 3.3.12 SAFE_PLIB_SDADC
    Set of safe functions for setting up and controlling the SDADC peripheral.
  - 3.3.13 SAFE_PLIB_SERCOM_USART
    Set of safe functions for setting up and controlling the USART peripheral.
  - 3.3.14 SAFE_PLIB_TC
    Set of safe functions for setting up and controlling the TC peripheral.
  - 3.3.15 SAFE_PLIB_TCC
    Set of safe functions for setting up and controlling the TCC peripheral.
  - 3.3.16 SAFE_PLIB_WDT
    Set of safe functions for setting up and controlling the WDT peripheral.
4 Appendix - FMEDA to Diagnostic API Mapping
5 Known Issues
6 Revision History
Microchip Information

3.3.5.2 DMAC_ChannelIsBusy

Reads the busy status of a channel.

The function returns true if the specified channel is busy with a transfer. This function can be used to poll for the completion of transfer that was started by calling the DMAC_ChannelTransfer() function. This function can be used as a polling alternative to the setting a callback function and receiving an asynchronous notification for transfer notification.

bool 
DMAC_ChannelBusy 
(
     DMAC_CHANNEL channel
);

Precondition

DMAC should have been initialized by calling the DMAC_Initialize.

Parameters

channel - the particular channel to be interrogated

Returns

returns true if the channel is busy with an on-going transfer, otherwise, false if not busy and is available for a transfer.