FwupdDevice

FwupdDevice — a hardware device

Functions

FwupdDevice * fwupd_device_new ()
gchar * fwupd_device_to_string ()
const gchar * fwupd_device_get_id ()
void fwupd_device_set_id ()
const gchar * fwupd_device_get_parent_id ()
void fwupd_device_set_parent_id ()
FwupdDevice * fwupd_device_get_parent ()
void fwupd_device_set_parent ()
void fwupd_device_add_child ()
GPtrArray * fwupd_device_get_children ()
const gchar * fwupd_device_get_name ()
void fwupd_device_set_name ()
const gchar * fwupd_device_get_serial ()
void fwupd_device_set_serial ()
const gchar * fwupd_device_get_summary ()
void fwupd_device_set_summary ()
const gchar * fwupd_device_get_branch ()
void fwupd_device_set_branch ()
const gchar * fwupd_device_get_description ()
void fwupd_device_set_description ()
const gchar * fwupd_device_get_version ()
void fwupd_device_set_version ()
const gchar * fwupd_device_get_version_lowest ()
void fwupd_device_set_version_lowest ()
guint64 fwupd_device_get_version_lowest_raw ()
void fwupd_device_set_version_lowest_raw ()
const gchar * fwupd_device_get_version_bootloader ()
void fwupd_device_set_version_bootloader ()
guint64 fwupd_device_get_version_bootloader_raw ()
void fwupd_device_set_version_bootloader_raw ()
guint64 fwupd_device_get_version_raw ()
void fwupd_device_set_version_raw ()
FwupdVersionFormat fwupd_device_get_version_format ()
void fwupd_device_set_version_format ()
guint32 fwupd_device_get_flashes_left ()
void fwupd_device_set_flashes_left ()
guint32 fwupd_device_get_install_duration ()
void fwupd_device_set_install_duration ()
guint64 fwupd_device_get_flags ()
void fwupd_device_set_flags ()
void fwupd_device_add_flag ()
void fwupd_device_remove_flag ()
gboolean fwupd_device_has_flag ()
guint64 fwupd_device_get_created ()
void fwupd_device_set_created ()
guint64 fwupd_device_get_modified ()
void fwupd_device_set_modified ()
GPtrArray * fwupd_device_get_checksums ()
void fwupd_device_add_checksum ()
const gchar * fwupd_device_get_plugin ()
void fwupd_device_set_plugin ()
const gchar * fwupd_device_get_protocol ()
void fwupd_device_set_protocol ()
void fwupd_device_add_protocol ()
gboolean fwupd_device_has_protocol ()
GPtrArray * fwupd_device_get_protocols ()
const gchar * fwupd_device_get_vendor ()
void fwupd_device_set_vendor ()
const gchar * fwupd_device_get_vendor_id ()
void fwupd_device_set_vendor_id ()
void fwupd_device_add_vendor_id ()
gboolean fwupd_device_has_vendor_id ()
GPtrArray * fwupd_device_get_vendor_ids ()
void fwupd_device_add_guid ()
gboolean fwupd_device_has_guid ()
GPtrArray * fwupd_device_get_guids ()
const gchar * fwupd_device_get_guid_default ()
void fwupd_device_add_instance_id ()
gboolean fwupd_device_has_instance_id ()
GPtrArray * fwupd_device_get_instance_ids ()
void fwupd_device_add_icon ()
GPtrArray * fwupd_device_get_icons ()
FwupdUpdateState fwupd_device_get_update_state ()
void fwupd_device_set_update_state ()
const gchar * fwupd_device_get_update_error ()
void fwupd_device_set_update_error ()
const gchar * fwupd_device_get_update_message ()
void fwupd_device_set_update_message ()
const gchar * fwupd_device_get_update_image ()
void fwupd_device_set_update_image ()
FwupdStatus fwupd_device_get_status ()
void fwupd_device_set_status ()
void fwupd_device_add_release ()
GPtrArray * fwupd_device_get_releases ()
FwupdRelease * fwupd_device_get_release_default ()
gint fwupd_device_compare ()
FwupdDevice * fwupd_device_from_variant ()
GPtrArray * fwupd_device_array_from_variant ()
void fwupd_device_array_ensure_parents ()

Types and Values

Description

An object that represents a physical device on the host.

See also: FwupdRelease

Functions

fwupd_device_new ()

FwupdDevice *
fwupd_device_new (void);

Creates a new device.

Returns

a new FwupdDevice

Since: 0.9.3


fwupd_device_to_string ()

gchar *
fwupd_device_to_string (FwupdDevice *device);

Builds a text representation of the object.

Parameters

device

A FwupdDevice

 

Returns

text, or NULL for invalid

Since: 0.9.3


fwupd_device_get_id ()

const gchar *
fwupd_device_get_id (FwupdDevice *device);

Gets the ID.

Parameters

device

A FwupdDevice

 

Returns

the ID, or NULL if unset

Since: 0.9.3


fwupd_device_set_id ()

void
fwupd_device_set_id (FwupdDevice *device,
                     const gchar *id);

Sets the ID.

Parameters

device

A FwupdDevice

 

id

the device ID, e.g. USB:foo

 

Since: 0.9.3


fwupd_device_get_parent_id ()

const gchar *
fwupd_device_get_parent_id (FwupdDevice *device);

Gets the ID.

Parameters

device

A FwupdDevice

 

Returns

the parent ID, or NULL if unset

Since: 1.0.8


fwupd_device_set_parent_id ()

void
fwupd_device_set_parent_id (FwupdDevice *device,
                            const gchar *parent_id);

Sets the parent ID.

Parameters

device

A FwupdDevice

 

parent_id

the device ID, e.g. USB:foo

 

Since: 1.0.8


fwupd_device_get_parent ()

FwupdDevice *
fwupd_device_get_parent (FwupdDevice *device);

Gets the parent.

Parameters

device

A FwupdDevice

 

Returns

the parent device, or NULL if unset.

[transfer none]

Since: 1.0.8


fwupd_device_set_parent ()

void
fwupd_device_set_parent (FwupdDevice *device,
                         FwupdDevice *parent);

Sets the parent. Only used internally.

Parameters

device

A FwupdDevice

 

parent

another FwupdDevice, or NULL

 

Since: 1.0.8


fwupd_device_add_child ()

void
fwupd_device_add_child (FwupdDevice *device,
                        FwupdDevice *child);

Adds a child device. An child device is logically linked to the primary device in some way.

NOTE: You should never call this function from user code, it is for daemon use only. Only use fwupd_device_set_parent() to set up a logical tree.

Parameters

device

A FwupdDevice

 

child

Another FwupdDevice

 

Since: 1.5.1


fwupd_device_get_children ()

GPtrArray *
fwupd_device_get_children (FwupdDevice *device);

Gets the device children. These can only be assigned using fwupd_device_set_parent().

Parameters

device

A FwupdDevice

 

Returns

the children, which may be empty.

[element-type FwupdDevice][transfer none]

Since: 1.3.7


fwupd_device_get_name ()

const gchar *
fwupd_device_get_name (FwupdDevice *device);

Gets the device name.

Parameters

device

A FwupdDevice

 

Returns

the device name, or NULL if unset

Since: 0.9.3


fwupd_device_set_name ()

void
fwupd_device_set_name (FwupdDevice *device,
                       const gchar *name);

Sets the device name.

Parameters

device

A FwupdDevice

 

name

the device name, e.g. ColorHug2

 

Since: 0.9.3


fwupd_device_get_serial ()

const gchar *
fwupd_device_get_serial (FwupdDevice *device);

Gets the serial number for the device.

Parameters

device

A FwupdDevice

 

Returns

a string value, or NULL if never set.

Since: 1.1.2


fwupd_device_set_serial ()

void
fwupd_device_set_serial (FwupdDevice *device,
                         const gchar *serial);

Sets the serial number for the device.

Parameters

device

A FwupdDevice

 

serial

the device serial number

 

Since: 1.1.2


fwupd_device_get_summary ()

const gchar *
fwupd_device_get_summary (FwupdDevice *device);

Gets the device summary.

Parameters

device

A FwupdDevice

 

Returns

the device summary, or NULL if unset

Since: 0.9.3


fwupd_device_set_summary ()

void
fwupd_device_set_summary (FwupdDevice *device,
                          const gchar *summary);

Sets the device summary.

Parameters

device

A FwupdDevice

 

summary

the device one line summary

 

Since: 0.9.3


fwupd_device_get_branch ()

const gchar *
fwupd_device_get_branch (FwupdDevice *device);

Gets the current device branch.

Parameters

device

A FwupdDevice

 

Returns

the device branch, or NULL if unset

Since: 1.5.0


fwupd_device_set_branch ()

void
fwupd_device_set_branch (FwupdDevice *device,
                         const gchar *branch);

Sets the current device branch.

Parameters

device

A FwupdDevice

 

branch

the device one line branch

 

Since: 1.5.0


fwupd_device_get_description ()

const gchar *
fwupd_device_get_description (FwupdDevice *device);

Gets the device description in AppStream markup format.

Parameters

device

A FwupdDevice

 

Returns

the device description, or NULL if unset

Since: 0.9.3


fwupd_device_set_description ()

void
fwupd_device_set_description (FwupdDevice *device,
                              const gchar *description);

Sets the device description.

Parameters

device

A FwupdDevice

 

description

the description in AppStream markup format

 

Since: 0.9.3


fwupd_device_get_version ()

const gchar *
fwupd_device_get_version (FwupdDevice *device);

Gets the device version.

Parameters

device

A FwupdDevice

 

Returns

the device version, or NULL if unset

Since: 0.9.3


fwupd_device_set_version ()

void
fwupd_device_set_version (FwupdDevice *device,
                          const gchar *version);

Sets the device version.

Parameters

device

A FwupdDevice

 

version

the device version, e.g. 1.2.3

 

Since: 0.9.3


fwupd_device_get_version_lowest ()

const gchar *
fwupd_device_get_version_lowest (FwupdDevice *device);

Gets the lowest version of firmware the device will accept.

Parameters

device

A FwupdDevice

 

Returns

the device version_lowest, or NULL if unset

Since: 0.9.3


fwupd_device_set_version_lowest ()

void
fwupd_device_set_version_lowest (FwupdDevice *device,
                                 const gchar *version_lowest);

Sets the lowest version of firmware the device will accept.

Parameters

device

A FwupdDevice

 

version_lowest

the description

 

Since: 0.9.3


fwupd_device_get_version_lowest_raw ()

guint64
fwupd_device_get_version_lowest_raw (FwupdDevice *device);

Gets the lowest version of firmware the device will accept in raw format.

Parameters

device

A FwupdDevice

 

Returns

integer version number, or 0 if unset

Since: 1.4.0


fwupd_device_set_version_lowest_raw ()

void
fwupd_device_set_version_lowest_raw (FwupdDevice *device,
                                     guint64 version_lowest_raw);

Sets the raw lowest version number from the hardware before converted to a string.

Parameters

device

A FwupdDevice

 

version_lowest_raw

the raw hardware version

 

Since: 1.4.0


fwupd_device_get_version_bootloader ()

const gchar *
fwupd_device_get_version_bootloader (FwupdDevice *device);

Gets the version of the bootloader.

Parameters

device

A FwupdDevice

 

Returns

the device version_bootloader, or NULL if unset

Since: 0.9.3


fwupd_device_set_version_bootloader ()

void
fwupd_device_set_version_bootloader (FwupdDevice *device,
                                     const gchar *version_bootloader);

Sets the bootloader version.

Parameters

device

A FwupdDevice

 

version_bootloader

the description

 

Since: 0.9.3


fwupd_device_get_version_bootloader_raw ()

guint64
fwupd_device_get_version_bootloader_raw
                               (FwupdDevice *device);

Gets the bootloader version of firmware the device will accept in raw format.

Parameters

device

A FwupdDevice

 

Returns

integer version number, or 0 if unset

Since: 1.4.0


fwupd_device_set_version_bootloader_raw ()

void
fwupd_device_set_version_bootloader_raw
                               (FwupdDevice *device,
                                guint64 version_bootloader_raw);

Sets the raw bootloader version number from the hardware before converted to a string.

Parameters

device

A FwupdDevice

 

version_bootloader_raw

the raw hardware version

 

Since: 1.4.0


fwupd_device_get_version_raw ()

guint64
fwupd_device_get_version_raw (FwupdDevice *device);

Gets the raw version number from the hardware before converted to a string.

Parameters

device

A FwupdDevice

 

Returns

the hardware version, or 0 if unset

Since: 1.3.6


fwupd_device_set_version_raw ()

void
fwupd_device_set_version_raw (FwupdDevice *device,
                              guint64 version_raw);

Sets the raw version number from the hardware before converted to a string.

Parameters

device

A FwupdDevice

 

version_raw

the raw hardware version

 

Since: 1.3.6


fwupd_device_get_version_format ()

FwupdVersionFormat
fwupd_device_get_version_format (FwupdDevice *device);

Gets the update state.

Parameters

device

A FwupdDevice

 

Returns

the update state, or FWUPD_VERSION_FORMAT_UNKNOWN if unset

Since: 1.2.9


fwupd_device_set_version_format ()

void
fwupd_device_set_version_format (FwupdDevice *device,
                                 FwupdVersionFormat version_format);

Sets the update state.

Parameters

device

A FwupdDevice

 

version_format

the state, e.g. FWUPD_VERSION_FORMAT_PENDING

 

Since: 1.2.9


fwupd_device_get_flashes_left ()

guint32
fwupd_device_get_flashes_left (FwupdDevice *device);

Gets the number of flash cycles left on the device

Parameters

device

A FwupdDevice

 

Returns

the flash cycles left, or NULL if unset

Since: 0.9.3


fwupd_device_set_flashes_left ()

void
fwupd_device_set_flashes_left (FwupdDevice *device,
                               guint32 flashes_left);

Sets the number of flash cycles left on the device

Parameters

device

A FwupdDevice

 

flashes_left

the description

 

Since: 0.9.3


fwupd_device_get_install_duration ()

guint32
fwupd_device_get_install_duration (FwupdDevice *device);

Gets the time estimate for firmware installation (in seconds)

Parameters

device

A FwupdDevice

 

Returns

the estimated time to flash this device (or 0 if unset)

Since: 1.1.3


fwupd_device_set_install_duration ()

void
fwupd_device_set_install_duration (FwupdDevice *device,
                                   guint32 duration);

Sets the time estimate for firmware installation (in seconds)

Parameters

device

A FwupdDevice

 

duration

The amount of time

 

Since: 1.1.3


fwupd_device_get_flags ()

guint64
fwupd_device_get_flags (FwupdDevice *device);

Gets the device flags.

Parameters

device

A FwupdDevice

 

Returns

the device flags, or 0 if unset

Since: 0.9.3


fwupd_device_set_flags ()

void
fwupd_device_set_flags (FwupdDevice *device,
                        guint64 flags);

Sets the device flags.

Parameters

device

A FwupdDevice

 

flags

the device flags, e.g. FWUPD_DEVICE_FLAG_REQUIRE_AC

 

Since: 0.9.3


fwupd_device_add_flag ()

void
fwupd_device_add_flag (FwupdDevice *device,
                       FwupdDeviceFlags flag);

Adds a specific device flag to the device.

Parameters

device

A FwupdDevice

 

flag

the FwupdDeviceFlags

 

Since: 0.9.3


fwupd_device_remove_flag ()

void
fwupd_device_remove_flag (FwupdDevice *device,
                          FwupdDeviceFlags flag);

Removes a specific device flag from the device.

Parameters

device

A FwupdDevice

 

flag

the FwupdDeviceFlags

 

Since: 0.9.3


fwupd_device_has_flag ()

gboolean
fwupd_device_has_flag (FwupdDevice *device,
                       FwupdDeviceFlags flag);

Finds if the device has a specific device flag.

Parameters

device

A FwupdDevice

 

flag

the FwupdDeviceFlags

 

Returns

TRUE if the flag is set

Since: 0.9.3


fwupd_device_get_created ()

guint64
fwupd_device_get_created (FwupdDevice *device);

Gets when the device was created.

Parameters

device

A FwupdDevice

 

Returns

the UNIX time, or 0 if unset

Since: 0.9.3


fwupd_device_set_created ()

void
fwupd_device_set_created (FwupdDevice *device,
                          guint64 created);

Sets when the device was created.

Parameters

device

A FwupdDevice

 

created

the UNIX time

 

Since: 0.9.3


fwupd_device_get_modified ()

guint64
fwupd_device_get_modified (FwupdDevice *device);

Gets when the device was modified.

Parameters

device

A FwupdDevice

 

Returns

the UNIX time, or 0 if unset

Since: 0.9.3


fwupd_device_set_modified ()

void
fwupd_device_set_modified (FwupdDevice *device,
                           guint64 modified);

Sets when the device was modified.

Parameters

device

A FwupdDevice

 

modified

the UNIX time

 

Since: 0.9.3


fwupd_device_get_checksums ()

GPtrArray *
fwupd_device_get_checksums (FwupdDevice *device);

Gets the device checksums.

Parameters

device

A FwupdDevice

 

Returns

the checksums, which may be empty.

[element-type utf8][transfer none]

Since: 0.9.3


fwupd_device_add_checksum ()

void
fwupd_device_add_checksum (FwupdDevice *device,
                           const gchar *checksum);

Sets the device checksum.

Parameters

device

A FwupdDevice

 

checksum

the device checksum

 

Since: 0.9.3


fwupd_device_get_plugin ()

const gchar *
fwupd_device_get_plugin (FwupdDevice *device);

Gets the plugin that created the device.

Parameters

device

A FwupdDevice

 

Returns

the plugin name, or NULL if unset

Since: 1.0.0


fwupd_device_set_plugin ()

void
fwupd_device_set_plugin (FwupdDevice *device,
                         const gchar *plugin);

Sets the plugin that created the device.

Parameters

device

A FwupdDevice

 

plugin

the plugin name, e.g. colorhug

 

Since: 1.0.0


fwupd_device_get_protocol ()

const gchar *
fwupd_device_get_protocol (FwupdDevice *device);

fwupd_device_get_protocol has been deprecated since version 1.5.8 and should not be used in newly-written code.

Use fwupd_device_get_protocols() instead.

Gets the protocol that the device uses for updating.

Parameters

device

A FwupdDevice

 

Returns

the protocol name, or NULL if unset

Since: 1.3.6


fwupd_device_set_protocol ()

void
fwupd_device_set_protocol (FwupdDevice *device,
                           const gchar *protocol);

fwupd_device_set_protocol has been deprecated since version 1.5.8 and should not be used in newly-written code.

Use fwupd_device_add_protocol() instead.

Sets the protocol that is used to update the device.

Parameters

device

A FwupdDevice

 

protocol

the protocol name, e.g. com.hughski.colorhug

 

Since: 1.3.6


fwupd_device_add_protocol ()

void
fwupd_device_add_protocol (FwupdDevice *device,
                           const gchar *protocol);

Adds a device protocol.

Parameters

device

A FwupdDevice

 

protocol

the ID, e.g. 'USB:0x1234'

 

Since: 1.5.8


fwupd_device_has_protocol ()

gboolean
fwupd_device_has_protocol (FwupdDevice *device,
                           const gchar *protocol);

Finds out if the device has this specific protocol.

Parameters

device

A FwupdDevice

 

protocol

the ID, e.g. 'USB:0x1234'

 

Returns

TRUE if the ID is found

Since: 1.5.8


fwupd_device_get_protocols ()

GPtrArray *
fwupd_device_get_protocols (FwupdDevice *device);

Gets the device protocol.

Parameters

device

A FwupdDevice

 

Returns

the device protocol.

[element-type utf8][transfer none]

Since: 1.5.8


fwupd_device_get_vendor ()

const gchar *
fwupd_device_get_vendor (FwupdDevice *device);

Gets the device vendor.

Parameters

device

A FwupdDevice

 

Returns

the device vendor, or NULL if unset

Since: 0.9.3


fwupd_device_set_vendor ()

void
fwupd_device_set_vendor (FwupdDevice *device,
                         const gchar *vendor);

Sets the device vendor.

Parameters

device

A FwupdDevice

 

vendor

the description

 

Since: 0.9.3


fwupd_device_get_vendor_id ()

const gchar *
fwupd_device_get_vendor_id (FwupdDevice *device);

fwupd_device_get_vendor_id has been deprecated since version 1.5.5 and should not be used in newly-written code.

Use fwupd_device_get_vendor_ids() instead.

Gets the combined device vendor ID.

Parameters

device

A FwupdDevice

 

Returns

the device vendor, e.g. 'USB:0x1234|PCI:0x5678', or NULL if unset

Since: 0.9.4


fwupd_device_set_vendor_id ()

void
fwupd_device_set_vendor_id (FwupdDevice *device,
                            const gchar *vendor_id);

fwupd_device_set_vendor_id has been deprecated since version 1.5.5 and should not be used in newly-written code.

Use fwupd_device_add_vendor_id() instead.

Sets the device vendor ID.

Parameters

device

A FwupdDevice

 

vendor_id

the ID, e.g. 'USB:0x1234' or 'USB:0x1234|PCI:0x5678'

 

Since: 0.9.4


fwupd_device_add_vendor_id ()

void
fwupd_device_add_vendor_id (FwupdDevice *device,
                            const gchar *vendor_id);

Adds a device vendor ID.

Parameters

device

A FwupdDevice

 

vendor_id

the ID, e.g. 'USB:0x1234'

 

Since: 1.5.5


fwupd_device_has_vendor_id ()

gboolean
fwupd_device_has_vendor_id (FwupdDevice *device,
                            const gchar *vendor_id);

Finds out if the device has this specific vendor ID.

Parameters

device

A FwupdDevice

 

vendor_id

the ID, e.g. 'USB:0x1234'

 

Returns

TRUE if the ID is found

Since: 1.5.5


fwupd_device_get_vendor_ids ()

GPtrArray *
fwupd_device_get_vendor_ids (FwupdDevice *device);

Gets the device vendor ID.

Parameters

device

A FwupdDevice

 

Returns

the device vendor ID.

[element-type utf8][transfer none]

Since: 1.5.5


fwupd_device_add_guid ()

void
fwupd_device_add_guid (FwupdDevice *device,
                       const gchar *guid);

Adds the GUID if it does not already exist.

Parameters

device

A FwupdDevice

 

guid

the GUID, e.g. 2082b5e0-7a64-478a-b1b2-e3404fab6dad

 

Since: 0.9.3


fwupd_device_has_guid ()

gboolean
fwupd_device_has_guid (FwupdDevice *device,
                       const gchar *guid);

Finds out if the device has this specific GUID.

Parameters

device

A FwupdDevice

 

guid

the GUID, e.g. 2082b5e0-7a64-478a-b1b2-e3404fab6dad

 

Returns

TRUE if the GUID is found

Since: 0.9.3


fwupd_device_get_guids ()

GPtrArray *
fwupd_device_get_guids (FwupdDevice *device);

Gets the GUIDs.

Parameters

device

A FwupdDevice

 

Returns

the GUIDs.

[element-type utf8][transfer none]

Since: 0.9.3


fwupd_device_get_guid_default ()

const gchar *
fwupd_device_get_guid_default (FwupdDevice *device);

Gets the default GUID.

Parameters

device

A FwupdDevice

 

Returns

the GUID, or NULL if unset

Since: 0.9.3


fwupd_device_add_instance_id ()

void
fwupd_device_add_instance_id (FwupdDevice *device,
                              const gchar *instance_id);

Adds the InstanceID if it does not already exist.

Parameters

device

A FwupdDevice

 

instance_id

the GUID, e.g. PCI\VEN_10EC&DEV_525A

 

Since: 1.2.5


fwupd_device_has_instance_id ()

gboolean
fwupd_device_has_instance_id (FwupdDevice *device,
                              const gchar *instance_id);

Finds out if the device has this specific InstanceID.

Parameters

device

A FwupdDevice

 

instance_id

the InstanceID, e.g. PCI\VEN_10EC&DEV_525A

 

Returns

TRUE if the InstanceID is found

Since: 1.2.5


fwupd_device_get_instance_ids ()

GPtrArray *
fwupd_device_get_instance_ids (FwupdDevice *device);

Gets the InstanceIDs.

Parameters

device

A FwupdDevice

 

Returns

the InstanceID.

[element-type utf8][transfer none]

Since: 1.2.5


fwupd_device_add_icon ()

void
fwupd_device_add_icon (FwupdDevice *device,
                       const gchar *icon);

Adds the icon name if it does not already exist.

Parameters

device

A FwupdDevice

 

icon

the name, e.g. input-mouse or /usr/share/icons/foo.png

 

Since: 0.9.8


fwupd_device_get_icons ()

GPtrArray *
fwupd_device_get_icons (FwupdDevice *device);

Gets the icon names to use for the device.

NOTE: Icons specified without a full path are stock icons and should be loaded from the users icon theme.

Parameters

device

A FwupdDevice

 

Returns

an array of icon names.

[element-type utf8][transfer none]

Since: 0.9.8


fwupd_device_get_update_state ()

FwupdUpdateState
fwupd_device_get_update_state (FwupdDevice *device);

Gets the update state.

Parameters

device

A FwupdDevice

 

Returns

the update state, or FWUPD_UPDATE_STATE_UNKNOWN if unset

Since: 0.9.8


fwupd_device_set_update_state ()

void
fwupd_device_set_update_state (FwupdDevice *device,
                               FwupdUpdateState update_state);

Sets the update state.

Parameters

device

A FwupdDevice

 

update_state

the state, e.g. FWUPD_UPDATE_STATE_PENDING

 

Since: 0.9.8


fwupd_device_get_update_error ()

const gchar *
fwupd_device_get_update_error (FwupdDevice *device);

Gets the update error.

Parameters

device

A FwupdDevice

 

Returns

the update error, or NULL if unset

Since: 0.9.8


fwupd_device_set_update_error ()

void
fwupd_device_set_update_error (FwupdDevice *device,
                               const gchar *update_error);

Sets the update error.

Parameters

device

A FwupdDevice

 

update_error

the update error string

 

Since: 0.9.8


fwupd_device_get_update_message ()

const gchar *
fwupd_device_get_update_message (FwupdDevice *device);

Gets the update message.

Parameters

device

A FwupdDevice

 

Returns

the update message, or NULL if unset

Since: 1.2.4


fwupd_device_set_update_message ()

void
fwupd_device_set_update_message (FwupdDevice *device,
                                 const gchar *update_message);

Sets the update message.

Parameters

device

A FwupdDevice

 

update_message

the update message string

 

Since: 1.2.4


fwupd_device_get_update_image ()

const gchar *
fwupd_device_get_update_image (FwupdDevice *device);

Gets the update image.

Parameters

device

A FwupdDevice

 

Returns

the update image URL, or NULL if unset

Since: 1.4.5


fwupd_device_set_update_image ()

void
fwupd_device_set_update_image (FwupdDevice *device,
                               const gchar *update_image);

Sets the update image.

Parameters

device

A FwupdDevice

 

update_image

the update image URL

 

Since: 1.4.5


fwupd_device_get_status ()

FwupdStatus
fwupd_device_get_status (FwupdDevice *self);

Returns what the device is currently doing.

Parameters

self

A FwupdDevice

 

Returns

the status value, e.g. FWUPD_STATUS_DEVICE_WRITE

Since: 1.4.0


fwupd_device_set_status ()

void
fwupd_device_set_status (FwupdDevice *self,
                         FwupdStatus status);

Sets what the device is currently doing.

Parameters

self

A FwupdDevice

 

status

the status value, e.g. FWUPD_STATUS_DEVICE_WRITE

 

Since: 1.4.0


fwupd_device_add_release ()

void
fwupd_device_add_release (FwupdDevice *device,
                          FwupdRelease *release);

Adds a release for this device.

Parameters

device

A FwupdDevice

 

release

a FwupdRelease

 

Since: 0.9.8


fwupd_device_get_releases ()

GPtrArray *
fwupd_device_get_releases (FwupdDevice *device);

Gets all the releases for this device.

Parameters

device

A FwupdDevice

 

Returns

array of releases.

[transfer none][element-type FwupdRelease]

Since: 0.9.8


fwupd_device_get_release_default ()

FwupdRelease *
fwupd_device_get_release_default (FwupdDevice *device);

Gets the default release for this device.

Parameters

device

A FwupdDevice

 

Returns

the FwupdRelease, or NULL if not set.

[transfer none]

Since: 0.9.8


fwupd_device_compare ()

gint
fwupd_device_compare (FwupdDevice *device1,
                      FwupdDevice *device2);

Comparison function for comparing two FwupdDevice objects.

Parameters

device1

a FwupdDevice

 

device2

a FwupdDevice

 

Returns

negative, 0 or positive

Since: 1.1.1


fwupd_device_from_variant ()

FwupdDevice *
fwupd_device_from_variant (GVariant *value);

Creates a new device using packed data.

Parameters

value

a GVariant

 

Returns

a new FwupdDevice, or NULL if value was invalid.

[transfer full]

Since: 1.0.0


fwupd_device_array_from_variant ()

GPtrArray *
fwupd_device_array_from_variant (GVariant *value);

Creates an array of new devices using packed data.

Parameters

value

a GVariant

 

Returns

devices, or NULL if value was invalid.

[transfer container][element-type FwupdDevice]

Since: 1.2.10


fwupd_device_array_ensure_parents ()

void
fwupd_device_array_ensure_parents (GPtrArray *devices);

Sets the parent object on all devices in the array using the parent-id.

Parameters

devices

devices.

[element-type FwupdDevice]

Since: 1.3.7

Types and Values

FWUPD_TYPE_DEVICE

#define FWUPD_TYPE_DEVICE (fwupd_device_get_type ())

struct FwupdDeviceClass

struct FwupdDeviceClass {
	GObjectClass			 parent_class;
};

FwupdDevice

typedef struct _FwupdDevice FwupdDevice;