Updated cmake-tutorial (#14)

Author: felipe-iar

.gitignore

@@ -1,3 +1,4 @@
 _builds
+hello-world
 Testing
 

README.md

@@ -0,0 +1,30 @@
+# Example for creating a test for CTest 
+# to execute the `IAR C-SPY Command-line Utility (cspybat.exe)`
+
+function(iar_cspy_add_test TARGET TEST_NAME EXPECTED_OUTPUT)
+  # Add a test for CTest
+  add_test(NAME ${TEST_NAME} 
+           COMMAND ${TOOLKIT_DIR}/../common/bin/cspybat --silent
+           # C-SPY drivers
+           "${TOOLKIT_DIR}/bin/${CMAKE_SYSTEM_PROCESSOR}proc.dll"
+           "${TOOLKIT_DIR}/bin/${CMAKE_SYSTEM_PROCESSOR}sim.dll"
+           "--plugin=${TOOLKIT_DIR}/bin/${CMAKE_SYSTEM_PROCESSOR}bat.dll"
+           --debug_file=$<TARGET_FILE:${TARGET}>
+           # C-SPY macros settings
+           "--macro=${CMAKE_CURRENT_SOURCE_DIR}/${TARGET}.mac"
+           "--macro_param=testName=\"${TEST_NAME}\""
+           "--macro_param=testExpected=${EXPECTED_OUTPUT}"
+           # C-SPY backend setup
+           --backend
+           -p $<IF:$<BOOL:$<TARGET_PROPERTY:${TARGET},DDF>>,$<TARGET_PROPERTY:${TARGET},DDF>,${TOOLKIT_DIR}/config/debugger/msp430f149.ddf>
+           --hwmul_base=0x130
+           --hardware_multiplier=16
+           --hwmult_type=1
+           --iv_base=0xFFE0
+           --odd_word_check
+           --derivativeSim=MSP430F149
+           -d sim )
+
+  # Set the test to interpret a C-SPY's message containing `PASS`
+  set_tests_properties(${TEST_NAME} PROPERTIES PASS_REGULAR_EXPRESSION "PASS")
+endfunction()

examples/430/iar-cspy-430.cmake

@@ -0,0 +1,43 @@
+cmake_minimum_required(VERSION 3.22)
+
+# Set the project name, [description] and [version],
+# while enabling its required languages
+project(Example1 
+  DESCRIPTION "Mixing C and Assembly"
+  VERSION 1.0.0
+  LANGUAGES C ASM )
+
+# Fallback option for generators other than `Ninja Multi-Config`
+if (NOT DEFINED CMAKE_BUILD_TYPE)
+  set(CMAKE_BUILD_TYPE Debug)
+endif()
+
+# Enable CTest
+enable_testing()
+
+# Add the executable for the "mixLanguages" target
+add_executable(mixLanguages
+  # Source files
+  main.c
+  mynum.asm )
+
+# Set a preprocessor symbol, usable from "mixLanguages" target
+target_compile_definitions(mixLanguages PUBLIC USE_ASM=1)
+
+# Set the compiler flags for the "mixLanguages" target
+target_compile_options(mixLanguages PRIVATE
+  $<$<COMPILE_LANGUAGE:C>:--multiplier=16 --dlib_config ${TOOLKIT_DIR}/lib/dlib/dl430fn.h>
+  -D__MSP430F149__ )
+
+# Set the linker options for the "mixLanguages" target
+target_link_options(mixLanguages PRIVATE
+  -f ${TOOLKIT_DIR}/config/linker/lnk430f149.xcl
+  ${TOOLKIT_DIR}/lib/dlib/dl430fn.r43
+  # The `SHELL:` prefix prevents option de-duplication
+  "SHELL:-D_DATA16_HEAP_SIZE=50"
+  "SHELL:-D_STACK_SIZE=50"
+  "SHELL:-D_DATA20_HEAP_SIZE=50" )
+
+# Optional: test the project with C-SPY
+include(../iar-cspy-430.cmake)
+iar_cspy_add_test(mixLanguages test_mynum 42)

examples/430/mix-c-asm/CMakeLists.txt

@@ -0,0 +1,40 @@
+# Add the executable for the "myProgram" target,
+# specifying its source files
+add_executable (myProgram
+  # Source files
+  main.c )
+
+# Set the properties for the "myProgram" target
+set_target_properties(myProgram PROPERTIES
+  XCL    "${TOOLKIT_DIR}/config/linker/lnk430f149.xcl"
+  # C-SPY-related properties
+  DDF    "${TOOLKIT_DIR}/config/debugger/msp430f149.ddf" )
+
+# Set the compiler flags for the target
+target_compile_options(myProgram PRIVATE
+  $<$<COMPILE_LANGUAGE:C>:--multiplier=16 --double=32 --dlib_config ${TOOLKIT_DIR}/lib/dlib/dl430fn.h>
+  -D__MSP430F149__ )
+
+# Set the linker flags for the target
+target_link_options(myProgram PRIVATE
+  -s __program_start
+  # Create a map file from the target's UBROF
+  -l $<TARGET_PROPERTY:NAME>.map
+  # The `SHELL:` prefix prevents option de-duplication
+  "SHELL:-D_DATA16_HEAP_SIZE=50"
+  "SHELL:-D_STACK_SIZE=50"
+  "SHELL:-D_DATA20_HEAP_SIZE=50"
+  # Set the linker script
+  -f $<TARGET_PROPERTY:XCL>
+  # The `SHELL:` prefix prevents option de-duplication
+  "SHELL:-f ${TOOLKIT_DIR}/config/linker/multiplier.xcl"
+  -rt ${TOOLKIT_DIR}/lib/dlib/dl430fn.r43 )
+
+# Link "myProgram" against the "myMath" library
+target_link_libraries(myProgram LINK_PUBLIC myMath)
+
+# Optional: test the project with C-SPY
+include(../../iar-cspy-430.cmake)
+iar_cspy_add_test(myProgram test_add 42)
+iar_cspy_add_test(myProgram test_sub 38)
+iar_cspy_add_test(myProgram test_mul 80)