From patchwork Mon Oct 16 10:19:53 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: 153302 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp3358635vqb; Mon, 16 Oct 2023 03:20:06 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGtOerC8S8qqRF1gL+i40U5z2HY2S/AEw3+60FqWVJiyjBBKqIS45znyYi/gSNYyMV1pXnI X-Received: by 2002:a17:902:da87:b0:1c6:2902:24f9 with SMTP id j7-20020a170902da8700b001c6290224f9mr38696661plx.1.1697451606069; Mon, 16 Oct 2023 03:20:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697451606; cv=none; d=google.com; s=arc-20160816; b=ZURTdT8QEYZeSUzgOB+VMmIGJsZHkVZwz4Yp9c9VEX+78y5X9kIEYBVLKJUws7Lild UhtS3YFiFD9d1zU4rw6PfLcfRH3wWH187RH8SYmm8JuB/WjCrha/VFV4JgKi+BSqyPqS MRUtql+W8VrYmEhXZ187yXKBT4k9bWhcH3cvhvqo9WT6TcqaupESo8xKNzoEYxKqqdmO wwhZwaxuqUq6O40BFrAJqhtU7DZwDBPnc5zAc3U6/uGEvEfy9gClp3zJORHHJ3Pb4y/U Oe46/1GYzMqv0k7S7o4slK5udueRvF3OOQlk+OH21Y/hLwocFB3WlMgBMu/AsZyv6ROF YVyw== 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=m4GpdmijHR853VxeH7pNZ9/TZgpVcefutyVpuwDJ2X0=; fh=k5lSSvTDD/Qt7TJ1igpforA78PuVCbiowFdCnlkka/4=; b=sFLBhhiO+JJl9QvLt4sJin2C3qsrrI00e2RpS2KR/d5JjAp+8MKM/DbAQI6SZSh3Rq vqie3aUCgiLsNbSOdz3f7Cx+DJ+5JJHsDX6P0gCINqH+DrNCgr2mw8qYmyMZlbzQUoll xTmSx79JaSUd+XJhoIlkGMz5XdEw3ZP7Dp7VSFg47WS8UHyBa1+XWHAZlyKZexupyN1Z pWmUzK43IaIeg5DAZ6qe+n1Eow0HWs2d56eZvO/qw9evBOfOxC1O2BcBYed7f1lrwZPe aU4IhG+3mq798KCeMASPAEbBTyBIHfhy4s13ynCIUVjMrjQTdsata25pB7dCPIW51JQB b+ww== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=ClAYZ8Np; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 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 snail.vger.email (snail.vger.email. [23.128.96.37]) by mx.google.com with ESMTPS id l15-20020a170903244f00b001bbae3ae2bcsi4521419pls.413.2023.10.16.03.20.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 16 Oct 2023 03:20:06 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=ClAYZ8Np; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 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 snail.vger.email (Postfix) with ESMTP id 672D9803E7A0; Mon, 16 Oct 2023 03:20:05 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231162AbjJPKUA (ORCPT + 18 others); Mon, 16 Oct 2023 06:20:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35184 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229668AbjJPKT7 (ORCPT ); Mon, 16 Oct 2023 06:19:59 -0400 Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.151]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F3407B4; Mon, 16 Oct 2023 03:19:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1697451596; x=1728987596; h=from:to:cc:subject:date:message-id; bh=QREbj1c18eNe5Kf8EeCr5BxaKxdLOo747K7h+2jlT1M=; b=ClAYZ8NpTxSKq4YXtJRHlz6CnCi9oa/rXTzBpfgzROkQEBGRQcpfmcHP 6RKlYSq2Jo6xyjl55COClh7n9Aqp6yvVOjIgZw6m4bnJKJviYtFIaiqie gmM64XDipirCXHhzpq6lmalu7h2YBumttsbIIs8HJR1P3hmYQrbGEwqLA fu91y3cAiy1Ezsi1IJVDzxHaSRV4pVy4vO5nfu0XtrnbazIHiAWMkItZk oLRdaAmjfDgnDV9vqid/aRCWPJ6qub2ZBG88DevHuWPZOpZkN4DOOCy4i 92vCtxp1s9spvc5IHMkbUvdOn6rv7L6CL3F941WVp1GEBUVRlZlZq53vE g==; X-IronPort-AV: E=McAfee;i="6600,9927,10863"; a="365750296" X-IronPort-AV: E=Sophos;i="6.03,229,1694761200"; d="scan'208";a="365750296" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 16 Oct 2023 03:19:56 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10863"; a="846343306" X-IronPort-AV: E=Sophos;i="6.03,229,1694761200"; d="scan'208";a="846343306" Received: from inlubt0316.iind.intel.com ([10.191.20.213]) by FMSMGA003.fm.intel.com with ESMTP; 16 Oct 2023 03:19:54 -0700 From: lakshmi.sowjanya.d@intel.com To: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: giometti@enneenne.com, corbet@lwn.net, gregkh@linuxfoundation.org, 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: Mon, 16 Oct 2023 15:49:53 +0530 Message-Id: <20231016101953.27308-1-lakshmi.sowjanya.d@intel.com> X-Mailer: git-send-email 2.17.1 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_NONE autolearn=ham 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-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Mon, 16 Oct 2023 03:20:05 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779907015499296708 X-GMAIL-MSGID: 1779907015499296708 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 Reviewed-by: Andy Shevchenko Acked-by: Rodolfo Giometti --- 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::