Skip to content

Commit 72103f4

Browse files
authored
Update README.md
1 parent daf56a9 commit 72103f4

File tree

1 file changed

+19
-20
lines changed

1 file changed

+19
-20
lines changed

README.md

+19-20
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
![homie-esp8266 banner](banner.png)
22

3+
*** THIS IS THE DEVELOPMENT BRANCH FOR Version 3.x.y ***
4+
- See https://github.com/homieiot/homie-esp8266 for current 2.0.y releases
5+
36
Homie for ESP8266
47
=================
58

6-
[![Build Status](https://img.shields.io/circleci/project/github/homieiot/homie-esp8266/develop.svg?style=flat-square)](https://circleci.com/gh/homieiot/homie-esp8266) [![Latest Release](https://img.shields.io/badge/release-v2.0.0-yellow.svg?style=flat-square)](https://github.com/homieiot/homie-esp8266/releases) [![Gitter](https://img.shields.io/gitter/room/Homie/ESP8266.svg?style=flat-square)](https://gitter.im/homie-iot/ESP8266)
9+
[![Build Status](https://img.shields.io/circleci/project/github/homieiot/homie-esp8266/develop-v3.svg?style=flat-square)](https://circleci.com/gh/homieiot/homie-esp8266) [![Latest Release](https://img.shields.io/badge/release-v2.0.0-yellow.svg?style=flat-square)](https://github.com/homieiot/homie-esp8266/releases) [![Gitter](https://img.shields.io/gitter/room/Homie/ESP8266.svg?style=flat-square)](https://gitter.im/homie-iot/ESP8266)
710

811
An Arduino for ESP8266 implementation of [Homie](https://github.com/homieiot/convention), an MQTT convention for the IoT.
912

10-
Currently Homie for ESP8266 implements [Homie 3.0.1](https://github.com/homieiot/convention/releases/tag/v3.0.1)
11-
12-
## Note for v1.x users
13-
14-
The old configurator is not available online anymore. You can download it [here](https://github.com/homieiot/homie-esp8266/releases/download/v1.5.0/homie-esp8266-v1-setup.zip).
13+
This branch of Homie for ESP8266 implements [Homie 3.0.1](https://github.com/homieiot/convention/releases/tag/v3.0.1)
1514

1615
## Download
1716

18-
The Git repository contains the development version of Homie for ESP8266. Stable releases are available [on the releases page](https://github.com/marvinroger/homie-esp8266/releases).
17+
The Git repository contains the development version of Homie for ESP8266. Stable releases are available [on the releases page](https://github.com/homieiot/homie-esp8266/releases).
18+
Note that there is no release of the 3.x.y branch yet. Please use the git repository if you are interested in latest development.
1919

2020
## Using with PlatformIO
2121

@@ -43,6 +43,7 @@ Add the `PIO_FRAMEWORK_ARDUINO_LWIP2_LOW_MEMORY` build flag to ensure reliable O
4343

4444
4. Update dev/platform to staging version:
4545
- [Instruction for Espressif 8266](http://docs.platformio.org/en/latest/platforms/espressif8266.html#using-arduino-framework-with-staging-version)
46+
4647
5. Add development version of "Homie" to project using `platformio.ini` and [lib_deps](http://docs.platformio.org/page/projectconf/section_env_library.html#lib-deps) option:
4748
```ini
4849
[env:myboard]
@@ -51,11 +52,9 @@ board = ...
5152
framework = arduino
5253
build_flags = -D PIO_FRAMEWORK_ARDUINO_LWIP2_LOW_MEMORY
5354

54-
; the latest development branch
55+
; the latest development branch (convention V3.0.x)
5556
lib_deps = https://github.com/homieiot/homie-esp8266.git#develop-v3
5657

57-
; or tagged version
58-
lib_deps = https://github.com/homieiot/homie-esp8266.git#v2.0.0-beta.2
5958
```
6059

6160
-----
@@ -64,20 +63,20 @@ Happy coding with PlatformIO!
6463
## Features
6564

6665
* Automatic connection/reconnection to Wi-Fi/MQTT
67-
* [JSON configuration file](http://homieiot.github.io/homie-esp8266/docs/develop/configuration/json-configuration-file) to configure the device
68-
* [Cute HTTP API / Web UI / App](http://homieiot.github.io/homie-esp8266/docs/develop/configuration/http-json-api) to remotely send the configuration to the device and get information about it
69-
* [Custom settings](http://homieiot.github.io/homie-esp8266/docs/develop/advanced-usage/custom-settings)
70-
* [OTA over MQTT](http://homieiot.github.io/homie-esp8266/docs/develop/others/ota-configuration-updates)
71-
* [Magic bytes](http://homieiot.github.io/homie-esp8266/docs/develop/advanced-usage/magic-bytes)
72-
* Available in the [PlatformIO registry](http://platformio.org/#!/lib/show/555/Homie)
73-
* Pretty straightforward sketches, a simple light for example:
66+
* [JSON configuration file](http://homieiot.github.io/homie-esp8266/docs/develop-v3/configuration/json-configuration-file) to configure the device
67+
* [Cute HTTP API / Web UI / App](http://homieiot.github.io/homie-esp8266/docs/develop-v3/configuration/http-json-api) to remotely send the configuration to the device and get information about it
68+
* [Custom settings](http://homieiot.github.io/homie-esp8266/docs/develop-v3/advanced-usage/custom-settings)
69+
* [OTA over MQTT](http://homieiot.github.io/homie-esp8266/docs/develop-v3/others/ota-configuration-updates)
70+
* [Magic bytes](http://homieiot.github.io/homie-esp8266/docs/develop-v3/advanced-usage/magic-bytes)
71+
* Available in the [PlatformIO registry](http://platformio.org/#!/lib/show/555/Homie) **Please note that this is the latest release from V2 branch** - see above how to use latest v3 version with platformio.
72+
* Pretty straightforward sketches, a simple light for example: (**TODO**: adapt to V3)
7473

7574
```c++
7675
#include <Homie.h>
7776

7877
const int PIN_RELAY = 5;
7978

80-
HomieNode lightNode("light", "Light", "switch");
79+
HomieNode lightNode("light", "switch");
8180

8281
bool lightOnHandler(const HomieRange& range, const String& value) {
8382
if (value != "true" && value != "false") return false;
@@ -98,7 +97,7 @@ void setup() {
9897

9998
Homie_setFirmware("awesome-relay", "1.0.0");
10099

101-
lightNode.advertise("on", "On", "boolean").settable(lightOnHandler);
100+
lightNode.advertise("on").settable(lightOnHandler);
102101

103102
Homie.setup();
104103
}
@@ -110,7 +109,7 @@ void loop() {
110109
111110
## Requirements, installation and usage
112111
113-
The project is documented on http://marvinroger.github.io/homie-esp8266/ with a *Getting started* guide and every piece of information you will need.
112+
The project is documented on https://homieiot.github.io/homie-esp8266/ with a *Getting started* guide and every piece of information you will need.
114113
115114
## Donate
116115

0 commit comments

Comments
 (0)