CONFIG EDMAX - Revision history

Admin: Created page with "= Action = Configures the enhanced direct memory access (DMA) channel of the XMEGA.
2017-01-17T20:35:38Z

Created page with "= <span style="font-size: 14pt; font-weight: bold;">Action</span> = Configures the enhanced direct memory access (DMA) channel of the XMEGA. <span style="font-family: Arial;..."

New page
= <span style="font-size: 14pt; font-weight: bold;">Action</span> =

Configures the enhanced direct memory access (DMA) channel of the XMEGA.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Syntax</span> =

<span style="font-weight: bold; color: rgb(0, 0, 128);">CONFIG EDMACHx</span>=enabled|disabled,BURSTLEN=bl, CHANRPT=chrpt, CTR=ctr, SINGLESHOT=ss, TCI=tci, EIL=eil,SAR=sar, SAM=sam,DAR=dar,DAM=dam, TRIGGER,trig, BTC=btc,SADR=sadr, DADR=dadr

 

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Remarks</span> =

In order to understand the various options better, we first have a quick look at DMA. Please consult the help topic [[CONFIG DMACHX|CONFIG DMAx]] and the atmel documentation for the EDMA.

Normally, when you want to transfer data, the processor need to execute a number of operations.

The BASCOM MEMCOPY for example will use processor instructions like LD (load data) and ST(store data) in a loop.

If you want to clear 32KB of memory you need at least 32 K instructions. This will consume time, and all this time the processor can not handle other tasks.

In a PC, you do not want to use the processor to be busy when you load a file from disk. The EDMA controller will handle this. It can move blocks of memory between devices while the processor performs other tasks.

 

You can also send for example an array in SRAM to an USART over EDMA so the processor will not be busy handling the transfer from the Array to the USART.

 

There is also an example to receive bytes over USART to SRAM in the Bascom-AVR/Samples folders.

 

Before <span style="font-weight: bold; color: rgb(0, 0, 128);">CONFIG EDMACHx </span>can be used you need to use <span style="font-size: 8pt; font-family: 'Courier'; font-weight: bold; color: #000080;">Config</span><span style="font-size: 8pt; font-family: 'Courier';">EDMA ([[CONFIG EDMA|CONFIG_DMA]])</span>

<span style="font-size: 8pt; font-family: 'Courier';"> </span>

<span class="f_Header"> </span>
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| style="border: solid 2px #000000; border-spacing:0px; border-collapse: collapse;" width="604" cellspacing="0" cellpadding="1" border="1"
|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
DMACHx

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
There are 4 DMA channels numbered 0-3. By default these DMA channels are disabled. Use ENABLED to enable the channel.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
bl

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-weight: bold;">BURSTLEN</span>

Each DMA channel has an internal transfer buffer that is either 1 or 2 byte long.

The buffer is used to reduce the time the DMA controller occupy the bus.

 

Options :

- 1 : 1 byte burst mode

- 2 : 2 byte burst mode

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
chanrpt

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-weight: bold;">Channel Repeat</span>

Setting this bit enables the repeat mode. In repeat mode, this bit is cleared by hardware in the beginning of the last block transfer.

 

Options :

Enabled : enabled repeat mode

Disabled : disabled repeat mode

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
ctr

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">DMA Channel Transfer Request</span>

Setting this bit requests a data transfer on the DMA Channel. This bit is automatically cleared at the beginning of the data transfer

Options :

Enabled : request transfer

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
ss

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">DMA Channel Single Shot Data transfer</span>

Setting this bit enables the single shot mode. The channel will then do a burst transfer of BL bytes on the transfer trigger. This bit can not be changed if the channel is busy.

Options :

Enabled : enable SS mode.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
tci

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">DMA Channel Transaction Complete Interrupt Level</span>

The interrupt can be turned OFF, or be given a priority LO, MED or HI

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
eil

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">DMA Channel Error Interrupt Level</span>

The interrupt can be turned OFF, or be given a priority LO, MED or HI

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
sar

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Source Address Reload</span>

The channel source address can be reloaded the following way:

NONE : No reload performed.

BLOCK : DMA source address register is reloaded with initial value at end of<br/>          each block transfer.

BURST : DMA source address register is reloaded with initial value at end of<br/>           each burst transfer.

TRANSACTION : DMA source address register is reloaded with initial value at<br/>                     end of each transaction.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
sam

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Source Address Mode</span>

The address can be altered the following way :

FIXED  : The address remains the same.

INC : The address is incremented by one

If you want to write to a PORT, for example to generate a wave, you would chose FIXED. But if you want to move a block of memory, you want to use INC so the the source address is increased after each byte.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
dar

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Channel Destination Address Reload</span>

The channel destiny address can be reloaded the following way:

NONE : No reload performed.

BLOCK : DMA destiny address register is reloaded with initial value at end of<br/>          each block transfer.

BURST : DMA destiny address register is reloaded with initial value at end of<br/>           each burst transfer.

TRANSACTION : DMA destiny address register is reloaded with initial value at<br/>                     end of each transaction.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
dam

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Destiny Address Mode</span>

The address can be altered the following way :

FIXED  : The address remains the same.

INC : The address is incremented by one

If you want to write to a PORT, for example to generate a wave, you would chose FIXED. But if you want to move a block of memory, you want to use INC so the the source address is increased after each byte. In case of an byte array it would start with array(1) and the next byte would be array(2) which will be transferred and so on.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
trigger

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Trigger Source Select</span>

The trigger selected which device triggers the DMA transfer. A zero (0) will disable a trigger. You can manual start a DATA TRANSFER with START DMACHx statement.

You can find the hardware trigger values in the datasheet.

For example, EVENTSYS channel 0 would be 1. And EVENSTYS channel 1 would be 1. In case of for example an USART you need to add the base value and add an offset.

Example:

Base value for USARTC0 is &H4B

Offset for (RXC) Receive complete is &H00

Offset for (DRE) Data Register Empty is &H01

 

So when you want to use the DRE the trigger is &H4B + &H01 = &H4C

<span style="font-size: 8pt; font-family: 'Courier'; color: #008000;"> </span>

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
btc

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Block Transfer Count</span>

The BTC represents the 16-bit value TRFCNT. Which also means the max value is 64Kbyte. TRFCNT defines the number of bytes in a block transfer. The value of TRFCNT is decremented after each byte read by the DMA channel. When TRFCNT reaches zero, the register is reloaded with the last value written to it.

When repeat is 1, this is the total amount of bytes to send in the DMA transaction.

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
sadr

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Source Address</span>

This is the address of the DMA source. For example, the address of a variable. Or the address of a register. Use [[VARPTR]]() to find the address of a variable.

For example if the source address is an array:

<span style="font-size: 11pt; font-family: 'Courier New';">sadr </span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">= </span><span style="font-size: 11pt; font-family: 'Courier New'; font-weight: bold; color: #000080;">varptr</span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">(</span><span style="font-size: 11pt; font-family: 'Courier New';">ar</span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">(</span><span style="font-size: 11pt; font-family: 'Courier New';">1</span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">))</span>

For example if the source address is an hardware address like from an USART:

<span style="font-size: 11pt; font-family: 'Courier New';">sadr </span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">= </span><span style="font-size: 8pt; font-family: 'Courier'; font-weight: bold; color: #000080;">Varptr</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">(</span><span style="font-size: 8pt; font-family: 'Courier'; color: #800000;">usarte0_data</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">)</span>

<span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;"> </span>

or ADC A Channel 0:

<span style="font-size: 8pt; font-family: 'Courier';">Sadr </span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">=</span><span style="font-size: 8pt; font-family: 'Courier'; font-weight: bold; color: #000080;">Varptr</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">(</span><span style="font-size: 8pt; font-family: 'Courier'; color: #800000;">adca_ch0_res</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">)</span>

<span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;"> </span>

|- style="vertical-align: top;"
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |
dadr

| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
<span style="font-family: Arial; font-weight: bold;">Destination Address</span>

The destiny address.

This can be also for example an array in SRAM:

<span style="font-size: 11pt; font-family: 'Courier New';">dadr </span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">= </span><span style="font-size: 11pt; font-family: 'Courier New'; font-weight: bold; color: #000080;">varptr</span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">(</span><span style="font-size: 11pt; font-family: 'Courier New';">dest</span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">(</span><span style="font-size: 11pt; font-family: 'Courier New';">1</span><span style="font-size: 11pt; font-family: 'Courier New'; color: #ff0000;">))</span>

This can be also for example a hardware recourse like USART:

<span style="font-size: 8pt; font-family: 'Courier';">Dadr </span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">=</span><span style="font-size: 8pt; font-family: 'Courier'; font-weight: bold; color: #000080;">Varptr</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">(</span><span style="font-size: 8pt; font-family: 'Courier'; color: #800000;">usarte0_data</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">)</span>

<span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;"> </span>

or for example for DAC B Channel 0:

<span style="font-size: 8pt; font-family: 'Courier';">Dadr </span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">=</span><span style="font-size: 8pt; font-family: 'Courier'; font-weight: bold; color: #000080;">Varptr</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">(</span><span style="font-size: 8pt; font-family: 'Courier'; color: #800000;">dacb_ch0datal</span><span style="font-size: 8pt; font-family: 'Courier'; color: #ff0000;">)</span>

|}
</div>
 

After you have configured the DMA channel, you can start the transfer with the START EDMACHx statement.

This will write the TRFREQ bit in the CTRLA register.

 

Setting the TRFREQ Bit (DMA Channel Transfer Request) requests a DATA TRANSFER on the EDMA channel.

Setting this bit requests a data transfer on the DMA Channel. This bit is automatically cleared at

the beginning of the data transfer.

 

<span style="font-family: Arial;"> </span>

= <span class="f_Header">See also</span> =

<span style="font-family: Arial;">[[CONFIG DMA|CONFIG DMA]] , [[START|START DMACHx]], [[ATXMEGA]] , [[CONFIG EDMA|CONFIG EDMA]]</span>

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Example</span> =

<source lang="bascomavr">
'----------------------------------------------------------------
' (c) 1995-2016, MCS
' xm128A1-DMA.bas
' This sample demonstrates DMA with an Xmega32E5
'-----------------------------------------------------------------
$regfile = "xm32e5def.dat"
$crystal = 32000000
$hwstack = 64
$swstack = 40
$framesize = 40

'first enable the osc of your choice
Config Osc = Enabled , 32mhzosc = Enabled

'configure the systemclock
Config Sysclock = 32mhz , Prescalea = 1 , Prescalebc = 1_1

Config Com1 = 38400 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8

Dim Ar(100) As Byte , Dest(100) As Byte , J As Byte , W As Word

For J = 1 To 100
Ar(j) = J ' create an array and assign a value
Next

Print "DMA DEMO"
Config Edma = Enabled , Doublebuf = Disabled , Cpm = Rr ' enable DMA

'you can configure 4 DMA channels
Config Edmach0 = Enabled , Burstlen = 1 , Chanrpt = Enabled , Tci = Off , Eil = Off , Sar = None , Sam = Inc , Dar = None , Dam = Inc , Trigger = 0 , Btc = 100 , Sadr = Varptr(ar(1)) , Dadr = Varptr(dest(1))

Start Edmach0 ' this will do a manual/software DMA transfer, when trigger<>0 you can use a hardware event as a trigger source

For J = 1 To 50
Print J ; "-" ; Ar(j) ; "-" ; Dest(j) ' print the values
Next
End
</source>

<br/>{{Languages}}

[[Category:BASCOM Language Reference]]