mirror of
https://git.proxmox.com/git/fwupd
synced 2025-06-05 06:51:40 +00:00
114 lines
3.8 KiB
C
114 lines
3.8 KiB
C
/*
|
|
* Copyright (C) 2015 Richard Hughes <richard@hughsie.com>
|
|
*
|
|
* SPDX-License-Identifier: LGPL-2.1+
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <glib.h>
|
|
|
|
/**
|
|
* FuDfuRequest:
|
|
* @FU_DFU_REQUEST_DETACH: Detach
|
|
* @FU_DFU_REQUEST_DNLOAD: Download host-to-device
|
|
* @FU_DFU_REQUEST_UPLOAD: Upload device-to-host
|
|
* @FU_DFU_REQUEST_GETSTATUS: Get the device status
|
|
* @FU_DFU_REQUEST_CLRSTATUS: Clear the device status
|
|
* @FU_DFU_REQUEST_GETSTATE: Get the last set state
|
|
* @FU_DFU_REQUEST_ABORT: Abort the current transfer
|
|
*
|
|
* The DFU request kinds.
|
|
**/
|
|
typedef enum {
|
|
FU_DFU_REQUEST_DETACH = 0x00,
|
|
FU_DFU_REQUEST_DNLOAD = 0x01,
|
|
FU_DFU_REQUEST_UPLOAD = 0x02,
|
|
FU_DFU_REQUEST_GETSTATUS = 0x03,
|
|
FU_DFU_REQUEST_CLRSTATUS = 0x04,
|
|
FU_DFU_REQUEST_GETSTATE = 0x05,
|
|
FU_DFU_REQUEST_ABORT = 0x06,
|
|
/*< private >*/
|
|
FU_DFU_REQUEST_LAST
|
|
} FuDfuRequest;
|
|
|
|
/**
|
|
* FuDfuStatus:
|
|
* @FU_DFU_STATUS_OK: No error condition is present
|
|
* @FU_DFU_STATUS_ERR_TARGET: File is not targeted for use by this device
|
|
* @FU_DFU_STATUS_ERR_FILE: File is for this device but fails a verification test
|
|
* @FU_DFU_STATUS_ERR_WRITE: Device is unable to write memory
|
|
* @FU_DFU_STATUS_ERR_ERASE: Memory erase function failed
|
|
* @FU_DFU_STATUS_ERR_CHECK_ERASED: Memory erase check failed
|
|
* @FU_DFU_STATUS_ERR_PROG: Program memory function failed
|
|
* @FU_DFU_STATUS_ERR_VERIFY: Programmed memory failed verification
|
|
* @FU_DFU_STATUS_ERR_ADDRESS: Cannot program memory due to received address that isout of range
|
|
* @FU_DFU_STATUS_ERR_NOTDONE: Received DFU_DNLOAD with wLength = 0 but data is incomplete
|
|
* @FU_DFU_STATUS_ERR_FIRMWARE: Device firmware is corrupt
|
|
* @FU_DFU_STATUS_ERR_VENDOR: iString indicates a vendor-specific error
|
|
* @FU_DFU_STATUS_ERR_USBR: Device detected unexpected USB reset signaling
|
|
* @FU_DFU_STATUS_ERR_POR: Device detected unexpected power on reset
|
|
* @FU_DFU_STATUS_ERR_UNKNOWN: Something unexpected went wrong
|
|
* @FU_DFU_STATUS_ERR_STALLDPKT: Device stalled an unexpected request
|
|
*
|
|
* The status enumerated kind.
|
|
**/
|
|
typedef enum {
|
|
FU_DFU_STATUS_OK = 0x00,
|
|
FU_DFU_STATUS_ERR_TARGET = 0x01,
|
|
FU_DFU_STATUS_ERR_FILE = 0x02,
|
|
FU_DFU_STATUS_ERR_WRITE = 0x03,
|
|
FU_DFU_STATUS_ERR_ERASE = 0x04,
|
|
FU_DFU_STATUS_ERR_CHECK_ERASED = 0x05,
|
|
FU_DFU_STATUS_ERR_PROG = 0x06,
|
|
FU_DFU_STATUS_ERR_VERIFY = 0x07,
|
|
FU_DFU_STATUS_ERR_ADDRESS = 0x08,
|
|
FU_DFU_STATUS_ERR_NOTDONE = 0x09,
|
|
FU_DFU_STATUS_ERR_FIRMWARE = 0x0a,
|
|
FU_DFU_STATUS_ERR_VENDOR = 0x0b,
|
|
FU_DFU_STATUS_ERR_USBR = 0x0c,
|
|
FU_DFU_STATUS_ERR_POR = 0x0d,
|
|
FU_DFU_STATUS_ERR_UNKNOWN = 0x0e,
|
|
FU_DFU_STATUS_ERR_STALLDPKT = 0x0f,
|
|
/*< private >*/
|
|
FU_DFU_STATUS_LAST
|
|
} FuDfuStatus;
|
|
|
|
/**
|
|
* FuDfuState:
|
|
* @FU_DFU_STATE_APP_IDLE: State 0
|
|
* @FU_DFU_STATE_APP_DETACH: State 1
|
|
* @FU_DFU_STATE_DFU_IDLE: State 2
|
|
* @FU_DFU_STATE_DFU_DNLOAD_SYNC: State 3
|
|
* @FU_DFU_STATE_DFU_DNBUSY: State 4
|
|
* @FU_DFU_STATE_DFU_DNLOAD_IDLE: State 5
|
|
* @FU_DFU_STATE_DFU_MANIFEST_SYNC: State 6
|
|
* @FU_DFU_STATE_DFU_MANIFEST: State 7
|
|
* @FU_DFU_STATE_DFU_MANIFEST_WAIT_RESET: State 8
|
|
* @FU_DFU_STATE_DFU_UPLOAD_IDLE: State 9
|
|
* @FU_DFU_STATE_DFU_ERROR: State 10
|
|
*
|
|
* The state enumerated kind.
|
|
**/
|
|
typedef enum {
|
|
FU_DFU_STATE_APP_IDLE = 0x00,
|
|
FU_DFU_STATE_APP_DETACH = 0x01,
|
|
FU_DFU_STATE_DFU_IDLE = 0x02,
|
|
FU_DFU_STATE_DFU_DNLOAD_SYNC = 0x03,
|
|
FU_DFU_STATE_DFU_DNBUSY = 0x04,
|
|
FU_DFU_STATE_DFU_DNLOAD_IDLE = 0x05,
|
|
FU_DFU_STATE_DFU_MANIFEST_SYNC = 0x06,
|
|
FU_DFU_STATE_DFU_MANIFEST = 0x07,
|
|
FU_DFU_STATE_DFU_MANIFEST_WAIT_RESET = 0x08,
|
|
FU_DFU_STATE_DFU_UPLOAD_IDLE = 0x09,
|
|
FU_DFU_STATE_DFU_ERROR = 0x0a,
|
|
/*< private >*/
|
|
FU_DFU_STATE_LAST
|
|
} FuDfuState;
|
|
|
|
const gchar *fu_dfu_state_to_string (FuDfuState state);
|
|
const gchar *fu_dfu_status_to_string (FuDfuStatus status);
|
|
|
|
/* helpers */
|
|
GBytes *fu_dfu_utils_bytes_join_array (GPtrArray *chunks);
|