From d8d9919376abb0027dfef1d5fbadc2ccde7b8df5 Mon Sep 17 00:00:00 2001 From: Danfro Date: Mon, 10 Oct 2022 21:19:44 +0200 Subject: [PATCH 1/4] fix typo in shelly integrations card --- shelly/meta.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/shelly/meta.json b/shelly/meta.json index 18b79dc4..ec77f077 100644 --- a/shelly/meta.json +++ b/shelly/meta.json @@ -1,6 +1,6 @@ { "title": "Shelly", - "tagline": "USe Shelly devices with nymea.", + "tagline": "Use Shelly devices with nymea.", "icon": "shelly.png", "stability": "consumer", "offline": true, From 0ebdd46b30b32b33b8f3e1b2b541b819ec8f4641 Mon Sep 17 00:00:00 2001 From: Danfro Date: Mon, 10 Oct 2022 21:20:29 +0200 Subject: [PATCH 2/4] add notes about connecting to shelly plug --- shelly/README.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/shelly/README.md b/shelly/README.md index 25685add..29732bde 100644 --- a/shelly/README.md +++ b/shelly/README.md @@ -22,9 +22,9 @@ The currently supported devices are: * Shelly TRV ## Requirements -The Shelly device needs to be connected to the same WiFi as nymea is in. New Shelly devices will open a WiFi named with -their name as SSID. For instance, a Shelly 1 would appear as "shelly1-XXXXXX". Connect to this WiFi and open the webpage -that will pop up. From there, it can be configured it to connect to the same network where the nymea system is located. +The Shelly device needs to be connected to the same WiFi as nymea is in. New Shelly devices will open a WiFi named with +their name as SSID. For instance, a Shelly 1 would appear as "shelly1-XXXXXX". Connect to this WiFi. For some devices a webpage + will pop up. For others the website needs to be accessed by a local ip e.g. (http://192.168.33.1) for the shelly plug/s. From there, it can be configured to connect to the same network where the nymea system is located. No other options need to be set as they can be configured using nymea later on. @@ -41,8 +41,15 @@ It is recommended to keep the Shelly Button 1 plugged into a power source during it will shut down right after a button press which might interrupt the setup. However, once set up, the Shelly Button 1 will work perfectly fine in the low power mode. +### Note for the Shelly Plug / Plug S +As default the shelly plug starts as wifi access point. To be able to integrate it into nymea, you need to change this behaviour. Open the shelly plugs configuration webpage (http://192.168.33.1). Got to "Internet & Security", select the option "Wifi Mode- Client", tick the box "Connect the Shelly device to an existing WiFi Network" and enter the credentials for that network and press the "SAVE" button. Now the network connection is closed and the shelly plug will try to connect to the specified network. Make sure security settings of your router allow new devices to connect to your wifi. + +Some shelly plugs get sold with an old firmware version installed. Some functionality will be missing. Since some point in 2021, the shelly plug needs to connect to the shelly cloud once to pull firmware updates. So please enable cloud access in the settings under "Internet & Security" -> "Cloud" and wait a few minutes. +If no update does show up, you can force an OTA update by calling the url in your browser generated by (http://archive.shelly-tools.de/). Open that page, provide your devices local ip, select your device and the required version. Copy the generated OTA url in your browser and press return. The new firmware version should then show up in the shelly plugs webpage under "Settings" -> "Firmware update". +If not even this works, you can try a firmware update from a local address. The OTA link from above looks like `http://X.X.X.X/ota?url=http://archive.shelly-tools.de/version/v1.12/SHPLG-S.zip`. Copy the last part after `url=` into your browser and download the firmware file (.zip). Then either use an existing local server or open that folder in terminal and run `python3 -m http.server 9000` to open a local http server on that folder. Then grab the OTA link from above and replace the shelly plugs ip with the ip of your local server/your machine, copy that in your browser and press return. After the update has finished, press `ctrl + c` in the terminal to stop the http server. + ## Plugin properties -When adding a Shelly device that is meant to be installed in walls and has connectors to switches, a new Gateway type device +When adding a Shelly device that is meant to be installed in walls and has connectors to switches, a new Gateway type device representing the Shelly device itself will be added. The gateway device allow basic monitoring (such as the connected state) and interaction (e.g. reboot the Shelly device). In addition to that, a power switch device will appear which will reflect presses on the Shelly's SW input. You can use generic things to connect them to those switches in order to represent your actual From c97f9685a5dd2103b85501a968a92c64ee0a139c Mon Sep 17 00:00:00 2001 From: Danfro Date: Tue, 11 Oct 2022 21:23:20 +0200 Subject: [PATCH 3/4] rephrase website info --- shelly/README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/shelly/README.md b/shelly/README.md index 29732bde..1f5339e5 100644 --- a/shelly/README.md +++ b/shelly/README.md @@ -23,8 +23,7 @@ The currently supported devices are: ## Requirements The Shelly device needs to be connected to the same WiFi as nymea is in. New Shelly devices will open a WiFi named with -their name as SSID. For instance, a Shelly 1 would appear as "shelly1-XXXXXX". Connect to this WiFi. For some devices a webpage - will pop up. For others the website needs to be accessed by a local ip e.g. (http://192.168.33.1) for the shelly plug/s. From there, it can be configured to connect to the same network where the nymea system is located. +their name as SSID. For instance, a Shelly 1 would appear as "shelly1-XXXXXX". Connect to this WiFi and open the webpage that will pop up or manually open http://192.168.33.1. From there, it can be configured to connect to the same network where the nymea system is located. No other options need to be set as they can be configured using nymea later on. From f65af7e691ed37d84931cc04436538d4f12470b3 Mon Sep 17 00:00:00 2001 From: Danfro Date: Tue, 11 Oct 2022 21:34:30 +0200 Subject: [PATCH 4/4] drop sections about wifi setup and local host updates, remove plug ref. --- shelly/README.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/shelly/README.md b/shelly/README.md index 1f5339e5..bbabfb64 100644 --- a/shelly/README.md +++ b/shelly/README.md @@ -40,12 +40,9 @@ It is recommended to keep the Shelly Button 1 plugged into a power source during it will shut down right after a button press which might interrupt the setup. However, once set up, the Shelly Button 1 will work perfectly fine in the low power mode. -### Note for the Shelly Plug / Plug S -As default the shelly plug starts as wifi access point. To be able to integrate it into nymea, you need to change this behaviour. Open the shelly plugs configuration webpage (http://192.168.33.1). Got to "Internet & Security", select the option "Wifi Mode- Client", tick the box "Connect the Shelly device to an existing WiFi Network" and enter the credentials for that network and press the "SAVE" button. Now the network connection is closed and the shelly plug will try to connect to the specified network. Make sure security settings of your router allow new devices to connect to your wifi. - -Some shelly plugs get sold with an old firmware version installed. Some functionality will be missing. Since some point in 2021, the shelly plug needs to connect to the shelly cloud once to pull firmware updates. So please enable cloud access in the settings under "Internet & Security" -> "Cloud" and wait a few minutes. -If no update does show up, you can force an OTA update by calling the url in your browser generated by (http://archive.shelly-tools.de/). Open that page, provide your devices local ip, select your device and the required version. Copy the generated OTA url in your browser and press return. The new firmware version should then show up in the shelly plugs webpage under "Settings" -> "Firmware update". -If not even this works, you can try a firmware update from a local address. The OTA link from above looks like `http://X.X.X.X/ota?url=http://archive.shelly-tools.de/version/v1.12/SHPLG-S.zip`. Copy the last part after `url=` into your browser and download the firmware file (.zip). Then either use an existing local server or open that folder in terminal and run `python3 -m http.server 9000` to open a local http server on that folder. Then grab the OTA link from above and replace the shelly plugs ip with the ip of your local server/your machine, copy that in your browser and press return. After the update has finished, press `ctrl + c` in the terminal to stop the http server. +### Note regarding firmware updates +Some shelly devices get sold with an old firmware version installed. Some functionality will be missing. Since some point in 2021, shelly devices need to connect to the shelly cloud once to pull firmware updates. So please enable cloud access in the settings under "Internet & Security" -> "Cloud" and wait a few minutes. +If no update does show up, you can force an OTA update by calling the url in your browser generated by (http://archive.shelly-tools.de/). Open that page, provide your devices local ip, select your device and the required version. Copy the generated OTA url in your browser and press return. The new firmware version should then show up in the shelly devices webpage under "Settings" -> "Firmware update". ## Plugin properties When adding a Shelly device that is meant to be installed in walls and has connectors to switches, a new Gateway type device