From patchwork Mon Feb 19 11:59:18 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Armin Wolf X-Patchwork-Id: 203025 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:693c:2685:b0:108:e6aa:91d0 with SMTP id mn5csp1233191dyc; Mon, 19 Feb 2024 04:00:55 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCUFsfSH3TqxoFz5DiL/hdwpm8BRi5yAsCXfqnWLOZCHtaICosrD0tGNcZ1XKvBZVZ8pYV5mEf5BBzyMkqDqsFkfDk/sUg== X-Google-Smtp-Source: AGHT+IE2KYd5162m6aQYTLw6HvwW6EZmwAGdT9rbQ/S0geIFTvfKxDuXpkP805lomy9YDBPBq3VR X-Received: by 2002:a17:906:b791:b0:a3d:5271:2b2d with SMTP id dt17-20020a170906b79100b00a3d52712b2dmr8091121ejb.65.1708344055653; Mon, 19 Feb 2024 04:00:55 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1708344055; cv=pass; d=google.com; s=arc-20160816; b=cNAJHbl8DmpGEjxK65W3Bo8uqZ2yfk4/VL9hO9Fj3vkt0gEvNdwZdEho+sC4EH8q/+ +4sXnSmjNi9SFW7xtCd0eleoGVHhLP+NxwZbz6FwUIDhyyfKKM4pvSWx5DUuibpUryRc wu804jLPTZn43xuetQOX8H7unMe8G6Xz8DXIYkEUW9k00g//vHBj2ygNUcG8aXDUTq+q or9/A2wlsw8AROg/CWjCLDwZHjLVQMsyJSjyUb2VH4ODc75WYwl08pP5eKdq/3kgKCVF br5BJPcQBo77mTIiDApf1ThA398R/G8QiGfA+pUiYRyuZPF9r1NtLbSXTK+IRt+eJ+v/ GKCw== 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=53tDE54uAbGWTgaegrI/oOrsTh38Ao2IXD0IrA5mCUE=; b=cQn4Gksfwn6PTfucqzc+92j26dR80hWRbe9TNZ2vN3tJISJeUSLiDWRImpesN5RH+1 onzBGA+FVR+LRWIxiSKhwaVS4v/2854WxB0l0AjWq8W94zPfAIpz8F25wfvcnYdjJGqv mYpoxKDkSyB6jxotoIF9N43RBtcN30MNr+6B/jui8BDENC8/xVLuQXArwvjqm1k7Hl+T ojT/Ni5iriMVKlVPoZMBkUG7FrkeYD6+mpmrMtSg361YocBjMkYsXP2gMLv0U/uNG7h7 lnGjCIKBeMyeE8uXcyTkRol1KnH29nvhPKTjdRSJFbG6TI6JxAM27LRZL4pwVwixX5lQ fWoQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=EmTgCLO2; 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-71266-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-71266-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=gmx.de Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id kl10-20020a170907994a00b00a3e73c92596si1174070ejc.171.2024.02.19.04.00.55 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 19 Feb 2024 04:00:55 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-71266-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=EmTgCLO2; 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-71266-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-71266-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 462CA1F21E72 for ; Mon, 19 Feb 2024 12:00:55 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 8E7B233CD4; Mon, 19 Feb 2024 11:59:45 +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="EmTgCLO2" 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 C614B2E405; Mon, 19 Feb 2024 11:59:40 +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=1708343982; cv=none; b=hmA4X9xA/50UX0vQ0si7+IyIuCPOhRV1WD7kLSHklRxDdCkAbJ/ZW3sI8/pjnST30tQrvGVobobTHcHylnvBsuW7dcvXYO8mnjrw8FUGvrXX4ZguW97JfqpOM3GXrOaLQyMvPz9faQ4CQ3PbuAQqyZTqAYP4F4UuBewS0dKNDos= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708343982; c=relaxed/simple; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=N7nr46yG16C1YEDo5GqpdVXMYp0iG4YPiAPV219dydC6doPCtlbGuUSqCGtyED//KcXmCJaWa8ZewthdAYokoJSL8n+DIDALtXYTd04OmQexkswD6VW8wGaYRvQA1H318RKGxSAAzLY7hDiAPHcyJKuXbbYfUHZKWXQI4cqdSi0= 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=EmTgCLO2; 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=1708343971; x=1708948771; i=w_armin@gmx.de; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To: References; b=EmTgCLO2wSkDlsTcGb7KzGMNJBIjQJA7HdTi8wQZlcl2x2ZlyWZHqh2nTRE+9nHa duLFAjlPMpSnAz5eT5XKuHKOKB2oyXADJ2cQxPSGvDCSkkb74fGOyE7MOVADf/Jmm r3K3sb6MBkW6lfA5xlP8cTRXYHR7KbD3At/wmM9/6X3zXHFthYAcPDlBOP6xd1vKd oQlCeEw+tztsFCHcFavp1AMJa4wh+SjGRNPByzdcl+5Tfblf6QmQ0neEa9h+8lVR1 S/JqGwY0YANiJ5b3UrrDpFHEywR3/nW5erG6dDdQfnkyi7oMkufdfuDV/JnYTn/60 HQFG15unTEhPPlyy1w== 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 1N17UQ-1qvnXl2og6-012XiL; Mon, 19 Feb 2024 12:59:31 +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 v2 4/5] platform/x86: wmi: Update documentation regarding _WED Date: Mon, 19 Feb 2024 12:59:18 +0100 Message-Id: <20240219115919.16526-5-W_Armin@gmx.de> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240219115919.16526-1-W_Armin@gmx.de> References: <20240219115919.16526-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:HVa15Z2LrHiydE7egWuwmvdECI1Tv1ZQ4wpN3HEd4/nYZH066wW 6rSrrp1W7tjcnHIFkdtKe1fK1O2U0hrxiukCjwvvFX5RsyR742wCAH81sE/atj1I+FtCWG8 5pCq3lvrnfiGk1QzXXaPl8b0MaZqe+uhXBz4R6AugdZixXijUl1v37OCbLAfFGUnIrvvEyJ Ier5ZaABptv+RqAwnD0MA== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:hkUeSe5q1/k=;jg/Rfqe6pDRd5XWkin84hm86CfJ /EHlUVVNaQOTFfJTVPcgDK9MYH7yLhR5n/H3Ho6et9/euvbQNBq0op72oMmyxmcNnzyWJ9afE EcP8mUtazAH3WAtCT75dpP47HHHtb31VKQY/2qfeflVIYYXIZ8CiL1wp2Uxyz1E/uCIH8YqhT fK0L/vm2Nzxm7Qben1bwMMBeuFrMQcf09eQ1c6IwpOxY9PGjk58kd2mMGx0JZS5nYhtFnnEIX hfGNLAZQkc5nsI6qXKIEoyG79DmAcg0ZPsFeQw0yg1l/Og/iKcAFGRHePQjpuqZBrE+0XWIYE i5MueCxE5mkB6VXZG1lFxPOClRZc0dmcn0k84TQPe2NMvcdi8/72jKjjHejsVoB2RtVlqO13N gxF6jCpKQ07h9zsqwQtpjyR34eDE+J2dAkfiJFT/cgc9LCJbIJ5RbjpPSIn+yYgGeFy3eo2J1 mpDdwgleJ+UMYcZ3bpiYqmmQdEANFn+SIoP8gEm+bWgBa2GAKlj13sALw2wsgiMDUpE3ajI+o iqw+kqxqV8P0Jm3+1NW+tzm0ru1Gmnf//Kk65z1n4pOMSOOwIYB65DGr5mDbk0KZqSq3uGx/e Sy7vOSJIHm1MNF+UFNsMUAnnNP1ORM4zLozedPKJ9yf9ZVnNKSQeSEvRHXvrLyzOR9BpdPtm3 X/eGU1aXTEqZlRmzi47nEJIE1OJv7npeY3tnM2uYXl7uRExbZF0uPkqzW5bsGgm7SpHDHNPgl Tg5sES+L3JJo/KhfEX38MkQYxIXSNTR6weuvsLOHgst9DeP5z4RjNn/Q8DnHB9EPUxMG9OQrd heqt/6eMzvqpuNriGw8jgIF0RbZrGELSeG1atJspnRDac= X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1791328576173305681 X-GMAIL-MSGID: 1791328576173305681 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.