v1.0.1 to add PWM_StepperControl example

### Releases v1.0.1

1. Add example [PWM_StepperControl](https://github.com/khoih-prog/STM32_PWM/tree/main/examples/PWM_StepperControl) to demo how to control Stepper Motor using PWM

Author: khoih-prog

Diff for: examples/PWM_StepperControl/PWM_StepperControl.ino

@@ -0,0 +1,214 @@
+/****************************************************************************************************************************
+  PWM_StepperControl.ino
+  
+  For STM32F/L/H/G/WB/MP1 boards
+  Written by Khoi Hoang
+
+  Built by Khoi Hoang https://github.com/khoih-prog/STM32_PWM
+  Licensed under MIT license
+
+  Hardware-based multi-channel PWM wrapper library for STM32F/L/H/G/WB/MP1 boards
+  
+  Credits of Paul van Dinther (https://github.com/dinther). Check https://github.com/khoih-prog/RP2040_PWM/issues/16
+*****************************************************************************************************************************/
+
+// Use with Stepper-Motor driver, such as TMC2209
+
+#if !( defined(STM32F0) || defined(STM32F1) || defined(STM32F2) || defined(STM32F3)  ||defined(STM32F4) || defined(STM32F7) || \
+       defined(STM32L0) || defined(STM32L1) || defined(STM32L4) || defined(STM32H7)  ||defined(STM32G0) || defined(STM32G4) || \
+       defined(STM32WB) || defined(STM32MP1) || defined(STM32L5))
+  #error This code is designed to run on STM32F/L/H/G/WB/MP1 platform! Please check your Tools->Board setting.
+#endif
+
+// These define's must be placed at the beginning before #include "ESP32_PWM.h"
+// _PWM_LOGLEVEL_ from 0 to 4
+// Don't define _PWM_LOGLEVEL_ > 0. Only for special ISR debugging only. Can hang the system.
+#define _PWM_LOGLEVEL_      4
+
+#define USING_MICROS_RESOLUTION       true    //false 
+
+#include "STM32_PWM.h"
+
+/////////////////////////////////////////////////
+
+// Change the pin according to your STM32 board. There is no single definition for all boards.
+#define pin0    PA0
+#define pin1    D1
+#define pin2    D2
+#define pin3    D3
+#define pin4    D4
+#define pin5    D5
+#define pin6    D6
+#define pin7    D7
+
+#define pin8    D8
+#define pin9    D9
+#define pin10   D10
+#define pin11   D11
+#define pin12   D12
+#define pin13   D13
+#define pin14   D14
+#define pin15   D15
+#define pin16   D16
+
+//////////////////////////////////////////////////////
+
+// Change the pin according to your STM32 board. There is no single definition for all boards.
+
+#if ( defined(STM32F1) && ( defined(ARDUINO_BLUEPILL_F103CB) || defined(ARDUINO_BLUEPILL_F103C8) ) )
+
+  #warning Using BLUEPILL_F103CB / BLUEPILL_F103C8 pins
+
+  // For F103CB => pin0, pin4, pin10 ============>> TimerIndex = 1, 2, 0
+  #define STEP_PIN        pin3
+  
+#elif ( defined(STM32F7) && defined(ARDUINO_NUCLEO_F767ZI) )
+
+  #warning Using NUCLEO_F767ZI pins
+  
+  // For F767ZI => pin0, pin3, pin9/10 ============>> TimerIndex = 1, 0, 3
+  #define STEP_PIN        pin3
+
+#elif ( defined(STM32L5) && defined(ARDUINO_NUCLEO_L552ZE_Q) )
+
+  #warning Using NUCLEO_L552ZE_Q pins
+  
+  // For NUCLEO_L552ZE_Q => pin0, pin3, pin9/10 ============>> TimerIndex = 1, 0, 3
+  #define STEP_PIN        pin3
+
+#elif ( defined(STM32H7) && defined(ARDUINO_NUCLEO_H743ZI2) )
+
+  #warning Using NUCLEO_H743ZI2 pins
+  
+  // For NUCLEO_L552ZE_Q => pin0, pin3, pin9/10 ============>> TimerIndex = 1, 0, 3
+  #define STEP_PIN        pin3
+
+#else
+
+  // For ??? => pin0, pin3, pin9/10 ============>> TimerIndex = 1, 0, 3
+  #define STEP_PIN        pin3
+
+#endif
+
+//////////////////////////////////////////////////////
+
+#define DIR_PIN         pin1
+
+TIM_TypeDef *stepperTimer;
+
+HardwareTimer *stepper;
+
+uint32_t channel;
+
+int previousSpeed = 0;
+
+// The Stepper RPM will be ( speed * 60 ) / steps-per-rev
+// For example, 28BYJ-48 Stepper Motor (https://lastminuteengineers.com/28byj48-stepper-motor-arduino-tutorial/) has 32 Steps/Rev
+// Speed = 640 Hz => Stepper RPM = (640 * 60 / 32) = 1200 RPM
+void setSpeed(int speed)
+{
+  // Do nothing if same speed
+  if (speed == previousSpeed)
+    return;
+
+  Serial.print(F("setSpeed = "));
+  Serial.println(speed);
+
+  // Create new instance for new speed  
+  if (stepper)
+    delete stepper;
+    
+  stepper = new HardwareTimer(stepperTimer);
+  
+  if (speed == 0)
+  {
+    // Use DC = 0 to stop stepper
+    stepper->setPWM(channel, STEP_PIN, 500, 0, nullptr);
+  }
+  else
+  {
+    //  Set the frequency of the PWM output and a duty cycle of 50%
+    digitalWrite(DIR_PIN, (speed < 0));
+    stepper->setPWM(channel, STEP_PIN, abs(speed), 50, nullptr);
+  }
+
+  previousSpeed = speed;
+}
+
+void initPWM(uint32_t step_pin)
+{
+  // Using pin = PA0, PA1, etc.
+  PinName pinNameToUse = digitalPinToPinName(step_pin);
+
+  // Automatically retrieve TIM instance and channel associated to pin
+  // This is used to be compatible with all STM32 series automatically.
+  stepperTimer = (TIM_TypeDef *) pinmap_peripheral(pinNameToUse, PinMap_PWM);
+
+  if (stepperTimer != nullptr)
+  {
+    uint8_t timerIndex = get_timer_index(stepperTimer);
+
+    // pin => 0, 1, etc
+    channel = STM_PIN_CHANNEL(pinmap_function( pinNameToUse, PinMap_PWM));
+
+    Serial.print("stepperTimer = 0x");
+    Serial.print( (uint32_t) stepperTimer, HEX);
+    Serial.print(", channel = ");
+    Serial.print(channel);
+    Serial.print(", TimerIndex = ");
+    Serial.print(get_timer_index(stepperTimer));
+    Serial.print(", PinName = ");
+    Serial.println( pinNameToUse );
+
+    stepper = new HardwareTimer(stepperTimer);
+
+    // SetPWM object and passed just a random frequency of 500 steps/s
+    // The Stepper RPM will be ( speed * 60 ) / steps-per-revolution
+    // The duty cycle is how you turn the motor on and off
+    previousSpeed = 500;
+    stepper->setPWM(channel, step_pin, previousSpeed, 0, nullptr);
+  }
+  else
+  {
+    Serial.println("ERROR => Wrong pin, You have to select another one. Skip NULL stepperTimer");
+  }  
+}
+
+void setup() 
+{
+  pinMode(STEP_PIN, OUTPUT);
+  digitalWrite(STEP_PIN, LOW);
+  pinMode(DIR_PIN, OUTPUT);
+  digitalWrite(DIR_PIN, LOW);
+  
+  Serial.begin(115200);
+
+  while (!Serial && millis() < 5000);
+
+  delay(100);
+
+  Serial.print(F("\nStarting PWM_StepperControl on "));
+  Serial.println(BOARD_NAME);
+  Serial.println(STM32_PWM_VERSION);
+
+  initPWM(STEP_PIN);
+}
+
+void loop() 
+{
+  // The Stepper RPM will be ( speed * 60 ) / steps-per-rev
+  setSpeed(2000);
+  delay(3000);
+
+  // Stop before reversing
+  setSpeed(0);
+  delay(3000);
+
+  // Reversing
+  setSpeed(-1000);
+  delay(3000);
+
+  // Stop before reversing
+  setSpeed(0);
+  delay(3000);
+}