mirror of
https://gitlab.freedesktop.org/upower/upower.git
synced 2026-05-05 08:48:05 +02:00
Merge branch 'master' of ssh://hughsient@git.freedesktop.org/git/DeviceKit/DeviceKit-power
This commit is contained in:
Richard Hughes
commit
71843411a4
2 changed files with 150 additions and 5 deletions
|
|
@ -8,14 +8,130 @@
|
|||
<doc:doc>
|
||||
<doc:description>
|
||||
<doc:para>
|
||||
TODO: some explanatory text etc. etc. Mention that we
|
||||
collect history to provide more precise values of
|
||||
time-to-empty, time-to-full. Go into detail
|
||||
with the algorithms.
|
||||
Objects implementing this interface are usually discovered through
|
||||
the <doc:tt>org.freedesktop.DeviceKit.Power</doc:tt> interface on
|
||||
the <doc:tt>/org/freedesktop/DeviceKit/Power</doc:tt> object on
|
||||
the D-Bus system bus service with the well-known
|
||||
name <doc:tt>org.freedesktop.DeviceKit.Power</doc:tt> using
|
||||
the
|
||||
<doc:ref type="method" to="Power.EnumerateDevices">EnumerateDevices</doc:ref>
|
||||
method.
|
||||
</doc:para>
|
||||
<doc:para>
|
||||
<doc:example language="shell" title="simple example">
|
||||
<doc:code>
|
||||
$ dbus-send --print-reply \
|
||||
--system \
|
||||
--dest=org.freedesktop.DeviceKit.Power \
|
||||
/org/freedesktop/DeviceKit/Power/devices/battery_BAT0 \
|
||||
org.freedesktop.DBus.Properties.GetAll \
|
||||
string:org.freedesktop.DeviceKit.Power.Device
|
||||
|
||||
method return sender=:1.386 -> dest=:1.477 reply_serial=2
|
||||
array [
|
||||
dict entry(
|
||||
string "native-path"
|
||||
variant string "/sys/devices/LNXSYSTM:00/device:00/PNP0A08:00/device:01/PNP0C09:00/PNP0C0A:00/power_supply/BAT0"
|
||||
)
|
||||
dict entry(
|
||||
string "vendor"
|
||||
variant string "SONY"
|
||||
)
|
||||
dict entry(
|
||||
string "model"
|
||||
variant string "42T4568"
|
||||
)
|
||||
dict entry(
|
||||
string "serial"
|
||||
variant string "4179"
|
||||
)
|
||||
dict entry(
|
||||
string "update-time"
|
||||
variant uint64 1226417875
|
||||
)
|
||||
dict entry(
|
||||
string "type"
|
||||
variant string "battery"
|
||||
)
|
||||
dict entry(
|
||||
string "power-supply"
|
||||
variant boolean true
|
||||
)
|
||||
dict entry(
|
||||
string "has-history"
|
||||
variant boolean true
|
||||
)
|
||||
dict entry(
|
||||
string "has-statistics"
|
||||
variant boolean true
|
||||
)
|
||||
dict entry(
|
||||
string "online"
|
||||
variant boolean false
|
||||
)
|
||||
dict entry(
|
||||
string "energy"
|
||||
variant double 72.85
|
||||
)
|
||||
dict entry(
|
||||
string "energy-empty"
|
||||
variant double 0
|
||||
)
|
||||
dict entry(
|
||||
string "energy-full"
|
||||
variant double 74.55
|
||||
)
|
||||
dict entry(
|
||||
string "energy-full-design"
|
||||
variant double 74.88
|
||||
)
|
||||
dict entry(
|
||||
string "energy-rate"
|
||||
variant double 0
|
||||
)
|
||||
dict entry(
|
||||
string "voltage"
|
||||
variant double 16.415
|
||||
)
|
||||
dict entry(
|
||||
string "time-to-empty"
|
||||
variant int64 0
|
||||
)
|
||||
dict entry(
|
||||
string "time-to-full"
|
||||
variant int64 0
|
||||
)
|
||||
dict entry(
|
||||
string "percentage"
|
||||
variant double 97.7197
|
||||
)
|
||||
dict entry(
|
||||
string "is-present"
|
||||
variant boolean true
|
||||
)
|
||||
dict entry(
|
||||
string "state"
|
||||
variant string "fully-charged"
|
||||
)
|
||||
dict entry(
|
||||
string "is-rechargeable"
|
||||
variant boolean true
|
||||
)
|
||||
dict entry(
|
||||
string "capacity"
|
||||
variant double 100
|
||||
)
|
||||
dict entry(
|
||||
string "technology"
|
||||
variant string "lithium-ion"
|
||||
)
|
||||
]
|
||||
</doc:code>
|
||||
</doc:example>
|
||||
</doc:para>
|
||||
<doc:para>
|
||||
Unless otherwise noted, an empty string or the value 0 in a
|
||||
property means not set.
|
||||
property on this interface means not set.
|
||||
</doc:para>
|
||||
</doc:description>
|
||||
</doc:doc>
|
||||
|
|
|
|||
|
|
@ -4,6 +4,35 @@
|
|||
<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
|
||||
|
||||
<interface name="org.freedesktop.DeviceKit.Power">
|
||||
<doc:doc>
|
||||
<doc:description>
|
||||
<doc:para>
|
||||
The DeviceKit-power service is available via the system message
|
||||
bus. To access the service, use
|
||||
the <doc:tt>org.freedesktop.DeviceKit.Power</doc:tt> interface on
|
||||
the <doc:tt>/org/freedesktop/DeviceKit/Power</doc:tt> object on
|
||||
the D-Bus system bus service with the well-known
|
||||
name <doc:tt>org.freedesktop.DeviceKit.Power</doc:tt>.
|
||||
</doc:para>
|
||||
<doc:para>
|
||||
<doc:example language="shell" title="simple example">
|
||||
<doc:code>
|
||||
$ dbus-send --print-reply \
|
||||
--system \
|
||||
--dest=org.freedesktop.DeviceKit.Power \
|
||||
/org/freedesktop/DeviceKit/Power \
|
||||
org.freedesktop.DeviceKit.Power.EnumerateDevices
|
||||
|
||||
method return sender=:1.386 -> dest=:1.451 reply_serial=2
|
||||
array [
|
||||
object path "/org/freedesktop/DeviceKit/Power/devices/line_power_AC"
|
||||
object path "/org/freedesktop/DeviceKit/Power/devices/battery_BAT0"
|
||||
]
|
||||
</doc:code>
|
||||
</doc:example>
|
||||
</doc:para>
|
||||
</doc:description>
|
||||
</doc:doc>
|
||||
|
||||
<!-- ************************************************************ -->
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue