Message ID | 20230509113924.19540-3-ilpo.jarvinen@linux.intel.com |
---|---|
State | New |
Headers |
Return-Path: <linux-kernel-owner@vger.kernel.org> Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp2816622vqo; Tue, 9 May 2023 04:54:01 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ6sgcp9SUwjCQWeb+BKIaAA4ntjEqPbQZniQoZ1vNKuCn62yr4P8HTRStGbf1pN/CJIfTSL X-Received: by 2002:a05:6a20:938e:b0:ea:fa7f:f879 with SMTP id x14-20020a056a20938e00b000eafa7ff879mr19623531pzh.42.1683633240660; Tue, 09 May 2023 04:54:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1683633240; cv=none; d=google.com; s=arc-20160816; b=kKRxcVWBh2gkt91pVgv0gBz1fTRtCnPGIfFo8V/nkDQgtcUo/BInzhPH2nLqckfQQc LOGMFc5fENj3Rb3sWVq0FLyh0cL2DuVw9KqDhKyFaEJWkSgKpUNx7B42zMHGC5UjNchY 4cENNFIE+6j/hVM533qGHQWhw1aTts74oR5FD3XA0/gH67QSRu7hAZ8lOeEkht6pf0uT /zyN+Bieg1mPiwg27iihUlVRuCiBOJoJhB1syeGqTWb8bhdCbixo39v+e+ixPOdvb7Ch qqwMWP8puRYru7oMIZQ9kkItDI/mCzKCL2DZfjJnKDOmdLCSyCa1dhuf/vDyHIBk5oI+ civg== 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=WHYUQnoXWjvk14GYaZKim1GW+qzBUdwmVM+eexFMivk=; b=0VlNVbNSlquw0LbB2UfN2KmGJtJ36H8AccjO6L+8g/tm+pUovrwQHMSbj4CQw6o3bo nogx/wMq/uUQCqQ1rBfrEVBa6Pbfy6qDWaWlRb2Q0uCb0pkO+PZRd50nWDf1dH1Sz8Za 6iz6U0xOfnbilZx6W56vt+84/v0Gs1ytcjiu8lo2MKyvTWFPYRrTrKz7HE4BEr1sM2Yq 1JoZZ+uFgIUC9EQSVLj9KB6YLkpl6UJ37QffAF3BQg019g3cjnDJt/WlhQMlWgiNPDFJ AhEPo+fB5q0By8rg/DWyZ8b4ll5u5u0PjESCtULjmNTLkdpB5J5Xy3XC7PEy++QKXP3E oOog== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=Y67raeDr; 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 lx9-20020a17090b4b0900b00246bd5445d7si29239131pjb.104.2023.05.09.04.53.48; Tue, 09 May 2023 04:54:00 -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=Y67raeDr; 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 S235376AbjEILjt (ORCPT <rfc822;baris.duru.linux@gmail.com> + 99 others); Tue, 9 May 2023 07:39:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54490 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235055AbjEILjm (ORCPT <rfc822;linux-kernel@vger.kernel.org>); Tue, 9 May 2023 07:39:42 -0400 Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 05DC930F5; Tue, 9 May 2023 04:39:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1683632382; x=1715168382; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=KgSo5iUE5tQb+4UxGhuvzVjJhZnju7Zh1OoucPsBSwE=; b=Y67raeDrpcyhp8udNx7m1FT5aq4f1oWZFoO/RcMDHSlWxmHy/5KpndK/ nEu1vOT0B2lagSWUZY52QyMpnx0MrQ1QHLSI8EHq7qc6XePPJpg3dOG1d T8cKsJOFYzDC2Bhnwg2xxiBnUW9j4tauziWDQhtknKoavu6NdnU+8L+lA anc/mhWFH17oHYbD/wmqx9qZ1t/ELgZE+sF1xvLTlJ/n5TakH5rYnmk2g 0n/h1nHLlkV+L+1+PoT7vhIIjlV4SgNaOx/pqBZBmtP1AEE5UDndK18DF pNBuNIv0RqDNDw6IsTDl5qCD7yhRNk0O3C6K9+AedxNxbXS4a/yotGV1g w==; X-IronPort-AV: E=McAfee;i="6600,9927,10704"; a="347362072" X-IronPort-AV: E=Sophos;i="5.99,262,1677571200"; d="scan'208";a="347362072" Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 May 2023 04:39:41 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10704"; a="763805936" X-IronPort-AV: E=Sophos;i="5.99,262,1677571200"; d="scan'208";a="763805936" Received: from mbrdon-mobl.ger.corp.intel.com (HELO ijarvine-MOBL2.ger.corp.intel.com) ([10.251.219.121]) by fmsmga008-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 May 2023 04:39:39 -0700 From: =?utf-8?q?Ilpo_J=C3=A4rvinen?= <ilpo.jarvinen@linux.intel.com> To: linux-serial@vger.kernel.org, Greg Kroah-Hartman <gregkh@linuxfoundation.org>, Jiri Slaby <jirislaby@kernel.org>, =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= <philmd@linaro.org>, linux-kernel@vger.kernel.org Cc: Niklas Schnelle <schnelle@linux.ibm.com>, =?utf-8?q?Ilpo_J=C3=A4rvinen?= <ilpo.jarvinen@linux.intel.com> Subject: [PATCH v3 2/6] serial: 8250: Document uart_8250_port's ->dl_read/write() Date: Tue, 9 May 2023 14:39:20 +0300 Message-Id: <20230509113924.19540-3-ilpo.jarvinen@linux.intel.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230509113924.19540-1-ilpo.jarvinen@linux.intel.com> References: <20230509113924.19540-1-ilpo.jarvinen@linux.intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.3 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,T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED 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: <linux-kernel.vger.kernel.org> X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1765417409379735053?= X-GMAIL-MSGID: =?utf-8?q?1765417409379735053?= |
Series |
serial: Separate RT288x/Au1xxx code into own file
|
|
Commit Message
Ilpo Järvinen
May 9, 2023, 11:39 a.m. UTC
Add documentation for the struct uart_8250_port divisor latch function
pointers. Documentation is in kernel doc format but don't enable kernel
doc yet as many other fields remain undocumented.
Signed-off-by: Ilpo Järvinen <ilpo.jarvinen@linux.intel.com>
---
include/linux/serial_8250.h | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)
diff --git a/include/linux/serial_8250.h b/include/linux/serial_8250.h index 7b5d558e4e0c..d64e7bbe1f2f 100644 --- a/include/linux/serial_8250.h +++ b/include/linux/serial_8250.h @@ -90,8 +90,17 @@ struct uart_8250_em485 { * their own 8250 ports without registering their own * platform device. Using these will make your driver * dependent on the 8250 driver. + * + * @dl_read: ``u32 ()(struct uart_8250_port *port)`` + * + * UART divisor latch read. + * + * @dl_write: ``void ()(struct uart_8250_port *port, u32 value)`` + * + * Write @value into UART divisor latch. + * + * Locking: Caller holds port's lock. */ - struct uart_8250_port { struct uart_port port; struct timer_list timer; /* "no irq" timer */