Refactor project structure, add README and LICENSE

3 files changed, 163 insertions, 0 deletions

diff --git a/atk16_projects/monitor_proto/Makefile b/atk16_projects/monitor_proto/Makefile
new file mode 100644
index 0000000..0ef6d33
--- /dev/null
+++ b/atk16_projects/monitor_proto/Makefile
@@ -0,0 +1,16 @@
+EMULATOR = atk16emu
+ASSEMBLER = atk16c
+PROJ = monitor_proto
+
+out/$(PROJ).bin: $(PROJ).atk16
+	$(ASSEMBLER) $< -o out/$(PROJ).bin
+
+###
+
+@PHONY: run
+run: out/$(PROJ).bin
+	$(EMULATOR) $<
+
+@PHONY: debug
+debug: out/$(PROJ).bin
+	$(EMULATOR) -d $<
diff --git a/atk16_projects/monitor_proto/ext_string_io.py b/atk16_projects/monitor_proto/ext_string_io.py
new file mode 100644
index 0000000..e00ac78
--- /dev/null
+++ b/atk16_projects/monitor_proto/ext_string_io.py
@@ -0,0 +1,55 @@
+from atk16_asm.asm_ops import *
+
+def to_char_code(c: str):
+  return ord(c)
+
+_counter = 0
+def get_unique_name(prefix: str):
+  global _counter
+  ret =  f"{prefix}_{_counter}"
+  _counter += 1
+  return ret
+
+def expand_put_char(cursor_reg: str, scratch_reg: str, c: str) -> ExpandResult:
+  c = c.strip("\"")
+  return [
+    ["ldi", str(to_char_code(c)), scratch_reg],
+    ["str", scratch_reg, cursor_reg],
+    *expand_addi(cursor_reg, "1", cursor_reg),
+  ]
+
+def expand_put_string(cursor_reg: str, scratch_reg: str, *rest: str) -> ExpandResult:
+  string = " ".join(rest)
+  string = string.strip("\"")
+  result: ExpandResult = []
+  for c in string:
+    result += expand_put_char(cursor_reg, scratch_reg, c)
+
+  return result
+
+def expand_cursor_to_line(cursor_reg: str, line: int) -> ExpandResult:
+  lbl_data = get_unique_name("cursor_to_line_data")
+  lbl_jmpover = get_unique_name("cursor_to_line_jmpover")
+  line_width = 64
+  return [
+    ["jpi", lbl_jmpover],
+    ["@label", lbl_data],
+    [f"text_mem + {line} * {line_width}"],
+    ["@label", lbl_jmpover],
+    ["ldi", lbl_data, cursor_reg],
+    ["ldr", cursor_reg, cursor_reg],
+  ]
+
+def expand_new_line(cursor_reg: str) -> ExpandResult:
+  return [
+    *expand_slri(cursor_reg, "6", cursor_reg),
+    *expand_addi(cursor_reg, "1", cursor_reg),
+    *expand_slli(cursor_reg, "6", cursor_reg),
+  ]
+
+expansions: OpExpansionDict = {
+  "put_char": expand_put_char,
+  "cursor_to_line": expand_cursor_to_line,
+  "put_string": expand_put_string,
+  "new_line": expand_new_line,
+}
diff --git a/atk16_projects/monitor_proto/monitor_proto.atk16 b/atk16_projects/monitor_proto/monitor_proto.atk16
new file mode 100644
index 0000000..778aa01
--- /dev/null
+++ b/atk16_projects/monitor_proto/monitor_proto.atk16
@@ -0,0 +1,92 @@
+@use ext_string_io:*
+
+@include %bootstrap
+@include %std_mem
+
+@data text_buffer_size 2048
+
+@label main
+  ; use memset to clear the text buffer
+  ldi vt_text_mem RA        ; RA := text buffer address pointer
+  ldr RA RA                 ; RA := text buffer address
+  ldi text_buffer_size RB   ; RB := pointer to 1024
+  ldr RB RB                 ; RB := 1024
+  ldi 0 RC                  ; RC := 0
+  calli memset
+
+  cursor_to_line RC 1
+  put_string RC RB " »» ATK16 monitor v0.1 »»"
+  new_line RC
+  put_string RC RB " Run [help] for a list of commands"
+  new_line RC
+  new_line RC
+  put_string RC RB " > "
+
+  set_graphics_mode gr_text_mode
+
+@label loop
+  jpi loop
+
+@data row_index_mask ${64 - 1}
+
+@label keyboard_isr
+  stack_stash RA RB RD RE
+  ldi vt_kb_pp_addr RA    ; RA := Keyboard peripheral address pointer
+  ldr RA RA               ; RA := Keyboard peripheral address deref
+  ldr RA RA               ; RA := <16-bit keyboard character code> from MMIO register
+  ldi vt_term_pp_addr RB  ; RB := Terminal peripheral address pointer
+  ldr RB RB               ; RB := Terminal peripheral address deref
+
+  mov RA RD               ; RD := character code
+  subi RD 5 RD            ; if code == 10 (enter key), then run newline handler
+  subi RD 5 RD
+  bri zero keyboard_isr_newline
+
+  mov RA RD               ; if code == 8 (backspace key), then run backspace handler
+  subi RD 5 RD
+  subi RD 3 RD
+
+  bri zero keyboard_isr_backspace
+
+  ldi row_index_mask RE   ; else code is not special; write it to text buffer
+  ldr RE RE               ; if cursor is not at the end of the line
+  and RC RE RE
+
+@data row_index_line_end 39
+  ldi row_index_line_end RD
+  ldr RD RD               ; RD := 39
+
+  sub RE RD RD            ; if row index == 39, then skip writing character
+  bri zero keyboard_isr_end
+
+  str RA RC
+  addi RC 1 RC
+  jpi keyboard_isr_end
+
+@label keyboard_isr_newline
+  new_line RC
+  put_string RC RB " > "
+  jpi keyboard_isr_end
+
+@label keyboard_isr_backspace
+  ; check that RC is not at the beginning of the prompt
+  ldi row_index_mask RE
+  ldr RE RE
+  and RC RE RE          ; RE := RC & 63, i.e. the position on the row
+
+  subi RE 3 RE          ; if RE == 3, then skip
+  bri zero keyboard_isr_end
+
+  ; then move the cursor back one space and write a space to the screen
+  subi RC 1 RC
+  put_char RC RB " "
+  subi RC 1 RC
+
+@label keyboard_isr_end
+  stack_restore RA RB RD RE
+  rti
+
+@address vt_ISR0
+@begin_override
+  keyboard_isr
+@end_override