From bcedcdac2f093379346e57bb331af655a777d77d Mon Sep 17 00:00:00 2001 From: Fatima Idrees Date: Tue, 27 May 2025 10:54:38 +0300 Subject: [PATCH] Updating --- Documentation/README.md | 33 +++++++++++++++++++++++++++++++++ Images/5.png | Bin 0 -> 31271 bytes README.md | 24 ++++++++++-------------- 3 files changed, 43 insertions(+), 14 deletions(-) create mode 100644 Documentation/README.md create mode 100644 Images/5.png diff --git a/Documentation/README.md b/Documentation/README.md new file mode 100644 index 0000000..750bb3a --- /dev/null +++ b/Documentation/README.md @@ -0,0 +1,33 @@ +# Steps of Developing the Motor Library +--- + +## Version 01: + +![](../Images/1.png) + +Created two separate functions for testing: +- One function to turn the fan motor on or off +- Another function to set the motor speed + +--- + +## Version 02: + +![](../Images/2.png) + +Combined both actions into a single function and tested the new approach. + +--- + +## Version 03: + +![](../Images/4.png) + +Updated the speed control to use a percentage value. +The function now converts the percentage to a value between 0 and 1023 using PWM for smoother speed control. + +--- + +## Usage Example: +![](../Images/5.png) +A way to test the Library! diff --git a/Images/5.png b/Images/5.png new file mode 100644 index 0000000000000000000000000000000000000000..1a3b1fc1035d7a851b1626f8a5142809472f9697 GIT binary patch literal 31271 zcmc$F^;eW(*R_a9mkcE(Akr;e(h`D%wA2hG4N7;%&>e!bNO$MJFmx#cGUQN7=g@rP z^Ss~t{R!U>vsm}N?sdnx&e`W&dvBuOYbX=qJ;!_W=n}2C1s3`k*X6CD`=dwCKL7h+EL$^pJ$mHb zsiGjO>t(wC70XK(-hTgp%B$E$`1*8iBPcw}WyQjqb%V4&dAUY5zrku*KVWR_=r9g? zqJr}TCpe4^7uQt;vHWlvU_qQBMOKt(-H(!*JY?K6^gV1sja7OE*3aGc(1|Q62<+0Kio_i1Jk^Xk5%}5I(FT3YM=AtDJs4~3`ayIPn%qOaM-x<$AF)^v5QPaDY7Cs;MaXDLm@urBm#U{&lo0h-K3P4%)uP z5bbIgkxcgpxw$PB6|2C|P!FVJE&VwVtx|&=82BqHU4R##P!onka;#srs-h1$G}QeF zSzq;plj*ELqwShp-L@iK^5InUY7*;be@)#G4LK3W{%Vz0HwX599@;kuA(`T`(ieiK zrSBflOOeX@J#ncu?(FC5mr9Y0Gb@;kHqFSGT|5(n6t&IV8FX08Y!wzJ;_9V~MN9pW z)CpO!x-r0Ulxcub#+p8qrLyVjr0SiUZ$wX7nih#_JZTk`!oMGP^ow)se3db@pt89t zR!1xOO1F0yH*HnCx}Fv_73C%>a6m}w`6+0Yv%Sw3?seJ5qa3v@tZ+%MY;s9n{0h2o z_E8J4skj{u5bzPBwzGR1oq!J3i|U)N08JQhvqhAz`PBtc4OqUYqSw*S%1fP%xP~22 zir4xYdDVx^&)23$zg*~IYmD3dlKkk}>ZOrrQ>&EUg~s47cV7}34{8xWfoeoo3S!?FXMB0TC=8daTuZ>`|+h!lLI_4NZ49I+03SBvhqnks#9 zG=EFjW3)Tj_2i(B5c>QiHM!qxye<6{hfC

h;1aGKyLNWvE3smmsswD}L-egIGbD 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