AOWIS – Table of Contents

Overview of all AOWIS namespaces and their intended scope.

This document defines the high‑level structure of the AOWIS standard. Each namespace serves a specific purpose within the overall architecture.

Standard:

The normative core of AOWIS. Contains binding requirements, definitions, and compliance rules.

Pages in this namespace include:

Scope of the standard
Normative requirements (MUST/SHOULD/MAY)
Definitions and terminology
Safety rules
Conformance levels
Versioning and change control

Concepts:

Non‑normative explanations of the ideas behind AOWIS. Provides context, philosophy, and rationale.

Typical content:

Design philosophy
Human‑in‑the‑loop principles
Offline‑first operation
Real‑world constraints
Paper‑based operation
Shared infrastructure model

Architecture:

The structural blueprint of AOWIS. Describes how controllers, communication, and logic fit together.

Includes:

System overview
Field Controller architecture
Farm Controller architecture
HQ Controller architecture
Communication model
Data flow diagrams
Security model
State machines

Infrastructure:

Physical systems that AOWIS interacts with. Covers water, power, and mechanical components.

Topics include:

Hydraulics
Pumps and pump protection
Valves and actuators
Water towers and tanks
Distribution networks
Electrical systems
Power constraints

Measurement:

All forms of measurement used by AOWIS, including sensors, manual readings, and derived values.

Sub‑topics:

Electronic sensors (soil moisture, flow meters, tank levels, weather, optical, power)
Manual measurements (dipsticks, visual inspection, paper forms)
Derived measurements (ET₀, flow estimation, soil water balance)
Calibration and drift
Measurement uncertainty

Data:

Data structures, logs, synchronization formats, and documentation models.

Includes:

Data models
Logging formats
Paper forms
Sync protocols
Event types
Audit trails
Data validation rules

Operations:

Runtime behavior and operational logic of AOWIS.

Covers:

Decision hierarchy
Scheduling
Safety logic
Manual intervention
Bypass modes
Fallback behavior
Offline operation

Modules:

Domain‑specific extensions to the AOWIS core. Modules define specialized logic for particular use cases.

Examples:

Crop irrigation
Community water supply
Livestock
Poultry
Greenhouse and hydroponics
Custom modules
Module templates

Databases:

Federated knowledge bases that support AOWIS implementations.

Includes:

AOWIS‑Agro‑DB
AOWIS‑Water‑DB
Hardware database
Device database
Contribution model
Sync model

Governance:

Organizational, legal, and certification aspects of AOWIS.

Topics:

Certification processes
Compliance verification
Licensing
Governance model
Protection strategy

Training:

Human capacity building and operator education.

Includes:

Training programs
Certification levels
Curriculum
Field guides
Operator checklists

Reference:

Non‑normative supporting material.

Contains:

Case studies
Implementation examples
Hardware examples
Glossary
FAQ
Change log

End of AOWIS Table of Contents