From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Cyrus-Session-Id: sloti22d1t05-1286548-1524492865-2-13822288438695723151 X-Sieve: CMU Sieve 3.0 X-Spam-known-sender: no ("Email failed DMARC policy for domain") X-Spam-score: 0.0 X-Spam-hits: BAYES_00 -1.9, FROM_WORDY 2.5, HEADER_FROM_DIFFERENT_DOMAINS 0.25, MAILING_LIST_MULTI -1, ME_NOAUTH 0.01, RCVD_IN_DNSWL_HI -5, LANGUAGES en, BAYES_USED global, SA_VERSION 3.4.0 X-Spam-source: IP='209.132.180.67', Host='vger.kernel.org', Country='US', FromHeader='com', MailFrom='org', XOriginatingCountry='GB' X-Spam-charsets: X-IgnoreVacation: yes ("Email failed DMARC policy for domain") X-Resolved-to: greg@kroah.com X-Delivered-to: greg@kroah.com X-Mail-from: linux-usb-owner@vger.kernel.org ARC-Seal: i=1; a=rsa-sha256; cv=none; d=messagingengine.com; s=fm2; t= 1524492864; b=XYDtnj4/duzwDh/o6wtr00GPjcYYXuc+C79cH/Bj1iqZ+SJZ5H DceRN50kb0ufYRBCHX42Og3BpdZhL1Xsiqn+4A5XXwYbyB7MZEIE/+EztlEI4mbp M/x8Xk7XwBe9zwZ0xWvAEWFHKQSzWM3/x1Q0ibKv7iiJ4yyUEELt9Fp+NkHIERBJ uoz0KpZXngSXoI+9j5xBTU5yMNd1r0uB0w5nbBEfLJ1ZP5eodKBRRGg+2Ic5Cvnx fqYzhPTBQ0ESN4rhG7ze0Qn09wpjNfBQXk3UyWY+jSfKN0U6agW8LaIkHL9nxdQy CbBYPFtD+rCG+KXw5kxesEHp4XpJCMHFHDUg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=message-id:in-reply-to:references:from :date:subject:to:cc:mime-version:content-type:sender:list-id; s= fm2; t=1524492864; bh=mrE3EzwzDTd/c3dljp1V78wu15SdxlPbAtoqQw/Vom c=; b=dT47e+7FJUYO17sRE36yyNz6NOg3KjhpoxLq9IDkSxjURZ6uU6HoPvwGre 7midxHz/XsreV8MIdIVcgAK3Y6bujL86yckJQW1AeL/w/9iOxcqvzoY008NtDWTa IL9NxBztXU3AR0Fc3v7/KHFHh3eUGXupTESC/HH6A5DcPB95C1wj2TDYZtPR0hSo luANhS+1DiVawF47HNjGS3YAg7P4wRqVwQ5VAyoJBvRSRTYlXpdUmnLcMMGgW+lS Eoej2wyUwTZUhPOxlzyP/SK0E0hCz2jyUMmi+3gymUAcIk5/fAVBQ3V/YZ+5Hep2 B0Zc+bczrKAFtyzAPZwoGjAcqdyg== ARC-Authentication-Results: i=1; mx4.messagingengine.com; arc=none (no signatures found); dkim=none (no signatures found); dmarc=fail (p=none,has-list-id=yes,d=none) header.from=diasemi.com; iprev=pass policy.iprev=209.132.180.67 (vger.kernel.org); spf=none smtp.mailfrom=linux-usb-owner@vger.kernel.org smtp.helo=vger.kernel.org; x-aligned-from=fail; x-cm=none score=0; x-ptr=pass x-ptr-helo=vger.kernel.org x-ptr-lookup=vger.kernel.org; x-return-mx=pass smtp.domain=vger.kernel.org smtp.result=pass smtp_org.domain=kernel.org smtp_org.result=pass smtp_is_org_domain=no header.domain=diasemi.com header.result=pass header_is_org_domain=yes; x-vs=clean score=-100 state=0 Authentication-Results: mx4.messagingengine.com; arc=none (no signatures found); dkim=none (no signatures found); dmarc=fail (p=none,has-list-id=yes,d=none) header.from=diasemi.com; iprev=pass policy.iprev=209.132.180.67 (vger.kernel.org); spf=none smtp.mailfrom=linux-usb-owner@vger.kernel.org smtp.helo=vger.kernel.org; x-aligned-from=fail; x-cm=none score=0; x-ptr=pass x-ptr-helo=vger.kernel.org x-ptr-lookup=vger.kernel.org; x-return-mx=pass smtp.domain=vger.kernel.org smtp.result=pass smtp_org.domain=kernel.org smtp_org.result=pass smtp_is_org_domain=no header.domain=diasemi.com header.result=pass header_is_org_domain=yes; x-vs=clean score=-100 state=0 X-ME-VSCategory: clean X-CM-Envelope: MS4wfHSItJHFNWtcogBshjQCdrbITSAZPcxn8arkv4mjQMS4duA8zwCJM0EedHBwriAmZyi2hvTDTjYBFwO7KvzoOyUA0tKNxtSUhaBOw4AnytRCtzZAIqUm dfidKsaq9IfywkJ48ZSbVRzkA8SmYgyq1iJ+P+ZYRRumClVQxAfJADtU5xnx6ckBcIG13cA056WMBCFTVfFxxNfLL1T4R3+JB3GK41QogPLhiHN4HlC+b4Uo X-CM-Analysis: v=2.3 cv=JLoVTfCb c=1 sm=1 tr=0 a=UK1r566ZdBxH71SXbqIOeA==:117 a=UK1r566ZdBxH71SXbqIOeA==:17 a=QRjQRLzp78EA:10 a=Kd1tUaAdevIA:10 a=X3a0BiUdAAAA:8 a=VwQbUJbxAAAA:8 a=1oTnwJ4CJyehrDCbU1MA:9 a=2grzjaLDg0IriL4c:21 a=9upTPQrpya9CoTA_:21 a=d24Ss_oZLtcA:10 a=x8gzFH9gYPwA:10 a=aWu3muFgq6otJbhCXpL5:22 a=AjGcO6oz07-iQ99wixmX:22 X-ME-CMScore: 0 X-ME-CMCategory: none Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755675AbeDWOOU (ORCPT ); Mon, 23 Apr 2018 10:14:20 -0400 Received: from mail1.bemta5.messagelabs.com ([195.245.231.149]:14397 "EHLO mail1.bemta5.messagelabs.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755227AbeDWOLA (ORCPT ); Mon, 23 Apr 2018 10:11:00 -0400 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrGIsWRWlGSWpSXmKPExsUSt3OpsW7hy7t RBvt+m1o0L17PZvHm+HQmi67VO1ksrh3rZbK4vGsOm8Xn3iOMFouWtTJbPFl4hsni9O4SB06P Tas62TzmnQz02D93DbvHxnc7mDze77vK5rHzewO7x+dNcgHsUayZeUn5FQmsGUt2rWIv+F9ec fXYB9YGxsepXYycHEIC6xklPkxhhbArJDr27mYDsXkFMiVurdkCFucUcJfonvSRDaLGTeJy2x tGEJtNwEJi8okHQHEODhYBVYk5JzRBwsICURI/fi9k72Lk4hAReM8o8enxBxaQBLNAnUTv77c sEPMFJU7OfAIVl5A4+OIFM8R8A4nTCxrB4hIC9hLT319lBpkvIaAv0XgsFiJsKPF91jeoEnOJ +4e72CYwCs5CMnUWkqkLGJlWMaoXpxaVpRbpGuslFWWmZ5TkJmbm6BoamOrlphYXJ6an5iQmF esl5+duYgTGBwMQ7GDc+8/pEKMkB5OSKK/l+btRQnxJ+SmVGYnFGfFFpTmpxYcYZTg4lCR437 0AygkWpaanVqRl5gAjFSYtwcGjJMIbB5LmLS5IzC3OTIdInWJUlBLn3QySEABJZJTmwbXBksM lRlkpYV5GoEOEeApSi3IzS1DlXzGKczAqCfO+BZnCk5lXAjf9FdBiJqDFHZJ3QBaXJCKkpBoY I5X//LT3DzE+Ia74+qvuQ1/7oknd9RPWTLUS2Gfw7njMZvNlqVeUb774msWzOHdD4b/wCffyQ ta4nw7WufIgVYLz+OKbCu7dRwMOV+3kWB2xNz6t7vsmX4GyLH/5frZ7ohZcV82NMx8ldt86LX ZatJZJ+NTK6p2qX+cL7Tknx9/VM/P2V1sfJZbijERDLeai4kQABS33xQkDAAA= X-Env-Sender: Adam.Thomson.Opensource@diasemi.com X-Msg-Ref: server-16.tower-180.messagelabs.com!1524492656!99333180!2 X-Originating-IP: [94.185.165.51] X-SYMC-ESS-Client-Auth: outbound-route-from=pass X-StarScan-Received: X-StarScan-Version: 9.9.15; banners=-,-,- X-VirusChecked: Checked Message-ID: <262928f7cd04c1691c78993520304f036ba207b2.1524490253.git.Adam.Thomson.Opensource@diasemi.com> In-Reply-To: References: From: Adam Thomson Date: Mon, 23 Apr 2018 15:10:57 +0100 Subject: [PATCH v8 2/6] Documentation: power: Initial effort to document power_supply ABI To: Heikki Krogerus , Guenter Roeck , Greg Kroah-Hartman , Sebastian Reichel , Hans de Goede , Jun Li CC: , , , MIME-Version: 1.0 Content-Type: text/plain X-KSE-AttachmentFiltering-Interceptor-Info: protection disabled X-KSE-ServerInfo: sw-ex-cashub01.diasemi.com, 9 X-KSE-Antivirus-Interceptor-Info: scan successful X-KSE-Antivirus-Info: Clean, bases: 23/04/2018 11:44:00 Sender: linux-usb-owner@vger.kernel.org X-Mailing-List: linux-usb@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-Mailing-List: linux-kernel@vger.kernel.org List-ID: This commit adds generic ABI information regarding power_supply properties. This is an initial attempt to try and align the usage of these properties between drivers. As part of this commit, common Battery and USB related properties have been listed. Signed-off-by: Adam Thomson Reviewed-by: Heikki Krogerus Reviewed-by: Sebastian Reichel --- Documentation/ABI/testing/sysfs-class-power | 443 ++++++++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 444 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-class-power b/Documentation/ABI/testing/sysfs-class-power index f85ce9e..e046566 100644 --- a/Documentation/ABI/testing/sysfs-class-power +++ b/Documentation/ABI/testing/sysfs-class-power @@ -1,3 +1,446 @@ +===== General Properties ===== + +What: /sys/class/power_supply//manufacturer +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the name of the device manufacturer. + + Access: Read + Valid values: Represented as string + +What: /sys/class/power_supply//model_name +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the name of the device model. + + Access: Read + Valid values: Represented as string + +What: /sys/class/power_supply//serial_number +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the serial number of the device. + + Access: Read + Valid values: Represented as string + +What: /sys/class/power_supply//type +Date: May 2010 +Contact: linux-pm@vger.kernel.org +Description: + Describes the main type of the supply. + + Access: Read + Valid values: "Battery", "UPS", "Mains", "USB" + +===== Battery Properties ===== + +What: /sys/class/power_supply//capacity +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Fine grain representation of battery capacity. + Access: Read + Valid values: 0 - 100 (percent) + +What: /sys/class/power_supply//capacity_alert_max +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Maximum battery capacity trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery discharging scenario where user-space needs to know the + battery has dropped to an upper level so it can take + appropriate action (e.g. warning user that battery level is + low). + + Access: Read, Write + Valid values: 0 - 100 (percent) + +What: /sys/class/power_supply//capacity_alert_min +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Minimum battery capacity trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery discharging scenario where user-space needs to know the + battery has dropped to a lower level so it can take + appropriate action (e.g. warning user that battery level is + critically low). + + Access: Read, Write + Valid values: 0 - 100 (percent) + +What: /sys/class/power_supply//capacity_level +Date: June 2009 +Contact: linux-pm@vger.kernel.org +Description: + Coarse representation of battery capacity. + + Access: Read + Valid values: "Unknown", "Critical", "Low", "Normal", "High", + "Full" + +What: /sys/class/power_supply//current_avg +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an average IBAT current reading for the battery, over a + fixed period. Normally devices will provide a fixed interval in + which they average readings to smooth out the reported value. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//current_max +Date: October 2010 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum IBAT current allowed into the battery. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//current_now +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an instant, single IBAT current reading for the battery. + This value is not averaged/smoothed. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//charge_type +Date: July 2009 +Contact: linux-pm@vger.kernel.org +Description: + Represents the type of charging currently being applied to the + battery. + + Access: Read + Valid values: "Unknown", "N/A", "Trickle", "Fast" + +What: /sys/class/power_supply//charge_term_current +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the charging current value which is used to determine + when the battery is considered full and charging should end. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//health +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the health of the battery or battery side of charger + functionality. + + Access: Read + Valid values: "Unknown", "Good", "Overheat", "Dead", + "Over voltage", "Unspecified failure", "Cold", + "Watchdog timer expire", "Safety timer expire" + +What: /sys/class/power_supply//precharge_current +Date: June 2017 +Contact: linux-pm@vger.kernel.org +Description: + Reports the charging current applied during pre-charging phase + for a battery charge cycle. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//present +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports whether a battery is present or not in the system. + + Access: Read + Valid values: + 0: Absent + 1: Present + +What: /sys/class/power_supply//status +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Represents the charging status of the battery. Normally this + is read-only reporting although for some supplies this can be + used to enable/disable charging to the battery. + + Access: Read, Write + Valid values: "Unknown", "Charging", "Discharging", + "Not charging", "Full" + +What: /sys/class/power_supply//technology +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Describes the battery technology supported by the supply. + + Access: Read + Valid values: "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe", + "NiCd", "LiMn" + +What: /sys/class/power_supply//temp +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the current TBAT battery temperature reading. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_max +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Maximum TBAT temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery charging scenario where user-space needs to know the + battery temperature has crossed an upper threshold so it can + take appropriate action (e.g. warning user that battery level is + critically high, and charging has stopped). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_min +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Minimum TBAT temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery charging scenario where user-space needs to know the + battery temperature has crossed a lower threshold so it can take + appropriate action (e.g. warning user that battery level is + high, and charging current has been reduced accordingly to + remedy the situation). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_max +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum allowed TBAT battery temperature for + charging. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_min +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the minimum allowed TBAT battery temperature for + charging. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//voltage_avg, +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an average VBAT voltage reading for the battery, over a + fixed period. Normally devices will provide a fixed interval in + which they average readings to smooth out the reported value. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_max, +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum safe VBAT voltage permitted for the battery, + during charging. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_min, +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the minimum safe VBAT voltage permitted for the battery, + during discharging. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_now, +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an instant, single VBAT voltage reading for the battery. + This value is not averaged/smoothed. + + Access: Read + Valid values: Represented in microvolts + +===== USB Properties ===== + +What: /sys/class/power_supply//current_avg +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an average IBUS current reading over a fixed period. + Normally devices will provide a fixed interval in which they + average readings to smooth out the reported value. + + Access: Read + Valid values: Represented in microamps + + +What: /sys/class/power_supply//current_max +Date: October 2010 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum IBUS current the supply can support. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//current_now +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the IBUS current supplied now. This value is generally + read-only reporting, unless the 'online' state of the supply + is set to be programmable, in which case this value can be set + within the reported min/max range. + + Access: Read, Write + Valid values: Represented in microamps + +What: /sys/class/power_supply//input_current_limit +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Details the incoming IBUS current limit currently set in the + 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). + + Access: Read, Write + Valid values: Represented in microamps + +What: /sys/class/power_supply//online, +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Indicates if VBUS is present for the supply. When the supply is + online, and the supply allows it, then it's possible to switch + between online states (e.g. Fixed -> Programmable for a PD_PPS + USB supply so voltage and current can be controlled). + + Access: Read, Write + Valid values: + 0: Offline + 1: Online Fixed - Fixed Voltage Supply + 2: Online Programmable - Programmable Voltage Supply + +What: /sys/class/power_supply//temp +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the current supply temperature reading. This would + normally be the internal temperature of the device itself (e.g + TJUNC temperature of an IC) + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_max +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Maximum supply temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + charging scenario where user-space needs to know the supply + temperature has crossed an upper threshold so it can take + appropriate action (e.g. warning user that the supply + temperature is critically high, and charging has stopped to + remedy the situation). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_min +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Minimum supply temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + charging scenario where user-space needs to know the supply + temperature has crossed a lower threshold so it can take + appropriate action (e.g. warning user that the supply + temperature is high, and charging current has been reduced + accordingly to remedy the situation). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_max +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum allowed supply temperature for operation. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_min +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the mainimum allowed supply temperature for operation. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//voltage_max +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum VBUS voltage the supply can support. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_min +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the minimum VBUS voltage the supply can support. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_now +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the VBUS voltage supplied now. This value is generally + read-only reporting, unless the 'online' state of the supply + is set to be programmable, in which case this value can be set + within the reported min/max range. + + Access: Read, Write + Valid values: Represented in microvolts + +===== Device Specific Properties ===== + What: /sys/class/power/ds2760-battery.*/charge_now Date: May 2010 KernelVersion: 2.6.35 diff --git a/MAINTAINERS b/MAINTAINERS index 0a1410d..700bfb7 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -11242,6 +11242,7 @@ M: Sebastian Reichel L: linux-pm@vger.kernel.org T: git git://git.kernel.org/pub/scm/linux/kernel/git/sre/linux-power-supply.git S: Maintained +F: Documentation/ABI/testing/sysfs-class-power F: Documentation/devicetree/bindings/power/supply/ F: include/linux/power_supply.h F: drivers/power/supply/ -- 1.9.1 From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v8,2/6] Documentation: power: Initial effort to document power_supply ABI From: "Opensource \[Adam Thomson\]" Message-Id: <262928f7cd04c1691c78993520304f036ba207b2.1524490253.git.Adam.Thomson.Opensource@diasemi.com> Date: Mon, 23 Apr 2018 15:10:57 +0100 To: Heikki Krogerus , Guenter Roeck , Greg Kroah-Hartman , Sebastian Reichel , Hans de Goede , Jun Li Cc: linux-usb@vger.kernel.org, linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, support.opensource@diasemi.com List-ID: VGhpcyBjb21taXQgYWRkcyBnZW5lcmljIEFCSSBpbmZvcm1hdGlvbiByZWdhcmRpbmcgcG93ZXJf c3VwcGx5CnByb3BlcnRpZXMuIFRoaXMgaXMgYW4gaW5pdGlhbCBhdHRlbXB0IHRvIHRyeSBhbmQg YWxpZ24gdGhlIHVzYWdlCm9mIHRoZXNlIHByb3BlcnRpZXMgYmV0d2VlbiBkcml2ZXJzLiBBcyBw YXJ0IG9mIHRoaXMgY29tbWl0LApjb21tb24gQmF0dGVyeSBhbmQgVVNCIHJlbGF0ZWQgcHJvcGVy dGllcyBoYXZlIGJlZW4gbGlzdGVkLgoKU2lnbmVkLW9mZi1ieTogQWRhbSBUaG9tc29uIDxBZGFt LlRob21zb24uT3BlbnNvdXJjZUBkaWFzZW1pLmNvbT4KLS0tCiBEb2N1bWVudGF0aW9uL0FCSS90 ZXN0aW5nL3N5c2ZzLWNsYXNzLXBvd2VyIHwgNDQzICsrKysrKysrKysrKysrKysrKysrKysrKysr KysKIE1BSU5UQUlORVJTICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfCAgIDEgKwog MiBmaWxlcyBjaGFuZ2VkLCA0NDQgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL0RvY3VtZW50 YXRpb24vQUJJL3Rlc3Rpbmcvc3lzZnMtY2xhc3MtcG93ZXIgYi9Eb2N1bWVudGF0aW9uL0FCSS90 ZXN0aW5nL3N5c2ZzLWNsYXNzLXBvd2VyCmluZGV4IGY4NWNlOWUuLmUwNDY1NjYgMTAwNjQ0Ci0t LSBhL0RvY3VtZW50YXRpb24vQUJJL3Rlc3Rpbmcvc3lzZnMtY2xhc3MtcG93ZXIKKysrIGIvRG9j dW1lbnRhdGlvbi9BQkkvdGVzdGluZy9zeXNmcy1jbGFzcy1wb3dlcgpAQCAtMSwzICsxLDQ0NiBA QAorPT09PT0gR2VuZXJhbCBQcm9wZXJ0aWVzID09PT09CisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bv d2VyX3N1cHBseS88c3VwcGx5X25hbWU+L21hbnVmYWN0dXJlcgorRGF0ZToJCU1heSAyMDA3CitD b250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRz IHRoZSBuYW1lIG9mIHRoZSBkZXZpY2UgbWFudWZhY3R1cmVyLgorCisJCUFjY2VzczogUmVhZAor CQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGFzIHN0cmluZworCitXaGF0OgkJL3N5cy9jbGFz cy9wb3dlcl9zdXBwbHkvPHN1cHBseV9uYW1lPi9tb2RlbF9uYW1lCitEYXRlOgkJTWF5IDIwMDcK K0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcG9y dHMgdGhlIG5hbWUgb2YgdGhlIGRldmljZSBtb2RlbC4KKworCQlBY2Nlc3M6IFJlYWQKKwkJVmFs aWQgdmFsdWVzOiBSZXByZXNlbnRlZCBhcyBzdHJpbmcKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93 ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vc2VyaWFsX251bWJlcgorRGF0ZToJCUphbnVhcnkgMjAw OAorQ29udGFjdDoJbGludXgtcG1Admdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJUmVw b3J0cyB0aGUgc2VyaWFsIG51bWJlciBvZiB0aGUgZGV2aWNlLgorCisJCUFjY2VzczogUmVhZAor CQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGFzIHN0cmluZworCitXaGF0OgkJL3N5cy9jbGFz cy9wb3dlcl9zdXBwbHkvPHN1cHBseV9uYW1lPi90eXBlCitEYXRlOgkJTWF5IDIwMTAKK0NvbnRh Y3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCURlc2NyaWJlcyB0 aGUgbWFpbiB0eXBlIG9mIHRoZSBzdXBwbHkuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZh bHVlczogIkJhdHRlcnkiLCAiVVBTIiwgIk1haW5zIiwgIlVTQiIKKworPT09PT0gQmF0dGVyeSBQ cm9wZXJ0aWVzID09PT09CisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5 X25hbWU+L2NhcGFjaXR5CitEYXRlOgkJTWF5IDIwMDcKK0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIu a2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCUZpbmUgZ3JhaW4gcmVwcmVzZW50YXRpb24gb2Yg YmF0dGVyeSBjYXBhY2l0eS4KKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogMCAtIDEw MCAocGVyY2VudCkKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFt ZT4vY2FwYWNpdHlfYWxlcnRfbWF4CitEYXRlOgkJSnVseSAyMDEyCitDb250YWN0OglsaW51eC1w bUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlNYXhpbXVtIGJhdHRlcnkgY2FwYWNp dHkgdHJpcC13aXJlIHZhbHVlIHdoZXJlIHRoZSBzdXBwbHkgd2lsbAorCQlub3RpZnkgdXNlci1z cGFjZSBvZiB0aGUgZXZlbnQuIFRoaXMgaXMgbm9ybWFsbHkgdXNlZCBmb3IgdGhlCisJCWJhdHRl cnkgZGlzY2hhcmdpbmcgc2NlbmFyaW8gd2hlcmUgdXNlci1zcGFjZSBuZWVkcyB0byBrbm93IHRo ZQorCQliYXR0ZXJ5IGhhcyBkcm9wcGVkIHRvIGFuIHVwcGVyIGxldmVsIHNvIGl0IGNhbiB0YWtl CisJCWFwcHJvcHJpYXRlIGFjdGlvbiAoZS5nLiB3YXJuaW5nIHVzZXIgdGhhdCBiYXR0ZXJ5IGxl dmVsIGlzCisJCWxvdykuCisKKwkJQWNjZXNzOiBSZWFkLCBXcml0ZQorCQlWYWxpZCB2YWx1ZXM6 IDAgLSAxMDAgKHBlcmNlbnQpCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3Vw cGx5X25hbWU+L2NhcGFjaXR5X2FsZXJ0X21pbgorRGF0ZToJCUp1bHkgMjAxMgorQ29udGFjdDoJ bGludXgtcG1Admdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJTWluaW11bSBiYXR0ZXJ5 IGNhcGFjaXR5IHRyaXAtd2lyZSB2YWx1ZSB3aGVyZSB0aGUgc3VwcGx5IHdpbGwKKwkJbm90aWZ5 IHVzZXItc3BhY2Ugb2YgdGhlIGV2ZW50LiBUaGlzIGlzIG5vcm1hbGx5IHVzZWQgZm9yIHRoZQor CQliYXR0ZXJ5IGRpc2NoYXJnaW5nIHNjZW5hcmlvIHdoZXJlIHVzZXItc3BhY2UgbmVlZHMgdG8g a25vdyB0aGUKKwkJYmF0dGVyeSBoYXMgZHJvcHBlZCB0byBhIGxvd2VyIGxldmVsIHNvIGl0IGNh biB0YWtlCisJCWFwcHJvcHJpYXRlIGFjdGlvbiAoZS5nLiB3YXJuaW5nIHVzZXIgdGhhdCBiYXR0 ZXJ5IGxldmVsIGlzCisJCWNyaXRpY2FsbHkgbG93KS4KKworCQlBY2Nlc3M6IFJlYWQsIFdyaXRl CisJCVZhbGlkIHZhbHVlczogMCAtIDEwMCAocGVyY2VudCkKKworV2hhdDoJCS9zeXMvY2xhc3Mv cG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vY2FwYWNpdHlfbGV2ZWwKK0RhdGU6CQlKdW5lIDIw MDkKK0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCUNv YXJzZSByZXByZXNlbnRhdGlvbiBvZiBiYXR0ZXJ5IGNhcGFjaXR5LgorCisJCUFjY2VzczogUmVh ZAorCQlWYWxpZCB2YWx1ZXM6ICJVbmtub3duIiwgIkNyaXRpY2FsIiwgIkxvdyIsICJOb3JtYWwi LCAiSGlnaCIsCisJCQkgICAgICAiRnVsbCIKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3Vw cGx5LzxzdXBwbHlfbmFtZT4vY3VycmVudF9hdmcKK0RhdGU6CQlNYXkgMjAwNworQ29udGFjdDoJ bGludXgtcG1Admdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJUmVwb3J0cyBhbiBhdmVy YWdlIElCQVQgY3VycmVudCByZWFkaW5nIGZvciB0aGUgYmF0dGVyeSwgb3ZlciBhCisJCWZpeGVk IHBlcmlvZC4gTm9ybWFsbHkgZGV2aWNlcyB3aWxsIHByb3ZpZGUgYSBmaXhlZCBpbnRlcnZhbCBp bgorCQl3aGljaCB0aGV5IGF2ZXJhZ2UgcmVhZGluZ3MgdG8gc21vb3RoIG91dCB0aGUgcmVwb3J0 ZWQgdmFsdWUuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50ZWQg aW4gbWljcm9hbXBzCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5X25h bWU+L2N1cnJlbnRfbWF4CitEYXRlOgkJT2N0b2JlciAyMDEwCitDb250YWN0OglsaW51eC1wbUB2 Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRzIHRoZSBtYXhpbXVtIElCQVQg Y3VycmVudCBhbGxvd2VkIGludG8gdGhlIGJhdHRlcnkuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZh bGlkIHZhbHVlczogUmVwcmVzZW50ZWQgaW4gbWljcm9hbXBzCisKK1doYXQ6CQkvc3lzL2NsYXNz L3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L2N1cnJlbnRfbm93CitEYXRlOgkJTWF5IDIwMDcK K0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcG9y dHMgYW4gaW5zdGFudCwgc2luZ2xlIElCQVQgY3VycmVudCByZWFkaW5nIGZvciB0aGUgYmF0dGVy eS4KKwkJVGhpcyB2YWx1ZSBpcyBub3QgYXZlcmFnZWQvc21vb3RoZWQuCisKKwkJQWNjZXNzOiBS ZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50ZWQgaW4gbWljcm9hbXBzCisKK1doYXQ6CQkv c3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L2NoYXJnZV90eXBlCitEYXRlOgkJ SnVseSAyMDA5CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9u OgorCQlSZXByZXNlbnRzIHRoZSB0eXBlIG9mIGNoYXJnaW5nIGN1cnJlbnRseSBiZWluZyBhcHBs aWVkIHRvIHRoZQorCQliYXR0ZXJ5LgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1ZXM6 ICJVbmtub3duIiwgIk4vQSIsICJUcmlja2xlIiwgIkZhc3QiCisKK1doYXQ6CQkvc3lzL2NsYXNz L3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L2NoYXJnZV90ZXJtX2N1cnJlbnQKK0RhdGU6CQlK dWx5IDIwMTQKK0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246 CisJCVJlcG9ydHMgdGhlIGNoYXJnaW5nIGN1cnJlbnQgdmFsdWUgd2hpY2ggaXMgdXNlZCB0byBk ZXRlcm1pbmUKKwkJd2hlbiB0aGUgYmF0dGVyeSBpcyBjb25zaWRlcmVkIGZ1bGwgYW5kIGNoYXJn aW5nIHNob3VsZCBlbmQuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVz ZW50ZWQgaW4gbWljcm9hbXBzCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3Vw cGx5X25hbWU+L2hlYWx0aAorRGF0ZToJCU1heSAyMDA3CitDb250YWN0OglsaW51eC1wbUB2Z2Vy Lmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRzIHRoZSBoZWFsdGggb2YgdGhlIGJh dHRlcnkgb3IgYmF0dGVyeSBzaWRlIG9mIGNoYXJnZXIKKwkJZnVuY3Rpb25hbGl0eS4KKworCQlB Y2Nlc3M6IFJlYWQKKwkJVmFsaWQgdmFsdWVzOiAiVW5rbm93biIsICJHb29kIiwgIk92ZXJoZWF0 IiwgIkRlYWQiLAorCQkJICAgICAgIk92ZXIgdm9sdGFnZSIsICJVbnNwZWNpZmllZCBmYWlsdXJl IiwgIkNvbGQiLAorCQkJICAgICAgIldhdGNoZG9nIHRpbWVyIGV4cGlyZSIsICJTYWZldHkgdGlt ZXIgZXhwaXJlIgorCitXaGF0OgkJL3N5cy9jbGFzcy9wb3dlcl9zdXBwbHkvPHN1cHBseV9uYW1l Pi9wcmVjaGFyZ2VfY3VycmVudAorRGF0ZToJCUp1bmUgMjAxNworQ29udGFjdDoJbGludXgtcG1A dmdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJUmVwb3J0cyB0aGUgY2hhcmdpbmcgY3Vy cmVudCBhcHBsaWVkIGR1cmluZyBwcmUtY2hhcmdpbmcgcGhhc2UKKwkJZm9yIGEgYmF0dGVyeSBj aGFyZ2UgY3ljbGUuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50 ZWQgaW4gbWljcm9hbXBzCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5 X25hbWU+L3ByZXNlbnQKK0RhdGU6CQlNYXkgMjAwNworQ29udGFjdDoJbGludXgtcG1Admdlci5r ZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJUmVwb3J0cyB3aGV0aGVyIGEgYmF0dGVyeSBpcyBw cmVzZW50IG9yIG5vdCBpbiB0aGUgc3lzdGVtLgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2 YWx1ZXM6CisJCQkwOiBBYnNlbnQKKwkJCTE6IFByZXNlbnQKKworV2hhdDoJCS9zeXMvY2xhc3Mv cG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vc3RhdHVzCitEYXRlOgkJTWF5IDIwMDcKK0NvbnRh Y3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcHJlc2VudHMg dGhlIGNoYXJnaW5nIHN0YXR1cyBvZiB0aGUgYmF0dGVyeS4gTm9ybWFsbHkgdGhpcworCQlpcyBy ZWFkLW9ubHkgcmVwb3J0aW5nIGFsdGhvdWdoIGZvciBzb21lIHN1cHBsaWVzIHRoaXMgY2FuIGJl CisJCXVzZWQgdG8gZW5hYmxlL2Rpc2FibGUgY2hhcmdpbmcgdG8gdGhlIGJhdHRlcnkuCisKKwkJ QWNjZXNzOiBSZWFkLCBXcml0ZQorCQlWYWxpZCB2YWx1ZXM6ICJVbmtub3duIiwgIkNoYXJnaW5n IiwgIkRpc2NoYXJnaW5nIiwKKwkJCSAgICAgICJOb3QgY2hhcmdpbmciLCAiRnVsbCIKKworV2hh dDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vdGVjaG5vbG9neQorRGF0 ZToJCU1heSAyMDA3CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0 aW9uOgorCQlEZXNjcmliZXMgdGhlIGJhdHRlcnkgdGVjaG5vbG9neSBzdXBwb3J0ZWQgYnkgdGhl IHN1cHBseS4KKworCQlBY2Nlc3M6IFJlYWQKKwkJVmFsaWQgdmFsdWVzOiAiVW5rbm93biIsICJO aU1IIiwgIkxpLWlvbiIsICJMaS1wb2x5IiwgIkxpRmUiLAorCQkJICAgICAgIk5pQ2QiLCAiTGlN biIKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vdGVtcAor RGF0ZToJCU1heSAyMDA3CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2Ny aXB0aW9uOgorCQlSZXBvcnRzIHRoZSBjdXJyZW50IFRCQVQgYmF0dGVyeSB0ZW1wZXJhdHVyZSBy ZWFkaW5nLgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGlu IDEvMTAgRGVncmVlcyBDZWxzaXVzCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88 c3VwcGx5X25hbWU+L3RlbXBfYWxlcnRfbWF4CitEYXRlOgkJSnVseSAyMDEyCitDb250YWN0Ogls aW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlNYXhpbXVtIFRCQVQgdGVt cGVyYXR1cmUgdHJpcC13aXJlIHZhbHVlIHdoZXJlIHRoZSBzdXBwbHkgd2lsbAorCQlub3RpZnkg dXNlci1zcGFjZSBvZiB0aGUgZXZlbnQuIFRoaXMgaXMgbm9ybWFsbHkgdXNlZCBmb3IgdGhlCisJ CWJhdHRlcnkgY2hhcmdpbmcgc2NlbmFyaW8gd2hlcmUgdXNlci1zcGFjZSBuZWVkcyB0byBrbm93 IHRoZQorCQliYXR0ZXJ5IHRlbXBlcmF0dXJlIGhhcyBjcm9zc2VkIGFuIHVwcGVyIHRocmVzaG9s ZCBzbyBpdCBjYW4KKwkJdGFrZSBhcHByb3ByaWF0ZSBhY3Rpb24gKGUuZy4gd2FybmluZyB1c2Vy IHRoYXQgYmF0dGVyeSBsZXZlbCBpcworCQljcml0aWNhbGx5IGhpZ2gsIGFuZCBjaGFyZ2luZyBo YXMgc3RvcHBlZCkuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50 ZWQgaW4gMS8xMCBEZWdyZWVzIENlbHNpdXMKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3Vw cGx5LzxzdXBwbHlfbmFtZT4vdGVtcF9hbGVydF9taW4KK0RhdGU6CQlKdWx5IDIwMTIKK0NvbnRh Y3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCU1pbmltdW0gVEJB VCB0ZW1wZXJhdHVyZSB0cmlwLXdpcmUgdmFsdWUgd2hlcmUgdGhlIHN1cHBseSB3aWxsCisJCW5v dGlmeSB1c2VyLXNwYWNlIG9mIHRoZSBldmVudC4gVGhpcyBpcyBub3JtYWxseSB1c2VkIGZvciB0 aGUKKwkJYmF0dGVyeSBjaGFyZ2luZyBzY2VuYXJpbyB3aGVyZSB1c2VyLXNwYWNlIG5lZWRzIHRv IGtub3cgdGhlCisJCWJhdHRlcnkgdGVtcGVyYXR1cmUgaGFzIGNyb3NzZWQgYSBsb3dlciB0aHJl c2hvbGQgc28gaXQgY2FuIHRha2UKKwkJYXBwcm9wcmlhdGUgYWN0aW9uIChlLmcuIHdhcm5pbmcg dXNlciB0aGF0IGJhdHRlcnkgbGV2ZWwgaXMKKwkJaGlnaCwgYW5kIGNoYXJnaW5nIGN1cnJlbnQg aGFzIGJlZW4gcmVkdWNlZCBhY2NvcmRpbmdseSB0bworCQlyZW1lZHkgdGhlIHNpdHVhdGlvbiku CisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50ZWQgaW4gMS8xMCBE ZWdyZWVzIENlbHNpdXMKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5LzxzdXBwbHlf bmFtZT4vdGVtcF9tYXgKK0RhdGU6CQlKdWx5IDIwMTQKK0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIu a2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcG9ydHMgdGhlIG1heGltdW0gYWxsb3dlZCBU QkFUIGJhdHRlcnkgdGVtcGVyYXR1cmUgZm9yCisJCWNoYXJnaW5nLgorCisJCUFjY2VzczogUmVh ZAorCQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGluIDEvMTAgRGVncmVlcyBDZWxzaXVzCisK K1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L3RlbXBfbWluCitE YXRlOgkJSnVseSAyMDE0CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2Ny aXB0aW9uOgorCQlSZXBvcnRzIHRoZSBtaW5pbXVtIGFsbG93ZWQgVEJBVCBiYXR0ZXJ5IHRlbXBl cmF0dXJlIGZvcgorCQljaGFyZ2luZy4KKworCQlBY2Nlc3M6IFJlYWQKKwkJVmFsaWQgdmFsdWVz OiBSZXByZXNlbnRlZCBpbiAxLzEwIERlZ3JlZXMgQ2Vsc2l1cworCitXaGF0OgkJL3N5cy9jbGFz cy9wb3dlcl9zdXBwbHkvPHN1cHBseV9uYW1lPi92b2x0YWdlX2F2ZywKK0RhdGU6CQlNYXkgMjAw NworQ29udGFjdDoJbGludXgtcG1Admdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJUmVw b3J0cyBhbiBhdmVyYWdlIFZCQVQgdm9sdGFnZSByZWFkaW5nIGZvciB0aGUgYmF0dGVyeSwgb3Zl ciBhCisJCWZpeGVkIHBlcmlvZC4gTm9ybWFsbHkgZGV2aWNlcyB3aWxsIHByb3ZpZGUgYSBmaXhl ZCBpbnRlcnZhbCBpbgorCQl3aGljaCB0aGV5IGF2ZXJhZ2UgcmVhZGluZ3MgdG8gc21vb3RoIG91 dCB0aGUgcmVwb3J0ZWQgdmFsdWUuCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczog UmVwcmVzZW50ZWQgaW4gbWljcm92b2x0cworCitXaGF0OgkJL3N5cy9jbGFzcy9wb3dlcl9zdXBw bHkvPHN1cHBseV9uYW1lPi92b2x0YWdlX21heCwKK0RhdGU6CQlKYW51YXJ5IDIwMDgKK0NvbnRh Y3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcG9ydHMgdGhl IG1heGltdW0gc2FmZSBWQkFUIHZvbHRhZ2UgcGVybWl0dGVkIGZvciB0aGUgYmF0dGVyeSwKKwkJ ZHVyaW5nIGNoYXJnaW5nLgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1ZXM6IFJlcHJl c2VudGVkIGluIG1pY3Jvdm9sdHMKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5Lzxz dXBwbHlfbmFtZT4vdm9sdGFnZV9taW4sCitEYXRlOgkJSmFudWFyeSAyMDA4CitDb250YWN0Ogls aW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRzIHRoZSBtaW5p bXVtIHNhZmUgVkJBVCB2b2x0YWdlIHBlcm1pdHRlZCBmb3IgdGhlIGJhdHRlcnksCisJCWR1cmlu ZyBkaXNjaGFyZ2luZy4KKworCQlBY2Nlc3M6IFJlYWQKKwkJVmFsaWQgdmFsdWVzOiBSZXByZXNl bnRlZCBpbiBtaWNyb3ZvbHRzCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3Vw cGx5X25hbWU+L3ZvbHRhZ2Vfbm93LAorRGF0ZToJCU1heSAyMDA3CitDb250YWN0OglsaW51eC1w bUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRzIGFuIGluc3RhbnQsIHNp bmdsZSBWQkFUIHZvbHRhZ2UgcmVhZGluZyBmb3IgdGhlIGJhdHRlcnkuCisJCVRoaXMgdmFsdWUg aXMgbm90IGF2ZXJhZ2VkL3Ntb290aGVkLgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1 ZXM6IFJlcHJlc2VudGVkIGluIG1pY3Jvdm9sdHMKKworPT09PT0gVVNCIFByb3BlcnRpZXMgPT09 PT0KKworV2hhdDogCQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L2N1cnJl bnRfYXZnCitEYXRlOgkJTWF5IDIwMDcKK0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9y ZworRGVzY3JpcHRpb246CisJCVJlcG9ydHMgYW4gYXZlcmFnZSBJQlVTIGN1cnJlbnQgcmVhZGlu ZyBvdmVyIGEgZml4ZWQgcGVyaW9kLgorCQlOb3JtYWxseSBkZXZpY2VzIHdpbGwgcHJvdmlkZSBh IGZpeGVkIGludGVydmFsIGluIHdoaWNoIHRoZXkKKwkJYXZlcmFnZSByZWFkaW5ncyB0byBzbW9v dGggb3V0IHRoZSByZXBvcnRlZCB2YWx1ZS4KKworCQlBY2Nlc3M6IFJlYWQKKwkJVmFsaWQgdmFs dWVzOiBSZXByZXNlbnRlZCBpbiBtaWNyb2FtcHMKKworCitXaGF0OiAJCS9zeXMvY2xhc3MvcG93 ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vY3VycmVudF9tYXgKK0RhdGU6CQlPY3RvYmVyIDIwMTAK K0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcG9y dHMgdGhlIG1heGltdW0gSUJVUyBjdXJyZW50IHRoZSBzdXBwbHkgY2FuIHN1cHBvcnQuCisKKwkJ QWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50ZWQgaW4gbWljcm9hbXBzCisK K1doYXQ6IAkJL3N5cy9jbGFzcy9wb3dlcl9zdXBwbHkvPHN1cHBseV9uYW1lPi9jdXJyZW50X25v dworRGF0ZToJCU1heSAyMDA3CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rl c2NyaXB0aW9uOgorCQlSZXBvcnRzIHRoZSBJQlVTIGN1cnJlbnQgc3VwcGxpZWQgbm93LiBUaGlz IHZhbHVlIGlzIGdlbmVyYWxseQorCQlyZWFkLW9ubHkgcmVwb3J0aW5nLCB1bmxlc3MgdGhlICdv bmxpbmUnIHN0YXRlIG9mIHRoZSBzdXBwbHkKKwkJaXMgc2V0IHRvIGJlIHByb2dyYW1tYWJsZSwg aW4gd2hpY2ggY2FzZSB0aGlzIHZhbHVlIGNhbiBiZSBzZXQKKwkJd2l0aGluIHRoZSByZXBvcnRl ZCBtaW4vbWF4IHJhbmdlLgorCisJCUFjY2VzczogUmVhZCwgV3JpdGUKKwkJVmFsaWQgdmFsdWVz OiBSZXByZXNlbnRlZCBpbiBtaWNyb2FtcHMKKworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3Vw cGx5LzxzdXBwbHlfbmFtZT4vaW5wdXRfY3VycmVudF9saW1pdAorRGF0ZToJCUp1bHkgMjAxNAor Q29udGFjdDoJbGludXgtcG1Admdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJRGV0YWls cyB0aGUgaW5jb21pbmcgSUJVUyBjdXJyZW50IGxpbWl0IGN1cnJlbnRseSBzZXQgaW4gdGhlCisJ CXN1cHBseS4gTm9ybWFsbHkgdGhpcyBpcyBjb25maWd1cmVkIGJhc2VkIG9uIHRoZSB0eXBlIG9m CisJCWNvbm5lY3Rpb24gbWFkZSAoZS5nLiBBIGNvbmZpZ3VyZWQgU0RQIHNob3VsZCBvdXRwdXQg YSBtYXhpbXVtCisJCW9mIDUwMG1BIHNvIHRoZSBpbnB1dCBjdXJyZW50IGxpbWl0IGlzIHNldCB0 byB0aGUgc2FtZSB2YWx1ZSkuCisKKwkJQWNjZXNzOiBSZWFkLCBXcml0ZQorCQlWYWxpZCB2YWx1 ZXM6IFJlcHJlc2VudGVkIGluIG1pY3JvYW1wcworCitXaGF0OgkJL3N5cy9jbGFzcy9wb3dlcl9z dXBwbHkvPHN1cHBseV9uYW1lPi9vbmxpbmUsCitEYXRlOgkJTWF5IDIwMDcKK0NvbnRhY3Q6CWxp bnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCUluZGljYXRlcyBpZiBWQlVT IGlzIHByZXNlbnQgZm9yIHRoZSBzdXBwbHkuIFdoZW4gdGhlIHN1cHBseSBpcworCQlvbmxpbmUs IGFuZCB0aGUgc3VwcGx5IGFsbG93cyBpdCwgdGhlbiBpdCdzIHBvc3NpYmxlIHRvIHN3aXRjaAor CQliZXR3ZWVuIG9ubGluZSBzdGF0ZXMgKGUuZy4gRml4ZWQgLT4gUHJvZ3JhbW1hYmxlIGZvciBh IFBEX1BQUworCQlVU0Igc3VwcGx5IHNvIHZvbHRhZ2UgYW5kIGN1cnJlbnQgY2FuIGJlIGNvbnRy b2xsZWQpLgorCisJCUFjY2VzczogUmVhZCwgV3JpdGUKKwkJVmFsaWQgdmFsdWVzOgorCQkJMDog T2ZmbGluZQorCQkJMTogT25saW5lIEZpeGVkIC0gRml4ZWQgVm9sdGFnZSBTdXBwbHkKKwkJCTI6 IE9ubGluZSBQcm9ncmFtbWFibGUgLSBQcm9ncmFtbWFibGUgVm9sdGFnZSBTdXBwbHkKKworV2hh dDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vdGVtcAorRGF0ZToJCU1h eSAyMDA3CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgor CQlSZXBvcnRzIHRoZSBjdXJyZW50IHN1cHBseSB0ZW1wZXJhdHVyZSByZWFkaW5nLiBUaGlzIHdv dWxkCisJCW5vcm1hbGx5IGJlIHRoZSBpbnRlcm5hbCB0ZW1wZXJhdHVyZSBvZiB0aGUgZGV2aWNl IGl0c2VsZiAoZS5nCisJCVRKVU5DIHRlbXBlcmF0dXJlIG9mIGFuIElDKQorCisJCUFjY2Vzczog UmVhZAorCQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGluIDEvMTAgRGVncmVlcyBDZWxzaXVz CisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L3RlbXBfYWxl cnRfbWF4CitEYXRlOgkJSnVseSAyMDEyCitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5v cmcKK0Rlc2NyaXB0aW9uOgorCQlNYXhpbXVtIHN1cHBseSB0ZW1wZXJhdHVyZSB0cmlwLXdpcmUg dmFsdWUgd2hlcmUgdGhlIHN1cHBseSB3aWxsCisJCW5vdGlmeSB1c2VyLXNwYWNlIG9mIHRoZSBl dmVudC4gVGhpcyBpcyBub3JtYWxseSB1c2VkIGZvciB0aGUKKwkJY2hhcmdpbmcgc2NlbmFyaW8g d2hlcmUgdXNlci1zcGFjZSBuZWVkcyB0byBrbm93IHRoZSBzdXBwbHkKKwkJdGVtcGVyYXR1cmUg aGFzIGNyb3NzZWQgYW4gdXBwZXIgdGhyZXNob2xkIHNvIGl0IGNhbiB0YWtlCisJCWFwcHJvcHJp YXRlIGFjdGlvbiAoZS5nLiB3YXJuaW5nIHVzZXIgdGhhdCB0aGUgc3VwcGx5CisJCXRlbXBlcmF0 dXJlIGlzIGNyaXRpY2FsbHkgaGlnaCwgYW5kIGNoYXJnaW5nIGhhcyBzdG9wcGVkIHRvCisJCXJl bWVkeSB0aGUgc2l0dWF0aW9uKS4KKworCQlBY2Nlc3M6IFJlYWQKKwkJVmFsaWQgdmFsdWVzOiBS ZXByZXNlbnRlZCBpbiAxLzEwIERlZ3JlZXMgQ2Vsc2l1cworCitXaGF0OgkJL3N5cy9jbGFzcy9w b3dlcl9zdXBwbHkvPHN1cHBseV9uYW1lPi90ZW1wX2FsZXJ0X21pbgorRGF0ZToJCUp1bHkgMjAx MgorQ29udGFjdDoJbGludXgtcG1Admdlci5rZXJuZWwub3JnCitEZXNjcmlwdGlvbjoKKwkJTWlu aW11bSBzdXBwbHkgdGVtcGVyYXR1cmUgdHJpcC13aXJlIHZhbHVlIHdoZXJlIHRoZSBzdXBwbHkg d2lsbAorCQlub3RpZnkgdXNlci1zcGFjZSBvZiB0aGUgZXZlbnQuIFRoaXMgaXMgbm9ybWFsbHkg dXNlZCBmb3IgdGhlCisJCWNoYXJnaW5nIHNjZW5hcmlvIHdoZXJlIHVzZXItc3BhY2UgbmVlZHMg dG8ga25vdyB0aGUgc3VwcGx5CisJCXRlbXBlcmF0dXJlIGhhcyBjcm9zc2VkIGEgbG93ZXIgdGhy ZXNob2xkIHNvIGl0IGNhbiB0YWtlCisJCWFwcHJvcHJpYXRlIGFjdGlvbiAoZS5nLiB3YXJuaW5n IHVzZXIgdGhhdCB0aGUgc3VwcGx5CisJCXRlbXBlcmF0dXJlIGlzIGhpZ2gsIGFuZCBjaGFyZ2lu ZyBjdXJyZW50IGhhcyBiZWVuIHJlZHVjZWQKKwkJYWNjb3JkaW5nbHkgdG8gcmVtZWR5IHRoZSBz aXR1YXRpb24pLgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVk IGluIDEvMTAgRGVncmVlcyBDZWxzaXVzCisKK1doYXQ6CQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBs eS88c3VwcGx5X25hbWU+L3RlbXBfbWF4CitEYXRlOgkJSnVseSAyMDE0CitDb250YWN0OglsaW51 eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRzIHRoZSBtYXhpbXVt IGFsbG93ZWQgc3VwcGx5IHRlbXBlcmF0dXJlIGZvciBvcGVyYXRpb24uCisKKwkJQWNjZXNzOiBS ZWFkCisJCVZhbGlkIHZhbHVlczogUmVwcmVzZW50ZWQgaW4gMS8xMCBEZWdyZWVzIENlbHNpdXMK KworV2hhdDoJCS9zeXMvY2xhc3MvcG93ZXJfc3VwcGx5LzxzdXBwbHlfbmFtZT4vdGVtcF9taW4K K0RhdGU6CQlKdWx5IDIwMTQKK0NvbnRhY3Q6CWxpbnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVz Y3JpcHRpb246CisJCVJlcG9ydHMgdGhlIG1haW5pbXVtIGFsbG93ZWQgc3VwcGx5IHRlbXBlcmF0 dXJlIGZvciBvcGVyYXRpb24uCisKKwkJQWNjZXNzOiBSZWFkCisJCVZhbGlkIHZhbHVlczogUmVw cmVzZW50ZWQgaW4gMS8xMCBEZWdyZWVzIENlbHNpdXMKKworV2hhdDogCQkvc3lzL2NsYXNzL3Bv d2VyX3N1cHBseS88c3VwcGx5X25hbWU+L3ZvbHRhZ2VfbWF4CitEYXRlOgkJSmFudWFyeSAyMDA4 CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBv cnRzIHRoZSBtYXhpbXVtIFZCVVMgdm9sdGFnZSB0aGUgc3VwcGx5IGNhbiBzdXBwb3J0LgorCisJ CUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGluIG1pY3Jvdm9sdHMK KworV2hhdDogCQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBseS88c3VwcGx5X25hbWU+L3ZvbHRhZ2Vf bWluCitEYXRlOgkJSmFudWFyeSAyMDA4CitDb250YWN0OglsaW51eC1wbUB2Z2VyLmtlcm5lbC5v cmcKK0Rlc2NyaXB0aW9uOgorCQlSZXBvcnRzIHRoZSBtaW5pbXVtIFZCVVMgdm9sdGFnZSB0aGUg c3VwcGx5IGNhbiBzdXBwb3J0LgorCisJCUFjY2VzczogUmVhZAorCQlWYWxpZCB2YWx1ZXM6IFJl cHJlc2VudGVkIGluIG1pY3Jvdm9sdHMKKworV2hhdDogCQkvc3lzL2NsYXNzL3Bvd2VyX3N1cHBs eS88c3VwcGx5X25hbWU+L3ZvbHRhZ2Vfbm93CitEYXRlOgkJTWF5IDIwMDcKK0NvbnRhY3Q6CWxp bnV4LXBtQHZnZXIua2VybmVsLm9yZworRGVzY3JpcHRpb246CisJCVJlcG9ydHMgdGhlIFZCVVMg dm9sdGFnZSBzdXBwbGllZCBub3cuIFRoaXMgdmFsdWUgaXMgZ2VuZXJhbGx5CisJCXJlYWQtb25s eSByZXBvcnRpbmcsIHVubGVzcyB0aGUgJ29ubGluZScgc3RhdGUgb2YgdGhlIHN1cHBseQorCQlp cyBzZXQgdG8gYmUgcHJvZ3JhbW1hYmxlLCBpbiB3aGljaCBjYXNlIHRoaXMgdmFsdWUgY2FuIGJl IHNldAorCQl3aXRoaW4gdGhlIHJlcG9ydGVkIG1pbi9tYXggcmFuZ2UuCisKKwkJQWNjZXNzOiBS ZWFkLCBXcml0ZQorCQlWYWxpZCB2YWx1ZXM6IFJlcHJlc2VudGVkIGluIG1pY3Jvdm9sdHMKKwor PT09PT0gRGV2aWNlIFNwZWNpZmljIFByb3BlcnRpZXMgPT09PT0KKwogV2hhdDoJCS9zeXMvY2xh c3MvcG93ZXIvZHMyNzYwLWJhdHRlcnkuKi9jaGFyZ2Vfbm93CiBEYXRlOgkJTWF5IDIwMTAKIEtl cm5lbFZlcnNpb246CTIuNi4zNQpkaWZmIC0tZ2l0IGEvTUFJTlRBSU5FUlMgYi9NQUlOVEFJTkVS UwppbmRleCAwYTE0MTBkLi43MDBiZmI3IDEwMDY0NAotLS0gYS9NQUlOVEFJTkVSUworKysgYi9N QUlOVEFJTkVSUwpAQCAtMTEyNDIsNiArMTEyNDIsNyBAQCBNOglTZWJhc3RpYW4gUmVpY2hlbCA8 c3JlQGtlcm5lbC5vcmc+CiBMOglsaW51eC1wbUB2Z2VyLmtlcm5lbC5vcmcKIFQ6CWdpdCBnaXQ6 Ly9naXQua2VybmVsLm9yZy9wdWIvc2NtL2xpbnV4L2tlcm5lbC9naXQvc3JlL2xpbnV4LXBvd2Vy LXN1cHBseS5naXQKIFM6CU1haW50YWluZWQKK0Y6CURvY3VtZW50YXRpb24vQUJJL3Rlc3Rpbmcv c3lzZnMtY2xhc3MtcG93ZXIKIEY6CURvY3VtZW50YXRpb24vZGV2aWNldHJlZS9iaW5kaW5ncy9w b3dlci9zdXBwbHkvCiBGOglpbmNsdWRlL2xpbnV4L3Bvd2VyX3N1cHBseS5oCiBGOglkcml2ZXJz L3Bvd2VyL3N1cHBseS8K From mboxrd@z Thu Jan 1 00:00:00 1970 From: Adam Thomson Subject: [PATCH v8 2/6] Documentation: power: Initial effort to document power_supply ABI Date: Mon, 23 Apr 2018 15:10:57 +0100 Message-ID: <262928f7cd04c1691c78993520304f036ba207b2.1524490253.git.Adam.Thomson.Opensource@diasemi.com> References: Mime-Version: 1.0 Content-Type: text/plain Return-path: In-Reply-To: Sender: linux-kernel-owner@vger.kernel.org To: Heikki Krogerus , Guenter Roeck , Greg Kroah-Hartman , Sebastian Reichel , Hans de Goede , Jun Li Cc: linux-usb@vger.kernel.org, linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, support.opensource@diasemi.com List-Id: linux-pm@vger.kernel.org This commit adds generic ABI information regarding power_supply properties. This is an initial attempt to try and align the usage of these properties between drivers. As part of this commit, common Battery and USB related properties have been listed. Signed-off-by: Adam Thomson --- Documentation/ABI/testing/sysfs-class-power | 443 ++++++++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 444 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-class-power b/Documentation/ABI/testing/sysfs-class-power index f85ce9e..e046566 100644 --- a/Documentation/ABI/testing/sysfs-class-power +++ b/Documentation/ABI/testing/sysfs-class-power @@ -1,3 +1,446 @@ +===== General Properties ===== + +What: /sys/class/power_supply//manufacturer +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the name of the device manufacturer. + + Access: Read + Valid values: Represented as string + +What: /sys/class/power_supply//model_name +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the name of the device model. + + Access: Read + Valid values: Represented as string + +What: /sys/class/power_supply//serial_number +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the serial number of the device. + + Access: Read + Valid values: Represented as string + +What: /sys/class/power_supply//type +Date: May 2010 +Contact: linux-pm@vger.kernel.org +Description: + Describes the main type of the supply. + + Access: Read + Valid values: "Battery", "UPS", "Mains", "USB" + +===== Battery Properties ===== + +What: /sys/class/power_supply//capacity +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Fine grain representation of battery capacity. + Access: Read + Valid values: 0 - 100 (percent) + +What: /sys/class/power_supply//capacity_alert_max +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Maximum battery capacity trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery discharging scenario where user-space needs to know the + battery has dropped to an upper level so it can take + appropriate action (e.g. warning user that battery level is + low). + + Access: Read, Write + Valid values: 0 - 100 (percent) + +What: /sys/class/power_supply//capacity_alert_min +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Minimum battery capacity trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery discharging scenario where user-space needs to know the + battery has dropped to a lower level so it can take + appropriate action (e.g. warning user that battery level is + critically low). + + Access: Read, Write + Valid values: 0 - 100 (percent) + +What: /sys/class/power_supply//capacity_level +Date: June 2009 +Contact: linux-pm@vger.kernel.org +Description: + Coarse representation of battery capacity. + + Access: Read + Valid values: "Unknown", "Critical", "Low", "Normal", "High", + "Full" + +What: /sys/class/power_supply//current_avg +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an average IBAT current reading for the battery, over a + fixed period. Normally devices will provide a fixed interval in + which they average readings to smooth out the reported value. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//current_max +Date: October 2010 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum IBAT current allowed into the battery. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//current_now +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an instant, single IBAT current reading for the battery. + This value is not averaged/smoothed. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//charge_type +Date: July 2009 +Contact: linux-pm@vger.kernel.org +Description: + Represents the type of charging currently being applied to the + battery. + + Access: Read + Valid values: "Unknown", "N/A", "Trickle", "Fast" + +What: /sys/class/power_supply//charge_term_current +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the charging current value which is used to determine + when the battery is considered full and charging should end. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//health +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the health of the battery or battery side of charger + functionality. + + Access: Read + Valid values: "Unknown", "Good", "Overheat", "Dead", + "Over voltage", "Unspecified failure", "Cold", + "Watchdog timer expire", "Safety timer expire" + +What: /sys/class/power_supply//precharge_current +Date: June 2017 +Contact: linux-pm@vger.kernel.org +Description: + Reports the charging current applied during pre-charging phase + for a battery charge cycle. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//present +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports whether a battery is present or not in the system. + + Access: Read + Valid values: + 0: Absent + 1: Present + +What: /sys/class/power_supply//status +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Represents the charging status of the battery. Normally this + is read-only reporting although for some supplies this can be + used to enable/disable charging to the battery. + + Access: Read, Write + Valid values: "Unknown", "Charging", "Discharging", + "Not charging", "Full" + +What: /sys/class/power_supply//technology +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Describes the battery technology supported by the supply. + + Access: Read + Valid values: "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe", + "NiCd", "LiMn" + +What: /sys/class/power_supply//temp +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the current TBAT battery temperature reading. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_max +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Maximum TBAT temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery charging scenario where user-space needs to know the + battery temperature has crossed an upper threshold so it can + take appropriate action (e.g. warning user that battery level is + critically high, and charging has stopped). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_min +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Minimum TBAT temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + battery charging scenario where user-space needs to know the + battery temperature has crossed a lower threshold so it can take + appropriate action (e.g. warning user that battery level is + high, and charging current has been reduced accordingly to + remedy the situation). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_max +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum allowed TBAT battery temperature for + charging. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_min +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the minimum allowed TBAT battery temperature for + charging. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//voltage_avg, +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an average VBAT voltage reading for the battery, over a + fixed period. Normally devices will provide a fixed interval in + which they average readings to smooth out the reported value. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_max, +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum safe VBAT voltage permitted for the battery, + during charging. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_min, +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the minimum safe VBAT voltage permitted for the battery, + during discharging. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_now, +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an instant, single VBAT voltage reading for the battery. + This value is not averaged/smoothed. + + Access: Read + Valid values: Represented in microvolts + +===== USB Properties ===== + +What: /sys/class/power_supply//current_avg +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports an average IBUS current reading over a fixed period. + Normally devices will provide a fixed interval in which they + average readings to smooth out the reported value. + + Access: Read + Valid values: Represented in microamps + + +What: /sys/class/power_supply//current_max +Date: October 2010 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum IBUS current the supply can support. + + Access: Read + Valid values: Represented in microamps + +What: /sys/class/power_supply//current_now +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the IBUS current supplied now. This value is generally + read-only reporting, unless the 'online' state of the supply + is set to be programmable, in which case this value can be set + within the reported min/max range. + + Access: Read, Write + Valid values: Represented in microamps + +What: /sys/class/power_supply//input_current_limit +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Details the incoming IBUS current limit currently set in the + 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). + + Access: Read, Write + Valid values: Represented in microamps + +What: /sys/class/power_supply//online, +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Indicates if VBUS is present for the supply. When the supply is + online, and the supply allows it, then it's possible to switch + between online states (e.g. Fixed -> Programmable for a PD_PPS + USB supply so voltage and current can be controlled). + + Access: Read, Write + Valid values: + 0: Offline + 1: Online Fixed - Fixed Voltage Supply + 2: Online Programmable - Programmable Voltage Supply + +What: /sys/class/power_supply//temp +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the current supply temperature reading. This would + normally be the internal temperature of the device itself (e.g + TJUNC temperature of an IC) + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_max +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Maximum supply temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + charging scenario where user-space needs to know the supply + temperature has crossed an upper threshold so it can take + appropriate action (e.g. warning user that the supply + temperature is critically high, and charging has stopped to + remedy the situation). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_alert_min +Date: July 2012 +Contact: linux-pm@vger.kernel.org +Description: + Minimum supply temperature trip-wire value where the supply will + notify user-space of the event. This is normally used for the + charging scenario where user-space needs to know the supply + temperature has crossed a lower threshold so it can take + appropriate action (e.g. warning user that the supply + temperature is high, and charging current has been reduced + accordingly to remedy the situation). + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_max +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum allowed supply temperature for operation. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//temp_min +Date: July 2014 +Contact: linux-pm@vger.kernel.org +Description: + Reports the mainimum allowed supply temperature for operation. + + Access: Read + Valid values: Represented in 1/10 Degrees Celsius + +What: /sys/class/power_supply//voltage_max +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the maximum VBUS voltage the supply can support. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_min +Date: January 2008 +Contact: linux-pm@vger.kernel.org +Description: + Reports the minimum VBUS voltage the supply can support. + + Access: Read + Valid values: Represented in microvolts + +What: /sys/class/power_supply//voltage_now +Date: May 2007 +Contact: linux-pm@vger.kernel.org +Description: + Reports the VBUS voltage supplied now. This value is generally + read-only reporting, unless the 'online' state of the supply + is set to be programmable, in which case this value can be set + within the reported min/max range. + + Access: Read, Write + Valid values: Represented in microvolts + +===== Device Specific Properties ===== + What: /sys/class/power/ds2760-battery.*/charge_now Date: May 2010 KernelVersion: 2.6.35 diff --git a/MAINTAINERS b/MAINTAINERS index 0a1410d..700bfb7 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -11242,6 +11242,7 @@ M: Sebastian Reichel L: linux-pm@vger.kernel.org T: git git://git.kernel.org/pub/scm/linux/kernel/git/sre/linux-power-supply.git S: Maintained +F: Documentation/ABI/testing/sysfs-class-power F: Documentation/devicetree/bindings/power/supply/ F: include/linux/power_supply.h F: drivers/power/supply/ -- 1.9.1