From 40479d923280cdcd167990348850f8950d409d1f Mon Sep 17 00:00:00 2001
From: David Banks <dave@hoglet.com>
Date: Sun, 12 Aug 2018 22:38:12 +0100
Subject: [PATCH] Updated User Manual   Command Reference (markdown)

---
 User-Manual---Command-Reference.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/User-Manual---Command-Reference.md b/User-Manual---Command-Reference.md
index 079bf58..388c55f 100644
--- a/User-Manual---Command-Reference.md
+++ b/User-Manual---Command-Reference.md
@@ -15,6 +15,7 @@
 * [rdm (rd)](#rdm-rd)
 * [regs (r)](#regs-r)
 * [reset (res)](#reset-res)
+* [srec (sr)](#srec-sr)
 * [step (s)](#step-s)
 * [test (t)](#test-t)
 * [trace (tr)](#trace-tr)
@@ -345,6 +346,33 @@ Resetting CPU
 ```
 In this example, you can see the program counter is set to FF3F, which is the 6502 reset vector on the Acorn Atom.
 
+## srec (sr)
+
+Uploads srecords into memory
+
+_Usage: sr_
+
+There are no paramaters.
+
+You should see a message:
+Send file now..
+
+Only the S1 srecord is currently understood, e.g.:
+```
+<S1><Count><Addr><Data>...<Data><CRC>
+```
+Here's a specific example:
+```
+S123A0004C10A0A94E8D0802A9A08D09024C33A0A9468D0402A9A08D0502A90F8D04B8A9A9
+```
+The command completes if no records are received within a short time period.
+
+The linux utility srec_cat can be used to convert an arbitrary file into suitable srecords:
+```
+% srec_cat somefile -binary -offset 0x1900 -data_only > somefile.srec
+``` 
+This will turn a binary file (somefile) into srecord format (solefile.srec), with a loading address in memory of 0x1900.
+
 ## step (s)
 
 Single steps one or more instructions.