Evgenii LegotckoiСәуір 1, 2017, 12:16 Т.Қ.

Qt Linux - 003-сабақ. libacpi көмегімен ноутбук батареясының деңгейін тексеру

Мазмұны

1. либакпи
2. Кітапхананы пайдалану
3. Қолданбаның негізгі терезесі
1. 1. виджет.h
2. 2. widget.cpp
4. Виджеттер
1. 1. batterywidget.h
2. 2. batterywidget.cpp
5. Кітапхананың нәтижесі

Форумда Qt кітапханасы арқылы Linux жүйесінде ноутбуктің батарея деңгейін тексеру туралы әңгіме болды. Шындығында, Qt қазіргі уақытта батарея зарядын тексеруге мүмкіндік беретін сыныпты қамтамасыз етпейді.Бірақ мұндай функционалдылықты libacpi. сияқты үшінші тарап кітапханалары арқылы жүзеге асыруға болады.

Кем дегенде кейбір деректерді қабылдайтын және келесідей болатын қосымшаны жасауға тырысайық:

либакпи

Кітапхананың өзі C тілінде жазылған және қызықтыратын келесі функциялар мен деректер құрылымдарына ие:

global_t - желдеткіштердің, батареялардың және жылу аймақтарының санын сақтайтын жаһандық деректер құрылымы, сондай-ақ қуат адаптері бар құрылым.
init_acpi_batt(global_t *globals) - батарея деректерін инициализациялау
init_acpi_acadapt(global_t *globals) - адаптер деректерін инициализациялау
init_acpi_fan(global_t *globals) - желдеткіш деректерін баптандыру
init_acpi_thermal(global_t *globals) - жылу аймақтары туралы деректерді инициализациялау
read_acpi_batt(int num) - батарея деректерін оқу
read_acpi_zone(int num, global_t *globals) - жылу аймағы деректерін оқу
read_acpi_fan(int num) - желдеткіш деректерін оқу
battery_t - батарея деректерінің құрылымы
fans_t - желдеткіш деректерінің құрылымы
thermal_t - жылу аймағы деректерінің құрылымы
battery_t батареялар [MAX_ITEMS] - батареялар жиымы, онда read_acpi_batt шақырылғанда деректер сақталады.
thermal_t термиялықтар [MAX_ITEMS] - термиялық аймақтардың жиымы, деректер read_acpi_zone шақырылғанда сақталады.
fan_t желдеткіштер [MAX_ITEMS] - желдеткіштер массиві, деректер read_acpi_fan шақырылғанда сақталады.

Кітапхананы пайдалану

Кітапхананы Qt жобасында пайдалану үшін сізге қажет:

Репозиторийден кітапхананы орнатыңыз:

sudo apt-get install libacpi-dev

Кітапхананы pro жоба файлына қосыңыз:

LIBS += -lacpi

Кітапхананың тақырып файлын бастапқы код файлына қосыңыз, онда ол батарея заряды туралы деректерді алады:

#ifdef __cplusplus
extern "C" {
#endif

#include <libacpi.h>

#ifdef __cplusplus
}
#endif

Қолданбаның негізгі терезесі

Қолданбаның негізгі терезесі - ui файлы арқылы жасалған және интерфейсі графикалық дизайнер арқылы жасалған виджет класы. Оның ScrollArea бар, ол элементтерді тік орналастыру нысанын, кітапхана таба алатын нәрсеге байланысты динамикалық түрде жасалатын виджеттерді қамтиды. Сондай-ақ кітапхананың деректерді оқуды бастау түймесі бар.

виджет.h

Тақырып файлы батареяларға, желдеткіштерге және жылу аймақтарына арналған виджеттері бар векторларды жариялайды. Қуат адаптері бар виджеттің көрсеткіші де жарияланған. Барлық виджеттер теңшелетін сыныптар. Сәл әрі қарай виджеттердің бірінің коды мысал ретінде беріледі.

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

#include "batterywidget.h"
#include "adapterwidget.h"
#include "fanwidget.h"
#include "thermalwidget.h"

namespace Ui {
class Widget;
}

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget *parent = 0);
    ~Widget();

private slots:
    void on_pushButton_clicked();

private:
    Ui::Widget *ui;
    QVector<BatteryWidget*> m_butteryWidgetList;    // Вектор виджетов с батареями
    QVector<FanWidget*> m_fanWidgetList;            // Вектор виджетов с вентиляторами
    QVector<ThermalWidget*> m_thermalWidgetList;    // Вектор виджетов с тепловыми зонами
    AdapterWidget* m_adapterWidget;                 // Виджет для адаптера питания всегда один
};

#endif // WIDGET_H

widget.cpp

Кітапхана Си тілінде жазылғандықтан, оның процедуралық кодты орындау стилі бар. Сондай-ақ бір кішкентай трюк бар. Кітапханада деректер жазылатын бірнеше жаһандық айнымалылар бар. Бұл желдеткіштері, жылу аймақтары және батареялары бар массивтер.

Яғни, read_acpi_batt(1) функциясын шақырған кезде battery_t деректер құрылымын battery[1]. жиым ұяшығына жазасыз.

Жоғарыда аталған барлық құрылымдардың саны туралы мәліметтерді қамтитын ғаламдық құрылымды құру үшін жадты бөлу қажет.

#include "widget.h"
#include "ui_widget.h"

#ifdef __cplusplus
extern "C" {
#endif

#include <libacpi.h>

#ifdef __cplusplus
}
#endif

#include <QFileDialog>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget),
    m_adapterWidget(nullptr)
{
    ui->setupUi(this);
}

Widget::~Widget()
{
    delete ui;
}

void Widget::on_pushButton_clicked()
{
    // Выделяем память под глобальную структуру данных бибилотеки
    global_t *global = static_cast<global_t*>(malloc(sizeof(global_t)));

    // Инициализируем структуру для
    init_acpi_batt(global);     // батареи
    init_acpi_acadapt(global);  // адаптера питания
    init_acpi_fan(global);      // вентиляторов
    init_acpi_thermal(global);  // тепловых зон

    // Battery
    battery_t *binfo;

    // Если нашлись батареи, то считываем в цикле данные и добавляем виджеты
    for(int i=0; i < global->batt_count; i++)
    {
        read_acpi_batt(i);      // считываем данные
        // которые считываются в специальный массив batteries - он есть в самой библиотеке
        binfo = &batteries[i];

        BatteryWidget* butteryWidget;
        // Создаём виджет
        if (m_butteryWidgetList.count() <= i)
        {
            butteryWidget = new BatteryWidget(this);
            butteryWidget->setTitle(QString(binfo->name));
            m_butteryWidgetList.append(butteryWidget);
            ui->verticalLayout->addWidget(butteryWidget);
        }
        else
        {
            // Или забираем его из списка виджетов
            butteryWidget = m_butteryWidgetList.at(i);
        }

        // Устанавливаем
        butteryWidget->setPercentage(binfo->percentage);        // Процент заряда
        butteryWidget->setChargeTime(binfo->charge_time);       // Время до полного заряда
        butteryWidget->setRemainingTime(binfo->remaining_time); // Время до полного разряда

        // Определяем статус заряда
        switch (binfo->charge_state)
        {
        case C_CHARGE:
            butteryWidget->setChargeState("Charging");
            break;
        case C_DISCHARGE:
            butteryWidget->setChargeState("Discharging");
        case C_CHARGED:
            butteryWidget->setChargeState("Charged");
        case C_NOINFO:
            butteryWidget->setChargeState("No info");
        default:
            butteryWidget->setChargeState("Error");
            break;
        }
    }

    // Adapter
    // Настройка виджета для адптера питания
    adapter_t *ac = &global->adapt;

    if (!m_adapterWidget)
    {
        m_adapterWidget = new AdapterWidget(this);
        ui->verticalLayout->addWidget(m_adapterWidget);
    }

    // Здесь проверяем только, подключён или нет
    switch (ac->ac_state)
    {
    case P_AC:
        m_adapterWidget->setStatus("Runs on AC");
        break;
    case P_BATT:
        m_adapterWidget->setStatus("Runs on battery");
    default:
        m_adapterWidget->setStatus("Error");
        break;
    }

    // Fan
    fan_t *finfo;

    // Если нашлись вентиляторы, то считываем в цикле данные и добавляем виджеты
    for(int i=0; i < global->fan_count; i++)
    {
        read_acpi_fan(i);   // считываем данные
        // которые считываются в специальный массив fans - он есть в самой библиотеке
        finfo = &fans[i];
        FanWidget* fanWidget;

        // Создаём виджет
        if (m_fanWidgetList.count() <= i)
        {
            fanWidget = new FanWidget(this);
            fanWidget->setTitle(QString(finfo->name));
            m_fanWidgetList.append(fanWidget);
            ui->verticalLayout->addWidget(fanWidget);
        }
        else
        {
            // Или забираем его из списка виджетов
            fanWidget = m_fanWidgetList.at(i);
        }

        // Устанавливаем статус, включён или нет
        switch (finfo->fan_state)
        {
        case F_ON:
            fanWidget->setStatus("ON");
            break;
        case F_OFF:
            fanWidget->setStatus("OFF");
        default:
            fanWidget->setStatus("Error");
            break;
        }
    }

    // Thermal
    thermal_t *tinfo;

    // Если нашлись тепловые зоны, то считываем в цикле данные и добавляем виджеты
    for(int i=0; i < global->fan_count; i++)
    {
        read_acpi_zone(i, global);  // считываем данные
        // которые считываются в специальный массив thermals - он есть в самой библиотеке
        tinfo = &thermals[i];
        ThermalWidget* thermalWidget;

        // Создаём виджет
        if (m_thermalWidgetList.count() <= i)
        {
            thermalWidget = new ThermalWidget(this);
            thermalWidget->setTitle(QString(tinfo->name));
            m_thermalWidgetList.append(thermalWidget);
            ui->verticalLayout->addWidget(thermalWidget);
        }
        else
        {
            // Или забираем его из списка виджетов
            thermalWidget = m_thermalWidgetList.at(i);
        }

        thermalWidget->setTemperature(tinfo->temperature);  // Устанавливаем температуру
        thermalWidget->setFrequency(tinfo->frequency);      // и частоту
    }

    free(global);
}

Виджеттер

Бағдарламада жоғарыда аталған құрылымдардың барлығына арналған виджеттер бар. Олар тек ақпаратты көрсету және динамикалық қосу үшін қызмет етеді. Мен мысал ретінде батарея туралы ақпаратты көрсететін виджетті беремін.

batterywidget.h

#ifndef BATTERYWIDGET_H
#define BATTERYWIDGET_H

#include <QWidget>

namespace Ui {
class BatteryWidget;
}

class BatteryWidget : public QWidget
{
    Q_OBJECT

public:
    explicit BatteryWidget(QWidget *parent = 0);
    ~BatteryWidget();

    void setTitle(QString title);               // Название батареи (как определено в ОС Linux)
    void setPercentage(int percentage);         // Процент заряда
    void setChargeTime(int chargeTime);         // Время до полного заряда в минутах
    void setRemainingTime(int remainingTime);   // Время до полного разряда в минутах
    void setChargeState(QString chargeState);   // Состояние

private:
    Ui::BatteryWidget *ui;
};

#endif // BATTERYWIDGET_H

batterywidget.cpp

#include "batterywidget.h"
#include "ui_batterywidget.h"

BatteryWidget::BatteryWidget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::BatteryWidget)
{
    ui->setupUi(this);
}

BatteryWidget::~BatteryWidget()
{
    delete ui;
}

void BatteryWidget::setTitle(QString title)
{
    ui->label_title->setText(title);
}

void BatteryWidget::setPercentage(int percentage)
{
    ui->label_percentage->setText(QString::number(percentage));
}

void BatteryWidget::setChargeTime(int chargeTime)
{
    ui->label_charge_time->setText(QString("%1:%2").arg(chargeTime / 60).arg(chargeTime % 60));
}

void BatteryWidget::setRemainingTime(int remainingTime)
{
    ui->label_remaining_time->setText(QString("%1:%2").arg(remainingTime / 60).arg(remainingTime % 60));
}

void BatteryWidget::setChargeState(QString chargeState)
{
    ui->label_charge_state->setText(chargeState);
}

Кітапхананың нәтижесі

Кітапхананың нәтижесін мен қанағаттанарлық деп атар едім, бірақ ол батарея зарядының пайызын, сондай-ақ батареяны толық зарядтау уақытын анықтайды. Бірақ ол шығарылғанға дейінгі уақытты анықтаған жоқ. Сондай-ақ ешқандай желдеткіштер мен жылу аймақтары табылмады. Менің ноутбук үлгісінде бұл деректер жай ғана қол жетімді емес деп ойлаймын. Сондай-ақ кейбір құрылым параметрлеріне қол жеткізу әрекеті кезінде қолданбаның мерзімді бұзылуы болды.

Мақаланың басындағы скриншот кітапхана менің ноутбугымда таба алған деректерді көрсетеді. Әрине, мұнда барлық деректер берілмейді, егер сіз кітапхананың тақырып файлын қарасаңыз, құрылымдар параметрлердің неғұрлым бай таңдауын қамтамасыз ететінін көресіз. Бірақ бұл кітапхананың іске қосылғанын көрсету үшін жеткілікті деп ойлаймын.

Жобаны өз бетіңізше іске қосып көріңіз және мүмкіндігінше бұл кітапхана ноутбукта жылу аймақтары мен желдеткіштерді тапса, жазылымнан бас тартыңыз.

Жоба қолданбалары