Skip to content
VK driver for the Raspberry Pi (Broadcom Videocore IV)
C C++ Python Other
Branch: master
Clone or download
Latest commit cb2490c Oct 1, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
QPUassembler loader work pt2 Sep 30, 2019
brcm loader work pt2 Sep 30, 2019
driver validation layers tested and working! Oct 1, 2019
external trying to make the loader stuff work Sep 29, 2019
test validation layers tested and working! Oct 1, 2019
.gitignore added qpu assembler/disassembler Apr 14, 2019
LICENSE Create LICENSE Nov 17, 2018 Update Oct 1, 2019 loader work pt2 Sep 30, 2019
rpi-vk-driver.json trying to make the loader stuff work Sep 29, 2019


(not conformant yet, can't use official name or logo)


  • clear screen example working
  • triangle example working
    • shader from assembly, vertices from vertex buffer object, no uniforms, color hardcoded
    • uniforms for matrix multiplication and animation
    • texture coordinates and texture sampling
    • varyings
    • Multiple vertex attributes
    • Depth buffers
    • Stencil buffers
    • Indexed draw calls
    • blending
  • Shader compiler chain
    • QPU assembler / disassembler
  • Resources
    • Descriptor support
    • VkSampler support
    • Push constant support
  • Platform features
    • Layer support
  • Render to texture features
    • VkRenderPass support
    • Subpass support
    • Multiple attachments
    • MSAA support
  • Synchronization
    • vkCmdPipelineBarrier support
  • Performance
    • Performance counters
    • Queries
    • Shader performance info
  • Emulated features
    • Clear command support
    • Copy command support
  • Shader patching
    • Stencil state
    • Depth writes
    • Blending mode
    • Vertex attrib format
  • WSI
    • Direct to display support
  • Secondary command buffers
  • Try to pass as much of the VK CTS as possible with existing feature set

VK CTS progress

  • Passed: 7894/67979 (11.6%)
  • Failed: 878/67979 (1.3%)
  • Not supported: 59206/67979 (87.1%)
  • Warnings: 1/67979 (0.0%)

Conformance run is considered passing if all tests finish with allowed result codes. Following status codes are allowed:

  • Pass
  • NotSupported
  • QualityWarning
  • CompatibilityWarning

There are about 470.000 conformance tests.


Will this ever be a fully functional VK driver?

As far as I know the PI is NOT fully VK capable on the hardware level. I can already see that some things will need to be emulated and others won't ever be emulated.

What performance should you expect?

Performance wise, the Pi is quite capable. The specs and architecture is close to the GPU in the iPhone 4s. The only problem I see is bandwidth as you only have about 7GB/s compared to 12-25GB/s on typical mobile phones. So post processing is a huge no and you'd need to be very careful about the techniques that you use. Eg. you'd need to stay on chip at all times. CPU performance (eg. number of draw calls) should be enough on the quad-core PIs as you can easily utilise all cores using VK.

What features will not be supported?

  • 3D textures
  • sparse textures
  • compute shaders (though could be supported to some extent if the kernel side would support it)
  • some texture formats
  • some render target texture formats
  • occlusion queries (
  • indirect draws
  • spirv shaders
  • events
  • proper semaphore support
  • tessellation shaders
  • geometry shaders
  • 32 bit indices
  • instancing
  • some vertex buffer formats
  • pipeline caches (doesn't make sense with assembly shaders)

What additional features will this driver support?

  • I already added support (to be polished) to load shader assembly. This will enable devs to optimise shaders to the last cycle.
  • I'll probably add something to indicate towards the developer that things are emulated or not supported at all.
  • Videocore IV provides some performance counters these will be exposed
  • Videocore IV supports some texture formats that are not present in the spec
    • bw1: 1 bit black and white
    • a4: 4 bit alpha
    • a1: 1 bit alpha
  • vector graphics support?
You can’t perform that action at this time.