Use custom exception and improved README

README.md

@@ -1,6 +1,6 @@
 # shelly-php-client 
 
-You can use this library to access an API of a Shelly device.
+You can use this library to access the HTTP API of a Shelly device.
 You can find the official API documentation [here](https://shelly-api-docs.shelly.cloud). 
 
 ## Installation
@@ -23,7 +23,7 @@ $client = new \ShellyClient\HTTP\Client('http://192.168.1.10', 'ShellyDeviceLigh
 ```php
 $meter = $client->getMeter();
 $power = $meter->getPower();
-echo "Watt usage: " . $power;
+echo "Current power usage: " . $power;
 ```
 
 ### Power shelly plug "on"
@@ -32,6 +32,41 @@ echo "Watt usage: " . $power;
 $client->getRelay(0, \ShellyClient\Request\RelayRequest::TURN_ON);
 ```
 
+
+### Full example
+
+```php
+// Create new client for one device
+$clientLightA = new \ShellyClient\HTTP\Client('http://192.168.1.10', 'ShellyDeviceLightA');
+$clientLightB = new \ShellyClient\HTTP\Client('http://192.168.1.20', 'ShellyDeviceLightB');
+// Switch device on and get relay data
+$relay = $clientLightA->getRelay(0, \ShellyClient\Request\RelayRequest::TURN_ON);
+// check if timer has been set
+if ($relay->hasTimer()) {
+    // do something
+}
+
+$meter = $clientLightA->getMeter();
+// Get total power consumption in kW/h
+$kilowattHours = $meter->getTotalInKilowattHours();
+// Get last three watt per minute power consumption values
+$counters = $meter->getCounters();
+
+// Parallel call informations from device B
+$power = $clientLightB->getMeter()->getPower();
+// Get device name set above in construct
+$deviceNameDeviceB = $clientLightB->getDeviceName();
+```
+
 ## Supported Platforms
 
 * You need at least PHP 7.4
+
+## Supported APIs
+| API                | Code                    |
+| -------------------|-------------------------|
+| /settings          | $client->getSettings(); |
+| /settings/actions  | $client->getActions();  |
+| /status            | $client->getStatus();   |
+| /meter             | $client->getMeter();    |
+| /relay             | $client->getRelay();    |

lib/Exception/InvalidArgumentException.php

@@ -0,0 +1,10 @@
+<?php
+declare(strict_types=1);
+
+namespace ShellyClient\Exception;
+
+use Exception;
+
+class InvalidArgumentException extends Exception
+{
+}

lib/Request/RelayRequest.php

@@ -3,6 +3,7 @@
 
 namespace ShellyClient\Request;
 
+use ShellyClient\Exception\InvalidArgumentException;
 use ShellyClient\Model\RelayResponse;
 
 class RelayRequest extends RequestAbstract
@@ -16,7 +17,7 @@ class RelayRequest extends RequestAbstract
     public function doRequest(int $relayIndex = 0, string $turn = null): void
     {
         if ($turn !== null && !in_array($turn, [self::TURN_ON, self::TURN_OFF, self::TURN_TOGGLE], true)) {
-            throw new \Exception('Invalid value for turn parameter: ' . $turn);
+            throw new InvalidArgumentException('Invalid value for turn parameter: ' . $turn);
         }
 
         $this->response = $this->client->request('GET', self::METER_ENDPOINT . '/' . $relayIndex, [