Home

Terraduino Wiki

Terraduino is a configurable automation controller for homestead resource and environmental systems built around Arduino-compatible microcontrollers. The current version is Simple-Homestead-Arduino v0.7.2.0.

The current design uses registered objects and attachments to model homestead-specific reservoir, transfer, environmental, and scheduling behavior.

A useful way to think about the system is:

Sensors → Measurements → Triggers / Balancers → Actuators

For stored resources:

Reservoirs ← Actuator Attachments → Reservoirs

The scheduler evaluates that object graph and keeps the required transfer or conditioning actuators active.

Main Pages

• Controller Overview - Controller lifecycle, registered object families, persistence, and subsystem layout
• Objects & Data - Identity, registration, attachments, persistence, factory reconstruction, and calibration
• Actuators - Relay, transfer-pump, variable actuators, activation handles, and reservoir/rail attachments
• Sensors - Analog, binary, remote, and domain-specific measurement sensors
• Reservoirs - Water/thermal reservoirs, infinite sources/sinks, transfer attachments, state triggers, and scheduler flow
• Environment & Thermal - Environmental sensors, MQTT weather stations, thermal reservoirs, heaters, and circulators
• Rails - Shared electrical capacity and regulated power limits
• Triggers - Measurement value/range conditions with de-trigger tolerance and delay
• Balancers & Scheduling - Linear-edge balancing and automatic reservoir stage scheduling
• Measurements & Publishing - Measurement records, polling frames, logger output, CSV publishing, MQTT, and remote freshness
• Extra Goodies Supplied - Examples, host tests, support tools, optional UI, and networking

Object Model

Terraduino currently has four registered object families:

• Actuators
• Sensors
• Reservoirs
• Rails

Relationships are represented with attachments and object linkages. A pump connection, for example, is not a separate route object: the transfer actuator points at its source and destination reservoirs.

Subobjects such as triggers and balancers attach to those registered objects but do not create another parallel registry.

Offline First

Normal reservoir control, sensor polling, scheduling, logging, and local storage do not require an Internet connection.

Networking is enabled only when the installation needs WiFi/Ethernet access, MQTT publishing, remote UI, or another external service.

Safety Boundary

Terraduino can supervise pumps, valves, heaters, circulators, and shared power limits.

It does not replace pressure relief, pump protection, motor overloads, thermal cutoffs, backflow prevention, mains protection, or other independent safety systems required by the physical installation.