From 97dd039191d2df4e343ef5b5e5cd18d71fb4cba0 Mon Sep 17 00:00:00 2001 From: Eric Anholt Date: Thu, 15 Oct 2020 16:19:51 -0700 Subject: [PATCH] docs/vc4: Add information on the hw documentation available. Reviewed-by: Erik Faye-Lund Part-of: --- docs/drivers/vc4.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/drivers/vc4.rst b/docs/drivers/vc4.rst index d80b568cd20..344b42c14af 100644 --- a/docs/drivers/vc4.rst +++ b/docs/drivers/vc4.rst @@ -285,3 +285,21 @@ you can test a compiler change in this shader-db with:: (cd ../mesa && make install) ./run.py > after ./report.py before after + +Hardware Documentation +---------------------- + +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 +potentially get access to "simpenrose", the C software simulator of +the GPU. The Mesa driver includes a backend (`vc4_simulator.c`) 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.