Changes to the driver should be reviewed against the documentation for the following hardware.
Some of the hardware listed here is not supported, meaning we don't regularly run tests on it. The hardware development page on fuchsia.dev has the most up to date hardware support status.
The driver code here is based on the Programmer's Reference Manuals published by Intel for graphics driver developers.
To facilitate reviews, driver code should include comments pointing to the relevant manual sections. Reference comments should include the following parts:
IHD-OS-TGL-Vol 2c-12.21
. This facilitates searching for a downloadable version of the manual."Sequences for DisplayPort" > "Enable Sequence"
. This facilitates searching for equivalent information in a different manual. This example uses a two-level section name because "Enable Sequence"
is too generic, resulting in too many hits.IHD-OS-TGL-Vol 2c-12.21
is split into two parts. Without a Part 1
/ Part 2
qualifier, page numbers would be ambiguous.pages 143-145
. This optimizes for reviewers who need to check that the code matches the documentation.The most relevant manuals for this driver are:
The following standards are particularly relevant to this driver.