runtime: add selectable call alert events

Author: arancormonk

include/dsd-neo/core/opts.h

@@ -218,6 +218,7 @@ struct dsd_opts {
     /* DMR: when set, relax CRC gating (ignore final CRC when no irrecoverable errors).
        Off by default; enabled via -F like other protocols. */
     uint8_t dmr_crc_relaxed_default;
+    uint8_t call_alert_events;
     int frame_ysf;
     int inverted_ysf;
     short int aggressive_framesync;

include/dsd-neo/runtime/call_alert.h

@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+/*
+ * Copyright (C) 2026 by arancormonk <180709949+arancormonk@users.noreply.github.com>
+ */
+
+/**
+ * @file
+ * @brief Call-alert event selection helpers.
+ */
+
+#pragma once
+
+#include <stdint.h>
+
+typedef enum {
+    DSD_CALL_ALERT_EVENT_VOICE_START = 1u << 0,
+    DSD_CALL_ALERT_EVENT_VOICE_END = 1u << 1,
+    DSD_CALL_ALERT_EVENT_DATA = 1u << 2,
+    DSD_CALL_ALERT_EVENT_ALL =
+        DSD_CALL_ALERT_EVENT_VOICE_START | DSD_CALL_ALERT_EVENT_VOICE_END | DSD_CALL_ALERT_EVENT_DATA
+} dsd_call_alert_event_t;
+
+static inline uint8_t
+dsd_call_alert_mask_events(uint8_t events) {
+    return (uint8_t)(events & DSD_CALL_ALERT_EVENT_ALL);
+}
+
+static inline uint8_t
+dsd_call_alert_normalize_events(uint8_t events) {
+    uint8_t normalized = dsd_call_alert_mask_events(events);
+    return normalized ? normalized : (uint8_t)DSD_CALL_ALERT_EVENT_ALL;
+}
+
+static inline uint8_t
+dsd_call_alert_effective_events(int enabled, uint8_t events) {
+    if (!enabled) {
+        return 0;
+    }
+    return dsd_call_alert_normalize_events(events);
+}
+
+static inline int
+dsd_call_alert_event_enabled(int enabled, uint8_t configured_events, uint8_t event) {
+    uint8_t events = dsd_call_alert_effective_events(enabled, configured_events);
+    return (events & event) != 0;
+}

include/dsd-neo/runtime/config.h

@@ -15,6 +15,7 @@
 #define DSD_NEO_RUNTIME_CONFIG_H
 
 /* Include schema types first (before extern "C" for C++ compat) */
+#include <dsd-neo/runtime/call_alert.h>
 #include <dsd-neo/runtime/config_schema.h>
 
 #ifdef __cplusplus
@@ -679,6 +680,11 @@ typedef struct dsdneoUserConfig {
     char event_log[1024];
     char frame_log[1024];
 
+    /* [alerts] */
+    int has_alerts;
+    int call_alert_enabled; /* bool */
+    int call_alert_events;  /* bitmask of dsd_call_alert_event_t values */
+
     /* [recording] */
     int has_recording;
     int per_call_wav; /* bool */

include/dsd-neo/ui/ui_cmd.h

@@ -40,6 +40,7 @@ enum UiCmdId {
     UI_CMD_HPF_D_TOGGLE = 55,
     UI_CMD_AGGR_SYNC_TOGGLE = 56,
     UI_CMD_CALL_ALERT_TOGGLE = 57,
+    UI_CMD_CALL_ALERT_EVENTS_SET = 58, // payload: uint8_t event mask (0 disables master switch)
 
     // Views and visualization controls
     UI_CMD_CONST_TOGGLE = 70,

src/core/util/dsd_events.c

@@ -27,6 +27,7 @@
 
 #include "dsd-neo/core/opts_fwd.h"
 #include "dsd-neo/core/state_fwd.h"
+#include "dsd-neo/runtime/call_alert.h"
 
 // Safe bounded copy helper that tolerates potential overlap
 static inline void
@@ -260,7 +261,8 @@ watchdog_event_history(dsd_opts* opts, dsd_state* state, uint8_t slot) {
     }
 
     //call alert beep when new call detected
-    if (last_source_id == 0 && source_id != 0 && opts->call_alert == 1) {
+    if (last_source_id == 0 && source_id != 0
+        && dsd_call_alert_event_enabled(opts->call_alert, opts->call_alert_events, DSD_CALL_ALERT_EVENT_VOICE_START)) {
         beeper(opts, state, slot, 40, 86, 3);
     }
 
@@ -300,7 +302,7 @@ watchdog_event_history(dsd_opts* opts, dsd_state* state, uint8_t slot) {
         }
 
         //end of voice call alert
-        if (opts->call_alert == 1) {
+        if (dsd_call_alert_event_enabled(opts->call_alert, opts->call_alert_events, DSD_CALL_ALERT_EVENT_VOICE_END)) {
             beeper(opts, state, slot, 40, 86, 3);
         }
     }
@@ -1165,7 +1167,7 @@ watchdog_event_datacall(dsd_opts* opts, dsd_state* state, uint32_t src, uint32_t
     /* stack buffers; no free */
 
     //call alert on data calls
-    if (opts->call_alert) {
+    if (dsd_call_alert_event_enabled(opts->call_alert, opts->call_alert_events, DSD_CALL_ALERT_EVENT_DATA)) {
         beeper(opts, state, slot, 80, 20, 3);
     }
 }

src/core/util/dsd_init.c

@@ -26,6 +26,7 @@
 #include "dsd-neo/core/state_fwd.h"
 #include "dsd-neo/dsp/p25p1_heuristics.h"
 #include "dsd-neo/platform/sockets.h"
+#include "dsd-neo/runtime/call_alert.h"
 
 #ifdef USE_CODEC2
 #include <codec2/codec2.h>
@@ -246,6 +247,7 @@ initOpts(dsd_opts* opts) {
     opts->p2counter = 0;
 
     opts->call_alert = 0; //call alert beeper for ncurses
+    opts->call_alert_events = (uint8_t)DSD_CALL_ALERT_EVENT_ALL;
 
     //rigctl options
     opts->use_rigctl = 0;

src/runtime/cli/args.c

@@ -31,6 +31,7 @@
 #include "dsd-neo/core/state_fwd.h"
 #include "dsd-neo/io/iq_types.h"
 #include "dsd-neo/platform/platform.h"
+#include "dsd-neo/runtime/call_alert.h"
 #if defined(__MINGW32__) || defined(__MINGW64__)
 #include <getopt.h>
 #include <unistd.h>
@@ -911,7 +912,10 @@ dsd_parse_short_opts(int argc, char** argv, dsd_opts* opts, dsd_state* state, in
                 dsd_cli_usage();
                 cli_set_exit_rc(out_exit_rc, 0);
                 return DSD_PARSE_ONE_SHOT;
-            case 'a': opts->call_alert = 1; break;
+            case 'a':
+                opts->call_alert = 1;
+                opts->call_alert_events = (uint8_t)DSD_CALL_ALERT_EVENT_ALL;
+                break;
             case '~':
                 state->debug_mode = 1;
                 LOG_NOTICE("Debug Mode Enabled; \n");

src/runtime/cli/usage.c

@@ -115,7 +115,7 @@ dsd_cli_usage(void) {
     printf("      --rdio-upload-timeout-ms <ms>  API upload timeout per call (default 5000)\n");
     printf("      --rdio-upload-retries <n>  API upload retry attempts per call (default 1)\n");
     printf("      --rdio-api-delete-after-upload  Delete per-call WAV after successful API-only upload\n");
-    printf("  -a            Enable Call Alert Beep\n");
+    printf("  -a            Enable Call Alert Beep for start, end, and data events\n");
     printf("                 (Warning! Might be annoying.)\n");
     printf("  -J <file>     Specify Filename for Event Log Output.\n");
     printf("  -L <file>     Specify Filename for LRRP Data Output.\n");

src/runtime/config_schema.c

@@ -70,6 +70,17 @@ static const dsdcfg_schema_entry_t s_schema[] = {
     {"logging", "event_log", "Event history log file path", "", NULL, DSDCFG_TYPE_PATH, 0, 0, 0},
     {"logging", "frame_log", "Frame trace log file path", "", NULL, DSDCFG_TYPE_PATH, 0, 0, 0},
 
+    /* [alerts] section */
+    {"alerts", "enabled", "Enable audible call-alert beeps", "false", NULL, DSDCFG_TYPE_BOOL, 0, 0, 0},
+    {"alerts", "call_alert", "Enable audible call-alert beeps (alias for enabled)", "false", NULL, DSDCFG_TYPE_BOOL, 0,
+     0, 1},
+    {"alerts", "voice_start", "Beep when a voice call starts", "true", NULL, DSDCFG_TYPE_BOOL, 0, 0, 0},
+    {"alerts", "start", "Beep when a voice call starts (alias for voice_start)", "true", NULL, DSDCFG_TYPE_BOOL, 0, 0,
+     1},
+    {"alerts", "voice_end", "Beep when a voice call ends", "true", NULL, DSDCFG_TYPE_BOOL, 0, 0, 0},
+    {"alerts", "end", "Beep when a voice call ends (alias for voice_end)", "true", NULL, DSDCFG_TYPE_BOOL, 0, 0, 1},
+    {"alerts", "data", "Beep when a data call is logged", "true", NULL, DSDCFG_TYPE_BOOL, 0, 0, 0},
+
     /* [recording] section */
     {"recording", "per_call_wav", "Enable per-call WAV output", "false", NULL, DSDCFG_TYPE_BOOL, 0, 0, 0},
     {"recording", "per_call_wav_dir", "Per-call WAV output directory", "./WAV", NULL, DSDCFG_TYPE_PATH, 0, 0, 0},

src/runtime/config_user.cpp

@@ -21,13 +21,15 @@
 #include <dsd-neo/runtime/decode_mode.h>
 #include <dsd-neo/runtime/freq_parse.h>
 #include <dsd-neo/runtime/rdio_export.h>
+#include <stdint.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 
 #include "config_user_internal.h"
 #include "dsd-neo/core/opts_fwd.h"
 #include "dsd-neo/core/state_fwd.h"
+#include "dsd-neo/runtime/call_alert.h"
 
 #if defined(_WIN32)
 #include <windows.h>
@@ -86,6 +88,9 @@ user_cfg_reset(dsdneoUserConfig* cfg) {
 
     cfg->rtl_auto_ppm = 0;
 
+    cfg->call_alert_enabled = 0;
+    cfg->call_alert_events = DSD_CALL_ALERT_EVENT_ALL;
+
     // Recording defaults (match initOpts)
     cfg->per_call_wav = 0;
     snprintf(cfg->per_call_wav_dir, sizeof cfg->per_call_wav_dir, "%s", "./WAV");
@@ -684,6 +689,16 @@ dsd_user_config_render_ini(const dsdneoUserConfig* cfg, FILE* out) {
         fprintf(out, "\n");
     }
 
+    if (cfg->has_alerts) {
+        uint8_t events = dsd_call_alert_mask_events((uint8_t)cfg->call_alert_events);
+        fprintf(out, "[alerts]\n");
+        fprintf(out, "enabled = %s\n", cfg->call_alert_enabled ? "true" : "false");
+        fprintf(out, "voice_start = %s\n", (events & DSD_CALL_ALERT_EVENT_VOICE_START) ? "true" : "false");
+        fprintf(out, "voice_end = %s\n", (events & DSD_CALL_ALERT_EVENT_VOICE_END) ? "true" : "false");
+        fprintf(out, "data = %s\n", (events & DSD_CALL_ALERT_EVENT_DATA) ? "true" : "false");
+        fprintf(out, "\n");
+    }
+
     if (cfg->has_recording) {
         fprintf(out, "[recording]\n");
         fprintf(out, "per_call_wav = %s\n", cfg->per_call_wav ? "true" : "false");
@@ -914,6 +929,12 @@ dsd_apply_user_config_to_opts_impl(const dsdneoUserConfig* cfg, dsd_opts* opts,
         opts->frame_log_file[sizeof opts->frame_log_file - 1] = '\0';
     }
 
+    if (cfg->has_alerts) {
+        uint8_t events = dsd_call_alert_mask_events((uint8_t)cfg->call_alert_events);
+        opts->call_alert = (cfg->call_alert_enabled && events != 0) ? 1 : 0;
+        opts->call_alert_events = events;
+    }
+
     if (cfg->has_recording) {
         if (cfg->per_call_wav_dir[0]) {
             snprintf(opts->wav_out_dir, sizeof opts->wav_out_dir, "%s", cfg->per_call_wav_dir);
@@ -1118,6 +1139,12 @@ dsd_snapshot_opts_to_user_config(const dsd_opts* opts, const dsd_state* state, d
     snprintf(cfg->frame_log, sizeof cfg->frame_log, "%s", opts->frame_log_file);
     cfg->frame_log[sizeof cfg->frame_log - 1] = '\0';
 
+    // Alert snapshot
+    cfg->has_alerts = 1;
+    cfg->call_alert_enabled = opts->call_alert ? 1 : 0;
+    cfg->call_alert_events = opts->call_alert ? dsd_call_alert_normalize_events(opts->call_alert_events)
+                                              : dsd_call_alert_mask_events(opts->call_alert_events);
+
     // Recording snapshot
     cfg->has_recording = 1;
     cfg->per_call_wav = opts->dmr_stereo_wav ? 1 : 0;