PucaOS

PucaOS

This project is in development. There are safeguards and failsafes that are yet to be implemented! It should not be used to manage a terrarium in its current state!

PucaOS is an embedded system written for the Arduino Nano ESP32. It includes an accompanying Android app, which allows for remote interfacing with the Arduino. The Arduino takes in measurements from DS18B20 temperature probes and compares them against a saved schedule. Based on these measurements and the configured schedule, the Arduino controls a Tasmota smart plug over the local network using HTTP commands to regulate the terrarium's temperature.

Images

Features

• Temperature reading.
• Create and set custom schedules with:
  1. Custom starting times.
  2. Custom set temperatures.
• Manually control the lamp with manual control mode.

Dependencies

• Mongoose
• DallasTemperature
• OneWire
• Wire
• Adafruit_SSD1306
• Adafruit_GFX

Technologies

• Arduino
• DS18B20
• WiFi
• MQTT
• HTTP
• C/C++
• Kotlin/Java

Included

1. The source code for the Arduino program.
2. The source code for the Android app.
3. The gerbers and KiCad project files for the PCB.
4. The .STEP files for the housing and Stevenson Screen.

Implementation

Clone the repository and setup 'config.h'

git clone https://github.com/SacCno/PucaOS && cd PucaOS/PucaOS-Arduino && cp config.example.h config.h

On Powershell you may have to use this command instead.

git clone https://github.com/SacCno/PucaOS; if ($LASTEXITCODE -eq 0) { Copy-Item PucaOS/PucaOS-Arduino/config.example.h PucaOS/PucaOS-Arduino/config.h }

Arduino

The above command will have copied 'config.example.h' into 'PucaOS-Arduino/' as 'config.h'. This file will be ignored by git so you can safely fill in your details and push commits without sharing your WiFi password! The program will not run if the values in the new 'config.h' are not filled in accurately.

To compile and upload the program onto your Arduino Nano ESP32:

1. Ensure all files are in the same directory as 'PucaOS-Arduino.ino'
2. Open Arduino IDE
3. Click 'File -> Open...'
4. Select 'Puca-OSArduino.ino'
5. Ensure Arduino Nano ESP32 is connected to the computer and that the appropriate board and port are selected in 'tools'
6. Click 'Upload Sketch'
7. On first start-up, open serial monitor in Arduino IDE where you will be prompted to enter your MQTT password.

Android

In Android Studio, open the PucaOS-Android/ folder as a project, and let the gradle build.

License

MIT License - See LICENSE.