1DFU-SUFFIX(1)                                                    DFU-SUFFIX(1)
2
3
4

NAME

6       dfu-suffix - add, check, or remove DFU firmware file suffix
7

SYNOPSIS

9       dfu-suffix [options] --add DFU_FILE
10       dfu-suffix --check DFU_FILE
11       dfu-suffix --delete DFU_FILE
12       dfu-suffix --help
13       dfu-suffix --version
14

DESCRIPTION

16       The  program  dfu-suffix  can  be  used  to  add, check or remove a DFU
17       firmware file suffix, recommended for safely matching a  firmware  file
18       and device.
19
20       Note  that  a  suffix  is  recommended by the DFU standard, but not re‐
21       quired.  A DFU host tool like dfu-util will recognize  the  suffix  and
22       use  it to check that the device is matching, but not transfer the suf‐
23       fix to the device.
24

OPTIONS

26       -v, --vid vendorID
27              Specify USB vendor ID (hexadecimal)
28
29       -p, --pid productID
30              Specify USB product ID (hexadecimal)
31
32       -d, --did deviceID
33              Specify USB device ID (hexadecimal)
34
35       -S, --spec version
36              Specify DFU specification version (hexadecimal)
37
38       -h, --help
39              Displays a help message.
40
41       -V, --version
42              Displays the software version.
43

EXAMPLES

45       dfu-suffix --vid 0123 --add firmware.dfu
46              Adds a suffix matching vendor  0x0123  and  product  ID  0x4567.
47              Since product and device ID are not specified, they will contain
48              the wildcard value 0xFFFF.
49
50       dfu-suffix --check firmware.dfu
51              Checks the file firmware.dfu for a valid DFU suffix
52
53       dfu-suffix --delete firmware.dfu
54              Removes a valid DFU suffix from the file firmware.dfu
55

EXIT VALUES

57       0      Success (also if suffix is missing)
58
59       -64    Usage error
60

LIMITATIONS

62       dfu-suffix can not tell a broken DFU  suffix  (e.g. checksum  mismatch)
63       from a non-existing suffix, so only a valid suffix can be removed.
64

BUGS

66       https://sourceforge.net/p/dfu-util/tickets/
67

69       License GPLv2: GNU GPL version 2
70

SEE ALSO

72       dfu-prefix(1), dfu-util(1)
73

AUTHORS

75       See AUTHORS file in source.
76
77
78
79dfu-util 0.11                   September 2021                   DFU-SUFFIX(1)
Impressum