Jump to content

AOWIS:Table of Contents

From AOWIS
Revision as of 13:45, 5 September 2026 by Samuel (talk | contribs) (Infrastructure:)

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 technologies, systems, components, and engineering principles used in AOWIS deployments. Infrastructure pages describe classes of physical systems rather than specific implementation blueprints. Specific implementation blueprints go to "Reference Implementations" instead.

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 Implementations:

Non‑normative supporting material.

Contains:

  • Case studies
  • Implementation examples
  • Hardware examples
  • Glossary
  • FAQ
  • Change log

End of AOWIS Table of Contents