summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-fw-download.txt
blob: a45589cea3f4735669c11c43d5371aad7653bd8a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
nvme-fw-download(1)
===================

NAME
----
nvme-fw-download - Download all or a portion of an nvme firmware image.

SYNOPSIS
--------
[verse]
'nvme fw-download' <device> [--fw=<firmware-file> | -f <firmware-file>]
			[--xfer=<transfer-size> | -x <transfer-size>]
			[--offset=<offset> | -O <offset>]
			[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
			[--timeout=<timeout> | -t <timeout>]

DESCRIPTION
-----------
The Firmware Image Download command is used to download all or a portion
of the firmware image for a future update to the controller. The Firmware
Image Download command may be submitted while other commands on the Admin
Submission Queue or I/O Submission Queues are outstanding. The Firmware
Image Download command copies the new firmware image (in whole or in part)
to the controller.

The firmware image may be constructed of multiple pieces that
are individually downloaded with separate Firmware Image Download
commands. Each Firmware Image Download command includes a Dword
Offset and Number of Dwords that specify a Dword range. The host
software shall ensure that firmware pieces do not have Dword ranges
that overlap. Firmware portions may be submitted out of order to the
controller.

The new firmware image is not applied as part of the Firmware Image
Download command. It is applied following a reset, where the image to
apply and the firmware slot it should be committed to is specified with
the Firmware Commit command (nvme fw-commit <args>).

OPTIONS
-------
-f <firmware-file>::
--fw=<firmware-file>::
	Required argument. This specifies the path to the device's
	firmware file on your system that will be read by the program
	and sent to the device.

-x <transfer-size>::
--xfer=<transfer-size>::
	This specifies the size to split each transfer. This is useful if
	the device has a max transfer size requirement for firmware. It
	defaults to 4k.

-O <offset>::
--offset=<offset>::
	This specifies the starting offset in dwords. This is really only
	useful if your firmware is split in multiple files; otherwise
	the offset starts at zero and automatically adjusts based on the
	'xfer' size given.

-o <fmt>::
--output-format=<fmt>::
	Set the reporting format to 'normal', 'json' or 'binary'. Only one
	output format can be used at a time.

-v::
--verbose::
	Increase the information detail in the output.

-t <timeout>::
--timeout=<timeout>::
	Override default timeout value. In milliseconds.

EXAMPLES
--------
* Transfer a firmware size 128KiB at a time:
+
------------
# nvme fw-download /dev/nvme0 --fw=/path/to/nvme.fw --xfer=0x20000
------------

NVME
----
Part of the nvme-user suite