DtkSystemSettings
dtk library for systemsettings.
载入中...
搜索中...
未找到
Dtk::Power::DPowerDevice类 参考

电源设备类,用于管理电源设备的数据和属性 更多...

#include <dpowerdevice.h>

类 Dtk::Power::DPowerDevice 继承关系图:
Dtk::Power::DPowerDevice 的协作图:

Public 槽

DExpected< PowerHistoryList > history (const QString &type, const uint timespan, const uint resolution) const
 获取在重新引导期间持续存在的电源设备的历史记录
 
DExpected< PowerStatisticList > statistics (const QString &type) const
 获取功率设备的统计信息, 这些统计信息可能会在会话中的图形界面上显示
 
DExpected< void > refresh ()
 刷新信息
 

信号

void updateTimeChanged (const QDateTime &value)
 从电源读取数据的时间点发生改变
 
void percentageChanged (const double value)
 电源百分比发生改变
 
void timeToEmptyChanged (const qint64 value)
 电源消耗到空的时间发生改变
 
void timeToFullChanged (const qint64 value)
 电源充满时间发生改变
 
void energyRateChanged (const double value)
 电源消耗的能量发生改变, 以W为单位
 
void energyChanged (const double value)
 电源中当前可用的能量发生改变
 
void iconNameChanged (const QString &value)
 电源图标发生改变
 

Public 成员函数

bool hasHistory () const
 电源设备是否有历史记录
 
bool hasStatistics () const
 电源设备是否有电源设备具有统计信息
 
bool isPresent () const
 电源设备是否有电源设备具有统计信息
 
bool isRechargeable () const
 电源设备是否可充电
 
bool online () const
 电源设备当前是否通过线路电源提供电源。仅当属性类型具有值 line-power 时, 此属性才有效。
 
bool powerSupply () const
 如果电源设备用于为系统供电。对于笔记本电脑电池和UPS设备, 这将设置为TRUE, 但对于无线鼠标或掌上电脑设置为FALSE
 
double capacity () const
 电源的容量表示为0和100之间的百分比。
 
double energy () const
 电源中当前可用的能量 (以Wh为单位)
 
double energyEmpty () const
 当电源被认为是空的时, 电源中的能量 (以Wh为单位)
 
double energyFull () const
 当电源被认为充满时, 电源中的能量 (以Wh为单位)
 
double energyFullDesign () const
 电池设计的最大容量, 以Wh作为单位
 
double energyRate () const
 电源消耗的能量, 以W为单位。如果是正数, 电源正在放电, 如果是负数, 电源正在充电
 
double luminosity () const
 仪表记录的光度
 
double percentage () const
 功率源中剩余的能量表示为0和100之间的百分比。
 
double temperature () const
 设备的温度, 以摄氏度为单位。
 
double voltage () const
 电池中的电压或被仪表记录的值。
 
qint32 chargeCycles () const
 TCO认证定义的充电周期数, 如果该值未知或不适用, 则为-1。(systemd>=251)
 
qint64 timeToEmpty () const
 直到电源被认为是空的秒数。如果未知, 则设置为0
 
qint64 timeToFull () const
 电池充电达到被认为充满所需的秒数。如果未知, 则设置为0
 
QString iconName () const
 图标名称, 遵循图标命名规范
 
QString model () const
 这种电池型号的名称
 
QString nativePath () const
 操作系统特定的电源本机路径。在Linux上, 这是sysfs路径, 例如/sys/devices/LNXSYSTM:00/device:00/PNP0C0A:00/power_supply/BAT0. 如果设备由用户空间驱动程序驱动, 则为空白
 
QString serial () const
 电池的唯一序列号
 
QString vendor () const
 电池供应商的名称
 
quint32 batteryLevel () const
 不报告百分比而是报告粗略电池电量的设备的电池电量。如果该值为None, 则该设备不支持粗略的电池报告, 应改用百分比
 
quint32 state () const
 电池电量状态
 
quint32 technology () const
 电池使用技术
 
quint32 type () const
 电源类型
 
quint32 warningLevel () const
 电池警告级别
 
QDateTime updateTime () const
 从电源读取数据的时间点 (从世界协调时1970年1月1日开始的0:00秒)。(本质还是unix时间戳)
 
QString deviceName () const
 获取当前device名称(唯一id)
 

属性

bool hasHistory
 
bool hasStatistics
 
bool isPresent
 
bool isRechargeable
 
bool online
 
bool powerSupply
 
double capacity
 
double energy
 
double energyEmpty
 
double energyFull
 
double energyFullDesign
 
double energyRate
 
double luminosity
 
double percentage
 
double temperature
 
double voltage
 
uint chargeCycles
 
qint64 timeToEmpty
 
qint64 timeToFull
 
QString iconName
 
QString model
 
QString nativePath
 
QString serial
 
QString vendor
 
uint batteryLevel
 
uint state
 
uint technology
 
uint type
 
uint warningLevel
 
QDateTime updateTime
 
QString deviceName
 

友元

class DPowerManager
 

详细描述

电源设备类,用于管理电源设备的数据和属性

成员函数说明

◆ batteryLevel()

uint DPowerDevice::batteryLevel ( ) const

不报告百分比而是报告粗略电池电量的设备的电池电量。如果该值为None, 则该设备不支持粗略的电池报告, 应改用百分比

返回
  • 0: 未知
  • 1: 无(电池不使用粗略级别的电池报告)
  • 3:
  • 4: 临界
  • 6: 正常
  • 7:
  • 8:

◆ capacity()

double DPowerDevice::capacity ( ) const

电源的容量表示为0和100之间的百分比。

电池的容量会随着使用的增长而减少。 小于75的容量值通常表示您应该更新电池。通常, 此值与 (full-design / full) * 100相同。 但是, 某些原始电源无法报告容量, 在这种情况下, 容量属性将被取消。

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ chargeCycles()

int DPowerDevice::chargeCycles ( ) const

TCO认证定义的充电周期数, 如果该值未知或不适用, 则为-1。(systemd>=251)

返回
整数

◆ deviceName()

QString DPowerDevice::deviceName ( ) const

获取当前device名称(唯一id)

signal

◆ energy()

double DPowerDevice::energy ( ) const

电源中当前可用的能量 (以Wh为单位)

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ energyChanged

void DPowerDevice::energyChanged ( const double  value)
signal

电源中当前可用的能量发生改变

参数
[in]value电源中可用能量

◆ energyEmpty()

double DPowerDevice::energyEmpty ( ) const

当电源被认为是空的时, 电源中的能量 (以Wh为单位)

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ energyFull()

double DPowerDevice::energyFull ( ) const

当电源被认为充满时, 电源中的能量 (以Wh为单位)

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ energyFullDesign()

double DPowerDevice::energyFullDesign ( ) const

电池设计的最大容量, 以Wh作为单位

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ energyRate()

double DPowerDevice::energyRate ( ) const

电源消耗的能量, 以W为单位。如果是正数, 电源正在放电, 如果是负数, 电源正在充电

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ energyRateChanged

void DPowerDevice::energyRateChanged ( const double  value)
signal

电源消耗的能量发生改变, 以W为单位

参数
[in]value消耗的能量正数是放电负数是充电

◆ hasHistory()

bool DPowerDevice::hasHistory ( ) const

电源设备是否有历史记录

返回
布尔值

◆ hasStatistics()

bool DPowerDevice::hasStatistics ( ) const

电源设备是否有电源设备具有统计信息

返回
布尔值

◆ history

QList< History > DPowerDevice::history ( const QString &  type,
const uint  timespan,
const uint  resolution 
) const
slot

获取在重新引导期间持续存在的电源设备的历史记录

参数
[in]typehistory的类型。有效类型是rateor或者 charge。
[in]timespan以秒为单位返回的数据量, 或者全部为0
[in]resolution要返回的近似点数。更高的分辨率更准确, 但以牺牲绘图速度为代价
返回
data:电源设备的历史数据(如果设备支持历史)。数据从最早的时间到最新的数据点进行排序。每个元素包含以下成员: -* time: 以秒为单位的时间值, 从 gettimeofday() 方法获取 -* value: 数据值, 比如以W为单位的增长速率或者以百分比为单位的充电百分比 -* state: 设备的状态, 例如charging或 discharging。

◆ iconName()

QString DPowerDevice::iconName ( ) const

图标名称, 遵循图标命名规范

注解
相对于剩余或感知到的剩余电量, 图标在呈现方面可能与最终用户的期望不匹配。 建议前端首先使用BatteryLevel属性 (如果可用), 然后使用百分比, 以向用户呈现更真实的电池电量
返回
字符串

◆ iconNameChanged

void DPowerDevice::iconNameChanged ( const QString &  value)
signal

电源图标发生改变

参数
[in]value电源图标名

◆ isPresent()

bool DPowerDevice::isPresent ( ) const

电源设备是否有电源设备具有统计信息

返回
布尔值

◆ isRechargeable()

bool DPowerDevice::isRechargeable ( ) const

电源设备是否可充电

返回
布尔值

◆ luminosity()

double DPowerDevice::luminosity ( ) const

仪表记录的光度

(我也不能理解光度是什么意思, 大概也许可能是屏幕亮度或者环境亮度? 使用d-feet软件也无法获取其值)

返回
双精度浮点数

◆ model()

QString DPowerDevice::model ( ) const

这种电池型号的名称

返回
字符串

◆ nativePath()

QString DPowerDevice::nativePath ( ) const

操作系统特定的电源本机路径。在Linux上, 这是sysfs路径, 例如/sys/devices/LNXSYSTM:00/device:00/PNP0C0A:00/power_supply/BAT0. 如果设备由用户空间驱动程序驱动, 则为空白

返回
字符串

◆ online()

bool DPowerDevice::online ( ) const

电源设备当前是否通过线路电源提供电源。仅当属性类型具有值 line-power 时, 此属性才有效。

返回
布尔值

◆ percentage()

double DPowerDevice::percentage ( ) const

功率源中剩余的能量表示为0和100之间的百分比。

通常这与 (energy - energy-empty) / (energy-full - energy-empty)相同。 但是, 某些原始电源只能报告百分比, 在这种情况下, 在设置此属性时, 将取消设置energy* 属性。

注解
仅当type属性类型具有值battery时, 此属性才有效
如果battery level被设置为无以外的东西, 百分比将是一个近似值。 百分比的保留是出于兼容性的考虑
返回
双精度浮点数

◆ percentageChanged

void DPowerDevice::percentageChanged ( const double  value)
signal

电源百分比发生改变

参数
[in]value电源百分比

◆ powerSupply()

bool DPowerDevice::powerSupply ( ) const

如果电源设备用于为系统供电。对于笔记本电脑电池和UPS设备, 这将设置为TRUE, 但对于无线鼠标或掌上电脑设置为FALSE

返回
布尔值

◆ refresh

void DPowerDevice::refresh ( )
slot

刷新信息

◆ serial()

QString DPowerDevice::serial ( ) const

电池的唯一序列号

返回
字符串

◆ state()

uint DPowerDevice::state ( ) const

电池电量状态

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
  • 0: 未知
  • 1: 充电
  • 2: 未充电
  • 3:
  • 4: 充满电
  • 5: 待充电
  • 6: 待放电

◆ statistics

QList< Statistics > DPowerDevice::statistics ( const QString &  type) const
slot

获取功率设备的统计信息, 这些统计信息可能会在会话中的图形界面上显示

参数
[in]type统计模式。有效类型是 charging 或者 discharging
返回
电源设备的统计数据。每个元素包含以下成员: -* value: 百分比的值, 通常以秒为单位 -* accuracy: 预测的准确性, 以百分比表示

◆ technology()

uint DPowerDevice::technology ( ) const

电池使用技术

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
  • 0: 未知
  • 1: 锂离子
  • 2: 锂聚合物电池
  • 3: 磷酸铁锂电池
  • 4: 铅酸电池
  • 5: 镍铬电池
  • 6: 镍氢电池

◆ temperature()

double DPowerDevice::temperature ( ) const

设备的温度, 以摄氏度为单位。

注解
仅当type属性类型具有值battery时, 此属性才有效
返回
双精度浮点数

◆ timeToEmpty()

qint64 DPowerDevice::timeToEmpty ( ) const

直到电源被认为是空的秒数。如果未知, 则设置为0

返回
长整数

◆ timeToEmptyChanged

void DPowerDevice::timeToEmptyChanged ( const qint64  value)
signal

电源消耗到空的时间发生改变

参数
[in]value时间段

◆ timeToFull()

qint64 DPowerDevice::timeToFull ( ) const

电池充电达到被认为充满所需的秒数。如果未知, 则设置为0

返回
长整数

◆ timeToFullChanged

void DPowerDevice::timeToFullChanged ( const qint64  value)
signal

电源充满时间发生改变

参数
[in]value时间段

◆ type()

uint DPowerDevice::type ( ) const

电源类型

注解
power-supply 如果该值设置为“电池”, 则在将其视为笔记本电脑电池之前 , 您需要验证该属性的值是否为“真”。否则, 它很可能是未知类型设备的电池。
返回
  • 0: Unknown
  • 1: 线路电源
  • 2: 电池
  • 3: Ups不间断电源
  • 4: 监控
  • 5: 鼠标
  • 6: 键盘
  • 7: 掌上电脑
  • 8: 手机

◆ updateTime()

QDateTime DPowerDevice::updateTime ( ) const

从电源读取数据的时间点 (从世界协调时1970年1月1日开始的0:00秒)。(本质还是unix时间戳)

返回
返回为一个qdatetime对象
参见
QDateTime使用方法
注解
返回的时间并不直接可用, 返回是是世界标准时间GMT, 需要根据实际情况调整时区增减

◆ updateTimeChanged

void DPowerDevice::updateTimeChanged ( const QDateTime &  value)
signal

从电源读取数据的时间点发生改变

参数
[in]valueQDateTime对象

◆ vendor()

QString DPowerDevice::vendor ( ) const

电池供应商的名称

返回
字符串

◆ voltage()

double DPowerDevice::voltage ( ) const

电池中的电压或被仪表记录的值。

返回
双精度浮点数

◆ warningLevel()

uint DPowerDevice::warningLevel ( ) const

电池警告级别

返回
  • 0: 未知
  • 1:
  • 2: 放电(仅适用于UPS不间断电源)
  • 3:
  • 4: 临界
  • 5: Action

该类的文档由以下文件生成: