summaryrefslogtreecommitdiffstats
path: root/user/bsps
diff options
context:
space:
mode:
authorKinsey Moore <kinsey.moore@oarcorp.com>2022-07-19 14:41:46 -0500
committerJoel Sherrill <joel@rtems.org>2022-07-21 12:28:23 -0500
commit3348f192bde2e94bc206dff1baf1a104d2709e47 (patch)
treeead0b2a5714669859893b96d92eabfe19deb6d69 /user/bsps
parenteng/coding-conventions.rst: Fix duplicate periods (diff)
downloadrtems-docs-3348f192bde2e94bc206dff1baf1a104d2709e47.tar.bz2
zynqmp: Add commentary about lwIP usage
Diffstat (limited to 'user/bsps')
-rw-r--r--user/bsps/aarch64/xilinx-zynqmp.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/user/bsps/aarch64/xilinx-zynqmp.rst b/user/bsps/aarch64/xilinx-zynqmp.rst
index 78bff12..239ebe4 100644
--- a/user/bsps/aarch64/xilinx-zynqmp.rst
+++ b/user/bsps/aarch64/xilinx-zynqmp.rst
@@ -244,6 +244,18 @@ Cadence GEM instances present on all ZynqMP hardware variants. All interfaces
are enabled by default, but only interfaces with operational MII busses will be
recognized and usable in RTEMS. Most ZynqMP dev boards use CGEM3.
+When used with lwIP from the rtems-lwip integration repository, these BSP
+variants support networking via CGEM0 and one of the other CGEM* instances
+simultaneously. This is a limitation of the Xilinx driver, specifically
+in code referring directly to XPAR_XEMACPS_0_BASEADDR. Attempting to use more
+than two interfaces simultaneously may cause unexpected behavior. Attempting to
+use a set of two interfaces that does not include CGEM0 may cause unexpected
+behavior.
+
+The interfaces will not come up by default under lwIP and must be configured
+manually. There are examples of this in the start_networking() implementation
+in netstart.c as used by the network tests.
+
Running Executables on QEMU
---------------------------