• SuperGreenOS
  • Who is this document for
  • Features
• Quickstart
  • Workspace setup
    • Esp-idf setup
    • Clone repo, build and run
    • Connect to wifi
  • Basic concept
  • Key / value
  • Available keys
    • Core keys
    • Controller keys
    • Box keys
    • Led keys

SuperGreenOS provides most features used when growing cannabis, all in one package, and controllable from your smartphone, pc, mac, linux, toaster, plumbus, whatnot...

It is the official firmware for the SuperGreenController.

This document is for developpers that want to start playing with there controller's internal stuffs, or just setup their own hardware. This repository is based on SuperGreenOSBoilerplate, please read the doc here first.

Here's what it can (or will) do:

• Lights on and off schedules
• Up to 6 separate led channels (you can put multiple leds behind one channel)
• Up to 3 separate timers, for full-cycle setups (veg + flo)
• Monitoring a wide range of sensors
• Data sent to a private cloud
• Produce alerts based on sensor values
• Allows remote control (TODO)
• Manual ventilation control
• Automatic ventilation control based on temperature and humidity (TODO)
• Stretch mode, allows to choose how much you want your plant to stretch or thicken
• Sunglass mode, so you don't burn your eyes when you work on your plants
• More to come..

This is the firmware that runs the SuperGreenController.

If you haven't already done it, you'll to setup esp-idf's toolchain and sdk.

They have a very good quickstart here.

Now you should be able to clone and build the firmware:

git clone https://github.com/supergreenlab/SuperGreenOS.git
cd SuperGreenOS
./update_templates.sh config.controller.json
./update_htmlapp.sh config.controller.json
make -j4

The plug your controller or any esp32 based board and run the commands:

make -j4 flash monitor
./write_spiffs.sh

The first command flashes the firmware, the second writes the embedded admin interface on the tiny file system (~20KB available).

Once the firmware is flashed you can access the controller's wifi network, once connected go to http://192.168.4.1/fs/app.html, this will display the html embedded admin interface, which allows you to easily modify any of the controller's parameter.