Mesa (master): docs/vc4: Add information on the hw documentation available.

[GitLab Mirror]

Module: Mesa
Branch: master
Commit: 97dd039191d2df4e343ef5b5e5cd18d71fb4cba0
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=97dd039191d2df4e343ef5b5e5cd18d71fb4cba0

Author: Eric Anholt <eric at anholt.net>
Date:   Thu Oct 15 16:19:51 2020 -0700

docs/vc4: Add information on the hw documentation available.

Reviewed-by: Erik Faye-Lund <erik.faye-lund at collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7174>

---

 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
+<https://docs.broadcom.com/doc/12358545>`__ PDF for the 21553, which
+is closely related to the vc4 GPU present in the Raspberry Pi.  They
+also released a `snapshot <https://docs.broadcom.com/docs/12358546>`__
+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.