You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
389 lines
8.0 KiB
389 lines
8.0 KiB
11 years ago
|
/* This file is part of the TDE libraries
|
||
|
Copyright (C) 2012 Timothy Pearson <kb9vqf@pearsoncomputing.net>
|
||
|
(C) 2013 Golubev Alexander <fatzer2@gmail.com>
|
||
|
|
||
|
This library is free software; you can redistribute it and/or
|
||
|
modify it under the terms of the GNU Library General Public
|
||
|
License version 2 as published by the Free Software Foundation.
|
||
|
|
||
|
This library is distributed in the hope that it will be useful,
|
||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
Library General Public License for more details.
|
||
|
|
||
|
You should have received a copy of the GNU Library General Public License
|
||
|
along with this library; see the file COPYING.LIB. If not, write to
|
||
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
||
|
Boston, MA 02110-1301, USA.
|
||
|
*/
|
||
|
|
||
|
#ifndef _TDEGENERICDEVICE_H
|
||
|
#define _TDEGENERICDEVICE_H
|
||
|
|
||
|
#include <tqobject.h>
|
||
|
#include <tqstring.h>
|
||
|
|
||
|
#include "tdelibs_export.h"
|
||
|
#include "kicontheme.h"
|
||
|
|
||
|
// Keep readGenericDeviceTypeFromString(), getFriendlyDeviceTypeStringFromType(), and getDeviceTypeIconFromType() in tdehardwaredevices.cpp in sync with this enum
|
||
|
namespace TDEGenericDeviceType {
|
||
|
enum TDEGenericDeviceType {
|
||
|
Root,
|
||
|
RootSystem,
|
||
|
CPU,
|
||
|
GPU,
|
||
|
RAM,
|
||
|
Bus,
|
||
|
I2C,
|
||
|
MDIO,
|
||
|
Mainboard,
|
||
|
Disk,
|
||
|
SCSI,
|
||
|
StorageController,
|
||
|
Mouse,
|
||
|
Keyboard,
|
||
|
HID,
|
||
|
Modem,
|
||
|
Monitor,
|
||
|
Network,
|
||
|
Printer,
|
||
|
Scanner,
|
||
|
Sound,
|
||
|
VideoCapture,
|
||
|
IEEE1394,
|
||
|
PCMCIA,
|
||
|
Camera,
|
||
|
TextIO,
|
||
|
Serial,
|
||
|
Parallel,
|
||
|
Peripheral,
|
||
|
Backlight,
|
||
|
Battery,
|
||
|
PowerSupply,
|
||
|
Dock,
|
||
|
ThermalSensor,
|
||
|
ThermalControl,
|
||
|
BlueTooth,
|
||
|
Bridge,
|
||
|
Platform,
|
||
|
Cryptography,
|
||
|
Event,
|
||
|
Input,
|
||
|
PNP,
|
||
|
OtherACPI,
|
||
|
OtherUSB,
|
||
|
OtherMultimedia,
|
||
|
OtherPeripheral,
|
||
|
OtherSensor,
|
||
|
OtherVirtual,
|
||
|
Other,
|
||
|
Last = Other
|
||
|
};
|
||
|
};
|
||
|
|
||
|
class TDECORE_EXPORT TDEGenericDevice : public TQObject
|
||
|
{
|
||
|
Q_OBJECT
|
||
|
|
||
|
public:
|
||
|
/**
|
||
|
* Constructor.
|
||
|
* @param Device type
|
||
|
*/
|
||
|
TDEGenericDevice(TDEGenericDeviceType::TDEGenericDeviceType dt, TQString dn=TQString::null);
|
||
|
|
||
|
/**
|
||
|
* Destructor.
|
||
|
*/
|
||
|
~TDEGenericDevice();
|
||
|
|
||
|
/**
|
||
|
* @return a TDEGenericDeviceType::TDEGenericDeviceType specifying the device type
|
||
|
*/
|
||
|
TDEGenericDeviceType::TDEGenericDeviceType type();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the device name, if any
|
||
|
*/
|
||
|
TQString name();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the vendor name, if any
|
||
|
*/
|
||
|
TQString vendorName();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the vendor model, if any
|
||
|
*/
|
||
|
TQString vendorModel();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the serial number, if any
|
||
|
*/
|
||
|
TQString serialNumber();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with a friendly name
|
||
|
*
|
||
|
* While TDE tries very hard to generate and return a friendly name for this device,
|
||
|
* sometimes the best it will be able to do is "Unknown Device [xxxx:yyyy]"
|
||
|
*/
|
||
|
virtual TQString friendlyName();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the device bus name, if any
|
||
|
*/
|
||
|
TQString deviceBus();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the system path, if any
|
||
|
*
|
||
|
* This method is non-portable, so be careful!
|
||
|
*/
|
||
|
TQString systemPath();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the system device node, if any
|
||
|
*
|
||
|
* This method is non-portable, so be careful!
|
||
|
*/
|
||
|
TQString deviceNode();
|
||
|
|
||
|
/**
|
||
|
* @return true if this device has been blacklisted for update actions
|
||
|
*/
|
||
|
bool blacklistedForUpdate();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString containing a unique identifier for this device
|
||
|
*/
|
||
|
TQString uniqueID();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the vendor ID, if any
|
||
|
*/
|
||
|
TQString vendorID();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the model ID, if any
|
||
|
*/
|
||
|
TQString modelID();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the encoded vendor, if any
|
||
|
*/
|
||
|
TQString vendorEncoded();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the encoded model, if any
|
||
|
*/
|
||
|
TQString modelEncoded();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the subvendor ID, if any
|
||
|
*/
|
||
|
TQString subVendorID();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the submodel ID, if any
|
||
|
*/
|
||
|
TQString subModelID();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the PCI device class, if any
|
||
|
*/
|
||
|
TQString PCIClass();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the module alias string, if any
|
||
|
*/
|
||
|
TQString moduleAlias();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the device driver, if any
|
||
|
*/
|
||
|
TQString deviceDriver();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString with the subsystem type, if any
|
||
|
*/
|
||
|
TQString subsystem();
|
||
|
|
||
|
/**
|
||
|
* @return a TDEGenericDevice* with the parent device, if any
|
||
|
*/
|
||
|
TDEGenericDevice* parentDevice();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString containing the friendly type name
|
||
|
*/
|
||
|
virtual TQString friendlyDeviceType();
|
||
|
|
||
|
/**
|
||
|
* @return a TQString containing the device bus ID, if any
|
||
|
*/
|
||
|
TQString busID();
|
||
|
|
||
|
/**
|
||
|
* Get an icon for this device
|
||
|
* @param size a TDEIcon::StdSizes structure specifying the desired icon size
|
||
|
* @return a TQPixmap containing the icon for the specified type
|
||
|
*/
|
||
|
virtual TQPixmap icon(TDEIcon::StdSizes size);
|
||
|
|
||
|
protected:
|
||
|
/**
|
||
|
* @param a TQString with the device name, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetName(TQString dn);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the vendor name, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetVendorName(TQString vn);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the vendor model, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetVendorModel(TQString vm);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the serial number, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetSerialNumber(TQString sn);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the device bus name, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetDeviceBus(TQString db);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the system path, if any
|
||
|
* @internal
|
||
|
*
|
||
|
* This method is non-portable, so be careful!
|
||
|
*/
|
||
|
void internalSetSystemPath(TQString sp);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the system device node, if any
|
||
|
* @internal
|
||
|
*
|
||
|
* This method is non-portable, so be careful!
|
||
|
*/
|
||
|
void internalSetDeviceNode(TQString sn);
|
||
|
|
||
|
/**
|
||
|
* @param bl true if this device has been blacklisted for update actions
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetBlacklistedForUpdate(bool bl);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the vendor ID, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetVendorID(TQString id);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the model ID, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetModelID(TQString id);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the encoded vendor, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetVendorEncoded(TQString id);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the encoded model, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetModelEncoded(TQString id);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the subvendor ID, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetSubVendorID(TQString id);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the submodel ID, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetSubModelID(TQString id);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the PCI device class, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetPCIClass(TQString cl);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the module alias string, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetModuleAlias(TQString ma);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the device driver, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetDeviceDriver(TQString dr);
|
||
|
|
||
|
/**
|
||
|
* @param a TQString with the subsystem type, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetSubsystem(TQString ss);
|
||
|
|
||
|
/**
|
||
|
* @param a TDEGenericDevice* with the parent device, if any
|
||
|
* @internal
|
||
|
*/
|
||
|
void internalSetParentDevice(TDEGenericDevice* pd);
|
||
|
|
||
|
private:
|
||
|
TDEGenericDeviceType::TDEGenericDeviceType m_deviceType;
|
||
|
TQString m_deviceName;
|
||
|
TQString m_systemPath;
|
||
|
TQString m_deviceNode;
|
||
|
TQString m_vendorName;
|
||
|
TQString m_vendorModel;
|
||
|
TQString m_serialNumber;
|
||
|
TQString m_deviceBus;
|
||
|
TQString m_uniqueID;
|
||
|
TQString m_vendorID;
|
||
|
TQString m_modelID;
|
||
|
TQString m_vendorenc;
|
||
|
TQString m_modelenc;
|
||
|
TQString m_subvendorID;
|
||
|
TQString m_submodelID;
|
||
|
TQString m_pciClass;
|
||
|
TQString m_modAlias;
|
||
|
TQString m_deviceDriver;
|
||
|
TQString m_subsystem;
|
||
|
TQString m_friendlyName;
|
||
|
bool m_blacklistedForUpdate;
|
||
|
TDEGenericDevice* m_parentDevice;
|
||
|
|
||
|
// Internal use only!
|
||
|
TQStringList m_externalSubtype;
|
||
|
TQString m_externalRulesFile;
|
||
|
TQString m_udevtype;
|
||
|
TQString m_udevdevicetypestring;
|
||
|
TQString udevdevicetypestring_alt;
|
||
|
|
||
|
friend class TDEHardwareDevices;
|
||
|
};
|
||
|
|
||
|
#endif // _TDEGENERICDEVICE_H
|