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

CR-1160311 xbflash2 tool doc update #7716

Merged
merged 3 commits into from
Sep 22, 2023

Conversation

vboggara-xilinx
Copy link
Contributor

Problem solved by the commit

CR-1160311 xbflash2 tool doc update

Bug / issue (if any) fixed, which PR introduced the bug, how it was discovered

https://jira.xilinx.com/browse/CR-1160311

How problem was solved, alternative solutions (if any) and why they were rejected

Improve xbflash2 documentation by:

Defining the software requirements. From the xbflash2 XRT doc page xbflash2 — XRT Master documentation (xilinx.github.io), it's not clear whether xbflash2 requires XRT or not. It only says xbflash2 package doesn't include XRT.

doesnt require XRT packages, updated in documentation.

Provide link to download xbflash2, or mention generally where one can get it -> currently in the Alveo Lounge, however this may become public under the respective card pages.

updated in documentation.

Define all supported cards - currently it is strangely worded - "This tool supported for all Alveo platforms, U2 and U30 platforms.".

This tool supported for all Alveo platforms.
updated in documentation.

Be clear on supported platforms and suggested to reference UG1120. Current wording is ambiguous and refers to designs instead of platforms - "This tool is verified and supported only on XDMA PCIe DMA designs."

we don't need platform to flash it. just need vivado designs

It mentions golden image - recommend to provide link to these images

whatever is in the board is golden image.

Define how to obtain the BAR offset

This tool is for advance users, they should know how to get bar-offset, lspci would give them bar-offset.

Provide an example of 'xbflash dump' option

dump would be an .mcs file which is in binary file.
already provided example command for dump in the documentation.

Risks (if any) associated the changes in the commit

Low

What has been tested and how, request additional testing if necessary

Documentation update

Documentation impact (if any)

Yes

@gbuildx
Copy link
Collaborator

gbuildx commented Sep 22, 2023

Build Passed!

@gbuildx
Copy link
Collaborator

gbuildx commented Sep 22, 2023

Build Passed!

@chvamshi-xilinx
Copy link
Collaborator

Please cherry-pick to 2023.2

@chvamshi-xilinx chvamshi-xilinx merged commit 3c356f4 into Xilinx:master Sep 22, 2023
3 checks passed
src/runtime_src/doc/toc/xbflash2.rst Show resolved Hide resolved

This tool doesn't come with XRT package, it comes as separate xbflash package.
This tool doesn't require XRT Package and it doesn't come with XRT package, it comes as separate xbflash package.
Copy link
Member

Choose a reason for hiding this comment

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

It does not. It comes in a xrt-xbflash2 package:

i   xrt-xbflash2                                       - Xilinx RunTime stack for use with Xilinx FPGA platforms     

Note that the package description is rather wrong because it copies the one from XRT.

vboggara-xilinx added a commit to vboggara-xilinx/XRT that referenced this pull request Sep 24, 2023
* CR-1160311 xbflash2 tool doc update

Signed-off-by: vboggara <[email protected]>

* CR-1160311 xbflash2 tool doc update

Signed-off-by: vboggara <[email protected]>

* CR-1160311 xbflash2 tool doc update

Signed-off-by: vboggara <[email protected]>

---------

Signed-off-by: vboggara <[email protected]>
(cherry picked from commit 3c356f4)
chvamshi-xilinx pushed a commit that referenced this pull request Sep 25, 2023
* CR-1160311 xbflash2 tool doc update

Signed-off-by: vboggara <[email protected]>

* CR-1160311 xbflash2 tool doc update

Signed-off-by: vboggara <[email protected]>

* CR-1160311 xbflash2 tool doc update

Signed-off-by: vboggara <[email protected]>

---------

Signed-off-by: vboggara <[email protected]>
(cherry picked from commit 3c356f4)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants