From patchwork Wed Oct 19 09:33:41 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Ilpo_J=C3=A4rvinen?= X-Patchwork-Id: 5272 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp276512wrs; Wed, 19 Oct 2022 04:50:11 -0700 (PDT) X-Google-Smtp-Source: AMsMyM5jDsJ/QYeyQidq7CcTFMCYS40IZOywyvOEXQSicBlXCmYf8XV5Q5g/HuEW5gsGgMn7aei+ X-Received: by 2002:a17:907:3f26:b0:78d:9c30:4529 with SMTP id hq38-20020a1709073f2600b0078d9c304529mr6353297ejc.195.1666180210901; Wed, 19 Oct 2022 04:50:10 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666180210; cv=none; d=google.com; s=arc-20160816; b=tepJJXDkvcMqzNKS3MJYxdvxzELBV3tZPB797+YuAI10nhwvKlh6fhFDUaUahd1x/K 8+63TXGLWAobwVyeWgtofa74le2eOjvWYa/oj874Q5UUx9RyatDcfWPVBnw4SzOwFRge u+3+NIq224Lqn+NYdNDMs1FGiTc7wi/8Y2F+gfrfBSYoNgkU5C0jLOzrCYZL2Bbgy/0n slb+6RwIHalU04tWuj5m18yhcAd5JOoQYe/dtYfw0GSVAz0cb5QnH3KiwgyTDIN8ExpH +gHIfd9X8Es+wPhIWyUY+HzSuJN1k4hZY81Tu/0FNuynI0BMkCk6a7VCCPUbH7Uo2vd2 SOgQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=6EZYU/swxqEbvNbsFtY4KEd5kUUEjkuxhnEW44Zam/0=; b=SK4vk9uhITpY+8iS9ExLWq1QLOMAh9WnUgD3SCqZmrI3IbNBILammJmk6EdGauThuy WTKQQw73bCutj0f2i35ebAYLVIqCtrO5xxl4DoGgFpRmddtrz44IBK6ribVZo99nf58A xUJH/WG6k0I8czDXP5r44jha0yYptNV6I9Iz2gDamjkYz2kEXAW50G0a3QWckNt7uZF6 ssNQHg0158WmD1JOxNKItrYIHmXXC3GLT62kb2gTf0ua9i/0zoeY8vrnaitVZLHj2sit 7FdFoWxNMnMaoIjBCl9tUD+8HeIOqM2ccTgq/gVfAxMK9bumqVOZoPi6muwRh9oJH2yz nV0A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=Dq1UtW5u; 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=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id gs17-20020a1709072d1100b007807e1f3d9dsi18733545ejc.842.2022.10.19.04.49.45; Wed, 19 Oct 2022 04:50:10 -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=@intel.com header.s=Intel header.b=Dq1UtW5u; 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=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231183AbiJSLrO (ORCPT + 99 others); Wed, 19 Oct 2022 07:47:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47668 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230500AbiJSLqd (ORCPT ); Wed, 19 Oct 2022 07:46:33 -0400 Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E456619C233; Wed, 19 Oct 2022 04:26:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1666178770; x=1697714770; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=rEYYlDIJLI+0frdDQYe75a4u653dFCn6f4t9c6SSqPc=; b=Dq1UtW5uNhpB82TnSJe0Wwbpi8PiKriBxhl6dylpvrwiLXtoVYdIjjH8 0gPfSBhkV6l7JrE/crBNQtxF6wrLD2WwdLOCXzzNcwiaooHpUYeNqgW93 jfO9MwFIrXmdOhqXebFVzebhcdMhkmIBtFr/7XjsaGvIN579jqfS2gkvr 9DQfAvTttXztfUEC6IWzovYzcQinIodcz9IaLhHdEjOiVNRTdNIzW5GNN 7WkLH8drFR20h9ax0M3z8BUBzsOwkQ7AXNN43Snf4ZT3gk6RqXJB/R0Ip jeUIJPAk8bLyjnR8PuEvjY16sMlSSEWcqAsqP4fHvICcowdhOaz8jatja g==; X-IronPort-AV: E=McAfee;i="6500,9779,10504"; a="392661891" X-IronPort-AV: E=Sophos;i="5.95,195,1661842800"; d="scan'208";a="392661891" Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 19 Oct 2022 02:34:11 -0700 X-IronPort-AV: E=McAfee;i="6500,9779,10504"; a="734127924" X-IronPort-AV: E=Sophos;i="5.95,195,1661842800"; d="scan'208";a="734127924" Received: from sponnura-mobl1.amr.corp.intel.com (HELO ijarvine-MOBL2.ger.corp.intel.com) ([10.251.214.35]) by fmsmga002-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 19 Oct 2022 02:34:08 -0700 From: =?utf-8?q?Ilpo_J=C3=A4rvinen?= To: linux-serial@vger.kernel.org, Greg KH , Jiri Slaby , Andy Shevchenko , Bagas Sanjaya , linux-doc@vger.kernel.org, Jonathan Corbet , linux-kernel@vger.kernel.org Cc: =?utf-8?q?Ilpo_J=C3=A4rvinen?= , Andy Shevchenko Subject: [PATCH v5 3/5] Documentation: rs485: Mention uart_get_rs485_mode() Date: Wed, 19 Oct 2022 12:33:41 +0300 Message-Id: <20221019093343.9546-4-ilpo.jarvinen@linux.intel.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20221019093343.9546-1-ilpo.jarvinen@linux.intel.com> References: <20221019093343.9546-1-ilpo.jarvinen@linux.intel.com> MIME-Version: 1.0 X-Spam-Status: No, score=-4.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1747116580711810410?= X-GMAIL-MSGID: =?utf-8?q?1747116580711810410?= Add to rs485 documentation that serial core prepares the struct serial_rs485 when uart_get_rs485_mode() is called. Remove the wrong claim that the driver must fill it by itself. Reviewed-by: Andy Shevchenko Signed-off-by: Ilpo Järvinen --- Documentation/driver-api/serial/serial-rs485.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Documentation/driver-api/serial/serial-rs485.rst b/Documentation/driver-api/serial/serial-rs485.rst index 513758a702a6..ee34c8e1e56e 100644 --- a/Documentation/driver-api/serial/serial-rs485.rst +++ b/Documentation/driver-api/serial/serial-rs485.rst @@ -34,8 +34,9 @@ RS485 Serial Communications parameters in the platform data and in ioctls. The device tree can also provide RS485 boot time parameters - [#DT-bindings]_. The driver is in charge of filling this data structure - from the values given by the device tree. + [#DT-bindings]_. The serial core fills the struct serial_rs485 from the + values given by the device tree when the driver calls + uart_get_rs485_mode(). Any driver for devices capable of working both as RS232 and RS485 should implement the rs485_config callback and provide rs485_supported in the @@ -48,7 +49,7 @@ RS485 Serial Communications serial_rs485 structure matching to the current configuration. .. kernel-doc:: include/uapi/linux/serial.h - :identifiers: serial_rs485 + :identifiers: serial_rs485 uart_get_rs485_mode 4. Usage from user-level ========================