Skip to content

Commit c7ba7e0

Browse files
committed
docs/wind: update Versal VxWorks MSI-X setup
Document the GICv3 ITS components needed for e1000e MSI-X and shell/network component updates for the symbol table error. Signed-off-by: shivkd <shiveshkd@gmail.com>
1 parent e85993e commit c7ba7e0

1 file changed

Lines changed: 34 additions & 3 deletions

File tree

docs/wind/vxworks_xlnx-versal-virt.rst

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
=========================================
2-
VxWorks 24.03 on xlnx-versal-virt machine
3-
=========================================
1+
====================================================
2+
VxWorks 24.03 and 26.03 on xlnx-versal-virt machine
3+
====================================================
44

55
This document contains steps to build a basic VxWorks project for the QEMU xlnx-versal-virt machine.
66

@@ -135,3 +135,34 @@ virtio-net-pci NIC
135135
-device virtio-net-pci,disable-legacy=on,netdev=net0,mac=00:00:e8:01:02:04 \
136136
-append "virtioNet(0,0)host:vxWorks h=10.0.2.2 e=10.0.2.15:ffffff00 g=10.0.2.2 u=target pw=vxTarget f=0x1"
137137
138+
MSI-X support with an attached PCIe NIC
139+
```````````````````````````````````````
140+
When testing the xlnx-versal-virt machine with an attached PCIe NIC, such
141+
as QEMU's e1000e device, the VxWorks image must include the Arm GICv3 ITS
142+
driver.
143+
144+
.. code::
145+
$ vxprj component add DRV_INTCTLR_FDT_ARM_GIC_V3_ITS
146+
147+
The DRV_INTCTLR_FDT_ARM_GIC_V3_ITS component also adds the required
148+
DRV_INTCTLR_ARM_GIC_V3_ITS component. This is required for PCIe MSI-X
149+
interrupt support on the xlnx-versal-virt machine.
150+
151+
To avoid the network symbol table error:
152+
153+
.. code::
154+
Error opening /host.host/vxWorks.sym: status = 0x290010
155+
156+
remove the network symbol table component:
157+
158+
.. code::
159+
$ vxprj component remove INCLUDE_NET_SYM_TBL
160+
161+
Then add the following shell components if missing:
162+
163+
.. code::
164+
$ vxprj component add INCLUDE_SHELL_INTERP_C
165+
$ vxprj component add INCLUDE_SHELL_INTERP_CMD
166+
$ vxprj component add INCLUDE_SHELL_VI_MODE
167+
$ vxprj component add INCLUDE_STOP_MODE_AGENT_END
168+

0 commit comments

Comments
 (0)