cmake_minimum_required(VERSION 3.22)

# ---------------------------------------------------------------------------
# stm32f103-blinky : bare-metal CMake build for an STM32F103C8 (Blue Pill)
#
#   cmake -B out -GNinja
#   ninja -C out
#
# The CMake cache picks up arm-none-eabi-gcc from PATH (or from the
# ARM_GCC_HOME environment variable), so no toolchain file is required.
# This mirrors what STM32CubeMX generates, but is hand written so that the
# whole flow is visible.
# ---------------------------------------------------------------------------

# Declare a bare-metal cross build *before* any language is enabled. Without
# this CMake assumes the host (Windows) and its compiler test tries to link a
# Win32 executable with the ARM linker -> "unrecognized option
# '--major-image-version'". CMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY makes
# the compiler check a pure compile step, which is what every bare-metal
# toolchain file does (STM32CubeMX's own gcc-arm-none-eabi.cmake included).
set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR arm)
set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)

project(stm32f103-blinky LANGUAGES NONE)

# --- 1. locate the cross compiler ------------------------------------------
if(NOT CMAKE_C_COMPILER)
  find_program(ARM_GCC_EXE
               NAMES arm-none-eabi-gcc
               HINTS ENV ARM_GCC_HOME ENV ARM_TOOLCHAIN_PATH
               PATH_SUFFIXES bin)
  if(NOT ARM_GCC_EXE)
    message(FATAL_ERROR
      "arm-none-eabi-gcc not found.\n"
      "Add <toolchain>/bin to PATH, or set ARM_GCC_HOME to the extracted "
      "arm-gnu-toolchain folder.")
  endif()
  get_filename_component(_arm_bin "${ARM_GCC_EXE}" DIRECTORY)
  set(CMAKE_C_COMPILER   "${_arm_bin}/arm-none-eabi-gcc.exe"   CACHE FILEPATH "")
  set(CMAKE_ASM_COMPILER "${_arm_bin}/arm-none-eabi-gcc.exe"   CACHE FILEPATH "")
  set(ARM_OBJCOPY "${_arm_bin}/arm-none-eabi-objcopy.exe" CACHE FILEPATH "")
  set(ARM_SIZE    "${_arm_bin}/arm-none-eabi-size.exe"    CACHE FILEPATH "")
  message(STATUS "Using toolchain: ${_arm_bin}")
endif()

enable_language(C ASM)

set(CMAKE_C_STANDARD 11)
set(CMAKE_C_STANDARD_REQUIRED ON)
set(CMAKE_C_EXTENSIONS OFF)
set(CMAKE_EXECUTABLE_SUFFIX ".elf")

if(NOT CMAKE_BUILD_TYPE)
  set(CMAKE_BUILD_TYPE Debug CACHE STRING "" FORCE)
endif()

# --- 2. target description -------------------------------------------------
set(MCU_CORE   cortex-m3)
set(MCU_FLAGS  -mcpu=${MCU_CORE} -mthumb -mfloat-abi=soft)

# STM32F103xB = 64 KiB flash / 20 KiB RAM lines of the F1 family
add_compile_definitions(STM32F103xB)
# --- 3. sources & includes -------------------------------------------------
set(APP_SOURCES
  Core/Src/main.c
  Core/Src/syscalls.c
  Core/Src/system_stm32f1xx.c
  startup_stm32f103xb.s
)

add_executable(${PROJECT_NAME} ${APP_SOURCES})

target_include_directories(${PROJECT_NAME} PRIVATE
  Core/Inc
  CMSIS/Device/ST/STM32F1xx/Include
  CMSIS/Core/Include
)

set(LINKER_SCRIPT "${CMAKE_CURRENT_SOURCE_DIR}/ld/STM32F103XB_FLASH.ld"
    CACHE FILEPATH "Linker script (swap in ld/STM32F103XB_FLASH_cubemx.ld to test the (READONLY) variant)")

# --- 4. compiler flags -----------------------------------------------------
target_compile_options(${PROJECT_NAME} PRIVATE
  ${MCU_FLAGS}
  -Wall -Wextra
  -ffunction-sections -fdata-sections
  -fno-common
  $<$<CONFIG:Debug>:-Og;-g3;-gdwarf-4>
  $<$<CONFIG:Release>:-Os>
)

# --- 5. linker flags -------------------------------------------------------
target_link_options(${PROJECT_NAME} PRIVATE
  ${MCU_FLAGS}
  -T${LINKER_SCRIPT}
  -Wl,--gc-sections
  -Wl,-Map=${PROJECT_NAME}.map,--cref
  -Wl,--print-memory-usage
  -specs=nano.specs
  # binutils >= 2.39 warns "LOAD segment with RWX permissions" for the classic
  # STM32 .ld layout; the segment is EEPROM-era harmless, so silence it on the
  # toolchains that know the switch (GCC 10.3's binutils 2.36 does not).
  $<$<VERSION_GREATER_EQUAL:${CMAKE_C_COMPILER_VERSION},12>:-Wl,--no-warn-rwx-segments>
  $<$<CONFIG:Release>:-Wl,--strip-debug>
)

# --- 6. post-build : intel hex + raw binary --------------------------------
add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
  COMMAND "${ARM_OBJCOPY}" -O ihex   $<TARGET_FILE:${PROJECT_NAME}> ${PROJECT_NAME}.hex
  COMMAND "${ARM_OBJCOPY}" -O binary $<TARGET_FILE:${PROJECT_NAME}> ${PROJECT_NAME}.bin
  COMMAND "${ARM_SIZE}" --format=berkeley $<TARGET_FILE:${PROJECT_NAME}>
  COMMENT "Generating ${PROJECT_NAME}.hex / ${PROJECT_NAME}.bin"
  VERBATIM
)

# convenience: `ninja -C out size`
add_custom_target(size
  COMMAND "${ARM_SIZE}" --format=berkeley $<TARGET_FILE:${PROJECT_NAME}>
  DEPENDS ${PROJECT_NAME}
  WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
  VERBATIM
)
