-
Notifications
You must be signed in to change notification settings - Fork 1.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs/library/jesd204/xgt_wizard: Add FPGAs Tranceivers documentation #1643
base: main
Are you sure you want to change the base?
Conversation
|
||
.. warning:: | ||
|
||
Please note that if you used the GUI method to instantiate the wizard, the paring script will not work |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please revise the entire doc - try to wrap the text lines to 80 characters, if possible.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The fact that the screenshots were transformed into ".svg"s from PNG, is not ok. We should try to put in words the actions that are done in GUI, and only if it is really hard, then to add PNG/JPG. Definitely not to create svg from image.
Location of the **COMMON** instance: | ||
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/<component_name>_common.v | ||
Location of the **CHANNEL** instance: | ||
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/<component_name>_gt.v |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Location of the **COMMON** instance: | |
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/<component_name>_common.v | |
Location of the **CHANNEL** instance: | |
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/<component_name>_gt.v | |
- Location of the **COMMON** instance: | |
<project_name>/<project_name>.gen/sources_1/ip/<component_name>/<component_name>_common.v | |
- Location of the **CHANNEL** instance: | |
<project_name>/<project_name>.gen/sources_1/ip/<component_name>/<component_name>_gt.v |
:: | ||
|
||
[~] less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_common.v | ||
[~] less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_gt.v |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
All the code blocks should be with the .. code-block::
directive, and all terminal commands should be with .. shell:: bash
directive.
:: | |
[~] less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_common.v | |
[~] less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_gt.v | |
.. shell: bash | |
/hdl/projects | |
$less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_common.v | |
$less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_gt.v |
[~] less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_common.v | ||
[~] less daq2_zc706.gen/sources_1/ip/gtwizard_0/gtwizard_0_gt.v | ||
|
||
This instances should be compared with the COMMON and CHANNEL instances used in :git-hdl:`util_adxcvr_xcm.v <library/xilinx/util_adxcvr/util_adxcvr_xcm.v>` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This instances should be compared with the COMMON and CHANNEL instances used in :git-hdl:`util_adxcvr_xcm.v <library/xilinx/util_adxcvr/util_adxcvr_xcm.v>` | |
These instances should be compared with the COMMON and CHANNEL instances used in :git-hdl:`util_adxcvr_xcm.v <library/xilinx/util_adxcvr/util_adxcvr_xcm.v>` |
This instances should be compared with the COMMON and CHANNEL instances used in :git-hdl:`util_adxcvr_xcm.v <library/xilinx/util_adxcvr/util_adxcvr_xcm.v>` | ||
and :git-hdl:`util_adxcvr_xch.v <library/xilinx/util_adxcvr/util_adxcvr_xch.v>` . | ||
|
||
Ultrascale and Ultrascale+ FPGAs Transceiver Wizard |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ultrascale and Ultrascale+ FPGAs Transceiver Wizard | |
UltraScale FPGAs Transceiver Wizard |
For simplicity, leave it like this
Location of the **COMMON** instance: | ||
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/synth/gtwizard_ultrascale_v1_7_gthe4_common.v | ||
Location of the **COMMON** wrapper: | ||
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/synth/<component_name>_gthe4_common_wrapper.v | ||
Location of the **CHANNEL** instance: | ||
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/synth/gtwizard_ultrascale_v1_7_gthe4_channel.v | ||
Location of the **CHANNEL** instance: | ||
* <project_name>/<project_name>.gen/sources_1/ip/<component_name>/synth/<component_name>_gthe4_channel_wrapper.v |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Restructure like in the previous comment.
Also, -
lists should be used over *
lists.
:: | ||
|
||
source ../../scripts/gtwizard_generator.tcl |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:: | |
source ../../scripts/gtwizard_generator.tcl | |
.. code-block:: tcl | |
source ../../scripts/gtwizard_generator.tcl |
This applies to all the code blocks.
1b0c259
to
5506bb6
Compare
Signed-off-by: Elena-Hadarau_adi <[email protected]>
5506bb6
to
b381722
Compare
PR Description
Added documentation for the Xilinx FPGA Transceivers Wizard to GitHubIO.
PR Type
PR Checklist