From patchwork Thu Mar 23 01:29:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dipen Patel X-Patchwork-Id: 73740 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:604a:0:0:0:0:0 with SMTP id j10csp2664181wrt; Wed, 22 Mar 2023 18:31:32 -0700 (PDT) X-Google-Smtp-Source: AK7set+xkynArXws7+aljRgKRtbDl+gzS25sbDQAMdr+nqws3m0+CCwNKavlA03miiqxB3c6JYk3 X-Received: by 2002:a17:906:7054:b0:932:4eea:17ce with SMTP id r20-20020a170906705400b009324eea17cemr9038883ejj.39.1679535092111; Wed, 22 Mar 2023 18:31:32 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1679535092; cv=pass; d=google.com; s=arc-20160816; b=P72x3iPk6ySOznikOKoB7yU1GtS8tgC9emnahC6quNzcLtr1F7tWsdtCoK12Q/OWLC 5uq0sdHWOUzvJ6AoNCO5e+Sioi3AfObYacV/HfcymtLJFI0/RacRTHT7PvTGHUpgjTmj HmvvAKEcudO3HmC/ZZv6pMDBrTtku/mPf8ID+8G50eenB2lLpLclWCFmPrP4jqMF8nto FUV0PLoaQt2bIl8XHGJHsRYPpfFnNzoylb5sK+qt2IDUEIPaX79mlBTRmZ343uqc2enC 1TVbvVMVdTlosPLv3zPCcTV7Qpoqhylocs6pCy1rWJkYSKYoC8KFrRZOICLp4f7/QvXz OBBQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=GjbHZfAEXm7Tpt9u32Vn9q9T4Up+3nN7WFwlqHYtLGs=; b=guk1STGP/Cb87MW8HnrJA6taAaaZYJpvhjWyVCtKK9lJSo8V5Q4EsBa7bbr8dgpXL/ 9T2+F/CwEYB1WdnmsvmQE4L5U2PXrmrOuMQKYf4A8BBrqz+OstDROtYntSJJZXPkXijl uWSU1M4xzss4hM+G1w7grOQEWNwcacVYghWRg28/NTKdvJvyhSKuJaCbrkeNKNwNtGjd dVeC947dzc31F1GyyPxmQz1t5n3MPXCusI4MvVSqTgrIgUNwzgJL9U/EIDltyG2rgtNv NLg84RlnE1UtNBycmaV9sOCNW/cDTUChGZPNB0v6Mr7clrrG62hEkyBksEQxMu5SdKy1 2NQg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@Nvidia.com header.s=selector2 header.b="m6OC/xZs"; arc=pass (i=1 spf=pass spfdomain=nvidia.com dmarc=pass fromdomain=nvidia.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=nvidia.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id rj13-20020a1709076c8d00b00939e76a0c9asi5498454ejc.977.2023.03.22.18.31.08; Wed, 22 Mar 2023 18:31:32 -0700 (PDT) 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; Authentication-Results: mx.google.com; dkim=pass header.i=@Nvidia.com header.s=selector2 header.b="m6OC/xZs"; arc=pass (i=1 spf=pass spfdomain=nvidia.com dmarc=pass fromdomain=nvidia.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=nvidia.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230274AbjCWBaK (ORCPT + 99 others); Wed, 22 Mar 2023 21:30:10 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53440 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230142AbjCWB3u (ORCPT ); Wed, 22 Mar 2023 21:29:50 -0400 Received: from NAM02-DM3-obe.outbound.protection.outlook.com (mail-dm3nam02on2076.outbound.protection.outlook.com [40.107.95.76]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0153E3C25; Wed, 22 Mar 2023 18:29:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EussqS4pgZx+X4nAnLg8oUWh3+gBLJs+gLZI2bHBpbj1a9/vuDhnnMurzM/P81ErVmzLAi9kpi7WxDAoT0QT4WwVCgx1k+jarLoIZCQW8vFzB33VzXbBAZkf1U58emK6UlmDiqIXoHYKCLsWZqEiD9Pm0epjXZZ7+Hx7MXrebR8TBmNn3DtWAdrnYS8KpGPJXgdz+1r7iIBRXFpOtogXDXA7ELzk4lMoSfLR1+iE+7L4y5Vf5zZgtvDgThMol+cEzDftqvjzmqQlDrfxYgQwdDGJJtf37tC8f0kfcRNZexkfwllGNx57H5EJOxxjNHvV2DlscWkg7qiq5beixJot3Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=GjbHZfAEXm7Tpt9u32Vn9q9T4Up+3nN7WFwlqHYtLGs=; b=RC/+R5IIm4et48E8Ddah/5V6gLieQNLGYafgQq/zXxXE8Uw54QGVWfIBu8vfbczS5GZpHu4R9fwq+HHr6ynm0N8jGDnEpOqvqw43Uvr0gnTJgnoiZVUDg+QM7jrxALFlo2DyZGT474qv0oRAn5TMWhsZR1/AWaU23/fA6WBPFcDRAzghvZk6DwLBRuCadiea/E3oKz0qINJHaZYJrdpDkRt5CeYjUTP/VqiWrJcImY8ZzKjsCg8prYiCACHFUq3REzIzKlE5OhQezGEhH5+I+ldVdHBs/fF2bfnA+R39yuYx04/x8Mp6CFdwcxj1Ca9b+NonbPXnSg7GdFdcTYGeCw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) smtp.rcpttodomain=gmail.com smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=GjbHZfAEXm7Tpt9u32Vn9q9T4Up+3nN7WFwlqHYtLGs=; b=m6OC/xZsXA2IVo8tMDjjdB+69boDz6KfOzqTt26dNa8XPx8efQlGOwjt+5XjfiLI+ME9nRVl5QMhkTWjQG7Q2Cg7DPWJ1zmle21RvXk/TBr/mvP/Xiz6YmUVDKgAE9uyDQOKNb6y2Co/fKue5ymF9+/45dkIjlNle67KbJcjhoCi2cK3HOuQj00pwttn6gVIcm/CVydC2LtW0ppzUSxx3yUFVQaDkcslhhDkvbuDbs6XNTl4yJLsnBGP27aCf/LuJOUgvrnYPDLYa9wQMD0iqlyth6hqkcFXVkzP1dFX7ZsvTS39pkUNjLzsmHAQnTda38XeEdYqPjRhBOQyOD/ZTQ== Received: from MW4PR04CA0181.namprd04.prod.outlook.com (2603:10b6:303:86::6) by SA1PR12MB6869.namprd12.prod.outlook.com (2603:10b6:806:25d::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37; Thu, 23 Mar 2023 01:29:45 +0000 Received: from CO1NAM11FT042.eop-nam11.prod.protection.outlook.com (2603:10b6:303:86:cafe::c5) by MW4PR04CA0181.outlook.office365.com (2603:10b6:303:86::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37 via Frontend Transport; Thu, 23 Mar 2023 01:29:45 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by CO1NAM11FT042.mail.protection.outlook.com (10.13.174.250) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6222.17 via Frontend Transport; Thu, 23 Mar 2023 01:29:45 +0000 Received: from rnnvmail203.nvidia.com (10.129.68.9) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Wed, 22 Mar 2023 18:29:34 -0700 Received: from rnnvmail203.nvidia.com (10.129.68.9) by rnnvmail203.nvidia.com (10.129.68.9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Wed, 22 Mar 2023 18:29:34 -0700 Received: from dipenp.nvidia.com (10.127.8.10) by mail.nvidia.com (10.129.68.9) with Microsoft SMTP Server id 15.2.986.5 via Frontend Transport; Wed, 22 Mar 2023 18:29:34 -0700 From: Dipen Patel To: , , , , , , , , , , , , , CC: Dipen Patel Subject: [PATCH V4 06/10] hte: Re-phrase tegra API document Date: Wed, 22 Mar 2023 18:29:25 -0700 Message-ID: <20230323012929.10815-7-dipenp@nvidia.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20230323012929.10815-1-dipenp@nvidia.com> References: <20230323012929.10815-1-dipenp@nvidia.com> X-NVConfidentiality: public MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1NAM11FT042:EE_|SA1PR12MB6869:EE_ X-MS-Office365-Filtering-Correlation-Id: 2a0c8deb-93b4-482c-23ad-08db2b3e15d2 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: m/gOKgHhfDLSK6h5ZrhJBgTfKcVzAbANAK1UtZhc4i26m/tSzFY0pySTTI41pYMDHdksIHFN9qbeMnYDeCPPSufeCmXbuCWC80HBLpq7hpdgpVDvQTNB3mlF6VQ9GDuUkwmxboVJLFN7BL1K5ejjcqh4Cbz4Ge3Lj/NtV0cdPHE8ulzSr8QbA0Jg3tbOQQg09jCmeoRikqN/dJSUN5bpfgwMXdtcEjp8akBbnXC9CDJcvCNMYL4bUK/A6vL6bf9LPmGThKVshpVfMfJVNTR3s8YUU/SaNiFm0gEsgvxB4zPG8XtXWsO2dAxSz7N02h0N9x7WOgLWzvo/Ru6L+b7uVGTeU3HVjKrEme36xExKPRjRY8wyBbUyH7DDrThWlzIa9BAHzIQrnH88ujaAHjVkUuaUjQ1/9DOq+YvhAIn28Ucd0HpjHDwVAaBLQfoVbDVrmBefB+gAsQ3ZFSo2SseoCxl7klOVtblsFjBevOjRXfHNOiB1E22WQxiA2UV/QoeKBnkDryu8LIqXV6AM5DcOWQw2nrEDGmUtE57meeK7/RTvgbEHVU1Oqi1QO1wsW2tKf2R7JNyC+9nmFIEnixfIdBp3aexexKFQncanq3zdEbxF9fmeBcC3lHxEvy/tJi0CK7bdC1XFYrAycXns/F07/1fbVmKcwmE5lQei21703Ldg6jVKlk76aTwVxysywQNrPhTbZx7fuEMGb7mCgeKz2vkfunOOUmcmlU1K7+vT1dc+D9VuznRUAUu0kNSNry9txOkLPLHMA1RfWUMSboMkTGM8ofpgEHq+4ERE97rQh3Nbo0guFnZYsmCXbiV2li8rYL613WpFnD1xfAWSYw/BEt9V/CwkrlXhvG8eL1kSQK0= X-Forefront-Antispam-Report: CIP:216.228.117.161;CTRY:US;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:mail.nvidia.com;PTR:dc6edge2.nvidia.com;CAT:NONE;SFS:(13230025)(4636009)(39860400002)(396003)(376002)(346002)(136003)(451199018)(36840700001)(40470700004)(46966006)(82310400005)(426003)(2616005)(83380400001)(36860700001)(40460700003)(8936002)(6666004)(7636003)(2906002)(86362001)(356005)(5660300002)(36756003)(40480700001)(82740400003)(4326008)(921005)(41300700001)(70586007)(70206006)(8676002)(336012)(316002)(7416002)(7696005)(107886003)(26005)(186003)(110136005)(1076003)(478600001)(47076005)(83996005)(2101003);DIR:OUT;SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Mar 2023 01:29:45.5554 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2a0c8deb-93b4-482c-23ad-08db2b3e15d2 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a;Ip=[216.228.117.161];Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT042.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR12MB6869 X-Spam-Status: No, score=-0.2 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO, RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_NONE 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: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1761120188742265881?= X-GMAIL-MSGID: =?utf-8?q?1761120188742265881?= Make Tegra194 API document generic to make it applicable for current and future tegra hte providers. Signed-off-by: Dipen Patel Reviewed-by: Bagas Sanjaya --- Documentation/driver-api/hte/tegra194-hte.rst | 33 +++++++++---------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/Documentation/driver-api/hte/tegra194-hte.rst b/Documentation/driver-api/hte/tegra194-hte.rst index f2d617265546..85e654772782 100644 --- a/Documentation/driver-api/hte/tegra194-hte.rst +++ b/Documentation/driver-api/hte/tegra194-hte.rst @@ -5,25 +5,25 @@ HTE Kernel provider driver Description ----------- -The Nvidia tegra194 HTE provider driver implements two GTE -(Generic Timestamping Engine) instances: 1) GPIO GTE and 2) LIC -(Legacy Interrupt Controller) IRQ GTE. Both GTE instances get the -timestamp from the system counter TSC which has 31.25MHz clock rate, and the -driver converts clock tick rate to nanoseconds before storing it as timestamp -value. +The Nvidia tegra HTE provider also known as GTE (Generic Timestamping Engine) +driver implements two GTE instances: 1) GPIO GTE and 2) LIC +(Legacy Interrupt Controller) IRQ GTE. Both GTE instances get the timestamp +from the system counter TSC which has 31.25MHz clock rate, and the driver +converts clock tick rate to nanoseconds before storing it as timestamp value. GPIO GTE -------- This GTE instance timestamps GPIO in real time. For that to happen GPIO -needs to be configured as input. The always on (AON) GPIO controller instance -supports timestamping GPIOs in real time and it has 39 GPIO lines. The GPIO GTE -and AON GPIO controller are tightly coupled as it requires very specific bits -to be set in GPIO config register before GPIO GTE can be used, for that GPIOLIB -adds two optional APIs as below. The GPIO GTE code supports both kernel -and userspace consumers. The kernel space consumers can directly talk to HTE -subsystem while userspace consumers timestamp requests go through GPIOLIB CDEV -framework to HTE subsystem. +needs to be configured as input. Only the always on (AON) GPIO controller +instance supports timestamping GPIOs in real time as it is tightly coupled with +the GPIO GTE. To support this, GPIOLIB adds two optional APIs as mentioned +below. The GPIO GTE code supports both kernel and userspace consumers. The +kernel space consumers can directly talk to HTE subsystem while userspace +consumers timestamp requests go through GPIOLIB CDEV framework to HTE +subsystem. The hte devicetree binding described at +``Documentation/devicetree/bindings/timestamp`` provides an example of how a +consumer can request an GPIO line. See gpiod_enable_hw_timestamp_ns() and gpiod_disable_hw_timestamp_ns(). @@ -34,9 +34,8 @@ returns the timestamp in nanoseconds. LIC (Legacy Interrupt Controller) IRQ GTE ----------------------------------------- -This GTE instance timestamps LIC IRQ lines in real time. There are 352 IRQ -lines which this instance can add timestamps to in real time. The hte -devicetree binding described at ``Documentation/devicetree/bindings/timestamp`` +This GTE instance timestamps LIC IRQ lines in real time. The hte devicetree +binding described at ``Documentation/devicetree/bindings/timestamp`` provides an example of how a consumer can request an IRQ line. Since it is a one-to-one mapping with IRQ GTE provider, consumers can simply specify the IRQ number that they are interested in. There is no userspace consumer support for