[DESIGN] - Automation Software, Cloud Backend

[JLefebvre55]

Completion is tracked below.

Design Scope

Design and implement all software libraries and scripts for the automation subsystem.

Purpose

The purpose of the automation subsystem software suite is to enable sensor reading, actuator control, camera capture, environment schedule parsing and implementation, and cloud monitoring and control.

Method

See software control flow diagram.

[JLefebvre55]

Background

ToDo

As of Jul 16, 2022

• Computer Software (Raspberry Pi Zero 2 W, TypeScript)

  • Main Menu/Idle State
  • Check env fields on import
  • Camera capture (w/ lighting control)
  • Controller Interface Class
    • Message parsing
    • Publisher start → Pull arduino reset → Revision listener → write initial instructions
    • Implement compile and flash (update) util function
    • Test board-to-board ICSP programming
    • Test automated flashing on revision fail
  • Control Systems Classes
    • PID (Air, Water temp)
    • Bang-Bang (Humidity, Gas Concentration)
  • Cloud Publishing Interface Class
    • Firebase Device Flow, Self-Registration, Key Caching
    • Project, Program Selection
    • MQTT batch publishing (data, error, debug) and subscribing (commands, config aka environment schedule)
      • Direct arduino instruction send via GCP “command”
      • Change data batch from “label:{batch:[{timestamp:..., value:...}, ...]}” to “label:[{timestamp:..., value:...}, ...]” (same for CloudPonics)
  • Local Logging Interface Class

• Microcontroller Software (Arduino Nano, C/C++)

  • More sophisticated sensor/actuator object states (error codes, etc.)
  • Sensor and actuator toJSON method (names, ids, data labels)
  • Include units (str), precision (uint8_t numbers after decimal) in data messages
  • Sensor Interface Classes
    • CO2 Sensor (K30 Extended Range)
    • Air Temp, Hum Sensor (SHT31)
    • Water Temp Sensor
    • Water Pressure Sensor
  • Actuator Interface Classes
    • Lighting
    • Supply Pump, Solenoid
    • Dosage Pumps
    • Peltier TEC
  • JSON messaging, instruction parsing libraries
  • Main Menu/Idle State
  • Accountability (WDT, error/debug codes, software revision checks, unit tests)
    • Upload/wiring (blink)
    • JSON messaging
    • JSON parsing, instruction implementation
    • Sensor unit tests

• Cloud Backend (Google Cloud Platform IoT Core, PubSub; Firebase PubSub, Cloud Functions, Firestore)

  • MQTT subscribing (data, error, debug), send to Firestore
  • MQTT publishing (commands, config selection/updating) from CloudPonics