| Top |
MMModemFirmware implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModemFirmware.
The MMModemFirmware is an object providing access to the methods, signals and properties of the Firmware interface.
The Firmware interface is exposed whenever a modem has firmware capabilities.
const gchar *
mm_modem_firmware_get_path (MMModemFirmware *self);
Gets the DBus path of the MMObject which implements this interface.
gchar *
mm_modem_firmware_dup_path (MMModemFirmware *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
void mm_modem_firmware_list (MMModemFirmware *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the list of available firmware images.
When the operation is finished, callback
will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_firmware_list_finish() to get the result of the operation.
See mm_modem_firmware_list_sync() for the synchronous, blocking version of this method.
self |
||
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_modem_firmware_list_finish (MMModemFirmware *self,GAsyncResult *res,MMFirmwareProperties **selected,GList **installed,GError **error);
Finishes an operation started with mm_modem_firmware_list().
self |
||
selected |
The selected firmware slot, or NULL if no slot is selected (such as if all slots are empty, or no slots exist). The returned value should be freed with |
[out][allow-none][transfer full] |
installed |
A list of MMFirmwareProperties objects specifying the installed images. The returned value should be freed with |
[out][allow-none][transfer full][element-type ModemManager.FirmwareProperties] |
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_modem_firmware_list_sync (MMModemFirmware *self,MMFirmwareProperties **selected,GList **installed,GCancellable *cancellable,GError **error);
Synchronously gets the list of available firmware images.
The calling thread is blocked until a reply is received. See mm_modem_firmware_list()
for the asynchronous version of this method.
self |
||
selected |
The selected firmware slot, or NULL if no slot is selected (such as if all slots are empty, or no slots exist). The returned value should be freed with |
[out][allow-none][transfer full] |
installed |
A list of MMFirmwareProperties objects specifying the installed images. The returned value should be freed with |
[out][allow-none][transfer full][element-type ModemManager.FirmwareProperties] |
cancellable |
A GCancellable or |
[allow-none] |
error |
Return firmware for error or |
void mm_modem_firmware_select (MMModemFirmware *self,const gchar *unique_id,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously selects a firmware image to boot.
When the operation is finished, callback
will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_firmware_select_finish() to get the result of the operation.
See mm_modem_firmware_select_sync() for the synchronous, blocking version of this method.
self |
||
unique_id |
Unique ID of the firmware image to select. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_modem_firmware_select_finish (MMModemFirmware *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_firmware_select().
self |
||
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_modem_firmware_select_sync (MMModemFirmware *self,const gchar *unique_id,GCancellable *cancellable,GError **error);
Synchronously selects a firmware image to boot.
The calling thread is blocked until a reply is received. See mm_modem_firmware_select()
for the asynchronous version of this method.
self |
||
unique_id |
Unique ID of the firmware image to select. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
MMFirmwareUpdateSettings *
mm_modem_firmware_get_update_settings (MMModemFirmware *self);
Gets a MMFirmwareUpdateSettings object specifying the expected update settings.
self are not updated when the values in the
interface change. Instead, the client is expected to call
mm_modem_firmware_get_update_settings() again to get a new MMFirmwareUpdateSettings
with the new values.A MMFirmwareUpdateSettings that must be freed with g_object_unref() or NULL if unknown.
[transfer full]
MMFirmwareUpdateSettings *
mm_modem_firmware_peek_update_settings
(MMModemFirmware *self);
Gets a MMFirmwareUpdateSettings object specifying the expected update settings.
self was constructed. Use mm_modem_firmware_get_update_settings() if on
another thread.A MMFirmwareUpdateSettings. Do not free the returned value, it belongs to self
.
[transfer none]
struct MMModemFirmware;
The MMModemFirmware structure contains private data and should only be accessed using the provided API.