From patchwork Wed Feb 14 07:04:32 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Armin Wolf X-Patchwork-Id: 200837 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:bc8a:b0:106:860b:bbdd with SMTP id dn10csp1035462dyb; Tue, 13 Feb 2024 23:06:53 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCUHUl4l3vqtKBQzlI9NKQfYffOuLPUb4cytMybBpnUvAV+qycUvjNADwMBsm/xOZIvzB5nAIjx4358/TmGyNMvfDLPt2g== X-Google-Smtp-Source: AGHT+IHUC29qsYb7UmQM1I+9kVt9t9Q6dtvO8lo6aXkqnWmmgemJWKUN6ngFsMWqOlVkq/IcGxL9 X-Received: by 2002:a05:6870:d623:b0:219:f490:a7a5 with SMTP id a35-20020a056870d62300b00219f490a7a5mr1767354oaq.45.1707894413241; Tue, 13 Feb 2024 23:06:53 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1707894413; cv=pass; d=google.com; s=arc-20160816; b=hSRa1nl88ilLZyfIG/nhJe9BbzeYM0iGlAYyJy2pVugn7zZyIDyTy+dfJ6CEkawDo4 JCDohoM44rdc2xxchc+y9FSSAoYp1HVn3+4hcLSPognqoV0D9mcUoqEUSihudx3B6nRs rnz2ytGPgkBvEtdA0FWO7H6FTqlBFbhdcTNVF4bczDyjtR67JrvRUGpx0yVI/6e/yqJE RSTa+p5tVbUX0ow8T01evquzowNGr1OBrOiHmpXSWxGMZFKrXK8Ji8F4PsAdp4YJcNS+ 8baMFKGNrQHUg72G9AVM+oBlYF0I8tj93WfFMLBoXFkGerolG3v5lWlIqDRMW2sqITOq kO1A== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=ui-outboundreport:content-transfer-encoding:mime-version :list-unsubscribe:list-subscribe:list-id:precedence:references :in-reply-to:message-id:date:subject:cc:to:from:dkim-signature; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; fh=PGLoma5U7rMgfmaTr38ubG/C/gniXsstRxtnUVbCqZU=; b=aDPHzbVmFXqVzzpvVB8bCoPsMCYIXZZr6mfTcsI6a9vQITRbNfOJpdkgIjOuPltoAB +x0AXucwpYZwcgrGVhH2alfuXeAhRvU1OGdJwEr2o/WBCz00lmj9zvzKrc9zU9FKJ6NO aSg7UApZ0zAY/9gyuFiEYhVXxJ5Z61FtHbUU6c6/so1snpHIuH1+Z4F89fSG/ujEjK6H UGVWUG3zfuKjddSdalnX0JwfmUujFpMVR2upU/Rtt4SKpCmEpr9aWuTf63VgvkCqueXK VViGwosP69IfIg2cX60CCN0pxtYSUJZVsKmD9ElO4N+CaxSxeR7wMJhoIY3xTg+qlpzE Q5mg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=VKujJ4Vy; arc=pass (i=1 spf=pass spfdomain=gmx.de dkim=pass dkdomain=gmx.de dmarc=pass fromdomain=gmx.de); spf=pass (google.com: domain of linux-kernel+bounces-64822-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-64822-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=gmx.de X-Forwarded-Encrypted: i=2; AJvYcCV/RMNoJRnhtTxFCBRZScuaBO61X9+FTIgNeSxIfcPQrGEiB2UYVMD46pxtug6nCrYZsMx2Lj+LzJeFVOaQ0K5x+Yh98g== Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id m29-20020a63711d000000b005cdfb84720fsi3282286pgc.857.2024.02.13.23.06.52 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 13 Feb 2024 23:06:53 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-64822-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=VKujJ4Vy; arc=pass (i=1 spf=pass spfdomain=gmx.de dkim=pass dkdomain=gmx.de dmarc=pass fromdomain=gmx.de); spf=pass (google.com: domain of linux-kernel+bounces-64822-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-64822-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=gmx.de Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 8DA06286C7F for ; Wed, 14 Feb 2024 07:06:06 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 02F9116419; Wed, 14 Feb 2024 07:04:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmx.de header.i=w_armin@gmx.de header.b="VKujJ4Vy" Received: from mout.gmx.net (mout.gmx.net [212.227.17.20]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 606BF111BE; Wed, 14 Feb 2024 07:04:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=212.227.17.20 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707894295; cv=none; b=LBOZHCMaR641gTO9Veg8MjPvj4+kePgqP5uInBQUZyKhmKFG+kCXMq1E4S/jVQuGsBWtgb1mJu633YOP7BZE8nAU031P//lZtjG7m5aqVTKcaBhtKuytu5pfDCCicTHSWefHt3ZTRAj2m78obKN/0pjgZRtQ2LFwXju8soyj3YA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707894295; c=relaxed/simple; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=L6iCeoJnibiqu0i7nHXcSS8p4R/Aw+bV+ZEKiaxfcy4WllgAe7eHv8iakmOTq7lzohyFjHIuBXgY2erxYAqF6Zi+vhlE3LwtsvYqqZUh7a4OK9y9xCR2YyNmSFFXFbprpR/SyhxZIXy/5+aadUdolHeosK6uUK4ydrXfk1aVjYA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gmx.de; spf=pass smtp.mailfrom=gmx.de; dkim=pass (2048-bit key) header.d=gmx.de header.i=w_armin@gmx.de header.b=VKujJ4Vy; arc=none smtp.client-ip=212.227.17.20 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gmx.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.de; s=s31663417; t=1707894282; x=1708499082; i=w_armin@gmx.de; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To: References; b=VKujJ4VydpfQlZJyHHf0w5Ig9CSIgulNK1w/eSsDseTXAI1rmDcXim3TDHHUNzP1 quIe6g7hlGlskRtSGev5CbJ0munBdymTMAl1QBmop+o9x8+m1vsYOCyEmbYltpf0m rT9ZoR15nYdqqzrNi3XvBpujnE7PvausvV8HRQ1priDiuZz/pdIyzl/nqGe2ro+lA v1jUw0ruKmwVnZyFTevw9nE8DNdX0hnIrsJiQPA/AT1PnEs2IMOyKVu224FWMry3n R0sJ3HTKwfAn7OxM5e/RWMMcFEqpx7c9d3mobPBg3lvi39rNFZk17EWyUQuZ47al8 /wilx0aqBdwW+MT5Iw== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from mx-amd-b650.users.agdsn.de ([141.30.226.129]) by mail.gmx.net (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MIdif-1rmVGp3JX3-00EgDZ; Wed, 14 Feb 2024 08:04:42 +0100 From: Armin Wolf To: corentin.chary@gmail.com, luke@ljones.dev Cc: hdegoede@redhat.com, ilpo.jarvinen@linux.intel.com, platform-driver-x86@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/5] platform/x86: wmi: Update documentation regarding _WED Date: Wed, 14 Feb 2024 08:04:32 +0100 Message-Id: <20240214070433.2677-5-W_Armin@gmx.de> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240214070433.2677-1-W_Armin@gmx.de> References: <20240214070433.2677-1-W_Armin@gmx.de> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Provags-ID: V03:K1:dbO3uuwlKIrxeUIUm3YJzFs4CKaDxi5uNObhcAbIaZAAhlvg2+e K49uGcVWqc+0jsJ21zYCSuD1gvfnGOaz/lavIp5EJULuqlPOczxezNcmqmORkKPHcR4ilqf DYgO6ZWELDGwQmt2ecVzc3AnhsU3gW9z/YcaT61sf0G+XTa0JWoUK17BEjNx6ig0bNxUiXd ofKrinCBS1ZgYahqKjrfQ== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:r5GjNjsGBWg=;fOr3OJzvZTvySH0j/QmwI8IVq5r gNFXAX765DlnQm182+sLNzCRCTyorUNwUFnogA2J9gkmGwO7lr5cKv9eoRX86Pt+5HeTPzHSI 17dIyKC7r+PtRXFwYN/GZ+77CuJ0QLm5DiUQbcS0bjiSG++4UY0Ie69kISTSNFAl7ZV3clQ/U mLe7g9jTkNqjU7lBFtwtmt7121HXXZq/K90LteNrbE2/uF2E6NuemcVRBmEudfkNrIOPWBlCc jcTV4LpIfCoIV6d1vf1sXKOLf57Kn7wsuiN1wu58TJN7JhdZ0WEMClAvOuerbdLO4NSoLoQBA NPOldYZwuSuucp6bbH/WR7tjWOsidbbdSomWqkqo5yaxDwTtOYMDc2sBUtnb59E9bO77oltdG Vv16sJZ0oN4F9J1j8p+Q5YRgSelH7DJAhv5YBWbYd6FDBl1Syi9uBGdviqLXue8pxtFZyFmeB 2l/hWCpCtJd5F9tlxntRq8sTpv/V6eY9+v6mwG4UYwZcJ5oryY0ONgEQtNrN6CGj01UVFFt6t F/fH2K3SL6m5YQUUBoTPdztzR8qbaxy4fZRwRf3TgczpwLoTCNZSY10te09k0OWEJToH8O1D+ 5ivOMiFCUaMiocgXUwMw6UtF46rZIH10IgsDCcg6QW8gVHc4AL8PdTb4St1iwJ41eDJFzHwA6 2W+RfsetBm2Vl1dgM/e+Htl6NAOouJv3HV20V48gGKiVuJBUh2MPGUHqmrI/UalA8avzdObLK yfBCdmOVNaWvu/CShBz/OM2KLDsgFjsoy/OI0tFeDAoVEFm0RfQDM1O7QgMw/2YtM1Zi2L5lv SVCjuNnFEzhOuKzMqVLksEQSnjDBXVJVJiHUuIZS9Ig/c= X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1790857092042244111 X-GMAIL-MSGID: 1790857092042244111 Update the WMI ACPI interface documentation to include the fact that _WED should be evaluated every time an ACPI notification is received. Signed-off-by: Armin Wolf --- Documentation/wmi/acpi-interface.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) -- 2.39.2 diff --git a/Documentation/wmi/acpi-interface.rst b/Documentation/wmi/acpi-interface.rst index d31af0ed9c08..06fb7fcf4413 100644 --- a/Documentation/wmi/acpi-interface.rst +++ b/Documentation/wmi/acpi-interface.rst @@ -93,4 +93,7 @@ _WED ACPI method ---------------- Used to retrieve additional WMI event data, its single parameter is a integer -holding the notification ID of the event. +holding the notification ID of the event. This method should be evaluated every +time an ACPI notification is received, since some ACPI implementations use a +queue to store WMI event data items. This queue will overflow after a couple +of WMI events are received without retrieving the associated WMI event data.