Skip to content
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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

hadarauelena
Copy link
Collaborator

PR Description

Added documentation for the Xilinx FPGA Transceivers Wizard to GitHubIO.

PR Type

  • Bug fix (change that fixes an issue)
  • New feature (change that adds new functionality)
  • Breaking change (has dependencies in other repos or will cause CI to fail)
  • Documentation

PR Checklist

  • I have followed the code style guidelines
  • I have performed a self-review of changes
  • I have compiled all hdl projects and libraries affected by this PR
  • I have tested in hardware affected projects, at least on relevant boards
  • I have commented my code, at least hard-to-understand parts
  • I have signed off all commits from this PR
  • I have updated the documentation (wiki pages, ReadMe files, Copyright etc)
  • I have not introduced new Warnings/Critical Warnings on compilation
  • I have added new hdl testbenches or updated existing ones


.. warning::

Please note that if you used the GUI method to instantiate the wizard, the paring script will not work
Copy link
Contributor

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.

Copy link
Contributor

@IuliaCMoldovan IuliaCMoldovan left a 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.

Comment on lines 115 to 120
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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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

Comment on lines 120 to 126
::

[~] 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
Copy link
Contributor

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.

Suggested change
::
[~] 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>`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Ultrascale and Ultrascale+ FPGAs Transceiver Wizard
UltraScale FPGAs Transceiver Wizard

For simplicity, leave it like this

Comment on lines 159 to 171
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
Copy link
Contributor

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.

Comment on lines 194 to 205
::

source ../../scripts/gtwizard_generator.tcl
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
::
source ../../scripts/gtwizard_generator.tcl
.. code-block:: tcl
source ../../scripts/gtwizard_generator.tcl

This applies to all the code blocks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants