Include to add

#include <MTobjects.h> // See http://arduino.dansetrad.fr/en/MTobjects

I strongly advise to leave the comment, if another person wanted to try the program, they would have a download link directly. This is valid for all the libraries you use.

Useful comments

micro_second
micro_seconds
inpulse_width
inpulses_width
period_width
periods_width
per_cent
level_and_stop
levels_and_stop
start_with

These comments are words that can be added anywhere and which are ignored by the compiler.

Constructor

MTsoftPWM(pin, 
          inpulseMicrosecond = 10000 µs,
          periodMicrosecond = 20000 µs,
          start = HIGH,
          numberOfChanges = MT_INFINI,
          onStopFunction = NO_ACTION,
          active = MT_ON);

• pin (uint8_t): output pin; all usable (exept A6 and A7 on a Nano witch are input only)
• inpulseMicrosecond (float): inpulse width in milliseconds
• periodMicrosecond (float): period in millisecondes
• start (uint8_t): starting level of the inpulse
  • HIGH → positive inpulses (default)
  • LOW → negative inpulses
• numberOfChange (unsigned long): number of changes before it stops
  • 2 levels_and_stop → only one inpulse (rest then 2 changes)
  • <digital value> levels_and_stop → will do levels_and_stop/2 inpulses
  • MT_INFINI → continuously
• onStopFunction: what happens when numberOfChanges/2 inpulses are done
  • NO_ACTION → nothing happens
  • myFunction → call a function "void myFunction(void) {...}"
• active (boolean): run or not?
  • MT_ON → normal function
  • MT_OFF →stop function (no level changes for the moment)

Useful functions

void setInpulse(float inpulseMicrosecond);
void setDutyCycle(float dutyCycle);
void setPeriod(float periodMicrosecond);
void detach(void);
void attach(void);
void onStop(void);

setInpulse: change the inpulse width
setInpulse: without parameter set inpulse width to 10ms
setDutyCycle: change the inpulse width with a duty cycle
setDutyCycle: without parameter set a 50% duty cycle 50%
setPeriod: change the period
setPeriod: without parameter set a 20ms period (50Hz)
detach: disconnects the pin, it becomes "normal" as a starter (does not erase times programmed)
attach: reconnect the pin, if it was detached
onStop: changes the function called when numberOfChanges/2 inpulses are done

Bonus functions

float getInpulse(void);
float getPeriod(void);
float getDutyCycle(void);
float getResolution(void);
void setNumberOfChanges(unsigned long numberOfChanges);
unsigned long getNumberOfChanges(void);
unsigned long getNumberOfChangesRemains(void);
void stop(void);
void start(void);
boolean getActive(void)

getInpulse: return the inpulse width
getPeriod: return the period
getDutyCycle: return the duty cycle
getResolution: returns the resolution in μs (between 62.5ns and 64μs)
setNumberOfChanges: change the number of changes before stop
getNumberOfChanges: return the programmed number of changes
getNumberOfChangesRemains: returns the number of levels that remains to be made
stop: suspends activity
start: resumes the activity
getActive: retourne true if active

Examples

• Example 1: Flashing of an LED
• Example 2: Flashing and on/off