From 5a1f0d298f50c411b720d52fea56aa1f047ba637 Mon Sep 17 00:00:00 2001 From: Jarno Rankinen <50285623+0ranki@users.noreply.github.com> Date: Tue, 4 Apr 2023 21:53:06 +0300 Subject: [PATCH 1/4] Update README.md Install instructions 1 --- README.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a4e67ec..1d9a618 100644 --- a/README.md +++ b/README.md @@ -99,7 +99,24 @@ WantedBy=default.target - To let user services continue running after logging out: - `sudo loginctl enable-linger $USER` -Readme will be updated in the near future with physical connection instructions. +### Connecting to the Pingvin unit +- Connect an RS-485 adapter to the computer you intend to run the daemon on + - Tested only on a RPi 4B and Zero W 1 with the Zihatec RS-485 HAT + - You may need terminating resistors in your adapter, see documentation +- Ensure the user has read/write privileges to the serial device. + - No need to run the daemon as root, and it is not recommended + +# Disclaimer: +**I am not responsible of possible damage to your device if you choose to follow these instructions** +**The manufacturer may void your warranty if you choose to follow these instructions** +- Shut down the main power of the unit +- Disconnect the device from mains, discharge any static electricity before proceeding + - A new motherboard seems to cost close to 1000€ + labour +- Open the cover in which the power switch is attached to. No need to disconnect the switch, there +should be enough length in the wires to move the lid with the switch connected out of the way +- Locate the green RS-485 connector on the motherboard + - + Work is part of my Bachelor's Thesis at Oulu University of Applied Sciences. -- 2.40.1 From f31cf085ca22a06ddf6750cc276045eb759f5a13 Mon Sep 17 00:00:00 2001 From: Jarno Rankinen <50285623+0ranki@users.noreply.github.com> Date: Tue, 4 Apr 2023 22:11:45 +0300 Subject: [PATCH 2/4] install instructions continued --- README.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1d9a618..41fec7f 100644 --- a/README.md +++ b/README.md @@ -107,15 +107,31 @@ WantedBy=default.target - No need to run the daemon as root, and it is not recommended # Disclaimer: + **I am not responsible of possible damage to your device if you choose to follow these instructions** + **The manufacturer may void your warranty if you choose to follow these instructions** + - Shut down the main power of the unit - Disconnect the device from mains, discharge any static electricity before proceeding - A new motherboard seems to cost close to 1000€ + labour - Open the cover in which the power switch is attached to. No need to disconnect the switch, there should be enough length in the wires to move the lid with the switch connected out of the way -- Locate the green RS-485 connector on the motherboard - - +- Locate the green RS-485 connector on the motherboard, should be on the right edge + - Schematics available from Enervent at [https://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1](https://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1), page 38 (finnish) +- The connector has a detachable plug part. Grab the top of the connector with plyers and carefully pull it out. This will make attaching the wire much easier +- Connect **A connector to A connector and B to B**. (they are not Tx/Rx like in many other serials) + - **NOTE:** After reading quite a few forum posts, many RS-485 adapters seem to have printed the A and B the wrong way, I wouldn't be surprised if this was the case with Pingvin too. +- Plug the plug back to the Pingvin motherboard and close the cover and screws +- Reconnect mains and switch both devices onhttps://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1 +- Mixing A and B should be safe and won't break anything, but the daemon won't work. If that's the case, disconnect powers again and switch the wires on the RPi. + +### Home Assistant + +- There are so many variations for HASS configs, that definite instructions are hard to do. +- All the YAMLs are intended to be copy-pasted to `configuration.yaml` (or files included to configuration.yaml) +- Change the IP address, port, username and password according to your configuration +- Restart Home Assistant (A full reload doesn't seem to be enough for all REST integration features to update) Work is part of my Bachelor's Thesis at Oulu University -- 2.40.1 From 1d1d2990a45ff6f18e546f255eede1cf474a736b Mon Sep 17 00:00:00 2001 From: Jarno Rankinen <50285623+0ranki@users.noreply.github.com> Date: Tue, 4 Apr 2023 22:21:25 +0300 Subject: [PATCH 3/4] images --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 41fec7f..2448711 100644 --- a/README.md +++ b/README.md @@ -102,8 +102,8 @@ WantedBy=default.target ### Connecting to the Pingvin unit - Connect an RS-485 adapter to the computer you intend to run the daemon on - Tested only on a RPi 4B and Zero W 1 with the Zihatec RS-485 HAT - - You may need terminating resistors in your adapter, see documentation -- Ensure the user has read/write privileges to the serial device. + - You may need terminating resistors in your adapter, see documentation of your adapter. +- Ensure the user you intend to run the daemon as has read/write privileges to the serial device. - No need to run the daemon as root, and it is not recommended # Disclaimer: @@ -117,9 +117,13 @@ WantedBy=default.target - A new motherboard seems to cost close to 1000€ + labour - Open the cover in which the power switch is attached to. No need to disconnect the switch, there should be enough length in the wires to move the lid with the switch connected out of the way +![IMG_20230114_133625](https://user-images.githubusercontent.com/50285623/229897490-33d917be-9dea-4b74-bfed-c7b25f9f45f6.jpg) - Locate the green RS-485 connector on the motherboard, should be on the right edge - Schematics available from Enervent at [https://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1](https://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1), page 38 (finnish) +![IMG_20230114_133824](https://user-images.githubusercontent.com/50285623/229898136-ce7dc020-6c33-4605-86ff-5285000cbbd2.jpg) - The connector has a detachable plug part. Grab the top of the connector with plyers and carefully pull it out. This will make attaching the wire much easier +- Attach wires by tightening the screws in the connector +- There should be available holes to pass the wires through on the top of the electronics compartment - Connect **A connector to A connector and B to B**. (they are not Tx/Rx like in many other serials) - **NOTE:** After reading quite a few forum posts, many RS-485 adapters seem to have printed the A and B the wrong way, I wouldn't be surprised if this was the case with Pingvin too. - Plug the plug back to the Pingvin motherboard and close the cover and screws -- 2.40.1 From 19d4d3d78b286dc413cc59a0d0be428f90200553 Mon Sep 17 00:00:00 2001 From: Jarno Rankinen <50285623+0ranki@users.noreply.github.com> Date: Tue, 4 Apr 2023 22:40:50 +0300 Subject: [PATCH 4/4] images continued --- README.md | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 2448711..8713c8d 100644 --- a/README.md +++ b/README.md @@ -99,19 +99,23 @@ WantedBy=default.target - To let user services continue running after logging out: - `sudo loginctl enable-linger $USER` +*** +# Disclaimer: + +**I am not responsible of possible damage to your device if you choose to follow these instructions** + +**The manufacturer may void your warranty if you choose to follow these instructions** +*** + ### Connecting to the Pingvin unit +#### RPi/computer running the daemon - Connect an RS-485 adapter to the computer you intend to run the daemon on - Tested only on a RPi 4B and Zero W 1 with the Zihatec RS-485 HAT - You may need terminating resistors in your adapter, see documentation of your adapter. - Ensure the user you intend to run the daemon as has read/write privileges to the serial device. - No need to run the daemon as root, and it is not recommended -# Disclaimer: - -**I am not responsible of possible damage to your device if you choose to follow these instructions** - -**The manufacturer may void your warranty if you choose to follow these instructions** - +#### Pingvin - Shut down the main power of the unit - Disconnect the device from mains, discharge any static electricity before proceeding - A new motherboard seems to cost close to 1000€ + labour @@ -121,14 +125,16 @@ should be enough length in the wires to move the lid with the switch connected o - Locate the green RS-485 connector on the motherboard, should be on the right edge - Schematics available from Enervent at [https://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1](https://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1), page 38 (finnish) ![IMG_20230114_133824](https://user-images.githubusercontent.com/50285623/229898136-ce7dc020-6c33-4605-86ff-5285000cbbd2.jpg) -- The connector has a detachable plug part. Grab the top of the connector with plyers and carefully pull it out. This will make attaching the wire much easier +- There should be available outlet holes to pass the wires through on the top of the electronics compartment. +- The connector has a detachable plug part. Grab the top of the connector (the part with the screws) with plyers and carefully pull it out. This will make attaching the wire much easier - Attach wires by tightening the screws in the connector -- There should be available holes to pass the wires through on the top of the electronics compartment - Connect **A connector to A connector and B to B**. (they are not Tx/Rx like in many other serials) - **NOTE:** After reading quite a few forum posts, many RS-485 adapters seem to have printed the A and B the wrong way, I wouldn't be surprised if this was the case with Pingvin too. +![IMG_20230114_133936](https://user-images.githubusercontent.com/50285623/229900176-5bac0027-80c6-4702-ab74-0ff2b9739507.jpg) - Plug the plug back to the Pingvin motherboard and close the cover and screws -- Reconnect mains and switch both devices onhttps://doc.enervent.com/op/op.ViewOnline.php?documentid=940&version=1 -- Mixing A and B should be safe and won't break anything, but the daemon won't work. If that's the case, disconnect powers again and switch the wires on the RPi. +![IMG_20230114_135258](https://user-images.githubusercontent.com/50285623/229899975-45126a64-7344-4ca0-bfba-c4e524ebe2f8.jpg) +- Reconnect mains and switch both devices on +- Mixing A and B should be safe and won't break anything, but the daemon won't work. If that's the case, disconnect power again and switch the wires on the RPi end. ### Home Assistant -- 2.40.1