Add NimBLEClient::cancelConnect

Adds a function to cancel and in-progress connection.

src/NimBLEClient.cpp

@@ -369,6 +369,21 @@ bool NimBLEClient::disconnect(uint8_t reason) {
     return true;
 } // disconnect
 
+/**
+ * @brief Cancel an ongoing connection attempt.
+ * @return True if the command was successfully sent.
+ */
+bool NimBLEClient::cancelConnect() {
+    int rc = ble_gap_conn_cancel();
+    if (rc != 0 && rc != BLE_HS_EALREADY) {
+        NIMBLE_LOGE(LOG_TAG, "ble_gap_conn_cancel failed: rc=%d %s", rc, NimBLEUtils::returnCodeToString(rc));
+        m_lastErr = rc;
+        return false;
+    }
+
+    return true;
+} // cancelConnect
+
 # if CONFIG_BT_NIMBLE_EXT_ADV
 /**
  * @brief Set the PHY types to use when connecting to a server.

src/NimBLEClient.h

@@ -51,6 +51,7 @@ class NimBLEClient {
     bool connect(const NimBLEAddress& address, bool deleteAttributes = true, bool asyncConnect = false, bool exchangeMTU = true);
     bool           connect(bool deleteAttributes = true, bool asyncConnect = false, bool exchangeMTU = true);
     bool           disconnect(uint8_t reason = BLE_ERR_REM_USER_CONN_TERM);
+    bool           cancelConnect();
     NimBLEAddress  getPeerAddress() const;
     bool           setPeerAddress(const NimBLEAddress& address);
     int            getRssi() const;