V3D — The Mesa 3D Graphics Library latest documentation

# V3D

Mesa’s V3D graphics driver stack includes a conformant GLES3.1 driver called V3D and a Vulkan graphics driver called V3DV, notably used on the Raspberry Pi 4 and Raspberry Pi 5.

The V3D Mesa drivers communicate directly with the V3D kernel DRM driver for scheduling GPU commands. Additionally, on the Raspberry Pi 4 and 5, the kernel uses the VC4 DRM driver for display support, so Mesa exposes a `vc4_dri.so` using the kmsro helpers to do behind-the-scenes buffer management between the two kernel drivers, while executing rendering on the V3D kernel module.

Initial development work was done on the Broadcom 7268 (V3D 3.3) and 7278 (V3D 4.1). Development since then has been on V3D 4.2 (Raspberry Pi 4), and V3D 7.1 (Raspberry Pi 5). When the support for V3D 7.1 landed, the support for 3.3 and 4.1 was dropped as it was not tested anymore (see MR#25851) Broadcom’s reference software platforms do not make use of the open source V3D stack, but porting a particular hardware implementation to use it would still be possible.

## Hardware Documentation

Broadcom never released a public specification for the V3D 3.x or 4.x series.

For driver developers, Broadcom publicly released a specification PDF for the 21553, which is closely related to the VC4 GPU present in the Raspberry Pi. They also released a snapshot of a corresponding Android graphics driver. That graphics driver was ported to Raspbian for a demo, but was not expected to have ongoing development.

Developers with NDA access with Broadcom or Raspberry Pi can get access to the V3D architecture specification for documentation of the GPU’s programming model. There is also a C++ software simulator called simpenrose, and the Mesa driver includes a backend (`src/broadcom/drm-shim/`) to use simpenrose from an x86 system with the i915 graphics driver with all of the VC4 rendering commands emulated on simpenrose and memcpyed to the real GPU. Note that simpenrose’s API drifts over time, so you need to be synced up with whatever version Mesa was last being developed against.