Merge pull request #4277 from peterbuehler/master

Pure Numerals Clock Version 0.04

Author: bobrippling

apps/purenumerals/ChangeLog

@@ -1 +1,2 @@
-0.03: first released version.
+0.03: First released version.
+0.04: Battery level with ringbuffer, blinking red dot if device on.

apps/purenumerals/README.md

@@ -1,16 +1,28 @@
 # Pure Numerals Clock
 
-## System settings
+> **Time, reduced to digits.**
 
-This chapter describes some system settings that affect the behavior of the Pure Numerals Clock.
+Pure Numerals is a digital watch face that strips away all unnecessary elements and translates time into two bold blocks of numbers. Hours at the top, minutes at the bottom — in vivid contrasting colors against a deep black background. Radically simple, extremely easy to read, and looking like a digital neon sign on your wrist.
+
+## Features
+
+- **Oversized, softly rounded numerals** for maximum readability at a glance
+- **Strong contrasting colors** on a deep black background
+- **Radically focused** on the time — no distractions, no clutter
+- **Optimized for Bangle.js** — smooth, responsive, and power-efficient
+- **For users who love typographic presence** and the beauty of pure digital numerals
+
+---
+
+## System Settings
 
 ### LCD Timeout
 
-The _LCD Timeout_ can be found under _Settings → System → LCD_ and determines the duration after which the watch automatically goes into "sleep" mode without user interaction. During this time, the touchscreen and backlight are switched off to prevent unwanted user interactions and reduce power consumption. The _LCD Timeout_ is set to 10 seconds by default.
+Found under _Settings → System → LCD_. Determines how long the watch waits before going to sleep — switching off the touchscreen and backlight to save power. Default: 10 seconds.
 
-### Waking up the clock
+### Waking Up the Clock
 
-Under _Settings → System → LCD,_ you can configure one or more options to determine the user interaction used to wake the clock from sleep mode. The following options are available:
+Under _Settings → System → LCD_, configure which interactions wake the clock from sleep:
 
 - Wake on Button
 - Wake on Tap
@@ -20,54 +32,57 @@ Under _Settings → System → LCD,_ you can configure one or more options to de
 
 ### LCD Brightness
 
-The _LCD Brightness_ setting adjusts the brightness of the display's backlight. This setting can be found under _Settings → System → LCD_ . The brightness is set to a value between 0.0 and 1.0 and affects power consumption and therefore the watch's battery life. In practice, a value of 0.3 has proven effective.
+Found under _Settings → System → LCD_. Accepts a value between 0.0 and 1.0. A value of 0.3 is a good practical starting point.
+
+### Summer and Winter Time
 
-### Summer and winter time
+The Bangle only detects time changes when synced with a smartphone. If the time is off, correct it manually by adjusting the time zone under _Settings → System → Adjust Local_.
 
-The Bangle only recognizes the time change if it is connected to a smartphone and synchronizes with it. Therefore, the time may need to be corrected manually. You can do this by changing the _time zone_ under _Settings →_ Adjust _System → Local accordingly._
+### Default Clock
 
-### Setting the Default Clock
+Multiple watch faces can be installed on the Bangle. Set which one launches by default under _Settings → System → Clock_.
 
-Multiple watch faces can be installed on the Bangle. Under _Settings →_ _System → Clock_ allows you to set which clock should be used by default. This clock will be displayed when you exit the app launcher.
+---
 
 ## Primary Views
 
-The primary views are used to display the date and time, as well as the step counter and pulse measurement. A carousel navigation was implemented for switching views. Swiping from right to left displays the next view (corresponding to scrolling forward). Swiping from left to right displays the previous view. The order of the subchapters corresponds to the order of the carousel navigation.
+Primary views show the date, time, step count, and pulse. Switch between them using carousel navigation: swipe left for the next view, swipe right for the previous.
 
 ### Day/Month
-This view displays the date. The day is shown in the upper half, the month in the lower half. This order corresponds to the European date format.
+Displays the date in European format — day in the upper half, month in the lower half.
 
 ### Hours/Minutes
-This view displays the hours and minutes. This view is displayed when the clock starts or when the LCD timeout has expired and the clock is put to sleep.
+Displays hours and minutes. This is the default view shown on startup and after waking from sleep.
 
 ### Minutes/Seconds
-This view displays the minutes and seconds. The same color is used for the minutes as in the Hours/Minutes view.
+Displays minutes and seconds, using the same color for minutes as the Hours/Minutes view.
 
 ### Pedometer
-This view displays the number of steps recorded on a given day. The counter resets to 0 when the date changes. The font size of the step count scales automatically.
+Displays the step count for the current day. Resets at midnight. Font size scales automatically.
+
+### Pulse Measurement
+Activates the heart rate sensor when opened and displays the measured pulse once available. Font size scales automatically.
 
-### Pulse measurement
-This view displays the measured pulse. The pulse measurement sensor is activated when the view is opened. As soon as measurements are available, the measured pulse is displayed. The font size is automatically scaled.
+The first reading takes approximately 20 seconds. To allow for this, the LCD timeout is disabled in this view and re-enabled when you leave it.
 
-Since it takes approximately 20 seconds for the first measurement to be displayed, the LCD timeout is deactivated in this view. Therefore, the watch does not go to sleep during heart rate measurement. The LCD timeout is reactivated when the view is exited.
+---
 
 ## Secondary Views
 
-Secondary views are accessed from primary views through appropriate user interaction. When exiting a secondary view, the last active primary view is automatically displayed.
+Secondary views are accessed by tapping specific areas of the display. Exiting returns you to the last active primary view.
 
-### Battery indicator
+### Battery Indicator
 
-The battery indicator is accessed by tapping the upper right corner of the display.
-The charging indicator bar is colored as follows:
+Access by tapping the **upper right corner**. The charge bar uses the following color coding:
 
-- Green: Charge level > 40%
-- Orange: Charge level between 20% and 40%
-- Red: Charge level < 20%
+- **Green**: > 40%
+- **Orange**: 20–40%
+- **Red**: < 20%
 
-The battery indicator will automatically exit after a timeout of 3 seconds.
+Closes automatically after 3 seconds.
 
-### flashlight
+### Flashlight
 
-The flashlight icon displays a white rectangle at full brightness. The flashlight is activated by double-tapping the lower left corner of the display. The double-tapping feature prevents accidental activation of the flashlight.
+Access by **double-tapping the lower left corner**. Displays a full-brightness white screen.
 
-The LCD timeout is disabled while the flashlight is on. Tapping the display exits the view. This re-establishes the LCD timeout and restores the original brightness.
+The LCD timeout is disabled while active. Tap anywhere to exit, which restores the previous brightness and re-enables the timeout.

apps/purenumerals/app-icon.js

@@ -8,7 +8,8 @@
 //  Flashlight (double touch bottom left) and Battery (touch top right)
 //
 //  27.11.2025  Peter Bühler
-//  
+//  29.06.2026  Battery with Ringbuffer
+//              Watchdog (blinking red dot when device is on)  
 
 {
   // globals
@@ -404,9 +405,11 @@
 
     function draw() {
       clearBackground();
-      let percent = E.getBattery();  // Emulator : 0
+      // let percent = E.getBattery();  // Emulator : 0
       //percent = 19;
 
+      let percent = app.getBattery();
+
       // draw battery
       let bx = CENTER - 36, by = CENTER - 42;
       let bw = 72, bh = 30;
@@ -556,6 +559,108 @@
 
   };
 
+  // factory function for the battery manager
+  let createBatteryManager = function() {
+
+    // calculates average of battery charge
+
+    let values = [ -1, -1, -1, -1, -1 ]; // Ringbuffer
+    let index = 0;
+    let interval;
+    const timeout = 1000 * 60 * 5;  // 5 Min
+
+    function putMeasure() {
+      let value =  E.getBattery();
+      let ind = index % values.length;
+      values[ind] = value;
+      index++;
+    }
+
+    // returns the battery charge
+    function getValue() {
+      let sum = 0;
+      let count = 0;
+      for (const v of values) {   // calculate average
+        if ( v !== -1) {
+          sum += v;
+          count++;
+        }
+      }
+      return sum / count;
+    }
+
+    function start() {
+      if (interval) { clearInterval(interval); }
+      putMeasure();   // first measure
+      interval = setInterval(function() {
+        putMeasure();
+      }, timeout);
+    }
+
+    function stop() {
+       if (interval) { clearInterval(interval); }
+    }
+
+    return { start, stop, getValue } ;
+
+  };
+  
+  // factory function for watchdog ---------------------------------------
+  // draws red blinking dot when not watch is locked
+  
+  let createWatchdog = function() {
+  
+    const radius = 4;
+    const gap = 4;
+    const x = DISPLAY_SIZE - radius - gap;
+    const y = DISPLAY_SIZE - radius - gap;
+
+    let on = false;
+    let locked = false;
+    let visible = true;
+    let interval;
+
+    function init() {
+      interval = setInterval(updateState, 500); 
+    }
+  
+    function updateState() {
+      locked = Bangle.isLocked();
+      on = !on;
+      if (visible) { 
+        draw();
+      }
+    }
+  
+    function shutdown() {
+      clearInterval(interval);
+    }
+  
+    function draw() {
+    if (locked) {
+        drawDot('#000000');  // use black (gray is blinking)
+      }
+      else if (on) {
+        drawDot('#FF0000');  // red
+      }
+      else {
+        drawDot('#000000');  // black
+      } 
+    }
+  
+    function drawDot(color) {
+      g.setColor(color);
+      g.fillCircle(x, y, radius);
+    }
+
+    function setVisible(vis) {
+      visible = vis;
+    }
+  
+    return { init, shutdown, setVisible };
+
+  };
+
   // factory function for the app
   let createApp = function () {
 
@@ -582,6 +687,9 @@
     let lastTouchTime = 0;
     let lastTouchArea = undefined;
 
+    let batteryManager;
+    let watchdog = createWatchdog();
+
     function onSwipe(lr, td) {
       // console.log("onSwipe() lr: " + lr + " td: " + td);
       if (currentKey > MAX_CAROUSEL_KEY) { return; }    // only when carousel view
@@ -680,6 +788,7 @@
       currentView = viewMap[currentKey];
       lastCarouselKey = (currentKey <= MAX_CAROUSEL_KEY) ? currentKey : lastCarouselKey;
       currentView.enter();
+      watchdog.setVisible(key <= MAX_CAROUSEL_KEY);
     }
 
     // returns offset for step view
@@ -711,6 +820,11 @@
       require("Storage").writeJSON(FILE_NAME, data);
     }
 
+    // returns the battery charge
+    function getBattery() {
+      return batteryManager.getValue();
+    }
+
     // start app
     function start() {
       // console.log("app start()");
@@ -723,6 +837,11 @@
       Bangle.on("midnight", onMidnight);
       Bangle.on("lock", onLock);
 
+      // start battery manager
+      batteryManager = createBatteryManager();
+      batteryManager.start();
+
+      watchdog.init(); // start watchdog
       showView(1); // show hour/minute
     }
 
@@ -731,16 +850,19 @@
       // console.log("app shutdown()");
       if (currentView) { currentView.leave(); }
 
+      batteryManager.stop();
+
       // unregister event handler
       Bangle.removeListener("swipe", onSwipe);
       Bangle.removeListener("touch", onTouch);
       Bangle.removeListener("midnight", onMidnight);
       Bangle.removeListener("lock", onLock);
 
+      watchdog.shutdown();
       writeStepData();
     }
 
-    return { start, shutdown, showLastCarouselView, showView, getStepOffset };
+    return { start, shutdown, showLastCarouselView, showView, getStepOffset, getBattery };
 
   };
 

apps/purenumerals/app.js

@@ -1,17 +1,18 @@
-{ "id": "purenumerals",
-  "name": "Pure Numerals Clock",
-  "shortName":"Pure Numerals",
-  "icon": "app.png",
-  "version":"0.03",
-  "author":"OST Eastern Switzerland University of Applied Sciences",
-  "description": "A watch with a step counter and heart rate measurement. You can switch views by swiping left or right. Additionally, a flashlight function (double-tap the bottom left) and a battery indicator (tap the top right) are available.",
-  "tags": "clock",
-  "type": "clock",
-  "supports": ["BANGLEJS2"],
-  "allow_emulator": true,
-  "readme":"README.md",
-  "storage": [
-    {"name":"purenumerals.app.js","url":"app.js"},
-    {"name":"purenumerals.img","url":"app-icon.js","evaluate":true}
-  ]
-}
+{ "id": "purenumerals",
+  "name": "Pure Numerals Clock",
+  "shortName":"Pure Numerals",
+  "icon": "app.png",
+  "version":"0.04",
+  "author":"OST Eastern Switzerland University of Applied Sciences",
+  "description": "Pure Numerals is a minimalist digital watch face that displays easy-to-read time and date as two bold blocks of numbers in vivid colors on a deep black background. It also includes a step counter, heart rate measurement, a flashlight and a battery indicator.",
+  "tags": "clock",
+  "type": "clock",
+  "supports": ["BANGLEJS2"],
+  "allow_emulator": true,
+  "readme":"README.md",
+  "storage": [
+    {"name":"purenumerals.app.js","url":"app.js"},
+    {"name":"purenumerals.img","url":"app-icon.js","evaluate":true}
+  ],
+  "screenshots": [{"url":"screenshot.png"}]
+}