RFSoC Data Converter Evaluation Tool User Guide
51
UG1287 (v2018.2) October 1, 2018
Chapter 7:
Protocol Specification
Command Types
The commands for the evaluation tool fall into the following categories:
• Basic commands
• RFDC API commands—Arguments are 1:1 with the RFDC API definition, with the order
specified by the order they appear in the API and C structures (Struct).
• ZCU111 onboard clock commands
• Memory read/write and data movement-related commands
Refer to
Appendix A, Reference Design Protocol Specification
commands and arguments.
Application Flow
Control/datapath description:
• Upon receiving a command, the parser parses it.
• If the command is incorrect, it returns an error.
• If the command is correct, it executes.
• If the execution fails, it returns an error with an explicit message.
• If the execution succeeds, it returns the command and optional return values.
Input command format:
•
CMD PARAM1 PARAM2 PARAM3 (
with any number of parameters)
• Commands and parameters are separated by an ASCII space.
• Commands and parameters are human readable, i.e., sent in ASCII format.
• Receive end of line is
\n
.
• Control path command syntax is the same as the RFSoC driver with "XRFdc_" removed.
Parameters are the same as in the RFSoC drivers.
°
Parameters for C structures are provided in the order they appear in the structure.
°
The command format is provided in the code.
°
Datapath command syntax is as below:
writedatatomemory <tile_id> <block_id> <Number_of_bytes> <il_pair> <DDR/BRAM>