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

#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]	type	history的类型。有效类型是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。

返回: 布尔值

◆ 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] value QDateTime对象

◆ vendor()

QString DPowerDevice::vendor ( ) const

电池供应商的名称

返回: 字符串

◆ voltage()

double DPowerDevice::voltage ( ) const

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

返回: 双精度浮点数

◆ warningLevel()

uint DPowerDevice::warningLevel ( ) const

电池警告级别

返回

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

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

include/power/dpowerdevice.h
docs/power/dpowerdevice.zh_CN.dox

Public 槽

信号

Public 成员函数

属性

友元

详细描述

成员函数说明

◆ batteryLevel()

◆ capacity()

◆ chargeCycles()

◆ deviceName()

◆ energy()

◆ energyChanged

◆ energyEmpty()

◆ energyFull()

◆ energyFullDesign()

◆ energyRate()

◆ energyRateChanged

◆ hasHistory()

◆ hasStatistics()

◆ history

◆ iconName()

◆ iconNameChanged

◆ isPresent()

◆ isRechargeable()

◆ luminosity()

◆ model()

◆ nativePath()

◆ online()

◆ percentage()

◆ percentageChanged

◆ powerSupply()

◆ serial()

◆ state()

◆ statistics

◆ technology()

◆ temperature()

◆ timeToEmpty()

◆ timeToEmptyChanged

◆ timeToFull()

◆ timeToFullChanged

◆ type()

◆ updateTime()

◆ updateTimeChanged

◆ vendor()

◆ voltage()

◆ warningLevel()