0.3.1 • Published 7 years ago

oyapi v0.3.1

Weekly downloads
4
License
MIT
Repository
github
Last release
7 years ago

oyapi

OyaPi is Raspberry Pi 3 software for monitoring and controlling aeroponics systems. With OyaPi you can schedule grow tent lighting cycles as well as pump misting cycles. OyaPi automatically logs sensor data and provides you with live measurements as well as historical charts.

Sensors

The following sensors are currently supported:

SensorMeasurementImmersibleProtocolCalibration
DS18B20TemperatureYes1-Wire--
Atlas Scientific EZO EC K1Conductivity (EC)YesI2CNeural Net
AM2315Temperature/HumidityNoI2C--
SHT31-DISTemperature/HumidityNoI2C--

Some probes (e.g., EC probes) require calibration for temperature compensation. OyaPi uses an internal neural network for temperature compensation. The OyaPi neural network is more accurate than linear (i.e., 1- or 2-point) approximations commonly used in industry.

Network Dashboard

OyaPi displays summary status of all active OyaPi devices on the local subnet.

Other

  • Software: NodeJS, Vue, Vuetify, SQlite3

Installation

Set up the Raspberry Pi 3 operating system:

  1. Install Rasbpian using Noobs or Noobs Lite on a 16GB Micro SD card (use larger capacity cards if you intend to use a camera). Choose a fast SD card
  2. From a terminal window or console, use sudo raspi-config to configure the following:
    • Change password (for your safety!)
    • Network Options: Change hostname (e.g., bioreactor1)
    • Boot Options: Desktop / CLI : Console (recommended)
    • Localization Options: Change Timezone: (set timezone for scheduling)
    • Interfacing Options: Camera (optional)
    • Interfacing Options: SSH (for remote access)
    • Interfacing Options: I2C (for sensors)
    • Interfacing Options: 1-Wire (for sensors)
    • Finish and Reboot

Install OyaPi

Use ssh to login to your new Raspberry Pi 3 and enter the following commands to install OyaPi (this will take several minutes):

mkdir github
cd github
git clone https://github.com/oyamist/oyapi
cd oyapi
./scripts/oyapi-install.sh

Reboot your Raspberry Pi and use a Chrome browser to access OyaPi using the hostname you configured above (e.g., http://bioreactor1)

Recommended Hardware

OyaPi was developed and tested on a Raspberry Pi 3B+. It will probably work on other Raspberry Pi's. Choose the fastest SD card you can afford. You only need space for logging, so 16GB should be fine. OyaPi was tested using NOOBS. It will probably work on other Linux distros.

One of the issues you will need to deal with is safety. Farming requires water and water around electricity is dangerous. The USA electrical code is quite strict about outdoor voltages. Any voltage exceeding 20V has very strong code requirements. This means that 24V pumps would require installation by licensed electritian. Generally speaking, if you design your system around 12V power and backup you will be fine.

The Raspberry Pi doesn't take 12V. It needs 5V. To get 5V from 12V, just use an LM2596 buck converter available on Amazon.

A very fun project is to set up your grow lights using OyaPi. The AdaFruit https://www.adafruit.com/product/2935 controllable power supply is ideal for this.