Maintain project structure and add assembly

Author: XuhuaHuang

Assembly/Makefile

@@ -0,0 +1,44 @@
+# =====================================================
+# ARM Assembly Starter Project for WSL
+# =====================================================
+
+TARGET  := hello
+SRC_DIR := src
+OBJ_DIR := build
+BIN_DIR := bin
+
+AS       := arm-linux-gnueabi-as
+LD       := arm-linux-gnueabi-ld
+QEMU     := qemu-arm
+RM       := rm -rf
+
+SRC      := $(SRC_DIR)/hello.s
+OBJ      := $(OBJ_DIR)/hello.o
+BIN      := $(BIN_DIR)/$(TARGET)
+
+# Default build rule
+all: $(BIN)
+	@echo "Build complete: $(BIN)"
+
+# Create directories automatically
+$(OBJ_DIR) $(BIN_DIR):
+	@mkdir -p $@
+
+# Assemble and link
+$(OBJ): $(SRC) | $(OBJ_DIR)
+	$(AS) -o $@ $<
+
+$(BIN): $(OBJ) | $(BIN_DIR)
+	$(LD) -o $@ $<
+
+# Run with QEMU
+run: $(BIN)
+	@echo "Running under QEMU..."
+	@$(QEMU) $(BIN)
+
+# Clean
+clean:
+	@$(RM) $(OBJ_DIR) $(BIN_DIR)
+	@echo "Cleaned build artifacts."
+
+.PHONY: all run clean

Assembly/README.md

@@ -0,0 +1,27 @@
+# ARM Assembly on WSL — Starter Project
+
+This project demonstrates how to write, assemble, and run a simple ARM Assembly program using **WSL (Windows Subsystem for Linux)**.
+
+## Requirements
+
+Install the required toolchain and emulator in WSL:
+
+```bash
+sudo apt update
+sudo apt install gcc-arm-linux-gnueabi binutils-arm-linux-gnueabi qemu-user -y
+```
+
+## Build and run
+
+From the project root:
+
+```bash
+make
+make run
+```
+
+Expected output:
+
+```vbnet
+Hello from ARM Assembly on WSL!
+```

Assembly/src/hello.s

@@ -0,0 +1,36 @@
+    .section .data
+msg:
+    .asciz "Hello from ARM Assembly on WSL!\n"
+
+    .section .text
+    .global _start
+
+_start:
+    ldr r0, =msg        @ Load address of string into r0
+    bl print_string     @ Call function to print message
+
+    mov r7, #1          @ syscall: sys_exit
+    mov r0, #0          @ exit code 0
+    svc 0               @ make system call
+
+@ -----------------------------------------------------
+@ print_string: writes string to stdout (fd = 1)
+@ Arguments:
+@   r0 = pointer to string
+@ -----------------------------------------------------
+print_string:
+    mov r1, r0          @ r1 = string pointer
+
+@ Compute string length dynamically
+get_len:
+    ldrb r3, [r1], #1   @ Load next byte and increment pointer
+    cmp r3, #0          @ Check for null terminator
+    bne get_len
+    sub r2, r1, r0      @ r2 = length including null terminator
+    sub r2, r2, #1      @ subtract 1 to exclude '\0'
+
+    mov r1, r0          @ reset r1 = string pointer
+    mov r0, #1          @ stdout (fd = 1)
+    mov r7, #4          @ syscall: sys_write
+    svc 0
+    bx lr               @ return

CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.20)
 
-project("embedded_prog" LANGUAGES C CXX)
+project("embedded-prog" LANGUAGES C CXX)
 
 set(CMAKE_CXX_STANDARD 23)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)

Util/println.hpp

@@ -0,0 +1,37 @@
+/**
+ * @file println.inl
+ * @author Xuhua Huang
+ * @brief
+ * @version 0.1
+ * @date 2025-09-24
+ *
+ * @copyright Copyright (c) 2025
+ *
+ */
+
+#ifndef PRINTLN_HPP
+#define PRINTLN_HPP
+
+#include <iostream>
+#include <vector>
+
+namespace util {
+
+template <typename T>
+concept printable = requires(std::ostream &os, T v) { v.print(os); };
+
+template <typename T> std::ostream &print_ln(std::ostream &os, const T &v) {
+  if constexpr (printable<T>) {
+    v.print(os);
+  } else {
+    os << v;
+  }
+  os << "\n";
+  return os;
+}
+
+template <printable T> using vector_of_printable = std::vector<T>;
+
+} // namespace util
+
+#endif //! PRINTLN_HPP

Util/println.inl

@@ -1,32 +1,49 @@
+/**
+ * @file type_name.hpp
+ * @author Xuhua Huang
+ * @brief
+ * @version 0.1
+ * @date 2025-09-23
+ *
+ * @copyright Copyright (c) 2025
+ *
+ */
+
 #pragma once
+#ifndef TYPE_NAME_HPP
+#define TYPE_NAME_HPP
 
-#ifndef _STRING_VIEW_
-#include <string_view>
+#if __cplusplus < 201703L
+#error "type_name.hpp requires C++17 or later (for std::string_view)"
 #endif
 
+#include <string>
+#include <string_view>
+
 namespace util {
 namespace type {
 
-template <typename T>
-constexpr auto type_name() {
-    std::string_view name, prefix, suffix;
+template <typename T> constexpr auto type_name() {
+  std::string_view name, prefix, suffix;
 #ifdef __clang__
-    name   = __PRETTY_FUNCTION__;
-    prefix = "auto util::type::type_name() [T = ";
-    suffix = "]";
+  name = __PRETTY_FUNCTION__;
+  prefix = "auto util::type::type_name() [T = ";
+  suffix = "]";
 #elif defined(__GNUC__)
-    name   = __PRETTY_FUNCTION__;
-    prefix = "constexpr auto util::type::type_name() [with T = ";
-    suffix = "]";
+  name = __PRETTY_FUNCTION__;
+  prefix = "constexpr auto util::type::type_name() [with T = ";
+  suffix = "]";
 #elif defined(_MSC_VER)
-    name   = __FUNCSIG__;
-    prefix = "auto __cdecl util::type::type_name<";
-    suffix = ">(void)";
+  name = __FUNCSIG__;
+  prefix = "auto __cdecl util::type::type_name<";
+  suffix = ">(void)";
 #endif
-    name.remove_prefix(prefix.size());
-    name.remove_suffix(suffix.size());
-    return name;
+  name.remove_prefix(prefix.size());
+  name.remove_suffix(suffix.size());
+  return name;
 }
 
 } // namespace type
 } // namespace util
+
+#endif //! TYPE_NAME_HH

Util/type_name.hpp

@@ -28,7 +28,9 @@
 #if defined(__GNUC__)
 #include <cxxabi.h>
 
-template <typename T> [[nodiscard]] std::string type_name() {
+template <typename T>
+[[nodiscard]]
+std::string type_name() {
   int status = 0;
   std::unique_ptr<char, void (*)(void *)> res{
       abi::__cxa_demangle(typeid(T).name(), nullptr, nullptr, &status),