fwupd/plugins/ebitdo/fu-plugin-ebitdo.c
Richard Hughes cff38bcb3a Convert the providers to plugins to simplify code and for future features
This is a large commit that removes all the providers and turns them into
plugins. I think having both providers _and_ plugins was super confusing.

Plugins are loaded at runtime so you could in theory develop a new plugin
without putting it in the fwupd source tree, although there are no installed
headers or PC files as I'm not sure it's a good idea at this stage.

This commit moves all the per-provider docs, tests, notes, debug dumps and test
data to plugin-specific directories -- these also allows the plugin author to
"own" more of the source tree so we don't enforce fu- prefixes and the style
guide everywhere.

This allows us to run the same action on all the plugins in the future, so we
could have a prepare(FuPlugin, FuDevice) and cleanup(FuPlugin, FuDevice) run
on *all* plugins, so doing an update using one plugin would allow us to work
around hardware quirks in other plugins.

If I've broken your out-of-tree provider it's trivial to port to the new API
with sed and a fixed up build file. If you need help please let me know.
2016-12-12 12:31:23 +00:00

231 lines
6.8 KiB
C

/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
*
* Copyright (C) 2016 Richard Hughes <richard@hughsie.com>
*
* Licensed under the GNU General Public License Version 2
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#include "config.h"
#include <appstream-glib.h>
#include "fu-ebitdo-device.h"
#include "fu-plugin.h"
#include "fu-plugin-vfuncs.h"
struct FuPluginData {
GHashTable *devices_runtime; /* id : FuEbitdoDevice */
};
static gboolean
fu_plugin_ebitdo_device_added (FuPlugin *plugin,
GUsbDevice *usb_device,
GError **error)
{
FuPluginData *data = fu_plugin_get_data (plugin);
FuEbitdoDeviceKind ebitdo_kind;
const gchar *platform_id = NULL;
g_autoptr(AsProfile) profile = as_profile_new ();
g_autoptr(AsProfileTask) ptask = NULL;
g_autoptr(FuEbitdoDevice) ebitdo_dev = NULL;
g_autoptr(FuDevice) dev = NULL;
g_autofree gchar *name = NULL;
/* ignore hubs */
ptask = as_profile_start (profile, "FuPlugin:added{%04x:%04x}",
g_usb_device_get_vid (usb_device),
g_usb_device_get_pid (usb_device));
/* get version */
platform_id = g_usb_device_get_platform_id (usb_device);
ebitdo_dev = fu_ebitdo_device_new (usb_device);
if (fu_ebitdo_device_get_kind (ebitdo_dev) == FU_EBITDO_DEVICE_KIND_UNKNOWN) {
g_set_error_literal (error,
FWUPD_ERROR,
FWUPD_ERROR_NOT_SUPPORTED,
"invalid 8Bitdo device type detected");
return FALSE;
}
/* open the device */
if (!fu_ebitdo_device_open (ebitdo_dev, error))
return FALSE;
/* generate name */
ebitdo_kind = fu_ebitdo_device_get_kind (ebitdo_dev);
name = g_strdup_printf ("8Bitdo %s Gamepad",
fu_ebitdo_device_kind_to_string (ebitdo_kind));
/* create the device */
dev = fu_device_new ();
fu_device_set_id (dev, platform_id);
fu_device_add_flag (dev, FWUPD_DEVICE_FLAG_ALLOW_ONLINE);
fu_device_add_guid (dev, fu_ebitdo_device_get_guid (ebitdo_dev));
fu_device_set_version (dev, fu_ebitdo_device_get_version (ebitdo_dev));
fu_device_set_name (dev, name);
/* close the device */
if (!fu_ebitdo_device_close (ebitdo_dev, error))
return FALSE;
/* only the bootloader can do the update */
if (ebitdo_kind == FU_EBITDO_DEVICE_KIND_BOOTLOADER) {
FuEbitdoDevice *ebitdo_runtime;
fu_device_remove_flag (dev, FWUPD_DEVICE_FLAG_NEEDS_BOOTLOADER);
/* add the last seen runtime GUID too */
ebitdo_runtime = g_hash_table_lookup (data->devices_runtime, platform_id);
if (ebitdo_runtime != NULL) {
const gchar *guid;
guid = fu_ebitdo_device_get_guid (ebitdo_runtime);
g_debug ("adding runtime GUID of %s", guid);
fu_device_add_guid (dev, guid);
}
} else {
fu_device_add_flag (dev, FWUPD_DEVICE_FLAG_NEEDS_BOOTLOADER);
g_hash_table_insert (data->devices_runtime,
g_strdup (platform_id),
g_object_ref (ebitdo_dev));
g_debug ("saving runtime GUID of %s",
fu_ebitdo_device_get_guid (ebitdo_dev));
}
/* insert to hash */
fu_plugin_device_add (plugin, dev);
fu_plugin_cache_add (plugin, platform_id, dev);
return TRUE;
}
static void
ebitdo_write_progress_cb (goffset current, goffset total, gpointer user_data)
{
FuPlugin *plugin = FU_PLUGIN (user_data);
gdouble percentage = -1.f;
if (total > 0)
percentage = (100.f * (gdouble) current) / (gdouble) total;
g_debug ("written %" G_GOFFSET_FORMAT "/%" G_GOFFSET_FORMAT " bytes [%.1f%%]",
current, total, percentage);
fu_plugin_set_percentage (plugin, (guint) percentage);
}
gboolean
fu_plugin_update_online (FuPlugin *plugin,
FuDevice *dev,
GBytes *blob_fw,
FwupdInstallFlags flags,
GError **error)
{
GUsbContext *usb_ctx = fu_plugin_get_usb_context (plugin);
const gchar *platform_id;
g_autoptr(FuEbitdoDevice) ebitdo_dev = NULL;
g_autoptr(GUsbDevice) usb_device = NULL;
/* get version */
platform_id = fu_device_get_id (dev);
usb_device = g_usb_context_find_by_platform_id (usb_ctx,
platform_id,
error);
if (usb_device == NULL)
return FALSE;
ebitdo_dev = fu_ebitdo_device_new (usb_device);
if (fu_ebitdo_device_get_kind (ebitdo_dev) != FU_EBITDO_DEVICE_KIND_BOOTLOADER) {
g_set_error_literal (error,
FWUPD_ERROR,
FWUPD_ERROR_NOT_SUPPORTED,
"invalid 8Bitdo device type detected");
return FALSE;
}
/* write the firmware */
if (!fu_ebitdo_device_open (ebitdo_dev, error))
return FALSE;
fu_plugin_set_status (plugin, FWUPD_STATUS_DEVICE_WRITE);
if (!fu_ebitdo_device_write_firmware (ebitdo_dev, blob_fw,
ebitdo_write_progress_cb, plugin,
error))
return FALSE;
fu_plugin_set_status (plugin, FWUPD_STATUS_DEVICE_RESTART);
if (!fu_ebitdo_device_close (ebitdo_dev, error))
return FALSE;
/* success */
return TRUE;
}
static void
fu_plugin_ebitdo_device_added_cb (GUsbContext *ctx,
GUsbDevice *usb_device,
FuPlugin *plugin)
{
g_autoptr(GError) error = NULL;
if (!fu_plugin_ebitdo_device_added (plugin, usb_device, &error)) {
if (!g_error_matches (error,
FWUPD_ERROR,
FWUPD_ERROR_NOT_SUPPORTED)) {
g_warning ("Failed to add 8Bitdo device: %s",
error->message);
}
}
}
static void
fu_plugin_ebitdo_device_removed_cb (GUsbContext *ctx,
GUsbDevice *usb_device,
FuPlugin *plugin)
{
FuDevice *dev;
const gchar *platform_id = NULL;
/* already in database */
platform_id = g_usb_device_get_platform_id (usb_device);
dev = fu_plugin_cache_lookup (plugin, platform_id);
if (dev == NULL)
return;
fu_plugin_device_remove (plugin, dev);
fu_plugin_cache_remove (plugin, platform_id);
}
void
fu_plugin_init (FuPlugin *plugin)
{
FuPluginData *data = fu_plugin_alloc_data (plugin, sizeof (FuPluginData));
data->devices_runtime = g_hash_table_new_full (g_str_hash, g_str_equal,
g_free, (GDestroyNotify) g_object_unref);
}
void
fu_plugin_destroy (FuPlugin *plugin)
{
FuPluginData *data = fu_plugin_get_data (plugin);
g_hash_table_unref (data->devices_runtime);
}
gboolean
fu_plugin_startup (FuPlugin *plugin, GError **error)
{
GUsbContext *usb_ctx = fu_plugin_get_usb_context (plugin);
g_signal_connect (usb_ctx, "device-added",
G_CALLBACK (fu_plugin_ebitdo_device_added_cb),
plugin);
g_signal_connect (usb_ctx, "device-removed",
G_CALLBACK (fu_plugin_ebitdo_device_removed_cb),
plugin);
return TRUE;
}