Differences

This shows you the differences between two versions of the page.

--- buster:porridge [2021/04/14 23:08] – slack
+++ buster:porridge [2021/05/05 15:14] (current) – slack
@@ Line 1: / Line 1: @@
+**Deprecated: use [[https://github.com/repent/porridge/blob/master/README.md|README.md]].**
 Ensure your user is a member of ''gpio''.
+====== Dependencies ======
 Install
   * RVM
   * ruby
-  * rails
+  * Create a gemset that reflects .ruby-gemset (and 'rvm use 3.0.0@rails6131 --default ?)
+  * install rails into that gemset
   * ''gem update bundle''
-''rpi_gpio'' v0.5.0 won't install through bundle (April 2021).  [[https://github.com/ClockVapor/rpi_gpio/issues/22|Here's why]].
+''rpi_gpio'' v0.5.0 won't install through bundle (April 2021).  [[https://github.com/ClockVapor/rpi_gpio/issues/22|Here's why]].  Locking to v0.4.0 seems to work at the moment (in Gemfile).
+====== Installation ======
+===== System configuration =====
+In ''/boot/config.txt'', a ''dtoverlay'' line has to be added for every pin to which one or more 1-wire thermometers are added:
+  # 1-Wire interface for 18B20 thermometers (can add as many of these as you like, in theory)
+  # 3.21: having difficulty with gpiopin 4
+  # For the breadboard setup (4.21):
+  dtoverlay=w1-gpio,gpiopin=5
+  dtoverlay=w1-gpio,gpiopin=13
+  # For the downstairs PCB (first version, tested working 20.4.21):
+  #dtoverlay=w1-gpio,gpiopin=5
+  #dtoverlay=w1-gpio,gpiopin=10
+And reboot to take effect.
+===== Daemon =====
+**The daemon relies on ''~/.porridge'' for basic configuration.  If you don't make sure that this is in place, then ''systemd'' will log to ''/var/log/daemon.log'' by default.**  (And it will try localhost:80 for the API server.)
+The daemon uses systemd.  This means that porridged.system needs to be linked from ''/etc/systemd/system/porridged.service''.
+To enable the daemon from boot, ''systemctl enable porridged'' as root.  For this to work, the .service needs an ''[Install]'' section that includes a "target" -- a point in the boot process at which it should be loaded.  ''systemctl get-default'' tells you the default, ''systemctl list-units --type=targets'' lists all of the options.  [[https://www.pragmaticlinux.com/2020/08/raspberry-pi-startup-script-using-systemd/|More]].
+  ln -s /home/slack/porridge/porridged.service /etc/systemd/system/
+  systemctl daemon-reload
+  systemctl enable porridged
+  systemctl status porridged
+  systemctl start porridged
+The ''.service'' needs to use the RVM wrapper script, [[https://rvm.io/integration/cron|as if it were being launched from ''cron'']].  This needs to be updated with newer versions of ruby (or new gemsets).
+===== API Server =====
+====== Updates ======
+===== Updating ruby =====
+  * New wrapper needed in porridged.service
+===== Updating rails =====
+====== Troubleshooting ======
+  * Thermometers are plugged in but none are recognised
+    * Have you set ''dtoverlay'' correctly?