feat: add periodic auto-advert with GPS position (Auto-Advert tool)

Adds configurable periodic 0-hop self-advert that includes GPS coordinates,
making the device's position visible in other nodes' Nearby Nodes screen.
Options: off / 1min / 2min / 5min / 10min / 30min / 1h.

Accessible via Tools → Auto-Advert. Timer runs in MyMesh::loop().

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

examples/companion_radio/ui-new/AutoAdvertScreen.h

@@ -0,0 +1,68 @@
+#pragma once
+// Configures periodic automatic 0-hop advert with GPS position.
+// Included by UITask.cpp after DashboardConfigScreen.h.
+
+class AutoAdvertScreen : public UIScreen {
+  UITask*    _task;
+  NodePrefs* _prefs;
+  bool       _dirty;
+
+  static const int OPT_COUNT = 7;
+  static const uint32_t OPTS[OPT_COUNT];
+  static const char*    OPT_LABELS[OPT_COUNT];
+
+  int currentIdx() const {
+    for (int i = 0; i < OPT_COUNT; i++)
+      if (OPTS[i] == _prefs->advert_auto_interval_sec) return i;
+    return 0;
+  }
+
+public:
+  AutoAdvertScreen(UITask* task, NodePrefs* prefs) : _task(task), _prefs(prefs) {}
+
+  void enter() { _dirty = false; }
+
+  int render(DisplayDriver& display) override {
+    display.setTextSize(1);
+    display.setColor(DisplayDriver::LIGHT);
+    display.drawTextCentered(display.width() / 2, 0, "AUTO-ADVERT");
+    display.fillRect(0, 10, display.width(), 1);
+
+    display.setCursor(2, 14);
+    display.print("Interval:");
+
+    int idx = currentIdx();
+    display.setColor(DisplayDriver::LIGHT);
+    display.fillRect(0, 24, display.width(), 12);
+    display.setColor(DisplayDriver::DARK);
+    display.drawTextCentered(display.width() / 2, 25, OPT_LABELS[idx]);
+    display.setColor(DisplayDriver::LIGHT);
+
+    display.setCursor(2, 40);
+    display.print("<  > to change");
+    display.setCursor(2, 51);
+    display.print("[Esc] to save");
+    return 500;
+  }
+
+  bool handleInput(char c) override {
+    if (c == KEY_CANCEL || c == KEY_CONTEXT_MENU) {
+      if (_dirty) the_mesh.savePrefs();
+      _task->gotoToolsScreen();
+      return true;
+    }
+    bool right = (c == KEY_RIGHT || c == KEY_NEXT || c == KEY_ENTER);
+    bool left  = (c == KEY_LEFT  || c == KEY_PREV);
+    if (right || left) {
+      int idx = currentIdx();
+      idx = right ? (idx + 1) % OPT_COUNT : (idx + OPT_COUNT - 1) % OPT_COUNT;
+      _prefs->advert_auto_interval_sec = OPTS[idx];
+      _dirty = true;
+      return true;
+    }
+    return false;
+  }
+};
+
+const uint32_t AutoAdvertScreen::OPTS[AutoAdvertScreen::OPT_COUNT]       = { 0, 60, 120, 300, 600, 1800, 3600 };
+const char*    AutoAdvertScreen::OPT_LABELS[AutoAdvertScreen::OPT_COUNT] = { "off", "1min", "2min", "5min", "10min", "30min", "1h" };

examples/companion_radio/ui-new/ToolsScreen.h

@@ -6,7 +6,7 @@ class ToolsScreen : public UIScreen {
   UITask* _task;
   int _sel;
 
-  static const int ITEM_COUNT = 3;
+  static const int ITEM_COUNT = 4;
   static const char* ITEMS[ITEM_COUNT];
 
 public:
@@ -42,11 +42,12 @@ public:
     if (c == KEY_DOWN && _sel < ITEM_COUNT - 1) { _sel++; return true; }
     if (c == KEY_CANCEL || c == KEY_CONTEXT_MENU) { _task->gotoHomeScreen(); return true; }
     if (c == KEY_ENTER) {
-      if (_sel == 0) { _task->gotoRingtoneEditor(); return true; }
-      if (_sel == 1) { _task->gotoBotScreen();      return true; }
-      if (_sel == 2) { _task->gotoNearbyScreen();   return true; }
+      if (_sel == 0) { _task->gotoRingtoneEditor();   return true; }
+      if (_sel == 1) { _task->gotoBotScreen();        return true; }
+      if (_sel == 2) { _task->gotoNearbyScreen();     return true; }
+      if (_sel == 3) { _task->gotoAutoAdvertScreen(); return true; }
     }
     return false;
   }
 };
-const char* ToolsScreen::ITEMS[3] = { "Ringtone Editor", "Auto-Reply Bot", "Nearby Nodes" };
+const char* ToolsScreen::ITEMS[4] = { "Ringtone Editor", "Auto-Reply Bot", "Nearby Nodes", "Auto-Advert" };

examples/companion_radio/ui-new/UITask.cpp

@@ -1594,6 +1594,7 @@ public:
 #include "BotScreen.h"
 #include "NearbyScreen.h"
 #include "DashboardConfigScreen.h"
+#include "AutoAdvertScreen.h"
 #include "ToolsScreen.h"
 
 // ── HomeScreen ────────────────────────────────────────────────────────────────
@@ -2252,6 +2253,7 @@ void UITask::begin(DisplayDriver* display, SensorManager* sensors, NodePrefs* no
   bot_screen    = new BotScreen(this, node_prefs);
   nearby_screen = new NearbyScreen(this);
   dashboard_config = new DashboardConfigScreen(this, node_prefs);
+  auto_advert_screen = new AutoAdvertScreen(this, node_prefs);
   setCurrScreen(splash);
 
   applyBrightness();
@@ -2286,6 +2288,11 @@ void UITask::gotoDashboardConfig() {
   setCurrScreen(dashboard_config);
 }
 
+void UITask::gotoAutoAdvertScreen() {
+  ((AutoAdvertScreen*)auto_advert_screen)->enter();
+  setCurrScreen(auto_advert_screen);
+}
+
 void UITask::playMelody(const char* melody) {
 #ifdef PIN_BUZZER
   buzzer.playForced(melody);

examples/companion_radio/ui-new/UITask.h

@@ -65,6 +65,7 @@ class UITask : public AbstractUITask {
   UIScreen* bot_screen;
   UIScreen* nearby_screen;
   UIScreen* dashboard_config;
+  UIScreen* auto_advert_screen;
   UIScreen* curr;
 
   void userLedHandler();
@@ -102,6 +103,7 @@ public:
   void gotoBotScreen();
   void gotoNearbyScreen();
   void gotoDashboardConfig();
+  void gotoAutoAdvertScreen();
   void playMelody(const char* melody);
   void stopMelody();
   bool isMelodyPlaying();