linux/Documentation/gpu
Dave Airlie 8205c61deb DRM Rust changes for v7.2-rc1
- Driver Core (shared via signed tag dd-lifetimes-7.2-rc1):
 
   - Introduce Higher-Ranked Lifetime Types (HRT) for Rust device
     drivers, allowing driver structs to hold device resources like
     pci::Bar and IoMem directly with a lifetime tied to the binding
     scope, removing the need for Devres indirection and ARef<Device>.
 
   - Replace drvdata() with scoped registration data on the auxiliary
     bus, using the new ForLt trait to thread lifetimes through
     registrations. Remove drvdata() and driver_type.
 
 - DRM:
 
   - Add GPUVM immediate mode abstraction for Rust GPU drivers:
     - In immediate mode, GPU virtual address space state is updated
       during job execution (in the DMA fence signalling critical path),
       keeping the GPUVM and the GPU's address space always in sync.
 
     - Provide GpuVm, GpuVa, and GpuVmBo types for managing address
       spaces, virtual mappings, and GEM object backing respectively.
 
     - Provide split-merge map/unmap operations that handle partial
       overlaps with existing mappings.
 
     - drm_exec integration for dma_resv locking and GEM object
       validation based on the external/evicted object lists are not
       yet covered and planned as follow-up work.
 
   - Introduce DeviceContext type state for drm::Device, allowing
     drivers to restrict operations to contexts where the device is
     guaranteed to be registered (or not yet registered) with userspace.
 
   - Add FEAT_RENDER flag to the Driver trait for render node support.
 
 - Nova:
 
   - Hopper/Blackwell enablement:
     - Add GPU identification and architecture-based HAL selection for
       Hopper (GH100) and Blackwell (GB100, GB202).
 
     - Implement the FSP (Foundation Security Processor) boot path used by
       Hopper and Blackwell, including FSP falcon engine support, EMEM
       operations, MCTP/NVDM message infrastructure, and FSP Chain of
       Trust boot with GSP lockdown release.
 
     - Add support for 32-bit firmware images and auto-detection of
       firmware image format.
 
     - Add architecture-specific framebuffer, sysmem flush, PCI config
       mirror, DMA mask, and WPR/non-WPR heap sizing.
 
   - GSP boot and unload:
     - Refactor the GSP boot process into a chipset-specific HAL,
       keeping the SEC2 and FSP boot paths separated cleanly.
 
     - Implement proper driver unload: send UNLOADING_GUEST_DRIVER
       command, run Booter Unloader and FWSEC-SB upon unbinding, and run
       the unload bundle on Gsp::boot() failure. This removes the need
       for a manual GPU reset between driver unbind and re-probe.
 
   - GA100 support:
     - Add support for the GA100 GPU, including IFR header detection and
       skipping, correct fwsignature selection, conditional FRTS boot,
       and documentation of the IFR header layout.
 
   - VBIOS hardening and refactoring:
     - Harden VBIOS parsing with checked arithmetic, bounds-checked
       accesses, and FromBytes-based structure reads throughout the FWSEC
       and Falcon data paths. Simplify the overall VBIOS module
       structure.
 
   - HRT adoption:
     - Use lifetime-parameterized pci::Bar directly, replacing the
       Arc<Devres<Bar0>> indirection. Replace ARef<Device> with &'bound
       Device in SysmemFlush and the GSP sequencer. Separate the driver
       type from driver data.
 
   - Misc:
     - Rename module names to kebab-case (nova-drm, nova-core).
 
     - Require little-endian in Kconfig, making the existing assumption
       explicit.
 
 - Tyr:
 
   - Define comprehensive typed register blocks for GPU_CONTROL,
     JOB_CONTROL, MMU_CONTROL (including per-address-space registers),
     and DOORBELL_BLOCK using the kernel register!() macro. This replaces
     manual bit manipulation with typed register and field accessors.
 
   - Add shmem-backed GEM objects and set DMA mask based on GPU physical
     address width.
 
   - Adopt HRT: separate driver type from driver data, and use IoMem
     directly instead of Devres for register access during probe.
 
   - Move clock cleanup into a Drop implementation.
 -----BEGIN PGP SIGNATURE-----
 
 iHUEABYKAB0WIQS2q/xV6QjXAdC7k+1FlHeO1qrKLgUCaiHGcwAKCRBFlHeO1qrK
 LucmAQCnRhpHwT9Miq3y29lyJjm0OcxikeBmeVczx3o+pUWI6wD+IHQMk26MEpqa
 T/XmMDbY+cFjRpeVu7qRAKa28649FgM=
 =eLXf
 -----END PGP SIGNATURE-----

Merge tag 'drm-rust-next-2026-06-04' of https://gitlab.freedesktop.org/drm/rust/kernel into drm-next

DRM Rust changes for v7.2-rc1

- Driver Core (shared via signed tag dd-lifetimes-7.2-rc1):

  - Introduce Higher-Ranked Lifetime Types (HRT) for Rust device
    drivers, allowing driver structs to hold device resources like
    pci::Bar and IoMem directly with a lifetime tied to the binding
    scope, removing the need for Devres indirection and ARef<Device>.

  - Replace drvdata() with scoped registration data on the auxiliary
    bus, using the new ForLt trait to thread lifetimes through
    registrations. Remove drvdata() and driver_type.

- DRM:

  - Add GPUVM immediate mode abstraction for Rust GPU drivers:
    - In immediate mode, GPU virtual address space state is updated
      during job execution (in the DMA fence signalling critical path),
      keeping the GPUVM and the GPU's address space always in sync.

    - Provide GpuVm, GpuVa, and GpuVmBo types for managing address
      spaces, virtual mappings, and GEM object backing respectively.

    - Provide split-merge map/unmap operations that handle partial
      overlaps with existing mappings.

    - drm_exec integration for dma_resv locking and GEM object
      validation based on the external/evicted object lists are not
      yet covered and planned as follow-up work.

  - Introduce DeviceContext type state for drm::Device, allowing
    drivers to restrict operations to contexts where the device is
    guaranteed to be registered (or not yet registered) with userspace.

  - Add FEAT_RENDER flag to the Driver trait for render node support.

- Nova:

  - Hopper/Blackwell enablement:
    - Add GPU identification and architecture-based HAL selection for
      Hopper (GH100) and Blackwell (GB100, GB202).

    - Implement the FSP (Foundation Security Processor) boot path used by
      Hopper and Blackwell, including FSP falcon engine support, EMEM
      operations, MCTP/NVDM message infrastructure, and FSP Chain of
      Trust boot with GSP lockdown release.

    - Add support for 32-bit firmware images and auto-detection of
      firmware image format.

    - Add architecture-specific framebuffer, sysmem flush, PCI config
      mirror, DMA mask, and WPR/non-WPR heap sizing.

  - GSP boot and unload:
    - Refactor the GSP boot process into a chipset-specific HAL,
      keeping the SEC2 and FSP boot paths separated cleanly.

    - Implement proper driver unload: send UNLOADING_GUEST_DRIVER
      command, run Booter Unloader and FWSEC-SB upon unbinding, and run
      the unload bundle on Gsp::boot() failure. This removes the need
      for a manual GPU reset between driver unbind and re-probe.

  - GA100 support:
    - Add support for the GA100 GPU, including IFR header detection and
      skipping, correct fwsignature selection, conditional FRTS boot,
      and documentation of the IFR header layout.

  - VBIOS hardening and refactoring:
    - Harden VBIOS parsing with checked arithmetic, bounds-checked
      accesses, and FromBytes-based structure reads throughout the FWSEC
      and Falcon data paths. Simplify the overall VBIOS module
      structure.

  - HRT adoption:
    - Use lifetime-parameterized pci::Bar directly, replacing the
      Arc<Devres<Bar0>> indirection. Replace ARef<Device> with &'bound
      Device in SysmemFlush and the GSP sequencer. Separate the driver
      type from driver data.

  - Misc:
    - Rename module names to kebab-case (nova-drm, nova-core).

    - Require little-endian in Kconfig, making the existing assumption
      explicit.

- Tyr:

  - Define comprehensive typed register blocks for GPU_CONTROL,
    JOB_CONTROL, MMU_CONTROL (including per-address-space registers),
    and DOORBELL_BLOCK using the kernel register!() macro. This replaces
    manual bit manipulation with typed register and field accessors.

  - Add shmem-backed GEM objects and set DMA mask based on GPU physical
    address width.

  - Adopt HRT: separate driver type from driver data, and use IoMem
    directly instead of Devres for register access during probe.

  - Move clock cleanup into a Drop implementation.

Signed-off-by: Dave Airlie <airlied@redhat.com>

From: "Danilo Krummrich" <dakr@kernel.org>
Link: https://patch.msgid.link/DJ0IF39U9ETK.PCCUO7ZEQ4S0@kernel.org
2026-06-05 09:13:12 +10:00
..
amdgpu Documentation/amdgpu: Add documentation for Peak Tops Limiter (PTL) sysfs interface 2026-05-11 15:55:55 -04:00
bridge drm: bridge: dw-hdmi: Add Documentation on supported input formats 2017-04-04 17:48:21 +02:00
dp-mst drm/dp_mst: Introduce new refcounting scheme for mstbs and ports 2019-01-10 20:12:19 -05:00
imagination drm/imagination: Numerous documentation fixes. 2023-11-28 18:56:03 +01:00
intel-display Documentation/gpu: add remaining DOC: comments to Intel display documentation 2026-05-11 10:30:13 +03:00
nova gpu: nova-core: vbios: move constants and functions to be associated 2026-05-25 20:18:08 +02:00
rfc Documentation/gpu/rfc: fix toctree 2026-05-13 11:07:12 +03:00
xe Driver Changes: 2026-06-03 08:59:08 +10:00
afbc.rst drm/afbc: Add AFBC modifier usage documentation 2019-01-11 17:52:06 +00:00
automated_testing.rst drm/ci: enable lockdep detection 2025-03-12 08:16:31 +05:30
backlight.rst doc-rst: Wire-up Backlight kernel-doc documentation 2020-07-20 10:26:22 +01:00
driver-uapi.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drivers.rst Documentation/gpu: add dedicated documentation for Intel display 2026-05-11 10:30:13 +03:00
drm-client.rst drm/client: Move client event handlers to drm_client_event.c 2024-10-18 09:23:03 +02:00
drm-compute.rst kernel/cgroup: Add "dmem" memory accounting cgroup 2025-01-06 17:24:38 +01:00
drm-internals.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-kms-helpers.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-kms.rst - A Revert of a Kconfig patch that broke some builds (Jani) 2026-05-15 15:37:16 +10:00
drm-mm.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-ras.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-uapi.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-usage-stats.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-vm-bind-async.rst Documentation/gpu: Add a VM_BIND async document 2023-10-17 10:38:07 +02:00
drm-vm-bind-locking.rst Documentation/gpu: VM_BIND locking document 2023-11-29 20:54:43 +01:00
i915.rst Documentation/gpu: add dedicated documentation for Intel display 2026-05-11 10:30:13 +03:00
implementation_guidelines.rst Documentation/gpu: VM_BIND locking document 2023-11-29 20:54:43 +01:00
index.rst Documentation/gpu: limit main toctree depth to 2 2026-05-13 11:07:12 +03:00
introduction.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
kms-properties.csv drm/connector: hdmi: Add Broadcast RGB property 2024-05-28 10:24:37 +02:00
komeda-kms.rst drm: Rename struct drm_atomic_state to drm_atomic_commit 2026-05-04 14:05:04 +10:00
mcde.rst drm/mcde: Fix reference to DOC comment 2019-10-05 20:35:14 +02:00
meson.rst Documentation/gpu/meson: Remove link to meson_canvas.c 2019-04-05 08:35:05 -04:00
msm-crash-dump.rst Documentation: Fix typos 2023-08-18 11:29:03 -06:00
msm-preemption.rst Documentation: document adreno preemption 2024-10-04 08:47:29 -07:00
nouveau.rst Documentation: nouveau: Update GSP message queue kernel-doc reference 2025-06-13 16:46:35 +02:00
panfrost.rst drm/panfrost: Replace fdinfo's profiling debugfs knob with sysfs 2024-03-11 13:27:10 +01:00
panthor.rst Documentation/gpu: Add fdinfo meanings of panthor-*-memory tags 2025-02-07 15:23:39 +01:00
pl111.rst drm: pl111: Update documentation 2020-07-23 10:06:22 +02:00
tegra.rst drm/tegra: Add driver documentation 2017-06-15 13:58:56 +02:00
todo.rst Documentation: drm: Remove drm_atomic_state rename entry 2026-05-04 14:05:04 +10:00
tve200.rst drm/tve200: fix kernel-doc documentation comment include 2018-02-21 09:26:38 +02:00
v3d.rst drm/v3d: Add missing v3d documentation structure. 2018-07-05 11:42:50 -07:00
vc4.rst drm/vc4: Improve the KUnit documentation 2022-12-15 08:54:08 +01:00
vga-switcheroo.rst
vgaarbiter.rst Documentation: vgaarbiter: Fix grammar 2025-03-19 15:11:49 +01:00
vkms.rst drm/vkms: Update testing with IGT IGT_DEVICE 2025-11-04 11:51:15 +01:00
xen-front.rst drm/xen-front: Remove CMA support 2018-04-18 10:18:27 +03:00
zynqmp.rst drm: xlnx: zynqmp_dpsub: Fix kernel doc 2025-01-16 12:45:16 +01:00