WIP: device tree MVP

dts/bindings/lora/semtech,sx1261.yaml

@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Andreas Sandberg
+# SPDX-License-Identifier: Apache-2.0
+
+description: Semtech SX1261 LoRa Modem
+
+compatible: "semtech,sx1261"
+
+include: semtech,sx126x-base.yaml
+
+properties:
+    reset-gpios:
+      required: true
+    busy-gpios:
+      required: true
+    dio1-gpios:
+      required: true

dts/bindings/lora/semtech,sx1262.yaml

@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Andreas Sandberg
+# SPDX-License-Identifier: Apache-2.0
+
+description: Semtech SX1262 LoRa Modem
+
+compatible: "semtech,sx1262"
+
+include: semtech,sx126x-base.yaml
+
+properties:
+    reset-gpios:
+      required: true
+    busy-gpios:
+      required: true
+    dio1-gpios:
+      required: true

dts/bindings/lora/semtech,sx126x-base.yaml

@@ -0,0 +1,70 @@
+# Copyright (c) 2019 Manivannan Sadhasivam
+# Copyright (c) 2020 Andreas Sandberg
+# SPDX-License-Identifier: Apache-2.0
+
+include: spi-device.yaml
+
+properties:
+    reset-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        GPIO connected to the modem's NRESET signal.
+
+        This signal is open-drain, active-low as interpreted by the
+        modem.
+
+    busy-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        GPIO connected to the modem's BUSY signal.
+
+    antenna-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        Antenna power enable pin.
+
+    tx-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        Antenna switch TX enable GPIO. If set, the driver tracks the
+        state of the radio and controls the RF switch.
+
+    rx-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        Antenna switch RX enable GPIO. If set, the driver tracks the
+        state of the radio and controls the RF switch.
+
+    dio1-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        GPIO connected to DIO1. This GPIO will be used as a generic
+        IRQ line from the chip.
+
+    dio2-tx-enable:
+      type: boolean
+      required: false
+      description: |
+        Use DIO2 to drive an RF switch selecting between the TX and RX
+        paths. When enabled, DIO2 goes high when the chip is
+        transmitting.
+
+    dio3-tcxo-voltage:
+      type: int
+      required: false
+      description: |
+        TCXO supply voltage controlled by DIO3 if present.
+
+        See constants in dt-bindings/lora/sx126x.h.
+
+    tcxo-power-startup-delay-ms:
+      type: int
+      required: false
+      description: |
+        Startup delay to let the TCXO stabilize after TCXO power on.

dts/bindings/lora/semtech,sx1272.yaml

@@ -0,0 +1,8 @@
+# Copyright (c) 2021, Ilya Tagunov
+# SPDX-License-Identifier: Apache-2.0
+
+description: Semtech SX1272 LoRa Modem
+
+compatible: "semtech,sx1272"
+
+include: semtech,sx127x-base.yaml

dts/bindings/lora/semtech,sx1276.yaml

@@ -0,0 +1,8 @@
+# Copyright (c) 2021, Ilya Tagunov
+# SPDX-License-Identifier: Apache-2.0
+
+description: Semtech SX1276 LoRa Modem
+
+compatible: "semtech,sx1276"
+
+include: semtech,sx127x-base.yaml

dts/bindings/lora/semtech,sx127x-base.yaml

@@ -0,0 +1,70 @@
+# Copyright (c) 2019, Manivannan Sadhasivam
+# Copyright (c) 2020, Grinn
+# SPDX-License-Identifier: Apache-2.0
+
+include: spi-device.yaml
+
+properties:
+    reset-gpios:
+      type: phandle-array
+      required: true
+      description: |
+        GPIO connected to the modem's RESET/NRESET signal.
+
+        This signal is open-drain, active-high (SX1272/3) or
+        active-low (SX1276/7/8/9) as interpreted by the modem.
+
+    dio-gpios:
+      type: phandle-array
+      required: true
+      description: |
+        Up to six pins that produce service interrupts from the modem.
+
+        These signals are normally active-high.
+
+    power-amplifier-output:
+      type: string
+      required: false
+      description: |
+        Selects power amplifier output pin. This is required when neither
+        'rfo-enable-gpios' nor 'pa-boost-enable-gpios' is specified. In other
+        case this property is simply ignored.
+      enum:
+         - "rfo"
+         - "pa-boost"
+
+    antenna-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        Antenna power enable pin.
+
+    rfi-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        RFI antenna input enable pin.
+
+    rfo-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        RFO antenna output enable pin.
+
+    pa-boost-enable-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        PA_BOOST antenna output enable pin.
+
+    tcxo-power-gpios:
+      type: phandle-array
+      required: false
+      description: |
+        TCXO power enable pin.
+
+    tcxo-power-startup-delay-ms:
+      type: int
+      required: false
+      description: |
+        Delay which has to be applied after enabling TCXO power.

dts/bindings/lora/st,stm32wl-subghz-radio.yaml

@@ -0,0 +1,14 @@
+# Copyright (c) 2021 Fabio Baltieri
+# SPDX-License-Identifier: Apache-2.0
+
+description: STM32WL SUBGHZ Radio
+
+compatible: "st,stm32wl-subghz-radio"
+
+include: semtech,sx126x-base.yaml
+
+properties:
+    interrupts:
+      required: true
+      description: |
+        Position of the "Radio IRQ, Busy" interrupt line.