Initial solution

resources/settings/properties.xml

@@ -22,37 +22,47 @@
   <property id="api_url" type="string"></property>
 
   <!--
-    Best be a public URL in order to work away from your
-    home LAN and have a trusted HTTPS certificate
+    Best be a public URL in order to work away from your home LAN and have a
+    trusted HTTPS certificate.
   -->
   <property id="config_url" type="string"></property>
 
-  <!-- Decide if the menu configuration should be cached. -->
+  <!--
+    Decide if the menu configuration should be cached.
+  -->
   <property id="cache_config" type="boolean">false</property>
 
   <!--
-    Clear the menu configuration on next application start,
-    and refetch, then set this back to false
+    Clear the menu configuration on next application start, and refetch, then
+    set this back to false.
   -->
   <property id="clear_cache" type="boolean">false</property>
 
   <!--
-    Enable notification via vibrations, typically for confirmation of actions
+    Enable notification via vibrations, typically for confirmation of actions.
   -->
   <property id="enable_vibration" type="boolean">true</property>
 
   <!--
-    Application timeout in seconds, except 0 for no
-    timeout (default). After this amount of elapsed
-    time with no activity, exit the application.
+    Application timeout in seconds, except 0 for no timeout (default). After
+    this amount of elapsed time with no activity, exit the application.
   -->
   <property id="app_timeout" type="number">0</property>
 
   <!--
-    After this time (in seconds), a confirmation dialog
-    for an action is automatically closed and the action
-    is cancelled. Set to 0 to disable the timeout.
-    The default value is 3 seconds.
+    Poll delay adds a user configurable delay (in milliseconds) to the status
+    updates of each item in the watch menu that might be amended externally
+    from the watch. A user has requested that it is possible to add this delay
+    for an "always open" mode of operation, which then drains the watch battery
+    from the additional API access activity. A Timer must have a minimum 50 ms
+    value specified, so any value < 50 will be forced to 0.
+  -->
+  <property id="poll_delay" type="number">0</property>
+
+  <!--
+    After this time (in seconds), a confirmation dialog for an action is
+    automatically closed and the action is cancelled. Set to 0 to disable the
+    timeout. The default value is 3 seconds.
   -->
   <property id="confirm_timeout" type="number">3</property>
 
@@ -62,7 +72,8 @@
   <property id="menu_alignment" type="number">1</property>
 
   <!--
-    Enable the background service to send the clock battery level to Home Assistant.
+    Enable the background service to send the clock battery level to Home
+    Assistant.
   -->
   <property id="enable_battery_level" type="boolean">false</property>
 
@@ -73,11 +84,10 @@
   <property id="battery_level_refresh_rate" type="number">15</property>
 
   <!--
-    The webhook ID is the last part of the webhook URL.
-    It is secret and should not be shared.
-    It will not be set in settings but will be
-    generated by the application and stored in
-    properties, but read only for trouble shooting.
+    The webhook ID is the last part of the webhook URL. It is secret and
+    should not be shared. It will not be set in settings but will be
+    generated by the application and stored in properties, but read only
+    for trouble shooting.
   -->
   <property id="webhook_id" type="string"></property>
 

resources/settings/settings.xml

@@ -65,6 +65,13 @@
     <settingConfig type="numeric" min="0" />
   </setting>
 
+  <setting
+    propertyKey="@Properties.poll_delay"
+    title="@Strings.SettingsPollDelay"
+  >
+    <settingConfig type="numeric" min="0" />
+  </setting>
+
   <setting
     propertyKey="@Properties.confirm_timeout"
     title="@Strings.SettingsConfirmTimeout"

resources/strings/strings.xml

@@ -48,6 +48,7 @@
   <string id="SettingsClearCache">Should the application clear the existing cache next time it is started?</string>
   <string id="SettingsVibration">Should the application provide feedback via vibrations?</string>
   <string id="SettingsAppTimeout">Timeout in seconds. Exit the application after this period of inactivity to save the device battery.</string>
+  <string id="SettingsPollDelay">Additional poll delay (in milliseconds). Adds a delay between the status update of menu items.</string>
   <string id="SettingsConfirmTimeout">After this time (in seconds), a confirmation dialog for an action is automatically closed and the action is cancelled. Set to 0 to disable the timeout.</string>
   <string id="SettingsTextAlign">Left (off) or Right (on) Menu Alignment.</string>
   <string id="LeftToRight">Left to right</string>