feat: 全量同步 254 个常用的 Arduino 扩展库文件

arduino-libs/arduino-cli/libraries/RBD_Timer-master/src/RBD_Timer.cpp

@@ -0,0 +1,109 @@
+// Arduino RBD Timer Library v1.4.0 - Manage many timed events.
+// https://github.com/alextaujenis/RBD_Timer
+// Copyright (c) 2015 Alex Taujenis - MIT License
+
+#include <Arduino.h>
+#include <RBD_Timer.h> // https://github.com/alextaujenis/RBD_Timer
+
+namespace RBD {
+  Timer::Timer() {}
+
+  Timer::Timer(unsigned long value) {
+    setTimeout(value);
+  }
+
+  void Timer::setTimeout(unsigned long value) {
+    _timeout = (value > 0) ? value : 1;
+  }
+
+  unsigned long Timer::getTimeout() {
+    return _timeout;
+  }
+
+  void Timer::setHertz(int value) {
+    // possible to do: manage setHertz in micros() for higher resolution
+    _hertz   = constrain(value, 1, 1000);
+    _timeout = (unsigned long)(1000 / _hertz);
+  }
+
+  int Timer::getHertz() {
+    return _hertz;
+  }
+
+  void Timer::restart() {
+    _waypoint         = millis();
+    _state            = ACTIVE;
+    _has_been_active  = false;
+    _has_been_expired = false;
+  }
+
+  void Timer::stop() {
+    _state = STOPPED;
+  }
+
+  void Timer::expire() {
+    _state = EXPIRED;
+  }
+
+  bool Timer::isActive() {
+    _updateState();
+    return _state == ACTIVE;
+  }
+
+  bool Timer::isExpired() {
+    _updateState();
+    return _state == EXPIRED;
+  }
+
+  bool Timer::isStopped() {
+    return _state == STOPPED;
+  }
+
+  bool Timer::onRestart() {
+    if(isExpired()) {
+      restart();
+      return true;
+    }
+    return false;
+  }
+
+  bool Timer::onActive() {
+    if(!_has_been_active && isActive()) {
+      return _has_been_active = true;
+    }
+    return false;
+  }
+
+  bool Timer::onExpired() {
+    if(!_has_been_expired && isExpired()) {
+      return _has_been_expired = true;
+    }
+    return false;
+  }
+
+  unsigned long Timer::getValue() {
+    return millis() - _waypoint;
+  }
+
+  unsigned long Timer::getInverseValue() {
+    return _timeout - getValue();
+  }
+
+  int Timer::getPercentValue() {
+    if(_timeout == 0) {return 0;}
+    return getValue() / float(_timeout) * 100;
+  }
+
+  int Timer::getInversePercentValue() {
+    return 100 - getPercentValue();
+  }
+
+
+  // private
+
+  void Timer::_updateState() {
+    if(_state == ACTIVE && getValue() >= _timeout) {
+      _state = EXPIRED;
+    }
+  }
+}

arduino-libs/arduino-cli/libraries/RBD_Timer-master/src/RBD_Timer.h

@@ -0,0 +1,42 @@
+// Arduino RBD Timer Library v1.4.0 - Manage many timed events.
+// https://github.com/alextaujenis/RBD_Timer
+// Copyright (c) 2015 Alex Taujenis - MIT License
+
+#ifndef RBD_TIMER_H
+#define RBD_TIMER_H
+
+#include "Arduino.h"
+
+namespace RBD {
+  class Timer {
+    public:
+      Timer();                              // constructor with zero timeout, starts in "expired" state by default
+      Timer(unsigned long value);           // overloaded constructor: provide a setTimeout in milliseconds, starts in "expired" state by default
+      void setTimeout(unsigned long value); // set/change how long the timer will run until it expires in milliseconds
+      void setHertz(int value);             // set/change how many times onRestart will return true in one second
+      void restart();                       // reset and start the timer
+      void stop();                          // stop the timer
+      void expire();                        // expire the timer without changing the timeout
+      bool isActive();                      // check if time is left
+      bool isExpired();                     // returns true if time has run out
+      bool isStopped();                     // returns true if the timer is stopped
+      bool onRestart();                     // returns true if the timer is expired and restarts the timer automatically
+      bool onActive();                      // returns true once the timer is active, then waits for it to expire and go active again
+      bool onExpired();                     // returns true once the timer is expired, then waits for it to go active and expire again
+      unsigned long getTimeout();           // returns the value of setTimeout, which is how long the timer will run until it expires in milliseconds
+      int getHertz();                       // returns the value of setHertz, which is how many times onRestart will return true in one second
+      unsigned long getValue();             // how many milliseconds that have passed since the start of the timer
+      unsigned long getInverseValue();      // how many milliseconds the timer has until finished
+      int getPercentValue();                // how much time has passed as a percentage of the interval
+      int getInversePercentValue();         // how much time is left as a percentage of the interval
+    private:
+      unsigned long _timeout  = 0;          // how long this timer should run for
+      unsigned long _waypoint = 0;          // the point in time the timer was started or reset
+      int _hertz              = 0;          // the value given to setHertz
+      bool _has_been_active   = false;      // helps fire the onActive event only once
+      bool _has_been_expired  = false;      // helps fire the onExpired event only once
+      void _updateState();                  // maintains timer current state, helps eliminate rollover issues
+      enum {ACTIVE, EXPIRED, STOPPED} _state = EXPIRED;  // timer internal states, constructed in "expired" state by default
+  };
+}
+#endif