Direct Memory Access Controller (r_dmac)

Functions
fsp_err_t	R_DMAC_Open (transfer_ctrl_t *const p_api_ctrl, transfer_cfg_t const *const p_cfg)
fsp_err_t	R_DMAC_Reconfigure (transfer_ctrl_t *const p_api_ctrl, transfer_info_t *p_info)
fsp_err_t	R_DMAC_Reset (transfer_ctrl_t *const p_api_ctrl, void const *volatile p_src, void *volatile p_dest, uint16_t const num_transfers)
fsp_err_t	R_DMAC_SoftwareStart (transfer_ctrl_t *const p_api_ctrl, transfer_start_mode_t mode)
fsp_err_t	R_DMAC_SoftwareStop (transfer_ctrl_t *const p_api_ctrl)
fsp_err_t	R_DMAC_Enable (transfer_ctrl_t *const p_api_ctrl)
fsp_err_t	R_DMAC_Disable (transfer_ctrl_t *const p_api_ctrl)
fsp_err_t	R_DMAC_InfoGet (transfer_ctrl_t *const p_api_ctrl, transfer_properties_t *const p_info)
fsp_err_t	R_DMAC_Close (transfer_ctrl_t *const p_api_ctrl)
fsp_err_t	R_DMAC_Reload (transfer_ctrl_t *const p_api_ctrl, void const *p_src, void *p_dest, uint32_t const num_transfers)
fsp_err_t	R_DMAC_CallbackSet (transfer_ctrl_t *const p_api_ctrl, void(*p_callback)(dmac_callback_args_t *), void const *const p_context, dmac_callback_args_t *const p_callback_memory)
fsp_err_t	R_DMAC_LinkDescriptorSet (transfer_ctrl_t *const p_api_ctrl, dmac_link_cfg_t *p_descriptor)

Detailed Description

Driver for the DMAC peripheral on RZ MPUs. This module implements the Transfer Interface.

Overview

The Direct Memory Access Controller (DMAC) transfers data from one memory location to another without using the CPU.

Features

• Supports multiple transfer modes
  • Normal transfer
  • Block transfer
• Support Register mode
• Supports Next0 Register set and Next1 Register set
• Address increment, fixed
• Triggered by peripheral module events
  • See "Table 14.3" in "14.5.2 DMA Transfer Requests" in the User's manual.
• Supports 1, 2, 4, 8, 16, 32, 64, 128 byte data units
• Configurable DMA transfer activation request source, detection method of DMA request signal and DACK output mode
• Configurable DMA transfer interval
• Configurable DMAC channel priority

Configuration

Build Time Configurations for r_dmac

The following build time configurations are defined in fsp_cfg/r_dmac_cfg.h:

Configuration	Options	Default	Description
Parameter Checking	Default (BSP) Enabled Disabled	Default (BSP)	If selected code for parameter checking is included in the build.

Configurations for Transfer > Transfer Driver on r_dmac

This module can be added to the Stacks tab via New Stack > Transfer > Transfer Driver on r_dmac.

Configuration	Options	Default	Description
General > Name	Name must be a valid C symbol	g_transfer0	Module name.
General > Channel	Must be a valid integer between 0 and 15.	0	Specify the hardware channel.
General > Activation Source	Refer to the RZA Configuration tool for available options.	SOFTWARE_TRIGGER	Select the DMAC transfer start event.
General > DMAC Mode	Register Mode Link mode	Register Mode	Select DMAC Mode.
General > Channel Priority	Fixed Round Robin	module.driver.transfer_on_dmac.channel_priority.fixed	Channel Priority
Register Mode > Mode	Normal Block	Normal	Select the transfer mode.
Register Mode > Source Data Size	1 Byte 2 Bytes 4 Bytes 8 Bytes 16 Bytes 32 Bytes 64 Bytes 128 Bytes	2 Bytes	Select the source data size.
Register Mode > Destination Data Size	1 Byte 2 Bytes 4 Bytes 8 Bytes 16 Bytes 32 Bytes 64 Bytes 128 Bytes	2 Bytes	Select the destination data size.
Register Mode > Destination Address Mode	Fixed Incremented	Fixed	Select the address mode for the destination.
Register Mode > Source Address Mode	Fixed Incremented	Fixed	Select the address mode for the source.
Register Mode > DMA Activation Request Source Select	Requested by a transfer source module Requested by a transfer destination module	Requested by a transfer source module	DMA Activation Request Source Select.
Register Mode > Transfer Interval	Value must be a non-negative integer	0	Transfer interval
Register Mode > Transfer Continuation	DMA transfer only once Transfer with Setting 1 and Setting 2 alternately	DMA transfer only once	When Next0 Register Set Transfer completes, Next1 Register Set Transfer occurs
Register Mode > Setting 1 Destination Address	Manual Entry	NULL	Specify the transfer destination address.
Register Mode > Setting 1 Source Address	Manual Entry	NULL	Specify the transfer source address.
Register Mode > Setting 1 Total Number of Transfer Bytes	Value must be a non-negative integer	1	Specify the total number of transfer bytes.
Register Mode > Setting 2 Destination Address	Manual Entry	NULL	Specify the transfer destination address.(Use only when Transfer with Setting 1 and Setting 2 horizontally is selected in Transfer Continuatuion.)
Register Mode > Setting 2 Source Address	Manual Entry	NULL	Specify the transfer source address.(Use only when Transfer with Setting 1 and Setting 2 horizontally is selected in Transfer Continuatuion.)
Register Mode > Setting 2 Total Number of Transfer Bytes	Value must be a non-negative integer	1	Specify the total number of transfer bytes.(Use only when Transfer with Setting 1 and Setting 2 horizontally is selected in Transfer Continuatuion.)
Link Mode > Descriptor	Name must be a valid C symbol	NULL	DMAC Link mode descriptor symbol name.
Interrupts > Callback	Name must be a valid C symbol	NULL	A user callback that is called at the end of the transfer.
Interrupts > Transfer End Interrupt Enable	MCU Specific Options		Enable the transfer end interrupt.
Interrupts > Transfer End Interrupt Priority	Value must be an integer between 0 and 31	24	Select the transfer end interrupt priority.

Warning

"DMA Activation Request Source Select", "Low Detection Enable", "High Detection Enable", and "DACK output" must be set according to the DMAC transfer source. For details, see 'DMA Transfer Request Detection Operation Setting Table' of User's Manual.

Clock Configuration

The DMAC peripheral module uses ICLK as the clock source. The ICLK frequency is set by using the Clocks tab of the FSP Configuration editor prior to a build, or by using the CGC module at run-time.

Pin Configuration

This module does not use I/O pins.

Usage Notes

Transfer Modes

The DMAC Module supports two modes of operation.

• Normal Mode - In normal mode, a single data unit is forwarded each time a configured peripheral module event is received by the DMAC channel. The data unit can be 1 byte, 2 bytes, 4 bytes, 8 bytes, 16 bytes, 32 bytes, 64 bytes, or 128 bytes. The source and destination addresses can be fixed or incremented. The 32-bit counter decrements on every transfer. When the counter reaches 0, the peripheral module event no longer triggers the transfer and you can interrupt the CPU to signal that all transfers have finished.
• Block Mode - In block mode, the amount of data units transfered by each interrupt. For one DMA request, performs transfers until a DMA transfer completes. When the counter reaches 0, transfers will no longer be triggered by the peripheral module event and the CPU can be interrupted to signal that all transfers have finished.

Link Mode

In Link mode, a DMA transfer is performed by reading a descriptor placed in the RAM area as the transfer information setting value. The descriptor is configured by dmac_link_cfg_t struct. For more information see 'Link Mode' section in the RZ microprocessor manual.

Note

1. The descriptor must be 4-byte align.

2. To set the transfer source/destination address, see 'Area Maps' chapter in the RZ microprocessor manual for details. If the device supports MMU, specify the physical address for the source/destination address. (Use R_MMU_VAtoPA to convert to a physical address.)

3. dmac_link_cfg_t::channel_cfg and dmac_link_cfg_t::channel_extension_cfg have configuration restrictions same as the DMAC CHCFG_n and CHEXT_n registers. For more information see 'CHCFG_n : Channel Configuration Register n' and 'CHEXT_n : Channel Extension Register n' section in the RZ microprocessor manual.

4. Setting the link destination of the last descriptor to the address of the previous descriptor configures the descriptors in a loop. When set the descriptor to a loop, disable Parameter Checking of Build Time Configuration to avoid infinite loop operation.

Examples

Basic Example

This is a basic example of minimal use of the DMAC in an application.

void dmac_minimal_example (void)
{

    /* Open the transfer instance with initial configuration. */
    fsp_err_t err = R_DMAC_Open(&g_transfer_ctrl, &g_transfer_cfg);


    /* Handle any errors. This function should be defined by the user. */
    assert(FSP_SUCCESS == err);


    /* Enable the DMAC to handle incoming transfer requests. */
    err = R_DMAC_Enable(&g_transfer_ctrl);
    assert(FSP_SUCCESS == err);

}

Link Mode Example

This is an example of an application using the DMAC link mode for continuous transfers. DMAC transfer is triggered by R_DMAC_SoftwareStart().

In this example, if the MMU is supported, the source and destination addresses are set to non-cached areas of system RAM.

#define TRANSFER_LENGTH_0           (2048)
#define TRANSFER_LENGTH_1           (1024)
#define TRANSFER_LENGTH_2           (512)
#define DMAC_CHCFG_SETTING_VALUE    (0x80400420)
#define DMAC_CHEXT_SETTING_VALUE    (0x00)

#if (UINTPTR_MAX > UINT32_MAX)

uint8_t g_src0[TRANSFER_LENGTH_0] BSP_ALIGN_VARIABLE(64)  __attribute__((section("UNCACHED_BSS"))); /* Placed at System RAM Non-Cache buffer area */
uint8_t g_dest0[TRANSFER_LENGTH_0] BSP_ALIGN_VARIABLE(64) __attribute__((section("UNCACHED_BSS"))); /* Placed at System RAM Non-Cache buffer area */
uint8_t g_src1[TRANSFER_LENGTH_1] BSP_ALIGN_VARIABLE(64)  __attribute__((section("UNCACHED_BSS"))); /* Placed at System RAM Non-Cache buffer area */
uint8_t g_dest1[TRANSFER_LENGTH_1] BSP_ALIGN_VARIABLE(64) __attribute__((section("UNCACHED_BSS"))); /* Placed at System RAM Non-Cache buffer area */
uint8_t g_src2[TRANSFER_LENGTH_2] BSP_ALIGN_VARIABLE(64)  __attribute__((section("UNCACHED_BSS"))); /* Placed at System RAM Non-Cache buffer area */
uint8_t g_dest2[TRANSFER_LENGTH_2] BSP_ALIGN_VARIABLE(64) __attribute__((section("UNCACHED_BSS"))); /* Placed at System RAM Non-Cache buffer area */

dmac_link_cfg_t transfer0_descriptor BSP_ALIGN_VARIABLE (64) __attribute__((section("UNCACHED_BSS"))) =
{
    .header.link_valid         = DMAC_LINK_VALID_DESCRIPTOR_ENABLE,
    .header.link_end           = DMAC_LINK_END_DISABLE,
    .header.write_back_disable = DMAC_LINK_WRITE_BACK_DISABLE,
    .header.interrupt_mask     = DMAC_LINK_INTERRUPT_MASK_DISABLE,
    .src_addr              = 0x0,                      /* Source address */
    .dest_addr             = 0x0,                      /* Destination address */
    .transaction_byte      = TRANSFER_LENGTH_0,        /* Transaction byte */
    .channel_cfg           = DMAC_CHCFG_SETTING_VALUE, /* Channel configuration register setting */
    .channel_interval      = 0,                        /* Channel interval. */
    .channel_extension_cfg = 0,                        /* Channel extension register setting */
    .next_link_addr        = 0,                        /* Next link address */
};

dmac_link_cfg_t transfer1_descriptor BSP_ALIGN_VARIABLE (64) __attribute__((section("UNCACHED_BSS"))) =
{
    .header.link_valid         = DMAC_LINK_VALID_DESCRIPTOR_ENABLE,
    .header.link_end           = DMAC_LINK_END_DISABLE,
    .header.write_back_disable = DMAC_LINK_WRITE_BACK_DISABLE,
    .header.interrupt_mask     = DMAC_LINK_INTERRUPT_MASK_DISABLE,
    .src_addr              = 0x0,                      /* Source address */
    .dest_addr             = 0x0,                      /* Destination address */
    .transaction_byte      = TRANSFER_LENGTH_1,        /* Transaction byte */
    .channel_cfg           = DMAC_CHCFG_SETTING_VALUE, /* Channel configuration register setting */
    .channel_interval      = 0,                        /* Channel interval. */
    .channel_extension_cfg = 0,                        /* Channel extension register setting */
    .next_link_addr        = 0,                        /* Next link address */
};

dmac_link_cfg_t transfer2_descriptor BSP_ALIGN_VARIABLE (64) __attribute__((section("UNCACHED_BSS"))) =
{
    .header.link_valid         = DMAC_LINK_VALID_DESCRIPTOR_ENABLE,
    .header.link_end           = DMAC_LINK_END_ENABLE,
    .header.write_back_disable = DMAC_LINK_WRITE_BACK_DISABLE,
    .header.interrupt_mask     = DMAC_LINK_INTERRUPT_MASK_DISABLE,
    .src_addr              = 0x0,                      /* Source address */
    .dest_addr             = 0x0,                      /* Destination address */
    .transaction_byte      = TRANSFER_LENGTH_2,        /* Transaction byte */
    .channel_cfg           = DMAC_CHCFG_SETTING_VALUE, /* Channel configuration register setting */
    .channel_interval      = 0,                        /* Channel interval. */
    .channel_extension_cfg = 0,                        /* Channel extension register setting */
    .next_link_addr        = 0,                        /* Next link address */
};

#else

uint8_t g_src0[TRANSFER_LENGTH_0];     /* Placed at System RAM area */
uint8_t g_dest0[TRANSFER_LENGTH_0];    /* Placed at System RAM area */
uint8_t g_src1[TRANSFER_LENGTH_1];     /* Placed at System RAM area */
uint8_t g_dest1[TRANSFER_LENGTH_1];    /* Placed at System RAM area */
uint8_t g_src2[TRANSFER_LENGTH_2];     /* Placed at System RAM area */
uint8_t g_dest2[TRANSFER_LENGTH_2];    /* Placed at System RAM area */

dmac_link_cfg_t transfer0_descriptor BSP_ALIGN_VARIABLE (4) =
{
    .header.link_valid         = DMAC_LINK_VALID_DESCRIPTOR_ENABLE,
    .header.link_end           = DMAC_LINK_END_DISABLE,
    .header.write_back_disable = DMAC_LINK_WRITE_BACK_DISABLE,
    .header.interrupt_mask     = DMAC_LINK_INTERRUPT_MASK_DISABLE,
    .p_src                 = (void *) ((uint32_t) &g_src0[0]),  /* Source address */
    .p_dest                = (void *) ((uint32_t) &g_dest0[0]), /* Destination address */
    .transaction_byte      = TRANSFER_LENGTH_0,                 /* Transaction byte */
    .channel_cfg           = DMAC_CHCFG_SETTING_VALUE,          /* Channel configuration register setting */
    .channel_interval      = 0,                                 /* Channel interval. */
    .channel_extension_cfg = 0,                                 /* Channel extension register setting */
    .p_next_link_addr      = NULL,                              /* Next link address */
};

dmac_link_cfg_t transfer1_descriptor BSP_ALIGN_VARIABLE (4) =
{
    .header.link_valid         = DMAC_LINK_VALID_DESCRIPTOR_ENABLE,
    .header.link_end           = DMAC_LINK_END_DISABLE,
    .header.write_back_disable = DMAC_LINK_WRITE_BACK_DISABLE,
    .header.interrupt_mask     = DMAC_LINK_INTERRUPT_MASK_DISABLE,
    .p_src                 = (void *) ((uint32_t) &g_src1[0]),  /* Source address */
    .p_dest                = (void *) ((uint32_t) &g_dest1[0]), /* Destination address */
    .transaction_byte      = TRANSFER_LENGTH_1,                 /* Transaction byte */
    .channel_cfg           = DMAC_CHCFG_SETTING_VALUE,          /* Channel configuration register setting */
    .channel_interval      = 0,                                 /* Channel interval. */
    .channel_extension_cfg = 0,                                 /* Channel extension register setting */
    .p_next_link_addr      = NULL,                              /* Next link address */
};

dmac_link_cfg_t transfer2_descriptor BSP_ALIGN_VARIABLE (4) =
{
    .header.link_valid         = DMAC_LINK_VALID_DESCRIPTOR_ENABLE,
    .header.link_end           = DMAC_LINK_END_ENABLE,
    .header.write_back_disable = DMAC_LINK_WRITE_BACK_DISABLE,
    .header.interrupt_mask     = DMAC_LINK_INTERRUPT_MASK_DISABLE,
    .p_src                 = (void *) ((uint32_t) &g_src2[0]),  /* Source address */
    .p_dest                = (void *) ((uint32_t) &g_dest2[0]), /* Destination address */
    .transaction_byte      = TRANSFER_LENGTH_2,                 /* Transaction byte */
    .channel_cfg           = DMAC_CHCFG_SETTING_VALUE,          /* Channel configuration register setting */
    .channel_interval      = 0,                                 /* Channel interval. */
    .channel_extension_cfg = 0,                                 /* Channel extension register setting */
    .p_next_link_addr      = NULL,                              /* Next link address */
};

#endif

volatile bool g_transfer_complete = false;

void dmac_callback (transfer_callback_args_t * p_args)
{
    FSP_PARAMETER_NOT_USED(p_args);
    g_transfer_complete = true;
}

void dmac_link_mode_example (void)
{
    for (uint32_t i = 0; i < TRANSFER_LENGTH_0; i++)
    {
        g_src0[i] = (uint8_t) ('A' + (i % 26));
    }

    for (uint32_t i = 0; i < TRANSFER_LENGTH_1; i++)
    {
        g_src1[i] = (uint8_t) ('A' + (i % 26));
    }

    for (uint32_t i = 0; i < TRANSFER_LENGTH_2; i++)
    {
        g_src2[i] = (uint8_t) ('A' + (i % 26));
    }

#if (UINTPTR_MAX > UINT32_MAX)

    /*  To set the physical address, use R_MMU_VAtoPA function to convert from the virtual address to the physical address. */
    uint64_t * p_src_paddress = 0;
    R_MMU_VAtoPA(NULL, (uint64_t) &g_src0[0], p_src_paddress);
    transfer0_descriptor.src_addr = (uint32_t) *p_src_paddress;

    uint64_t * p_dest_paddress = 0;
    R_MMU_VAtoPA(NULL, (uint64_t) &g_dest0[0], p_dest_paddress);
    transfer0_descriptor.dest_addr = (uint32_t) *p_dest_paddress;

    uint64_t * p_next_link_paddress = 0;
    R_MMU_VAtoPA(NULL, (uint64_t) &transfer1_descriptor, p_next_link_paddress);
    transfer0_descriptor.next_link_addr = (uint32_t) *p_next_link_paddress;

    R_MMU_VAtoPA(NULL, (uint64_t) &g_src1[0], p_src_paddress);
    transfer1_descriptor.src_addr = (uint32_t) *p_src_paddress;

    R_MMU_VAtoPA(NULL, (uint64_t) &g_dest1[0], p_dest_paddress);
    transfer1_descriptor.dest_addr = (uint32_t) *p_dest_paddress;

    R_MMU_VAtoPA(NULL, (uint64_t) &transfer2_descriptor, p_next_link_paddress);
    transfer1_descriptor.next_link_addr = (uint32_t) *p_next_link_paddress;

    R_MMU_VAtoPA(NULL, (uint64_t) &g_src2[0], p_src_paddress);
    transfer2_descriptor.src_addr = (uint32_t) *p_src_paddress;

    R_MMU_VAtoPA(NULL, (uint64_t) &g_dest2[0], p_dest_paddress);
    transfer2_descriptor.dest_addr = (uint32_t) *p_dest_paddress;
#else
    transfer0_descriptor.p_next_link_addr = &transfer1_descriptor;
    transfer1_descriptor.p_next_link_addr = &transfer2_descriptor;
#endif

    /* Open the transfer instance with initial configuration. */
    fsp_err_t err = R_DMAC_Open(&g_transfer_ctrl, &g_transfer_cfg);
    assert(FSP_SUCCESS == err);

    /* Reset transfer descriptor. */
    err = R_DMAC_LinkDescriptorSet(&g_transfer_ctrl, &transfer0_descriptor);
    assert(FSP_SUCCESS == err);

    /* Trigger the transfer using software. */
    err = R_DMAC_SoftwareStart(&g_transfer_ctrl, (transfer_start_mode_t) NULL);
    assert(FSP_SUCCESS == err);

    while (!g_transfer_complete)
    {
        /* Wait for the first transfer complete interrupt */
    }

    g_transfer_complete = false;

    /* Trigger the transfer using software. */
    err = R_DMAC_SoftwareStart(&g_transfer_ctrl, (transfer_start_mode_t) NULL);
    assert(FSP_SUCCESS == err);

    while (!g_transfer_complete)
    {
        /* Wait for the second transfer complete interrupt */
    }

    g_transfer_complete = false;

    /* Trigger the transfer using software. */
    err = R_DMAC_SoftwareStart(&g_transfer_ctrl, (transfer_start_mode_t) NULL);
    assert(FSP_SUCCESS == err);

    while (!g_transfer_complete)
    {
        /* Wait for the third transfer complete interrupt */
    }
}

Data Structures
struct	dmac_next1_register_setting_t
struct	dmac_link_cfg_t
struct	dmac_instance_ctrl_t
struct	dmac_extended_cfg_t
struct	dmac_extended_info_t

Macros
#define	DMAC_MAX_NORMAL_TRANSFER_LENGTH
#define	DMAC_MAX_BLOCK_TRANSFER_LENGTH

Enumerations
enum	dmac_event_t
enum	dmac_transfer_size_t
enum	dmac_ack_mode_t
enum	dmac_detection_t
enum	dmac_request_direction_t
enum	dmac_continuous_setting_t
enum	dmac_channel_scheduling_t
enum	dmac_mode_select_t
enum	dmac_link_valid_t
enum	dmac_link_end_t
enum	dmac_link_write_back_t
enum	dmac_link_interrupt_mask_t

---

Data Structure Documentation

dmac_next1_register_setting_t

struct dmac_next1_register_setting_t

Register set settings.

Data Fields
void const *	p_src	Source pointer.
void *	p_dest	Destination pointer.
uint32_t	length	Transfer Byte.

dmac_link_cfg_t

struct dmac_link_cfg_t

Descriptor structure used in DMAC link mode, and variables of dmac_link_cfg_t must be allocated in the memory area.

Data Fields
union dmac_link_cfg_t	__unnamed__
void const *volatile	p_src	Source address.
void *volatile	p_dest	Destination address.
volatile uint32_t	transaction_byte	Transaction byte.
volatile uint32_t	channel_cfg	Channel configuration (Set value for CHCFG_n register).
volatile uint32_t	channel_interval	Channel interval (Set value for CHITVL register).
volatile uint32_t	channel_extension_cfg	Channel extension configuration (Set value for CHEXT_n register).
void *volatile	p_next_link_addr	Next link address.

dmac_instance_ctrl_t

struct dmac_instance_ctrl_t

Control block used by driver. DO NOT INITIALIZE - this structure will be initialized in transfer_api_t::open.

dmac_extended_cfg_t

struct dmac_extended_cfg_t

DMAC transfer configuration extension. This extension is required.

Data Fields
uint8_t	channel
	Channel number.
IRQn_Type	dmac_int_irq
	DMAC interrupt number.
uint8_t	dmac_int_ipl
	DMAC interrupt priority.
uint32_t	dmac_int_irq_detect_type
	DMAC interrupt detection type.
dmac_trigger_event_t	activation_source
IRQn_Type	activation_irq_number
dmac_ack_mode_t	ack_mode
	DACK output mode.
dmac_detection_t	detection_mode
	DMAC request detection method.
dmac_request_direction_t	activation_request_source_select
	DMAC activation request source.
dmac_mode_select_t	dmac_mode
	DMAC Mode.
dmac_link_cfg_t const *	p_descriptor
	The address of the descriptor (DMA Link Mode only)
dmac_continuous_setting_t	continuous_setting
	Next register operation settings.
uint16_t	transfer_interval
	DMA transfer interval.
dmac_channel_scheduling_t	channel_scheduling
	DMA channel scheduling.
void(*	p_callback )(dmac_callback_args_t *cb_data)
void const *	p_context

Field Documentation

activation_source

dmac_trigger_event_t dmac_extended_cfg_t::activation_source

Select which event will trigger the transfer.

activation_irq_number

IRQn_Type dmac_extended_cfg_t::activation_irq_number

The interrupt ID number that corresponds to the Activation Source.

p_callback

void(* dmac_extended_cfg_t::p_callback) (dmac_callback_args_t *cb_data)

Callback for transfer end interrupt.

p_context

void const* dmac_extended_cfg_t::p_context

Placeholder for user data. Passed to the user p_callback in transfer_callback_args_t.

dmac_extended_info_t

struct dmac_extended_info_t

DMAC transfer configuration extension. This extension is required.

Data Fields
dmac_transfer_size_t	src_size	Select number of source bytes to transfer at once.
dmac_transfer_size_t	dest_size	Select number of destnination bytes to transfer at once.
dmac_next1_register_setting_t *	p_next1_register_setting	Next1 Register set settings

Macro Definition Documentation

DMAC_MAX_NORMAL_TRANSFER_LENGTH

#define DMAC_MAX_NORMAL_TRANSFER_LENGTH

Max configurable number of transfers in TRANSFER_MODE_NORMAL.

DMAC_MAX_BLOCK_TRANSFER_LENGTH

#define DMAC_MAX_BLOCK_TRANSFER_LENGTH

Max number of transfers per block in TRANSFER_MODE_BLOCK

Enumeration Type Documentation

dmac_event_t

enum dmac_event_t

Events that can trigger a callback function.

Enumerator
DMAC_EVENT_TRANSFER_END	DMA transfer has completed.
DMAC_EVENT_TRANSFER_ERROR	A bus error occurred during DMA transfer.

dmac_transfer_size_t

enum dmac_transfer_size_t

Transfer size specifies the size of each individual transfer.

Enumerator
DMAC_TRANSFER_SIZE_1_BYTE	Each transfer transfers a 8-bit value.
DMAC_TRANSFER_SIZE_2_BYTE	Each transfer transfers a 16-bit value.
DMAC_TRANSFER_SIZE_4_BYTE	Each transfer transfers a 32-bit value.
DMAC_TRANSFER_SIZE_8_BYTE	Each transfer transfers a 64-bit value.
DMAC_TRANSFER_SIZE_16_BYTE	Each transfer transfers a 128-bit value.
DMAC_TRANSFER_SIZE_32_BYTE	Each transfer transfers a 256-bit value.
DMAC_TRANSFER_SIZE_64_BYTE	Each transfer transfers a 512-bit value.
DMAC_TRANSFER_SIZE_128_BYTE	Each transfer transfers a 1024-bit value.

dmac_ack_mode_t

enum dmac_ack_mode_t

DACK output mode. See RZ/T2M hardware manual Table 14.19 DMA Transfer Request Detection Operation Setting Table.

Enumerator
DMAC_ACK_MODE_LEVEL_MODE	Level mode.
DMAC_ACK_MODE_BUS_CYCLE_MODE	Bus cycle mode.
DMAC_ACK_MODE_MASK_DACK_OUTPUT	Output is masked.

dmac_detection_t

enum dmac_detection_t

Detection method of the DMA request signal. See RZ/T2M hardware manual Table 14.19 DMA Transfer Request Detection Operation Setting Table.

Enumerator
DMAC_DETECTION_FALLING_EDGE	Falling edge detection.
DMAC_DETECTION_RISING_EDGE	Rising edge detection.
DMAC_DETECTION_LOW_LEVEL	Low level detection.
DMAC_DETECTION_HIGH_LEVEL	High level detection.

dmac_request_direction_t

enum dmac_request_direction_t

DMA activation request source select. See RZ/T2M hardware manual Table 14.19 DMA Transfer Request Detection Operation Setting Table.

Enumerator
DMAC_REQUEST_DIRECTION_SOURCE_MODULE	Requested by a transfer source module.
DMAC_REQUEST_DIRECTION_DESTINATION_MODULE	Requested by a transfer destination module.

dmac_continuous_setting_t

enum dmac_continuous_setting_t

Select the Next register set to be executed next.

Enumerator
DMAC_CONTINUOUS_SETTING_TRANSFER_NEXT0_ONCE	Transfer only once using the Next0 register set.
DMAC_CONTINUOUS_SETTING_TRANSFER_NEXT0_NEXT1_ALTERNATELY	Transfers are performed alternately with the Next0 register set and the Next1 register set.

dmac_channel_scheduling_t

enum dmac_channel_scheduling_t

DMAC channel scheduling.

Enumerator
DMAC_CHANNEL_SCHEDULING_FIXED	Fixed priority mode.
DMAC_CHANNEL_SCHEDULING_ROUND_ROBIN	Round-robin mode.

dmac_mode_select_t

enum dmac_mode_select_t

DMAC mode setting.

Enumerator
DMAC_MODE_SELECT_REGISTER	Register mode.
DMAC_MODE_SELECT_LINK	Link mode.

dmac_link_valid_t

enum dmac_link_valid_t

Indicates the descriptor is enabled or disabled.

Enumerator
DMAC_LINK_VALID_DESCRIPTOR_DISABLE	The Descriptor is disabled.
DMAC_LINK_VALID_DESCRIPTOR_ENABLE	The Descriptor is enabled.

dmac_link_end_t

enum dmac_link_end_t

Indicates that the link ends during DMA transfer of this descriptor.

Enumerator
DMAC_LINK_END_DISABLE	The link continues.
DMAC_LINK_END_ENABLE	The link ends.

dmac_link_write_back_t

enum dmac_link_write_back_t

Masks write back execution of the dmac_link_cfg_t::link_valid. When disable, DMAC does not perform write-back operation.

Enumerator
DMAC_LINK_WRITE_BACK_ENABLE	Set dmac_link_cfg_t::link_valid to disable after the DMA transfer ends.
DMAC_LINK_WRITE_BACK_DISABLE	Remain dmac_link_cfg_t::link_valid after DMA transfer ends.

dmac_link_interrupt_mask_t

enum dmac_link_interrupt_mask_t

When dmac_link_cfg_t::link_valid is DMAC_LINK_VALID_DESCRIPTOR_DISABLE at loading of header, specifies whether DMA transfer completion interrupt mask or not.

Enumerator
DMAC_LINK_INTERRUPT_MASK_DISABLE	DMA transfer completion interrupt is asserted.
DMAC_LINK_INTERRUPT_MASK_ENABLE	DMA transfer completion interrupt is masked.

Function Documentation

R_DMAC_Open()

fsp_err_t R_DMAC_Open	(	transfer_ctrl_t *const	p_api_ctrl,
		transfer_cfg_t const *const	p_cfg
	)

Configure a DMAC channel.

Return values

FSP_SUCCESS	Successful open.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_IP_CHANNEL_NOT_PRESENT	The configured channel is invalid.
FSP_ERR_IRQ_BSP_DISABLED	The IRQ associated with the activation source is not enabled in the BSP.
FSP_ERR_ALREADY_OPEN	The control structure is already opened.

R_DMAC_Reconfigure()

fsp_err_t R_DMAC_Reconfigure	(	transfer_ctrl_t *const	p_api_ctrl,
		transfer_info_t *	p_info
	)

Reconfigure the transfer with new transfer info.

Return values

FSP_SUCCESS	Transfer is configured and will start when trigger occurs.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_ENABLED	DMAC is not enabled. The current configuration must not be valid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.

R_DMAC_Reset()

fsp_err_t R_DMAC_Reset	(	transfer_ctrl_t *const	p_api_ctrl,
		void const *volatile	p_src,
		void *volatile	p_dest,
		uint16_t const	num_transfers
	)

Reset transfer source, destination, and number of transfers.

Return values

FSP_ERR_UNSUPPORTED

API not supported.

R_DMAC_SoftwareStart()

fsp_err_t R_DMAC_SoftwareStart	(	transfer_ctrl_t *const	p_api_ctrl,
		transfer_start_mode_t	mode
	)

If the mode is TRANSFER_START_MODE_SINGLE initiate a single transfer with software. If the mode is TRANSFER_START_MODE_REPEAT continue triggering transfers until all of the transfers are completed.

Return values

FSP_SUCCESS	Transfer started written successfully.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.

R_DMAC_SoftwareStop()

fsp_err_t R_DMAC_SoftwareStop

(

transfer_ctrl_t *const

p_api_ctrl

)

Stop software transfers if they were started with TRANSFER_START_MODE_REPEAT.

Return values

FSP_SUCCESS	Transfer stopped written successfully.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.

R_DMAC_Enable()

fsp_err_t R_DMAC_Enable

(

transfer_ctrl_t *const

p_api_ctrl

)

Enable transfers for the configured activation source.

Return values

FSP_SUCCESS	Counter value written successfully.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.

R_DMAC_Disable()

fsp_err_t R_DMAC_Disable

(

transfer_ctrl_t *const

p_api_ctrl

)

Disable transfers so that they are no longer triggered by the activation source.

Return values

FSP_SUCCESS	Counter value written successfully.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.

R_DMAC_InfoGet()

fsp_err_t R_DMAC_InfoGet	(	transfer_ctrl_t *const	p_api_ctrl,
		transfer_properties_t *const	p_info
	)

Set driver specific information in provided pointer.

Return values

FSP_SUCCESS	Information has been written to p_info.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.
FSP_ERR_ASSERTION	An input parameter is invalid.

R_DMAC_Close()

fsp_err_t R_DMAC_Close

(

transfer_ctrl_t *const

p_api_ctrl

)

Disable transfer and clean up internal data. Implements transfer_api_t::close.

Return values

FSP_SUCCESS	Successful close.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.

R_DMAC_Reload()

fsp_err_t R_DMAC_Reload	(	transfer_ctrl_t *const	p_api_ctrl,
		void const *volatile	p_src,
		void *volatile	p_dest,
		uint32_t const	num_transfers
	)

Make the following transfer settings to continue the transfer. Implements transfer_api_t::reload.

Return values

FSP_SUCCESS	Successful continuous transfer settings.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.
FSP_ERR_INVALID_MODE	This API cannot be called during link mode operation or setting not to use the Next1 register.

R_DMAC_CallbackSet()

fsp_err_t R_DMAC_CallbackSet	(	transfer_ctrl_t *const	p_api_ctrl,
		void(*)(dmac_callback_args_t *)	p_callback,
		void const *const	p_context,
		dmac_callback_args_t *const	p_callback_memory
	)

Updates the user callback with the option to provide memory for the callback argument structure.

Return values

FSP_SUCCESS	Callback updated successfully.
FSP_ERR_ASSERTION	A required pointer is NULL.
FSP_ERR_NOT_OPEN	The control block has not been opened.

R_DMAC_LinkDescriptorSet()

fsp_err_t R_DMAC_LinkDescriptorSet	(	transfer_ctrl_t *const	p_api_ctrl,
		dmac_link_cfg_t *	p_descriptor
	)

Reconfigure the transfer descriptor information with new transfer descriptor.

Return values

FSP_SUCCESS	Transfer is configured and will start when trigger occurs.
FSP_ERR_ASSERTION	An input parameter is invalid.
FSP_ERR_NOT_ENABLED	DMAC is not enabled. The current configuration must not be valid.
FSP_ERR_INVALID_MODE	DMA mode is register mode. This function can only be used when the DMA mode is link mode.
FSP_ERR_NOT_OPEN	Handle is not initialized. Call R_DMAC_Open to initialize the control block.