Visible to Intel only — GUID: iga1446069969096
Ixiasoft
Visible to Intel only — GUID: iga1446069969096
Ixiasoft
31.8.12. alt_msgdma_construct_extended_mm_to_st_descriptor
Prototype: | int alt_msgdma_construct_extended_mm_to_st_descriptor (alt_msgdma_dev *dev, alt_msgdma_extended_descriptor *descriptor, alt_u32 *read_address, alt_u32 length, alt_u32 control, alt_u16 sequence_number, alt_u8 read_burst_count, alt_u16 read_stride) |
Include: | < modular_sgdma_dispatcher.h > |
Parameters: | *dev-a pointer to msgdma instance. *descriptor – a pointer to an extended descriptor structure. *read_address – a pointer to the base address of the source memory. length – is used to specify the number of bytes to transfer per descriptor. The largest possible value can be filled in is “0Xffffffff”. control – control field. sequence_number – programmable sequence number to identify which descriptor has been sent to the host block. read_burst_count – programmable burst count between 1 and 128 and a power of 2. Setting to 0 will cause the host to use the maximum burst count instead. read_stride – programmable transfer stride. The stride value determines by how many words the host will increment the address. For fixed addresses the stride value is 0, sequential it is 1, every other word it is 2, etc… |
Returns: | “0” for success, -EINVAL for invalid argument, could be due to argument which has larger value than hardware setting value.
|
Description: | Function call helper function “alt_msgdma_construct_extended_descriptor” for constructing mm_to_st extended descriptors. Unnecessary elements are set to 0 for completeness and will be ignored by the hardware. |