diff options
| author | Patrick Delaunay | 2019-10-14 09:28:06 +0200 |
|---|---|---|
| committer | Marek Vasut | 2019-10-31 12:12:31 +0100 |
| commit | ec44cace4b8d23556924550fe76bf2744eb91144 (patch) | |
| tree | fa18cb82d82561fbf4790fd372e8ecd9b70522d6 /doc | |
| parent | d5640f700d0413059b39cdd621c9401ef90d08fa (diff) | |
dfu: add DFU virtual backend
Add a virtual DFU backend to allow board specific read and write
(for OTP update for example).
Acked-by: Lukasz Majewski <lukma@denx.de>
Signed-off-by: Patrick Delaunay <patrick.delaunay@st.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/README.dfu | 32 |
1 files changed, 31 insertions, 1 deletions
diff --git a/doc/README.dfu b/doc/README.dfu index 92a7695be22..43a6f311d63 100644 --- a/doc/README.dfu +++ b/doc/README.dfu @@ -22,11 +22,18 @@ Overview: - RAM - SF (serial flash) - MTD (all MTD device: NAND, SPI-NOR, SPI-NAND,...) + - virtual These DFU backends are also used by - the dfutftp (see README.dfutftp) - the thordown command (cmd/thordown.c and gadget/f_thor.c) + The "virtual" backend is a generic DFU backend to support a board specific + target (for example OTP), only based on the weak functions: + - dfu_write_medium_virt + - dfu_get_medium_size_virt + - dfu_read_medium_virt + Configuration Options: CONFIG_DFU CONFIG_DFU_OVER_USB @@ -36,6 +43,7 @@ Configuration Options: CONFIG_DFU_RAM CONFIG_DFU_SF CONFIG_DFU_SF_PART + CONFIG_DFU_VIRTUAL CONFIG_CMD_DFU Environment variables: @@ -117,6 +125,11 @@ Commands: with <partid> is the MTD partition index + "virt" + cmd: dfu 0 virt <dev> + each element in "dfu_alt_info" = + <name> + <interface> and <dev> are absent: the dfu command to use multiple devices cmd: dfu 0 list @@ -128,7 +141,7 @@ Commands: ram <dev>=<alt1>;....;<altN> sf <dev>=<alt1>;....;<altN> mtd <dev>=<alt1>;....;<altN> - + virt <dev>=<alt1>;....;<altN> Host tools: When U-Boot runs the dfu stack, the DFU host tools can be used @@ -230,3 +243,20 @@ Usage: dev: MTD alt: 1 name: u-boot layout: RAW_ADDR dev: MTD alt: 2 name: u-boot-env layout: RAW_ADDR dev: MTD alt: 3 name: UBI layout: RAW_ADDR + + Example 3: firmware located in SD Card (mmc) and virtual partition on + OTP and PMIC not volatile memory + - alternate 1 (alt=1) for scard + - alternate 2 (alt=2) for OTP (virtual) + - alternate 3 (alt=3) for PMIC NVM (virtual) + + U-Boot> env set dfu_alt_info \ + "mmc 0=sdcard raw 0 0x100000&"\ + "virt 0=otp" \ + "virt 1=pmic" + + U-Boot> dfu 0 list + DFU alt settings list: + dev: eMMC alt: 0 name: sdcard layout: RAW_ADDR + dev: VIRT alt: 1 name: otp layout: RAW_ADDR + dev: VIRT alt: 2 name: pmic layout: RAW_ADDR |