Skip to content

VITIS-15146: Add GMIO-to-DDR connectivity support#9640

Merged
stsoe merged 13 commits intoXilinx:masterfrom
bisingha-xilinx:gmio-conn
Mar 16, 2026
Merged

VITIS-15146: Add GMIO-to-DDR connectivity support#9640
stsoe merged 13 commits intoXilinx:masterfrom
bisingha-xilinx:gmio-conn

Conversation

@bisingha-xilinx
Copy link
Collaborator

@bisingha-xilinx bisingha-xilinx commented Mar 3, 2026

Problem solved by the commit

It's a new feature. Adds APIs to resolve GMIO port names to memory bank indices so host code can allocate buffers in the correct DDR banks for AIE GMIOs. So it removes the hardcoding from all the host applications.

NOTE: This pr assumes all the xclbins will have IP_LAYOUT section irrespective of the type (non-aie, overlay aie, aie only, etc.)

API signature and Usage:
auto ghdl=xrt::graph(hwctx_1,"graphName");
uint32_t bank_in_id = ghdl.gmio_bank_id("logicalGMIOName");
auto din_buffer = xrt::aie::bo (hwctx_1, BLOCK_SIZE_in_Bytes,xrt::bo::flags::normal, bank_in_id);

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

It's not a bug but a new feature.

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

It was solved by mapping the GMIO ports to its memory banks and assigning a mem index for buffer allocation. This happens just after loading the xclbin. And host can get the assigned bank id for a particular GMIO.

Risks (if any) associated the changes in the commit

n/a

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

Tested by having multiple usecases:

  1. non overlay AIE only: Test passes
  2. overlay AIE only: by manually adding the CONNECTIVITY and EMBEDDED_METADATA section. Update: new TA ships CONNECTIVITY and EMBEDDED_METADATA section for aie only xclbins.
  3. PL+AIE (single xclbin): all the required sections are already part of the generated xclbin
  4. Tested couple of existing testcases on across platforms.

Documentation impact (if any)

Yes. The new API to get the memory bank id for a respective GMIO has to be logged.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 3, 2026

clang-tidy review says "All clean, LGTM! 👍"

1 similar comment
@github-actions
Copy link
Contributor

github-actions bot commented Mar 3, 2026

clang-tidy review says "All clean, LGTM! 👍"

@github-actions
Copy link
Contributor

clang-tidy review says "All clean, LGTM! 👍"

@bisingha-xilinx bisingha-xilinx added the do not merge hold off on merging label Mar 12, 2026
@github-actions
Copy link
Contributor

clang-tidy review says "All clean, LGTM! 👍"

@bisingha-xilinx bisingha-xilinx removed the do not merge hold off on merging label Mar 12, 2026
@github-actions
Copy link
Contributor

clang-tidy review says "All clean, LGTM! 👍"

Copy link
Collaborator

@chvamshi-xilinx chvamshi-xilinx left a comment

Choose a reason for hiding this comment

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

Idea looks good overall, but there are some minor issues with current implementation.
Please review and fix.

Bikash Singha added 12 commits March 16, 2026 10:43
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
…e in all xclbins

Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
…connectivity

Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
@github-actions
Copy link
Contributor

clang-tidy review says "All clean, LGTM! 👍"

Signed-off-by: Bikash Singha <bisingha@xcobisingha50x.amd.com>
@github-actions
Copy link
Contributor

clang-tidy review says "All clean, LGTM! 👍"

Copy link
Collaborator

@chvamshi-xilinx chvamshi-xilinx left a comment

Choose a reason for hiding this comment

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

Looks good.

Copy link
Collaborator

@stsoe stsoe left a comment

Choose a reason for hiding this comment

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

Looks good, thanks for keeping xrt::xclbin implementation code simple.

@stsoe stsoe merged commit 53b796a into Xilinx:master Mar 16, 2026
21 checks passed
stsoe added a commit to stsoe/XRT that referenced this pull request Mar 17, 2026
Revert Xilinx#9640 exception in kernel construction.
Message blocks xclbins used by model-tests.

Signed-off-by: Soren Soe <2106410+stsoe@users.noreply.github.com>
chvamshi-xilinx pushed a commit that referenced this pull request Mar 18, 2026
Revert #9640 exception in kernel construction.
Message blocks xclbins used by model-tests.

Signed-off-by: Soren Soe <2106410+stsoe@users.noreply.github.com>
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.

3 participants