From patchwork Fri Oct 3 16:55:09 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 497 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510610; bh=twKIZIIT3hVU2x3tz/WNpoNyJ4ZE0JXtT3l6lNBUj3Y=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=e630uCl62zjENS1BXWTsD1IfS8ZTlV0j4NmqrrymKzJdwCa4BTuOZKNezdosEVgjO JcYbwORF7JnuCmmqAV5GMmdWVtSP69oCvjPo4rS/wEn9T19dlxx0SmJ+FAuv5VVOHe Ceh/FeK1irRiGSn5apbBJEXklQ1297XiWhDNkaNidU/PX2B3l6KdNrpIObg/kJ3lxX WEB75hz35ramgWpYMKby9aLFTkx9doO1Ff5ht2Zi3IbqMHKzxzaTbHxebBoVRwl6/B hF7UKhRgcKPv0mgdcc3EeUnO0H3r/hv3imiSKxb/s4wFLHzyuvuw5RceyyAiWp3r8F IsrhH43m6N4Wg== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id DECFB67EBF for ; Fri, 3 Oct 2025 10:56:50 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id 41Z5qDsOiIla for ; Fri, 3 Oct 2025 10:56:50 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510610; bh=twKIZIIT3hVU2x3tz/WNpoNyJ4ZE0JXtT3l6lNBUj3Y=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=e630uCl62zjENS1BXWTsD1IfS8ZTlV0j4NmqrrymKzJdwCa4BTuOZKNezdosEVgjO JcYbwORF7JnuCmmqAV5GMmdWVtSP69oCvjPo4rS/wEn9T19dlxx0SmJ+FAuv5VVOHe Ceh/FeK1irRiGSn5apbBJEXklQ1297XiWhDNkaNidU/PX2B3l6KdNrpIObg/kJ3lxX WEB75hz35ramgWpYMKby9aLFTkx9doO1Ff5ht2Zi3IbqMHKzxzaTbHxebBoVRwl6/B hF7UKhRgcKPv0mgdcc3EeUnO0H3r/hv3imiSKxb/s4wFLHzyuvuw5RceyyAiWp3r8F IsrhH43m6N4Wg== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id CDA4867E83 for ; Fri, 3 Oct 2025 10:56:50 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510609; bh=6rU+HS/2y6/FopCEPUCiiiSX4DzgHUWd1JHggEtSJF8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=coSS2N4qfvGTUfLJIk3wQOlFwEnCXoEEj/0ZEy3mqDHZ4woc3eECl/iKkKtsGwsBa mOYJikdHbTNze4yfqwhde3BSI1AiP6x/iBx5IAhJj9oP14hEzXewRIOSRrUZKOHnen wlHXw5bYMXcJ56edA/SeE/3T2KzLNglZblcA8kxBzRgyH0VyT9KrUNo/e2mhG1u+VM xO1Fe7OM2QSsBEj8Jvhj4ZYjm9gAmYBr6yrcQgR+EbYGeawNj82InmJ4lsSB+ljKBS 25D3aQQPX8ACQy/IP0Cw8L/a3AfvCALEpcJu+UDWcDYQ2lZO1plOinpClJbsFvGG07 XXu/LeTIf3TTQ== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 28E3A67E12; Fri, 3 Oct 2025 10:56:49 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id wyRr9zYMJRGV; Fri, 3 Oct 2025 10:56:49 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510604; bh=p10I8BgtJC1cMFvqg16HnivQHOh4m7ZXdT8We2AMi5A=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=f70Ht8icu7SKldSDIWaxcYpaTbaYuzmjWgl9HRUiS4WvGM6ZwwuYCXFr9WmJEnbDb pURTx6s6Q2OgrRncZEVqrZ/liekqEky0zB2HsMKMgeEgR/J0smKNz/NhLrynMdeX3F TD8gKJgR/BGT5qHCSvYm+6H+ZdifrENtbU3H5oEc2kLfQYVKeCeXA4hPO1IsufaqPX Us+ET5C6l4xVVeTAE7/dq8f7nTDxqkm78vvq6Y/LRjbqi5m5R+Mci2EI/0M6KV1kuM vxNiEYmNRm+hc3sS+EJJkV8sOAqmtOWHGhlBhvDCj88J5HWwu9ogwdorcgO4FXWHDg KnjHCtCJoPNUw== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id 3DD4B67E83; Fri, 3 Oct 2025 10:56:44 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Fri, 3 Oct 2025 10:55:09 -0600 Message-ID: <20251003165525.440173-17-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251003165525.440173-1-sjg@u-boot.org> References: <20251003165525.440173-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: PWLTCCAYSBNJSLS37CJYAEDDQ3B2WX75 X-Message-ID-Hash: PWLTCCAYSBNJSLS37CJYAEDDQ3B2WX75 X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Heinrich Schuchardt , Simon Glass X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 16/22] video: Tidy up the comment for sync() List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass Adjust this comment to match the style of other uclasses. Signed-off-by: Simon Glass --- include/video.h | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/include/video.h b/include/video.h index 116a10afc93..3ce603384dc 100644 --- a/include/video.h +++ b/include/video.h @@ -133,14 +133,22 @@ struct video_priv { /** * struct video_ops - structure for keeping video operations - * @sync: Synchronize FB with device. Some device like SPI based LCD - * displays needs synchronization when data in an FB is available. - * For these devices implement sync hook to call a sync function. - * vid is pointer to video device udevice. Function should return 0 - * on success and error code otherwise */ struct video_ops { - int (*sync)(struct udevice *vid); + /** + * @sync() - Synchronize FB with device + * + * Some devices like SPI-based LCD displays needs synchronization when + * data in a framebuffer is available. These devices can implement this + * method which is called whenever a video device is synced. + * + * Note that if CONFIG_VIDEO_DAMAGE is enabled, the driver can use this + * to optimise the region to redraw. + * + * @dev: Video device + * Return 0 on success, or -ve error code + */ + int (*sync)(struct udevice *dev); }; #define video_get_ops(dev) ((struct video_ops *)(dev)->driver->ops)