From: Bean Huo <beanhuo@xxxxxxxxxx>
FFU mode 4 initiates firmware download with CMD6 to enter FFU mode, followed by CMD24 for
single-block write, after each CMD24 single-block write, CMD6 is issued to exit FFU mode.
Which means in this mode, during FW downloading, the device will not remain FFU mode.
Signed-off-by: Bean Huo <beanhuo@xxxxxxxxxx>
Acked-by: Avri Altman <avri.altman@xxxxxxx>
---
mmc.1 | 3 +++
mmc.c | 7 ++++++-
mmc_cmds.c | 25 ++++++++++++++++++++-----
mmc_cmds.h | 1 +
4 files changed, 30 insertions(+), 6 deletions(-)
diff --git a/mmc.1 b/mmc.1
index 220427b..273bdcc 100644
--- a/mmc.1
+++ b/mmc.1
@@ -198,6 +198,9 @@ Same as 'ffu1', but uses CMD23+CMD25 for repeated downloads and remains in FFU m
.BI ffu3 " \fIimage\-file\-name\fR " " \fIdevice\fR " " [\fIchunk\-bytes\fR]
Same as 'ffu1', but uses CMD25+CMD12 Open-ended Multiple-block write to download and remains in FFU mode until completion.
.TP
+.BI ffu4 " \fIimage\-file\-name\fR " " \fIdevice\fR " " [\fIchunk\-bytes\fR]
+Same as 'ffu', but uses CMD24 Single-block write to download, exiting FFU mode after each block is written.
+.TP
.BI erase " " \fItype\fR " " \fIstart-address\fR " " \fIend\-address\fR " " \fIdevice\fR
Send Erase CMD38 with specific argument to the device.
.br
diff --git a/mmc.c b/mmc.c
index e013fc6..a6474db 100644
--- a/mmc.c
+++ b/mmc.c
@@ -241,7 +241,12 @@ static struct Command commands[] = {
},
{ do_ffu3, -2,
"ffu3", "<image name> <device> [chunk-bytes]\n"
- "Same as 'ffu', but uses CMD25+CMD12 Open-ended Multiple-block write to download and remains in FFU mode until completion.\n",
+ "Same as 'ffu1', but uses CMD25+CMD12 Open-ended Multiple-block write to download and remains in FFU mode until completion.\n",
+ NULL
+ },
+ { do_ffu4, -2,
+ "ffu4", "<image name> <device> [chunk-bytes]\n"
+ "Same as 'ffu1', but uses CMD24 Single-block write to download, exiting FFU mode after each block written.\n",
NULL
},
{ do_erase, -4,
diff --git a/mmc_cmds.c b/mmc_cmds.c
index 4bec56d..c9db4b4 100644
--- a/mmc_cmds.c
+++ b/mmc_cmds.c
@@ -2852,6 +2852,11 @@ static void set_ffu_download_cmd(struct mmc_ioc_multi_cmd *multi_cmd,
mmc_ioc_cmd_set_data(multi_cmd->cmds[0], buf + offset);
set_single_cmd(&multi_cmd->cmds[1], MMC_STOP_TRANSMISSION, 0, 0, 0);
multi_cmd->cmds[1].flags = MMC_RSP_SPI_R1B | MMC_RSP_R1B | MMC_CMD_AC;
+ } else if (ffu_mode == 4) {
+ fill_switch_cmd(&multi_cmd->cmds[0], EXT_CSD_MODE_CONFIG, EXT_CSD_FFU_MODE);
+ set_single_cmd(&multi_cmd->cmds[1], MMC_WRITE_BLOCK, 1, 1, arg);
+ mmc_ioc_cmd_set_data(multi_cmd->cmds[1], buf + offset);
+ fill_switch_cmd(&multi_cmd->cmds[2], EXT_CSD_MODE_CONFIG, EXT_CSD_NORMAL_MODE);
}
}
@@ -2952,8 +2957,13 @@ static int do_ffu_download(int dev_fd, __u8 *ext_csd, __u8 *fw_buf, off_t fw_siz
return -EINVAL;
}
- if (ffu_mode != 1) /* in FFU mode 1, mmc_ioc_multi_cmd contains 4 commands */
+ if (ffu_mode == 2 || ffu_mode == 3) {
+ /* in FFU mode 2, 3, mmc_ioc_multi_cmd contains 2 commands */
num_of_cmds = 2;
+ } else if (ffu_mode == 4) {
+ num_of_cmds = 3; /* in FFU mode 4, mmc_ioc_multi_cmd contains 3 commands */
+ chunk_size = 512; /* FFU mode 4 uses CMD24 single-block write */
+ }
/* allocate maximum required */
multi_cmd = calloc(1, sizeof(struct mmc_ioc_multi_cmd) +
@@ -2963,9 +2973,9 @@ static int do_ffu_download(int dev_fd, __u8 *ext_csd, __u8 *fw_buf, off_t fw_siz
return -ENOMEM;
}
- if (ffu_mode != 1) {
+ if (ffu_mode == 2 || ffu_mode == 3) {
/*
- * If the device is not in FFU mode 1, the command to enter FFU mode will be sent
+ * In FFU mode 2, mode 3, the command to enter FFU mode will be sent
* independently, separate from the firmware bundle download command.
*/
ret = enter_ffu_mode(dev_fd);
@@ -3020,9 +3030,9 @@ do_retry:
off += bytes_per_loop;
}
- if (ffu_mode != 1) {
+ if (ffu_mode == 2 || ffu_mode == 3) {
/*
- * If the device is not in FFU mode 1, the command to exit FFU mode will be sent
+ * In FFU mode 2, FFU mode 3, the command to exit FFU mode will be sent
* independently, separate from the firmware bundle download command.
*/
ret = exit_ffu_mode(dev_fd);
@@ -3208,6 +3218,11 @@ int do_ffu3(int nargs, char **argv)
return __do_ffu(nargs, argv, 3);
}
+int do_ffu4(int nargs, char **argv)
+{
+ return __do_ffu(nargs, argv, 4);
+}
+
int do_general_cmd_read(int nargs, char **argv)
{
int dev_fd;
diff --git a/mmc_cmds.h b/mmc_cmds.h
index 413bc85..a382349 100644
--- a/mmc_cmds.h
+++ b/mmc_cmds.h
@@ -44,6 +44,7 @@ int do_cache_dis(int nargs, char **argv);
int do_ffu1(int nargs, char **argv);
int do_ffu2(int nargs, char **argv);
int do_ffu3(int nargs, char **argv);
+int do_ffu4(int nargs, char **argv);
int do_read_scr(int argc, char **argv);
int do_read_cid(int argc, char **argv);
int do_read_csd(int argc, char **argv);
--
2.34.1
