Rename OUT_ascii instruction to OUTC and update related methods and documentation

Author: dominikoetiker

CentralProcessingUnit.py

@@ -81,7 +81,7 @@ def __init__(
             # I/O operations
             0x16: ("INP", self.__io_controller.asm_INP, 1),
             0x17: ("OUT", self.__io_controller.asm_OUT, 1),
-            0x18: ("OUT_ascii", self.__io_controller.asm_OUT_ascii, 1),
+            0x18: ("OUTC", self.__io_controller.asm_OUTC, 1),
         }
         # Format {code: (type, operand_size_byte)}
         self.__operand_type_set: Dict[int, Tuple[str, int]] = {

IO_controller/IoController.py

@@ -18,6 +18,6 @@ def asm_OUT(self, register: Register):
         self.R2.set(register.get())
         print(f"OUT: {register.get()}")
 
-    def asm_OUT_ascii(self, register: Register):
+    def asm_OUTC(self, register: Register):
         self.R2.set(register.get())
         print(f"OUT: {chr(register.get())}")

README.md

@@ -38,7 +38,6 @@ The virtual CPU implements a simplified architecture with the following componen
 
 - RAM with configurable size (default: 1024 bytes)
 - Support for address-based memory access
-- Memory tracking to manage used/free space (for now, it only marks memory as used and checks if it is used, but does not free it)
 
 ## Bytecode Format
 
@@ -79,6 +78,7 @@ The virtual CPU implements a simplified architecture with the following componen
 | **I/O Operations**        |
 | 0x16                      | INP      | `INP Rd`                    | Read input from user and store in Rd                     | None           |
 | 0x17                      | OUT      | `OUT Rd`                    | Output value from Rd to console                          | None           |
+| 0x18                      | OUTC     | `OUTC Rd`                   | Output character from Rd to console                      | None           |
 
 Where:
 
@@ -154,7 +154,7 @@ my_cpu.run()
 
 1. **Assembler**: Create a tool to translate assembly language into bytecode
 2. **Loader**: Implement a loader to load programs from files
-3. **Memory Management**: Improve the memory allocation and management system (e.g., free memory)
+3. **Memory Management**: Improve the memory allocation and management system (e.g., malloc, free memory)
 
 ## Contributing
 

main.py

@@ -273,27 +273,27 @@ def main():
         [
             # Hello World program
             0x02, 0x01, 0x00, 0x48, 0x00, # MOV R0, 72 (H) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x65, 0x00, # MOV R0, 101 (e) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x6c, 0x00, # MOV R0, 108 (l) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x6c, 0x00, # MOV R0, 108 (l) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x6f, 0x00, # MOV R0, 111 (o) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x20, 0x00, # MOV R0, 32 (space) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x57, 0x00, # MOV R0, 87 (W) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x6f, 0x00, # MOV R0, 111 (o) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x72, 0x00, # MOV R0, 114 (r) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x6c, 0x00, # MOV R0, 108 (l) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x02, 0x01, 0x00, 0x64, 0x00, # MOV R0, 100 (d) # fmt: skip
-            0x18, 0x00, 0x00, # OUT_ascii R0 # fmt: skip
+            0x18, 0x00, 0x00, # OUTC R0 # fmt: skip
             0x01, # HLT # fmt: skip
         ]
     )