Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id F4171C433EF for ; Wed, 22 Dec 2021 17:11:37 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 281B083451; Wed, 22 Dec 2021 18:11:35 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="Mf93Z7S1"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 75B75832FC; Wed, 22 Dec 2021 18:11:32 +0100 (CET) Received: from mail-qt1-x82f.google.com (mail-qt1-x82f.google.com [IPv6:2607:f8b0:4864:20::82f]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 3BBEB8304B for ; Wed, 22 Dec 2021 18:11:29 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=seanga2@gmail.com Received: by mail-qt1-x82f.google.com with SMTP id q14so2502517qtx.10 for ; Wed, 22 Dec 2021 09:11:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=KLodT3dl9rjkJOoZ+monfMRozCSWJ7peo6FWHINJ9fY=; b=Mf93Z7S1l59oHovhf+qgQ/TVXITWfVp4v3LqdGrPil/NlS6VqLf6Us3hmsnWi4k8UJ 8gdm/sJ0c6hp7CkpRHZBGYY+U5KOzCH7XYAlJqG1my+W368YZasa56RHAffvps24yMWD CrJ+HMWeZYuHkV8tba1xjIiTMSByDI93X70xb0S9T3LzeHzoIPyCjsNxY5gnRDP5NX5C MNHL9V8g8KXSNnT07P7bjv5umBjQo6OWNNw4hWFXSJ6++xK/bBlJBw81/6+6VnOLGVYP ayiLWjF+C0aC2WHmeVFQ9je45JaRPu4G2M/1+7Hw9clO6MkKIDf+9NzI4/CYITe/8K9M DF3A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=KLodT3dl9rjkJOoZ+monfMRozCSWJ7peo6FWHINJ9fY=; b=Qd9m9WCEzzuoeZxBwvDQZEm15bT0u8Cwz04euZNGejUcOMKojXRRo3PU1bePfGN901 JTk4rLRdjFNVY8/u7ujwfRDGh64x6OzTqsH4S2roq4uXGi7JM56u9wAhpYYMmb8c9GJ3 eJC6S7IJdzaGG2iGo4j+hwTLu4T5qP4Z+ob+TGJuBozCiy8lqIb75uclSKJObHi/RxHP pAipfKp5UuNK2Ybv9L89ZBEUfmbEfLFaG6ie9ZPLjonZQhxGgVI5l5AMw552vX/Djmmh k562SPdqkJdITVB+t2/ZCKrshvSE4M2WW5q+TkzGfMeVvhtIcFAW/L3QEEz4oPrAYdFd JaUA== X-Gm-Message-State: AOAM53136dmb4R9dGQ38GRaRblaTWVjuUgFYWx55AjcwX3jsqa/SQAde Inkh4IZzrc4fnvH+fbB8OIQeHP2LH7I= X-Google-Smtp-Source: ABdhPJzKXtpkLReuU/BvBGXluTr46F7JPHDbC3kIRliqcT/x1jlND1NA+iCd+PviR1c6KmWTZLfQ7g== X-Received: by 2002:ac8:4e41:: with SMTP id e1mr2925898qtw.116.1640193087883; Wed, 22 Dec 2021 09:11:27 -0800 (PST) Received: from godwin.fios-router.home (pool-108-18-207-184.washdc.fios.verizon.net. [108.18.207.184]) by smtp.gmail.com with ESMTPSA id j21sm2099609qkk.27.2021.12.22.09.11.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 22 Dec 2021 09:11:27 -0800 (PST) From: Sean Anderson To: u-boot@lists.denx.de Cc: Simon Glass , Lukasz Majewski , Dario Binacchi , Sean Anderson , Heinrich Schuchardt , Michal Simek , Neil Armstrong , u-boot-amlogic@groups.io Subject: [PATCH v2 0/5] clk: Clean up optional helpers, and add API docs to HTML Date: Wed, 22 Dec 2021 12:11:09 -0500 Message-Id: <20211222171114.3091780-1-seanga2@gmail.com> X-Mailer: git-send-email 2.33.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.38 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.2 at phobos.denx.de X-Virus-Status: Clean This cleans up the various optional helpers for clocks, and adds a new one. While we're at it, also convert the existing API docs to our HTML documentation. Changes in v2: - Clean up the argument list and descriptions - Rebased onto u-boot/master Sean Anderson (5): clk: Rename clk_get_optional_nodev clk: Inline clk_get_*_optional clk: Add client API to HTML docs clk: Add driver API to HTML docs clk: Add clk_get_by_name_optional doc/api/clk.rst | 19 +++ doc/api/index.rst | 1 + drivers/clk/clk-uclass.c | 21 --- drivers/clk/clk_zynq.c | 5 +- drivers/phy/phy-mtk-tphy.c | 8 +- drivers/rng/meson-rng.c | 4 +- include/clk-uclass.h | 187 +++++++++++++---------- include/clk.h | 306 +++++++++++++++++++++---------------- 8 files changed, 310 insertions(+), 241 deletions(-) create mode 100644 doc/api/clk.rst -- 2.33.0