GY-63_MS5611/libraries/HeartBeat

HeartBeat

Arduino library for a HeartBeat with frequency and duty cycle.

Description

HeartBeat

The HeartBeat library offers a simple heart beat by sending pulses to a digital pin. Typical usage is to blink a (built in) LED as indicator a program is still alive.

The library uses no hardware timer and is based upon micros() so the user is responsible to call the beat() function as often as needed or better even more.

The library allows to set the frequency runtime, so the HeartBeat can be used as a first level debugging tool. Different frequencies can indicate a different state of the program or a different level of some sensor. No heart beat indicates the program is stuck or blocked.

HeartBeatSL

Since version 0.3.0 a derived class HeartBeatSL is added which can
send diagnostic or error patterns. A pattern exists of 1 to 7 HIGH pulses separated by a fixed length LOW pulse. The length of the HIGH pulses can be coded with S and L (short and long). The unit length of the base pulse is determined by the frequency.

If a pattern is started it cannot be overwritten until it is either ready or explicitly stopped. If one wants to repeat a pattern the application has to repeat the call.

HeartBeatDiag

Since version 0.3.0 a derived class HeartBeatDiag is added which can
send diagnostic or error patterns. A pattern exists of 1 to 9 HIGH pulses separated by a fixed length LOW pulse. The (relative) length of the HIGH pulses can be coded between 1 to 9. An example of an SOS pattern is 111333111. The unit length of the base pulse is determined by the frequency.

If a pattern is started it cannot be overwritten until it is either ready or explicitly stopped. If one wants to repeat a pattern the application has to repeat the call.

To keep patterns recognizable one can exaggerate the difference in length. 121 is harder to differentiate than 131, a rule of thumb is to use multiples of 3 (1, 3, 6 and 9) as length.

Many applications only need 2 lengths, short and long (BIOS alike), but the interface allows more. One could start with an extra long HIGH to indicate the start of a pattern or to get attention (think buzzzzzzzer). The variable length can also be used to indicate a level of a measurement.

HeartBeatDiag uses more RAM and PROGMEM than HeartBeatSL.

For more complex patterns, please check my pulsePattern library.

Interface

HeartBeat

The interface of the base HeartBeat consists of the following functions:

• HeartBeat() constructor
• void begin(uint8_t pin, float frequency) to configure the HeartBeat. The default frequency is 1.0
• void setFrequency(float frequency) change the frequency of the pulsing.
  Will not enable or disable the HeartBeat.
  Must be > 0.001 otherwise it will be constrained to 0.001. On the upper side values beyond 10 Hz are hard for humans but are allowed.
• void setDutyCycle(float dutyCycle = 50) duty cycle in percentage time HIGH. Must be between 0.00 and 100.0. A value of 0 will put the heartbeat effectively off.
• float getFrequency() returns set frequency (or constrained value).
• float getDutyCycle() returns set duty cycle (or constrained value).
• void enable() enable the pulsing.
• void disable() disable the pulsing; will switch of the LED.
• void beat() the worker; this function checks if the HeartBeat is enabled and the LED must be toggled.
  It must be called as often as possible to keep a steady pace, at least 4 times the given frequency.
  Not calling beat() effectively stops the heartbeat.
• uint8_t getState() returns the state of the heartbeat. Useful for debugging.

HeartBeatSL

The interface of HeartBeatSL adds of the following functions to HeartBeat:

• HeartBeatSL() constructor
• bool code(const char * str) executes the pattern ONE time. Repeating the pattern means repeating the call. The max supported string length is 7.
• void codeOff() explicitly stops the pattern. Forced stop.

Minimal example

HeartBeatSL HB;

void setup() 
{
  HB.begin(13, 3);  // PIN 13 with frequency 3

  // other setup here
}


void loop()
{
  HB.beat();
  if (some_error) HB.code("LSSLSL");  // ==> L HHHHHH L H L H L HHH 

  // other code here
}

HeartBeatDiag

The interface of HeartBeatDiag adds of the following functions:

• HeartBeatDiag() constructor
• bool code(uint32_t pattern) executes the pattern ONE time. Repeating the pattern means repeating the call. The max supported pattern length is 9.
• void codeOff() explicitly stops the pattern. Forced stop.

Minimal example

HeartBeatDiag HB;

void setup() 
{
  HB.begin(13, 3);  // PIN 13 with frequency 3

  // other setup here
}


void loop()
{
  HB.beat();
  if (some_error) HB.code(6113);  // ==> L HHHHHH L H L H L HHH 

  // other code here
}

Applications

Applications include but are not limited to

• show an alive sign, typical freq of 1 Hz is sufficient.
• show error code by means of different frequencies.
  • 1 Hz = OK
  • 2 Hz = Warning
  • 5 Hz = Error
  • no signal would indicate also an error.
• indicate power e.g. round(amps) - you might need to map the range!
• indicate the volume by increasing heartBeat
• indicate a changing distant - increasing or decreasing.
• Geiger counter style.

With the HeartBeatDiag and HeartBeatSL one can give different more specific "messages" depending on the state of the application or a sensor.

Operation

See examples

Future

• add examples
• test HeartBeatDiag version in more detail.