diff --git a/.gitmodules b/.gitmodules
index 2ebc53fbd..baef597b7 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -90,3 +90,15 @@
 	path = sources/meta-rockchip
 	url = git://git.yoctoproject.org/meta-rockchip
 	branch = dunfell
+[submodule "sources/meta-xilinx"]
+	path = sources/meta-xilinx
+	url = https://github.com/Xilinx/meta-xilinx
+	branch = master
+[submodule "sources/meta-xilinx-tools"]
+	path = sources/meta-xilinx-tools
+	url = https://github.com/Xilinx/meta-xilinx-tools
+	branch = master
+[submodule "sources/meta-petalinux"]
+	path = sources/meta-petalinux
+	url = https://github.com/Xilinx/meta-petalinux
+	branch = master
diff --git a/conf/bblayers.conf b/conf/bblayers.conf
index 0d369ec18..4831ba37d 100644
--- a/conf/bblayers.conf
+++ b/conf/bblayers.conf
@@ -52,4 +52,10 @@ BBLAYERS = " \
   ${BASELAYERS} \
   ${TOPDIR}/sources/openembedded-core/meta \
   ${TOPDIR}/sources/meta-rockchip \
+  ${TOPDIR}/sources/meta-xilinx/meta-xilinx-bsp \
+  ${TOPDIR}/sources/meta-xilinx/meta-xilinx-contrib \
+  ${TOPDIR}/sources/meta-xilinx/meta-xilinx-pynq \
+  ${TOPDIR}/sources/meta-xilinx/meta-xilinx-standalone \
+  ${TOPDIR}/sources/meta-xilinx-tools \
+  ${TOPDIR}/sources/meta-petalinux \
   "
diff --git a/conf/site.conf b/conf/site.conf
index f643f4875..0c21644b1 100644
--- a/conf/site.conf
+++ b/conf/site.conf
@@ -82,3 +82,4 @@ IMG_VERSION = "0.0.1"
 #-l ${@int(os.sysconf(os.sysconf_names['SC_NPROCESSORS_ONLN'])) * 150/100} \
 #"
 #
+
diff --git a/docs/xilinx-zcu102.md b/docs/xilinx-zcu102.md
new file mode 100644
index 000000000..76d04c7db
--- /dev/null
+++ b/docs/xilinx-zcu102.md
@@ -0,0 +1,30 @@
+# Notes on using Yoe on the Xilinx ZCU102
+
+[up](README.md)
+
+[BSP Layer documentation](meta-xilinx/meta-xilinx-bsp/README.building.md)
+
+## Building/installing an image
+
+1. `git clone git://github.com/YoeDistro/yoe-distro.git`
+1. `cd yoe-distro`
+1. `. zcu102-zynqmp-envsetup.sh`
+1. `yoe_setup`
+1. add following to conf/local.conf
+```console
+IMAGE_BOOT_FILES_append = " boot.bin"
+PREFERRED_PROVIDER_virtual/pmu-firmware = "pmu-firmware"
+PREFERRED_PROVIDER_virtual/boot-bin = "xilinx-bootbin"
+PREFERRED_PROVIDER_virtual/dtb = "device-tree"
+PREFERRED_PROVIDER_qemu-native = "qemu-xilinx-native"
+PREFERRED_PROVIDER_qemu-helper-native = "qemu-helper-native"
+IMAGE_INSTALL_remove = " qemu"
+```
+1. `bitbake petalinux-image-minimal`
+1. insert SD card
+1. `lsblk` (note sd card device, and substitute for /dev/sdX below)
+1. `yoe_install_image /dev/sdX petalinux-image-minimal`
+1. optional: configure console for serial port (see below)
+1. `sudo eject /dev/sdX`
+
+*core-image-minimal also works, but yoe-simple-image builds but would not boot up and gets stuck in kernel *
diff --git a/sources/meta-petalinux b/sources/meta-petalinux
new file mode 160000
index 000000000..6daf05f4c
--- /dev/null
+++ b/sources/meta-petalinux
@@ -0,0 +1 @@
+Subproject commit 6daf05f4c27d5fe000038417fb38f1428a9bf7b5
diff --git a/sources/meta-xilinx b/sources/meta-xilinx
new file mode 160000
index 000000000..084f9d4ff
--- /dev/null
+++ b/sources/meta-xilinx
@@ -0,0 +1 @@
+Subproject commit 084f9d4ff241d5f2c617d1d5390a39f40c419737
diff --git a/sources/meta-xilinx-tools b/sources/meta-xilinx-tools
new file mode 160000
index 000000000..0e1e3b9d3
--- /dev/null
+++ b/sources/meta-xilinx-tools
@@ -0,0 +1 @@
+Subproject commit 0e1e3b9d3533b6faaa0e3c5210e8b89c018a2ed9
diff --git a/zcu102-zynqmp-envsetup.sh b/zcu102-zynqmp-envsetup.sh
new file mode 120000
index 000000000..18fd360cc
--- /dev/null
+++ b/zcu102-zynqmp-envsetup.sh
@@ -0,0 +1 @@
+envsetup.sh
\ No newline at end of file