From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131]) (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 6BD2735C6A2 for ; Fri, 21 Aug 2026 15:40:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787326830; cv=none; b=LdkB9OcDKAomUcB0SzOuYVtsQmDEs+0QEBsV2EU76f1nqqp+lZUdI8J6bYTRDA8pxUHUilVvZye/yEPfZwChv4PR0B6F664SUNS2gOgJa2MPIRi1ABrmo6OmAYaXKUwECDpPfWU057L5wskqQ4s6Lmz/GRWs+IvuxuciR7xKJnY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787326830; c=relaxed/simple; bh=VJF6Lc+wvuhwwUZ5wyL5elyVGsjfwYxjyDBU4SiQ/j0=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=mbrkzy2lbQc1cPSTmha4YFv2vfNSyq0hUEwC2Qf+x6pyPYF/VbpAP6HZgLDksGxlyl5w0VChDlgYspVfCypmMS19+YP9HmVPdXDL575GPSGWZCsKPQslX66S8gDrWlqCZdNKYsest5tcUDc1LSJ4tqCFN2eWtfn8mN8FFBtwCgg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=ONTHvUhH; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=TpH6Ka1r; arc=none smtp.client-ip=205.220.180.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="ONTHvUhH"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="TpH6Ka1r" Received: from pps.filterd (m0279871.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 67LCoY3J2783253 for ; Fri, 21 Aug 2026 15:40:21 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:date:from:message-id:mime-version :subject:to; s=qcppdkim1; bh=0Q7GiUt40Eatw9r3S8IuomLGZZsRqDzMMhg kiTbs1T8=; b=ONTHvUhHQb+0k0oStm0KGe9cZjo33ZZyosHPPor/UP4gbip+TlY W+Hh9ZOFoGXMHf7bvio25ZdtmVjy2KkdnvJwh0en+QGbRuo/JEWupwMxdmAuW7H6 VO7TIp7ezCVkS8Oyq0XzkwbsXmxZogLqLv1WOHnB54BGDc3lYpltiAxoIxjutFHM 2eN6qhIxKelauDGkkrVK4mt+5R8CSh9D8NsaMF+zEsz6oQsNJrZ2MJWA6wctNeFq UUovbWi+osTg2VebU4RNsdp79KMJ8wDy+dIOMy+/WAVeJon6x53AO5Yiq20jsmGa h0vLlMgxs2Q2wG+2eeXR/HtLq6/StVMXIfQ== Received: from mail-qt1-f199.google.com (mail-qt1-f199.google.com [209.85.160.199]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4g6gdf29ax-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Fri, 21 Aug 2026 15:40:21 +0000 (GMT) Received: by mail-qt1-f199.google.com with SMTP id d75a77b69052e-51c07f25de2so8456211cf.3 for ; Fri, 21 Aug 2026 08:40:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1787326820; x=1787931620; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=0Q7GiUt40Eatw9r3S8IuomLGZZsRqDzMMhgkiTbs1T8=; b=TpH6Ka1re0eiG8l+zsLXJyK+DbCHtuMOMJMFf1VWHSYWrr3VISpFpPM4f7OG6SbnMD iFPGpRTR6Y0OAyeNUJhkxVMCjTX/sLW9yQMATStU69zh5HSdd1KkingZpPwW3T0r5BPu oqhkVnL3P5ObZiiVD/SX9yN0vfJDPBMjIBW9iCtSEKVdoQwjTDr9v5eE+MZRlZ23o1Gc dOfK1pkwsSbujemuMeM2qp+oTh97g/wjMA/QTNFaP/TLW9KdPaKeOC9RN48j2pqS/drV BkAHkg5BAi66fTqqAHnb+1ujSkJb3MO8Tob9ruthE5c7MGBlbGsfZoqW95zENk97DJbv 0fug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1787326820; x=1787931620; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=0Q7GiUt40Eatw9r3S8IuomLGZZsRqDzMMhgkiTbs1T8=; b=cN47m5IErLoOChJJS/cgcjTRaBR9N3YzRiCIVHh8rDsfdhqqBcPLFKsPVB6hGIQG4q yGM6WWa9SmY25ch9UgacTqvGxGEwc/0WhuGy2JDIHSBh7ywGcL4scL2nnySmhurs+jrh OH2nzuntKYYOt0fo+y9YZnISOTmJ0/avzK+FLIQXb3q0fZHdAcZiYogP52A5tdVmzTCX ZLCxsnPZjy8oVcqvSTOM93SxA5Rck/ymPF9nISJBt0ROMzjjTYT8K8Dl81szjMDAOC8I LrKTAb37ngmm1x3mnRWClTZC1L8tfz5j2ZoFGw0TsMsM8THGumi3r3kV+ILVeY46+iyY twEw== X-Forwarded-Encrypted: i=1; AHgh+RogB7IQbYnLRCnYioaCfV+Vi6Y03VCSU/gV1QHnkWSJSc7CnTjUWlEUHNCH/yMLR6GUsjWDzov4fP1L9pI=@vger.kernel.org X-Gm-Message-State: AOJu0YzzToZY3U/tc/sxT/TrbVKsGVNf+dxtGpCchY4/i+vIW1bdKo3o F7zqgPGoF5h4aoAe4uki08A0fAAaYDy/L4vvTbJaqLLIfdrUd3U+7Tbf6xfHC+gZihLL/MzYRfQ DcdPtq73BB4With1aPnApxFDACpjQGxUhSVLqOJ2hE4Lw7hz8J8ZGh9NBoThFRqXGBHE= X-Gm-Gg: AR+sD13CHzvw2SW3JqSSq5IWg78+JIdxQ/B6nZEhSA67mhwkZW1kKW2Y3pghLAIMOWE UJz2qOTwhGugtkAdcc+cu/WL4IENODV/U2sJoeYMA2TGqZFkw5/sEOyQBj6i9QzhD454ebKq1Ci hKQWr/xDvzzRZwGeIZJ8pB1p0eQHPuXR3N2wHuqR6CWlvgruzmHGHVXBIsAxUicLLKaCSul8jHD hP+QCM5Cy1tIblVCYD+vglxDKjdMeHRHB0PTMssHZ/BysEh8vCeB7GMwXwDAPi1CKx6munb7ywj aGOgsvtiS/uLz3zesGfjmg2U/lwgQ7WdyIxLQs2igXT5vK8Sypi0GHk+z6EAuIyaEc2UmzQE35i amLaDIgyayFF05LPVLIOgUc0fpxsw X-Received: by 2002:ac8:5745:0:b0:51b:fcb4:7576 with SMTP id d75a77b69052e-52df5739ac0mr66610601cf.15.1787326820421; Fri, 21 Aug 2026 08:40:20 -0700 (PDT) X-Received: by 2002:ac8:5745:0:b0:51b:fcb4:7576 with SMTP id d75a77b69052e-52df5739ac0mr66609891cf.15.1787326819936; Fri, 21 Aug 2026 08:40:19 -0700 (PDT) Received: from mai.box.freepro.com ([2a05:6e02:1041:c10:7d20:e20f:a77f:4ef7]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-482b14c338dsm14640533f8f.25.2026.08.21.08.40.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 21 Aug 2026 08:40:18 -0700 (PDT) From: Daniel Lezcano To: Sebastian Reichel Cc: Daniel Lezcano , linux-pm@vger.kernel.org (open list:POWER SUPPLY CLASS/SUBSYSTEM and DRIVERS), linux-kernel@vger.kernel.org (open list) Subject: [PATCH] power: supply: Fix power limit documentation Date: Fri, 21 Aug 2026 17:39:49 +0200 Message-ID: <20260821153949.2914201-1-daniel.lezcano@oss.qualcomm.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Authority-Analysis: v=2.4 cv=CsqPtH4D c=1 sm=1 tr=0 ts=6a887165 cx=c_pps a=WeENfcodrlLV9YRTxbY/uA==:117 a=xqWC_Br6kY4A:10 a=Sv0fKeRqtYgA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=3WHJM1ZQz_JShphwDgj5:22 a=EUspDBNiAAAA:8 a=VwQbUJbxAAAA:8 a=arXYI40Hz2FkRTtgrrYA:9 a=kacYvNCVWA4VmyqE58fU:22 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwODIxMDEyMiBTYWx0ZWRfX7einQz/WEzbr ab6N5ew2LsStH6pjO6T+Iohj4BzbvqJqV6/vqndgqVGYPw4gu3wCdnbSkhGAndJHpPnXX6mi8WN GDgxspOwW8NV5IryoODpni4lL3Eb9aEQMwOe9ZvD3UVuAKJgCkE9hxVTHaRPM7YqFgD9t005ccu +FYkuJ6EzmMRD/RMffBMdKb0h2T15QBsaQv8FWsDe5U+su42kYKpP7Bvug3tziIzBtnUHgl3ngL qU2g3KvLiwl4qgDf6Odv/ofMBDJJrRYAYmFskBJFfqWUsyOSiZidOwScDvri9xlc3ReVyR3+OmY SBDTQb4YGCMByy6G0nJuhle8ZY4urUD0CEpLfD2E0eBz6qsDBPVzdEKoLVUvnmJaZ9jTabsxYw4 LXzMD4FmMnTElZ7tkvGOrKOC/cb7EUCjk0bdMfxYRsfwpykCX2PUMYqb+ANewUBwMdXsKM4DIAJ ulNRG1aVMUnRfGGsZQw== X-Proofpoint-ORIG-GUID: C_-wgkixP9ZLWNfzabvLZCWgsSdxTCUd X-Proofpoint-GUID: C_-wgkixP9ZLWNfzabvLZCWgsSdxTCUd X-Proofpoint-Spam-Info: AW1haW4tMjYwODIxMDEyMiBTYWx0ZWRfX+5+ZSMF5TeI2 VzZP/AgzKIuM9RDUKlHK9A789Y2ByqoZo3x9MOmJ7QXiHnpDS/OsMV2YJZqpO29f/fXo1O1N0ng /wsr3NuPjSv9F9o1rW4GuIee+6A+h+w= X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1176,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-08-21_04,2026-08-21_02,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 impostorscore=0 spamscore=0 lowpriorityscore=0 suspectscore=0 phishscore=0 malwarescore=0 clxscore=1015 adultscore=0 bulkscore=0 priorityscore=1501 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2608210122 The documentation for the input current and voltage limits recommends using those properties for problems that can be solved using a power limit. This contradicts the recommendation to prefer input_power_limit for such cases. Similarly, the input_power_limit documentation recommends using the current or voltage limits for problems that can be solved with a power limit, which conveys the opposite of the intended meaning. Fix the wording to clarify that input_power_limit should be preferred whenever a power limit can address the problem, while current or voltage limits should be used when it cannot. Signed-off-by: Daniel Lezcano Signed-off-by: Daniel Lezcano --- Documentation/ABI/testing/sysfs-class-power | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-class-power b/Documentation/ABI/testing/sysfs-class-power index 32697b926cc8..f0ef87d365dd 100644 --- a/Documentation/ABI/testing/sysfs-class-power +++ b/Documentation/ABI/testing/sysfs-class-power @@ -600,8 +600,8 @@ Description: supply. Normally this is configured based on the type of connection made (e.g. A configured SDP should output a maximum of 500mA so the input current limit is set to the same value). - Use preferably input_power_limit, and for problems that can be - solved using power limit use input_current_limit. + Use preferably input_power_limit, and for problems that can not + be solved using power limit use input_current_limit. Access: Read, Write @@ -618,8 +618,8 @@ Description: input power to 5V when the screen is on to meet Google's skin temperature targets). Note that this feature should not be used for safety critical things. - Use preferably input_power_limit, and for problems that can be - solved using power limit use input_voltage_limit. + Use preferably input_power_limit, and for problems that can not + be solved using power limit use input_voltage_limit. Access: Read, Write @@ -633,7 +633,7 @@ Description: in the supply. Normally this is configured based on system-level knowledge or user input. Use preferably this feature to limit the incoming power and use current/voltage - limit only for problems that can be solved using power limit. + limit only for problems that can not be solved using power limit. Access: Read, Write -- 2.43.0