[U-Boot] [PATCH v2] README: Add handy kermit primer

[Karl O. Pinc]

Add doc/README.kermit.

Mention in README.

Signed-off-by: Karl O. Pinc <kop at meme.com>
---
Thanks for the guidance.

Turns out the wiki has an even better guide.
(It does not mention entering commands interactively.
Oh well.)

P.S.  I'm not sure I'm threading this right.  I'm
threading to the original patch submission, not your
reply.  Is that right?

Changes to v2:
  - Get rid of primer in README.
  - Add doc/README.kermit, as copy of wiki kermit setup docs
  - Reference doc/README.kermit in README.

 README            |    2 +-
 doc/README.kermit |   52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 1 deletions(-)
 create mode 100644 doc/README.kermit

diff --git a/README b/README
index 6bb5992..f9535de 100644
--- a/README
+++ b/README
@@ -4631,7 +4631,7 @@ Over time, many people have reported problems when trying to use the
 consider minicom to be broken, and recommend not to use it. Under
 Unix, I recommend to use C-Kermit for general purpose use (and
 especially for kermit binary protocol download ("loadb" command), and
-use "cu" for S-Record download ("loads" command).
+use "cu" for S-Record download ("loads" command).  See doc/README.kermit.
 
 Nevertheless, if you absolutely want to use it try adding this
 configuration to your "File transfer protocols" section:
diff --git a/doc/README.kermit b/doc/README.kermit
new file mode 100644
index 0000000..f103d6a
--- /dev/null
+++ b/doc/README.kermit
@@ -0,0 +1,52 @@
+Copied from the U-Boot wiki,
+http://www.denx.de/wiki/view/DULG/SystemSetup#Section_4.3.
+on 2012-08-03.
+
+4.3. Configuring the "kermit" command
+
+The name kermit stands for a whole family of communications software
+for serial and network connections. The fact that it is available for
+most computers and operating systems makes it especially well suited
+for our purposes.
+
+kermit executes the commands in its initialization file, .kermrc, in
+your home directory before it executes any other commands, so this can
+be easily used to customize its behaviour using appropriate
+initialization commands. The following settings are recommended for
+use with U-Boot and Linux:
+
+    * ~/.kermrc:
+
+set line /dev/ttyS0
+set speed 115200
+set carrier-watch off
+set handshake none
+set flow-control none
+robust
+set file type bin
+set file name lit
+set rec pack 1000
+set send pack 1000
+set window 5
+
+This example assumes that you use the first serial port of your host
+system (/dev/ttyS0) at a baudrate of 115200 to connect to the target's
+serial console port.
+
+You can then connect to the serial line:
+
+$ kermit -c
+Connecting to /dev/ttyS0, speed 115200.
+The escape character is Ctrl-\ (ASCII 28, FS)
+Type the escape character followed by C to get back,
+or followed by ? to see other options.
+----------------------------------------------------
+
+TIP Due to licensing conditions you will often find two kermit
+packages in your GNU/Linux distribution. In this case you will want to
+install the ckermit package. The gkermit package is only a command
+line tool implementing the kermit transfer protocol.
+
+TIP If you cannot find kermit on the distribution media for your Linux
+host system, you can download it from the kermit project home page:
+http://www.columbia.edu/kermit/
-- 
1.7.2.5