User Tools

Site Tools

FIXME This page is a Work In Progress. The goal is to make it similar to opkg and then link to it as often as possible


mtd is a utility we use to write to an MTD (Memory Technology Device). Please read the Notes to learn more.


Usage: mtd [<options> ...] <command> [<arguments> ...] <device>[:<device>...]

Writing to MTD

unlock <dev> unlock the device
refresh <dev> refresh mtd partition
erase <dev> erase all data on device
write <imagefile>|- write <imagefile> (use - for stdin) to device
jffs2write <file> append <file> to the jffs2 partition on the device
fixtrx <dev> fix the checksum in a trx header on first boot


-q quiet mode (once: no [w] on writing, twice: no status messages)
-n write without first erasing the blocks
-r reboot after successful command
-f force write without trx checks
-e <device> erase <device> before executing the command
-d <name> directory for jffs2write, defaults to “tmp”
-j <name> integrate <file> into jffs2 data when writing an image
-o offset offset of the image header in the partition(for fixtrx)
-F <part>[:<size>[:<entrypoint>]][,<part>…] alter the fis partition table to create new partitions replacing the partitions provided as argument to the write command (only valid together with the write command)


Download linux.bin from Internet (it's not safe to do so, here is for demonstration purpose only), then write linux.bin to a MTD partition labeled as linux (could be mtd4) and reboot afterwards:

cd /tmp
mtd -r write /tmp/linux.bin linux

mtd vs dd

The differences between dd (disc dump) and mtd are … TODO


  • To make it more clear, here is a small comparison of MTD devices and block devices:
    • MTD devices represent flash devices and they consist of eraseblocks of rather large size, typically about 128KiB. Block devices consist of small blocks, typically 512 bytes. MTD devices support 3 main operations - read from some offset within an eraseblock, write to some offset within an eraseblock, and erase a whole eraseblock. Block devices support 2 main operations - read a whole block and write a whole block.
    • The whole eraseblock has to be erased before it becomes possible to re-write its contents. Blocks may be just re-written.
    • Eraseblocks become worn out after some number of erase cycles - typically 100K-1G for SLC NAND and NOR flashes, and 1K-10K for MLC NAND flashes. Blocks do not have the wear-out property.
    • Eraseblocks may become bad (only on NAND flashes) and software should deal with this. Blocks on hard drives typically do not become bad, because hardware has mechanisms to substitute bad blocks, at least in modern LBA disks.
  • Sometimes flash memory uses FTL: Raw Flash vs. FTL (Flash Translation Layer)
  • Although most flashes on the commodity hardware have FTL, there are systems which have bare flashes and do not use FTL! Those are mostly various handheld devices and embedded systems.
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
docs/techref/mtd.txt · Last modified: 2019/04/30 22:55 by cpttz