28.8. Parameters
| Parameter Display Name | Parameter Name | Allowable Range | Default Value | Description |
|---|---|---|---|---|
| DMA Settings | ||||
| DMA Mode | MODE | 0: Memory-Mapped to Memory-Mapped, 1: Memory-Mapped to Streaming, 2: Streaming to Memory-Mapped |
0: Memory-Mapped to Memory-Mapped |
Transfer mode of mSGDMA. This parameter determines the dispatcher, read and write host sub-cores instantiation to construct the mSGDMA structure. |
| Data Width | DATA_WIDTH | 8, 16, 32, 64, 128, 256, 512, 1024 | 32 | Datapath width. This parameter affects both read host and write host Avalon® MM/ST data widths. |
| Use pre-determined host address width | USE_FIX_ADDRESS_WIDTH | Enable, Disable | Disable | When enabled, host address width is configurable based on parameter ‘pre-determined host address width’. When disabled, host address width is set to 32-bit. |
| Pre-determined host address width | FIX_ADDRESS_WIDTH | Standard descriptor: 1-32 Extended descriptor: 1-64 |
32 | Minimum host address width that is required to address memory agent.
Note: Applicable only when parameter ‘Use pre-determined host address width’ is enabled.
|
| Expose mSGDMA read and write host's streaming ports | EXPOSE_ST_PORT | Enable, Disable | Disable | When enabled, mSGDMA read host's data source port and mSGDMA write host's data sink port will be exposed for connection outside mSGDMA IP.
Note: Applicable only for Memory-Mapped to Memory-Mapped configuration.
|
| Data Path FIFO Depth | DATA_FIFO_DEPTH | 16, 32, 64, 128, 256, 512, 1024, 2048, 4096 | 32 | Depth of internal data path FIFO. The FIFO depth setting must be at least four times the maximum burst count setting. |
| Descriptor FIFO Depth | DESCRIPTOR_FIFO_DEPTH | 8, 16, 32, 64, 128, 256, 512, 1024 | 128 | FIFO size to store descriptor count. |
| Response Port | RESPONSE_PORT | 0: Memory-Mapped, 1: Streaming, 2: Disabled |
2: Disabled |
Option to enable response port and its port interface type.
Note: Applicable only when Prefetcher is disabled and DMA mode is set to either Memory-Mapped to Memory-Mapped or Streaming to Memory-Mapped.
|
| Maximum Transfer Length | MAX_BYTE | 1KB, 2KB, 4KB, 8KB, 16KB, 32KB, 64KB,128KB,256KB, 512KB, 1MB, 2MB,4MB, 8MB, 16MB, 32MB, 64MB, 128MB,256MB, 512MB, 1GB, 2GB | 1KB | Maximum transfer length. With shorter length width being configured, the faster frequency of mSGDMA can operate in FPGA. |
| Transfer Type | TRANSFER_TYPE | Full Word Accesses Only, Aligned Accesses, Unaligned Accesses |
Aligned Accesses | Supported transaction type. Full Word Accesses Only: When full word accesses only is enabled, you must provide an address that is aligned. You must also provide a transfer length is that is a multiple of the data width. This memory access mode results in the smallest hardware footprint and highest frequency. Aligned Accesses: When aligned accesses is enabled, you must provide an address that is aligned. You can provide any transfer length. Unaligned Accesses: When unaligned accesses is enabled, you can provide any address or transfer length. This memory access mode results in the largest hardware footprint and lowest frequency. |
| No Byteenables During Writes | NO_BYTEENABLES | Enable, Disable | Disable | When enabled, it forces all byte enables to high. This option is only applicable when transfer type is set to Aligned Accesses and DMA mode is set to either Memory-mapped to Memory-Mappedor Streamingto Memory- Mapped. When enabled, software needs to handle scenario where transfer length is not a multiple of data width at the end of transfer.
Note: This parameter is only available in Quartus® Prime Pro Edition.
|
| Burst Enable | BURST_ENABLE | Enable, Disable | Disable | Enable burst transfer. Bursting must not be enabled when stride is also enabled. |
| Maximum Burst Count | MAX_BURST_COUNT | 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024 | 2 | Maximum burst count. The maximum burst count must be less than or equal to a quarter of the FIFO depth setting.
Note: Applicable only when parameter Burst Enable is enabled.
|
| Force Burst Alignment Enable | BURST_WRAPPING_SUPPORT | Enable, Disable | Disable | Enable force burst alignment to force the hosts to post bursts of length1 until the address is aligned to the next burst boundary.
Note: If this feature is enabled, it’ll caused performance degradation if the address is not burst aligned.
Note: You cannot use this setting and programmable burst capabilities concurrently.
Note: Applicable only when parameter Burst Enable is enabled.
|
| Enable Write Response | WRITE_RESPONSE_ENABLE | Enable, Disable | Disable | When enabled, it turns on the write response features of the write host. After completion of theDMA transfer, the host is only notified when all the outstanding writes have been responded.
Note: Applicable only to either Memory-Mapped to Memory-Mappedor Streamingto Memory-Mapped.
Note: This parameter is only available in Quartus® Prime Pro Edition.
|
| Extended Feature Options | ||||
| Enable Extended Feature Support | ENHANCED_FEATURES | Enable, Disable | Disable | Enable extended features. In order to use stride addressing, programmable burst lengths, 64-bit addressing, or descriptor tagging, the enhanced features support must be enabled. |
| Stride Addressing Enable | STRIDE_ENABLE | Enable, Disable | Disable | Enable stride addressing. Stride addressing allows the DMA to read or write data that is interleaved in memory. Stride addressing cannot be enabled if the burst transfer option or unaligned accesses is enabled
Note: Applicable only when parameter Enable Extended Feature Support is enabled.
|
| Maximum Stride Words | MAX_STRIDE | 1 – 32768 | 1 | Maximum stride amount (in words). 1- Sequential address 2 - skip every other word in sequential transfer
Note: Applicable only when parameter Enable Extended Feature Support and Stride Addressing Enable are enabled.
|
| Programmable Burst Enable | PROGRAMMABLE_BURST_ENABLE | Enable, Disable | Disable | Enable dynamic burst programming. You cannot use this setting and force burst alignment support concurrently.
Note: Applicable only when parameter Enable Extended Feature Support and Burst Enable are enabled.
|
| Streaming Options | ||||
| Packet Support Enable | PACKET_ENABLE | Enable, Disable | Disable | Enable packetized transfer
Note: When PACKET_ENABLE parameter is disabled and TRANSFER_TYPE is not "Full Word Accesses Only", any unaligned transfer length will cause additional bytes to be written during the last transfer beat of the Avalon streaming data source port of the read host core. Only with this parameter set TRUE, actual bytes transferred is meaningful for the transaction.
Note: PACKET_ENABLE only apply for Memory-Mapped to Streaming or Streaming to Memory-Mapped DMA operation mode.
|
| Error Enable | ERROR_ENABLE | Enable, Disable | Disable | Enable error field of Avalon® -ST interface
Note: Applicable only for Memory-Mapped to Streaming or Streaming to Memory-Mapped configurations
|
| Error Width | ERROR_WIDTH | 1, 2, 3, 4, 5, 6, 7, 8 | 8 | Error field width. Set the error width according to the number of error lines connected to the data source port.
Note: Applicable only when Error Enable is enabled and for either Memory-Mapped to Streaming or Streaming to Memory-Mapped configurations.
|
| Channel Enable | CHANNEL_ENABLE | Enable, Disable | Disable | Enable channel field of Avalon® -ST interface
Note: Applicable only for Memory-Mapped to Streaming configuration
|
| Channel Width | CHANNEL_WIDTH | 1, 2, 3, 4, 5, 6, 7, 8 | 8 | Channel field width. Set the channel width according to the number of channel lines connected to the data source port.
Note: Applicable only when Channel Enable is enabled and for Memory-Mapped to Streaming configuration
|
| Enable Pre-fetching Module | PREFETCHER_ENABLE | Enable, Disable | Disable | Enables prefetcher modules, a hardware core which fetches descriptors from memory. |
| Expose response port to enable sideband support | SIDEBAND_ENABLE | Enable, Disable | Disable | If enabled, prefetcher performs write back to descriptor fields offset 0x30, 0x34 and 0x38 with the sideband information from the Avalon ST Response Sink data bus [191:160], [223:192] and [255:224] . If disabled, prefetcher do not perform write back to descriptor fields offset 0x30, 0x34 and 0x38. These offset are reserved fields.
Note:
This parameter is applicable when Prefetcher is enabled and Enable Extended Feature Support parameter is set to 1. Else, sideband write back feature is disabled. |
| Enable bursting on descriptor read host | PREFETCHER_READ_BURST_ENABLE | Enable, Disable | Disable | Enable read burst will turn on the bursting capabilities of the prefetcher's read descriptor interface when fetching descriptors. |
| Data Width of Descriptor read/write host data path | PREFETCHER_DATA_WIDTH | For non-burst transfer of standard descriptor: 32, 64, 128, 256 For non-burst transfer of extended descriptor: 32, 64, 128, 256, 512 |
32 | Width of the Avalon® -MM descriptor read/write data path.
Note: When parameter ‘Enable bursting on descriptor read host’ is enabled, the allowed range for descriptor data width is dependent on the configured maximum burst count of descriptor read host, to transfer for a 256-bit standard descriptor or 512-bit extended descriptor.
|
| Maximum Burst Count on descriptor read host | PREFETCHER_MAX_READ_BURST_COUNT | 2, 4, 8, 16 | 2 | Specifies the maximum read burst count of Avalon® -MM read descriptor host. The allowed range for maximum burst count of descriptor read host is dependent on the configured descriptor data width, to transfer for a 256-bit standard descriptor or 512-bit extended descriptor.
Note: Applicable only when parameter Enable bursting on descriptor read host is enabled
|