drivers, dts: Add drivers for Semtech LoRa transceivers LR11xx, SX126x

Those drivers are actually device tree bindings, and HAL/BSP as described
in https://github.com/Lora-net/SWL2001/blob/master/lbm_lib/PORTING_GUIDE.md

Signed-off-by: Félix Piédallu <[email protected]>

Author: Salamandar

drivers/CMakeLists.txt

@@ -1,3 +1,4 @@
+# Copyright (c) 2021 Nordic Semiconductor ASA
 # SPDX-License-Identifier: Apache-2.0
 
 # FIXME: SHADOW_VARS: Remove this once we have enabled -Wshadow globally.
@@ -58,6 +59,7 @@ add_subdirectory_ifdef(CONFIG_KSCAN kscan)
 add_subdirectory_ifdef(CONFIG_LED led)
 add_subdirectory_ifdef(CONFIG_LED_STRIP led_strip)
 add_subdirectory_ifdef(CONFIG_LORA lora)
+add_subdirectory_ifdef(CONFIG_LORA_BASICS_MODEM_DRIVERS lora_lbm)
 add_subdirectory_ifdef(CONFIG_MBOX mbox)
 add_subdirectory_ifdef(CONFIG_MDIO mdio)
 add_subdirectory_ifdef(CONFIG_MEMC memc)

drivers/Kconfig

@@ -53,6 +53,7 @@ source "drivers/kscan/Kconfig"
 source "drivers/led/Kconfig"
 source "drivers/led_strip/Kconfig"
 source "drivers/lora/Kconfig"
+source "drivers/lora_lbm/Kconfig"
 source "drivers/mbox/Kconfig"
 source "drivers/mdio/Kconfig"
 source "drivers/memc/Kconfig"

drivers/lora_lbm/CMakeLists.txt

@@ -0,0 +1,30 @@
+# Copyright (c) 2024 Semtech Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+zephyr_library()
+
+# Disable all warnings for Semtech code.
+#
+# Zephyr is compiled with a lot more warnings enabled then the basics modem.
+# Since we copy the Basics Modem directly with no modifications, the warnings clog up
+# the build output in our applications.
+# zephyr_library_compile_options(-w)
+
+if(CONFIG_SEMTECH_LR11XX)
+  # Library flag that disables some warnings
+  zephyr_library_compile_definitions(LR11XX_DISABLE_WARNINGS)
+
+  zephyr_library_sources(lr11xx/lr11xx_board.c lr11xx/lr11xx_hal.c)
+
+  zephyr_library_sources_ifdef(CONFIG_LORA_BASICS_MODEM_DRIVERS_RAL_RALF
+    lr11xx/lr11xx_ral_bsp.c lr11xx/lr11xx_ral_bsp_calibration.c
+  )
+endif()
+
+if(CONFIG_SEMTECH_SX126X)
+  zephyr_library_sources(sx126x/sx126x_hal.c sx126x/sx126x_board.c)
+
+  zephyr_library_sources_ifdef(CONFIG_LORA_BASICS_MODEM_DRIVERS_RAL_RALF
+    sx126x/sx126x_ral_bsp.c
+  )
+endif()

drivers/lora_lbm/Kconfig

@@ -0,0 +1,85 @@
+# LoRa Basics Modem drivers configuration options
+#
+# Copyright (c) 2024 Semtech Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+# NOTE: Might be renamed LORA_DRIVERS for upstreaming
+
+menuconfig LORA_BASICS_MODEM_DRIVERS
+	bool "LoRa drivers from the new LoRa Basics Modem stack [EXPERIMENTAL]"
+	select POLL
+	select EXPERIMENTAL
+	select ZEPHYR_LORA_BASICS_MODEM_MODULE
+	depends on !LORA
+	help
+	  Include LoRa drivers from the new LoRa Basics Modem stack in the system configuration.
+
+if LORA_BASICS_MODEM_DRIVERS
+
+module = LORA_BASICS_MODEM_DRIVERS
+module-str = lora-lbm
+source "subsys/logging/Kconfig.template.log_config"
+
+rsource "Kconfig.lr11xx"
+rsource "Kconfig.sx12xx"
+
+config LORA_BASICS_MODEM_DRIVERS_INIT_PRIORITY
+	int "Init priority"
+	default 50
+
+
+config LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER
+	bool
+
+choice
+	prompt "Event trigger mode"
+	default LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_GLOBAL_THREAD
+	help
+	  Specify the type of triggering to be used by the LORA_BASICS_MODEM_DRIVERS driver.
+
+config LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_NONE
+	bool "No trigger on event"
+
+config LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_GLOBAL_THREAD
+	bool "Use global thread"
+	depends on GPIO
+	select LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER
+
+config LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_OWN_THREAD
+	bool "Use own thread"
+	depends on GPIO
+	select LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER
+
+endchoice
+
+config LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_THREAD_PRIORITY
+	int "Thread priority"
+	depends on LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_OWN_THREAD
+	default 10
+	help
+	  Priority of thread used by the driver to handle interrupts.
+
+config LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_THREAD_STACK_SIZE
+	int "Thread stack size"
+	depends on LORA_BASICS_MODEM_DRIVERS_EVENT_TRIGGER_OWN_THREAD
+	default 1024
+	help
+	  Stack size of thread used by the driver to handle interrupts.
+
+config LORA_BASICS_MODEM_DRIVERS_HAL_WAIT_ON_BUSY_TIMEOUT_MSEC
+	int "Time to wait on BUSY pin in ms before aborting"
+	default 600000
+	help
+	  Busy pin wait time in milliseconds. As WiFi and GPS scanning can take
+	  seconds/minutes, the default is set to 10 minutes.
+
+
+config LORA_BASICS_MODEM_DRIVERS_RAL_RALF
+	bool "LoRa Radio Abstraction Layer from the new LoRa Basics Modem stack"
+	default y
+	help
+	  Include the Radio Abstraction Layer from the new LoRa Basics Modem stack
+
+# TODO: LORA_SHELL
+
+endif # LORA_BASICS_MODEM_DRIVERS

drivers/lora_lbm/Kconfig.lr11xx

@@ -0,0 +1,21 @@
+# Copyright (c) 2024 Semtech Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+# LoRa transceiver drivers configuration options
+
+config SEMTECH_LR11XX
+	bool "Semtech LR11xx family LoRa transceiver driver"
+	default y
+	depends on DT_HAS_SEMTECH_LR1110_ENABLED || DT_HAS_SEMTECH_LR1120_ENABLED || DT_HAS_SEMTECH_LR1121_ENABLED
+	select SPI
+	select GPIO
+	help
+	  Enable driver for the LR11xx family LoRa transceiver driver
+
+
+if SEMTECH_LR11XX
+
+config LR11XX_USE_CRC_OVER_SPI
+	bool "Use CRC over SPI communication"
+
+endif # SEMTECH_LR11XX

drivers/lora_lbm/Kconfig.sx12xx

@@ -0,0 +1,13 @@
+# Copyright (c) 2024 Semtech Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+# LoRa transceiver drivers configuration options
+
+config SEMTECH_SX126X
+	bool "Semtech SX126x family LoRa transceiver driver"
+	default y
+	depends on DT_HAS_SEMTECH_SX1261_NEW_ENABLED || DT_HAS_SEMTECH_SX1262_NEW_ENABLED || DT_HAS_SEMTECH_SX1268_NEW_ENABLED || DT_HAS_ST_STM32WL_SUBGHZ_RADIO_ENABLED
+	select SPI
+	select GPIO
+	help
+	  Enable driver for the SX126x family and stm32wl embedded LoRa transceiver driver