Makefile

##############################################################################
# Makefile - Layered Architecture Example Project
##############################################################################

# Project name
PROJECT = architecture-example

# Directories
SRC_DIR = src
BUILD_DIR = build
OBJ_DIR = $(BUILD_DIR)/obj

# Layers
APP_DIR = $(SRC_DIR)/app
CONTROL_DIR = $(SRC_DIR)/control
DRIVER_DIR = $(SRC_DIR)/driver
MCU_DIR = $(SRC_DIR)/mcu-peripherals

# Source files (now in src/ subdirectories)
APP_SRCS = $(wildcard $(APP_DIR)/src/*.c)
CONTROL_SRCS = $(wildcard $(CONTROL_DIR)/src/*.c)
DRIVER_SRCS = $(wildcard $(DRIVER_DIR)/src/*.c)
MCU_SRCS = $(wildcard $(MCU_DIR)/src/*.c)

ALL_SRCS = $(APP_SRCS) $(CONTROL_SRCS) $(DRIVER_SRCS) $(MCU_SRCS)

# Objects
APP_OBJS = $(patsubst $(APP_DIR)/src/%.c,$(OBJ_DIR)/app_%.o,$(APP_SRCS))
CONTROL_OBJS = $(patsubst $(CONTROL_DIR)/src/%.c,$(OBJ_DIR)/control_%.o,$(CONTROL_SRCS))
DRIVER_OBJS = $(patsubst $(DRIVER_DIR)/src/%.c,$(OBJ_DIR)/driver_%.o,$(DRIVER_SRCS))
MCU_OBJS = $(patsubst $(MCU_DIR)/src/%.c,$(OBJ_DIR)/mcu_%.o,$(MCU_SRCS))

ALL_OBJS = $(APP_OBJS) $(CONTROL_OBJS) $(DRIVER_OBJS) $(MCU_OBJS)

# Executable
TARGET = $(BUILD_DIR)/$(PROJECT).elf

# Compiler
CC = gcc

# Flags - Add include paths for all layer headers
CFLAGS = -Wall -Wextra -std=c99 \
         -I$(APP_DIR)/inc \
         -I$(CONTROL_DIR)/inc \
         -I$(DRIVER_DIR)/inc \
         -I$(MCU_DIR)/inc \
         -DSIMULATION  # Enable simulation mode with printf
LDFLAGS = 

##############################################################################
# Rules
##############################################################################

.PHONY: help all clean validate info format

# Default target: show help
help:
	@echo "╔════════════════════════════════════════════════════════════════════╗"
	@echo "║  4-Layer Architecture Example - Build System                       ║"
	@echo "╚════════════════════════════════════════════════════════════════════╝"
	@echo ""
	@echo "Available targets:"
	@echo ""
	@echo "  make build       - Compile entire project and generate executable"
	@echo "  make clean       - Remove all compiled files (build/ directory)"
	@echo "  make validate    - Validate architecture rules compliance"
	@echo "  make format      - Auto-format all source files (Barr C Coding Standard)"
	@echo "  make info        - Show project information and dependencies"
	@echo "  make help        - Show this help message"
	@echo ""
	@echo "Quick commands:"
	@echo ""
	@echo "  make clean build           - Clean build from scratch"
	@echo "  make build validate        - Build and validate architecture"
	@echo "  make clean build validate  - Full clean, build and validation"
	@echo ""
	@echo "Running the program:"
	@echo ""
	@echo "  ./build/$(PROJECT).elf           - Run in simulation mode"
	@echo "  timeout 3 ./build/$(PROJECT).elf - Run for 3 seconds"
	@echo ""
	@echo "Architecture layers:"
	@echo ""
	@echo "  APP             → calls → CONTROL only"
	@echo "  CONTROL         → calls → DRIVER, MCU-PERIPHERALS"
	@echo "  DRIVER          → calls → MCU-PERIPHERALS only"
	@echo "  MCU-PERIPHERALS → base layer (no dependencies)"
	@echo ""

build: $(TARGET)

# Link
$(TARGET): $(ALL_OBJS)
	@echo "Linking..."
	@mkdir -p $(BUILD_DIR)
	$(CC) $(ALL_OBJS) $(LDFLAGS) -o $@
	@echo "Build complete: $(TARGET)"

# Compilation - APP
$(OBJ_DIR)/app_%.o: $(APP_DIR)/src/%.c
	@echo "Compiling APP: $<"
	@mkdir -p $(OBJ_DIR)
	$(CC) $(CFLAGS) -c $< -o $@

# Compilation - CONTROL
$(OBJ_DIR)/control_%.o: $(CONTROL_DIR)/src/%.c
	@echo "Compiling CONTROL: $<"
	@mkdir -p $(OBJ_DIR)
	$(CC) $(CFLAGS) -c $< -o $@

# Compilation - DRIVER
$(OBJ_DIR)/driver_%.o: $(DRIVER_DIR)/src/%.c
	@echo "Compiling DRIVER: $<"
	@mkdir -p $(OBJ_DIR)
	$(CC) $(CFLAGS) -c $< -o $@

# Compilation - MCU-PERIPHERALS
$(OBJ_DIR)/mcu_%.o: $(MCU_DIR)/src/%.c
	@echo "Compiling MCU-PERIPHERALS: $<"
	@mkdir -p $(OBJ_DIR)
	$(CC) $(CFLAGS) -c $< -o $@

# Cleanup
clean:
	@echo "Cleaning..."
	@rm -rf $(BUILD_DIR)
	@echo "Clean complete!"

# Architecture validation
validate:
	@echo "Validating 4-layer architecture..."
	@echo ""
	@echo "1. Checking if APP includes DRIVER or MCU-PERIPHERALS..."
	@! grep -r '#include.*["/]driver' $(APP_DIR)/src/ | grep -v "driverlib" && echo "✅ APP OK (only includes CONTROL)" || echo "❌ APP violation: should only include CONTROL!"
	@echo ""
	@echo "2. Checking if CONTROL includes APP..."
	@! grep -r '#include.*["/]app' $(CONTROL_DIR)/src/ && echo "✅ CONTROL OK (doesn't include APP)" || echo "❌ CONTROL violation found!"
	@echo ""
	@echo "3. Checking if DRIVER includes CONTROL or APP..."
	@! grep -r '#include.*["/]\(control\|app\)' $(DRIVER_DIR)/src/ && echo "✅ DRIVER OK (only includes MCU-PERIPHERALS)" || echo "❌ DRIVER violation found!"
	@echo ""
	@echo "4. Checking if MCU-PERIPHERALS includes anything..."
	@! grep -r '#include.*["/]\(app\|control\|driver\)' $(MCU_DIR)/src/ | grep -v "driverlib" && echo "✅ MCU-PERIPHERALS OK (base layer)" || echo "❌ MCU-PERIPHERALS violation found!"
	@echo ""
	@echo "Architecture validation complete!"

# Info
info:
	@echo "Project Info:"
	@echo "  APP sources:        $(APP_SRCS)"
	@echo "  CONTROL sources:    $(CONTROL_SRCS)"
	@echo "  DRIVER sources:     $(DRIVER_SRCS)"
	@echo "  MCU-PERIPH sources: $(MCU_SRCS)"
	@echo ""
	@echo "Dependencies:"
	@echo "  APP             → can call → CONTROL only"
	@echo "  CONTROL         → can call → DRIVER, MCU-PERIPHERALS"
	@echo "  DRIVER          → can call → MCU-PERIPHERALS only"
	@echo "  MCU-PERIPHERALS → base layer (no dependencies)"

# Auto-format all source files
format:
	@echo "Formatting source files with clang-format (Barr C Coding Standard)..."
	@if command -v clang-format >/dev/null 2>&1; then \
		for file in $(ALL_SRCS) $(wildcard $(APP_DIR)/inc/*.h) $(wildcard $(CONTROL_DIR)/inc/*.h) $(wildcard $(DRIVER_DIR)/inc/*.h) $(wildcard $(MCU_DIR)/inc/*.h); do \
			echo "  Formatting $$file"; \
			clang-format -i -style=file $$file; \
		done; \
		echo "✅ Formatting complete!"; \
	else \
		echo "❌ clang-format not found. Install it with:"; \
		echo "   Ubuntu/Debian: sudo apt install clang-format"; \
		echo "   Fedora:        sudo dnf install clang-tools-extra"; \
		echo "   macOS:         brew install clang-format"; \
		exit 1; \
	fi