feat: add Xilinx DMA driver extension

nikolaishields · smira · commit 0989a0fecaf7 · 2025-04-01T12:42:18.000+04:00
See siderolabs/pkgs#1194 Signed-off-by: Andrey Smirnov <andrey.smirnov@siderolabs.com> Signed-off-by: Nikolai Shields <nshields@dwavesys.com>
diff --git a/.kres.yaml b/.kres.yaml
@@ -57,6 +57,7 @@ spec:
     - vc4
     - vmtoolsd-guest-agent
     - wasmedge
+    - xdma-driver
     - xen-guest-agent
     - zerotier
     - zfs
@@ -76,7 +77,7 @@ spec:
       - name: EXTENSIONS_IMAGE_REF
         defaultValue: $(REGISTRY_AND_USERNAME)/extensions:$(TAG)
       - name: PKGS
-        defaultValue: v1.10.0-alpha.0-71-ge9a260a
+        defaultValue: v1.10.0-alpha.0-72-g7d7323b
       - name: PKGS_PREFIX
         defaultValue: ghcr.io/siderolabs
       - name: TOOLS
diff --git a/MAINTAINERS.md b/MAINTAINERS.md
@@ -6,10 +6,11 @@ If you are interested in becoming a maintainer, please reach out to the current
 
 If the field is marked as `Needs Maintainer`, it means that the package is currently unmaintained. If you are interested in maintaining the package, please reach out to the current maintainers/create a GitHub issue.
 
-# Maintainers
+## Maintainers
 
 | Name                                      | Maintainer         | Github ID                                                            |
 | ----------------------------------------- | ------------------ | -------------------------------------------------------------------- |
+| amazon-ena                                | Sidero Labs        | NA                                                                   |
 | amdgpu                                    | Sidero Labs        | NA                                                                   |
 | amd-ucode                                 | Sidero Labs        | NA                                                                   |
 | binfmt-misc                               | Serge Logvinov     | [sergelogvinov](https://github.com/sergelogvinov)                    |
@@ -63,6 +64,7 @@ If the field is marked as `Needs Maintainer`, it means that the package is curre
 | vc4                                       | Jorn Vanthienen    | [Jorn Vanthienen](https://github.com/jvanthienen-gluo)               |
 | vmtoolsd-guest-agent                      | Robin Elfrink      | [robinelfrink](https://github.com/robinelfrink)                      |
 | wasmedge                                  | Sidero Labs        | NA                                                                   |
+| xdma-driver                               | Nikolai Shields    | [nikolaishields](https://github.com/nikolaishields)                  |
 | xen-guest-agent                           | Jerwin NJ          | [j3rwin](https://github.com/j3rwin)                                  |
 | zerotier                                  | rob-htl            | [rob-htl](https://github.com/rob-htl)                                |
 | zfs                                       | Aenix, Enix        | [kvaps](https://github.com/kvaps), [donch](https://github.com/donch) |
diff --git a/Makefile b/Makefile
@@ -1,6 +1,6 @@
 # THIS FILE WAS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT.
 #
-# Generated on 2025-03-31T09:46:13Z by kres d903dae.
+# Generated on 2025-04-01T08:20:01Z by kres d903dae.
 
 # common variables
 
@@ -50,7 +50,7 @@ COMMON_ARGS += --build-arg=TOOLS_PREFIX="$(TOOLS_PREFIX)"
 # extra variables
 
 EXTENSIONS_IMAGE_REF ?= $(REGISTRY_AND_USERNAME)/extensions:$(TAG)
-PKGS ?= v1.10.0-alpha.0-71-ge9a260a
+PKGS ?= v1.10.0-alpha.0-72-g7d7323b
 PKGS_PREFIX ?= ghcr.io/siderolabs
 TOOLS ?= v1.10.0-alpha.0-23-g6d456ca
 TOOLS_PREFIX ?= ghcr.io/siderolabs
@@ -112,6 +112,7 @@ TARGETS += v4l-uvc-drivers
 TARGETS += vc4
 TARGETS += vmtoolsd-guest-agent
 TARGETS += wasmedge
+TARGETS += xdma-driver
 TARGETS += xen-guest-agent
 TARGETS += zerotier
 TARGETS += zfs
diff --git a/README.md b/README.md
@@ -84,6 +84,7 @@ cosign verify --certificate-identity-regexp '@siderolabs\.com$' --certificate-oi
 | [uinput](drivers/uinput/)            | [ghcr.io/siderolabs/uinput](https://github.com/siderolabs/extensions/pkgs/container/uinput)                                                 | uinput drivers                       | `talos version`                                       |
 | [usb-modem](drivers/usb-modem/)      | [ghcr.io/siderolabs/usb-modem-drivers](https://github.com/siderolabs/extensions/pkgs/container/usb-modem-drivers)                           | USB Modem drivers                    | `talos version`                                       |
 | [v4l-uvc](drivers/v4l-uvc/)          | [ghcr.io/siderolabs/v4l-uvc-drivers](https://github.com/siderolabs/extensions/pkgs/container/v4l-uvc-drivers)                               | USB Video Class (Webcam) drivers     | `talos version`                                       |
+| [xdma-driver](drivers/xdma-driver/)  | [ghcr.io/siderolabs/xdma-driver](https://github.com/siderolabs/extensions/pkgs/container/xdma-driver)                                       | Xilinx PCIe DMA                      | `upstream-talos version`                                       |
 
 ### Digital Video Broadcasting (DVB)
 
diff --git a/drivers/xdma-driver/README.md b/drivers/xdma-driver/README.md
@@ -0,0 +1,35 @@
+# xdma-driver extension
+
+This extension provides [Xilinx PCIe DMA](https://github.com/Xilinx/dma_ip_drivers/tree/master/XDMA/linux-kernel) drivers for Talos Linux.
+
+## Installation
+
+See [Installing Extensions](https://github.com/siderolabs/extensions#installing-extensions).
+
+## Usage
+
+```yaml
+machine:
+  kernel:
+    modules:
+      - name: xdma
+```
+
+## Verifying
+
+You can verify the modules are enabled by reading the `/proc/modules` where it _should_ show the module is live.
+
+For example:
+
+```bash
+❯ talosctl read /proc/modules
+```
+
+In addition, if you actually have XDMA module installed, you should be able to verify with the presence of character devices that begin with `/dev/xdma*`.
+
+For example:
+
+```bash
+❯ talosctl ls -l /dev/xdma*
+NODE           MODE          UID   GID   SIZE(B)   LASTMOD           NAME
+```
diff --git a/drivers/xdma-driver/manifest.yaml b/drivers/xdma-driver/manifest.yaml
@@ -0,0 +1,10 @@
+version: v1alpha1
+metadata:
+  name: xdma-driver
+  version: "$VERSION"
+  author: Nikolai Shields
+  description: |
+    Xilinx DMA Driver
+  compatibility:
+    talos:
+      version: ">= v1.2.0"
diff --git a/drivers/xdma-driver/pkg.yaml b/drivers/xdma-driver/pkg.yaml
@@ -0,0 +1,24 @@
+name: xdma-driver
+variant: scratch
+shell: /bin/bash
+dependencies:
+  - stage: base
+  # The pkgs version for a particular release of Talos as defined in
+  # https://github.com/siderolabs/talos/blob/<talos version>/pkg/machinery/gendata/data/pkgs
+  - image: "{{ .BUILD_ARG_PKGS_PREFIX }}/xdma-driver-pkg:{{ .BUILD_ARG_PKGS }}"
+steps:
+  - prepare:
+      - |
+        sed -i 's#$VERSION#{{ .VERSION }}#' /pkg/manifest.yaml
+  - install:
+      - |
+        mkdir -p /rootfs/usr/lib/modules
+
+        cp -R /usr/lib/modules/* /rootfs/usr/lib/modules
+  - test:
+      - |
+finalize:
+  - from: /rootfs
+    to: /rootfs
+  - from: /pkg/manifest.yaml
+    to: /
diff --git a/drivers/xdma-driver/vars.yaml b/drivers/xdma-driver/vars.yaml
@@ -0,0 +1,2 @@
+# update when pkgs version is updated
+VERSION: "aefa9a1-{{ .BUILD_ARG_TAG }}"
diff --git a/hack/release.toml b/hack/release.toml
@@ -67,6 +67,12 @@ The Amazon Elastic Network Adapter (ENA) driver is now supported as a system ext
         title = "vc4"
         description = """\
 The Broadcom VideoCore GPU kernel modules (vc4) are now supported as a system extension.
+"""
+
+    [notes.xdma]
+        title = "Xilinx PCIe DMA"
+        description = """\
+The Xilinx PCIe DMA kernel module (xdma-driver) is now supported as a system extension.
 """
 
 [make_deps]

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+# update when pkgs version is updated`
	`2`	`+VERSION: "aefa9a1-{{ .BUILD_ARG_TAG }}"`