Warning, /plasma/powerdevil/daemon/dbus/org.freedesktop.UPower.Device.xml is written in an unsupported language. File is not indexed.
0001 <!DOCTYPE node PUBLIC 0002 "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" 0003 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd" [ 0004 <!ENTITY ERROR_GENERAL "org.freedesktop.UPower.Device.GeneralError"> 0005 ]> 0006 <node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd"> 0007 <interface name="org.freedesktop.UPower.Device"> 0008 <doc:doc> 0009 <doc:description> 0010 <doc:para> 0011 Objects implementing this interface are usually discovered through 0012 the <doc:tt>org.freedesktop.UPower</doc:tt> interface on 0013 the <doc:tt>/org/freedesktop/UPower</doc:tt> object on 0014 the D-Bus system bus service with the well-known 0015 name <doc:tt>org.freedesktop.UPower</doc:tt> using 0016 the 0017 <doc:ref type="method" to="Power.EnumerateDevices">EnumerateDevices</doc:ref> 0018 method. 0019 </doc:para> 0020 <doc:para> 0021 <doc:example language="shell" title="simple example"> 0022 <doc:code> 0023 $ dbus-send --print-reply \ 0024 --system \ 0025 --dest=org.freedesktop.UPower \ 0026 /org/freedesktop/UPower/devices/battery_BAT0 \ 0027 org.freedesktop.DBus.Properties.GetAll \ 0028 string:org.freedesktop.UPower.Device 0029 0030 method return sender=:1.386 -> dest=:1.477 reply_serial=2 0031 array [ 0032 dict entry( 0033 string "native-path" 0034 variant string "/sys/devices/LNXSYSTM:00/device:00/PNP0A08:00/device:01/PNP0C09:00/PNP0C0A:00/power_supply/BAT0" 0035 ) 0036 dict entry( 0037 string "vendor" 0038 variant string "SONY" 0039 ) 0040 dict entry( 0041 string "model" 0042 variant string "42T4568" 0043 ) 0044 dict entry( 0045 string "serial" 0046 variant string "4179" 0047 ) 0048 dict entry( 0049 string "update-time" 0050 variant uint64 1226417875 0051 ) 0052 dict entry( 0053 string "type" 0054 variant uint 2 0055 ) 0056 dict entry( 0057 string "power-supply" 0058 variant boolean true 0059 ) 0060 dict entry( 0061 string "has-history" 0062 variant boolean true 0063 ) 0064 dict entry( 0065 string "has-statistics" 0066 variant boolean true 0067 ) 0068 dict entry( 0069 string "online" 0070 variant boolean false 0071 ) 0072 dict entry( 0073 string "energy" 0074 variant double 72.85 0075 ) 0076 dict entry( 0077 string "energy-empty" 0078 variant double 0 0079 ) 0080 dict entry( 0081 string "energy-full" 0082 variant double 74.55 0083 ) 0084 dict entry( 0085 string "energy-full-design" 0086 variant double 74.88 0087 ) 0088 dict entry( 0089 string "energy-rate" 0090 variant double 0 0091 ) 0092 dict entry( 0093 string "voltage" 0094 variant double 16.415 0095 ) 0096 dict entry( 0097 string "time-to-empty" 0098 variant int64 0 0099 ) 0100 dict entry( 0101 string "time-to-full" 0102 variant int64 0 0103 ) 0104 dict entry( 0105 string "percentage" 0106 variant double 97.7197 0107 ) 0108 dict entry( 0109 string "is-present" 0110 variant boolean true 0111 ) 0112 dict entry( 0113 string "state" 0114 variant uint 3 0115 ) 0116 dict entry( 0117 string "is-rechargeable" 0118 variant boolean true 0119 ) 0120 dict entry( 0121 string "capacity" 0122 variant double 100 0123 ) 0124 dict entry( 0125 string "technology" 0126 variant uint 1 0127 ) 0128 ] 0129 </doc:code> 0130 </doc:example> 0131 </doc:para> 0132 <doc:para> 0133 Unless otherwise noted, an empty string or the value 0 in a 0134 property on this interface means not set. 0135 </doc:para> 0136 </doc:description> 0137 </doc:doc> 0138 0139 0140 <!-- ************************************************************ --> 0141 <method name="Refresh"> 0142 <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> 0143 <doc:doc> 0144 <doc:description> 0145 <doc:para> 0146 Refreshes the data collected from the power source. 0147 </doc:para> 0148 </doc:description> 0149 <doc:permission>Callers will need to make sure that the daemon was started in debug mode</doc:permission> 0150 <doc:errors> 0151 <doc:error name="&ERROR_GENERAL;">if an error occured while refreshing</doc:error> 0152 </doc:errors> 0153 </doc:doc> 0154 </method> 0155 0156 <!-- ************************************************************ --> 0157 <!-- 0158 <method name="GetHistory"> 0159 <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> 0160 <arg name="type" direction="in" type="s"> 0161 <doc:doc><doc:summary>The type of history. 0162 Valid types are <doc:tt>rate</doc:tt> or <doc:tt>charge</doc:tt>.</doc:summary></doc:doc> 0163 </arg> 0164 <arg name="timespan" direction="in" type="u"> 0165 <doc:doc><doc:summary>The amount of data to return in seconds, or 0 for all.</doc:summary></doc:doc> 0166 </arg> 0167 <arg name="resolution" direction="in" type="u"> 0168 <doc:doc> 0169 <doc:summary> 0170 The approximate number of points to return. 0171 A higher resolution is more accurate, at the expense of plotting speed. 0172 </doc:summary> 0173 </doc:doc> 0174 </arg> 0175 <arg name="data" direction="out" type="a(udu)"> 0176 <doc:doc><doc:summary> 0177 The history data for the power device, if the device supports history. 0178 Data is ordered from the earliest in time, to the newest data point. 0179 Each element contains the following members: 0180 <doc:list> 0181 <doc:item> 0182 <doc:term>time</doc:term> 0183 <doc:definition> 0184 The time value in seconds from the <doc:tt>gettimeofday()</doc:tt> method. 0185 </doc:definition> 0186 </doc:item> 0187 <doc:item> 0188 <doc:term>value</doc:term> 0189 <doc:definition> 0190 The data value, for instance the rate in W or the charge in %. 0191 </doc:definition> 0192 </doc:item> 0193 <doc:item> 0194 <doc:term>state</doc:term> 0195 <doc:definition> 0196 The state of the device, for instance <doc:tt>charging</doc:tt> or 0197 <doc:tt>discharging</doc:tt>. 0198 </doc:definition> 0199 </doc:item> 0200 </doc:list> 0201 </doc:summary></doc:doc> 0202 </arg> 0203 <doc:doc> 0204 <doc:description> 0205 <doc:para> 0206 Gets history for the power device that is persistent across reboots. 0207 </doc:para> 0208 </doc:description> 0209 </doc:doc> 0210 </method> 0211 --> 0212 0213 <!-- ************************************************************ --> 0214 <!-- 0215 <method name="GetStatistics"> 0216 <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> 0217 <arg name="type" direction="in" type="s"> 0218 <doc:doc><doc:summary>The mode for the statistics. 0219 Valid types are <doc:tt>charging</doc:tt> or <doc:tt>discharging</doc:tt>.</doc:summary></doc:doc> 0220 </arg> 0221 <arg name="data" direction="out" type="a(dd)"> 0222 <doc:doc><doc:summary> 0223 The statistics data for the power device. 0224 Each element contains the following members: 0225 <doc:list> 0226 <doc:item> 0227 <doc:term>value</doc:term> 0228 <doc:definition> 0229 The value of the percentage point, usually in seconds 0230 </doc:definition> 0231 </doc:item> 0232 <doc:item> 0233 <doc:term>accuracy</doc:term> 0234 <doc:definition> 0235 The accuracy of the prediction in percent. 0236 </doc:definition> 0237 </doc:item> 0238 </doc:list> 0239 </doc:summary></doc:doc> 0240 </arg> 0241 <doc:doc> 0242 <doc:description> 0243 <doc:para> 0244 Gets statistics for the power device that may be interesting 0245 to show on a graph in the session. 0246 </doc:para> 0247 </doc:description> 0248 </doc:doc> 0249 </method> 0250 --> 0251 0252 <!-- ************************************************************ --> 0253 <property name="NativePath" type="s" access="read"> 0254 <doc:doc> 0255 <doc:description> 0256 <doc:para> 0257 OS specific native path of the power source. On Linux this 0258 is the sysfs path, for 0259 example <doc:tt>/sys/devices/LNXSYSTM:00/device:00/PNP0C0A:00/power_supply/BAT0</doc:tt>. Is 0260 blank if the device is being driven by a user space 0261 driver. 0262 </doc:para> 0263 </doc:description> 0264 </doc:doc> 0265 </property> 0266 0267 <property name="Vendor" type="s" access="read"> 0268 <doc:doc> 0269 <doc:description> 0270 <doc:para> 0271 Name of the vendor of the battery. 0272 </doc:para> 0273 </doc:description> 0274 </doc:doc> 0275 </property> 0276 0277 <property name="Model" type="s" access="read"> 0278 <doc:doc> 0279 <doc:description> 0280 <doc:para> 0281 Name of the model of this battery. 0282 </doc:para> 0283 </doc:description> 0284 </doc:doc> 0285 </property> 0286 0287 <property name="Serial" type="s" access="read"> 0288 <doc:doc> 0289 <doc:description> 0290 <doc:para> 0291 Unique serial number of the battery. 0292 </doc:para> 0293 </doc:description> 0294 </doc:doc> 0295 </property> 0296 0297 <property name="UpdateTime" type="t" access="read"> 0298 <doc:doc> 0299 <doc:description> 0300 <doc:para> 0301 The point in time (seconds since the Epoch Jan 1, 1970 0302 0:00 UTC) that data was read from the power source. 0303 </doc:para> 0304 </doc:description> 0305 </doc:doc> 0306 </property> 0307 0308 <property name="Type" type="u" access="read"> 0309 <doc:doc> 0310 <doc:description> 0311 <doc:para> 0312 Type of power source. 0313 </doc:para> 0314 <doc:list> 0315 <doc:item> 0316 <doc:term>0</doc:term><doc:definition>Unknown</doc:definition> 0317 </doc:item> 0318 <doc:item> 0319 <doc:term>1</doc:term><doc:definition>Line Power</doc:definition> 0320 </doc:item> 0321 <doc:item> 0322 <doc:term>2</doc:term><doc:definition>Battery</doc:definition> 0323 </doc:item> 0324 <doc:item> 0325 <doc:term>3</doc:term><doc:definition>Ups</doc:definition> 0326 </doc:item> 0327 <doc:item> 0328 <doc:term>4</doc:term><doc:definition>Monitor</doc:definition> 0329 </doc:item> 0330 <doc:item> 0331 <doc:term>5</doc:term><doc:definition>Mouse</doc:definition> 0332 </doc:item> 0333 <doc:item> 0334 <doc:term>6</doc:term><doc:definition>Keyboard</doc:definition> 0335 </doc:item> 0336 <doc:item> 0337 <doc:term>7</doc:term><doc:definition>Pda</doc:definition> 0338 </doc:item> 0339 <doc:item> 0340 <doc:term>8</doc:term><doc:definition>Phone</doc:definition> 0341 </doc:item> 0342 </doc:list> 0343 <doc:para> 0344 If the value is set to "Battery", you will need to verify that the 0345 property <doc:ref type="property" to="Source:PowerSupply">power-supply</doc:ref> 0346 has the value "true" before considering it as a laptop battery. Otherwise it 0347 will likely be the battery for a device of an unknown type. 0348 </doc:para> 0349 </doc:description> 0350 </doc:doc> 0351 </property> 0352 0353 <property name="PowerSupply" type="b" access="read"> 0354 <doc:doc> 0355 <doc:description> 0356 <doc:para> 0357 If the power device is used to supply the system. 0358 This would be set TRUE for laptop batteries and UPS devices, 0359 but set FALSE for wireless mice or PDAs. 0360 </doc:para> 0361 </doc:description> 0362 </doc:doc> 0363 </property> 0364 0365 <property name="HasHistory" type="b" access="read"> 0366 <doc:doc> 0367 <doc:description> 0368 <doc:para> 0369 If the power device has history. 0370 </doc:para> 0371 </doc:description> 0372 </doc:doc> 0373 </property> 0374 0375 <property name="HasStatistics" type="b" access="read"> 0376 <doc:doc> 0377 <doc:description> 0378 <doc:para> 0379 If the power device has statistics. 0380 </doc:para> 0381 </doc:description> 0382 </doc:doc> 0383 </property> 0384 0385 <property name="Online" type="b" access="read"> 0386 <doc:doc> 0387 <doc:description> 0388 <doc:para> 0389 Whether power is currently being provided through line power. 0390 This property is only valid if the property 0391 <doc:ref type="property" to="Source:Type">type</doc:ref> 0392 has the value "line-power". 0393 </doc:para> 0394 </doc:description> 0395 </doc:doc> 0396 </property> 0397 0398 <property name="Energy" type="d" access="read"> 0399 <doc:doc> 0400 <doc:description> 0401 <doc:para> 0402 Amount of energy (measured in Wh) currently available in 0403 the power source. 0404 </doc:para><doc:para> 0405 This property is only valid if the property 0406 <doc:ref type="property" to="Source:Type">type</doc:ref> 0407 has the value "battery". 0408 </doc:para> 0409 </doc:description> 0410 </doc:doc> 0411 </property> 0412 0413 <property name="EnergyEmpty" type="d" access="read"> 0414 <doc:doc> 0415 <doc:description> 0416 <doc:para> 0417 Amount of energy (measured in Wh) in the power source when 0418 it's considered to be empty. 0419 </doc:para><doc:para> 0420 This property is only valid if the property 0421 <doc:ref type="property" to="Source:Type">type</doc:ref> 0422 has the value "battery". 0423 </doc:para> 0424 </doc:description> 0425 </doc:doc> 0426 </property> 0427 0428 <property name="EnergyFull" type="d" access="read"> 0429 <doc:doc> 0430 <doc:description> 0431 <doc:para> 0432 Amount of energy (measured in Wh) in the power source when 0433 it's considered full. 0434 </doc:para><doc:para> 0435 This property is only valid if the property 0436 <doc:ref type="property" to="Source:Type">type</doc:ref> 0437 has the value "battery". 0438 </doc:para> 0439 </doc:description> 0440 </doc:doc> 0441 </property> 0442 0443 <property name="EnergyFullDesign" type="d" access="read"> 0444 <doc:doc> 0445 <doc:description> 0446 <doc:para> 0447 Amount of energy (measured in Wh) the power source is 0448 designed to hold when it's considered full. 0449 </doc:para><doc:para> 0450 This property is only valid if the property 0451 <doc:ref type="property" to="Source:Type">type</doc:ref> 0452 has the value "battery". 0453 </doc:para> 0454 </doc:description> 0455 </doc:doc> 0456 </property> 0457 0458 <property name="EnergyRate" type="d" access="read"> 0459 <doc:doc> 0460 <doc:description> 0461 <doc:para> 0462 Amount of energy being drained from the source, measured 0463 in W. If positive, the source is being discharged, if 0464 negative it's being charged. 0465 </doc:para><doc:para> 0466 This property is only valid if the property 0467 <doc:ref type="property" to="Source:Type">type</doc:ref> 0468 has the value "battery". 0469 </doc:para> 0470 </doc:description> 0471 </doc:doc> 0472 </property> 0473 0474 <property name="Voltage" type="d" access="read"> 0475 <doc:doc> 0476 <doc:description> 0477 <doc:para> 0478 Voltage in the Cell or being recorded by the meter. 0479 </doc:para> 0480 </doc:description> 0481 </doc:doc> 0482 </property> 0483 0484 <property name="ChargeCycles" type="i" access="read"> 0485 <doc:doc> 0486 <doc:description> 0487 <doc:para> 0488 The number of charge cycles as defined by the TCO certification, or -1 if 0489 that value is unknown or not applicable. 0490 </doc:para> 0491 </doc:description> 0492 </doc:doc> 0493 </property> 0494 0495 <property name="Luminosity" type="d" access="read"> 0496 <doc:doc> 0497 <doc:description> 0498 <doc:para> 0499 Luminosity being recorded by the meter. 0500 </doc:para> 0501 </doc:description> 0502 </doc:doc> 0503 </property> 0504 0505 <property name="TimeToEmpty" type="x" access="read"> 0506 <doc:doc> 0507 <doc:description> 0508 <doc:para> 0509 Number of seconds until the power source is considered empty. 0510 Is set to 0 if unknown. 0511 </doc:para><doc:para> 0512 This property is only valid if the property 0513 <doc:ref type="property" to="Source:Type">type</doc:ref> 0514 has the value "battery". 0515 </doc:para> 0516 </doc:description> 0517 </doc:doc> 0518 </property> 0519 0520 <property name="TimeToFull" type="x" access="read"> 0521 <doc:doc> 0522 <doc:description> 0523 <doc:para> 0524 Number of seconds until the power source is considered full. 0525 Is set to 0 if unknown. 0526 </doc:para><doc:para> 0527 This property is only valid if the property 0528 <doc:ref type="property" to="Source:Type">type</doc:ref> 0529 has the value "battery". 0530 </doc:para> 0531 </doc:description> 0532 </doc:doc> 0533 </property> 0534 0535 <property name="Percentage" type="d" access="read"> 0536 <doc:doc> 0537 <doc:description> 0538 <doc:para> 0539 The amount of energy left in the power source expressed as 0540 a percentage between 0 and 100. Typically this is the same as 0541 (<doc:ref type="property" to="Source:Energy">energy</doc:ref> - 0542 <doc:ref type="property" to="Source:EnergyEmpty">energy-empty</doc:ref>) / 0543 (<doc:ref type="property" to="Source:EnergyFull">energy-full</doc:ref> - 0544 <doc:ref type="property" to="Source:EnergyEmpty">energy-empty</doc:ref>). 0545 However, some primitive power sources are capable of only 0546 reporting percentages and in this case the energy-* 0547 properties will be unset while this property is set. 0548 </doc:para><doc:para> 0549 This property is only valid if the property 0550 <doc:ref type="property" to="Source:Type">type</doc:ref> 0551 has the value "battery". 0552 </doc:para> 0553 <doc:para> 0554 The percentage will be an approximation if the <doc:ref type="property" to="BatteryLevel">battery level</doc:ref> 0555 is set to something other than None. The percentage is kept for compatibility reasons. 0556 </doc:para> 0557 </doc:description> 0558 </doc:doc> 0559 </property> 0560 0561 <property name="Temperature" type="d" access="read"> 0562 <doc:doc> 0563 <doc:description> 0564 <doc:para> 0565 The temperature of the device in degrees Celsius. This property is 0566 only valid if the property 0567 <doc:ref type="property" to="Source:Type">type</doc:ref> 0568 has the value "battery". 0569 </doc:para> 0570 </doc:description> 0571 </doc:doc> 0572 </property> 0573 0574 <property name="IsPresent" type="b" access="read"> 0575 <doc:doc> 0576 <doc:description> 0577 <doc:para> 0578 If the power source is present in the bay. 0579 This field is required as some batteries are hot-removable, for example 0580 expensive UPS and most laptop batteries. 0581 </doc:para><doc:para> 0582 This property is only valid if the property 0583 <doc:ref type="property" to="Source:Type">type</doc:ref> 0584 has the value "battery". 0585 </doc:para> 0586 </doc:description> 0587 </doc:doc> 0588 </property> 0589 0590 <property name="State" type="u" access="read"> 0591 <doc:doc> 0592 <doc:description> 0593 <doc:para> 0594 The battery power state. 0595 </doc:para> 0596 <doc:list> 0597 <doc:item> 0598 <doc:term>0</doc:term><doc:definition>Unknown</doc:definition> 0599 </doc:item> 0600 <doc:item> 0601 <doc:term>1</doc:term><doc:definition>Charging</doc:definition> 0602 </doc:item> 0603 <doc:item> 0604 <doc:term>2</doc:term><doc:definition>Discharging</doc:definition> 0605 </doc:item> 0606 <doc:item> 0607 <doc:term>3</doc:term><doc:definition>Empty</doc:definition> 0608 </doc:item> 0609 <doc:item> 0610 <doc:term>4</doc:term><doc:definition>Fully charged</doc:definition> 0611 </doc:item> 0612 <doc:item> 0613 <doc:term>5</doc:term><doc:definition>Pending charge</doc:definition> 0614 </doc:item> 0615 <doc:item> 0616 <doc:term>6</doc:term><doc:definition>Pending discharge</doc:definition> 0617 </doc:item> 0618 </doc:list> 0619 <doc:para> 0620 This property is only valid if the property 0621 <doc:ref type="property" to="Source:Type">type</doc:ref> 0622 has the value "battery". 0623 </doc:para> 0624 </doc:description> 0625 </doc:doc> 0626 </property> 0627 0628 <property name="IsRechargeable" type="b" access="read"> 0629 <doc:doc> 0630 <doc:description> 0631 <doc:para> 0632 If the power source is rechargeable. 0633 </doc:para><doc:para> 0634 This property is only valid if the property 0635 <doc:ref type="property" to="Source:Type">type</doc:ref> 0636 has the value "battery". 0637 </doc:para> 0638 </doc:description> 0639 </doc:doc> 0640 </property> 0641 0642 <property name="Capacity" type="d" access="read"> 0643 <doc:doc> 0644 <doc:description> 0645 <doc:para> 0646 The capacity of the power source expressed as a percentage between 0 and 100. 0647 The capacity of the battery will reduce with age. 0648 A capacity value less than 75% is usually a sign that you should renew your battery. 0649 Typically this value is the same as 0650 (<doc:ref type="property" to="Source:FullDesign">full-design</doc:ref> / 0651 <doc:ref type="property" to="Source:Full">full</doc:ref>) * 100. 0652 However, some primitive power sources are not capable reporting capacity 0653 and in this case the capacity property will be unset. 0654 </doc:para><doc:para> 0655 This property is only valid if the property 0656 <doc:ref type="property" to="Source:Type">type</doc:ref> 0657 has the value "battery". 0658 </doc:para> 0659 </doc:description> 0660 </doc:doc> 0661 </property> 0662 0663 <property name="Technology" type="u" access="read"> 0664 <doc:doc> 0665 <doc:description> 0666 <doc:para> 0667 Technology used in the battery: 0668 </doc:para> 0669 <doc:list> 0670 <doc:item> 0671 <doc:term>0</doc:term><doc:definition>Unknown</doc:definition> 0672 </doc:item> 0673 <doc:item> 0674 <doc:term>1</doc:term><doc:definition>Lithium ion</doc:definition> 0675 </doc:item> 0676 <doc:item> 0677 <doc:term>2</doc:term><doc:definition>Lithium polymer</doc:definition> 0678 </doc:item> 0679 <doc:item> 0680 <doc:term>3</doc:term><doc:definition>Lithium iron phosphate</doc:definition> 0681 </doc:item> 0682 <doc:item> 0683 <doc:term>4</doc:term><doc:definition>Lead acid</doc:definition> 0684 </doc:item> 0685 <doc:item> 0686 <doc:term>5</doc:term><doc:definition>Nickel cadmium</doc:definition> 0687 </doc:item> 0688 <doc:item> 0689 <doc:term>6</doc:term><doc:definition>Nickel metal hydride</doc:definition> 0690 </doc:item> 0691 </doc:list> 0692 <doc:para> 0693 This property is only valid if the property 0694 <doc:ref type="property" to="Source:Type">type</doc:ref> 0695 has the value "battery". 0696 </doc:para> 0697 </doc:description> 0698 </doc:doc> 0699 </property> 0700 0701 <property name="WarningLevel" type="u" access="read"> 0702 <doc:doc> 0703 <doc:description> 0704 <doc:para> 0705 Warning level of the battery: 0706 </doc:para> 0707 <doc:list> 0708 <doc:item> 0709 <doc:term>0</doc:term><doc:definition>Unknown</doc:definition> 0710 </doc:item> 0711 <doc:item> 0712 <doc:term>1</doc:term><doc:definition>None</doc:definition> 0713 </doc:item> 0714 <doc:item> 0715 <doc:term>2</doc:term><doc:definition>Discharging (only for UPSes)</doc:definition> 0716 </doc:item> 0717 <doc:item> 0718 <doc:term>3</doc:term><doc:definition>Low</doc:definition> 0719 </doc:item> 0720 <doc:item> 0721 <doc:term>4</doc:term><doc:definition>Critical</doc:definition> 0722 </doc:item> 0723 <doc:item> 0724 <doc:term>5</doc:term><doc:definition>Action</doc:definition> 0725 </doc:item> 0726 </doc:list> 0727 </doc:description> 0728 </doc:doc> 0729 </property> 0730 0731 <property name="BatteryLevel" type="u" access="read"> 0732 <doc:doc> 0733 <doc:description> 0734 <doc:para> 0735 The level of the battery for devices which do not report a percentage but rather a coarse battery level. If the value 0736 is None, then the device does not support coarse battery reporting, and the percentage should be used instead. 0737 </doc:para> 0738 <doc:list> 0739 <doc:item> 0740 <doc:term>0</doc:term><doc:definition>Unknown</doc:definition> 0741 </doc:item> 0742 <doc:item> 0743 <doc:term>1</doc:term><doc:definition>None (the battery does not use a coarse level of battery reporting)</doc:definition> 0744 </doc:item> 0745 <doc:item> 0746 <doc:term>3</doc:term><doc:definition>Low</doc:definition> 0747 </doc:item> 0748 <doc:item> 0749 <doc:term>4</doc:term><doc:definition>Critical</doc:definition> 0750 </doc:item> 0751 <doc:item> 0752 <doc:term>6</doc:term><doc:definition>Normal</doc:definition> 0753 </doc:item> 0754 <doc:item> 0755 <doc:term>7</doc:term><doc:definition>High</doc:definition> 0756 </doc:item> 0757 <doc:item> 0758 <doc:term>8</doc:term><doc:definition>Full</doc:definition> 0759 </doc:item> 0760 </doc:list> 0761 </doc:description> 0762 </doc:doc> 0763 </property> 0764 0765 <property name="IconName" type="s" access="read"> 0766 <doc:doc> 0767 <doc:description> 0768 <doc:para> 0769 <p>An icon name, following the <a href="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">Icon Naming Specification</a></p> 0770 <p>Note that the icons might not match end-user expectations in terms of presentation relative to the amount of battery left or perceived to be left. It is recommended that front-ends use the BatteryLevel property first, if available, followed by the Percentage, to present a more realistic battery level to the user.</p> 0771 </doc:para> 0772 </doc:description> 0773 </doc:doc> 0774 </property> 0775 </interface> 0776 0777 </node>