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) > 0
+/*****************************************************************************
+ * $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)
@@ -4645,6 +4664,15 @@ static const struct shell_cmd btshell_commands[] = {
         .help = &gatt_clear_pending_notif_help,
 #endif
     },
+#if MYNEWT_VAL(BLE_EATT_CHAN_NUM) > 0
+    {
+        .sc_cmd = "gatt-eatt-connect",
+        .sc_cmd_func = cmd_gatt_eatt_connect,
+#if MYNEWT_VAL(SHELL_CMD_HELP)
+        .help = &gatt_eatt_connect_help,
+#endif
+    },
+#endif
 #if MYNEWT_VAL(BLE_L2CAP_COC_MAX_NUM)
     {
         .sc_cmd = "l2cap-update",

apps/btshell/src/cmd_gatt.c

@@ -664,3 +664,35 @@ cmd_gatt_clear_pending_notif(int argc, char **argv)
     return ENOTSUP;
 #endif
 }
+
+#if MYNEWT_VAL(BLE_EATT_CHAN_NUM) > 0
+/*****************************************************************************
+ * $gatt-eatt-connect                                                        *
+ *****************************************************************************/
+
+int
+cmd_gatt_eatt_connect(int argc, char **argv)
+{
+    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);
+}
+#endif

apps/btshell/src/cmd_gatt.h

@@ -38,5 +38,8 @@ 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);
+#if MYNEWT_VAL(BLE_EATT_CHAN_NUM) > 0
+int cmd_gatt_eatt_connect(int argc, char **argv);
+#endif
 
 #endif