update GitHub actions

Author: RobTillaart

.github/workflows/arduino-lint.yml

@@ -6,8 +6,8 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v4
-      - uses: arduino/arduino-lint-action@v1
+      - uses: actions/checkout@v6
+      - uses: arduino/arduino-lint-action@v2
         with:
           library-manager: update
           compliance: strict

.github/workflows/arduino_test_runner.yml

@@ -6,9 +6,8 @@ jobs:
   runTest:
     runs-on: ubuntu-latest
     timeout-minutes: 20
-
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: 2.6

.github/workflows/jsoncheck.yml

@@ -5,13 +5,15 @@ on:
     paths:
       - '**.json'
   pull_request:
+    paths:
+      - '**.json'
 
 jobs:
   test:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: json-syntax-check
         uses: limitusus/json-syntax-check@v2
         with:

CHANGELOG.md

@@ -5,19 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.3.5] - 2026-01-15
+- update GitHub actions
+- add HOURS resolution
+- minor edits
 
 ## [0.3.4] - 2025-03-20
 - add **void resume()** to replace cont()
 - update examples
 - update readme.md
 - minor edits
 
-
 ## [0.3.3] - 2024-04-11
 - update GitHub actions
 - minor edits
 
-
 ## [0.3.2] - 2023-10-18
 - update readme.md (badges)
 
@@ -70,7 +72,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ----
 
 ## [0.1.3] - 2017-07-16
-- TODO improved seconds - OdoMeter see below ... TODO 
+- TODO improved seconds - OdoMeter see below ... TODO
 
 ## [0.1.2] - 2017-07-16
 - add start(days, hours, minutes, seconds) + cont() == continue countdown

CountDown.cpp

@@ -1,7 +1,7 @@
 //
 //    FILE: CountDown.cpp
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.3.4
+// VERSION: 0.3.5
 // PURPOSE: CountDown library for Arduino
 //     URL: https://github.com/RobTillaart/CountDown
 
@@ -137,6 +137,9 @@ void CountDown::calcRemaining()
   {
     switch(_res)
     {
+      case HOURS:
+        t = (millis() - _startTime) / (60 * 60000UL);
+        break;
       case MINUTES:
         t = (millis() - _startTime) / 60000UL;
         break;

CountDown.h

@@ -2,20 +2,20 @@
 //
 //    FILE: CountDown.h
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.3.4
+// VERSION: 0.3.5
 // PURPOSE: CountDown library for Arduino
 //     URL: https://github.com/RobTillaart/CountDown
 
 
 #include "Arduino.h"
 
-#define COUNTDOWN_LIB_VERSION               (F("0.3.4"))
+#define COUNTDOWN_LIB_VERSION               (F("0.3.5"))
 
 
 class CountDown
 {
 public:
-  enum Resolution { MICROS = 'u', MILLIS = 'm', SECONDS = 's', MINUTES = 'M' };
+  enum Resolution { MICROS = 'u', MILLIS = 'm', SECONDS = 's', MINUTES = 'M', HOURS = 'H' };
 
   explicit CountDown(const enum Resolution res = MILLIS);
 
@@ -28,6 +28,7 @@ class CountDown
   //  Implicit set resolution to SECONDS.
   bool     start(uint8_t days, uint16_t hours, uint32_t minutes, uint32_t seconds);
   //  Implicit set resolution to MINUTES.
+  //  optional set minutes to zero for hours
   bool     start(uint8_t days, uint16_t hours, uint32_t minutes);
 
   void     stop();
@@ -39,6 +40,7 @@ class CountDown
   bool     isStopped();
 
   //  obsolete in future
+  [[deprecated("Use resume()")]]
   void     cont() { resume(); };  //  replaced by resume()
 
 private:

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2015-2025 Rob Tillaart
+Copyright (c) 2015-2026 Rob Tillaart
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -34,13 +34,16 @@ For longer periods one could cascade CountDown objects, so when one is finished
 Note the CountDown object is as accurate as the underlying **millis()** or **micros()**.
 Interrupts etc. might cause deviations.
 
+Feedback as always is welcome.
+
 
 ### Related
 
+- https://github.com/RobTillaart/CountDown
+- https://github.com/RobTillaart/dateTimeHelpers  formatting date / time strings
 - https://github.com/RobTillaart/printHelpers
 - https://github.com/RobTillaart/stopWatch_RT
-- https://github.com/RobTillaart/CountDown
-- https://github.com/RobTillaart/timing  wrappers around millis() and microc()
+- https://github.com/RobTillaart/timing  wrappers around millis() and micros()
 
 
 ## Interface
@@ -59,6 +62,7 @@ default to MILLIS. See table below.
 - **enum Resolution resolution()** return the current resolution (integer).
 - **char getUnits()** return the current resolution as printable char (u,m,s,M)
 
+
 ### Start / Stop functions
 
 - **bool start(uint32_t ticks)** (re)start in current resolution.
@@ -78,12 +82,14 @@ Obsolete in future (0.4.0).
 - **void cont()** resumes / continue the count down.
 *(note continue is a C-Keyword)*
 
+
 ### Status 
 
 - **uint32_t remaining()** returns the remaining ticks in current resolution.
 - **bool isRunning()** idem.
 - **bool isStopped()** idem.
 
+
 ## Operation
 
 The function **start(days, hours, minutes, seconds)** allows all combinations
@@ -118,6 +124,7 @@ The resolution is implicitly set to **CountDown::MINUTES**.
 |  start(ticks)                          |  MICROS  = micros  |  ~70 min   |  setResolution(CountDown::MICROS)  |
 |  start(ticks)                          |  SECONDS = millis  |  49+ days  |  setResolution(CountDown::SECONDS) |
 |  start(ticks)                          |  MINUTES = millis  |  49+ days  |  setResolution(CountDown::MINUTES) |
+|  start(ticks)                          |  HOURS   = millis  |  49+ days  |  setResolution(CountDown::HOURS)   |
 
 
 The Countdown clock uses by default **millis()** to do the time keeping,
@@ -131,6 +138,7 @@ The parameter **res** can be:
 |  CountDown::MILLIS   |  millis()  |     m        |  default
 |  CountDown::SECONDS  |  millis()  |     s        |
 |  CountDown::MINUTES  |  millis()  |     M        |
+|  CountDown::HOURS    |  millis()  |     H        |
 
 Although possible one should not change the resolution of the CountDown 
 clock while it is running as you mix up different timescales.
@@ -173,10 +181,12 @@ a repeating (timed) function or a watchdog. See examples.
 - add examples
   - visualisations - hexadecimal - alphabetical (radix 26)
   - depends on sensor
-- add resolution::HOURS + **start(days, hours)**
-  - extend adaptive display example
-  - or default 00 minutes?
-- add **void resume()** instead of **cont()**? 
+- implement a CountDown64 class
+  - far longer timespan
+  - inaccurate at best
+  - interesting for longer micros() time span?
+- implement a CountDownRTC class
+  - which RTC?
 
 #### Wont (unless)
 
@@ -196,6 +206,7 @@ a repeating (timed) function or a watchdog. See examples.
 - printable interface (stopwatch_rt)
 - add call-back function when **0** is reached
   - cannot be guaranteed as interface polls.
+- enum State { RUNNING, PAUSED, STOPPED };  // stopped => remaining = 0;
 
 
 ## Support

examples/countdown_DHMS/countdown_DHMS.ino

@@ -15,6 +15,7 @@ void setup()
 {
   //  while(!Serial);  //  uncomment if needed
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("COUNTDOWN_LIB_VERSION: ");
   Serial.println(COUNTDOWN_LIB_VERSION);

examples/countdown_adaptive_display/countdown_adaptive_display.ino

@@ -17,6 +17,7 @@ void setup()
 {
   //  while(!Serial);  //  uncomment if needed
   Serial.begin(115200);
+  Serial.println();
   Serial.println(__FILE__);
   Serial.print("COUNTDOWN_LIB_VERSION: ");
   Serial.println(COUNTDOWN_LIB_VERSION);