From patchwork Tue Jun 25 23:33:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Suman Anna X-Patchwork-Id: 167764 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp162081ilk; Tue, 25 Jun 2019 16:33:51 -0700 (PDT) X-Google-Smtp-Source: APXvYqy+qV4DQKfYlOe7vvTULVHFDcKEU9z9DJXTfWQnufFE3aj19DCYdFGCH/4xLgLdQ9dmT222 X-Received: by 2002:a17:90a:1904:: with SMTP id 4mr544518pjg.116.1561505630980; Tue, 25 Jun 2019 16:33:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1561505630; cv=none; d=google.com; s=arc-20160816; b=tyQMKv2+SniHI/gmdmyF6qzzyOOC7oBAvH1UazNvh7e7+7544oDQ2ntgVoMef4Mebc s7/qxEWAnOL01zfPHWkslC0KYOEAE8c4n9L48TaPX84qkQ3pdlhXwy34/iJi286XzJws pcTqBr1aOXZd2pDfvKNcEh2K/SQA6+0ad7Dv3LKFrX6h+XTWF3Ux6hDoGd7U+p7AQeOe lZy1X7pI9UCLze8R5r7swhS5qPMZD65Z1cRWtkyL6tC3f9J4hwOQkVH3499gtGoStrMI FADiuo0QUnz7KgI9ulMuUoWM7W6m8tNE6gctfN/LznJc58PvvCYVYuq4L78fxym/gkqP 8UMQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=LYYsn6FVz3dICPC1xjcrf+g4cuqCw9FM0ggDi0G05Kc=; b=CP/iYvX2VHdvlrlSCD8PSpaGyqJ0ZdPoODc8CVNwePKdRtzf+Dm3L65oTftazX1GI3 aPO+5MrdXlLNRc8h5/hVigNo8sAcK5/Au2WgfHcOGRRk882h09ndVjDTrJoO6ZHb6SMp rLb1hq4ppbV+9VXWQ7azXeeSaRc1YbPcZCtc8C4ie3yHvmXThICq3c0E4bASkVW58EpX iA408kVI7Wz0jK9MMW+ZZ17Zd4rzGgDRnhjf9pu9qaSiKJIbV/cpAG4HlG0eAQ9J74iP oi6pC8d8VnzFD9QaMeC7OfmWCV8IoXtptKMVAlKKCo9VGxPSSoYFWF4VTDnvv1b7G5Vh Fryg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=sFwzpKbL; spf=pass (google.com: best guess record for domain of linux-omap-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-omap-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id n75si226633pjc.27.2019.06.25.16.33.50; Tue, 25 Jun 2019 16:33:50 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-omap-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=sFwzpKbL; spf=pass (google.com: best guess record for domain of linux-omap-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-omap-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726402AbfFYXdu (ORCPT + 5 others); Tue, 25 Jun 2019 19:33:50 -0400 Received: from lelv0143.ext.ti.com ([198.47.23.248]:42720 "EHLO lelv0143.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725782AbfFYXdu (ORCPT ); Tue, 25 Jun 2019 19:33:50 -0400 Received: from fllv0034.itg.ti.com ([10.64.40.246]) by lelv0143.ext.ti.com (8.15.2/8.15.2) with ESMTP id x5PNXM42125309; Tue, 25 Jun 2019 18:33:22 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1561505602; bh=LYYsn6FVz3dICPC1xjcrf+g4cuqCw9FM0ggDi0G05Kc=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=sFwzpKbLCJ2IprsW6z9REMmMi1NEbB4UpkSJQIs2UhH6BkoY21nDhI9fofl1pQrAK Thv9NMcEjCWaZ8nDMjoXdLarfSV58pYF11YZONh/thO3m3YKNsERZEpL6aSvRbBl8B mZAFxV45y3dnRh2cqoWBfMgy6rgKr5766W0KPZcQ= Received: from DLEE114.ent.ti.com (dlee114.ent.ti.com [157.170.170.25]) by fllv0034.itg.ti.com (8.15.2/8.15.2) with ESMTPS id x5PNXLVu012960 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 25 Jun 2019 18:33:22 -0500 Received: from DLEE103.ent.ti.com (157.170.170.33) by DLEE114.ent.ti.com (157.170.170.25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1713.5; Tue, 25 Jun 2019 18:33:21 -0500 Received: from fllv0040.itg.ti.com (10.64.41.20) by DLEE103.ent.ti.com (157.170.170.33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1713.5 via Frontend Transport; Tue, 25 Jun 2019 18:33:21 -0500 Received: from legion.dal.design.ti.com (legion.dal.design.ti.com [128.247.22.53]) by fllv0040.itg.ti.com (8.15.2/8.15.2) with ESMTP id x5PNXLjl084713; Tue, 25 Jun 2019 18:33:21 -0500 Received: from localhost (irmo.dhcp.ti.com [128.247.58.153]) by legion.dal.design.ti.com (8.11.7p1+Sun/8.11.7) with ESMTP id x5PNXLm12247; Tue, 25 Jun 2019 18:33:21 -0500 (CDT) From: Suman Anna To: Tony Lindgren CC: Tero Kristo , Roger Quadros , , , Suman Anna Subject: [PATCH 4/5] bus: ti-sysc: Add missing kerneldoc comments Date: Tue, 25 Jun 2019 18:33:14 -0500 Message-ID: <20190625233315.22301-5-s-anna@ti.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190625233315.22301-1-s-anna@ti.com> References: <20190625233315.22301-1-s-anna@ti.com> MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 Sender: linux-omap-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-omap@vger.kernel.org A few fields in various structures is missing the corresponding kerneldoc comments. Add them. Also, fixed the comment for sidlemodes. Signed-off-by: Suman Anna --- drivers/bus/ti-sysc.c | 7 +++++++ include/linux/platform_data/ti-sysc.h | 5 +++-- 2 files changed, 10 insertions(+), 2 deletions(-) -- 2.21.0 diff --git a/drivers/bus/ti-sysc.c b/drivers/bus/ti-sysc.c index 3030c9eadfb1..ccdd1f0871f9 100644 --- a/drivers/bus/ti-sysc.c +++ b/drivers/bus/ti-sysc.c @@ -54,15 +54,22 @@ static const char * const clock_names[SYSC_MAX_CLOCKS] = { * @module_size: size of the interconnect target module * @module_va: virtual address of the interconnect target module * @offsets: register offsets from module base + * @mdata: ti-sysc to hwmod translation data for a module * @clocks: clocks used by the interconnect target module * @clock_roles: clock role names for the found clocks * @nr_clocks: number of clocks used by the interconnect target module + * @rsts: resets used by the interconnect target module * @legacy_mode: configured for legacy mode if set * @cap: interconnect target module capabilities * @cfg: interconnect target module configuration + * @cookie: data used by legacy platform callbacks * @name: name if available * @revision: interconnect target module revision + * @enabled: sysc runtime enabled status * @needs_resume: runtime resume needed on resume from suspend + * @child_needs_resume: runtime resume needed for child on resume from suspend + * @disable_on_idle: status flag used for disabling modules with resets + * @idle_work: work structure used to perform delayed idle on a module * @clk_enable_quirk: module specific clock enable quirk * @clk_disable_quirk: module specific clock disable quirk * @reset_done_quirk: module specific reset done quirk diff --git a/include/linux/platform_data/ti-sysc.h b/include/linux/platform_data/ti-sysc.h index 7d009dc08a54..1a0905435b32 100644 --- a/include/linux/platform_data/ti-sysc.h +++ b/include/linux/platform_data/ti-sysc.h @@ -72,7 +72,7 @@ struct sysc_regbits { /** * struct sysc_capabilities - capabilities for an interconnect target module - * + * @type: sysc type identifier for the module * @sysc_mask: bitmask of supported SYSCONFIG register bits * @regbits: bitmask of SYSCONFIG register bits * @mod_quirks: bitmask of module specific quirks @@ -87,8 +87,9 @@ struct sysc_capabilities { /** * struct sysc_config - configuration for an interconnect target module * @sysc_val: configured value for sysc register + * @syss_mask: configured mask value for SYSSTATUS register * @midlemodes: bitmask of supported master idle modes - * @sidlemodes: bitmask of supported master idle modes + * @sidlemodes: bitmask of supported slave idle modes * @srst_udelay: optional delay needed after OCP soft reset * @quirks: bitmask of enabled quirks */