nimble/plna: Add driver for SKY66112

This adds support for SKY66112 front-end module (PA/LNA).

CTX and CRX signals are controller by phy and shall be configured using
LL syscfg settings for PA/LNA. Other signals can be configured via GPIO
or simply driven externally to spare GPIO pins. It's possible to use PA
or LNA only, in such case CPS signal has to be driven via GPIO.

Author: andrzej-kaczmarek

nimble/drivers/plna/sky66112/pkg.yml

@@ -0,0 +1,31 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+pkg.name: nimble/drivers/plna/sky66112
+pkg.description: Driver for SKY66112 front-end module
+pkg.author: "Apache Mynewt <[email protected]>"
+pkg.homepage: "https://mynewt.apache.org/"
+pkg.apis:
+    - ble_ll_pa
+    - ble_ll_lna
+pkg.deps:
+    - nimble/controller
+
+pkg.init:
+    sky66112_init: 999

nimble/drivers/plna/sky66112/src/sky66112.c

@@ -0,0 +1,117 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+#include <assert.h>
+#include <stdint.h>
+#include "syscfg/syscfg.h"
+#include "hal/hal_gpio.h"
+#include "controller/ble_ll_plna.h"
+
+#define NO_BYPASS \
+        ((MYNEWT_VAL(SKY66112_TX_BYPASS) >= 0) && \
+         (MYNEWT_VAL(SKY66112_RX_BYPASS) >= 0))
+
+static void
+sky66112_bypass(uint8_t enabled)
+{
+    if (NO_BYPASS) {
+        return;
+    }
+
+    hal_gpio_write(MYNEWT_VAL(SKY66112_PIN_CPS), enabled);
+}
+
+void
+ble_ll_plna_pa_init(void)
+{
+    /* Nothing to do here */
+}
+
+void
+ble_ll_plna_pa_enable(void)
+{
+    if (!MYNEWT_VAL(SKY66112_TX_BYPASS)) {
+        sky66112_bypass(0);
+    }
+}
+
+void
+ble_ll_plna_pa_disable(void)
+{
+    if (!MYNEWT_VAL(SKY66112_TX_BYPASS)) {
+        sky66112_bypass(1);
+    }
+}
+
+void
+ble_ll_plna_lna_init(void)
+{
+    /* Nothing to do here */
+}
+
+void
+ble_ll_plna_lna_enable(void)
+{
+    if (!MYNEWT_VAL(SKY66112_RX_BYPASS)) {
+        sky66112_bypass(0);
+    }
+}
+
+void
+ble_ll_plna_lna_disable(void)
+{
+    if (!MYNEWT_VAL(SKY66112_RX_BYPASS)) {
+        sky66112_bypass(1);
+    }
+}
+
+void
+sky66112_init(void)
+{
+    int pin;
+
+    /* Use CRX and CTX to enable sleep mode */
+    pin = MYNEWT_VAL(SKY66112_PIN_CSD);
+    if (pin >= 0) {
+        hal_gpio_init_out(pin, 1);
+    }
+
+    pin = MYNEWT_VAL(SKY66112_PIN_CPS);
+    if (NO_BYPASS) {
+        /* Disable bypass */
+        if (pin >= 0) {
+            hal_gpio_init_out(pin, 0);
+        }
+    } else {
+        /* Enable bypass, we'll disable it when needed */
+        assert(pin >= 0);
+        hal_gpio_init_out(pin, 1);
+    }
+
+    pin = MYNEWT_VAL(SKY66112_PIN_CHL);
+    if (pin >= 0) {
+        hal_gpio_init_out(pin, MYNEWT_VAL(SKY66112_TX_HP_MODE));
+    }
+
+    /* Select ANT1 */
+    pin = MYNEWT_VAL(SKY66112_PIN_SEL);
+    if (pin >= 0) {
+        hal_gpio_init_out(pin, 0);
+    }
+}

nimble/drivers/plna/sky66112/syscfg.yml

@@ -0,0 +1,66 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+syscfg.defs:
+    SKY66112_PIN_CSD:
+        description: >
+            GPIO pin number to control CSD signal.
+            When set to '-1', pin state will not be changed and it should be
+            driven externally.
+        value: -1
+    SKY66112_PIN_CPS:
+        description: >
+            GPIO pin number to control CPS signal.
+            When set to '-1', pin state will not be changed and it should be
+            driven externally.
+        value: -1
+    SKY66112_PIN_CHL:
+        description: >
+            GPIO pin number to control CHL signal.
+            When set to '-1', pin state will not be changed and it should be
+            driven externally.
+        value: -1
+    SKY66112_PIN_SEL:
+        description: >
+            GPIO pin number to control SEL signal.
+            When set to '-1', pin state will not be changed and it should be
+            driven externally.
+        value: -1
+    SKY66112_TX_HP_MODE:
+        description: >
+            Enables high-power mode for TX.
+            Only valid if CHL signal is controller by driver.
+        value: 0
+    SKY66112_TX_BYPASS:
+        description: >
+            Enables bypass for TX which effectively disables operation as PA.
+            Only valid if CPS signal is controller by driver.
+        value: 0
+    SKY66112_RX_BYPASS:
+        description: >
+            Enables bypass for RX which effectively disables operation as PA.
+            Only valid if CPS signal is controller by driver.
+        value: 0
+
+syscfg.vals.!BLE_LL_PA:
+    # Enable TX bypass by default if PA is disabled
+    SKY66112_TX_BYPASS: 1
+
+syscfg.vals.!BLE_LL_LNA:
+    # Enable RX bypass by default if LNA is disabled
+    SKY66112_RX_BYPASS: 1