1 files changed, 24 insertions, 0 deletions

diff --git a/utils/ipod/bin2note/README b/utils/ipod/bin2note/README
index 0dbc9e465d..61e03b9981 100644
--- a/utils/ipod/bin2note/README
+++ b/utils/ipod/bin2note/README
@@ -15,3 +15,27 @@ It is known to work on the 2nd generation Nano.
 The Makefile contains rules for compiling an ARM assembler file
 "test.S" into a notes file "test.htm".  Just put test.S in this
 directory and type "make test.htm".
+
+
+How it works
+------------
+
+When the Apple firmware boots, it scans the Notes folder and loads
+each note in turn in order to check its content.
+
+When it reaches our specially crafted note, a buffer overflows onto
+the stack, writing the entry point of our code over the top of an
+existing return address.
+
+This entry point was determined by "stooo1" as part of the
+"linux4nano" investigations into the Nano 2G.  He managed to attach a
+JTAG debugger to his Nano 2G and dump the RAM after a notes file was
+loaded.
+
+Only certain return addresses can be used, as it is converted
+internally to utf-8.  Hence we are currently using the address of the
+last instruction in the buffer, which is a branch back to our real
+entry point.
+
+You also need to ensure that there are no more than 64KB of notes in
+your Notes folder.