* [PATCH 1/3] cmd: mtd: add markbad command support
2025-09-04 14:50 [PATCH 0/3] cmd: mtd: improvements Mikhail Kshevetskiy
@ 2025-09-04 14:50 ` Mikhail Kshevetskiy
2025-09-04 14:50 ` [PATCH 2/3] cmd: mtd: add nand_write_test " Mikhail Kshevetskiy
` (2 subsequent siblings)
3 siblings, 0 replies; 6+ messages in thread
From: Mikhail Kshevetskiy @ 2025-09-04 14:50 UTC (permalink / raw)
To: Tom Rini, Ilias Apalodimas, Jerome Forissier, Heinrich Schuchardt,
Simon Glass, Mattijs Korpershoek, Michal Simek, Ibai Erkiaga,
Miquel Raynal, Michael Trimarchi, Christian Marangi, u-boot,
Andreas Gnau
Cc: Mikhail Kshevetskiy
Some nand flashes (like spi-nand one) are registered with mtd
subsystem only, thus nand command can't be used to work with
such flashes. As result some functionality is missing.
This patch implements 'nand markbad' functionality for mtd command.
Signed-off-by: Mikhail Kshevetskiy <mikhail.kshevetskiy@iopsys.eu>
---
cmd/Kconfig | 8 ++++++++
cmd/mtd.c | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 66 insertions(+)
diff --git a/cmd/Kconfig b/cmd/Kconfig
index 29de857ba7c..8f2a35d780b 100644
--- a/cmd/Kconfig
+++ b/cmd/Kconfig
@@ -1511,6 +1511,14 @@ config CMD_MTD_OTP
help
MTD commands for OTP access.
+config CMD_MTD_MARKBAD
+ bool "mtd markbad"
+ depends on CMD_MTD
+ help
+ MTD markbad command support.
+
+ This is a clone of "nand markbad" command, but for 'mtd' subsystem.
+
config CMD_MUX
bool "mux"
depends on MULTIPLEXER
diff --git a/cmd/mtd.c b/cmd/mtd.c
index 2520b89eed2..95e4be9863d 100644
--- a/cmd/mtd.c
+++ b/cmd/mtd.c
@@ -711,6 +711,57 @@ out_put_mtd:
return ret;
}
+#ifdef CONFIG_CMD_MTD_MARKBAD
+static int do_mtd_markbad(struct cmd_tbl *cmdtp, int flag, int argc,
+ char *const argv[])
+{
+ struct mtd_info *mtd;
+ loff_t off;
+ int ret = 0;
+
+ if (argc < 3)
+ return CMD_RET_USAGE;
+
+ mtd = get_mtd_by_name(argv[1]);
+ if (IS_ERR_OR_NULL(mtd))
+ return CMD_RET_FAILURE;
+
+ if (!mtd_can_have_bb(mtd)) {
+ printf("Only NAND-based devices can have bad blocks\n");
+ goto out_put_mtd;
+ }
+
+ argc -= 2;
+ argv += 2;
+ while (argc > 0) {
+ off = hextoul(argv[0], NULL);
+ if (!mtd_is_aligned_with_block_size(mtd, off)) {
+ printf("Offset not aligned with a block (0x%x)\n",
+ mtd->erasesize);
+ ret = CMD_RET_FAILURE;
+ goto out_put_mtd;
+ }
+
+ ret = mtd_block_markbad(mtd, off);
+ if (ret) {
+ printf("block 0x%08llx NOT marked as bad! ERROR %d\n",
+ off, ret);
+ ret = CMD_RET_FAILURE;
+ } else {
+ printf("block 0x%08llx successfully marked as bad\n",
+ off);
+ }
+ --argc;
+ ++argv;
+ }
+
+out_put_mtd:
+ put_mtd_device(mtd);
+
+ return ret;
+}
+#endif
+
static int do_mtd_bad(struct cmd_tbl *cmdtp, int flag, int argc,
char *const argv[])
{
@@ -793,6 +844,9 @@ U_BOOT_LONGHELP(mtd,
"mtd otpwrite <name> <off> <hex string>\n"
"mtd otplock <name> <off> <size>\n"
"mtd otpinfo <name> [u|f]\n"
+#endif
+#if CONFIG_IS_ENABLED(CMD_MTD_MARKBAD)
+ "mtd markbad <name> <off> [<off> ...]\n"
#endif
"\n"
"With:\n"
@@ -827,5 +881,9 @@ U_BOOT_CMD_WITH_SUBCMDS(mtd, "MTD utils", mtd_help_text,
mtd_name_complete),
U_BOOT_SUBCMD_MKENT_COMPLETE(erase, 4, 0, do_mtd_erase,
mtd_name_complete),
+#if CONFIG_IS_ENABLED(CMD_MTD_MARKBAD)
+ U_BOOT_SUBCMD_MKENT_COMPLETE(markbad, 20, 0, do_mtd_markbad,
+ mtd_name_complete),
+#endif
U_BOOT_SUBCMD_MKENT_COMPLETE(bad, 2, 1, do_mtd_bad,
mtd_name_complete));
--
2.50.1
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH 2/3] cmd: mtd: add nand_write_test command support
2025-09-04 14:50 [PATCH 0/3] cmd: mtd: improvements Mikhail Kshevetskiy
2025-09-04 14:50 ` [PATCH 1/3] cmd: mtd: add markbad command support Mikhail Kshevetskiy
@ 2025-09-04 14:50 ` Mikhail Kshevetskiy
2025-09-04 14:50 ` [PATCH 3/3] cmd: mtd: add nand_read_test " Mikhail Kshevetskiy
2025-09-05 14:13 ` [PATCH 0/3] cmd: mtd: improvements Miquel Raynal
3 siblings, 0 replies; 6+ messages in thread
From: Mikhail Kshevetskiy @ 2025-09-04 14:50 UTC (permalink / raw)
To: Tom Rini, Ilias Apalodimas, Jerome Forissier, Heinrich Schuchardt,
Simon Glass, Mattijs Korpershoek, Michal Simek, Ibai Erkiaga,
Miquel Raynal, Michael Trimarchi, Christian Marangi, u-boot,
Andreas Gnau
Cc: Mikhail Kshevetskiy
Some nand flashes (like spi-nand one) are registered with mtd
subsystem only, thus nand command can't be used to work with
such flashes. As result some functionality is missing.
This patch implements 'nand torture' functionality for mtd command.
Signed-off-by: Mikhail Kshevetskiy <mikhail.kshevetskiy@iopsys.eu>
---
cmd/Kconfig | 14 ++++
cmd/mtd.c | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 211 insertions(+)
diff --git a/cmd/Kconfig b/cmd/Kconfig
index 8f2a35d780b..cd1a664f34f 100644
--- a/cmd/Kconfig
+++ b/cmd/Kconfig
@@ -1519,6 +1519,20 @@ config CMD_MTD_MARKBAD
This is a clone of "nand markbad" command, but for 'mtd' subsystem.
+config CMD_MTD_NAND_WRITE_TEST
+ bool "mtd nand_write_test (destructive)"
+ depends on CMD_MTD
+ help
+ MTD nand_write_test command support.
+
+ Writes blocks of NAND flash with different patterns.
+ This is useful to determine if a block that caused a write error
+ is still good or should be marked as bad.
+
+ This is a clone of "nand torture" command, but for 'mtd' subsystem.
+
+ WARNING: This test will destroy any data on blocks being tested.
+
config CMD_MUX
bool "mux"
depends on MULTIPLEXER
diff --git a/cmd/mtd.c b/cmd/mtd.c
index 95e4be9863d..4d69c7b4915 100644
--- a/cmd/mtd.c
+++ b/cmd/mtd.c
@@ -20,6 +20,7 @@
#include <time.h>
#include <dm/devres.h>
#include <linux/err.h>
+#include <memalign.h>
#include <linux/ctype.h>
@@ -762,6 +763,194 @@ out_put_mtd:
}
#endif
+#ifdef CONFIG_CMD_MTD_NAND_WRITE_TEST
+/**
+ * nand_check_pattern:
+ *
+ * Check if buffer contains only a certain byte pattern.
+ *
+ * @param buf buffer to check
+ * @param patt the pattern to check
+ * @param size buffer size in bytes
+ * Return: 1 if there are only patt bytes in buf
+ * 0 if something else was found
+ */
+static int nand_check_pattern(const u_char *buf, u_char patt, int size)
+{
+ int i;
+
+ for (i = 0; i < size; i++)
+ if (buf[i] != patt)
+ return 0;
+ return 1;
+}
+
+/**
+ * nand_write_test:
+ *
+ * Writes a block of NAND flash with different patterns.
+ * This is useful to determine if a block that caused a write error is still
+ * good or should be marked as bad.
+ *
+ * @param mtd nand mtd instance
+ * @param offset offset in flash
+ * Return: 0 if the block is still good
+ */
+static int nand_write_test(struct mtd_info *mtd, loff_t offset)
+{
+ u_char patterns[] = {0xa5, 0x5a, 0x00};
+ struct erase_info instr = {
+ .mtd = mtd,
+ .addr = offset,
+ .len = mtd->erasesize,
+ };
+ size_t retlen;
+ int err, ret = -1, i, patt_count;
+ u_char *buf;
+
+ if ((offset & (mtd->erasesize - 1)) != 0) {
+ puts("Attempt to torture a block at a non block-aligned offset\n");
+ return -EINVAL;
+ }
+
+ if (offset + mtd->erasesize > mtd->size) {
+ puts("Attempt to torture a block outside the flash area\n");
+ return -EINVAL;
+ }
+
+ patt_count = ARRAY_SIZE(patterns);
+
+ buf = malloc_cache_aligned(mtd->erasesize);
+ if (buf == NULL) {
+ puts("Out of memory for erase block buffer\n");
+ return -ENOMEM;
+ }
+
+ for (i = 0; i < patt_count; i++) {
+ err = mtd_erase(mtd, &instr);
+ if (err) {
+ printf("%s: erase() failed for block at 0x%llx: %d\n",
+ mtd->name, instr.addr, err);
+ goto out;
+ }
+
+ /* Make sure the block contains only 0xff bytes */
+ err = mtd_read(mtd, offset, mtd->erasesize, &retlen, buf);
+ if ((err && err != -EUCLEAN) || retlen != mtd->erasesize) {
+ printf("%s: read() failed for block at 0x%llx: %d\n",
+ mtd->name, instr.addr, err);
+ goto out;
+ }
+
+ err = nand_check_pattern(buf, 0xff, mtd->erasesize);
+ if (!err) {
+ printf("Erased block at 0x%llx, but a non-0xff byte was found\n",
+ offset);
+ ret = -EIO;
+ goto out;
+ }
+
+ /* Write a pattern and check it */
+ memset(buf, patterns[i], mtd->erasesize);
+ err = mtd_write(mtd, offset, mtd->erasesize, &retlen, buf);
+ if (err || retlen != mtd->erasesize) {
+ printf("%s: write() failed for block at 0x%llx: %d\n",
+ mtd->name, instr.addr, err);
+ goto out;
+ }
+
+ err = mtd_read(mtd, offset, mtd->erasesize, &retlen, buf);
+ if ((err && err != -EUCLEAN) || retlen != mtd->erasesize) {
+ printf("%s: read() failed for block at 0x%llx: %d\n",
+ mtd->name, instr.addr, err);
+ goto out;
+ }
+
+ err = nand_check_pattern(buf, patterns[i], mtd->erasesize);
+ if (!err) {
+ printf("Pattern 0x%.2x checking failed for block at "
+ "0x%llx\n", patterns[i], offset);
+ ret = -EIO;
+ goto out;
+ }
+ }
+
+ ret = 0;
+
+out:
+ free(buf);
+ return ret;
+}
+
+static int do_nand_write_test(struct cmd_tbl *cmdtp, int flag, int argc,
+ char *const argv[])
+{
+ struct mtd_info *mtd;
+ loff_t off, len;
+ int ret = 0;
+ unsigned int failed = 0, passed = 0;
+
+ if (argc < 2)
+ return CMD_RET_USAGE;
+
+ mtd = get_mtd_by_name(argv[1]);
+ if (IS_ERR_OR_NULL(mtd))
+ return CMD_RET_FAILURE;
+
+ if (!mtd_can_have_bb(mtd)) {
+ printf("Only NAND-based devices can be tortured\n");
+ goto out_put_mtd;
+ }
+
+ argc -= 2;
+ argv += 2;
+
+ off = argc > 0 ? hextoul(argv[0], NULL) : 0;
+ len = argc > 1 ? hextoul(argv[1], NULL) : mtd->size;
+
+ if (!mtd_is_aligned_with_block_size(mtd, off)) {
+ printf("Offset not aligned with a block (0x%x)\n",
+ mtd->erasesize);
+ ret = CMD_RET_FAILURE;
+ goto out_put_mtd;
+ }
+
+ if (!mtd_is_aligned_with_block_size(mtd, len)) {
+ printf("Size not a multiple of a block (0x%x)\n",
+ mtd->erasesize);
+ ret = CMD_RET_FAILURE;
+ goto out_put_mtd;
+ }
+
+ printf("\nNAND write test: device '%s' offset 0x%llx size 0x%llx (block size 0x%x)\n",
+ mtd->name, off, len, mtd->erasesize);
+ while (len > 0) {
+ printf("\r block at %llx ", off);
+ if (mtd_block_isbad(mtd, off)) {
+ printf("marked bad, skipping\n");
+ } else {
+ ret = nand_write_test(mtd, off);
+ if (ret) {
+ failed++;
+ printf("failed\n");
+ } else {
+ passed++;
+ }
+ }
+ off += mtd->erasesize;
+ len -= mtd->erasesize;
+ }
+ printf("\n Passed: %u, failed: %u\n", passed, failed);
+ if (failed != 0)
+ ret = CMD_RET_FAILURE;
+
+out_put_mtd:
+ put_mtd_device(mtd);
+
+ return ret;
+}
+#endif
+
static int do_mtd_bad(struct cmd_tbl *cmdtp, int flag, int argc,
char *const argv[])
{
@@ -847,6 +1036,9 @@ U_BOOT_LONGHELP(mtd,
#endif
#if CONFIG_IS_ENABLED(CMD_MTD_MARKBAD)
"mtd markbad <name> <off> [<off> ...]\n"
+#endif
+#if CONFIG_IS_ENABLED(CMD_MTD_NAND_WRITE_TEST)
+ "mtd nand_write_test <name> [<off> [<size>]]\n"
#endif
"\n"
"With:\n"
@@ -884,6 +1076,11 @@ U_BOOT_CMD_WITH_SUBCMDS(mtd, "MTD utils", mtd_help_text,
#if CONFIG_IS_ENABLED(CMD_MTD_MARKBAD)
U_BOOT_SUBCMD_MKENT_COMPLETE(markbad, 20, 0, do_mtd_markbad,
mtd_name_complete),
+#endif
+#if CONFIG_IS_ENABLED(CMD_MTD_NAND_WRITE_TEST)
+ U_BOOT_SUBCMD_MKENT_COMPLETE(nand_write_test, 4, 0,
+ do_nand_write_test,
+ mtd_name_complete),
#endif
U_BOOT_SUBCMD_MKENT_COMPLETE(bad, 2, 1, do_mtd_bad,
mtd_name_complete));
--
2.50.1
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH 3/3] cmd: mtd: add nand_read_test command support
2025-09-04 14:50 [PATCH 0/3] cmd: mtd: improvements Mikhail Kshevetskiy
2025-09-04 14:50 ` [PATCH 1/3] cmd: mtd: add markbad command support Mikhail Kshevetskiy
2025-09-04 14:50 ` [PATCH 2/3] cmd: mtd: add nand_write_test " Mikhail Kshevetskiy
@ 2025-09-04 14:50 ` Mikhail Kshevetskiy
2025-09-05 22:27 ` Michael Nazzareno Trimarchi
2025-09-05 14:13 ` [PATCH 0/3] cmd: mtd: improvements Miquel Raynal
3 siblings, 1 reply; 6+ messages in thread
From: Mikhail Kshevetskiy @ 2025-09-04 14:50 UTC (permalink / raw)
To: Tom Rini, Ilias Apalodimas, Jerome Forissier, Heinrich Schuchardt,
Simon Glass, Mattijs Korpershoek, Michal Simek, Ibai Erkiaga,
Miquel Raynal, Michael Trimarchi, Christian Marangi, u-boot,
Andreas Gnau
Cc: Mikhail Kshevetskiy
This patch implements read-only test of nand flash devices.
Test reads blocks of NAND flash in normal and raw modes and compares
results. The following statuses can be returned for a block:
* non-ecc reading failed,
* ecc reading failed,
* block is bad,
* bitflips is above maximum,
* actual number of biflips above reported one,
* bitflips reached it maximum value,
* block is ok.
Signed-off-by: Mikhail Kshevetskiy <mikhail.kshevetskiy@iopsys.eu>
---
cmd/Kconfig | 16 +++++
cmd/mtd.c | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 213 insertions(+)
diff --git a/cmd/Kconfig b/cmd/Kconfig
index cd1a664f34f..21d6db57628 100644
--- a/cmd/Kconfig
+++ b/cmd/Kconfig
@@ -1533,6 +1533,22 @@ config CMD_MTD_NAND_WRITE_TEST
WARNING: This test will destroy any data on blocks being tested.
+config CMD_MTD_NAND_READ_TEST
+ bool "mtd nand_read_test"
+ depends on CMD_MTD
+ help
+ MTD nand_read_test command support.
+
+ Reads blocks of NAND flash in normal and raw modes and compares results.
+ The following statuses can be returned for a block:
+ * non-ecc reading failed,
+ * ecc reading failed,
+ * block is bad,
+ * bitflips is above maximum,
+ * actual number of biflips above reported one,
+ * bitflips reached it maximum value,
+ * block is ok.
+
config CMD_MUX
bool "mux"
depends on MULTIPLEXER
diff --git a/cmd/mtd.c b/cmd/mtd.c
index 4d69c7b4915..cee3a7e43ef 100644
--- a/cmd/mtd.c
+++ b/cmd/mtd.c
@@ -951,6 +951,195 @@ out_put_mtd:
}
#endif
+#ifdef CONFIG_CMD_MTD_NAND_READ_TEST
+enum nand_read_status {
+ NAND_READ_STATUS_UNKNOWN = 0,
+ NAND_READ_STATUS_NONECC_READ_FAIL,
+ NAND_READ_STATUS_ECC_READ_FAIL,
+ NAND_READ_STATUS_BAD_BLOCK,
+ NAND_READ_STATUS_BITFLIP_ABOVE_MAX,
+ NAND_READ_STATUS_BITFLIP_MISMATCH,
+ NAND_READ_STATUS_BITFLIP_MAX,
+ NAND_READ_STATUS_OK,
+};
+
+static enum nand_read_status nand_read_block_check(struct mtd_info *mtd,
+ loff_t off, size_t blocksize)
+{
+ struct mtd_oob_ops ops = {};
+ u_char *buf;
+ int i, d, ret, len, pos, cnt, max;
+
+ if (blocksize % mtd->writesize != 0) {
+ printf("\r block at 0x%llx: bad block size\n", off);
+ return NAND_READ_STATUS_UNKNOWN;
+ }
+
+ buf = malloc_cache_aligned(2 * blocksize);
+ if (buf == NULL) {
+ printf("\r block at 0x%llx: can't allocate memory\n", off);
+ return NAND_READ_STATUS_UNKNOWN;
+ }
+
+ ops.mode = MTD_OPS_RAW;
+ ops.len = blocksize;
+ ops.datbuf = buf;
+ ops.ooblen = 0;
+ ops.oobbuf = NULL;
+
+ if (mtd->_read_oob)
+ ret = mtd->_read_oob(mtd, off, &ops);
+ else
+ ret = mtd->_read(mtd, off, ops.len, &ops.retlen, ops.datbuf);
+
+ if (ret != 0) {
+ free(buf);
+ printf("\r block at 0x%llx: non-ecc reading error %d\n",
+ off, ret);
+ return NAND_READ_STATUS_NONECC_READ_FAIL;
+ }
+
+ ops.mode = MTD_OPS_AUTO_OOB;
+ ops.datbuf = buf + blocksize;
+
+ if (mtd->_read_oob)
+ ret = mtd->_read_oob(mtd, off, &ops);
+ else
+ ret = mtd->_read(mtd, off, ops.len, &ops.retlen, ops.datbuf);
+
+ if (ret == -EBADMSG) {
+ free(buf);
+ printf("\r block at 0x%llx: bad block\n", off);
+ return NAND_READ_STATUS_BAD_BLOCK;
+ }
+
+ if (ret < 0) {
+ free(buf);
+ printf("\r block at 0x%llx: ecc reading error %d\n", off, ret);
+ return NAND_READ_STATUS_ECC_READ_FAIL;
+ }
+
+ if (mtd->ecc_strength == 0) {
+ free(buf);
+ return NAND_READ_STATUS_OK;
+ }
+
+ if (ret > mtd->ecc_strength) {
+ free(buf);
+ printf("\r block at 0x%llx: returned bit-flips value %d "
+ "is above maximum value %d\n",
+ off, ret, mtd->ecc_strength);
+ return NAND_READ_STATUS_BITFLIP_ABOVE_MAX;
+ }
+
+ max = 0;
+ pos = 0;
+ len = blocksize;
+ while (len > 0) {
+ cnt = 0;
+ for (i = 0; i < mtd->ecc_step_size; i++) {
+ d = buf[pos + i] ^ buf[blocksize + pos + i];
+ if (d == 0)
+ continue;
+
+ while (d > 0) {
+ d &= (d - 1);
+ cnt++;
+ }
+ }
+ if (cnt > max)
+ max = cnt;
+
+ len -= mtd->ecc_step_size;
+ pos += mtd->ecc_step_size;
+ }
+
+ free(buf);
+
+ if (max > ret) {
+ printf("\r block at 0x%llx: bitflip mismatch, "
+ "read %d but actual %d\n", off, ret, max);
+ return NAND_READ_STATUS_BITFLIP_MISMATCH;
+ }
+
+ if (ret == mtd->ecc_strength) {
+ printf("\r block at 0x%llx: max bitflip reached, "
+ "block is unreliable\n", off);
+ return NAND_READ_STATUS_BITFLIP_MAX;
+ }
+
+ return NAND_READ_STATUS_OK;
+}
+
+static int do_mtd_nand_read_test(struct cmd_tbl *cmdtp, int flag, int argc,
+ char *const argv[])
+{
+ struct mtd_info *mtd;
+ u64 off, blocks;
+ int stat[NAND_READ_STATUS_OK + 1];
+ enum nand_read_status ret;
+
+ if (argc < 2)
+ return CMD_RET_USAGE;
+
+ mtd = get_mtd_by_name(argv[1]);
+ if (IS_ERR_OR_NULL(mtd))
+ return CMD_RET_FAILURE;
+
+ if (!mtd_can_have_bb(mtd)) {
+ printf("Only NAND-based devices can be checked\n");
+ goto out_put_mtd;
+ }
+
+ blocks = mtd->size;
+ do_div(blocks, mtd->erasesize);
+
+ printf("ECC strength: %d\n", mtd->ecc_strength);
+ printf("ECC step size: %d\n", mtd->ecc_step_size);
+ printf("Erase block size: 0x%x\n", mtd->erasesize);
+ printf("Total blocks: %lld\n", blocks);
+
+ printf("\nworking...\n");
+ memset(stat, 0, sizeof(stat));
+ for (off = 0; off < mtd->size; off += mtd->erasesize) {
+ ret = nand_read_block_check(mtd, off, mtd->erasesize);
+ stat[ret]++;
+
+ switch (ret) {
+ case NAND_READ_STATUS_BAD_BLOCK:
+ case NAND_READ_STATUS_BITFLIP_MAX:
+ if (!mtd_block_isbad(mtd, off))
+ printf("\r block at 0x%llx: should be marked "
+ "as BAD\n", off);
+ break;
+
+ case NAND_READ_STATUS_OK:
+ if (mtd_block_isbad(mtd, off))
+ printf("\r block at 0x%llx: marked as BAD, but "
+ "probably is GOOD\n", off);
+ break;
+
+ default:
+ break;
+ }
+ }
+
+out_put_mtd:
+ put_mtd_device(mtd);
+ printf("\n");
+ printf("results:\n");
+ printf(" Good blocks: %d\n", stat[NAND_READ_STATUS_OK]);
+ printf(" Physically bad blocks: %d\n", stat[NAND_READ_STATUS_BAD_BLOCK]);
+ printf(" Unreliable blocks: %d\n", stat[NAND_READ_STATUS_BITFLIP_MAX]);
+ printf(" Non checked blocks: %d\n", stat[NAND_READ_STATUS_UNKNOWN]);
+ printf(" Failed to check blocks: %d\n", stat[NAND_READ_STATUS_NONECC_READ_FAIL] +
+ stat[NAND_READ_STATUS_ECC_READ_FAIL]);
+ printf(" Suspictious blocks: %d\n", stat[NAND_READ_STATUS_BITFLIP_ABOVE_MAX] +
+ stat[NAND_READ_STATUS_BITFLIP_MISMATCH]);
+ return CMD_RET_SUCCESS;
+}
+#endif
+
static int do_mtd_bad(struct cmd_tbl *cmdtp, int flag, int argc,
char *const argv[])
{
@@ -1039,6 +1228,9 @@ U_BOOT_LONGHELP(mtd,
#endif
#if CONFIG_IS_ENABLED(CMD_MTD_NAND_WRITE_TEST)
"mtd nand_write_test <name> [<off> [<size>]]\n"
+#endif
+#if CONFIG_IS_ENABLED(CMD_MTD_NAND_READ_TEST)
+ "mtd nand_read_test <name>\n"
#endif
"\n"
"With:\n"
@@ -1081,6 +1273,11 @@ U_BOOT_CMD_WITH_SUBCMDS(mtd, "MTD utils", mtd_help_text,
U_BOOT_SUBCMD_MKENT_COMPLETE(nand_write_test, 4, 0,
do_nand_write_test,
mtd_name_complete),
+#endif
+#if CONFIG_IS_ENABLED(CMD_MTD_NAND_READ_TEST)
+ U_BOOT_SUBCMD_MKENT_COMPLETE(nand_read_test, 2, 0,
+ do_mtd_nand_read_test,
+ mtd_name_complete),
#endif
U_BOOT_SUBCMD_MKENT_COMPLETE(bad, 2, 1, do_mtd_bad,
mtd_name_complete));
--
2.50.1
^ permalink raw reply related [flat|nested] 6+ messages in thread* Re: [PATCH 3/3] cmd: mtd: add nand_read_test command support
2025-09-04 14:50 ` [PATCH 3/3] cmd: mtd: add nand_read_test " Mikhail Kshevetskiy
@ 2025-09-05 22:27 ` Michael Nazzareno Trimarchi
0 siblings, 0 replies; 6+ messages in thread
From: Michael Nazzareno Trimarchi @ 2025-09-05 22:27 UTC (permalink / raw)
To: Mikhail Kshevetskiy
Cc: Tom Rini, Ilias Apalodimas, Jerome Forissier, Heinrich Schuchardt,
Simon Glass, Mattijs Korpershoek, Michal Simek, Ibai Erkiaga,
Miquel Raynal, Christian Marangi, u-boot, Andreas Gnau
Hi
On Thu, Sep 4, 2025 at 4:50 PM Mikhail Kshevetskiy
<mikhail.kshevetskiy@iopsys.eu> wrote:
>
> This patch implements read-only test of nand flash devices.
>
> Test reads blocks of NAND flash in normal and raw modes and compares
> results. The following statuses can be returned for a block:
> * non-ecc reading failed,
> * ecc reading failed,
> * block is bad,
> * bitflips is above maximum,
> * actual number of biflips above reported one,
> * bitflips reached it maximum value,
> * block is ok.
>
> Signed-off-by: Mikhail Kshevetskiy <mikhail.kshevetskiy@iopsys.eu>
> ---
> cmd/Kconfig | 16 +++++
> cmd/mtd.c | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++++
> 2 files changed, 213 insertions(+)
>
> diff --git a/cmd/Kconfig b/cmd/Kconfig
> index cd1a664f34f..21d6db57628 100644
> --- a/cmd/Kconfig
> +++ b/cmd/Kconfig
> @@ -1533,6 +1533,22 @@ config CMD_MTD_NAND_WRITE_TEST
>
> WARNING: This test will destroy any data on blocks being tested.
>
> +config CMD_MTD_NAND_READ_TEST
> + bool "mtd nand_read_test"
> + depends on CMD_MTD
> + help
> + MTD nand_read_test command support.
> +
> + Reads blocks of NAND flash in normal and raw modes and compares results.
> + The following statuses can be returned for a block:
> + * non-ecc reading failed,
> + * ecc reading failed,
> + * block is bad,
> + * bitflips is above maximum,
> + * actual number of biflips above reported one,
> + * bitflips reached it maximum value,
> + * block is ok.
> +
> config CMD_MUX
> bool "mux"
> depends on MULTIPLEXER
> diff --git a/cmd/mtd.c b/cmd/mtd.c
> index 4d69c7b4915..cee3a7e43ef 100644
> --- a/cmd/mtd.c
> +++ b/cmd/mtd.c
> @@ -951,6 +951,195 @@ out_put_mtd:
> }
> #endif
>
> +#ifdef CONFIG_CMD_MTD_NAND_READ_TEST
> +enum nand_read_status {
> + NAND_READ_STATUS_UNKNOWN = 0,
> + NAND_READ_STATUS_NONECC_READ_FAIL,
> + NAND_READ_STATUS_ECC_READ_FAIL,
> + NAND_READ_STATUS_BAD_BLOCK,
> + NAND_READ_STATUS_BITFLIP_ABOVE_MAX,
> + NAND_READ_STATUS_BITFLIP_MISMATCH,
> + NAND_READ_STATUS_BITFLIP_MAX,
> + NAND_READ_STATUS_OK,
> +};
> +
> +static enum nand_read_status nand_read_block_check(struct mtd_info *mtd,
> + loff_t off, size_t blocksize)
> +{
> + struct mtd_oob_ops ops = {};
> + u_char *buf;
> + int i, d, ret, len, pos, cnt, max;
> +
> + if (blocksize % mtd->writesize != 0) {
> + printf("\r block at 0x%llx: bad block size\n", off);
> + return NAND_READ_STATUS_UNKNOWN;
> + }
> +
> + buf = malloc_cache_aligned(2 * blocksize);
> + if (buf == NULL) {
> + printf("\r block at 0x%llx: can't allocate memory\n", off);
> + return NAND_READ_STATUS_UNKNOWN;
> + }
> +
I think that you can allocate those and check outside the function
only one time. Then you
can use standard return ENOMEM.
> + ops.mode = MTD_OPS_RAW;
> + ops.len = blocksize;
> + ops.datbuf = buf;
> + ops.ooblen = 0;
> + ops.oobbuf = NULL;
> +
You don't need to set to 0 and null and if you drop the allocation and
the check then
you can initialize in the struct definition.
> + if (mtd->_read_oob)
> + ret = mtd->_read_oob(mtd, off, &ops);
> + else
> + ret = mtd->_read(mtd, off, ops.len, &ops.retlen, ops.datbuf);
> +
> + if (ret != 0) {
> + free(buf);
> + printf("\r block at 0x%llx: non-ecc reading error %d\n",
> + off, ret);
> + return NAND_READ_STATUS_NONECC_READ_FAIL;
> + }
> +
> + ops.mode = MTD_OPS_AUTO_OOB;
> + ops.datbuf = buf + blocksize;
> +
> + if (mtd->_read_oob)
> + ret = mtd->_read_oob(mtd, off, &ops);
> + else
> + ret = mtd->_read(mtd, off, ops.len, &ops.retlen, ops.datbuf);
> +
> + if (ret == -EBADMSG) {
> + free(buf);
> + printf("\r block at 0x%llx: bad block\n", off);
> + return NAND_READ_STATUS_BAD_BLOCK;
> + }
> +
> + if (ret < 0) {
> + free(buf);
> + printf("\r block at 0x%llx: ecc reading error %d\n", off, ret);
> + return NAND_READ_STATUS_ECC_READ_FAIL;
> + }
> +
> + if (mtd->ecc_strength == 0) {
> + free(buf);
> + return NAND_READ_STATUS_OK;
> + }
> +
> + if (ret > mtd->ecc_strength) {
> + free(buf);
> + printf("\r block at 0x%llx: returned bit-flips value %d "
> + "is above maximum value %d\n",
> + off, ret, mtd->ecc_strength);
> + return NAND_READ_STATUS_BITFLIP_ABOVE_MAX;
> + }
> +
> + max = 0;
> + pos = 0;
> + len = blocksize;
> + while (len > 0) {
> + cnt = 0;
> + for (i = 0; i < mtd->ecc_step_size; i++) {
> + d = buf[pos + i] ^ buf[blocksize + pos + i];
> + if (d == 0)
> + continue;
> +
> + while (d > 0) {
> + d &= (d - 1);
> + cnt++;
> + }
> + }
> + if (cnt > max)
> + max = cnt;
> +
> + len -= mtd->ecc_step_size;
> + pos += mtd->ecc_step_size;
> + }
> +
> + free(buf);
> +
> + if (max > ret) {
> + printf("\r block at 0x%llx: bitflip mismatch, "
> + "read %d but actual %d\n", off, ret, max);
> + return NAND_READ_STATUS_BITFLIP_MISMATCH;
> + }
> +
> + if (ret == mtd->ecc_strength) {
> + printf("\r block at 0x%llx: max bitflip reached, "
> + "block is unreliable\n", off);
> + return NAND_READ_STATUS_BITFLIP_MAX;
> + }
> +
> + return NAND_READ_STATUS_OK;
> +}
> +
> +static int do_mtd_nand_read_test(struct cmd_tbl *cmdtp, int flag, int argc,
> + char *const argv[])
> +{
> + struct mtd_info *mtd;
> + u64 off, blocks;
> + int stat[NAND_READ_STATUS_OK + 1];
> + enum nand_read_status ret;
> +
> + if (argc < 2)
> + return CMD_RET_USAGE;
> +
> + mtd = get_mtd_by_name(argv[1]);
> + if (IS_ERR_OR_NULL(mtd))
> + return CMD_RET_FAILURE;
> +
> + if (!mtd_can_have_bb(mtd)) {
> + printf("Only NAND-based devices can be checked\n");
> + goto out_put_mtd;
> + }
> +
> + blocks = mtd->size;
> + do_div(blocks, mtd->erasesize);
> +
> + printf("ECC strength: %d\n", mtd->ecc_strength);
> + printf("ECC step size: %d\n", mtd->ecc_step_size);
> + printf("Erase block size: 0x%x\n", mtd->erasesize);
> + printf("Total blocks: %lld\n", blocks);
> +
> + printf("\nworking...\n");
> + memset(stat, 0, sizeof(stat));
> + for (off = 0; off < mtd->size; off += mtd->erasesize) {
> + ret = nand_read_block_check(mtd, off, mtd->erasesize);
> + stat[ret]++;
> +
> + switch (ret) {
> + case NAND_READ_STATUS_BAD_BLOCK:
> + case NAND_READ_STATUS_BITFLIP_MAX:
> + if (!mtd_block_isbad(mtd, off))
> + printf("\r block at 0x%llx: should be marked "
> + "as BAD\n", off);
> + break;
> +
> + case NAND_READ_STATUS_OK:
> + if (mtd_block_isbad(mtd, off))
> + printf("\r block at 0x%llx: marked as BAD, but "
> + "probably is GOOD\n", off);
> + break;
> +
> + default:
> + break;
> + }
> + }
> +
> +out_put_mtd:
> + put_mtd_device(mtd);
> + printf("\n");
> + printf("results:\n");
> + printf(" Good blocks: %d\n", stat[NAND_READ_STATUS_OK]);
> + printf(" Physically bad blocks: %d\n", stat[NAND_READ_STATUS_BAD_BLOCK]);
> + printf(" Unreliable blocks: %d\n", stat[NAND_READ_STATUS_BITFLIP_MAX]);
> + printf(" Non checked blocks: %d\n", stat[NAND_READ_STATUS_UNKNOWN]);
> + printf(" Failed to check blocks: %d\n", stat[NAND_READ_STATUS_NONECC_READ_FAIL] +
> + stat[NAND_READ_STATUS_ECC_READ_FAIL]);
> + printf(" Suspictious blocks: %d\n", stat[NAND_READ_STATUS_BITFLIP_ABOVE_MAX] +
> + stat[NAND_READ_STATUS_BITFLIP_MISMATCH]);
> + return CMD_RET_SUCCESS;
> +}
> +#endif
> +
> static int do_mtd_bad(struct cmd_tbl *cmdtp, int flag, int argc,
> char *const argv[])
> {
> @@ -1039,6 +1228,9 @@ U_BOOT_LONGHELP(mtd,
> #endif
> #if CONFIG_IS_ENABLED(CMD_MTD_NAND_WRITE_TEST)
> "mtd nand_write_test <name> [<off> [<size>]]\n"
> +#endif
> +#if CONFIG_IS_ENABLED(CMD_MTD_NAND_READ_TEST)
> + "mtd nand_read_test <name>\n"
> #endif
> "\n"
> "With:\n"
> @@ -1081,6 +1273,11 @@ U_BOOT_CMD_WITH_SUBCMDS(mtd, "MTD utils", mtd_help_text,
> U_BOOT_SUBCMD_MKENT_COMPLETE(nand_write_test, 4, 0,
> do_nand_write_test,
> mtd_name_complete),
> +#endif
> +#if CONFIG_IS_ENABLED(CMD_MTD_NAND_READ_TEST)
> + U_BOOT_SUBCMD_MKENT_COMPLETE(nand_read_test, 2, 0,
> + do_mtd_nand_read_test,
> + mtd_name_complete),
> #endif
> U_BOOT_SUBCMD_MKENT_COMPLETE(bad, 2, 1, do_mtd_bad,
> mtd_name_complete));
> --
> 2.50.1
>
Otherwise:
Reviewed-by: Michael Trimarchi <michael@amarulasolutions.com>
--
Michael Nazzareno Trimarchi
Co-Founder & Chief Executive Officer
M. +39 347 913 2170
michael@amarulasolutions.com
__________________________________
Amarula Solutions BV
Joop Geesinkweg 125, 1114 AB, Amsterdam, NL
T. +31 (0)85 111 9172
info@amarulasolutions.com
www.amarulasolutions.com
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH 0/3] cmd: mtd: improvements
2025-09-04 14:50 [PATCH 0/3] cmd: mtd: improvements Mikhail Kshevetskiy
` (2 preceding siblings ...)
2025-09-04 14:50 ` [PATCH 3/3] cmd: mtd: add nand_read_test " Mikhail Kshevetskiy
@ 2025-09-05 14:13 ` Miquel Raynal
3 siblings, 0 replies; 6+ messages in thread
From: Miquel Raynal @ 2025-09-05 14:13 UTC (permalink / raw)
To: Mikhail Kshevetskiy
Cc: Tom Rini, Ilias Apalodimas, Jerome Forissier, Heinrich Schuchardt,
Simon Glass, Mattijs Korpershoek, Michal Simek, Ibai Erkiaga,
Michael Trimarchi, Christian Marangi, u-boot, Andreas Gnau
On 04/09/2025 at 17:50:20 +03, Mikhail Kshevetskiy <mikhail.kshevetskiy@iopsys.eu> wrote:
> Some nand flashes (like spi-nand one) are registered with mtd
> subsystem only, thus nand command can't be used to work with
> such flashes. As result some functionality is missing.
>
> This patch series introduce following features:
> * 'mtd markbad' command (clone of 'nand markbad')
> * 'mtd nand_write_test' command (clone of 'nand torture')
>
> Also a new command 'mtd nand_read_test' introduced. It produce readonly
> test of flash. It's mostly usefull to:
> * check general flash state,
> * check the correctness of returned number of corrected bits.
>
> Mikhail Kshevetskiy (3):
> cmd: mtd: add markbad command support
> cmd: mtd: add nand_write_test command support
> cmd: mtd: add nand_read_test command support
Nice!
Reviewed-by: Miquel Raynal <miquel.raynal@bootlin.com>
Thanks,
Miquèl
^ permalink raw reply [flat|nested] 6+ messages in thread