btshell: Add EATT connect shell command

Introduc a new shell command `gatt_eatt_connect` to allow manual
connection of multiple EATT channels per connection.

The command parses the connection handle and requested number of channels,
displays basic usage help, and calls the internal `ble_eatt_connect()` API.

Register the command in the shell, add parameter descriptions and
declaration in `cmd_gatt.h`.

Author: szymon-czapracki

apps/btshell/src/cmd.c

@@ -3568,6 +3568,25 @@ static const struct shell_cmd_help gatt_clear_pending_notif_help = {
     .usage = NULL,
     .params = NULL,
 };
+
+#if MYNEWT_VAL(BLE_EATT_CHAN_NUM)
+/*****************************************************************************
+ * $gatt-eatt-connect                                                        *
+ *****************************************************************************/
+
+static const struct shell_param gatt_eatt_connect_params[] = {
+    {"conn", "connection handle, usage: =<UINT16>"},
+    {"chan_num", "number of channels to connect, usage =<UINT16>"},
+    {NULL, NULL}
+};
+
+static const struct shell_cmd_help gatt_eatt_connect_help = {
+        .summary = "Connect EATT channels",
+        .usage = NULL,
+        .params = gatt_eatt_connect_params,
+};
+#endif
+
 #endif
 
 #if MYNEWT_VAL(BLE_L2CAP_COC_MAX_NUM)
@@ -4643,6 +4662,13 @@ static const struct shell_cmd btshell_commands[] = {
         .sc_cmd_func = cmd_gatt_clear_pending_notif,
 #if MYNEWT_VAL(SHELL_CMD_HELP)
         .help = &gatt_clear_pending_notif_help,
+#endif
+    },
+    {
+        .sc_cmd = "gatt-eatt-connect",
+        .sc_cmd_func = cmd_gatt_eatt_connect,
+#if MYNEWT_VAL(SHELL_CMD_HELP)
+        .help = &gatt_eatt_connect_help,
 #endif
     },
 #if MYNEWT_VAL(BLE_L2CAP_COC_MAX_NUM)

apps/btshell/src/cmd_gatt.c

@@ -664,3 +664,37 @@ cmd_gatt_clear_pending_notif(int argc, char **argv)
     return ENOTSUP;
 #endif
 }
+
+/*****************************************************************************
+ * $gatt-eatt-connect                                                        *
+ *****************************************************************************/
+
+int cmd_gatt_eatt_connect(int argc, char **argv)
+{
+#if MYNEWT_VAL(BLE_EATT_CHAN_NUM)
+    uint16_t conn_handle;
+    uint16_t chan_num;
+    int rc;
+
+    rc = parse_arg_init(argc - 1, argv + 1);
+    if (rc != 0) {
+        return rc;
+    }
+
+    conn_handle = parse_arg_uint16("conn", &rc);
+    if (rc != 0) {
+        console_printf("invalid 'conn' parameter\n");
+        return rc;
+    }
+
+    chan_num = parse_arg_uint16("chan_num", &rc);
+    if (rc != 0) {
+        console_printf("invalid 'chan_num' parameter\n");
+        return rc;
+    }
+    return ble_eatt_connect(conn_handle, chan_num);
+#else
+    console_printf("To enable this features set BLE_EATT_CHAN_NUM\n");
+    return ENOTSUP;
+#endif
+}

apps/btshell/src/cmd_gatt.h

@@ -38,5 +38,6 @@ int cmd_gatt_write(int argc, char **argv);
 int cmd_gatt_enqueue_notif(int argc, char **argv);
 int cmd_gatt_send_pending_notif(int argc, char **argv);
 int cmd_gatt_clear_pending_notif(int argc, char **argv);
+int cmd_gatt_eatt_connect(int argc, char **argv);
 
 #endif