YeePHP: add light power control

README.md

@@ -45,7 +45,7 @@ It can as well be used in your 'from scratch' project or in the framework of you
 - [x] Set the color (RGB) of the light
 - [x] Set the light brightness
 - [x] Set the light name
-- [ ] Set the light power (on of off)
+- [x] Set the light power (on of off)
 - [x] Get light infos (partially completed)
 - [ ] Color Flow control
 - [ ] Proper error handling

src/Interfaces/YeePHPInterface.php

@@ -56,6 +56,13 @@ public function getColor(): string;
      */
     public function getName(): string;
 
+    /**
+     * Toggle the light
+     *
+     * @return bool
+     */
+    public function toggle(): self;
+
     /**
      * Set the color of the light
      *
@@ -75,11 +82,19 @@ public function setBrightness(int $amount): self;
     /**
      * Set the light name
      *
-     * @param string $name
+     * @param string $name The name of the light
      * @return $this
      */
     public function setName(string $name): self;
 
+    /**
+     * Set the light on or off
+     *
+     * @param string $power The desired state, can be "on" or "off"
+     * @return $this
+     */
+    public function setPower(string $power): self;
+
     /**
      * Send the parameters to the light.
      * @return bool

src/YeePHP.php

@@ -34,7 +34,8 @@ class YeePHP implements YeePHPInterface
         'toggle',
         'set_bright',
         'set_name',
-        'set_rgb'
+        'set_rgb',
+        'set_power'
     ];
 
     /**
@@ -54,6 +55,9 @@ class YeePHP implements YeePHPInterface
      */
     protected $socket;
 
+    protected string $fadeEffect = 'smooth';
+    protected int $fadeDelay = 300;
+
     /**
      * Light constructor.
      * @param string $ip The light IP
@@ -140,15 +144,22 @@ public function getName(): string
         return $this->getProp('name');
     }
 
+    public function toggle(): self
+    {
+        $this->createJob('toggle', []);
+
+        return $this;
+    }
+
     /**
      * @inheritDoc
      */
     public function setColor(int $hexColor): self
     {
         $this->createJob('set_rgb', [
             $hexColor,
-            'smooth',
-            500
+            $this->fadeEffect,
+            $this->fadeDelay
         ]);
 
         return $this;
@@ -173,13 +184,33 @@ public function setBrightness(int $amount): self
         return $this;
     }
 
+    /**
+     * @inheritDoc
+     */
     public function setName(string $name): self
     {
         $this->createJob('set_name', [$name]);
 
         return $this;
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function setPower(string $power): self
+    {
+        if(!$power === 'on' || !$power === 'off')
+            throw new Exception('Invalid power state: ' . $power);
+
+        $this->createJob('set_power', [
+            $power,
+            $this->fadeEffect,
+            $this->fadeDelay
+        ]);
+
+        return $this;
+    }
+
     /**
      * @inheritDoc
      * @throws Exception