๐Ÿš€ Role Transition Tracker

AMD Ethernet Design Hub - Knowledge Transfer & Handoff

โ„น๏ธ

About This Documentation

This documentation hub serves as a comprehensive knowledge transfer and handoff resource for the AMD Ethernet Design Hub. It contains essential information, assets, and resources created and curated by AJ Dahal (Sr. Product Application Engineer - WTS-WWG).

๐Ÿ“ฆ

Included Resources

Reference designs, debugging playbooks, Answer Records (ARs), device tree configurations, driver patches, Jenkins automation workflows, and comprehensive testing documentation.

๐ŸŽฏ

Purpose

Ensure seamless continuity of Ethernet-related projects, provide quick access to critical resources, and maintain institutional knowledge for future team members.

๐Ÿ“š Key Resources & Links

Essential tools, repositories, and documentation

FEATURED INTERACTIVE
โš™๏ธ
โš™๏ธ Device Tree Architect
Launch Interactive Tool โ†’
Interactive configuration generator for custom Ethernet device trees with board-aware smart suggestions
FEATURED
๐ŸŒฒ
๐ŸŒฒ Device Tree Directory
Browse Ethernet Interfaces โ†’
Interactive map of all 64 Ethernet device tree configurations across Vivado versions
FEATURED
๐Ÿ“–
๐Ÿ“– Ethernet Debug Playbook
View Debug Playbook โ†’
Quick reference guide for MRMAC/DCMAC & 10G/25G Ethernet Subsystem debugging
FEATURED
๐Ÿ“Š
๐Ÿ“Š Cases Dashboard
View Cases Dashboard โ†’
Visualize and track Ethernet support cases by year, severity, and status
FEATURED
๐Ÿ“„
๐Ÿ“„ Answer Records List
View Complete AR Database โ†’
Comprehensive collection of ARs written by AJ for Ethernet debugging and configuration
FEATURED
๐Ÿ“
๐Ÿ“ Change Requests List
View Complete CR Database โ†’
Detailed database of all change requests filed by AJ for Ethernet improvements
FEATURED
๐Ÿ’ฌ
๐Ÿ’ฌ Community Questions List
View Complete CQ Database โ†’
Collection of community forum questions answered by AJ about Ethernet issues
FEATURED
๐Ÿ’ป
๐Ÿ’ป AJ's Versal Ethernet Repo
GitHub - ajayadaha1/Versal-Ethernet โ†’
Comprehensive Versal Ethernet examples and configurations
FEATURED
โšก
โšก ZCU102 Ethernet Repo
GitHub - ajayadaha1/ZCU102-Ethernet โ†’
Complete ZCU102 Ethernet examples (replaces XAPP1305)
FEATURED
๐Ÿงช
๐Ÿงช Boardfarm Resources
XSJ Boardfarm - WTS-WWG - Ethernet Testing Setup โ†’
Comprehensive testing setup documentation with board configurations and resources
๐Ÿ’ก Note: If having an issue with the listed interface, comment on the linked CR
FEATURED
๐ŸŽ“
๐ŸŽ“ Ethernet Training Plan
View Training Plan (PDF) โ†’
Comprehensive Ethernet domain knowledge training plan for L2 engineers
FEATURED
๐Ÿ”ง
๐Ÿ”ง Jenkins Automation for WTS
View Jenkins Automation Project โ†’
Automated build and testing infrastructure for Vivado, PetaLinux, and Boardfarm integration
๐Ÿ‘ฅ

Point of Contact

Key contacts for Ethernet support and resources

๐Ÿ’ป
๐Ÿ’ป

Driver Team

Nan Zang - WTS
Harini Katakam - SSW
๐Ÿ”ง
๐Ÿ”ง

IP Team

Elizabeth Zadler - WTS
๐Ÿงช
๐Ÿงช

Boardfarm

๐Ÿ’ฌ Comment in the relevant CR
๐Ÿ’ฌ Post in #boardfarm Slack channel
๐ŸŽฏ
๐ŸŽฏ

FAE Resources

FAEs assigned to cases are go-to resources for discussing the cases.

๐Ÿ“…

Key Meetings

Regular Ethernet team meetings and syncs

๐Ÿ“‹
๐Ÿ“‹

Ethernet Case Review

๐Ÿ—“๏ธ Wednesday
๐Ÿ•˜ 9:30 - 10:30 AM CST
๐Ÿ”
๐Ÿ”

Ethernet PRT

๐Ÿ—“๏ธ Thursday
๐Ÿ•˜ 9:00 - 10:00 AM CST
๐Ÿ”„
๐Ÿ”„

SSW/WTS Ethernet Driver Sync-up

๐Ÿ—“๏ธ Biweekly Monday
๐Ÿ•˜ 9:30 - 10:00 AM CST

๐Ÿ”ง Ethernet Reference Designs

Complete collection of Ethernet design examples and implementations

Versal Designs Zynq UltraScale+ Designs

๐Ÿ† Contribution Overview

Customer cases closed and impact delivered (Jan 2023 - Feb 2026)

342
Total Cases Closed
84
Change Requests
33
Answer Records
102
Community Questions

Cases Closed by Year

61
2023
131
2024
136
2025
14
2026

Community Questions by Year

2
2023
45
2024
55
2025

Contributed CRs, ARs & CQs

84
Change Requests
33
Answer Records
102
Community Questions
๐Ÿ“Š View Cases Dashboard โ†’ ๐Ÿ”ง View CR List โ†’ ๐Ÿ“ View AR List โ†’ ๐Ÿ’ฌ View CQ List โ†’
๐ŸŽฏ

Transition Tasks

5 of 5 Done
โœ…
5 of 5 done (100%)
โœ“
DONE
1
โœ“ Add gitclone command to ZCU102 GitHub repo top level README
โœ“
DONE
2
โœ“ Archive Jenkins ZCU102 Update Automation Notes
Archive in AJ's GitHub repo with:
  • โœ“ Extra notes for handoff
  • โœ“ README file for future maintainers
  • โœ“ Jenkins PowerPoint presentation
โœ“
DONE
3
โœ“ Provide ZCU102 Ethernet Interfaces Map with PS-GEM DT Nodes
Complete Ethernet Interface Documentation:
  • โœ“ PS-GEM โ†’ EMIO โ†’ PCS/PMA โ†’ SFP (1000base-x/sgmii)
  • โœ“ PS-GEM โ†’ MIO โ†’ RGMII โ†’ TI PHY (1000base-t)
  • โœ“ PS-GEM โ†’ PS-GTR (1000base-x/sgmii)
  • โœ“ PL Ethernet (1G/10G/25G) configurations
  • โœ“ Full DT nodes across versions (2020.1 โ†’ 2024.2)
  • โœ“ KR260 and other dev board considerations
โœ“
DONE
4
โœ“ MRMAC/DCMAC Debug Playbook
Create 1-2 page cheat sheet including:
  • Driver links
  • DT links
  • Useful ARs
  • Version differences/notes
  • Cases of note (e.g., 3x25 config)
  • Main issue types/details & driver issues
โœ“
DONE
5
โœ“ 10G/25G Ethernet Subsystem Debug Playbook
Create 1-2 page cheat sheet including:
  • Driver links
  • DT links
  • Useful ARs
  • Version differences/notes
  • Cases of note
  • Main issue types/details
  • Driver issues
  • DT issues
  • Clocking notes
  • DMA reset timeout patch