USBHS_DEVDMACONTROLx

Device DMA Channel x Control Register

  0x0308 + (x-1)*0x10 [x=1..7] 32 Read/Write 0   7 16 1index -1

Device DMA Channel x Control Register

Bit  31 30 29 28 27 26 25 24  
  BUFF_LENGTH[15:8]  
Access                   
Reset  0 0 0 0 0 0 0 0  
Bit  23 22 21 20 19 18 17 16  
  BUFF_LENGTH[7:0]  
Access                   
Reset  0 0 0 0 0 0 0 0  
Bit  15 14 13 12 11 10 9 8  
                   
Access                   
Reset                   
Bit  7 6 5 4 3 2 1 0  
  BURST_LCK DESC_LD_IT END_BUFFIT END_TR_IT END_B_EN END_TR_EN LDNXT_DSC CHANN_ENB  
Access                   
Reset  0 0 0 0 0 0 0 0  

Bit 0 – CHANN_ENB: Channel Enable Command

Channel Enable Command

ValueDescription
0

The DMA channel is disabled at end of transfer and no transfer occurs upon request. This bit is also cleared by hardware when the channel source bus is disabled at end of buffer.

If the LDNXT_DSC bit has been cleared by descriptor loading, the firmware must set the corresponding CHANN_ENB bit to start the described transfer, if needed.

If the LDNXT_DSC bit is cleared, the channel is frozen and the channel registers may then be read and/or written reliably as soon as both USBHS_DEVDMASTATUS.CHANN_ENB and CHANN_ACT flags read as 0.

If a channel request is currently serviced when this bit is cleared, the DMA FIFO buffer is drained until it is empty, then the USBHS_DEVDMASTATUS.CHANN_ENB bit is cleared.

If the LDNXT_DSC bit is set at or after this bit clearing, then the currently loaded descriptor is skipped (no data transfer occurs) and the next descriptor is immediately loaded.

1

The USBHS_DEVDMASTATUS.CHANN_ENB bit is set, thus enabling the DMA channel data transfer. Then, any pending request starts the transfer. This may be used to start or resume any requested transfer.

Bit 1 – LDNXT_DSC: Load Next Channel Transfer Descriptor Enable Command

Load Next Channel Transfer Descriptor Enable Command

If the CHANN_ENB bit is cleared, the next descriptor is immediately loaded upon transfer request.

DMA Channel Control Command Summary:

Value LDNXT_DSC Value CHANN_ENB Name Description
0 0 STOP_NOW Stop now
0 1 RUN_AND_STOP Run and stop at end of buffer
1 0 LOAD_NEXT_DESC Load next descriptor now
1 1 RUN_AND_LINK Run and link at end of buffer
ValueDescription
0

No channel register is loaded after the end of the channel transfer.

1

The channel controller loads the next descriptor after the end of the current transfer, i.e., when the USBHS_DEVDMASTATUS.CHANN_ENB bit is reset.

Bit 2 – END_TR_EN: End of Transfer Enable Control (OUT transfers only)

End of Transfer Enable Control (OUT transfers only)

When set, a BULK or INTERRUPT short packet or the last packet of an ISOCHRONOUS (micro) frame (DATAX) closes the current buffer and the USBHS_DEVDMASTATUSx.END_TR_ST flag is raised.

This is intended for a USBHS non-prenegotiated end of transfer (BULK or INTERRUPT) or ISOCHRONOUS microframe data buffer closure.

ValueDescription
0

The USB end of transfer is ignored.

1

The USBHS device can put an end to the current buffer transfer.

Bit 3 – END_B_EN: End of Buffer Enable Control

End of Buffer Enable Control

This is mainly for short packet IN validations initiated by the DMA reaching end of buffer, but can be used for OUT packet truncation (discarding of unwanted packet data) at the end of DMA buffer.

ValueDescription
0

DMA Buffer End has no impact on USB packet transfer.

1

The endpoint can validate the packet (according to the values programmed in the USBHS_DEVEPTCFGx.AUTOSW and USBHS_DEVEPTIERx.SHORTPACKETES fields) at DMA Buffer End, i.e., when USBHS_DEVDMASTATUS.BUFF_COUNT reaches 0.

Bit 4 – END_TR_IT: End of Transfer Interrupt Enable

End of Transfer Interrupt Enable

Use when the receive size is unknown.

ValueDescription
0

USBHS device-initiated buffer transfer completion does not trigger any interrupt at USBHS_DEVDMASTATUSx.END_TR_ST rising.

1

An interrupt is sent after the buffer transfer is complete, if the USBHS device has ended the buffer transfer.

Bit 5 – END_BUFFIT: End of Buffer Interrupt Enable

End of Buffer Interrupt Enable

ValueDescription
0

USBHS_DEVDMA_STATUSx.END_BF_ST rising does not trigger any interrupt.

1

An interrupt is generated when USBHS_HSTDMASTATUSx.BUFF_COUNT reaches zero.

Bit 6 – DESC_LD_IT: Descriptor Loaded Interrupt Enable

Descriptor Loaded Interrupt Enable

ValueDescription
0

USBHS_DEVDMASTATUSx.DESC_LDST rising does not trigger any interrupt.

1

An interrupt is generated when a descriptor has been loaded from the bus.

Bit 7 – BURST_LCK: Burst Lock Enable

Burst Lock Enable

ValueDescription
0

The DMA never locks bus access.

1

USB packets AHB data bursts are locked for maximum optimization of the bus bandwidth usage and maximization of fly-by AHB burst duration.

Bits 31:16 – BUFF_LENGTH[15:0]: Buffer Byte Length (Write-only)

Buffer Byte Length (Write-only)

This field determines the number of bytes to be transferred until end of buffer. The maximum channel transfer size (32 KBytes) is reached when this field is 0 (default value). If the transfer size is unknown, this field should be set to 0, but the transfer end may occur earlier under USB device control.

When this field is written, the USBHS_DEVDMASTATUSx.BUFF_COUNT field is updated with the write value.

Note: 1. Bits [31:2] are only writable when issuing a channel Control Command other than “Stop Now”.
Note: 2. For reliability, it is recommended to wait for both the USBHS_DEVDMASTATUSx.CHAN_ACT and the USBHS_DEVDMASTATUSx.CHAN_ENB flags to be at 0, thus ensuring the channel has been stopped before issuing a command other than “Stop Now”.