Contents

Prerequisites

A working KDE4 development environment. Documentation on setting up a KDE environment can be found here.

Listing Devices

Our first program will be a simple console based app that gets a list of all the hardware devices and prints them out to the screen.

Solid::DeviceNotifier*notifier=Solid::DeviceNotifier::instance();

This gets us the device manager. All the devices are queried through and returned from the device manager. Once we have the list of devices we can interact with them as follows:

foreach(Solid::Devicedevice,Solid::Device::allDevices()){//print the name of devicekDebug()<<device.udi();}

device.udi() returns the Unique Device Identifier for the device as a QString. Even if you have more than one identical device, the UDI is guaranteed to be unique. For example if you have a MythTV box with two PVR-250 T.V. capture cards in it, you will be able to refer to card #1 and #2 by their respective UDI.

Searching for specific devices

This second program makes uses of filters built into the solid framework. Using these filters you can list only devices according to supported capabilities, sub-devices of a given parent, and various predicates. In our example we'll be limiting our list to only audio hardware. A full list of capabilities can be viewed under the Solid::Capability namespace.

Solid::DeviceNotifier*notifier=Solid::DeviceNotifier::instance();//get a list of all devices that are AudioHwforeach(Solid::Devicedevice,Solid::Device::listFromType(Solid::DeviceInterface::AudioInterface,QString())){kDebug()<<device.udi().toLatin1().constData();}

In this example Solid::DeviceManager::findDevicesFromQuery looks for a device with any parent and the Solid::Capability::AudioHw capability. If we had wanted to specify an AudioHw device with the parent "real_specific_parent" it would look like this:

What do we do with a device once we get it?

Now that we got a device, what do we do with it? First let's look at the relationship between the Solid::Device and Solid::Capability. A Solid::Device can contain many Solid::Capability. A device can be tested to have a capability in the following way:

Solid::DeviceNotifier*notifier=Solid::DeviceNotifier::instance();//get a ProcessorQList<Solid::Device>list=Solid::Device::listFromType(Solid::DeviceInterface::Processor,QString());//take the first processorSolid::Devicedevice=list[0];if(device.is<Solid::Processor>())kDebug()<<"We've got a processor!";elsekDebug()<<"Device is not a processor.";Solid::Processor*processor=device.as<Solid::Processor>();kDebug()<<"This processors maximum speed is:"<<processor->maxSpeed();

To actually use this device as a processor we need to do the following: