Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
From:   Randy Li <ranl@synaptics.com>
Subject: Re: [PATCH v5 1/2] drm/fourcc: Add Synaptics VideoSmart tiled modifiers
Date:   Thu, 1 Dec 2022 00:49:16 +0800
Message-Id: <0D62976C-77E2-4748-AA90-C50D5E2CA48C@synaptics.com>
References: <Y4c+5f3qZd6Epd1C@phenom.ffwll.local>
Cc:     Hsia-Jun Li <randy.li@synaptics.com>,
        dri-devel@lists.freedesktop.org, nicolas@ndufresne.ca,
        sakari.ailus@linux.intel.com, airlied@linux.ie, ayaka@soulik.info,
        linux-kernel@vger.kernel.org, tfiga@chromium.org,
        helen.koike@collabora.com, linux-media@vger.kernel.org,
        ezequiel@vanguardiasur.com.ar, tzimmermann@suse.de,
        ribalda@chromium.org, sebastian.hesselbarth@gmail.com,
        mchehab@kernel.org, linux-arm-kernel@lists.infradead.org,
        laurent.pinchart@ideasonboard.com
In-Reply-To: <Y4c+5f3qZd6Epd1C@phenom.ffwll.local>
To:     Daniel Vetter <daniel@ffwll.ch>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?TEtwcmQzTnRBQXRsdnB4RGNOcW0rNERuNnlvdXNzLzlzWldKbUh1WlVZeUY1?=
 =?utf-8?B?WDV2UGdnQ1VUdUJQYjlSVTZWaGRrdzNoQklMRFRMZmIxQmx3dDFxaWlWTVZy?=
 =?utf-8?B?eTVVSHlJWXc3RUJOU1BDWTFOak5JWG9YOHJPMEVPZGpXZXBGZm5jTktnRWlD?=
 =?utf-8?B?N3g3cnhEK2pZbVZvM1VPa2k3cVZJcEVROFc2bHVYY3I1dUt2YnJzR1VnOVUr?=
 =?utf-8?B?QmtlcGRvSjRoTG16RlIwd3dOS2dmblpCVlExRGtFSUpTQ2xuM3VIYnlJeGNj?=
 =?utf-8?B?bkhkQmVHRlVoYWV1VEVnOGJHSEg1OXpvYzlhSHozRVNQRzlNK0ZjNzBkMUND?=
 =?utf-8?B?d2Y0bCtUNUh5QWZuVG5PQnhKUTdMVmxCK3liRlVDTkIrWDZqRWlmVk82VWxP?=
 =?utf-8?B?ZTFSVyt3MmgzOGVLN1pMQUsrcWlkQUlyeHZJTU1lc2wxalh0N3JJOUYyUFZY?=
 =?utf-8?B?OFVVWnl3ZjdDM3V6YlpjNExkUU40aldKSHhJWGkxemhzSnhQeSs3WDJPVnY1?=
 =?utf-8?B?bEwvTTBxYWdlWFE4Z0xrTjd5SEFtajNkRFBHNHJBeHl5QU1pZ3VOZzFlY1Ir?=
 =?utf-8?B?ZklHT2krT0JRSmZnYXNaL0JjcFVHZU1VTTh5eGJNWHp3WTAzaFNzamZCT3lC?=
 =?utf-8?B?YWFHclBrdzUzWlY4T1YyQzRNck9vb3ZkYlYrWXg0NEZsVGlkbzMrNk5yaW10?=
 =?utf-8?B?S0NqVy9ZeWJGUVZJS01PbHJsT1hZanJxLzA4dUNpUllRNkt6bU1YV0tjcFZT?=
 =?utf-8?B?RFJldTZJSkFnM0hOZnlQYUdvanM3RU9rcWVCdE1HNDJ1UGhjOWRqY1hheXZR?=
 =?utf-8?B?MmJ6TDYrMGtlYStKTzluaGlIdXdwSmZ0MU14RTk1R29ZVTlHbzVBR1lJNDVM?=
 =?utf-8?B?TFJ6M0xYMzhsTGVjWUVVTE1MYmFpbXcxbG93R0lKUFFXbzd0OFR1WmJCVnRX?=
 =?utf-8?B?SEtrd1JaTmZOT1JZaDNRK2Rvc3FhOXlmRE13OXcydFFrc2h0Qm04YUJhRTQ4?=
 =?utf-8?B?emVKVUc0THlsYlFrdUpyeThOVHAvWTUrNjN6eEp3MFZqeUIzRWMvZEJ1anlq?=
 =?utf-8?B?WjBmVXdISm1tckZlS0NmeEtjSVNyNHFSWnBYTVQyaEFxUmV3TU1HeHIwc1dB?=
 =?utf-8?B?UUdjd0RyUTBzMDNBUWVrVXdjQzhxdG1RZm81TCtONURIZlMrUzVhZHFqYy9R?=
 =?utf-8?B?Z0Y3MXg1S0pNNkJPeGhzT0VLWUQrSUlwS2YyeE9iZ1JZZUJxZHNlQWllcGJD?=
 =?utf-8?B?T0I2bTFkcDAyOERBM0JJUkdzSjdzbFpSeTg4TWFMeStiejJrTEJUdWl0V0VV?=
 =?utf-8?B?Tjg1STRPeVpwRUxCSmNsV2M1c2JwT2UweWtmQnFna2Z2cFJsbXBTRnQxMURr?=
 =?utf-8?B?TEQvTFRHY0U0WHkwbXpjTFgyV3VwWWFwZFNnWjU1Y01EVDIwY1A5ZmVPTzdC?=
 =?utf-8?B?bGZhT0ZKMXRiV21zNEFzVlZIUThzNjZRaWNvS2lVN2JtTmJHQ1gzS1RPWnow?=
 =?utf-8?B?eUZraldIKyt4T3N3TzlheGdkNEw3S3hwaTN4Y0FoNjhiL1BuVCtzZlRRNEZz?=
 =?utf-8?B?alRrOWhOWXRxOUZZYXIzVUxKOTdBSVJNeXBsZ21WQUNkcFJheURDZkRyUlpJ?=
 =?utf-8?B?R0pVblJKMG1WOGdNUWlSUERMSzg5MzIvQzYyYWNNY2wyNWhOUTFkdWlZZ1Aw?=
 =?utf-8?B?TXB4UFFTemc4OE1vMG5FQzNvUGN2Z3p1dTB3OHFaSUhUbVU5THIrZFJ2cElF?=
 =?utf-8?B?dWtlY2gxeFpiRStzeHlZR0RTbGsweGNwWkNQUHgyb2dzYkFRbDVQbzVGbk5y?=
 =?utf-8?B?NnZQMTd1QlNNNnhaTk0rSCtqNnRXMW9tVlk2eXBYQVpmWmlXK3FYWmh6OHVJ?=
 =?utf-8?B?ZFBWUWpjVG9aTTBDb3V5RFhmK0tFemtuekNxcVZYUVIrcGdmblR5a21VMVV1?=
 =?utf-8?B?R0MxQmxaTjdrakdSV1ovVEdlTTJ2akRFREpVMUFUbjYxYkZRMHlwcXFoeWx4?=
 =?utf-8?B?QllYOTRsTDZFYnVhSG91cEZrMXhZaDJMaWJjTzhneDBYbG1VMUhsazFXbzdQ?=
 =?utf-8?B?R1hZcjIwMW41M0hvS2s2TWhCbkNhQXRhK3dnT0hDY240RDZxZkIyeWlvbTYr?=
 =?utf-8?Q?nPNOB2AX6oNUjotoNDzYhcmI6?=
X-OriginatorOrg: synaptics.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 69a61328-e22b-4c3c-18e5-08dad2f2d56d
X-MS-Exchange-CrossTenant-AuthSource: DM6PR03MB5196.namprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Nov 2022 16:49:23.2693
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 335d1fbc-2124-4173-9863-17e7051a2a0e
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: Emkj7PGFsa3Lts83BADhtXjbVd+qqg+aIkBQ0CJ3LmvGkMA/M1vikyGohh+WXYm+F8zLddDw6rlBsphADY2jiw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR03MB6343
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org


Sent from my iPad

> On Nov 30, 2022, at 7:30 PM, Daniel Vetter <daniel@ffwll.ch> wrote:
>=20
> =EF=BB=BFCAUTION: Email originated externally, do not click links or open=
 attachments unless you recognize the sender and know the content is safe.
>=20
>=20
>> On Wed, Nov 30, 2022 at 05:21:48PM +0800, Hsia-Jun Li wrote:
>> From: "Hsia-Jun(Randy) Li" <randy.li@synaptics.com>
>>=20
>> Those modifiers only record the parameters would effort pixel
>> layout or memory layout. Whether physical memory page mapping
>> is used is not a part of format.
>>=20
>> Signed-off-by: Hsia-Jun(Randy) Li <randy.li@synaptics.com>
>> ---
>> include/uapi/drm/drm_fourcc.h | 76 +++++++++++++++++++++++++++++++++++
>> 1 file changed, 76 insertions(+)
>>=20
>> diff --git a/include/uapi/drm/drm_fourcc.h b/include/uapi/drm/drm_fourcc=
.h
>> index bc056f2d537d..e0905f573f43 100644
>> --- a/include/uapi/drm/drm_fourcc.h
>> +++ b/include/uapi/drm/drm_fourcc.h
>> @@ -407,6 +407,7 @@ extern "C" {
>> #define DRM_FORMAT_MOD_VENDOR_ARM     0x08
>> #define DRM_FORMAT_MOD_VENDOR_ALLWINNER 0x09
>> #define DRM_FORMAT_MOD_VENDOR_AMLOGIC 0x0a
>> +#define DRM_FORMAT_MOD_VENDOR_SYNAPTICS 0x0b
>>=20
>> /* add more to the end as needed */
>>=20
>> @@ -1507,6 +1508,81 @@ drm_fourcc_canonicalize_nvidia_format_mod(__u64 m=
odifier)
>> #define AMD_FMT_MOD_CLEAR(field) \
>>      (~((__u64)AMD_FMT_MOD_##field##_MASK << AMD_FMT_MOD_##field##_SHIFT=
))
>>=20
>> +/*
>> + * Synaptics VideoSmart modifiers
>> + *
>> + * Tiles could be arranged in Groups of Tiles (GOTs), it is a small til=
e
>> + * within a tile. GOT size and layout varies based on platform and
>> + * performance concern.
>> + *
>> + * Besides, an 8 length 4 bytes arrary (32 bytes) would be need to stor=
e
>> + * some compression parameters for a compression metadata plane.
>> + *
>> + * Further information can be found in
>> + * Documentation/gpu/synaptics.rst
>> + *
>> + *       Macro
>> + * Bits  Param Description
>> + * ----  ----- --------------------------------------------------------=
---------
>> + *
>> + *  7:0  f     Scan direction description.
>> + *
>> + *               0 =3D Invalid
>> + *               1 =3D V4, the scan would always start from vertical fo=
r 4 pixel
>> + *                   then move back to the start pixel of the next hori=
zontal
>> + *                   direction.
>> + *               2 =3D Reserved for future use.
>> + *
>> + * 15:8  m     The times of pattern repeat in the right angle direction=
 from
>> + *             the first scan direction.
>> + *
>> + * 19:16 p     The padding bits after the whole scan, could be zero.
>> + *
>> + * 20:20 g     GOT packing flag.
>> + *
>> + * 23:21 -     Reserved for future use.  Must be zero.
>=20
> Can you pls fold all the future use reservations into the top end?
You see we could put more related flag in each of reserved area.
Here is for the group of tiles flag.
Bit 35 to 32 could be used for describing the dimension of the group of til=
es.
> Also I
> think it'd be good to at least reserve maybe the top 8 bits or so for a
> synaptics specific format indicator, so that it's easier to extend this i=
n
> the future ...
I think the  bit 56 to 63 are used for storing the vendor id. That is why I=
 didn=E2=80=99t include them below. Or you mean the bit 7 to 0?
Do yo
> -Daniel
>=20
>=20
>> + *
>> + * 27:24 h     log2(horizontal) of pixels, in GOTs.
>> + *
>> + * 31:28 v     log2(vertical) of pixels, in GOTs.
>> + *
>> + * 35:32 -     Reserved for future use.  Must be zero.
>> + *
>> + * 36:36 c     Compression flag.
>> + *
>> + * 55:37 -     Reserved for future use.  Must be zero.
>> + *
>> + */
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4_TILED         fourcc_mod_code(SYNAPTICS,=
 1)
>> +
>> +#define DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(f, m, p, g, h, v, c) \
>> +     fourcc_mod_code(SYNAPTICS, ((__u64)((f) & 0xff) | \
>> +                              ((__u64)((m) & 0xff) << 8) | \
>> +                              ((__u64)((p) & 0xf) << 16) | \
>> +                              ((__u64)((g) & 0x1) << 20) | \
>> +                              ((__u64)((h) & 0xf) << 24) | \
>> +                              ((__u64)((v) & 0xf) << 28) | \
>> +                              ((__u64)((c) & 0x1) << 36)))
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4H1 \
>> +     DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(1, 1, 0, 0, 0, 0, 0)
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4H3P8 \
>> +     DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(1, 3, 8, 0, 0, 0, 0)
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4H1_64L4_COMPRESSED \
>> +     DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(1, 1, 0, 1, 6, 2, 1)
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4H3P8_64L4_COMPRESSED \
>> +     DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(1, 3, 8, 1, 6, 2, 1)
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4H1_128L128_COMPRESSED \
>> +     DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(1, 1, 0, 1, 7, 7, 1)
>> +
>> +#define DRM_FORMAT_MOD_SYNA_V4H3P8_128L128_COMPRESSED \
>> +     DRM_FORMAT_MOD_SYNA_MTR_LINEAR_2D(1, 3, 8, 1, 7, 7, 1)
>> +
>> #if defined(__cplusplus)
>> }
>> #endif
>> --
>> 2.37.3
>>=20
>=20
> --
> Daniel Vetter
> Software Engineer, Intel Corporation
> https://urldefense.proofpoint.com/v2/url?u=3Dhttp-3A__blog.ffwll.ch&d=3DD=
wIBAg&c=3D7dfBJ8cXbWjhc0BhImu8wVIoUFmBzj1s88r8EGyM0UY&r=3DP4xb2_7biqBxD4LGG=
PrSV6j-jf3C3xlR7PXU-mLTeZE&m=3Dd1mgHWc-ItDXK9dSnz0WGYs9xoXTTk9LqbifMtn2LOxm=
aHHsc4ieCoE78BFkHI1i&s=3D8ptqPzTUwb3X3fBSyQA6nVAA6DchubUUsMRgmLIp1lY&e=3D