Class

FwupdDevice

Description [src]

class Fwupd.Device : GObject.Object {
  parent_instance: GObject
}

A physical device on the host with optionally updatable firmware.

See also: FwupdRelease

Hierarchy

hierarchy this FwupdDevice ancestor_0 GObject ancestor_0--this

Ancestors

  • GObject

Constructors

fwupd_device_new

Creates a new device.

Available since: 0.9.3

Instance methods

fwupd_device_add_checksum

Sets the device checksum.

Available since: 0.9.3

fwupd_device_add_child

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

Available since: 1.5.1

fwupd_device_add_flag

Adds a specific device flag to the device.

Available since: 0.9.3

fwupd_device_add_guid

Adds the GUID if it does not already exist.

Available since: 0.9.3

fwupd_device_add_icon

Adds the icon name if it does not already exist.

Available since: 0.9.8

fwupd_device_add_instance_id

Adds the InstanceID if it does not already exist.

Available since: 1.2.5

fwupd_device_add_protocol

Adds a device protocol.

Available since: 1.5.8

fwupd_device_add_release

Adds a release for this device.

Available since: 0.9.8

fwupd_device_add_vendor_id

Adds a device vendor ID.

Available since: 1.5.5

fwupd_device_compare

Comparison function for comparing two device objects.

Available since: 1.1.1

fwupd_device_get_branch

Gets the current device branch.

Available since: 1.5.0

fwupd_device_get_checksums

Gets the device checksums.

Available since: 0.9.3

fwupd_device_get_children

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

Available since: 1.3.7

fwupd_device_get_composite_id

Gets the composite ID, falling back to the device ID if unset.

Available since: 1.6.0

fwupd_device_get_created

Gets when the device was created.

Available since: 0.9.3

fwupd_device_get_description

Gets the device description in AppStream markup format.

Available since: 0.9.3

fwupd_device_get_flags

Gets device flags.

Available since: 0.9.3

fwupd_device_get_flashes_left

Gets the number of flash cycles left on the device.

Available since: 0.9.3

fwupd_device_get_guid_default

Gets the default GUID.

Available since: 0.9.3

fwupd_device_get_guids

Gets the GUIDs.

Available since: 0.9.3

fwupd_device_get_icons

Gets the icon names to use for the device.

Available since: 0.9.8

fwupd_device_get_id

Gets the ID.

Available since: 0.9.3

fwupd_device_get_install_duration

Gets the time estimate for firmware installation (in seconds)

Available since: 1.1.3

fwupd_device_get_instance_ids

Gets the InstanceIDs.

Available since: 1.2.5

fwupd_device_get_modified

Gets when the device was modified.

Available since: 0.9.3

fwupd_device_get_name

Gets the device name.

Available since: 0.9.3

fwupd_device_get_parent

Gets the parent.

Available since: 1.0.8

fwupd_device_get_parent_id

Gets the ID.

Available since: 1.0.8

fwupd_device_get_plugin

Gets the plugin that created the device.

Available since: 1.0.0

fwupd_device_get_protocol

Gets the protocol that the device uses for updating.

Available since: 1.3.6

Deprecated since: 1.5.8

fwupd_device_get_protocols

Gets the device protocol.

Available since: 1.5.8

fwupd_device_get_release_default

Gets the default release for this device.

Available since: 0.9.8

fwupd_device_get_releases

Gets all the releases for this device.

Available since: 0.9.8

fwupd_device_get_serial

Gets the serial number for the device.

Available since: 1.1.2

fwupd_device_get_status

Returns what the device is currently doing.

Available since: 1.4.0

fwupd_device_get_summary

Gets the device summary.

Available since: 0.9.3

fwupd_device_get_update_error

Gets the update error.

Available since: 0.9.8

fwupd_device_get_update_image

Gets the update image.

Available since: 1.4.5

fwupd_device_get_update_message

Gets the update message.

Available since: 1.2.4

fwupd_device_get_update_state

Gets the update state.

Available since: 0.9.8

fwupd_device_get_vendor

Gets the device vendor.

Available since: 0.9.3

fwupd_device_get_vendor_id

Gets the combined device vendor ID.

Available since: 0.9.4

Deprecated since: 1.5.5

fwupd_device_get_vendor_ids

Gets the device vendor ID.

Available since: 1.5.5

fwupd_device_get_version

Gets the device version.

Available since: 0.9.3

fwupd_device_get_version_bootloader

Gets the version of the bootloader.

Available since: 0.9.3

fwupd_device_get_version_bootloader_raw

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

Available since: 1.4.0

fwupd_device_get_version_build_date

Gets the date when the firmware was built.

Available since: 1.6.2

fwupd_device_get_version_format

Gets the update state.

Available since: 1.2.9

fwupd_device_get_version_lowest

Gets the lowest version of firmware the device will accept.

Available since: 0.9.3

fwupd_device_get_version_lowest_raw

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

Available since: 1.4.0

fwupd_device_get_version_raw

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

Available since: 1.3.6

fwupd_device_has_flag

Finds if the device has a specific device flag.

Available since: 0.9.3

fwupd_device_has_guid

Finds out if the device has this specific GUID.

Available since: 0.9.3

fwupd_device_has_icon

Finds out if the device has this specific icon.

Available since: 1.6.2

fwupd_device_has_instance_id

Finds out if the device has this specific InstanceID.

Available since: 1.2.5

fwupd_device_has_protocol

Finds out if the device has this specific protocol.

Available since: 1.5.8

fwupd_device_has_vendor_id

Finds out if the device has this specific vendor ID.

Available since: 1.5.5

fwupd_device_incorporate

Copy all properties from the donor object if they have not already been set.

Available since: 1.1.0

fwupd_device_remove_child

Removes a child device.

Available since: 1.6.2

fwupd_device_remove_flag

Removes a specific device flag from the device.

Available since: 0.9.3

fwupd_device_set_branch

Sets the current device branch.

Available since: 1.5.0

fwupd_device_set_composite_id

Sets the composite ID, which is usually a SHA1 hash of a grandparent or parent device.

Available since: 1.6.0

fwupd_device_set_created

Sets when the device was created.

Available since: 0.9.3

fwupd_device_set_description

Sets the device description.

Available since: 0.9.3

fwupd_device_set_flags

Sets device flags.

Available since: 0.9.3

fwupd_device_set_flashes_left

Sets the number of flash cycles left on the device.

Available since: 0.9.3

fwupd_device_set_id

Sets the ID.

Available since: 0.9.3

fwupd_device_set_install_duration

Sets the time estimate for firmware installation (in seconds)

Available since: 1.1.3

fwupd_device_set_modified

Sets when the device was modified.

Available since: 0.9.3

fwupd_device_set_name

Sets the device name.

Available since: 0.9.3

fwupd_device_set_parent

Sets the parent. Only used internally.

Available since: 1.0.8

fwupd_device_set_parent_id

Sets the parent ID.

Available since: 1.0.8

fwupd_device_set_plugin

Sets the plugin that created the device.

Available since: 1.0.0

fwupd_device_set_protocol

Sets the protocol that is used to update the device.

Available since: 1.3.6

Deprecated since: 1.5.8

fwupd_device_set_serial

Sets the serial number for the device.

Available since: 1.1.2

fwupd_device_set_status

Sets what the device is currently doing.

Available since: 1.4.0

fwupd_device_set_summary

Sets the device summary.

Available since: 0.9.3

fwupd_device_set_update_error

Sets the update error.

Available since: 0.9.8

fwupd_device_set_update_image

Sets the update image.

Available since: 1.4.5

fwupd_device_set_update_message

Sets the update message.

Available since: 1.2.4

fwupd_device_set_update_state

Sets the update state.

Available since: 0.9.8

fwupd_device_set_vendor

Sets the device vendor.

Available since: 0.9.3

fwupd_device_set_vendor_id

Sets the device vendor ID.

Available since: 0.9.4

Deprecated since: 1.5.5

fwupd_device_set_version

Sets the device version.

Available since: 0.9.3

fwupd_device_set_version_bootloader

Sets the bootloader version.

Available since: 0.9.3

fwupd_device_set_version_bootloader_raw

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

Available since: 1.4.0

fwupd_device_set_version_build_date

Sets the date when the firmware was built.

Available since: 1.6.2

fwupd_device_set_version_format

Sets the update state.

Available since: 1.2.9

fwupd_device_set_version_lowest

Sets the lowest version of firmware the device will accept.

Available since: 0.9.3

fwupd_device_set_version_lowest_raw

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

Available since: 1.4.0

fwupd_device_set_version_raw

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

Available since: 1.3.6

fwupd_device_to_json

Adds a fwupd device to a JSON builder.

Available since: 1.2.6

fwupd_device_to_string

Builds a text representation of the object.

Available since: 0.9.3

fwupd_device_to_variant

Serialize the device data omitting sensitive fields.

Available since: 1.0.0

fwupd_device_to_variant_full

Serialize the device data. Optionally provides additional data based upon flags.

Available since: 1.1.2

Properties

Fwupd.Device:flags
No description available.
Fwupd.Device:parent
No description available.
Fwupd.Device:protocol
No description available.
Fwupd.Device:status
No description available.
Fwupd.Device:update-error
No description available.
Fwupd.Device:update-image
No description available.
Fwupd.Device:update-message
No description available.
Fwupd.Device:update-state
No description available.
Fwupd.Device:version-format
No description available.

Class structure

struct FwupdDeviceClass {
  GObjectClass parent_class;
  void (* _fwupd_reserved1) (
void
  );
  void (* _fwupd_reserved2) (
void
  );
  void (* _fwupd_reserved3) (
void
  );
  void (* _fwupd_reserved4) (
void
  );
  void (* _fwupd_reserved5) (
void
  );
  void (* _fwupd_reserved6) (
void
  );
  void (* _fwupd_reserved7) (
void
  );
  
}
Class members
parent_class
GObjectClass
  No description available.
_fwupd_reserved1
void (* _fwupd_reserved1) (
void
  )
  No description available.
_fwupd_reserved2
void (* _fwupd_reserved2) (
void
  )
  No description available.
_fwupd_reserved3
void (* _fwupd_reserved3) (
void
  )
  No description available.
_fwupd_reserved4
void (* _fwupd_reserved4) (
void
  )
  No description available.
_fwupd_reserved5
void (* _fwupd_reserved5) (
void
  )
  No description available.
_fwupd_reserved6
void (* _fwupd_reserved6) (
void
  )
  No description available.
_fwupd_reserved7
void (* _fwupd_reserved7) (
void
  )
  No description available.

Functions

fwupd_device_array_ensure_parents

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

Available since: 1.3.7

fwupd_device_array_from_variant

Creates an array of new devices using serialized data.

Available since: 1.2.10

fwupd_device_flag_from_string

Converts a string to a enumerated device flag.

Available since: 0.7.0

fwupd_device_flag_to_string

Converts a device flag to a string.

Available since: 0.7.0

fwupd_device_from_variant

Creates a new device using serialized data.

Available since: 1.0.0

fwupd_device_id_is_valid

Checks the string is a valid non-partial device ID. It is important to note that the wildcard ID of * is not considered a valid ID in this function and the client must check for this manually if this should be allowed.

Available since: 1.4.1