Added x16 implementation of the library except for run, time and printnum macros and minor changes in README.md, Makefile, MACRO_USAGE.md and STRUCTURE.md

Author: lina-torovoltas

MACRO_USAGE.md

@@ -3,12 +3,14 @@
 Some macros return data in a register.</br>
 The specific register used depends on the target architecture:
 
-- x86: `eax`  
+- x16:    `ax`
+- x86:    `eax`  
 - x86_64: `rax`  
-- ARM32: `r0`  
-- ARM64: `x0`
+- ARM32:  `r0`  
+- ARM64:  `x0`
 
 Also:  
+- For 16-bit targets, only 16-bit unsigned numbers are supported.
 - For 32-bit targets, only 32-bit unsigned numbers are supported.
 - For 64-bit targets, 64-bit unsigned numbers are supported.
 
@@ -122,7 +124,7 @@ mkdir dir_name, permissions
 
 **Arguments:**</br>
 `dir_name` — name of the directory to create, given as a string literal or a pointer to a string.</br>
-`permissions` — access mode in octal format, given as a number or a pointer to a variable containing the value.
+`permissions` — access mode in octal format, given as a number or a pointer to a variable containing the value. (not required for x16)
 
 
 **Usage example:**
@@ -169,7 +171,7 @@ print str, str_len
 
 **Arguments:**  
 `str` — pointer to the string or string literal to print.</br>
-`str_len` — length of the string in bytes, given as a number or pointer.
+`str_len` — length of the string in bytes, given as a number or pointer. (not required for x16)
 
 
 **Usage example:**
@@ -193,7 +195,7 @@ printtim times, str, str_len
 **Arguments:**</br>
 `times` — number of times to print the string, given as a number or pointer.</br>
 `str` — pointer to the string or string literal to print.</br>
-`str_len` — length of the string in bytes, given as a number or pointer.
+`str_len` — length of the string in bytes, given as a number or pointer. (not required for x16)
 
 
 **Usage example:**
@@ -216,7 +218,7 @@ printnum number
 
 **Note:**
 
-Not available in the library for ARM32 and ARM64.
+Not available in the library for x16, ARM32 and ARM64.
 
 
 **Arguments:**</br>
@@ -243,7 +245,7 @@ time
 
 **Note:**
 
-Not available in the library for ARM32 and ARM64.
+Not available in the library for x16, ARM32 and ARM64.
 
 
 
@@ -258,7 +260,7 @@ run command
 
 **Note:**
 
-Not available in the library for ARM32 and ARM64.
+Not available in the library for x16, ARM32 and ARM64.
 
 
 **Arguments:**</br>

Makefile

@@ -1,9 +1,11 @@
+SRC_x16 = examples/examples_x16
 SRC_x86 = examples/examples_x86
 SRC_x64 = examples/examples_x64
 SRC_arm32 = examples/examples_arm32
 SRC_arm64 = examples/examples_arm64
 
 BUILD_DIR = build
+BUILD_x16 = $(BUILD_DIR)/examples_x16
 BUILD_x86 = $(BUILD_DIR)/examples_x86
 BUILD_x64 = $(BUILD_DIR)/examples_x64
 BUILD_arm32 = $(BUILD_DIR)/examples_arm32
@@ -12,19 +14,27 @@ BUILD_arm64 = $(BUILD_DIR)/examples_arm64
 FASM = fasm
 FASMA = fasmarm
 
-.PHONY: x86 x64 arm32 arm64 all clean check_tools check_dirs
+.PHONY: x16 x86 x64 arm32 arm64 all clean check_tools check_dirs
 
 check_tools:
 	@command -v $(FASM) >/dev/null 2>&1 || { echo "Error: $(FASM) is not installed or not in PATH"; exit 1; }
 	@command -v $(FASMA) >/dev/null 2>&1 || { echo "Error: $(FASMA) is not installed or not in PATH"; exit 1; }
 
 check_dirs:
-	@for dir in $(SRC_x86) $(SRC_x64) $(SRC_arm32) $(SRC_arm64); do \
+	@for dir in $(SRC_x16) $(SRC_x86) $(SRC_x64) $(SRC_arm32) $(SRC_arm64); do \
 		if [ ! -d $$dir ]; then \
 			echo "Error: Source directory '$$dir' does not exist"; exit 1; \
 		fi \
 	done
 
+x16: check_tools check_dirs
+	@mkdir -p $(BUILD_x16)
+	@for file in $(SRC_x16)/*.asm; do \
+		output=$(BUILD_x16)/$$(basename $$file .asm); \
+		echo "Building $$file -> $$output"; \
+		$(FASM) $$file $$output || exit 1; \
+	done
+
 x86: check_tools check_dirs
 	@mkdir -p $(BUILD_x86)
 	@for file in $(SRC_x86)/*.asm; do \
@@ -57,7 +67,7 @@ arm64: check_tools check_dirs
 		$(FASMA) $$file $$output || exit 1; \
 	done
 
-all: x86 x64 arm32 arm64
+all: x16 x86 x64 arm32 arm64
 
 clean:
 	@rm -rf $(BUILD_DIR)

README.md

@@ -1,30 +1,31 @@
 ## FasmMacroLib
 
 ![Language](https://img.shields.io/badge/language%20-%20Assembler-red)
-![CPU](https://img.shields.io/badge/CPU-x86%2C%20x64%2C%20ARM32%2C%20ARM64-orange)
-![OS](https://img.shields.io/badge/OS-linux-blue)
+![CPU](https://img.shields.io/badge/CPU-x16%2C%20x86%2C%20x64%2C%20ARM32%2C%20ARM64-orange)
+![OS](https://img.shields.io/badge/OS-Linux%2C%20DOS-0078D4)
 ![License](https://img.shields.io/github/license/lina-torovoltas/FasmMacrosLib)
 ![GitHub release](https://img.shields.io/github/v/release/lina-torovoltas/FasmMacrosLib)
 ![Downloads](https://img.shields.io/github/downloads/lina-torovoltas/FasmMacrosLib/total)</br>
-FasmMacroLib is a macro library designed to simplify FASM programming upon Linux.</br>
-It supports x86, x86_64, ARM, and ARM64 architectures.
+FasmMacroLib is a macro library designed to simplify FASM programming upon Linux and DOS.</br>
+It supports x16 for DOS, and x86, x64, ARM and ARM64 for Linux.
 
 ## Installation
 
 Just include the `macrolib` file at the top of thy `.asm` file, depending upon thine architecture:
 
 ```asm
+include 'macrolib/macrolib_x16.inc'       ; for x16
 include 'macrolib/macrolib_x86.inc'       ; for x86
-include 'macrolib/macrolib_x64.inc'       ; for x86_64
+include 'macrolib/macrolib_x64.inc'       ; for x64
 include 'macrolib/macrolib_arm32.inc'     ; for arm32
 include 'macrolib/macrolib_arm64.inc'     ; for arm64
 ```
 
 ## Dependencies
 
 - Linux x86, x86_64, ARM32 or ARM64 operating system  
-- `make` utility for building  
-- `fasm` assembler for x86 and x86_64 targets
+- `make` utility for building
+- `fasm` assembler for x16, x86 and x64 targets
 - `fasmarm` assembler for ARM32 and ARM64 targets
 
 Make sure both `make`, `fasm` and `fasmarm` are installed and available in thy system PATH before building.

STRUCTURE.md

@@ -9,11 +9,20 @@
 ├── README.md
 ├── STRUCTURE.md
 ├── macrolib/
+    ├── macrolib_x16.inc
 │   ├── macrolib_x86.inc
 │   ├── macrolib_x64.inc
 │   ├── macrolib_arm.inc
 │   └── macrolib_arm64.inc
 └── examples/
+    ├── examples_x16/
+    │   ├── clear.asm
+    │   ├── exit.asm
+    │   ├── make_dir.asm
+    │   ├── print_times.asm
+    │   ├── print.asm
+    │   ├── remove_dir.asm
+    │   └── stackops.asm
     ├── examples_x86/
     │   ├── clear.asm
     │   ├── exit.asm
@@ -39,23 +48,17 @@
     ├── examples_arm/
     │   ├── clear.asm
     │   ├── exit.asm
-    │   ├── get_time.asm
     │   ├── make_dir.asm
-    │   ├── print_number.asm
     │   ├── print_times.asm
     │   ├── print.asm
     │   ├── remove_dir.asm
-    │   ├── run_command.asm
     │   └── stackops.asm
     └── examples_arm64/
         ├── clear.asm
         ├── exit.asm
-        ├── get_time.asm
         ├── make_dir.asm
-        ├── print_number.asm
         ├── print_times.asm
         ├── print.asm
         ├── remove_dir.asm
-        ├── run_command.asm
         └── stackops.asm
 ```

examples/examples_x16/clear.asm

@@ -0,0 +1,11 @@
+; This code works only on 16-bit DOS!!!
+
+include '../../macrolib/macrolib_x16.inc'
+org 100h
+use16
+
+
+
+clr ah
+mov ah, 4Ch
+int 21h

examples/examples_x16/exit.asm

@@ -0,0 +1,9 @@
+; This code works only on 16-bit DOS!!!
+
+include '../../macrolib/macrolib_x16.inc'
+org 100h
+use16
+
+
+
+exit 0

examples/examples_x16/make_dir.asm

@@ -0,0 +1,14 @@
+; This code works only on 16-bit DOS!!!
+
+include '../../macrolib/macrolib_x16.inc'
+org 100h
+use16
+
+mkdir name
+
+mov ah, 4Ch
+int 21h
+
+
+
+name db 'test',0 

examples/examples_x16/print.asm

@@ -0,0 +1,16 @@
+; This code works only on 16-bit DOS!!!
+
+include '../../macrolib/macrolib_x16.inc'
+org 100h
+use16
+
+
+
+print msg
+
+mov ah, 4Ch
+int 21h
+
+
+
+msg db 'Test output string', 0Ah, '$'

examples/examples_x16/print_times.asm

@@ -0,0 +1,18 @@
+; This code works only on 16-bit DOS!!!
+
+include '../../macrolib/macrolib_x16.inc'
+org 100h
+use16
+
+
+
+printtim 2, msg1
+printtim 3, msg2
+
+mov ah, 4Ch
+int 21h
+
+
+
+msg1 db 'This message will be repeated two times', 0Ah, '$'
+msg2 db 'This message will be repeated three times', 0Ah, '$'

examples/examples_x16/remove_dir.asm

@@ -0,0 +1,14 @@
+; This code works only on 16-bit DOS!!!
+
+include '../../macrolib/macrolib_x16.inc'
+org 100h
+use16
+
+rmdir name
+
+mov ah, 4Ch
+int 21h
+
+
+
+name db 'test',0