Add preliminary version of s51, a UI clone of the 8051 emulator.

sdcdb provides source-level debugging using the 8051 emulator, s51. By
emulating that emulator a the UI level, we should be able to get source
debugging right on our target platform.

This is just the preliminary structure for the program with most commands
not yet implemented.

1 files changed, 61 insertions, 0 deletions

diff --git a/s51/commands b/s51/commands
new file mode 100644
index 00000000..77a98493
--- /dev/null
+++ b/s51/commands
@@ -0,0 +1,61 @@
+Listens on port 9756 for a command stream.
+
+Dump commands:
+	di <start> <end> 	- dump imem
+	ds <start> <end>	- dump sprs
+	dx <start> <end>	- dump xaddr
+
+	Returns a string of hex pairs, each preceded by a space,
+	with 8 pairs per line
+
+Memory access commands:
+	set mem <prefix> <start> <end>
+	dump <prefix> <start> <end>
+
+	<prefix> is one of:
+
+		xram	- external ram or external stack
+		rom	- code space
+		iram	- internal ram or stack
+		sfr	- special function register
+
+
+	dump <addr>
+	set bit <addr>
+
+		bit addressable space
+
+Set PC:
+
+	pc <addr>
+
+	Sets PC to specified address
+
+	pc
+
+	Returns current PC
+
+Breakpoints
+
+	break <addr>
+	clear <addr>
+
+Load a file
+
+	file "<filename>"
+
+Execution control:
+
+	run <start>		- run starting at <start>
+	run <start> <stop>	- set temporary bp at <stop> 
+	run			- continue
+	next			- step over calls(?)
+	step			- step one instruction
+	
+	reset			- reset the simulator
+	res			- synonym?
+	
+Error messages:
+
+	start with "Error:"
+