Update the README with build information and better description

README.md

@@ -1,17 +1,51 @@
-# Type-Safe Rust Wrappers for various ESP-IDF services
+# Safe Rust wrappers for the services in the [ESP IDF SDK](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/)
 
 [![CI](https://github.com/esp-rs/esp-idf-svc/actions/workflows/ci.yml/badge.svg)](https://github.com/esp-rs/esp-idf-svc/actions/workflows/ci.yml)
-![crates.io](https://img.shields.io/crates/v/esp-idf-svc.svg)
+[![crates.io](https://img.shields.io/crates/v/esp-idf-svc.svg)](https://crates.io/crates/esp-idf-svc)
 [![Documentation](https://img.shields.io/badge/docs-esp--rs-brightgreen)](https://esp-rs.github.io/esp-idf-svc/esp_idf_svc/index.html)
 [![Matrix](https://img.shields.io/matrix/esp-rs:matrix.org?label=join%20matrix&color=BEC5C9&logo=matrix)](https://matrix.to/#/#esp-rs:matrix.org)
+[![Wokwi](https://img.shields.io/endpoint?url=https%3A%2F%2Fwokwi.com%2Fbadge%2Fclick-to-simulate.json)](https://wokwi.com/projects/332188235906155092)
 
-This crate contains wrappers which are mostly implementations of the abstractions defined in the [embedded-svc](https://github.com/ivmarkov/embedded-svc) project. It has features such as wifi, networking, httpd, logging.
+## Highlights
+
+* Supports almost all ESP IDF services: timers, event loop, Wifi, Ethernet, HTTP client & server, MQTT, WS, NVS, OTA, etc.
+* Implements the traits of [embedded-svc](https://github.com/esp-rs/embedded-svc)
+* Blocking and `async` mode for each service (`async` support where feasible)
+
+**You might want to also check out the ESP IDF [Drivers](https://github.com/esp-rs/esp-idf-hal) wrappers, and the raw bindings to ESP IDF in the [esp-idf-sys](https://github.com/esp-rs/esp-idf-sys) crate!**
+
+## Build Prerequisites
+
+Follow the [Prerequisites](https://github.com/esp-rs/esp-idf-template#prerequisites) section in the `esp-idf-template` crate.
+
+## Examples
+
+The examples could be built and flashed conveniently with [`cargo-espflash`](https://github.com/esp-rs/espflash/). To run e.g. `wifi` on an e.g. ESP32-C3:
+(Swap the Rust target and example name with the target corresponding for your ESP32 MCU and with the example you would like to build)
+
+with cargo-esptool v1.7:
+```
+$ ESP_IDF_VERSION=release/v4.4 cargo espflash --target riscv32imc-esp-espidf --example wifi --monitor /dev/ttyUSB0
+```
+
+with cargo-esptool v2.0:
+```
+$ ESP_IDF_VERSION=release/v4.4 cargo espflash flash --target riscv32imc-esp-espidf --example wifi --monitor
+```
+
+## Setting up a "Hello, world!" binary crate with ESP IDF
+
+Use the [esp-idf-template](https://github.com/esp-rs/esp-idf-template) project. Everything would be arranged and built for you automatically - no need to manually clone the ESP IDF repository.
+
+## More information
 
 For more information, check out:
 * The [Rust on ESP Book](https://esp-rs.github.io/book/)
-* The [embedded-svc](https://github.com/esp-rs/embedded-svc) project
+* The [ESP Embedded Training](https://github.com/esp-rs/espressif-trainings)
 * The [esp-idf-template](https://github.com/esp-rs/esp-idf-template) project
-* The [esp-idf-sys](https://github.com/esp-rs/esp-idf-sys) project
+* The [embedded-svc](https://github.com/esp-rs/embedded-svc) project
 * The [esp-idf-hal](https://github.com/esp-rs/esp-idf-hal) project
+* The [embedded-hal](https://github.com/rust-embedded/embedded-hal) project
+* The [esp-idf-sys](https://github.com/esp-rs/esp-idf-sys) project
 * The [Rust for Xtensa toolchain](https://github.com/esp-rs/rust-build)
 * The [Rust-with-STD demo](https://github.com/ivmarkov/rust-esp32-std-demo) project