Physical connection instructions

2023-04-04 22:41:47 +03:00 · 2023-04-04 22:41:47 +03:00 · 87482c793a
parent 789a92e2e4 19d4d3d78b
commit 87482c793a
1 changed files with 44 additions and 1 deletions
--- a/README.md
+++ b/README.md
@ -99,7 +99,50 @@ 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.
+***
+# 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
+
+#### 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
+- 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)
+- 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
+- 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
+![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
+
+- 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
 of Applied Sciences.