doc: Update README

Author: epsilonrt

README.md

@@ -21,7 +21,9 @@ Allows your Arduino to communicate via Modbus protocol
 The Modbus is a master-slave protocol used in industrial automation and can be used in other areas, such as home automation.
 
 The Modbus generally uses serial RS-232 or RS-485 as physical layer (then called Modbus Serial) and
-TCP/IP via Ethernet or WiFi (Modbus TCP).
+TCP/IP via Ethernet or WiFi (Modbus TCP). But it is also possible to associate the Modbus application protocol on any other physical layer, such as the radio for example (with [MobdusRadio](https://github.com/epsilonrt/modbus-radio) for example).
+
+![Modbus Stack](https://github.com/epsilonrt/modbus-arduino/raw/master/extras/modbus-stack.png)
 
 In the current version the library allows the Arduino operate **as a slave**, supporting Modbus Serial and
 Modbus over IP. For more information about Modbus see:
@@ -31,16 +33,7 @@ Modbus over IP. For more information about Modbus see:
 * [MODBUS Messaging on TCP/IP Implementation Guide](http://www.modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf)  
 * [MODBUS over serial line specification and implementation guide ](http://www.modbus.org/docs/Modbus_over_serial_line_V1_02.pdf)
 
-**Author's note (motivation and thanks):**
-
-It all started when I found the Modbus RTU Arduino library of Juan Pablo Zometa. I had extend the
-library to support other Modbus functions.
-
-After researching several other Modbus libraries I realized strengths and weaknesses in all of them.
-I also thought it would be cool have a base library for Modbus and derive it for each type of physical layer used.
 
-I appreciate the work of all the authors of the other libraries, of which I used several ideas to compose the modbus-arduino.
-At the end of this document is a list of libraries and their authors.
 
 ## Features
 
@@ -58,11 +51,20 @@ At the end of this document is a list of libraries and their authors.
     * 0x10 - Write Multiple Registers  
     * 0x11 - Report Server ID
 
+A set of examples is available for each of the Modbus-derived classes, for example:  
+* [Lamp](https://github.com/epsilonrt/modbus-serial/blob/master/examples/Lamp/Lamp.ino): Use a coil to turn on and off a LED (0x05 and 0x01 functions)  
+* [LampDimmer](https://github.com/epsilonrt/modbus-serial/blob/master/examples/LampDimmer/LampDimmer.ino): Use a holding register to control the brightness of a LED (0x06 and 0x03 functions)  
+* [Switch](https://github.com/epsilonrt/modbus-serial/blob/master/examples/Switch/Switch.ino): Use a discrete input to read the state of a switch (0x02 function)  
+* [TempSensor](https://github.com/epsilonrt/modbus-serial/blob/master/examples/TempSensor/TempSensor.ino): Use a input register to read the temperature from a sensor (0x04 function)  
+* [Servo](https://github.com/epsilonrt/modbus-radio/blob/master/examples/Servo/Servo.ino): Use a holding register to control the position of a servo motor (0x06 an 0x03 function). Show how to define boundaries for the register.
+* [LampEncrypted](https://github.com/epsilonrt/modbus-radio/blob/master/examples/LampEncrypted/LampEncrypted.ino): Use a coil to turn on and off a LED (0x05 and 0x01 functions) with encrypted communication.
+
+All examples show the use of 0x11 function to report the slave ID.
+
+
 **Notes:**
 
-1. The offsets for registers are 0-based. So be careful when setting your supervisory system or your testing software. For example, in ScadaBR (http://www.scadabr.com.br)
-offsets are 0-based, then, a register configured as 100 in the library is set to 100 in ScadaBR. On the other hand, in the CAS Modbus Scanner
-(http://www.chipkin.com/products/software/modbus-software/cas-modbus-scanner/) offsets are 1-based, so a register configured as 100 in library should be 101 in this software.
+1. The offsets for registers are 0-based. So be careful when setting your supervisory system or your testing software. If offsets are 1-based, so a register configured as 100 in library should be 101 in this software.
 
 2. Early in the library Modbus.h file there is an option to limit the operation
 to the functions of Holding Registers, saving space in the program memory.
@@ -76,19 +78,37 @@ Thus, only the following functions are supported:
 * 0x06 - Write Single Register  
 * 0x10 - Write Multiple Registers  
 
+You may test the library using the [MbPoll](https://github.com/epsilonrt/mbpoll) software. For example, to turn on the led in the Lamp example, just do:
+
+    $ mbpoll -m rtu -b38400 -a10 -t0   /dev/tnt1 1
+      mbpoll 1.5-2 - ModBus(R) Master Simulator
+      Copyright (c) 2015-2023 Pascal JEAN, https://github.com/epsilonrt/mbpoll
+      This program comes with ABSOLUTELY NO WARRANTY.
+      This is free software, and you are welcome to redistribute it
+      under certain conditions; type 'mbpoll -w' for details.
+
+      Protocol configuration: ModBus RTU
+      Slave configuration...: address = [10]
+                              start reference = 1, count = 1
+      Communication.........: /dev/tnt1,      38400-8E1
+                              t/o 1.00 s, poll rate 1000 ms
+      Data type.............: discrete output (coil)
+
+      Written 1 references.
+
 ## How to
 
-There are four classes corresponding to five headers that may be used:
+There are five classes corresponding to six headers that may be used:
 
 * Modbus-Arduino - Base Library  (this repository)  
 * [Modbus-Serial](https://github.com/epsilonrt/modbus-serial) - Modbus Serial RTU Library    
 * [Modbus-Ethernet](https://github.com/epsilonrt/modbus-ethernet) - Modbus TCP Library (standard Ethernet Shield)   
 * [Modbus-EtherCard](https://github.com/epsilonrt/modbus-ethercard) - Modbus TCP Library (for ENC28J60 chip)  
 * [Modbus-Esp8266AT](https://github.com/epsilonrt/modbus-esp8266at) - Modbus IP Library (for ESP8266 chip with AT firmware)   
+* [Modbus-Radio](https://github.com/epsilonrt/modbus-radio) - Modbus Radio Library (RadioHead compatible chips)  
 
-By opting for Modbus Serial or Modbus TCP you must include in your sketch the corresponding header and the base library header, eg:
+By opting for Modbus Serial, TCP or Radio you must include in your sketch the corresponding header :
 
-    #include <Modbus.h>
     #include <ModbusSerial.h>