User Tools

Site Tools

This wiki is read only and for archival purposes only. >>>>>>>>>> Please use the new OpenWrt wiki at <<<<<<<<<<
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. cd /tmp wget mtd -r write /tmp/original_firmware.bin firmware


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)


To write linux.trx to mtd4 labeled as linux and reboot afterwards:

mtd -r write linux.trx 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.
doc/techref/mtd.txt · Last modified: 2015/03/17 08:34 by Genrix