fwupd/plugins/modem-manager/fu-firehose-updater.h
Richard Hughes 40cd18fa97 Allow using a per-device global percentage completion
It's actually quite hard to build a front-end for fwupd at the moment
as you're never sure when the progress bar is going to zip back to 0%
and start all over again. Some plugins go 0..100% for write, others
go 0..100% for erase, then again for write, then *again* for verify.

By creating a helper object we can easily split up the progress of the
specific task, e.g. write_firmware().

We can encode at the plugin level "the erase takes 50% of the time, the
write takes 40% and the read takes 10%". This means we can have a
progressbar which goes up just once at a consistent speed.
2021-09-13 14:28:15 +01:00

39 lines
949 B
C

/*
* Copyright (C) 2020 Aleksander Morgado <aleksander@aleksander.es>
* Copyright (C) 2021 Quectel Wireless Solutions Co., Ltd.
*
* SPDX-License-Identifier: LGPL-2.1+
*/
#pragma once
#include <fwupdplugin.h>
#include <xmlb.h>
#define FU_TYPE_FIREHOSE_UPDATER (fu_firehose_updater_get_type())
G_DECLARE_FINAL_TYPE(FuFirehoseUpdater, fu_firehose_updater, FU, FIREHOSE_UPDATER, GObject)
FuFirehoseUpdater *
fu_firehose_updater_new(const gchar *port);
gboolean
fu_firehose_updater_open(FuFirehoseUpdater *self, GError **error);
gboolean
fu_firehose_updater_write(FuFirehoseUpdater *self,
XbSilo *silo,
GPtrArray *action_nodes,
FuProgress *progress,
GError **error);
gboolean
fu_firehose_updater_close(FuFirehoseUpdater *self, GError **error);
/* helpers */
gboolean
fu_firehose_validate_rawprogram(GBytes *rawprogram,
FuArchive *archive,
XbSilo **out_silo,
GPtrArray **out_action_nodes,
GError **error);