Update README.md

Author: linomp

README.md

@@ -1,47 +1,47 @@
 # Motion classification application on an Arduino board supporting multiple IoT protocols
 
-Final project of the Summer School on Enabling Technologies for IIoT by University of Pisa, 2022.
-
-The objective is to develop a motion classification application on an arduino board  (using embedded ML capabilities of the hardware) and connect it to the external world either: 
+This is a motion classification application for an arduino board  (using embedded ML capabilities of the hardware) that sends events to the external world either: 
 
 - by sending the events [through MQTT](./mqtt_version)
 - by sending events with the [CoAP protocol](./coap_version/)
-- by wrapping it as a ["Web Thing"](./webthings_version/), and monitoring it via a WebThings Gateway running on a Raspberry Pi
+- by declaring a ["Web Thing"](./webthings_version/) interface, allowing to monitor it via a WebThings Gateway running on a Raspberry Pi
 
+It was my final project at the Summer School on Enabling Technologies for IIoT by University of Pisa, 2022.
 
-### Required Hardware:
+## Requirements
+### Hardware:
 - [Arduino Nano RP2040 connect](https://docs.arduino.cc/hardware/nano-rp2040-connect)
 - [Raspberry Pi for running the WebThings Gateway software](https://webthings.io/docs/gateway-getting-started-guide.html) (Optional)
 
-### Required Libraries:
+### Libraries:
 - [WiFiNINA](https://www.arduino.cc/reference/en/libraries/wifinina/)
 - [STM32duino X-NUCLEO-IKS01A3](https://www.arduino.cc/reference/en/libraries/stm32duino-x-nucleo-iks01a3/3)
 - [ArduinoMqttClient](https://www.arduino.cc/reference/en/libraries/arduinomqttclient/)
 - [CoAP-simple-library](https://www.arduino.cc/reference/en/libraries/coap-simple-library/)
 - [webthing](https://webthings.io/framework/)
 - [ArduinoMDNS](https://github.com/arduino-libraries/ArduinoMDNS)
 
-### Setup:
+### Example setup:
 
-![](./img/setup.jpg)
+<img src="./img/setup.jpg" width="50%">
 
-### Milestones:
+## Features:
 
-- [X] Sending the current motion status through an MQTT topic to a broker running on my personal DigitalOcean cloud server
+- Send the current motion status through an MQTT topic to a broker running on a cloud server. [(See source code)](https://github.com/linomp/rp2040-webthing/blob/main/mqtt_version/mqtt_version.ino)
 
-    ![](./img/demoMqtt.PNG)
+  ![](./img/demoMqtt.PNG)
 
-- [X] Sending the current motion status as a CoAP PUT request to a CoAP test server running on my personal DigitalOcean cloud server
+- Send the current motion status as a CoAP PUT request to a CoAP test server running on a cloud server. [(See source code)](https://github.com/linomp/rp2040-webthing/blob/main/coap_version/coap_version.ino)
 
-    ![](./img/demoCoap.PNG)
+  ![](./img/demoCoap.PNG)
 
-- [X] Sending the current motion status to a WebThings gateway running on a Raspberry Pi on the local network
+- Send the current motion status to a WebThings gateway running on a Raspberry Pi on the local network. [(See source code)](https://github.com/linomp/rp2040-webthing/blob/main/webthings_version/webthings_version.ino)
 
     ![](./img/dashboard.PNG)
     ![](./img/logs.PNG)
 
 
-### References:
+## References:
 
 - [Using the IMU Machine Learning Core Features of the Nano RP2040 Connect](https://docs.arduino.cc/tutorials/nano-rp2040-connect/rp2040-imu-advanced)
 - [Article about Coap by Adafruit](https://learn.adafruit.com/alltheiot-protocols/coap)