SofaPirate · sofian · Jan 8, 2025 · Apr 3, 2024 · Apr 3, 2024 · Jun 9, 2024
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/docs/Alarm.rst b/docs/Alarm.rst
@@ -48,11 +48,11 @@ alarm at random periods of time.
 
 .. doxygenclass:: Alarm
    :project: Plaquette
-   :members: Alarm, isOn, isOff, getInt, get, start, stop, resume, elapsed, progress, isStarted
+   :members: Alarm, isOn, isOff, getInt, get, start, stop, pause, resume, elapsed, progress, isRunning, add, set, onRise, onFall, onChange, clearEvents
 
 |SeeAlso|
 ---------
-- :doc:`Metro`
+- :doc:`Chronometer`
+- :doc:`Metronome`
 - :doc:`Ramp`
-- :doc:`Timer`
-- :doc:`SquareOsc`
+- :doc:`SquareWave`
diff --git a/docs/AnalogIn.rst b/docs/AnalogIn.rst
@@ -25,7 +25,7 @@ Control an LED using a potentiometer.
 
    AnalogOut led(9);
 
-   SineOsc oscillator;
+   SineWave oscillator;
 
    void begin() {}
 

diff --git a/docs/Chronometer.rst b/docs/Chronometer.rst
@@ -0,0 +1,55 @@
+.. include:: defs.hrst
+
+Chronometer
+===========
+
+An analog unit that counts time in seconds. It can be started, stopped, paused, and
+resumed.
+
+|Example|
+---------
+
+Uses a chronometer to change the frequency a blinking LED. Restarts after 10 seconds.
+
+.. code-block:: c++
+
+   #include <Plaquette.h>
+
+   Chronometer chrono;
+
+   DigitalOut led(13);
+
+   SquareOsc osc(1.0); // a square oscillator
+
+   void begin() {
+     chrono.start(); // start chrono
+   }
+
+   void step() {
+     // Adjust oscillator's duty cycle according to current timer progress.
+     osc.frequency(chrono);
+
+     // Apply oscillator to LED state.
+     osc >> led;
+
+     // If the chronometer reaches 10 seconds: restart it.
+     if (chrono >= 10.0)
+     {
+       // Restarts the chronometer.
+       chrono.start();
+     }
+   }
+
+
+|Reference|
+-----------
+
+.. doxygenclass:: Chronometer
+   :project: Plaquette
+   :members: Chronometer, get, start, stop, pause, resume, elapsed, isRunning, add, set
+
+|SeeAlso|
+---------
+- :doc:`Alarm`
+- :doc:`Metronome`
+- :doc:`Ramp`
diff --git a/docs/DigitalIn.rst b/docs/DigitalIn.rst
@@ -58,7 +58,7 @@ one side to pin 2 and the other to ground.
 
 .. doxygenclass:: DigitalIn
    :project: Plaquette
-   :members: DigitalIn, isOn, isOff, pin, mode, getInt, get, debounce, noDebounce, debounceMode, rose, fell, changed, changeState
+   :members: DigitalIn, isOn, isOff, pin, mode, getInt, get, debounce, noDebounce, debounceMode, rose, fell, changed, changeState, onRise, onFall, onChange, clearEvents
 
 |SeeAlso|
 ---------

diff --git a/docs/DigitalOut.rst b/docs/DigitalOut.rst
@@ -39,7 +39,7 @@ Switches off an LED connected in "sink" mode after a timeout.
 
 .. doxygenclass:: DigitalOut
    :project: Plaquette
-   :members: DigitalOut, on, off, toggle, isOn, isOff, smooth, noSmooth, get, getInt, put, pin, mode
+   :members: DigitalOut, on, off, toggle, isOn, isOff, smooth, noSmooth, get, getInt, put, pin, mode, rose, fell, changed, changeState, onRise, onFall, onChange, clearEvents
 
 |SeeAlso|
 ---------

diff --git a/docs/Metro.rst → docs/Metronome.rst b/docs/Metro.rst → docs/Metronome.rst
@@ -1,7 +1,7 @@
 .. include:: defs.hrst
 
-Metro
-=====
+Metronome
+=========
 
 A metronome digital source unit. Emits an "on" signal at a regular pace.
 
@@ -12,7 +12,7 @@ A metronome digital source unit. Emits an "on" signal at a regular pace.
 
    #include <Plaquette.h>
 
-   Metro myMetro(0.5); // a metronome with a half-second duration
+   Metronome myMetro(0.5); // a metronome with a half-second duration
 
    DigitalOut led(13);
 
@@ -31,12 +31,13 @@ A metronome digital source unit. Emits an "on" signal at a regular pace.
 |Reference|
 -----------
 
-.. doxygenclass:: Metro
+.. doxygenclass:: Metronome
    :project: Plaquette
-   :members: Metro, isOn, isOff, getInt, get, rose, fell, changed, changeState, period, frequency, phase
+   :members: Metronome, isOn, isOff, getInt, get, rose, fell, changed, changeState, period, frequency, bpm, phase, onBang, clearEvents
 
 |SeeAlso|
 ---------
+- :doc:`Alarm`
+- :doc:`Chronometer`
 - :doc:`Ramp`
-- :doc:`SquareOsc`
-- :doc:`Timer`
+- :doc:`SquareWave`
diff --git a/docs/MinMaxScaler.rst b/docs/MinMaxScaler.rst
@@ -59,7 +59,7 @@ automatically adapt to incoming sensor values.
 
 .. doxygenclass:: MinMaxScaler
    :project: Plaquette
-   :members: MinMaxScaler, get, put, timeWindow, infiniteTimeWindow, timeWindowIsInfinite, reset, start, stop, isStarted
+   :members: MinMaxScaler, get, put, timeWindow, infiniteTimeWindow, timeWindowIsInfinite, reset, resumeCalibrating, pauseCalibrating, isCalibrating
 
 |SeeAlso|
 ---------

diff --git a/docs/Normalizer.rst b/docs/Normalizer.rst
@@ -45,7 +45,7 @@ Uses a normalizer to analyze input sensor values and detect extreme values.
 
 .. doxygenclass:: Normalizer
    :project: Plaquette
-   :members: Normalizer, get, put, timeWindow, infiniteTimeWindow, timeWindowIsInfinite, reset, start, stop, isStarted, targetMean, targetStdDev, isHighOutlier, isLowOutlier, isOutlier, highOutlierThreshold, lowOutlierThreshold, clamp, noClamp, isClamped
+   :members: Normalizer, get, put, timeWindow, infiniteTimeWindow, timeWindowIsInfinite, reset, resumeCalibrating, pauseCalibrating, isCalibrating, targetMean, targetStdDev, isHighOutlier, isLowOutlier, isOutlier, highOutlierThreshold, lowOutlierThreshold, clamp, noClamp, isClamped
 
 |SeeAlso|
 ---------

diff --git a/docs/PeakDetector.rst b/docs/PeakDetector.rst
@@ -86,7 +86,7 @@ peaks. Toggle and LED each time a peak is detected.
 
 .. doxygenclass:: PeakDetector
    :project: Plaquette
-   :members: PeakDetector, get, put, isOn, triggerThreshold, reloadThreshold, fallbackTolerance, modeInverted, modeCrossing, modePeak, mode
+   :members: PeakDetector, get, put, isOn, triggerThreshold, reloadThreshold, fallbackTolerance, modeInverted, modeCrossing, modePeak, mode, onBang, clearEvents
 
 |SeeAlso|
 ---------

diff --git a/docs/Ramp.rst b/docs/Ramp.rst
@@ -8,21 +8,21 @@ triggered to start transitioning to a target value for a certain duration.
 
 There are two ways to start the ramp.
 
-By calling ``start(from, to, duration)`` the ramp will transition from value ``from`` to
+By calling ``go(from, to, duration)`` the ramp will transition from value ``from`` to
 value ``to`` in ``duration`` seconds.
 
-Alternatively, calling ``start(to, duration)`` will start a transition from the ramp's
+Alternatively, calling ``go(to, duration)`` will start a transition from the ramp's
 current value to ``to`` in ``duration`` seconds.
 
-The following diagram shows what happens to the ramp signal if ``start(5.0, 1.0, 2.0)`` is
-called, followed later by ``start(3.0, 1.0)``:
+The following diagram shows what happens to the ramp signal if ``go(5.0, 1.0, 2.0)`` is
+called, followed later by ``go(3.0, 1.0)``:
 
 .. image:: images/Plaquette-Ramp.png
 
 .. note::
   Ramps also support the use of `easing functions <http://easings.net>`_ in order to
   create different kinds of expressive effects with signals. An easing function can
-  optionally be specified at the end of a ``start()`` command or by calling the
+  optionally be specified at the end of a ``go()`` command or by calling the
   ``easing()`` function.
 
   Please refer to :doc:`this page <easings>` for a full list of available easing functions.
@@ -36,20 +36,22 @@ Sequentially ramps through different values.
 
    #include <Plaquette.h>
 
-   Ramp myRamp(0.0); // the ramp is initialized at zero (0)
+   Ramp myRamp(3.0); // initial duration: 3 seconds
 
    StreamOut serialOut(Serial);
 
    void begin() {
      // Apply an easing function (optional).
      myRamp.easing(easeOutSine);
+     // Launch ramp: ramp from -10 to 10.
+     myRamp.go(-10, 10);
    }
 
    void step() {
      if (myRamp.isFinished())
      {
-       // Restarts the ramp going from current value to a random value in [-10, +10] in 2 seconds
-       myRamp.start(randomFloat(-10, 10), 2.0);
+       // Launch ramp from current value to half, increasing duration by one second.
+       myRamp.go(myRamp / 2, myRamp.duration() + 1);
      }
 
      myRamp >> serialOut;
@@ -61,12 +63,12 @@ Sequentially ramps through different values.
 
 .. doxygenclass:: Ramp
    :project: Plaquette
-   :members: Ramp, get, start, stop, resume, elapsed, progress, isStarted, isFinished, easing, noEasing, to, fromTo
+   :members: Ramp, get, start, stop, pause, resume, elapsed, progress, isRunning, add, set, isFinished, easing, noEasing, to, fromTo
 
 |SeeAlso|
 ---------
 - :doc:`Alarm`
+- :doc:`Chronometer`
 - :doc:`easings`
-- :doc:`Metro`
-- :doc:`Timer`
-- :doc:`TriOsc`
+- :doc:`Metronome`
+- :doc:`TriangleWave`
diff --git a/docs/ServoOut.rst b/docs/ServoOut.rst
@@ -29,7 +29,7 @@ Sweeps the shaft of a servo motor back and forth across 180 degrees.
   ServoOut servo(9);
 
   // Oscillator to make the servo sweep.
-  SineOsc oscillator(2.0);
+  SineWave oscillator(2.0);
 
   void begin() {
     // Position the servo in center.

diff --git a/docs/SineOsc.rst → docs/SineWave.rst b/docs/SineOsc.rst → docs/SineWave.rst
@@ -1,13 +1,13 @@
 .. include:: defs.hrst
 
-SineOsc
-=======
+SineWave
+========
 
 A source unit that can generate a sinusoid or `sine wave <https://en.wikipedia.org/wiki/Sine_wave>`_.
 The signal is remapped to oscillate between 0 and 1 (rather than -1 and 1 as
 the traditional sine wave).
 
-.. image:: images/Plaquette-SineOsc.png
+.. image:: images/Plaquette-SineWave.png
 
 |Example|
 ---------
@@ -20,7 +20,7 @@ Pulses an LED.
 
    AnalogOut led(9);
 
-   SineOsc osc;
+   SineWave osc;
 
    void begin() {
      osc.frequency(5.0); // frequency of 5 Hz
@@ -30,11 +30,11 @@ Pulses an LED.
      osc >> led;
    }
 
-.. doxygenclass:: SineOsc
+.. doxygenclass:: SineWave
    :project: Plaquette
-   :members: SineOsc, period, frequency, phase, amplitude, get
+   :members: SquareWave, get, period, frequency, width, phase, amplitude, bpm, mapTo, shiftBy
 
 |SeeAlso|
 ---------
-- :doc:`SquareOsc`
-- :doc:`TriOsc`
+- :doc:`SquareWave`
+- :doc:`TriangleWave`
diff --git a/docs/SquareOsc.rst → docs/SquareWave.rst b/docs/SquareOsc.rst → docs/SquareWave.rst
@@ -1,18 +1,18 @@
 .. include:: defs.hrst
 
-SquareOsc
-=========
+SquareWave
+==========
 
 A source unit that generates a `square wave <https://en.wikipedia.org/wiki/Square_wave>`_
 signal. The signal can be tuned by changing the ``period`` and/or ``frequency``
-of the oscillation, as well as the ``duty cycle``.
+of the oscillation, as well as the ``width``.
 
-.. image:: images/Plaquette-SquareOsc.png
+.. image:: images/Plaquette-SquareWave.png
 
-The duty cycle represents the proportion of time (expressed as a percentage) in each
+The width represents the proportion of time (expressed as a percentage) in each
 cycle (period) during which the wave is "on".
 
-.. image:: images/Plaquette-SquareOsc-DutyCycle.png
+.. image:: images/Plaquette-SquareWave-Width.png
 
 |Example|
 ---------
@@ -26,21 +26,21 @@ is set to 25%, the LED will stay on for 1 second and then off for 3 seconds.
 
    DigitalOut led(13);
 
-   SquareOsc blinkOsc(4.0);
+   SquareWave blinkOsc(4.0);
 
    void begin() {
-     blinkOsc.dutyCycle(0.25); // Sets the duty cycle to 25%
+     blinkOsc.width(0.25); // Sets the duty cycle to 25%
    }
 
    void step() {
      blinkOsc >> led;
    }
 
-.. doxygenclass:: SquareOsc
+.. doxygenclass:: SquareWave
    :project: Plaquette
-   :members: SquareOsc, period, frequency, phase, amplitude, dutyCycle, getInt, get
-
+   :members: SquareWave, get, period, frequency, width, phase, amplitude, bpm, mapTo, shiftBy
+   
 |SeeAlso|
 ---------
-- :doc:`SineOsc`
-- :doc:`TriOsc`
+- :doc:`SineWave`
+- :doc:`TriangleWave`
diff --git a/docs/Timer.rst b/docs/Timer.rst