drm/fourcc: add table describing AMD modifiers bit layout
authorSimon Ser <contact@emersion.fr>
Fri, 13 Nov 2020 17:21:35 +0000 (17:21 +0000)
committerAlex Deucher <alexander.deucher@amd.com>
Fri, 13 Nov 2020 22:29:47 +0000 (17:29 -0500)
commit544645f2ec1af910284ebde00da2a6cfab7cc8c1
tree27a3e84025a6995fd7da15d34c59fe63840eb845
parentb7397bad74db7bd380b8eee9f1d97bbfe42bdd23
drm/fourcc: add table describing AMD modifiers bit layout

The table describes how each bit in the u64 value is used. Explicitly
state which values a field can take if we have defines for them. Also
add a note when a field isn't always populated.

Forcing people to update the table when changing the bit layout should
make it more obvious when there's a mistake, I hope.

If we get to the point where the bit layout gets more complicated, it
might be worth it to split the table into multiple tables (e.g. one for
GFX8, one for GFX9+, and so on).

Signed-off-by: Simon Ser <contact@emersion.fr>
Cc: Bas Nieuwenhuizen <bas@basnieuwenhuizen.nl>
Cc: Alex Deucher <alexdeucher@gmail.com>
Cc: Daniel Vetter <daniel@ffwll.ch>
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>
include/uapi/drm/drm_fourcc.h