EP_AGORA: Add config logic to enable BLE, cell, and LoRa by default

targets/TARGET_NORDIC/TARGET_NRF5x/TARGET_NRF52/TARGET_MCU_NRF52840/TARGET_EP_AGORA/ONBOARD_TELIT_ME910.cpp

@@ -0,0 +1,140 @@
+/* mbed Microcontroller Library
+ * Copyright (c) 2006-2019 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed 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.
+ */
+
+#if MBED_CONF_NSAPI_PRESENT
+
+#if EP_AGORA_ENABLE_CELL
+
+#include "cellular/onboard_modem_api.h"
+#include "UARTSerial.h"
+#include "ONBOARD_TELIT_ME910.h"
+#include "ThisThread.h"
+#include "CellularLog.h"
+
+using namespace mbed;
+
+ONBOARD_TELIT_ME910::ONBOARD_TELIT_ME910(FileHandle *fh) : TELIT_ME910(fh, PIN_NAME_CELL_ON_OFF, true)
+{
+}
+
+nsapi_error_t ONBOARD_TELIT_ME910::hard_power_on()
+{
+    ::onboard_modem_init();
+    return NSAPI_ERROR_OK;
+}
+
+nsapi_error_t ONBOARD_TELIT_ME910::hard_power_off()
+{
+    ::onboard_modem_deinit();
+    return NSAPI_ERROR_OK;
+}
+
+nsapi_error_t ONBOARD_TELIT_ME910::soft_power_on()
+{
+    ::onboard_modem_power_up();
+    // From Telit_xE910 Global form factor App note: It is mandatory to avoid sending data to the serial ports during the first 200ms of the module start-up.
+    rtos::ThisThread::sleep_for(200);
+    return NSAPI_ERROR_OK;
+}
+
+nsapi_error_t ONBOARD_TELIT_ME910::soft_power_off()
+{
+    ::onboard_modem_power_down();
+    return NSAPI_ERROR_OK;
+}
+
+nsapi_error_t ONBOARD_TELIT_ME910::init()
+{
+    nsapi_error_t err = AT_CellularDevice::init();
+    if (err != NSAPI_ERROR_OK) {
+        return err;
+    }
+    _at->lock();
+#if DEVICE_SERIAL_FC
+    _at->at_cmd_discard("&K3;&C1;&D0", "");
+#else
+    _at->at_cmd_discard("&K0;&C1;&D0", "");
+#endif
+
+    // AT#QSS=1
+    // Enable the Query SIM Status unsolicited indication in the ME. The format of the
+    // unsolicited indication is the following:
+    // #QSS: <status>
+    // The ME informs at
+    // every SIM status change through the basic unsolicited indication where <status> range is 0...1
+    // <status> values:
+    // - 0: SIM not inserted
+    // - 1: SIM inserted
+    _at->at_cmd_discard("#QSS", "=1");
+
+    // AT#PSNT=1
+    // Set command enables unsolicited result code for packet service network type (PSNT)
+    // having the following format:
+    // #PSNT:<nt>
+    // <nt> values:
+    // - 0: GPRS network
+    // - 4: LTE network
+    // - 5: unknown or not registered
+    _at->at_cmd_discard("#PSNT", "=1");
+
+    // AT+CMER=2
+    // Set command enables sending of unsolicited result codes from TA to TE in the case of
+    // indicator state changes.
+    // Current setting: buffer +CIEV Unsolicited Result Codes in the TA when TA-TE link is
+    // reserved (e.g. on-line data mode) and flush them to the TE after
+    // reservation; otherwise forward them directly to the TE
+    _at->at_cmd_discard("+CMER", "=2");
+
+    // AT+CMEE=2
+    // Set command disables the use of result code +CME ERROR: <err> as an indication of an
+    // error relating to the +Cxxx command issued. When enabled, device related errors cause the +CME
+    // ERROR: <err> final result code instead of the default ERROR final result code. ERROR is returned
+    // normally when the error message is related to syntax, invalid parameters or DTE functionality.
+    // Current setting: enable and use verbose <err> values
+    _at->at_cmd_discard("+CMEE", "=2");
+
+    // AT#PORTCFG=0
+    // Set command allows to connect Service Access Points to the external physical ports giving a great
+    // flexibility. Examples of Service Access Points: AT Parser Instance #1, #2, #3, etc..
+    _at->at_cmd_discard("#PORTCFG", "=3");
+
+    // AT&W&P
+    // - AT&W: Execution command stores on profile <n> the complete configuration of the device. If
+    //         parameter is omitted, the command has the same behavior of AT&W0.
+    // - AT&P: Execution command defines which full profile will be loaded at startup. If parameter
+    //         is omitted, the command has the same behavior as AT&P0
+    _at->at_cmd_discard("&W&P", "");
+
+    return _at->unlock_return_error();
+}
+
+CellularDevice *CellularDevice::get_target_default_instance()
+{
+    static UARTSerial serial(MDMTXD, MDMRXD, 115200);
+#if DEVICE_SERIAL_FC
+    if (MDMRTS != NC && MDMCTS != NC) {
+        tr_debug("Modem flow control: RTS %d CTS %d", MDMRTS, MDMCTS);
+        serial.set_flow_control(SerialBase::RTSCTS, MDMRTS, MDMCTS);
+    }
+#endif
+    static ONBOARD_TELIT_ME910 device(&serial);
+    return &device;
+}
+
+#endif // EP_AGORA_ENABLE_CELL
+
+#endif // MBED_CONF_NSAPI_PRESENT

targets/TARGET_NORDIC/TARGET_NRF5x/TARGET_NRF52/TARGET_MCU_NRF52840/TARGET_EP_AGORA/ONBOARD_TELIT_ME910.h

@@ -0,0 +1,38 @@
+/* mbed Microcontroller Library
+ * Copyright (c) 2006-2019 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed 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.
+ */
+
+#ifndef ONBOARD_TELIT_ME910_
+#define ONBOARD_TELIT_ME910_
+
+#include "TELIT_ME910.h"
+
+namespace mbed {
+
+class ONBOARD_TELIT_ME910 : public TELIT_ME910 {
+public:
+    ONBOARD_TELIT_ME910(FileHandle *fh);
+
+    virtual nsapi_error_t init();
+    virtual nsapi_error_t hard_power_on();
+    virtual nsapi_error_t hard_power_off();
+    virtual nsapi_error_t soft_power_on();
+    virtual nsapi_error_t soft_power_off();
+};
+
+} // namespace mbed
+
+#endif // ONBOARD_TELIT_ME910_

targets/TARGET_NORDIC/TARGET_NRF5x/TARGET_NRF52/TARGET_MCU_NRF52840/TARGET_EP_AGORA/mbed_lib.json

@@ -0,0 +1,15 @@
+{
+    "name": "ep-agora",
+    "config": {
+        "enable-cell" : {
+            "help"                 : "Enable the cell module on the EP_AGORA board",
+            "macro_name"           : "EP_AGORA_ENABLE_CELL",
+            "value"                : true
+        }
+    },
+    "target_overrides": {
+        "EP_AGORA": {
+            "target.network-default-interface-type": "CELLULAR"
+        }
+    }
+}

targets/TARGET_NORDIC/TARGET_NRF5x/TARGET_NRF52/TARGET_MCU_NRF52840/TARGET_EP_AGORA/onboard_modem_api.c

@@ -0,0 +1,73 @@
+/* mbed Microcontroller Library
+ * Copyright (c) 2006-2019 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed 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.
+ */
+
+#if MBED_CONF_NSAPI_PRESENT
+
+#include "cellular/onboard_modem_api.h"
+#include "gpio_api.h"
+#include "platform/mbed_thread.h"
+#include "PinNames.h"
+
+#if MODEM_ON_BOARD
+
+static void press_power_button(int time_ms)
+{
+    gpio_t gpio;
+
+    gpio_init_out_ex(&gpio, PIN_NAME_CELL_ON_OFF, 1);
+    gpio_write(&gpio, 0);
+    thread_sleep_for(time_ms);
+    gpio_write(&gpio, 1);
+}
+
+void onboard_modem_init()
+{
+    gpio_t gpio;
+
+    gpio_init_out_ex(&gpio, PIN_NAME_CELL_POWER_ENABLE, 0);
+    gpio_write(&gpio, 1);
+}
+
+void onboard_modem_deinit()
+{
+    gpio_t gpio;
+
+    gpio_init_out_ex(&gpio, PIN_NAME_CELL_POWER_ENABLE, 1);
+    gpio_write(&gpio, 0);
+}
+
+void onboard_modem_power_up()
+{
+    /* keep the power line low for 5 seconds */
+    press_power_button(5000);
+    /* give modem a little time to respond */
+    thread_sleep_for(20 * 1000);
+}
+
+void onboard_modem_power_down()
+{
+    gpio_t gpio;
+
+    gpio_init_out_ex(&gpio, PIN_NAME_CELL_ON_OFF, 0);
+    /* keep the power line low for more than 3 seconds.
+     * If 3G_ON_OFF pin is kept low for more than a second, a controlled disconnect and shutdown takes
+     * place, Due to the network disconnect, shut-off can take up to 30 seconds. However, we wait for 10
+     * seconds only   */
+    thread_sleep_for(10 * 1000);
+}
+#endif //MODEM_ON_BOARD
+#endif //MBED_CONF_NSAPI_PRESENT

targets/targets.json

@@ -9326,18 +9326,22 @@
         "config": {
             "modem_is_on_board": {
                 "help": "Value: Tells the build system that the modem is on-board as oppose to a plug-in shield/module.",
-                "value": 0,
+                "value": 1,
                 "macro_name": "MODEM_ON_BOARD"
             },
             "modem_data_connection_type": {
                 "help": "Value: Defines how an on-board modem is wired up to the MCU, e.g., data connection can be a UART or USB and so forth.",
-                "value": 0,
+                "value": 1,
                 "macro_name": "MODEM_ON_BOARD_UART"
             }
         },
         "components_add": ["SPIF"],
         "components_remove": ["QSPIF"],
-        "release_versions": ["5"]
+        "release_versions": ["5"],
+        "macros_add": [
+            "CONFIG_GPIO_AS_PINRESET",
+            "NRF52_ERRATA_20"
+        ]
     },
     "IM880B": {
         "inherits": ["FAMILY_STM32"],