Add color and verbosity to Makefile

01_wait_forever/Cargo.toml

@@ -4,7 +4,6 @@ version = "0.1.0"
 authors = ["Andre Richter <andre.o.richter@gmail.com>"]
 edition = "2018"
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = []

01_wait_forever/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -14,6 +16,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -d in_asm -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -24,6 +27,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -d in_asm -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -31,12 +35,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -53,8 +59,8 @@ DOCKER_IMAGE         = rustembedded/osdev-utils
 DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
 DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 
@@ -63,36 +69,45 @@ EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

01_wait_forever/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

02_runtime_init/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = []

02_runtime_init/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -14,6 +16,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -d in_asm -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -24,6 +27,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -d in_asm -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -31,12 +35,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -53,8 +59,8 @@ DOCKER_IMAGE         = rustembedded/osdev-utils
 DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
 DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 
@@ -63,36 +69,45 @@ EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

02_runtime_init/README.md

@@ -33,9 +33,9 @@ diff -uNr 01_wait_forever/Cargo.toml 02_runtime_init/Cargo.toml
 +[profile.release]
 +lto = true
 +
- # The features section is used to select the target board.
  [features]
  default = []
+ bsp_rpi3 = []
 
 diff -uNr 01_wait_forever/src/_arch/aarch64/cpu/boot.S 02_runtime_init/src/_arch/aarch64/cpu/boot.S
 --- 01_wait_forever/src/_arch/aarch64/cpu/boot.S

02_runtime_init/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

03_hacky_hello_world/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = []

03_hacky_hello_world/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -14,6 +16,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -24,6 +27,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -31,12 +35,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -53,8 +59,8 @@ DOCKER_IMAGE         = rustembedded/osdev-utils
 DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
 DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 
@@ -63,36 +69,45 @@ EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

03_hacky_hello_world/README.md

@@ -31,7 +31,7 @@ Kernel panic: Stopping here.
 diff -uNr 02_runtime_init/Makefile 03_hacky_hello_world/Makefile
 --- 02_runtime_init/Makefile
 +++ 03_hacky_hello_world/Makefile
-@@ -11,7 +11,7 @@
+@@ -13,7 +13,7 @@
      KERNEL_BIN        = kernel8.img
      QEMU_BINARY       = qemu-system-aarch64
      QEMU_MACHINE_TYPE = raspi3
@@ -39,8 +39,8 @@ diff -uNr 02_runtime_init/Makefile 03_hacky_hello_world/Makefile
 +    QEMU_RELEASE_ARGS = -serial stdio -display none
      OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
-     LINKER_FILE       = src/bsp/raspberrypi/link.ld
+     READELF_BINARY    = aarch64-none-elf-readelf
-@@ -21,7 +21,7 @@
+@@ -24,7 +24,7 @@
      KERNEL_BIN        = kernel8.img
      QEMU_BINARY       = qemu-system-aarch64
      QEMU_MACHINE_TYPE =
@@ -48,7 +48,7 @@ diff -uNr 02_runtime_init/Makefile 03_hacky_hello_world/Makefile
 +    QEMU_RELEASE_ARGS = -serial stdio -display none
      OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
-     LINKER_FILE       = src/bsp/raspberrypi/link.ld
+     READELF_BINARY    = aarch64-none-elf-readelf
 
 diff -uNr 02_runtime_init/src/bsp/raspberrypi/console.rs 03_hacky_hello_world/src/bsp/raspberrypi/console.rs
 --- 02_runtime_init/src/bsp/raspberrypi/console.rs

03_hacky_hello_world/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

04_zero_overhead_abstraction/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = []

04_zero_overhead_abstraction/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -14,6 +16,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -24,6 +27,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -31,12 +35,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -53,8 +59,8 @@ DOCKER_IMAGE         = rustembedded/osdev-utils
 DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
 DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 
@@ -63,36 +69,45 @@ EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

04_zero_overhead_abstraction/README.md

@@ -13,7 +13,7 @@
 diff -uNr 03_hacky_hello_world/Cargo.toml 04_zero_overhead_abstraction/Cargo.toml
 --- 03_hacky_hello_world/Cargo.toml
 +++ 04_zero_overhead_abstraction/Cargo.toml
-@@ -18,3 +18,8 @@
+@@ -17,3 +17,8 @@
  ##--------------------------------------------------------------------------------------------------
 
  [dependencies]

04_zero_overhead_abstraction/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

05_safe_globals/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = []

05_safe_globals/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -14,6 +16,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -24,6 +27,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -31,12 +35,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -53,8 +59,8 @@ DOCKER_IMAGE         = rustembedded/osdev-utils
 DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
 DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 
@@ -63,36 +69,45 @@ EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

05_safe_globals/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

06_drivers_gpio_uart/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

06_drivers_gpio_uart/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -30,6 +33,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -37,12 +41,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -61,8 +67,8 @@ DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 DOCKER_ARG_DIR_UTILS = -v $(shell pwd)/../utils:/work/utils
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -79,19 +85,22 @@ EXEC_MINITERM = ruby ../utils/miniterm.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -99,19 +108,25 @@ miniterm:
 	@$(DOCKER_MINITERM) $(EXEC_MINITERM) $(DEV_SERIAL)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

06_drivers_gpio_uart/README.md

@@ -110,8 +110,8 @@ Miniterm 1.0
 diff -uNr 05_safe_globals/Cargo.toml 06_drivers_gpio_uart/Cargo.toml
 --- 05_safe_globals/Cargo.toml
 +++ 06_drivers_gpio_uart/Cargo.toml
-@@ -10,8 +10,8 @@
+@@ -9,8 +9,8 @@
- # The features section is used to select the target board.
+
  [features]
  default = []
 -bsp_rpi3 = []
@@ -121,7 +121,7 @@ diff -uNr 05_safe_globals/Cargo.toml 06_drivers_gpio_uart/Cargo.toml
 
  ##--------------------------------------------------------------------------------------------------
  ## Dependencies
-@@ -19,6 +19,9 @@
+@@ -18,6 +18,9 @@
 
  [dependencies]
 
@@ -135,7 +135,7 @@ diff -uNr 05_safe_globals/Cargo.toml 06_drivers_gpio_uart/Cargo.toml
 diff -uNr 05_safe_globals/Makefile 06_drivers_gpio_uart/Makefile
 --- 05_safe_globals/Makefile
 +++ 06_drivers_gpio_uart/Makefile
-@@ -5,6 +5,12 @@
+@@ -7,6 +7,12 @@
  # Default to the RPi3
  BSP ?= rpi3
 
@@ -148,15 +148,15 @@ diff -uNr 05_safe_globals/Makefile 06_drivers_gpio_uart/Makefile
  # BSP-specific arguments
  ifeq ($(BSP),rpi3)
      TARGET            = aarch64-unknown-none-softfloat
-@@ -52,13 +58,23 @@
+@@ -58,13 +64,23 @@
  DOCKER_IMAGE         = rustembedded/osdev-utils
  DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
  DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 +DOCKER_ARG_DIR_UTILS = -v $(shell pwd)/../utils:/work/utils
 +DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 
- DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+ DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
- DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+ DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 -EXEC_QEMU = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
 +# Dockerize commands that require USB device passthrough only on Linux
@@ -174,7 +174,7 @@ diff -uNr 05_safe_globals/Makefile 06_drivers_gpio_uart/Makefile
 
  all: $(KERNEL_BIN)
 
-@@ -79,6 +95,9 @@
+@@ -88,6 +104,9 @@
  	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
  endif
 
@@ -182,7 +182,7 @@ diff -uNr 05_safe_globals/Makefile 06_drivers_gpio_uart/Makefile
 +	@$(DOCKER_MINITERM) $(EXEC_MINITERM) $(DEV_SERIAL)
 +
  clippy:
- 	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+ 	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 
 diff -uNr 05_safe_globals/src/_arch/aarch64/cpu.rs 06_drivers_gpio_uart/src/_arch/aarch64/cpu.rs

06_drivers_gpio_uart/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

07_uart_chainloader/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

07_uart_chainloader/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53 -C relocation-model=pic
     CHAINBOOT_DEMO_PAYLOAD = demo_payload_rpi3.img
@@ -31,6 +34,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72 -C relocation-model=pic
     CHAINBOOT_DEMO_PAYLOAD = demo_payload_rpi4.img
@@ -39,12 +43,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -63,8 +69,8 @@ DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 DOCKER_ARG_DIR_UTILS = -v $(shell pwd)/../utils:/work/utils
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -82,22 +88,26 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
-qemu qemuasm:
+qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 
 qemuasm: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU with ASM output")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN) -d in_asm
 endif
 
@@ -105,22 +115,26 @@ chainboot:
 	@$(DOCKER_CHAINBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(CHAINBOOT_DEMO_PAYLOAD)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+	$(call colorecho, "\nLaunching objdump")
-                --section .text \
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
-                --section .got  \
+                --section .text   \
+                --section .rodata \
+                --section .got    \
                 $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

07_uart_chainloader/README.md

@@ -110,9 +110,9 @@ Binary files 06_drivers_gpio_uart/demo_payload_rpi4.img and 07_uart_chainloader/
 diff -uNr 06_drivers_gpio_uart/Makefile 07_uart_chainloader/Makefile
 --- 06_drivers_gpio_uart/Makefile
 +++ 07_uart_chainloader/Makefile
-@@ -21,7 +21,8 @@
+@@ -24,7 +24,8 @@
-     OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
+     READELF_BINARY    = aarch64-none-elf-readelf
      LINKER_FILE       = src/bsp/raspberrypi/link.ld
 -    RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 +    RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53 -C relocation-model=pic
@@ -120,9 +120,9 @@ diff -uNr 06_drivers_gpio_uart/Makefile 07_uart_chainloader/Makefile
  else ifeq ($(BSP),rpi4)
      TARGET            = aarch64-unknown-none-softfloat
      KERNEL_BIN        = kernel8.img
-@@ -31,7 +32,8 @@
+@@ -35,7 +36,8 @@
-     OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
+     READELF_BINARY    = aarch64-none-elf-readelf
      LINKER_FILE       = src/bsp/raspberrypi/link.ld
 -    RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 +    RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72 -C relocation-model=pic
@@ -130,7 +130,7 @@ diff -uNr 06_drivers_gpio_uart/Makefile 07_uart_chainloader/Makefile
  endif
 
  # Export for build.rs
-@@ -68,13 +70,14 @@
+@@ -74,13 +76,14 @@
  ifeq ($(UNAME_S),Linux)
      DOCKER_CMD_DEV = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_DEV)
 
@@ -148,18 +148,13 @@ diff -uNr 06_drivers_gpio_uart/Makefile 07_uart_chainloader/Makefile
 
  all: $(KERNEL_BIN)
 
-@@ -88,15 +91,18 @@
+@@ -102,10 +105,14 @@
- 	$(DOC_CMD) --document-private-items --open
-
- ifeq ($(QEMU_MACHINE_TYPE),)
--qemu:
-+qemu qemuasm:
- 	@echo "This board is not yet supported for QEMU."
- else
  qemu: $(KERNEL_BIN)
+ 	$(call colorecho, "\nLaunching QEMU")
  	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 +
 +qemuasm: $(KERNEL_BIN)
++	$(call colorecho, "\nLaunching QEMU with ASM output")
 +	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN) -d in_asm
  endif
 
@@ -169,19 +164,15 @@ diff -uNr 06_drivers_gpio_uart/Makefile 07_uart_chainloader/Makefile
 +	@$(DOCKER_CHAINBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(CHAINBOOT_DEMO_PAYLOAD)
 
  clippy:
- 	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+ 	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
-@@ -108,7 +114,10 @@
+@@ -122,6 +129,7 @@
- 	readelf --headers $(KERNEL_ELF)
+ 	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
-
+                 --section .text   \
- objdump: $(KERNEL_ELF)
+                 --section .rodata \
--	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
++                --section .got    \
-+	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                 $(KERNEL_ELF) | rustfilt
-+                --section .text \
-+                --section .got  \
-+                $(KERNEL_ELF) | rustfilt
 
  nm: $(KERNEL_ELF)
- 	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 diff -uNr 06_drivers_gpio_uart/src/_arch/aarch64/cpu/boot.rs 07_uart_chainloader/src/_arch/aarch64/cpu/boot.rs
 --- 06_drivers_gpio_uart/src/_arch/aarch64/cpu/boot.rs

07_uart_chainloader/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

08_timestamps/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

08_timestamps/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -30,6 +33,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -37,12 +41,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -61,8 +67,8 @@ DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 DOCKER_ARG_DIR_UTILS = -v $(shell pwd)/../utils:/work/utils
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -79,19 +85,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -99,19 +108,25 @@ chainboot: $(KERNEL_BIN)
 	@$(DOCKER_CHAINBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(KERNEL_BIN)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

08_timestamps/README.md

@@ -49,9 +49,9 @@ Binary files 07_uart_chainloader/demo_payload_rpi4.img and 08_timestamps/demo_pa
 diff -uNr 07_uart_chainloader/Makefile 08_timestamps/Makefile
 --- 07_uart_chainloader/Makefile
 +++ 08_timestamps/Makefile
-@@ -21,8 +21,7 @@
+@@ -24,8 +24,7 @@
-     OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
+     READELF_BINARY    = aarch64-none-elf-readelf
      LINKER_FILE       = src/bsp/raspberrypi/link.ld
 -    RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53 -C relocation-model=pic
 -    CHAINBOOT_DEMO_PAYLOAD = demo_payload_rpi3.img
@@ -59,9 +59,9 @@ diff -uNr 07_uart_chainloader/Makefile 08_timestamps/Makefile
  else ifeq ($(BSP),rpi4)
      TARGET            = aarch64-unknown-none-softfloat
      KERNEL_BIN        = kernel8.img
-@@ -32,8 +31,7 @@
+@@ -36,8 +35,7 @@
-     OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
+     READELF_BINARY    = aarch64-none-elf-readelf
      LINKER_FILE       = src/bsp/raspberrypi/link.ld
 -    RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72 -C relocation-model=pic
 -    CHAINBOOT_DEMO_PAYLOAD = demo_payload_rpi4.img
@@ -69,7 +69,7 @@ diff -uNr 07_uart_chainloader/Makefile 08_timestamps/Makefile
  endif
 
  # Export for build.rs
-@@ -76,8 +74,7 @@
+@@ -82,8 +80,7 @@
  EXEC_QEMU     = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
  EXEC_MINIPUSH = ruby ../utils/minipush.rb
 
@@ -79,18 +79,13 @@ diff -uNr 07_uart_chainloader/Makefile 08_timestamps/Makefile
 
  all: $(KERNEL_BIN)
 
-@@ -91,18 +88,15 @@
+@@ -105,14 +102,10 @@
- 	$(DOC_CMD) --document-private-items --open
-
- ifeq ($(QEMU_MACHINE_TYPE),)
--qemu qemuasm:
-+qemu:
- 	@echo "This board is not yet supported for QEMU."
- else
  qemu: $(KERNEL_BIN)
+ 	$(call colorecho, "\nLaunching QEMU")
  	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 -
 -qemuasm: $(KERNEL_BIN)
+-	$(call colorecho, "\nLaunching QEMU with ASM output")
 -	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN) -d in_asm
  endif
 
@@ -100,19 +95,15 @@ diff -uNr 07_uart_chainloader/Makefile 08_timestamps/Makefile
 +	@$(DOCKER_CHAINBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(KERNEL_BIN)
 
  clippy:
- 	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+ 	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
-@@ -114,10 +108,7 @@
+@@ -129,7 +122,6 @@
- 	readelf --headers $(KERNEL_ELF)
+ 	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
-
+                 --section .text   \
- objdump: $(KERNEL_ELF)
+                 --section .rodata \
--	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+-                --section .got    \
--                --section .text \
+                 $(KERNEL_ELF) | rustfilt
--                --section .got  \
--                $(KERNEL_ELF) | rustfilt
-+	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
 
  nm: $(KERNEL_ELF)
- 	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 diff -uNr 07_uart_chainloader/src/_arch/aarch64/cpu/boot.rs 08_timestamps/src/_arch/aarch64/cpu/boot.rs
 --- 07_uart_chainloader/src/_arch/aarch64/cpu/boot.rs

08_timestamps/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

09_hw_debug_JTAG/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

09_hw_debug_JTAG/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -32,6 +35,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -41,12 +45,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -67,9 +73,9 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -91,19 +97,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -114,33 +123,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

09_hw_debug_JTAG/README.md

@@ -306,25 +306,25 @@ Thanks to [@naotaco](https://github.com/naotaco) for laying the groundwork for t
 diff -uNr 08_timestamps/Makefile 09_hw_debug_JTAG/Makefile
 --- 08_timestamps/Makefile
 +++ 09_hw_debug_JTAG/Makefile
-@@ -20,6 +20,8 @@
+@@ -23,6 +23,8 @@
-     QEMU_RELEASE_ARGS = -serial stdio -display none
      OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
+     READELF_BINARY    = aarch64-none-elf-readelf
 +    OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
 +    JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
      LINKER_FILE       = src/bsp/raspberrypi/link.ld
      RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
  else ifeq ($(BSP),rpi4)
-@@ -30,6 +32,8 @@
+@@ -34,6 +36,8 @@
-     QEMU_RELEASE_ARGS = -serial stdio -display none
      OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
+     READELF_BINARY    = aarch64-none-elf-readelf
 +    OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
 +    JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
      LINKER_FILE       = src/bsp/raspberrypi/link.ld
      RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
  endif
-@@ -59,9 +63,12 @@
+@@ -65,9 +69,12 @@
  DOCKER_CMD           = docker run --rm -v $(shell pwd):/work/tutorial -w /work/tutorial
  DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
  DOCKER_ARG_DIR_UTILS = -v $(shell pwd)/../utils:/work/utils
@@ -332,12 +332,12 @@ diff -uNr 08_timestamps/Makefile 09_hw_debug_JTAG/Makefile
  DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 +DOCKER_ARG_NET       = --network host
 
- DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+ DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-+DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
++DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
- DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+ DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
  # Dockerize commands that require USB device passthrough only on Linux
-@@ -69,12 +76,17 @@
+@@ -75,12 +82,17 @@
      DOCKER_CMD_DEV = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_DEV)
 
      DOCKER_CHAINBOOT = $(DOCKER_CMD_DEV) $(DOCKER_ARG_DIR_UTILS) $(DOCKER_IMAGE)
@@ -356,7 +356,7 @@ diff -uNr 08_timestamps/Makefile 09_hw_debug_JTAG/Makefile
 
  all: $(KERNEL_BIN)
 
-@@ -98,6 +110,23 @@
+@@ -107,6 +119,19 @@
  chainboot: $(KERNEL_BIN)
  	@$(DOCKER_CHAINBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(KERNEL_BIN)
 
@@ -364,20 +364,16 @@ diff -uNr 08_timestamps/Makefile 09_hw_debug_JTAG/Makefile
 +	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 +
 +openocd:
++	$(call colorecho, "\nLaunching OpenOCD")
 +	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 +
-+define gen_gdb
++gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-+    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
++gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-+    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
++gdb gdb-opt0: $(KERNEL_ELF)
-+endef
++	$(call colorecho, "\nLaunching GDB")
-+
++	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-+gdb:
-+	$(call gen_gdb,-C debuginfo=2)
-+
-+gdb-opt0:
-+	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 +
  clippy:
- 	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+ 	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 ```

09_hw_debug_JTAG/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

10_privilege_level/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

10_privilege_level/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -32,6 +35,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -41,12 +45,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -67,9 +73,9 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -91,19 +97,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -114,33 +123,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

10_privilege_level/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

11_virtual_mem_part1_identity_mapping/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

11_virtual_mem_part1_identity_mapping/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -32,6 +35,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -41,12 +45,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -67,9 +73,9 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -91,19 +97,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -114,33 +123,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

11_virtual_mem_part1_identity_mapping/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

12_exceptions_part1_groundwork/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

12_exceptions_part1_groundwork/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -32,6 +35,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -41,12 +45,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -67,9 +73,9 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -91,19 +97,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -114,33 +123,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

12_exceptions_part1_groundwork/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

13_integrated_testing/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -21,6 +23,7 @@ ifeq ($(BSP),rpi3)
     QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -34,6 +37,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -81,10 +85,10 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_TEST     = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TEST  = $(DOCKER_CMD) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -106,19 +110,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu test:
-	@echo $(QEMU_MISSING_STRING)
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 
 define KERNEL_TEST_RUNNER
@@ -134,10 +141,11 @@ endef
 export KERNEL_TEST_RUNNER
 test: FEATURES += --features test_build
 test:
+	$(call colorecho, "\nCompiling test(s) - $(BSP)")
 	@mkdir -p target
 	@echo "$$KERNEL_TEST_RUNNER" > target/kernel_test_runner.sh
 	@chmod +x target/kernel_test_runner.sh
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
 endif
 
 chainboot: $(KERNEL_BIN)
@@ -147,33 +155,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

13_integrated_testing/README.md

@@ -819,12 +819,7 @@ diff -uNr 12_exceptions_part1_groundwork/.cargo/config.toml 13_integrated_testin
 diff -uNr 12_exceptions_part1_groundwork/Cargo.toml 13_integrated_testing/Cargo.toml
 --- 12_exceptions_part1_groundwork/Cargo.toml
 +++ 13_integrated_testing/Cargo.toml
-@@ -7,22 +7,49 @@
+@@ -11,17 +11,45 @@
- [profile.release]
- lto = true
-
--# The features section is used to select the target board.
- [features]
  default = []
  bsp_rpi3 = ["register"]
  bsp_rpi4 = ["register"]
@@ -875,23 +870,23 @@ diff -uNr 12_exceptions_part1_groundwork/Cargo.toml 13_integrated_testing/Cargo.
 diff -uNr 12_exceptions_part1_groundwork/Makefile 13_integrated_testing/Makefile
 --- 12_exceptions_part1_groundwork/Makefile
 +++ 13_integrated_testing/Makefile
-@@ -18,6 +18,7 @@
+@@ -20,6 +20,7 @@
      QEMU_BINARY       = qemu-system-aarch64
      QEMU_MACHINE_TYPE = raspi3
      QEMU_RELEASE_ARGS = -serial stdio -display none
 +    QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
      OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
-     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
+     READELF_BINARY    = aarch64-none-elf-readelf
-@@ -30,6 +31,7 @@
+@@ -33,6 +34,7 @@
      QEMU_BINARY       = qemu-system-aarch64
      QEMU_MACHINE_TYPE =
      QEMU_RELEASE_ARGS = -serial stdio -display none
 +    QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
      OBJDUMP_BINARY    = aarch64-none-elf-objdump
      NM_BINARY         = aarch64-none-elf-nm
-     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
+     READELF_BINARY    = aarch64-none-elf-readelf
-@@ -41,18 +43,30 @@
+@@ -45,6 +47,15 @@
  # Export for build.rs
  export LINKER_FILE
 
@@ -904,19 +899,10 @@ diff -uNr 12_exceptions_part1_groundwork/Makefile 13_integrated_testing/Makefile
 +    endif
 +endif
 +
-+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+ QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
-+
- RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
- RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
--FEATURES      = bsp_$(BSP)
+ RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
-+FEATURES      = --features bsp_$(BSP)
+@@ -59,6 +70,7 @@
- COMPILER_ARGS = --target=$(TARGET) \
--    --features $(FEATURES)         \
-+    $(FEATURES)                    \
-     --release
-
- RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
  DOC_CMD     = cargo doc $(COMPILER_ARGS)
  CLIPPY_CMD  = cargo clippy $(COMPILER_ARGS)
  CHECK_CMD   = cargo check $(COMPILER_ARGS)
@@ -924,15 +910,15 @@ diff -uNr 12_exceptions_part1_groundwork/Makefile 13_integrated_testing/Makefile
  OBJCOPY_CMD = rust-objcopy \
      --strip-all            \
      -O binary
-@@ -69,6 +83,7 @@
+@@ -75,6 +87,7 @@
 
- DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+ DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
- DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+ DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-+DOCKER_TEST     = $(DOCKER_CMD) $(DOCKER_IMAGE)
++DOCKER_TEST  = $(DOCKER_CMD) $(DOCKER_IMAGE)
- DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+ DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
  # Dockerize commands that require USB device passthrough only on Linux
-@@ -85,8 +100,8 @@
+@@ -91,8 +104,8 @@
  EXEC_QEMU     = $(QEMU_BINARY) -M $(QEMU_MACHINE_TYPE)
  EXEC_MINIPUSH = ruby ../utils/minipush.rb
 
@@ -943,16 +929,16 @@ diff -uNr 12_exceptions_part1_groundwork/Makefile 13_integrated_testing/Makefile
 
  all: $(KERNEL_BIN)
 
-@@ -100,11 +115,29 @@
+@@ -108,12 +121,31 @@
- 	$(DOC_CMD) --document-private-items --open
+ 	@$(DOC_CMD) --document-private-items --open
 
  ifeq ($(QEMU_MACHINE_TYPE),)
 -qemu:
--	@echo "This board is not yet supported for QEMU."
 +qemu test:
-+	@echo $(QEMU_MISSING_STRING)
+ 	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
  else
  qemu: $(KERNEL_BIN)
+ 	$(call colorecho, "\nLaunching QEMU")
  	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 +
 +define KERNEL_TEST_RUNNER
@@ -968,10 +954,11 @@ diff -uNr 12_exceptions_part1_groundwork/Makefile 13_integrated_testing/Makefile
 +export KERNEL_TEST_RUNNER
 +test: FEATURES += --features test_build
 +test:
++	$(call colorecho, "\nCompiling test(s) - $(BSP)")
 +	@mkdir -p target
 +	@echo "$$KERNEL_TEST_RUNNER" > target/kernel_test_runner.sh
 +	@chmod +x target/kernel_test_runner.sh
-+	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
++	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
  endif
 
  chainboot: $(KERNEL_BIN)

13_integrated_testing/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

14_exceptions_part2_peripheral_IRQs/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -21,6 +23,7 @@ ifeq ($(BSP),rpi3)
     QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -34,6 +37,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -81,10 +85,10 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_TEST     = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TEST  = $(DOCKER_CMD) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -106,19 +110,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu test:
-	@echo $(QEMU_MISSING_STRING)
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 
 define KERNEL_TEST_RUNNER
@@ -134,10 +141,11 @@ endef
 export KERNEL_TEST_RUNNER
 test: FEATURES += --features test_build
 test:
+	$(call colorecho, "\nCompiling test(s) - $(BSP)")
 	@mkdir -p target
 	@echo "$$KERNEL_TEST_RUNNER" > target/kernel_test_runner.sh
 	@chmod +x target/kernel_test_runner.sh
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
 endif
 
 chainboot: $(KERNEL_BIN)
@@ -147,33 +155,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

14_exceptions_part2_peripheral_IRQs/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

15_virtual_mem_part2_mmio_remap/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -21,6 +23,7 @@ ifeq ($(BSP),rpi3)
     QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi3.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi3.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -34,6 +37,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_TEST_ARGS    = $(QEMU_RELEASE_ARGS) -semihosting
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     OPENOCD_ARG       = -f /openocd/tcl/interface/ftdi/olimex-arm-usb-tiny-h.cfg -f /openocd/rpi4.cfg
     JTAG_BOOT_IMAGE   = ../X1_JTAG_boot/jtag_boot_rpi4.img
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
@@ -81,10 +85,10 @@ DOCKER_ARG_DIR_JTAG  = -v $(shell pwd)/../X1_JTAG_boot:/work/X1_JTAG_boot
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 DOCKER_ARG_NET       = --network host
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_GDB      = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
+DOCKER_GDB   = $(DOCKER_CMD_INTERACT) $(DOCKER_ARG_NET) $(DOCKER_IMAGE)
-DOCKER_TEST     = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TEST  = $(DOCKER_CMD) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -106,19 +110,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu test:
-	@echo $(QEMU_MISSING_STRING)
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 
 define KERNEL_TEST_RUNNER
@@ -134,10 +141,11 @@ endef
 export KERNEL_TEST_RUNNER
 test: FEATURES += --features test_build
 test:
+	$(call colorecho, "\nCompiling test(s) - $(BSP)")
 	@mkdir -p target
 	@echo "$$KERNEL_TEST_RUNNER" > target/kernel_test_runner.sh
 	@chmod +x target/kernel_test_runner.sh
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(TEST_CMD) $(TEST_ARG)
 endif
 
 chainboot: $(KERNEL_BIN)
@@ -147,33 +155,35 @@ jtagboot:
 	@$(DOCKER_JTAGBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(JTAG_BOOT_IMAGE)
 
 openocd:
+	$(call colorecho, "\nLaunching OpenOCD")
 	@$(DOCKER_OPENOCD) openocd $(OPENOCD_ARG)
 
-define gen_gdb
+gdb: RUSTC_MISC_ARGS += -C debuginfo=2
-    RUSTFLAGS="$(RUSTFLAGS_PEDANTIC) $1" $(RUSTC_CMD)
+gdb-opt0: RUSTC_MISC_ARGS += -C debuginfo=2 -C opt-level=0
-    @$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
+gdb gdb-opt0: $(KERNEL_ELF)
-endef
+	$(call colorecho, "\nLaunching GDB")
-
+	@$(DOCKER_GDB) gdb-multiarch -q $(KERNEL_ELF)
-gdb:
-	$(call gen_gdb,-C debuginfo=2)
-
-gdb-opt0:
-	$(call gen_gdb,-C debuginfo=2 -C opt-level=0)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

15_virtual_mem_part2_mmio_remap/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

X1_JTAG_boot/Cargo.toml

@@ -7,7 +7,6 @@ edition = "2018"
 [profile.release]
 lto = true
 
-# The features section is used to select the target board.
 [features]
 default = []
 bsp_rpi3 = ["register"]

X1_JTAG_boot/Makefile

@@ -2,6 +2,8 @@
 ##
 ## Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
 
+include ../utils/color.mk.in
+
 # Default to the RPi3
 BSP ?= rpi3
 
@@ -20,6 +22,7 @@ ifeq ($(BSP),rpi3)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a53
 else ifeq ($(BSP),rpi4)
@@ -30,6 +33,7 @@ else ifeq ($(BSP),rpi4)
     QEMU_RELEASE_ARGS = -serial stdio -display none
     OBJDUMP_BINARY    = aarch64-none-elf-objdump
     NM_BINARY         = aarch64-none-elf-nm
+    READELF_BINARY    = aarch64-none-elf-readelf
     LINKER_FILE       = src/bsp/raspberrypi/link.ld
     RUSTC_MISC_ARGS   = -C target-cpu=cortex-a72
 endif
@@ -37,12 +41,14 @@ endif
 # Export for build.rs
 export LINKER_FILE
 
+QEMU_MISSING_STRING = "This board is not yet supported for QEMU."
+
 RUSTFLAGS          = -C link-arg=-T$(LINKER_FILE) $(RUSTC_MISC_ARGS)
 RUSTFLAGS_PEDANTIC = $(RUSTFLAGS) -D warnings -D missing_docs
 
-FEATURES      = bsp_$(BSP)
+FEATURES      = --features bsp_$(BSP)
 COMPILER_ARGS = --target=$(TARGET) \
-    --features $(FEATURES)         \
+    $(FEATURES)                    \
     --release
 
 RUSTC_CMD   = cargo rustc $(COMPILER_ARGS)
@@ -61,8 +67,8 @@ DOCKER_CMD_INTERACT  = $(DOCKER_CMD) -i -t
 DOCKER_ARG_DIR_UTILS = -v $(shell pwd)/../utils:/work/utils
 DOCKER_ARG_DEV       = --privileged -v /dev:/dev
 
-DOCKER_QEMU     = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
+DOCKER_QEMU  = $(DOCKER_CMD_INTERACT) $(DOCKER_IMAGE)
-DOCKER_ELFTOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
+DOCKER_TOOLS = $(DOCKER_CMD) $(DOCKER_IMAGE)
 
 # Dockerize commands that require USB device passthrough only on Linux
 ifeq ($(UNAME_S),Linux)
@@ -79,19 +85,22 @@ EXEC_MINIPUSH = ruby ../utils/minipush.rb
 all: $(KERNEL_BIN)
 
 $(KERNEL_ELF):
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
+	$(call colorecho, "\nCompiling kernel - $(BSP)")
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(RUSTC_CMD)
 
 $(KERNEL_BIN): $(KERNEL_ELF)
 	@$(OBJCOPY_CMD) $(KERNEL_ELF) $(KERNEL_BIN)
 
 doc:
-	$(DOC_CMD) --document-private-items --open
+	$(call colorecho, "\nGenerating docs")
+	@$(DOC_CMD) --document-private-items --open
 
 ifeq ($(QEMU_MACHINE_TYPE),)
 qemu:
-	@echo "This board is not yet supported for QEMU."
+	$(call colorecho, "\n$(QEMU_MISSING_STRING)")
 else
 qemu: $(KERNEL_BIN)
+	$(call colorecho, "\nLaunching QEMU")
 	@$(DOCKER_QEMU) $(EXEC_QEMU) $(QEMU_RELEASE_ARGS) -kernel $(KERNEL_BIN)
 endif
 
@@ -99,19 +108,25 @@ chainboot: $(KERNEL_BIN)
 	@$(DOCKER_CHAINBOOT) $(EXEC_MINIPUSH) $(DEV_SERIAL) $(KERNEL_BIN)
 
 clippy:
-	RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
+	@RUSTFLAGS="$(RUSTFLAGS_PEDANTIC)" $(CLIPPY_CMD)
 
 clean:
 	rm -rf target $(KERNEL_BIN)
 
 readelf: $(KERNEL_ELF)
-	readelf --headers $(KERNEL_ELF)
+	$(call colorecho, "\nLaunching readelf")
+	@$(DOCKER_TOOLS) $(READELF_BINARY) --headers $(KERNEL_ELF)
 
 objdump: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(OBJDUMP_BINARY) --disassemble --demangle $(KERNEL_ELF) | rustfilt
+	$(call colorecho, "\nLaunching objdump")
+	@$(DOCKER_TOOLS) $(OBJDUMP_BINARY) --disassemble --demangle \
+                --section .text   \
+                --section .rodata \
+                $(KERNEL_ELF) | rustfilt
 
 nm: $(KERNEL_ELF)
-	@$(DOCKER_ELFTOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
+	$(call colorecho, "\nLaunching nm")
+	@$(DOCKER_TOOLS) $(NM_BINARY) --demangle --print-size $(KERNEL_ELF) | sort | rustfilt
 
 # For rust-analyzer
 check:

X1_JTAG_boot/build.rs

@@ -4,4 +4,5 @@ fn main() {
     let linker_file = env::var("LINKER_FILE").unwrap();
 
     println!("cargo:rerun-if-changed={}", linker_file);
+    println!("cargo:rerun-if-changed=build.rs");
 }

utils/color.mk.in

@@ -0,0 +1,5 @@
+define colorecho
+      @tput setaf 6
+      @echo $1
+      @tput sgr0
+endef

utils/minipush.rb

@@ -112,6 +112,7 @@ class MiniPush < MiniTerm
     end
 end
 
+puts
 puts 'Minipush 1.0'.cyan
 puts
 

utils/miniterm.rb

@@ -126,6 +126,7 @@ class MiniTerm
 end
 
 if __FILE__ == $PROGRAM_NAME
+    puts
     puts 'Miniterm 1.0'.cyan
     puts