From patchwork Fri Oct 6 12:15:31 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "D, Lakshmi Sowjanya" X-Patchwork-Id: 149219 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a888:0:b0:403:3b70:6f57 with SMTP id x8csp279247vqo; Fri, 6 Oct 2023 05:16:12 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFVX7/JWjOrSfnAlY039m9MuHvSDqxWyVl2CRUrD6JZKg/W+RgGbHnW4d/y1mbafewAeznG X-Received: by 2002:a92:c56e:0:b0:351:50f1:1f98 with SMTP id b14-20020a92c56e000000b0035150f11f98mr8441771ilj.32.1696594572056; Fri, 06 Oct 2023 05:16:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696594572; cv=none; d=google.com; s=arc-20160816; b=WcXSzbEipxAaaH/EwwPnrrWCe8n6KjYu2Z5aHi49nYTRHS+R6Bmm/qSVDbpp1LUXCQ NvzYdbtojVw5t4i8onbEX/KIx63mY/PIoD01KVXE/olyePuf7p9i5NpcxnV//DMT1eWc 1bxWzdZ86VcBe959otjFGRFotxIhKUPD272ho2vfIs9KTiXPfRvLrwdqbbkSrSS7UoyG R+z6s4X5CbnV1Tbe5I4j/YjD1EB87yWpL6tIWxpuuvEU65mdZgFIzyEwh++CBC8uXqen NL7HpBBKfHnfLDylG319Z9Sh9NBfnqUCZqY9qT2tfDT6JkSCENmYkjmHL6mlHd3ubOyN Qixg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:message-id:date:subject:cc:to:from :dkim-signature; bh=H8g7lJYgFVqahOPcBqStERW6ax7wVA5j4CiXAI1buqQ=; fh=ZFccEM93KI3lQBQodRnarklB9pX7RY6KCsGMfUm0Qo0=; b=jW70RZqbLPaaDw+rz7XluCRrZPLtkqoGZQjdbiVheB7BQG4mW88WYUw3d/DyluLrsp lJ9VGKdEWp2I2sQiCjI7UlJD2uuots8fWsqAui7sBwwhb0+qbdG9H8XSH49iGp+AUfmX sCCeQZ5o4vMLZI5clx091/Cd48XSZIRjLShoB6GA3N8aw/z6nO42yQdMSKg2IKPWgPTd Vicz/K/nHbIvV4GHUgUYuhmEzdhRZJ83EBMQYYi7fhWWtufqLpXHi6CUJ41rQPQtQfS6 dHbsVHgPNN+Edunbabsp7nn4ngIe3IWFNRGRaZJiIXbRkV8j2gkVovHhwXmXA/QLJ9be ScGg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=Hi2zS3a8; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: from agentk.vger.email (agentk.vger.email. [2620:137:e000::3:2]) by mx.google.com with ESMTPS id e65-20020a636944000000b005859d13f276si3595712pgc.569.2023.10.06.05.16.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 06 Oct 2023 05:16:12 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) client-ip=2620:137:e000::3:2; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=Hi2zS3a8; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by agentk.vger.email (Postfix) with ESMTP id 064B380BB3D0; Fri, 6 Oct 2023 05:16:10 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at agentk.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232179AbjJFMP5 (ORCPT + 18 others); Fri, 6 Oct 2023 08:15:57 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56068 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231991AbjJFMPz (ORCPT ); Fri, 6 Oct 2023 08:15:55 -0400 Received: from mgamail.intel.com (mgamail.intel.com [134.134.136.24]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CECF3C6 for ; Fri, 6 Oct 2023 05:15:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1696594553; x=1728130553; h=from:to:cc:subject:date:message-id; bh=NdTc3/DUxfAV3N4tPE4vGkhnkzQ8RRiJjrrmEKPFfSI=; b=Hi2zS3a8oPVlEyxYGSgnsfKEBk7ohsPQQbLwA/IW6/0vQAn2jvwPOvES ftSwVLHJg3Niz3B6mS6tNmd4MG96OrPJv/IRRagGVwHD2IIcMxYEYFInD jXqI5eEz/XlqSLXoOZcBDewacRrm2sCOh+Hdg8ctFgl8IbpgDHUV9Erc1 0jXvAu64tbQdag9hIEKl5d1cEwKf3yYA2OXwViVH9hHTOv98nwZ+J0FG8 qZUdQaT70ozVHH5U7uubNX+IFRWXMcvCVc9V41M3DRbMSSCryK1eUkp9N 3o3DuH1++LLrq4cbXhO/VPNfSaaGNMwxe+T0zAJ6FX78UuzO2PeTQdZQr w==; X-IronPort-AV: E=McAfee;i="6600,9927,10854"; a="386560892" X-IronPort-AV: E=Sophos;i="6.03,204,1694761200"; d="scan'208";a="386560892" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 06 Oct 2023 05:15:53 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10854"; a="781638826" X-IronPort-AV: E=Sophos;i="6.03,204,1694761200"; d="scan'208";a="781638826" Received: from inlubt0316.iind.intel.com ([10.191.20.213]) by orsmga008.jf.intel.com with ESMTP; 06 Oct 2023 05:15:32 -0700 From: lakshmi.sowjanya.d@intel.com To: linux-kernel@vger.kernel.org, giometti@enneenne.com Cc: andriy.shevchenko@linux.intel.com, pandith.n@intel.com, lakshmi.sowjanya.d@intel.com Subject: [PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation Date: Fri, 6 Oct 2023 17:45:31 +0530 Message-Id: <20231006121531.22450-1-lakshmi.sowjanya.d@intel.com> X-Mailer: git-send-email 2.17.1 X-Spam-Status: No, score=2.7 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (agentk.vger.email [0.0.0.0]); Fri, 06 Oct 2023 05:16:10 -0700 (PDT) X-Spam-Level: ** X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779008350047380631 X-GMAIL-MSGID: 1779008350047380631 From: Pandith N PPS documentation has a generalized section for generators. Update the section so any new generator documentation can be appended. Signed-off-by: Pandith N Signed-off-by: Lakshmi Sowjanya D Acked-by: Rodolfo Giometti Reviewed-by: Andy Shevchenko --- Documentation/driver-api/pps.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/Documentation/driver-api/pps.rst b/Documentation/driver-api/pps.rst index 2d6b99766ee8..78dded03e5d8 100644 --- a/Documentation/driver-api/pps.rst +++ b/Documentation/driver-api/pps.rst @@ -200,11 +200,17 @@ Generators Sometimes one needs to be able not only to catch PPS signals but to produce them also. For example, running a distributed simulation, which requires -computers' clock to be synchronized very tightly. One way to do this is to -invent some complicated hardware solutions but it may be neither necessary -nor affordable. The cheap way is to load a PPS generator on one of the -computers (master) and PPS clients on others (slaves), and use very simple -cables to deliver signals using parallel ports, for example. +computers' clock to be synchronized very tightly. + + +Parallel port generator +------------------------ + +One way to do this is to invent some complicated hardware solutions but it +may be neither necessary nor affordable. The cheap way is to load a PPS +generator on one of the computers (master) and PPS clients on others +(slaves), and use very simple cables to deliver signals using parallel +ports, for example. Parallel port cable pinout::