Skip to content
TheYOSH edited this page Nov 16, 2018 · 34 revisions

What is the default login

The default login name is 'admin' with password 'password'. Make sure you change it after installation at the system setting page.

How to stop TerrariumPI

The software is running in a screen session

  1. Login with the user 'pi'.
  2. Run the command 'screen -r'. This will give a new terminal.
  3. Press 'Ctrl+c' twice within 10 seconds.

How to start TerrariumPI

The software is running in a screen session

  1. Login with the user 'pi'.
  2. Go to the installation directory cd ~/TerrariumPi
  3. Start with sudo ./start.sh

How to restart TerrariumPI

The software is running in a screen session

  1. Login with the user 'pi'.
  2. Run the command 'screen -r'. This will give a new terminal.
  3. Press 'Ctrl+c' and wait 10 seconds.
  4. Use 'Ctrl+a' and then a single 'd' to close the screen session and logout of your Pi

How to debug TerrariumPI

The software is running in a screen session

  1. Login with the user 'pi'.
  2. Run the command 'screen -r'. This will give a new terminal.
  3. Here there could be errors. Mail them or make an issue with the contents of the error.
  4. Use 'Ctrl+a' and then a single 'd' to close the screen session and logout of your Pi

Use and enable NGINX server on port 80

In order to run the webinterface on port 80 in stead of 8090, you can install nginx and use the vhost configuration in the contrib folder. Execute the following commands:

  1. sudo apt install -y nginx
  2. cd /etc/nginx/sites-enabled
  3. sudo rm default
  4. sudo ln -s /home/pi/TerrariumPI/contrib/nginx.conf terrariumpi
  5. sudo service nginx reload

This should make the web interface be accessible on http://[terrariumpi_IP]. Either use port forwarding on your router, or register your pi at dataplicity and use their wormhole feature.

SMTP and/or SSL errors during startup.

If you see the following errors during startup of the software after a reboot, that is somewhat normal. The OS random number generator is not yet ready in order to create secure connections. This will become normal working again after 30 seconds till 1 minute. Just leave the software running and it will become steady.

HTTPSConnectionPool(host='www.yr.no', port=443): Max retries exceeded with url: /place/Netherlands/Provence/City/forecast_hour_by_hour.xml (Caused by SSLError(SSLError("bad handshake: Error([('', 'osrandom_rand_bytes', 'getrandom() initialization failed.')],)",),))

SMTP AUTH extension not supported by server.
2018-07-26 22:59:54,260 - ERROR - terrariumNotificatio - Mailserver login credentials are invalid. Cannot sent mail!

Connection unexpectedly closed: [Errno 104] Connection reset by peer
HTTPSConnectionPool(host='api.pushover.net', port=443): Max retries exceeded with url: /1/users/validate.json?token=[TOKEN] (Caused by SSLError(SSLError("bad handshake: Error([('', 'osrandom_rand_bytes', 'getrandom() initialization failed.')],)",),))
2018-07-27 11:16:57,780 - ERROR  - terrariumNotificatio - TelegramBot has issues: Did not receive valid JSON data

Increase logging

TerrariumPI log all actions in a log file at log/terrariumpi.log. By default it logs INFO, WARNING and ERROR messages. In order to get debug messages change the file: logging.conf and change

[handler_fileHandler]
class=logging.handlers.TimedRotatingFileHandler
level=INFO

to

[handler_fileHandler]
class=logging.handlers.TimedRotatingFileHandler
level=DEBUG

And restart TerrariumPI

How to translate

See the Translation page for creating a new translation

How to test a DHT11, DHT22 or AM2303 sensor

After installation of TerrariumPI there is a folder called 'Adafruit_Python_DHT' in the 'pi' user home folder. Enter the examples folder for a simple test script.

  1. cd ~/Adafruit_Python_DHT/examples
  2. ./AdafruitDHT.py 22 24
  3. Temp=21.6* Humidity=70.6%

Where value 22 is one of: 11 for DHT11 sensor, 22 for DHT22 sensor and 2302 for AM2303 sensor. And 24 is the value of the pin number in BCM mode https://pinout.xyz/

In order to use it with TerrariumPI translate the BCM number to physical layout using https://pinout.xyz/. In the above case the BCM 24 port is physical number 18. Therefore use value 18 in the software.

If the output is out of range, for example humidity is above 100%, this is an indication that the sensor is not working properly and can have a hardware failure. This has to be solved first before using it with TerrariumPI.

Clone this wiki locally