add PwmOut examples

Author: maciejbocianski

APIs_Drivers/PwmOut_ex_1/README.md

@@ -0,0 +1,5 @@
+# PwmOut example
+
+This example shows how to use PwmOut to modulate LED blinking.
+
+**Note**: Set the cycle time first, then set the duty cycle using either a relative time period via the write() function or an absolute time period using the pulsewidth() function.

APIs_Drivers/PwmOut_ex_1/main.cpp

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2017-2020 Arm Limited and affiliates.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include "mbed.h"
+
+// Adjust pin name to your board specification.
+// You can use LED1/LED2/LED3/LED4 if any is connected to PWM capable pin,
+// or use any PWM capable pin, and see generated signal on logical analyzer.
+PwmOut led(LED2);
+
+int main()
+{
+    // specify period first, then everything else
+    led.period(4.0f);  // 4 second period
+    led.write(0.50f);  // 50% duty cycle
+    while (1);         // led flashing
+}

APIs_Drivers/PwmOut_ex_2/README.md

@@ -0,0 +1,5 @@
+# PwmOut example
+
+This example shows how to use PwmOut to modulate LED blinking.
+
+**Note**: Set the cycle time first, then set the duty cycle using either a relative time period via the write() function or an absolute time period using the pulsewidth() function.

APIs_Drivers/PwmOut_ex_2/main.cpp

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2017-2020 Arm Limited and affiliates.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include "mbed.h"
+
+// Adjust pin name to your board specification.
+// You can use LED1/LED2/LED3/LED4 if any is connected to PWM capable pin,
+// or use any PWM capable pin, and see generated signal on logical analyzer.
+PwmOut led(LED2);
+
+int main()
+{
+    // specify period first, then everything else
+    led.period(4.0f);  // 4 second period
+    led.pulsewidth(2); // 2 second pulse (on)
+    while (1);         // led flashing
+}

APIs_Drivers/PwmOut_ex_3/README.md

@@ -0,0 +1,6 @@
+# PwmOut example
+
+This example shows how to use PwmOut to modulate LED blinking.
+
+**Note**: Set the cycle time first, then set the duty cycle using either a relative time period via the write() function or an absolute time period using the pulsewidth() function.
+

APIs_Drivers/PwmOut_ex_3/main.cpp

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2014-2020 Arm Limited and affiliates.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include "mbed.h"
+
+// Adjust pin name to your board specification.
+// You can use LED1/LED2/LED3/LED4 if any is connected to PWM capable pin,
+// or use any PWM capable pin, and see generated signal on logical analyzer.
+PwmOut led(LED1);
+
+int main()
+{
+    // specify period first
+    led.period(4.0f);      // 4 second period
+    led.write(0.50f);      // 50% duty cycle, relative to period
+    //led = 0.5f;          // shorthand for led.write()
+    //led.pulsewidth(2);   // alternative to led.write, set duty cycle time in seconds
+    while (1);
+}