From 7d393eca12e03d1021d987320f81b23a90df1905 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Johan=20B=C3=B6hlin?= Date: Mon, 25 Dec 2023 10:47:23 +0100 Subject: [PATCH] Update some documentation --- README.md | 12 ++++++------ idf_component.yml | 2 +- library.json | 14 +++++++++++++- library.properties | 4 ++-- 4 files changed, 22 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index af4a559..5a2875e 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ [![GitHub release](https://img.shields.io/github/release/Johboh/EspNowNetwork.svg)](https://github.com/Johboh/EspNowNetwork/releases) -Arduino and ESP-IDF compatible library for setting up a network of ESP NOW nodes +Arduino (using Arduino IDE or Platform I/O) and ESP-IDF (using Espressif IoT Development Framework or Platform I/O) compatible library for setting up a network of ESP NOW nodes ### Usage/Purpose The use case for the EspNowNetwork is to run a a [ESP-NOW](https://www.espressif.com/en/solutions/low-power-solutions/esp-now) network for battery powered sensors. @@ -16,20 +16,20 @@ Features: - **Over The Air/OTA**: A node can be updated Over The Air. The node report their firmware version upon handsake, and the host can send back wifi credentials and an URL where to download the new firmware. The node will download the firmware, write it and restart. ### Installation -#### Platform I/O: +#### Platform I/O (Arduino or ESP-IDF): Add the following to `libs_deps`: ``` Johboh/EspNowNetwork ``` -#### ESP-IDF: +#### Espressif IoT Development Framework: In your existing `idf_component.yml` or in a new `idf_component.yml` next to your main component: ``` dependencies: - EspNowNetwork: - git: https://github.com/Johboh/EspNowNetwork.git + johboh/EspNowNetwork: + version: ">=0.4.0" ``` -### Example +### Example (Arduino framework) See [host example](examples/Host/Host.ino) and [node example](examples/Node/Node.ino). ### Functionallity verified on the following platforms and frameworks diff --git a/idf_component.yml b/idf_component.yml index 5651dfe..c1cc40d 100644 --- a/idf_component.yml +++ b/idf_component.yml @@ -1,5 +1,5 @@ version: "0.4.0" -description: Arduino/ESP-IDF library for setting up a network of ESP NOW nodes +description: Library for setting up a network of ESP NOW nodes url: https://github.com/Johboh/EspNowNetwork dependencies: idf: ">=4.4" \ No newline at end of file diff --git a/library.json b/library.json index bbede45..b89ca9d 100644 --- a/library.json +++ b/library.json @@ -1,7 +1,7 @@ { "name": "EspNowNetwork", "keywords": "esp32, esp-now, ESP Now, now", - "description": "Arduino/ESP-IDF library for setting up a network of ESP NOW nodes", + "description": "Library for setting up a network of ESP NOW nodes", "$schema": "https://raw.githubusercontent.com/platformio/platformio-core/develop/platformio/assets/schema/library.json", "authors": { @@ -19,5 +19,17 @@ }, "frameworks": ["espidf", "arduino"], "platforms": ["espressif32"], + "examples": [ + { + "name": "Host", + "base": "examples/host", + "files": ["Host.ino"] + }, + { + "name": "Node", + "base": "examples/Node", + "files": ["Node.ino"] + } + ], "dependencies": [] } \ No newline at end of file diff --git a/library.properties b/library.properties index ae25cf9..393a0e3 100644 --- a/library.properties +++ b/library.properties @@ -2,8 +2,8 @@ name=EspNowNetwork version=0.4.0 author=Johan Böhlin maintainer=Johan Böhlin -sentence=Arduino/ESP-IDF library for setting up a network of ESP NOW nodes -paragraph=Arduino/ESP-IDF library for setting up a network of ESP NOW nodes +sentence=Library for setting up a network of ESP NOW nodes +paragraph=Library for setting up a network of ESP NOW nodes category=Communication url=https://github.com/Johboh/EspNowNetwork architectures=esp32