diff --git a/m1/tools/README b/m1/tools/README
new file mode 100644
index 0000000..4e33a72
--- /dev/null
+++ b/m1/tools/README
@@ -0,0 +1,22 @@
+m1nor - Flash a file to M1 NOR partition selected by the file name
+==================================================================
+
+During software development, one often need to update only the
+content of a single partition. reflash_m1.sh is a bit unwieldy
+for this kind of task.
+
+I've written a small script called m1nor that selects the target 
+partition based on the file name. E.g., m1nor flickernoise.fbi
+would update the regular Flickernoise partition.
+
+The matching algorithm checks the beginning of the file name,
+so names like flickernoise-test.fbi would also work. Furthermore,
+it checks the file extension, so if you try to flash flickernoise
+(ELF, for debugging) or flickernoise.bin (an intermediate form
+unsuitable for booting from NOR), it will politely refuse to do
+so.
+
+You need to have fjmem.bit somwehere. It searches for it under
+$HOME/.qi/milkymist/, where reflash_m1.sh caches it. You can also
+specify the location directly by setting the environment variable
+FJMEM_BIT.