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;
From:   Hsia-Jun Li <randy.li@synaptics.com>
To:     dri-devel@lists.freedesktop.org
Cc:     ayaka@soulik.info, maarten.lankhorst@linux.intel.com,
        mripard@kernel.org, tzimmermann@suse.de, airlied@gmail.com,
        daniel@ffwll.ch, linux-kernel@vger.kernel.org, tfiga@chromium.org,
        nicolas@ndufresne.ca, "Hsia-Jun(Randy) Li" <randy.li@synaptics.com>
Subject: [PATCH] RFC: drm: Create a alloc helper flags blob
Date:   Wed, 22 Mar 2023 18:52:26 +0800
Message-Id: <20230322105226.122467-1-randy.li@synaptics.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?P2vzdlYjidS+gomcqcdMD2niR+vPrKvjPF8XjLpGKpG1fsFEbFUz+HWr4EwK?=
 =?us-ascii?Q?/5DsBXSH+Urt+CM+j+d+sZcJeoHfbZshKutCcbeGc10WZaDIH8gUptJsUOpI?=
 =?us-ascii?Q?6ThgTcQwcBpHnUM8ABpvRVYcqpNigQ72JmNqSNfnukMk91ve3Sv1LucnPG4N?=
 =?us-ascii?Q?wTSB9pWO+fYl3TAAKdz8sErSqDlafL0I6437iOR/wAE2dur4Ka6Cgq49uKUQ?=
 =?us-ascii?Q?FLa2rBK7Jse5g6khrsBq4PXPtZ6bTnb+LKnasJs0eABRYJKgwRXQoK0Sq0cw?=
 =?us-ascii?Q?v+oI5mXDdAvF1Yhyn6X9cv+1Tl2Mhy/w3m3bXR+NxPpAJorcWkqlE8W5bV5j?=
 =?us-ascii?Q?FakxFelkb97mj1Pzw8aH5qplzzj4MtagoxPx8xYcJMdpsOfrpVJ+z5n4AAKy?=
 =?us-ascii?Q?YJL5hY4i/dZmqKGPl1TxteqsXjNXjMSpu9dxOyY7CiuAxTmwTIDj4yDZSv/o?=
 =?us-ascii?Q?Hxs2sdDyl676w5/Wg/YmxzIelDiIT8oo25c1LQJkuEZGRfkqYY1OaZkGveso?=
 =?us-ascii?Q?Q4q4aE822bazN+XbI9+ivCDaDH58xEwKMRFy0xrdPuUwY9BrDoN3JjtRnrGT?=
 =?us-ascii?Q?egBjKJfmdXjqCfI8R0xlwvz/WtzkAiR1kBHhw5xg+TTtSJumdQO7URqdQqg+?=
 =?us-ascii?Q?f13k7G2dm0ni4ZykWLFB1vWPYN9bHxIm1yee54GzeJ6agKodYrQ2E6VjSOIJ?=
 =?us-ascii?Q?a1rRoFjDPUIq9RXjOlTs20/24gIvjnHP/LkFAgbl0Ka9X6Pk9HN+wGlmYfA0?=
 =?us-ascii?Q?kI/+5PgYnO9XegSqc6oki87VxQW7YyPs5uetPwx/eGLxksPf0P6Mj7MPuwNn?=
 =?us-ascii?Q?NePKZfsTaG5yIe4qLt0X1x3VFx6fI4I24o78ZOCHe3aMnUFhaVfTJosS1w1L?=
 =?us-ascii?Q?1LkkAMMt9Cf1Edlt5ClxQw2T+Ygwopj2CpefzR9uH4PGcGKVLobGVYuOneg8?=
 =?us-ascii?Q?RTSBttHC+tjO9UclsLOc2v4IkbN98wb8B9o2Ys8nJe7eN0grRtK/RWF3e610?=
 =?us-ascii?Q?13ootBqoN3twutohQx9ttEoDKFskwMyXWrDmcExe6gkbi3VxuiK5zNEyqVK0?=
 =?us-ascii?Q?RcExO0MIhkH+L5NR6xU9IALRHNU09E98Cx2ovV0/5OtufgaDIhny9oJ/h5w4?=
 =?us-ascii?Q?s9b5Df3Ndwu8hJF7lEJ5CIukAnE2b3HUQ90CiC+sFe0JL965TkYYKSt+LF6w?=
 =?us-ascii?Q?px6S+AusRheXm5CcNb/61OWkoJCoPla4rqJSol8B4sre8tkhW5pNQ4UHH5en?=
 =?us-ascii?Q?mBDrp0AkmZpHrkvEKpKJfP9SH7i7IWfaykCCZC823gtkMMmtglZGX+dpkjz1?=
 =?us-ascii?Q?YVocKCrlfiPCl0H/LjrMyTiYSziqsJ4dMxWE4g4F7TaQd2F30XOy9Yo0JmVG?=
 =?us-ascii?Q?FdxTo7PFuFXPILyV9Vdjk6THdYiDft6/IhtdA/hpJg7Hon56BxY5Cv/M18cq?=
 =?us-ascii?Q?3FkqcHEaN1Nda5t16+vJGiy+VPhYsisHDVSWZU4H1Gh6TeV7OPiZ7GfcUoaz?=
 =?us-ascii?Q?SjSQNlQ/iIc+sJJBu/4ZJ+z/UCxyBXB3vXImyLP0VW1WBitj1akqGSIFh69U?=
 =?us-ascii?Q?rzNvOaTnq3rR3o3eLfQw6ziesgoePPX3xTo93E3a?=
X-OriginatorOrg: synaptics.com
X-MS-Exchange-CrossTenant-Network-Message-Id: c1a05af8-15a7-41a5-71df-08db2ac394e7
X-MS-Exchange-CrossTenant-AuthSource: DM6PR03MB5196.namprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Mar 2023 10:52:51.1210
 (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: wY5nD6QNlq3I5BFwm93TrjRf/xLQzlLaCaunhCwcJ7XBvIMwGAAjl5ycGllxFThJm0pZcaw7gWx3+F6uKjouPA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR03MB5093
X-Spam-Status: No, score=-0.0 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
        RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS
        autolearn=unavailable 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

From: "Hsia-Jun(Randy) Li" <randy.li@synaptics.com>

In Android, we could also call gralloc to allocate a
graphics buffer for the decoder, display or encoder.
In the GNU Linux, we don't have such framework, the only
thing we could have is the GBM.
Unfortunately, some platforms don't have a GPU may not
ship the gbm library or the GBM is a part of proprietary
GPU driver. They may not know the allocation requirement
for the other display device.

So it would be better to offer an generic interfaces
for the application allocating the buffer from the 3rd place,
likes DMA-heap or DRM dumb.

The storage of this blob would is different to the modifier
blob, userspace would likes the format key and modifiers
data relation. It would be better to let application seek
the allocation flags they want.

Signed-off-by: Hsia-Jun(Randy) Li <randy.li@synaptics.com>
---
 include/uapi/drm/drm_mode.h | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/include/uapi/drm/drm_mode.h b/include/uapi/drm/drm_mode.h
index 46becedf5b2f..ee5b4d5aee0a 100644
--- a/include/uapi/drm/drm_mode.h
+++ b/include/uapi/drm/drm_mode.h
@@ -218,6 +218,11 @@ extern "C" {
 #define DRM_MODE_CONTENT_PROTECTION_DESIRED     1
 #define DRM_MODE_CONTENT_PROTECTION_ENABLED     2
 
+/* DRM buffer allocation flags */
+#define DRM_BUF_ALLOC_FLAG_DUMB_IMPORT		(1UL << 63)
+#define DRM_BUF_ALLOC_FLAG_SEPARATE_PLANE	(1UL << 62)
+/* bits 0~31 were reserved for DMA-heap heap_flags */
+
 /**
  * struct drm_mode_modeinfo - Display mode information.
  * @clock: pixel clock in kHz
@@ -1168,6 +1173,37 @@ struct drm_format_modifier {
 	__u64 modifier;
 };
 
+struct drm_buf_alloc_flags_blob {
+#define FORMAT_BLOB_CURRENT 1
+	/* Version of this blob format */
+	__u32 version;
+
+	/* Flags */
+	__u32 flags;
+
+	/* Number of fourcc formats supported */
+	__u32 count_formats;
+
+	/* Where in this blob the formats exist (in bytes) */
+	__u32 formats_offset;
+
+	/* Number of drm_buf_alloc_flags */
+	__u32 count_alloc_flags;
+
+	/* Where in this blob the modifiers exist (in bytes) */
+	__u32 alloc_flags_offset;
+
+	/* __u32 formats[] */
+	/* struct drm_buf_alloc_flags alloc_flags[] */
+};
+
+struct drm_buf_alloc_flags {
+	__u32 format;
+	__u32 pad;
+	__u64 modifier_mask;
+	__u64 flags;
+};
+
 /**
  * struct drm_mode_create_blob - Create New blob property
  *
-- 
2.17.1