2nd attempt:

  Added SAPI5 speech for planes entering and leaving.
  Also speak when a new network client gets accepted or
  denied.

Author: gvanem

dump1090.cfg

@@ -53,8 +53,10 @@ aircrafts-url = https://s3.opensky-network.org/data-samples/metadata/aircraftDat
 airports = %~dp0\airport-codes.csv
 
 #
-# Prefer using ADSB-LOL over 'routes.csv' or a generated 'routes.c' file.
-# Regardless of 'USE_GEN_ROUTES = 1' in 'Makefile.Windows'.
+# Prefer using ADSB-LOL over a generated
+#   %TEMP%/dump1090/standing-data/results/routes.bin
+#
+# file. Regardless of 'USE_BIN_FILES = 1' in 'Makefile.Windows'.
 #
 prefer-adsb-lol = false
 
@@ -163,6 +165,15 @@ web-page      = %~dp0\web_root-Tar1090\index.html   # The default web-page.
 #
 # sdrconsole-in = tcp://localhost:50101
 
+#
+# Speech settings.
+# Have SAPI5 speak when a plane is entering or leaving.
+# Or when a client is accepted or denied.
+#
+speech-enable  = true
+speech-volume  = 70     # 0 - 100
+# speech-voice = x      # to-do
+
 #
 # Internal values for 'dump1090.exe --test=config':
 #

src/Dump1090.vcxproj

@@ -158,6 +158,7 @@
     <ClCompile Include="net_io.c" />
     <ClCompile Include="pconsole.c" />
     <ClCompile Include="sdrplay.c" />
+    <ClCompile Include="speech.c" />
     <ClCompile Include="externals\mongoose.c" />
     <ClCompile Include="externals\Curses\amalgamation.c" />
     <ClCompile Include="externals\sqlite3.c" />
@@ -179,6 +180,7 @@
     <ClInclude Include="misc.h" />
     <ClInclude Include="net_io.h" />
     <ClInclude Include="sdrplay.h" />
+    <ClInclude Include="speech.h" />
     <ClInclude Include="dump1090_config.h" />
     <ClInclude Include="externals\mongoose.h" />
     <ClInclude Include="externals\sqlite3.h" />

src/dump1090.c

@@ -23,6 +23,7 @@
 #include "net_io.h"
 #include "cfg_file.h"
 #include "sdrplay.h"
+#include "speech.h"
 #include "location.h"
 #include "airports.h"
 #include "interactive.h"
@@ -158,6 +159,8 @@ static const struct cfg_table config[] = {
     { "rtl-reset",        ARG_ATOB,    (void*) &Modes.rtlsdr.power_cycle },
     { "samplerate",       ARG_FUNC,    (void*) set_sample_rate },
     { "show-hostname",    ARG_ATOB,    (void*) &Modes.show_host_name },
+    { "speech-enable",    ARG_ATOB,    (void*) &Modes.speech_enable },
+    { "speech-volume",    ARG_ATOI,    (void*) &Modes.speech_volume },
     { "https-enable",     ARG_ATOB,    (void*) &Modes.https_enable },
     { "silent",           ARG_ATOB,    (void*) &Modes.silent },
     { "ppm",              ARG_FUNC,    (void*) set_ppm },
@@ -486,6 +489,12 @@ static bool modeS_init (void)
   if (Modes.logfile_initial[0])
      modeS_init_log();
 
+  if (Modes.speech_enable && !speak_init(0, Modes.speech_volume))
+  {
+    LOG_FILEONLY ("speak_init(): failed.\n");
+    Modes.speech_enable = false;
+  }
+
   modeS_log_set();
   aircraft_SQL_set_name();
 
@@ -3334,6 +3343,8 @@ static void modeS_exit (void)
   if (Modes.win_location)
      location_exit();
 
+  speak_exit();
+
   modeS_log_exit();
 
 #if defined(_DEBUG)
@@ -3638,7 +3649,7 @@ static bool set_prefer_adsb_lol (const char *arg)
 {
   Modes.prefer_adsb_lol = cfg_true (arg);
 
-#if !defined(USE_GEN_ROUTES) && !defined(USE_BIN_FILES)
+#if !defined(USE_BIN_FILES)
   DEBUG (DEBUG_GENERAL,
          "Config value 'prefer-adsb-lol=%d' has no meaning.\n"
          "Will always use ADSB-LOL API to lookup routes in 'airports.c'.\n",

src/misc.c

@@ -26,6 +26,9 @@
 #include "misc.h"
 #include "rtl-sdr/version.h"
 
+#define __SpeechConstants_MODULE_DEFINED__
+#include <sapi.h>
+
 #define TSIZE (int)(sizeof("HH:MM:SS.MMM: ") - 1)
 
 static bool modeS_log_reinit (const SYSTEMTIME *st);
@@ -1264,6 +1267,14 @@ static void print_sql_info (void)
   free (buf);
 }
 
+/**
+ * Print the SAPI (Speech API) version.
+ */
+static void print_SAPI_info (void)
+{
+  printf ("SAPI ver:     %x.%x\n", (_SAPI_VER & 0xF0) >> 4, _SAPI_VER & 0x0F);
+}
+
 /**
  * Return the compiler info the program was built with.
  */
@@ -1314,9 +1325,6 @@ static const char *build_features (void)
   #if defined(USE_UBSAN)
     "UBSAN",
   #endif
-  #if defined(USE_GEN_ROUTES)
-    "GEN_ROUTES",
-  #endif
   #if defined(USE_BIN_FILES)
     "BIN_FILES",
   #endif
@@ -1624,7 +1632,7 @@ static void print_BIN_files (void)
                               "routes.bin"
                             };
 
-  printf ("Generated .BIN-files:\n");
+  printf ("\nGenerated .BIN-files:\n");
 
   init_timings();  /* for 'Modes.timezone' */
 
@@ -1670,6 +1678,7 @@ void show_version_info (bool verbose)
     printf ("RTL-SDR ver:  %d.%d.%d.%d from https://%s\n",
             RTLSDR_MAJOR, RTLSDR_MINOR, RTLSDR_MICRO, RTLSDR_NANO, RTL_VER_ID);
     printf ("PDCurses ver: %-7s from https://github.com/wmcbrine/PDCurses\n", PDC_VERDOT);
+    print_SAPI_info();
     print_sql_info();
     print_BIN_files();
     print_CFLAGS();

src/misc.h

@@ -463,10 +463,12 @@ typedef struct global_data {
         int          win_location;               /**< Use 'Windows Location API' to get the 'Modes.home_pos'. */
         int          only_addr;                  /**< Print only ICAO addresses. */
         int          metric;                     /**< Use metric units. */
-        int          prefer_adsb_lol;            /**< Prefer using ADSB-LOL API even with '-DUSE_GEN_ROUTES' and/or '-DUSE_BIN_FILES'. */
+        int          prefer_adsb_lol;            /**< Prefer using ADSB-LOL API even with '-DUSE_BIN_FILES'. */
         bool         error_correct_1;            /**< Fix 1 bit errors (default: true). */
         bool         error_correct_2;            /**< Fix 2 bit errors (default: false). */
         int          keep_alive;                 /**< Send "Connection: keep-alive" if HTTP client sends it. */
+        int          speech_enable;              /**< Enable speech for planes entering and leaving. */
+        int          speech_volume;              /**< Speech volume; 0 - 100 percent */
         mg_file_path web_page;                   /**< The base-name of the web-page to server for HTTP clients. */
         mg_file_path web_root;                   /**< And it's directory. */
         bool         web_root_touch;             /**< Touch all files in `web_root` first. */

src/net_io.c

@@ -11,6 +11,7 @@
 #include "aircraft.h"
 #include "net_io.h"
 #include "rtl-tcp.h"
+#include "speech.h"
 #include "server-cert-key.h"
 #include "client-cert-key.h"
 
@@ -1550,7 +1551,7 @@ static bool client_is_extern (const mg_addr *addr)
 static bool client_handler (mg_connection *c, intptr_t service, int ev)
 {
   const mg_addr *addr = &c->rem;
-  const char    *is_tls = "";
+  const char    *ip, *is_tls = "";
   mg_host_name   addr_buf;
   unique_IP     *unique;
 
@@ -1577,13 +1578,22 @@ static bool client_handler (mg_connection *c, intptr_t service, int ev)
       if (deny && unique)  /* increment deny-counter for this `addr` */
          unique->denied++;
 
-      if (Modes.debug & DEBUG_NET)
-         Beep (deny ? 1200 : 800, 20);
+      net_str_addr (addr, addr_buf, sizeof(addr_buf));
+
+      if (Modes.speech_enable)
+      {
+        speak_string ("Client for %s %s.",
+                      net_service_descr(service),
+                      deny ? "denied" : "accepted");
+      }
+      else if (Modes.debug & DEBUG_NET)
+      {
+        Beep (deny ? 1200 : 800, 20);
+      }
 
       LOG_FILEONLY ("%s connection: %s (conn-id: %lu, service: \"%s\"%s).\n",
                     deny ? "Denied" : "Accepted",
-                    net_str_addr(addr, addr_buf, sizeof(addr_buf)),
-                    c->id, net_service_descr(service), is_tls);
+                    addr_buf, c->id, net_service_descr(service), is_tls);
       return (!deny);
     }
   }