# Copyright (c) 2019 Manivannan Sadhasivam
# Copyright (c) 2020 Andreas Sandberg
# SPDX-License-Identifier: Apache-2.0

description: |
  Semtech LLCC68 radio transceiver used with the Weihua application driver.

  This compatible intentionally differs from Zephyr's upstream
  semtech,llcc68 binding so the application-owned driver can coexist
  with Zephyr releases that ship a native LLCC68 binding and driver.

compatible: "semtech,llcc68-weihua"

include: spi-device.yaml

properties:
  reset-gpios:
    type: phandle-array
    required: true
    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: true
    description: |
      GPIO connected to the modem's BUSY signal.

  dio1-gpios:
    type: phandle-array
    required: true
    description: |
      GPIO connected to DIO1. This GPIO will be used as a generic
      IRQ line from the chip.

  tx-enable-gpios:
    type: phandle-array
    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
    description: |
      Antenna switch RX enable GPIO. If set, the driver tracks the
      state of the radio and controls the RF switch.

  rf-switch-mode:
    type: string
    enum:
      - "none"
      - "gpio-complementary"
      - "dio2-single"
    description: |
      Optional RF switch control mode.

      "none" disables RF switch handling.

      "gpio-complementary" controls TXEN/RXEN from MCU GPIOs using the
      complementary table:
        idle: TXEN=0, RXEN=0
        RX:   TXEN=0, RXEN=1
        TX:   TXEN=1, RXEN=0
      This mode requires tx-enable-gpios and rx-enable-gpios.

      "dio2-single" enables LLCC68 DIO2-as-RF-switch control for TXEN.
      RXEN must be externally pulled active or supplied as rx-enable-gpios,
      which the driver holds active. This mode must not use tx-enable-gpios.

  spi-cs-setup-delay-ns:
    default: 100000

  spi-cs-hold-delay-ns:
    default: 100000