Document and clean up wifi and LoRa modules, add ability in Python to get non-public targets (#247)

* Add a way to get target attributes for non public targets

* Document all WiFi and LoRa modules

* Fix some errors

* Fix another CMake error

Author: Jamie Smith

connectivity/drivers/802.15.4_RF/CMakeLists.txt

@@ -2,8 +2,8 @@
 # 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)
+macro(create_mbed_802_15_4_target)
+	if(NOT TARGET mbed-802.15.4-rf)
 		add_library(mbed-802.15.4-rf STATIC EXCLUDE_FROM_ALL)
 
 		# Nanostack drivers always require Mbed RTOS
@@ -14,29 +14,29 @@ macro(create_802_15_4_target)
 		        mbed-802.15.4-rf
 		)
 	endif()
-endmacro()
+endmacro(create_mbed_802_15_4_target)
 
 
 if("Freescale" IN_LIST MBED_TARGET_LABELS)
-	create_802_15_4_target()
+	create_mbed_802_15_4_target()
     add_subdirectory(TARGET_Freescale)
 elseif("Silicon_Labs" IN_LIST MBED_TARGET_LABELS)
-	create_802_15_4_target()
+	create_mbed_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()
+	create_mbed_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()
+	create_mbed_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()
+	create_mbed_802_15_4_target()
 	add_subdirectory(COMPONENT_STM_S2_LP)
 endif()
 

connectivity/drivers/wifi/CMakeLists.txt

@@ -1,20 +1,38 @@
 # Copyright (c) 2020-2021 ARM Limited. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
-add_library(mbed-wifi STATIC EXCLUDE_FROM_ALL)
+# The 'mbed-wifi' target is lazily created because there might not be any subdirectories needing it at all.
+macro(create_mbed_wifi_target)
+	if(NOT TARGET mbed-wifi)
+		add_library(mbed-wifi STATIC EXCLUDE_FROM_ALL)
 
-add_subdirectory(TARGET_WICED EXCLUDE_FROM_ALL)
+		target_link_libraries(mbed-wifi
+		    PUBLIC
+		        mbed-rtos-flags
+		        mbed-netsocket-api
+		)
+	endif()
+endmacro()
 
-add_subdirectory(TARGET_STM EXCLUDE_FROM_ALL)
+
+# The WICED subdirectory is for wifi drivers developed using Infineon WICED framework.
+# https://community.infineon.com/t5/Knowledge-Base-Articles/WICED-Wi-Fi-FAQ/ta-p/247356
+if("WICED" IN_LIST MBED_TARGET_LABELS)
+	create_mbed_wifi_target()
+    add_subdirectory(TARGET_WICED EXCLUDE_FROM_ALL)
+endif()
+
+if("STM" IN_LIST MBED_TARGET_LABELS)
+    add_subdirectory(TARGET_STM EXCLUDE_FROM_ALL)
+endif()
 
 if("WHD" IN_LIST MBED_TARGET_LABELS)
+	create_mbed_wifi_target()
     add_subdirectory(COMPONENT_WHD EXCLUDE_FROM_ALL)
 endif()
 
-add_subdirectory(esp8266-driver)
+if("COMPONENT_ESPRESSIF_ESP8266=1" IN_LIST MBED_TARGET_DEFINITIONS)
+	create_mbed_wifi_target()
+    add_subdirectory(COMPONENT_ESPRESSIF_ESP8266)
+endif()
 
-target_link_libraries(mbed-wifi
-    PUBLIC
-        mbed-rtos-flags
-        mbed-netsocket-api
-)

connectivity/drivers/wifi/esp8266-driver/CMakeLists.txt renamed to connectivity/drivers/wifi/COMPONENT_ESPRESSIF_ESP8266/CMakeLists.txt

@@ -6,7 +6,7 @@ The Mbed OS driver for the ESP8266 WiFi module.
 
 ESP8266 modules come in different shapes and formats, but the firmware version is the most important factor. To
 make sure that the firmware in your module is compatible with Mbed OS, follow the
-[Update guide](https://developer.mbed.org/teams/ESP8266/wiki/Firmware-Update).
+[Update guide](https://web.archive.org/web/20211025195109/https://os.mbed.com/teams/ESP8266/wiki/Firmware-Update).
 
 This driver supports AT firmware versions 1.3.0 to 1.7.0. We advise updating the
 [AT firmware](https://www.espressif.com/en/support/download/at?keys=) to at least version 1.7.0.