Received: by 2002:a05:6358:3188:b0:123:57c1:9b43 with SMTP id q8csp1239359rwd; Thu, 15 Jun 2023 08:03:42 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ4cSkituDrD9tNpz0PLvTFHrqxsITwhGkXnF9sK0XDVgLZ1Rmr+C5VpAAeMP9tmeZenOSsd X-Received: by 2002:a17:902:8d8a:b0:1ad:e633:ee96 with SMTP id v10-20020a1709028d8a00b001ade633ee96mr12427486plo.55.1686841421263; Thu, 15 Jun 2023 08:03:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686841421; cv=none; d=google.com; s=arc-20160816; b=YEdVTMMiEH7vpZs6mkCcM++1jh2pQFARANayv7ar5lU8pvNMiZBp1E/Zbs+Zildzva Ad3Q602MZJoD4ZZ3uyjDjZCgHP+I9PS1YYOjKtQ3F/u2SYfy4MnRH2gXk2VjL20gNUar j/xs9RQ64jgJXviAdWcYVp5AZu7Kn23O6CUr/L60q/5Wqz4o+oY4clj8a0vqOb/JCKp3 gt5YEUQDr7UZSJzFxzv+GIZBomo4l4IogCBtGeMOhSXQuKBenypSDkybn1w0iH6wZ7HF i708hepAi8tjwCweQK1t83vKO4nrNyE3jHl9G8y+tay9dlyhwUf14eC6+SNFS7zUwEaf AiEA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=FvtLr973j88UEE2Z9JBYRmv6xj7YJZjmrpIMuK6n4fg=; b=UQdX5hYLTrjWkaNi4D/QY3WDodyvQ1Z9Nhp6wmdGTgv6HE9NK7WlNnXJ3LkYKEtPXe goNRh93FCQIbmodQ//QnvgMCNxXyind5221pCWON6olcjlNX2Em/RMUoS13ha+ZLmpbY V9gYHCEz5HgRdBnyO0NYWbyOeEWv9z56t+IrtBcj0D1TUIzOVVgDM21sfpN5YKK4VnAp mzqcK2f4szrjpG0IBFRnMTufSTJWanS5kmP0/R5nvnmyst4CiTRf2JF48jf/ptBOh22w Hj0TFUCsmGudvRTkbtljPdC0k8ehTDtfZ02wYDYStEmDyRwqmuGchcZyw7D+P+aVqkJy IOMA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@quicinc.com header.s=qcppdkim1 header.b=H2hHuW7C; 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=quicinc.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id h11-20020a170902748b00b001b3414a1fa9si9696786pll.175.2023.06.15.08.03.08; Thu, 15 Jun 2023 08:03:41 -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=@quicinc.com header.s=qcppdkim1 header.b=H2hHuW7C; 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=quicinc.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1345115AbjFOOu4 (ORCPT + 99 others); Thu, 15 Jun 2023 10:50:56 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34858 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S238819AbjFOOux (ORCPT ); Thu, 15 Jun 2023 10:50:53 -0400 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 89844273D; Thu, 15 Jun 2023 07:50:51 -0700 (PDT) Received: from pps.filterd (m0279866.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 35FDI4gD025616; Thu, 15 Jun 2023 14:50:43 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=quicinc.com; h=date : from : to : cc : subject : message-id : references : mime-version : content-type : in-reply-to; s=qcppdkim1; bh=FvtLr973j88UEE2Z9JBYRmv6xj7YJZjmrpIMuK6n4fg=; b=H2hHuW7C4pHaCFLSPPQaOTyRYvUdMVjrbH5XPJPuA0FV+2OwbJPphgHIe19tvHQrb1A1 /Db4C8UtSp4bLNbPl6dXPzCxCgb9Z81IvsBCB+Ny/4tl5by82tSzM89oAEgTYROWUkVV B2dSWG/XYSyrWVwCxCNtrNksfpy0tO/OpcjJ7Ld7eOkasJWqOPhX1SFzqu7To0GoVG+5 Jhpa6+2WpqII3Csmb3htRgyKs9em4KpsDKvdxvvIB7LNptjUlA1/ZgTyGWzI5yzNy0xp Vhnjau3Iq7CAIok2uOWHfA4TCIZ0wenEXDoYVjRkKPNLI6gTbXHV0P82HoQnfEsgAfXq Fg== Received: from nalasppmta01.qualcomm.com (Global_NAT1.qualcomm.com [129.46.96.20]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 3r7va2hbkb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 15 Jun 2023 14:50:43 +0000 Received: from nalasex01c.na.qualcomm.com (nalasex01c.na.qualcomm.com [10.47.97.35]) by NALASPPMTA01.qualcomm.com (8.17.1.5/8.17.1.5) with ESMTPS id 35FEof6o008630 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 15 Jun 2023 14:50:41 GMT Received: from hu-bjorande-lv.qualcomm.com (10.49.16.6) by nalasex01c.na.qualcomm.com (10.47.97.35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.42; Thu, 15 Jun 2023 07:50:41 -0700 Date: Thu, 15 Jun 2023 07:50:39 -0700 From: Bjorn Andersson To: Arnaud POULIQUEN CC: Bjorn Andersson , Sarannya S , , , , , , , "Deepak Kumar Singh" Subject: Re: [PATCH V7 1/3] rpmsg: core: Add signal API support Message-ID: <20230615145039.GA3256591@hu-bjorande-lv.qualcomm.com> References: <1682160127-18103-1-git-send-email-quic_sarannya@quicinc.com> <1682160127-18103-2-git-send-email-quic_sarannya@quicinc.com> <20230614155453.dywcrntfjddxojfv@ripper> <6e51d6d8-cd3a-b0f2-c044-6282749aae89@foss.st.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: <6e51d6d8-cd3a-b0f2-c044-6282749aae89@foss.st.com> X-Originating-IP: [10.49.16.6] X-ClientProxiedBy: nalasex01c.na.qualcomm.com (10.47.97.35) To nalasex01c.na.qualcomm.com (10.47.97.35) X-QCInternal: smtphost X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=5800 signatures=585085 X-Proofpoint-GUID: wPnuenzpVlHciYfr5kJ1WBZ8Gsk_UCQF X-Proofpoint-ORIG-GUID: wPnuenzpVlHciYfr5kJ1WBZ8Gsk_UCQF X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.254,Aquarius:18.0.957,Hydra:6.0.591,FMLib:17.11.176.26 definitions=2023-06-15_11,2023-06-15_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 mlxlogscore=999 priorityscore=1501 mlxscore=0 impostorscore=0 bulkscore=0 suspectscore=0 lowpriorityscore=0 clxscore=1011 phishscore=0 malwarescore=0 spamscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2305260000 definitions=main-2306150129 X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE, SPF_PASS,T_SCC_BODY_TEXT_LINE 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 On Thu, Jun 15, 2023 at 11:01:14AM +0200, Arnaud POULIQUEN wrote: > > > On 6/14/23 17:54, Bjorn Andersson wrote: > > On Sat, Apr 22, 2023 at 04:12:05PM +0530, Sarannya S wrote: > >> From: Deepak Kumar Singh > >> > >> Some transports like Glink support the state notifications between > >> clients using flow control signals similar to serial protocol signals. > >> Local glink client drivers can send and receive flow control status > >> to glink clients running on remote processors. > >> > >> Add APIs to support sending and receiving of flow control status by > >> rpmsg clients. > >> > >> Signed-off-by: Deepak Kumar Singh > >> Signed-off-by: Sarannya S > >> --- > >> drivers/rpmsg/rpmsg_core.c | 21 +++++++++++++++++++++ > >> drivers/rpmsg/rpmsg_internal.h | 2 ++ > >> include/linux/rpmsg.h | 15 +++++++++++++++ > >> 3 files changed, 38 insertions(+) > >> > >> diff --git a/drivers/rpmsg/rpmsg_core.c b/drivers/rpmsg/rpmsg_core.c > >> index a2207c0..e8bbe05 100644 > >> --- a/drivers/rpmsg/rpmsg_core.c > >> +++ b/drivers/rpmsg/rpmsg_core.c > >> @@ -331,6 +331,25 @@ int rpmsg_trysend_offchannel(struct rpmsg_endpoint *ept, u32 src, u32 dst, > >> EXPORT_SYMBOL(rpmsg_trysend_offchannel); > >> > >> /** > >> + * rpmsg_set_flow_control() - sets/clears serial flow control signals > >> + * @ept: the rpmsg endpoint > >> + * @enable: pause/resume incoming data flow > > > > As shown in the discussion, it's still not clear what true/false means. > > Also, let's try to clarify that it's a request for the other side to do > > something: > > > > * rpmsg_set_flow_control() - request remote to pause/resume transmission > > * ... > > * @enable: flow restricted > > * ... > > > > > > PS. There's a stray space at the end of the line. > > The notion of flow restricted seems to me also ambiguous. It does > not specify if the stream is limited in term of bandwidth or stopped. > > What about using XON/XOFF as specified in software flow control[1] > > XOFF Pause transmission > XON Resume transmission > > or simply pause/resume definitions > I agree, that's still ambiguous. I was concerned about expressing it such that the reader would assume that calling this means there will be no more data coming, but there might be things in the queues etc. Expressing it in terms of the state of transmission is clearer. /* * rpmsg_set_flow_control() - request remote to pause/resume transmission ... * @enable: Pause transmission ... */ Does that sound okay and clear to you? Thanks, Bjorn > [1]https://en.wikipedia.org/wiki/Software_flow_control > > Regards, > Arnaud > > > > >> + * @dst: destination address of the endpoint > >> + * > >> + * Return: 0 on success and an appropriate error value on failure. > >> + */ > >> +int rpmsg_set_flow_control(struct rpmsg_endpoint *ept, bool enable, u32 dst) > >> +{ > >> + if (WARN_ON(!ept)) > >> + return -EINVAL; > >> + if (!ept->ops->set_flow_control) > >> + return -ENXIO; > >> + > >> + return ept->ops->set_flow_control(ept, enable, dst); > >> +} > >> +EXPORT_SYMBOL_GPL(rpmsg_set_flow_control); > >> + > >> +/** > >> * rpmsg_get_mtu() - get maximum transmission buffer size for sending message. > >> * @ept: the rpmsg endpoint > >> * > >> @@ -539,6 +558,8 @@ static int rpmsg_dev_probe(struct device *dev) > >> > >> rpdev->ept = ept; > >> rpdev->src = ept->addr; > >> + > >> + ept->flow_cb = rpdrv->flowcontrol; > >> } > >> > >> err = rpdrv->probe(rpdev); > >> diff --git a/drivers/rpmsg/rpmsg_internal.h b/drivers/rpmsg/rpmsg_internal.h > >> index 39b646d..b6efd3e 100644 > >> --- a/drivers/rpmsg/rpmsg_internal.h > >> +++ b/drivers/rpmsg/rpmsg_internal.h > >> @@ -55,6 +55,7 @@ struct rpmsg_device_ops { > >> * @trysendto: see @rpmsg_trysendto(), optional > >> * @trysend_offchannel: see @rpmsg_trysend_offchannel(), optional > >> * @poll: see @rpmsg_poll(), optional > >> + * @set_flow_control: see @rpmsg_set_flow_control(), optional > >> * @get_mtu: see @rpmsg_get_mtu(), optional > >> * > >> * Indirection table for the operations that a rpmsg backend should implement. > >> @@ -75,6 +76,7 @@ struct rpmsg_endpoint_ops { > >> void *data, int len); > >> __poll_t (*poll)(struct rpmsg_endpoint *ept, struct file *filp, > >> poll_table *wait); > >> + int (*set_flow_control)(struct rpmsg_endpoint *ept, bool enable, u32 dst); > >> ssize_t (*get_mtu)(struct rpmsg_endpoint *ept); > >> }; > >> > >> diff --git a/include/linux/rpmsg.h b/include/linux/rpmsg.h > >> index 523c98b..a0e9d38 100644 > >> --- a/include/linux/rpmsg.h > >> +++ b/include/linux/rpmsg.h > >> @@ -64,12 +64,14 @@ struct rpmsg_device { > >> }; > >> > >> typedef int (*rpmsg_rx_cb_t)(struct rpmsg_device *, void *, int, void *, u32); > >> +typedef int (*rpmsg_flowcontrol_cb_t)(struct rpmsg_device *, void *, bool); > >> > >> /** > >> * struct rpmsg_endpoint - binds a local rpmsg address to its user > >> * @rpdev: rpmsg channel device > >> * @refcount: when this drops to zero, the ept is deallocated > >> * @cb: rx callback handler > >> + * @flow_cb: remote flow control callback handler > >> * @cb_lock: must be taken before accessing/changing @cb > >> * @addr: local rpmsg address > >> * @priv: private data for the driver's use > >> @@ -92,6 +94,7 @@ struct rpmsg_endpoint { > >> struct rpmsg_device *rpdev; > >> struct kref refcount; > >> rpmsg_rx_cb_t cb; > >> + rpmsg_flowcontrol_cb_t flow_cb; > >> struct mutex cb_lock; > >> u32 addr; > >> void *priv; > >> @@ -106,6 +109,7 @@ struct rpmsg_endpoint { > >> * @probe: invoked when a matching rpmsg channel (i.e. device) is found > >> * @remove: invoked when the rpmsg channel is removed > >> * @callback: invoked when an inbound message is received on the channel > >> + * @flowcontrol: invoked when remote side flow control status is received > > > > s/status/request/ > > > > Regards, > > Bjorn > > > >> */ > >> struct rpmsg_driver { > >> struct device_driver drv; > >> @@ -113,6 +117,7 @@ struct rpmsg_driver { > >> int (*probe)(struct rpmsg_device *dev); > >> void (*remove)(struct rpmsg_device *dev); > >> int (*callback)(struct rpmsg_device *, void *, int, void *, u32); > >> + int (*flowcontrol)(struct rpmsg_device *, void *, bool); > >> }; > >> > >> static inline u16 rpmsg16_to_cpu(struct rpmsg_device *rpdev, __rpmsg16 val) > >> @@ -192,6 +197,8 @@ __poll_t rpmsg_poll(struct rpmsg_endpoint *ept, struct file *filp, > >> > >> ssize_t rpmsg_get_mtu(struct rpmsg_endpoint *ept); > >> > >> +int rpmsg_set_flow_control(struct rpmsg_endpoint *ept, bool enable, u32 dst); > >> + > >> #else > >> > >> static inline int rpmsg_register_device_override(struct rpmsg_device *rpdev, > >> @@ -316,6 +323,14 @@ static inline ssize_t rpmsg_get_mtu(struct rpmsg_endpoint *ept) > >> return -ENXIO; > >> } > >> > >> +static inline int rpmsg_set_flow_control(struct rpmsg_endpoint *ept, bool enable, u32 dst) > >> +{ > >> + /* This shouldn't be possible */ > >> + WARN_ON(1); > >> + > >> + return -ENXIO; > >> +} > >> + > >> #endif /* IS_ENABLED(CONFIG_RPMSG) */ > >> > >> /* use a macro to avoid include chaining to get THIS_MODULE */ > >> -- > >> The Qualcomm Innovation Center, Inc. is a member of the Code Aurora Forum, > >> a Linux Foundation Collaborative Project > >>