CMake target: add naming convenction to the picture

Author: 0xc0170

docs/porting/target/cmake.md

@@ -17,6 +17,8 @@ Note: All the CMake variables above are generated by mbed-tools and their values
 
 We still support mbed-cli 1 and its requirements for the folders naming. To stay backward compatible, we still use the same naming even with CMake.
 
+Each Mbed OS target should be prefixed with `mbed-`. We translate automatically Mbed OS target names from targets.json to CMake targets. A target from targets.json named `CYSBSYSKIT_01` has CMake target `mbed-cysbsyskit-01`.
+
 ### Vendor selection
 
 Vendor selection is handled in [`targets/CMakeLists.txt`](https://github.com/ARMmbed/mbed-os/blob/master/targets/CMakeLists.txt). The matching directory is added to directories to build.
@@ -32,35 +34,65 @@ add_subdirectory(TARGET_Cypress EXCLUDE_FROM_ALL)
 For example, the content of `targets/TARGET_Cypress/TARGET_PSOC6` can be listed as follows:
 
 ```
-if("SCL" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(COMPONENT_SCL EXCLUDE_FROM_ALL)
-endif()
+add_subdirectory(COMPONENT_SCL EXCLUDE_FROM_ALL)
 
-if("WHD" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(COMPONENT_WHD EXCLUDE_FROM_ALL)
-    add_subdirectory(common/COMPONENT_WHD EXCLUDE_FROM_ALL)
-endif()
 
-if("CY8CKIT064B0S2_4343W" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(TARGET_CY8CKIT064B0S2_4343W)
-elseif("CY8CKIT_062S2_43012" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(TARGET_CY8CKIT_062S2_43012)
+add_subdirectory(COMPONENT_WHD EXCLUDE_FROM_ALL)
+add_subdirectory(common/COMPONENT_WHD EXCLUDE_FROM_ALL)
+
+add_subdirectory(TARGET_CY8CKIT064B0S2_4343W EXCLUDE_FROM_ALL)
+add_subdirectory(TARGET_CY8CKIT_062S2_43012 EXCLUDE_FROM_ALL)
 ...
-endif()
+
+add_library(mbed-psoc6 INTERFACE)
 
 # Add the include directories accessible from this directory that are not specific to an MCU family or Mbed target
-target_include_directories(mbed-core
+target_include_directories(mbed-psoc6
     INTERFACE
         ...
 )
 
 # Add the source files accessible from this directory that are not specific to an MCU family or Mbed target
-target_sources(mbed-core
+target_sources(mbed-psoc6
     INTERFACE
         ...
 )
 ```
 
+The board target can link to `mbed-psoc6`. Let's take `mbed-cysbsyskit-01` target:
+
+```
+add_library(mbed-cysbsyskit-01 INTERFACE)
+
+target_include_directories(mbed-cysbsyskit-01
+    INTERFACE
+        .
+        device
+)
+
+target_sources(mbed-cysbsyskit-01
+    INTERFACE
+        PeripheralPins.c
+        cybsp.c
+)
+
+target_link_libraries(mbed-cysbsyskit-01
+    INTERFACE
+        mbed-cat1a
+        mbed-cysbsyskit-01-cm4
+        mbed-cysbsyskit-01-bsp-design-modus
+        mbed-psoc6
+        mbed-cy-psoc6-scl
+)
+
+target_compile_definitions(mbed-cysbsyskit-01
+    INTERFACE
+        "CY8C624AFNI_S2D43F"
+)
+
+mbed_post_build_psoc6_merge_hex("CYSBSYSKIT_01")
+```
+
 ## Add target's CMakeLists.txt
 
 Add `CMakeLists.txt` files to the top level directory of a given vendor directory. List all files found in the directory in this CMake input source file, adding additional CMake input source file if it is MCU or Mbed target specific and has a great number of files which will make the top level `CMakeLists.txt` too complex. Think when you decide to create functions in a computer software code to remove complexity.