From f67b2cc418242121feed3fc47bcb7fb40855a632 Mon Sep 17 00:00:00 2001
From: Raul Victor Trombin <raulvtrombin@gmail.com>
Date: Fri, 16 Feb 2024 23:38:16 -0300
Subject: [PATCH] src: lib: Add set_pwm_channel_duty_cycle

---
 src/lib.rs | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/src/lib.rs b/src/lib.rs
index 517a037d4f..9b3c64f9b4 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -481,6 +481,37 @@ impl Navigator {
         self.pwm.set_channel_off(channel.into(), value).unwrap();
     }
 
+    /// Calculate and set the necessary values for the desired Duty Cycle (high value time) of selected channel.
+    ///
+    /// This method also allows the relay mode using a value of 1.0.
+    ///
+    /// # Examples
+    ///
+    /// ```no_run
+    /// use navigator_rs::{Navigator, PwmChannel};
+    ///
+    /// let mut nav = Navigator::new();
+    ///
+    /// nav.init();
+    /// nav.set_pwm_enable(true);
+    ///
+    /// nav.set_pwm_freq_prescale(99); // sets the pwm frequency to 60 Hz
+    /// nav.set_pwm_channel_duty_cycle(PwmChannel::Ch1, 0.50); // sets the duty cycle to 50%
+    /// ```
+    pub fn set_pwm_channel_duty_cycle(&mut self, channel: PwmChannel, duty_cycle: f32) {
+        let duty_cycle = duty_cycle.max(0.0).min(1.0);
+        let max_value = 4095;
+
+        if approx::relative_eq!(duty_cycle, 1.0) {
+            self.pwm.set_channel_full_on(channel.into(), 0).unwrap();
+            return;
+        }
+
+        let value = (duty_cycle * max_value as f32) as u16;
+
+        self.set_pwm_channel_value(channel, value);
+    }
+
     /// Like [`set_pwm_channel_value`](struct.Navigator.html#method.set_pwm_channel_value). This function
     /// sets the Duty Cycle for a list of multiple channels.
     ///