apps/wireless/bluetooth/btsak: Add initial implementation of adverise commands.

wireless/bluetooth/btsak/Makefile

@@ -46,7 +46,7 @@ STACKSIZE = 4096
 # Bluetooth SAK (Swiss Army Knife)
 
 ASRCS =
-CSRCS = btsak_scan.c
+CSRCS = btsak_advertise.c btsak_scan.c
 MAINSRC = btsak_main.c
 
 AOBJS = $(ASRCS:.S=$(OBJEXT))

wireless/bluetooth/btsak/btsak_advertise.c

@@ -0,0 +1,240 @@
+/****************************************************************************
+ * apps/wireless/bluetooth/btsak/btsak_advertise.c
+ * Bluetooth Swiss Army Knife -- Advertise command
+ *
+ *   Copyright (C) 2018 Gregory Nutt. All rights reserved.
+ *   Author:  Gregory Nutt <gnutt@nuttx.org>
+ *
+ * Based loosely on the i8sak IEEE 802.15.4 program by Anthony Merlino and
+ * Sebastien Lorquet.  Commands inspired for btshell example in the
+ * Intel/Zephyr Arduino 101 package (BSD license).
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ *    used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ ****************************************************************************/
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <sys/ioctl.h>
+#include <stdbool.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <strings.h>
+#include <errno.h>
+
+#include <nuttx/wireless/bt_ioctl.h>
+
+#include "btsak.h"
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+#if !defined(CONFIG_BTSAK_NINSTANCES) || CONFIG_BTSAK_NINSTANCES <= 0
+#  undef CONFIG_BTSAK_NINSTANCES
+#  define CONFIG_BTSAK_NINSTANCES 3
+#endif
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+/* Describes one command */
+
+struct btsak_command_s
+{
+  FAR const char *name;
+  CODE void (*handler)(FAR struct btsak_s *btsak, int argc, FAR char *argv[]);
+  FAR const char *help;
+};
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: btsak_advertise_showusage
+ *
+ * Description:
+ *   Show usage of the advertise command
+ *
+ ****************************************************************************/
+
+static void btsak_advertise_showusage(FAR const char *progname,
+                                      FAR const char *cmd, int exitcode)
+{
+  fprintf(stderr, "%s:  Advertise commands:\n", cmd);
+  fprintf(stderr, "Usage:\n\n");
+  fprintf(stderr, "\t%s <ifname> %s [-h] <start|stop>\n",
+          progname, cmd);
+  fprintf(stderr, "\nWhere the options do the following:\n\n");
+  fprintf(stderr, "\tstart\t- Starts advertising (type ADV_IND).\n");
+  fprintf(stderr, "\tstop\t- Stops advertising\n");
+  exit(exitcode);
+}
+
+/****************************************************************************
+ * Name: btsak_cmd_advertisestart
+ *
+ * Description:
+ *   Scan start command
+ *
+ ****************************************************************************/
+
+static void btsak_cmd_advertisestart(FAR struct btsak_s *btsak, FAR char *cmd,
+                                     int argc, FAR char *argv[])
+{
+  struct bt_advertisestart_s start;
+  int sockfd;
+  int ret;
+
+  /* REVISIT:  Should support all advertising type.  Only ADV_IND is
+   * supported:
+   *
+   * ADV_IND 
+   *   Known as Advertising Indications (ADV_IND), where a peripheral device
+   *   requests connection to any central device (i.e., not directed at a
+   *   particular central device).  
+   *   Example:  A smart watch requesting connection to any central device. 
+   * ADV_DIRECT_IND 
+   *   Similar to ADV_IND, yet the connection request is directed at a
+   *   specific central device.
+   *   Example: A smart watch requesting connection to a specific central
+   *   device.
+   * ADV_NONCONN_IND 
+   *   Non connectible devices, advertising information to any listening
+   *   device.
+   *   Example:  Beacons in museums defining proximity to specific exhibits.
+   * ADV_SCAN_IND 
+   *   Similar to ADV_NONCONN_IND, with the option additional information via
+   *   scan responses.  
+   *   Example:  A warehouse pallet beacon allowing a central device to
+   *   request additional information about the pallet.  
+   */
+
+  memset(&start, 0, sizeof(struct bt_advertisestart_s));
+  strncpy(start.as_name, btsak->ifname, HCI_DEVNAME_SIZE);
+  start.as_type = BT_LE_ADV_IND;
+
+  /* Perform the IOCTL to start advertising */
+
+  sockfd = btsak_socket(btsak);
+  if (sockfd >= 0)
+    {
+      ret = ioctl(sockfd, SIOCBT_ADVERTISESTART,
+                  (unsigned long)((uintptr_t)&start));
+      if (ret < 0)
+        {
+          fprintf(stderr, "ERROR:  ioctl(SIOCBT_ADVERTISESTART) failed: %d\n",
+                  errno);
+        }
+    }
+
+  close(sockfd);
+}
+
+/****************************************************************************
+ * Name: btsak_cmd_advertisestop
+ *
+ * Description:
+ *   Scan stop command
+ *
+ ****************************************************************************/
+
+static void btsak_cmd_advertisestop(FAR struct btsak_s *btsak, FAR char *cmd,
+                              int argc, FAR char *argv[])
+{
+  struct bt_advertisestop_s stop;
+  int sockfd;
+  int ret;
+
+  /* Perform the IOCTL to stop advertising */
+
+  strncpy(stop.at_name, btsak->ifname, HCI_DEVNAME_SIZE);
+
+  sockfd = btsak_socket(btsak);
+  if (sockfd >= 0)
+    {
+      ret = ioctl(sockfd, SIOCBT_ADVERTISESTOP,
+                  (unsigned long)((uintptr_t)&stop));
+      if (ret < 0)
+        {
+          fprintf(stderr, "ERROR:  ioctl(SIOCBT_ADVERTISESTOP) failed: %d\n",
+                  errno);
+        }
+    }
+
+  close(sockfd);
+}
+
+/****************************************************************************
+ * Public functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name:
+ *
+ * Description:
+ *
+ ****************************************************************************/
+
+void btsak_cmd_advertise(FAR struct btsak_s *btsak, int argc, FAR char *argv[])
+{
+  int argind;
+
+  /* Verify that an option was provided */
+
+  argind = 1;
+  if (argc < 2)
+    {
+      fprintf(stderr, "ERROR: Missing advertise command\n");
+      btsak_advertise_showusage(btsak->progname, argv[0], EXIT_FAILURE);
+    }
+
+  /* Check for command */
+
+  if (strcmp(argv[argind], "-h") == 0)
+    {
+      btsak_advertise_showusage(btsak->progname, argv[0], EXIT_SUCCESS);
+    }
+  else if (strcmp(argv[argind], "start") == 0)
+    {
+      btsak_cmd_advertisestart(btsak, argv[0], argc - argind, &argv[argind]);
+    }
+  else if (strcmp(argv[argind], "-h") == 0)
+    {
+      btsak_cmd_advertisestop(btsak, argv[0], argc - argind, &argv[argind]);
+    }
+  else
+    {
+      fprintf(stderr, "ERROR:  Unrecognized advertise command: %s\n", argv[argind]);
+      btsak_advertise_showusage(btsak->progname, argv[0], EXIT_FAILURE);
+    }
+}

wireless/bluetooth/btsak/btsak_main.c

@@ -100,7 +100,7 @@ static const struct btsak_command_s g_btsak_commands[] =
   {
     "advertise",
     (CODE void *)btsak_cmd_advertise,
-    "[-h] <on|off>"
+    "[-h] <start|stop>"
   },
   {
     "security",

wireless/bluetooth/btsak/btsak_scan.c

@@ -247,7 +247,7 @@ static void btsak_cmd_scanstop(FAR struct btsak_s *btsak, FAR char *cmd,
   int sockfd;
   int ret;
 
-  /* Perform the IOCTL to start scanning */
+  /* Perform the IOCTL to stop scanning and flush any buffered responses. */
 
   strncpy(stop.st_name, btsak->ifname, HCI_DEVNAME_SIZE);
 
@@ -296,15 +296,15 @@ void btsak_cmd_scan(FAR struct btsak_s *btsak, int argc, FAR char *argv[])
     {
       btsak_scan_showusage(btsak->progname, argv[0], EXIT_SUCCESS);
     }
-  else if (strcmp(argv[argind], "-h") == 0)
+  else if (strcmp(argv[argind], "start") == 0)
     {
       btsak_cmd_scanstart(btsak, argv[0], argc - argind, &argv[argind]);
     }
-  else if (strcmp(argv[argind], "-h") == 0)
+  else if (strcmp(argv[argind], "get") == 0)
     {
       btsak_cmd_scanget(btsak, argv[0], argc - argind, &argv[argind]);
     }
-  else if (strcmp(argv[argind], "-h") == 0)
+  else if (strcmp(argv[argind], "stop") == 0)
     {
       btsak_cmd_scanstop(btsak, argv[0], argc - argind, &argv[argind]);
     }