Begin documenting Mbed OS target features and components (#240)

* Start on documenting features and components

* Missed some renames

* Go through all cellular and 802.15.4 modules

* Fix build

* Fix style

* Update copyright year

connectivity/drivers/802.15.4_RF/CMakeLists.txt

@@ -1,22 +1,43 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+# The 'mbed-802.15.4-rf' target is lazily created because there might not be any subdirectories needing it at all.
+macro(create_802_15_4_target)
+	if(NOT TARGET create_802_15_4_target)
 		add_library(mbed-802.15.4-rf STATIC EXCLUDE_FROM_ALL)
 
-target_link_libraries(mbed-802.15.4-rf PUBLIC mbed-core-flags)
+		# Nanostack drivers always require Mbed RTOS
-
+		target_link_libraries(mbed-802.15.4-rf PUBLIC mbed-core-flags mbed-rtos-flags)
-if("Freescale" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(TARGET_Freescale)
-    add_subdirectory(mcr20a-rf-driver)
-elseif("Silicon_Labs" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(TARGET_Silicon_Labs)
-elseif("STM" IN_LIST MBED_TARGET_LABELS)
-    add_subdirectory(stm-s2lp-rf-driver)
-endif()
-
-add_subdirectory(atmel-rf-driver)
 
 		target_link_libraries(mbed-nanostack
 		    INTERFACE
 		        mbed-802.15.4-rf
 		)
+	endif()
+endmacro()
+
+
+if("Freescale" IN_LIST MBED_TARGET_LABELS)
+	create_802_15_4_target()
+    add_subdirectory(TARGET_Freescale)
+elseif("Silicon_Labs" IN_LIST MBED_TARGET_LABELS)
+	create_802_15_4_target()
+    add_subdirectory(TARGET_Silicon_Labs)
+endif()
+
+if("COMPONENT_MICROCHIP_AT86RF=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	create_802_15_4_target()
+	add_subdirectory(COMPONENT_MICROCHIP_AT86RF)
+endif()
+
+if("COMPONENT_NXP_MCR20A=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	create_802_15_4_target()
+	add_subdirectory(COMPONENT_NXP_MCR20A)
+endif()
+
+if("COMPONENT_STM_S2_LP=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	create_802_15_4_target()
+	add_subdirectory(COMPONENT_STM_S2_LP)
+endif()
+
+

connectivity/drivers/cellular/Altair/CMakeLists.txt

@@ -1,4 +1,6 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-add_subdirectory(ALT1250)
+if("COMPONENT_ALTAIR_ALT1250=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	add_subdirectory(COMPONENT_ALTAIR_ALT1250)
+endif()

connectivity/drivers/cellular/CMakeLists.txt

@@ -1,7 +1,7 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-if("STMOD_CELLULAR" IN_LIST MBED_TARGET_LABELS)
+if("COMPONENT_STMOD_CELLULAR=1" IN_LIST MBED_TARGET_DEFINITIONS)
     add_subdirectory(COMPONENT_STMOD_CELLULAR)
 endif()
 
@@ -12,9 +12,3 @@ add_subdirectory(MultiTech)
 add_subdirectory(QUECTEL)
 add_subdirectory(RiotMicro)
 add_subdirectory(TELIT)
-add_subdirectory(UBLOX)
-
-target_include_directories(mbed-cellular
-    PUBLIC
-        .
-)

connectivity/drivers/cellular/GEMALTO/CMakeLists.txt

@@ -1,4 +1,6 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+if("COMPONENT_GEMALTO_CINTERION=1" IN_LIST MBED_TARGET_DEFINITIONS)
 	add_subdirectory(CINTERION)
+endif()

connectivity/drivers/cellular/GENERIC/CMakeLists.txt

@@ -1,4 +1,6 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-add_subdirectory(GENERIC_AT3GPP)
+if("COMPONENT_GENERIC_AT3GPP=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	add_subdirectory(COMPONENT_GENERIC_AT3GPP)
+endif()

connectivity/drivers/cellular/MultiTech/CMakeLists.txt

@@ -1,4 +1,6 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-add_subdirectory(DragonflyNano)
+if("COMPONENT_MULTITECH_DRAGONFLY_NANO_CELLULAR=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	add_subdirectory(COMPONENT_MULTITECH_DRAGONFLY_NANO_CELLULAR)
+endif()

connectivity/drivers/cellular/MultiTech/DragonflyNano/COMPONENT_MULTITECH_DRAGONFLY_NANO_CELLULAR/CMakeLists.txt

@@ -11,3 +11,7 @@ target_sources(mbed-cellular
         SARA4_PPP.cpp
         SARA4_PPP_CellularNetwork.cpp
 )
+
+if("MTS_DRAGONFLY_L471QG" IN_LIST MBED_TARGET_LABELS)
+	add_subdirectory(TARGET_MTS_DRAGONFLY_L471QG)
+endif()

connectivity/drivers/cellular/MultiTech/DragonflyNano/COMPONENT_MULTITECH_DRAGONFLY_NANO_CELLULAR/TARGET_MTS_DRAGONFLY_L471QG/CMakeLists.txt

@@ -1,4 +1,4 @@
-# Copyright (c) 2020 ARM Limited. All rights reserved.
+# Copyright (c) 2024 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 target_include_directories(mbed-cellular
@@ -8,5 +8,5 @@ target_include_directories(mbed-cellular
 
 target_sources(mbed-cellular
     PRIVATE
-        TELIT_HE910.cpp
+        ONBOARD_SARA4_PPP.cpp
 )

connectivity/drivers/cellular/QUECTEL/CMakeLists.txt

@@ -1,8 +1,23 @@
 # Copyright (c) 2020 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-add_subdirectory(BC95)
+if("COMPONENT_QUECTEL_EC2X=1" IN_LIST MBED_TARGET_DEFINITIONS)
-add_subdirectory(BG96)
+	add_subdirectory(COMPONENT_QUECTEL_EC2X)
-add_subdirectory(EC2X)
+endif()
-add_subdirectory(M26)
+
-add_subdirectory(UG96)
+if("COMPONENT_QUECTEL_BG96=1" IN_LIST MBED_TARGET_DEFINITIONS OR ("COMPONENT_STMOD_CELLULAR=1" IN_LIST MBED_TARGET_DEFINITIONS AND "MBED_CONF_STMOD_CELLULAR_TYPE=STMOD_BG96"))
+	add_subdirectory(COMPONENT_QUECTEL_BG96)
+endif()
+
+if("COMPONENT_QUECTEL_UG96=1" IN_LIST MBED_TARGET_DEFINITIONS OR ("COMPONENT_STMOD_CELLULAR=1" IN_LIST MBED_TARGET_DEFINITIONS AND "MBED_CONF_STMOD_CELLULAR_TYPE=STMOD_UG96"))
+	add_subdirectory(COMPONENT_QUECTEL_UG96)
+endif()
+
+if("COMPONENT_QUECTEL_BC95=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	add_subdirectory(COMPONENT_QUECTEL_BC95)
+endif()
+
+if("COMPONENT_QUECTEL_M26=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	add_subdirectory(COMPONENT_QUECTEL_M26)
+endif()
+

connectivity/drivers/cellular/QUECTEL/COMPONENT_QUECTEL_BC95/CMakeLists.txt

@@ -14,3 +14,7 @@ target_sources(mbed-cellular
         QUECTEL_BC95_CellularNetwork.cpp
         QUECTEL_BC95_CellularStack.cpp
 )
+
+if("TARGET_ADV_WISE_1570" IN_LIST MBED_TARGET_LABELS)
+	add_subdirectory(TARGET_ADV_WISE_1570)
+endif()

connectivity/drivers/cellular/QUECTEL/COMPONENT_QUECTEL_BC95/TARGET_ADV_WISE_1570/CMakeLists.txt

@@ -0,0 +1,12 @@
+# Copyright (c) 2024 ARM Limited. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+target_include_directories(mbed-cellular
+    PUBLIC
+        .
+)
+
+target_sources(mbed-cellular
+    PRIVATE
+        ONBOARD_QUECTEL_BC95.cpp
+)

connectivity/drivers/cellular/QUECTEL/COMPONENT_QUECTEL_BG96/CMakeLists.txt

@@ -15,3 +15,7 @@ target_sources(mbed-cellular
         QUECTEL_BG96_CellularStack.cpp
         QUECTEL_BG96_ControlPlane_netif.cpp
 )
+
+if("TARGET_WIO_BG96" IN_LIST MBED_TARGET_LABELS)
+	add_subdirectory(TARGET_WIO_BG96)
+endif()