Jump to content

Main Page: Difference between revisions

From AOWIS
Tags: Reverted Visual edit
mNo edit summary
 
(90 intermediate revisions by the same user not shown)
Line 1: Line 1:
= AOWIS – Open Standard for Water & Agricultural Infrastructure =
{{MainPageBanner}}
''AOWIS is an open technical standard for safe, reliable, offline‑capable water and agricultural systems in low‑resource environments.''


AOWIS defines how infrastructure can be operated by sensors, humans, or both — even with unstable power, limited connectivity, and minimal technical support.
{{Header box
| title = Motivation
| color = teal
| body =


----
[[File:Countryside.jpg|class=fullwidth|center]]


== What AOWIS Is ==
In less developed regions, such as rural areas and small towns in Africa, water distribution remains a significant challenge. While NGOs have been successfully supporting communities for decades by drilling wells, installing pumps, and sometimes building water towers, distributing water across a network on the surface is often difficult.
AOWIS provides a unified framework for designing, operating, and governing water and agricultural infrastructure.
It is built for environments where:


* power is unreliable 
Local initiatives that take on these projects frequently encounter a situation where operating the system manually becomes unsustainable, requiring constant attention. Qualified personnel are scarce, and suitable technology to support automated or semi-automated operation is either unavailable under local constraints or too expensive.
* connectivity is intermittent 
* equipment is diverse or aging 
* trained staff may be limited 
* safety and autonomy are essential 


AOWIS enables systems that continue working safely — even when everything else fails.
This is where AOWIS aims to contribute: by providing an open standard for designing, deploying, and managing water and agricultural infrastructure in such environments. AOWIS supports both the planning phase—helping initiatives evaluate and design systems based on regional conditions such as topography—and the operational phase, including system monitoring, control, and maintenance.


----
In addition, AOWIS aims to support the training of local technicians and to collaborate closely with experienced NGOs and local initiatives that already operate and maintain such systems, in order to improve sustainability and reduce operational burden.
}}


== Why AOWIS Exists ==
{{Header box
Many communities rely on infrastructure that is fragile, manually operated, or dependent on unstable networks.  
| title = Why an Open Standard is Needed
AOWIS addresses this by defining:
| color = turquoise
  | body =


* offline‑first operation 
[[File:Cooperation.jpg|400px|frameless|right]]
* human‑in‑the‑loop control 
* safe fallback behavior 
* modular, extensible logic 
* shared infrastructure models 
* transparent governance 


The goal is to make essential systems **robust, maintainable, and locally operable**.
In environments where infrastructure is built over decades by many different actors using solutions from different vendors and manufacturers, systems become fragmented, forcing operators to manage multiple incompatible tools and workflows while making daily operation, maintenance, expansion, and staff training increasingly complex and costly.


----
This fragmentation often results in vendor lock-in, where systems depend on specific tools, expertise, or suppliers that may not remain available over the full lifecycle of the infrastructure.


== How AOWIS Works ==
An open standard provides a shared technical foundation that enables interoperability and ensures systems can be maintained and extended independently of any single product or provider.
AOWIS is built around a three‑layer control model:


* '''Field Controller''' – Local, autonomous, safety‑critical 
AOWIS defines such a foundation for water and agricultural infrastructure under real-world operational constraints.
* '''Farm Controller''' – Coordination, scheduling, logic 
}}
* '''HQ Controller''' – Oversight, reporting, governance 


Core principles include:
<div class="hbox-row">
{{Header box
| title = Operation Conditions of AOWIS
| color = lightblue
| body =
[[File:Village.jpg|250px|frameless|right]]


* Offline‑first 
AOWIS is designed to operate under the real-world conditions faced by local initiatives. These include, among others:
* Measurement‑driven 
* Fail‑safe by design 
* Human‑operable at all times 
* Modular and extensible 
* Transparent and auditable 


----
* unreliable power supply
* intermittent connectivity
* diverse or aging equipment
* limited availability of trained personnel
* the need for safety and autonomous operation


== Access the Standard ==
AOWIS enables systems that continue to function safely and reliably, even under degraded or adverse conditions.
The AOWIS standard is organized into dedicated namespaces. 
}}
These sections form the technical backbone of the project.
 
{{Header box
| title = Facing the Challenges
| color = lightblue
| body =  
AOWIS addresses these operational challenges through the following principles:


* '''[[Standard:|Standard]]''' – Normative requirements and definitions 
* human-in-the-loop control
* '''[[Concepts:|Concepts]]''' – Philosophy, rationale, and real‑world context 
* offline-first operation
* '''[[Architecture:|Architecture]]''' – System structure and controller design 
* safe fallback behavior
* '''[[Infrastructure:|Infrastructure]]''' – Physical systems and components 
* modular and extensible logic
* '''[[Measurement:|Measurement]]''' – Sensors, manual readings, derived values 
* shared infrastructure models
* '''[[Data:|Data]]''' – Data models, logs, sync formats 
* training programs for local operators
* '''[[Operations:|Operations]]''' – Runtime logic and decision hierarchy 
* transparent governance
* '''[[Modules:|Modules]]''' – Domain‑specific extensions 
* '''[[Databases:|Databases]]''' – Federated knowledge bases 
* '''[[Governance:|Governance]]''' – Certification, compliance, licensing 
* '''[[Training:|Training]]''' – Human capacity building 
* '''[[Reference:|Reference]]''' – Examples, glossary, FAQ 


For a full overview, see the '''[[AOWIS:Table_of_Contents|Table of Contents]]'''.
The goal is to make essential systems '''robust, maintainable, and locally operable'''.
}}
</div>


----
<div class="hbox-row">


== Start Here ==
{{Header box
| title = Start Here
| color = yellow
| body =
If you are new to AOWIS, begin with:
If you are new to AOWIS, begin with:


Line 81: Line 81:
* [[Standard:Normative_Requirements|Normative Requirements]]   
* [[Standard:Normative_Requirements|Normative Requirements]]   
* [[Modules:Module_Template|Module Template]]   
* [[Modules:Module_Template|Module Template]]   
* [[AOWIS:Contributor_Guide|Contributor Guide]]
* [[AOWIS:Contributor_Guide_External|Contributor Guide - External]]
* [[AOWIS:Contributor_Guide_Internal|Contributor Guide - Internal]]
* [[AOWIS:Writing_Style_Guide|Writing Style Guide]]
* [[AOWIS:AI_Usage_Guide|AI Usage Guide]]
* [[AOWIS:Research_Form_Guide|Research Form Guide]]
* [[AOWIS:Naming_Convention_Specification|Naming Convention Specification]]
* [[AOWIS:Change_Log__Versioning|Change Log & Versioning]]
* [[AOWIS:Wiki|This Wiki]]


These pages explain how to read, use, and contribute to the standard.
These pages explain how to read, use, and contribute to the standard.
}}
{{Header box
| title = List of Requirement Pages
| color = brown
| body =
This index lists AOWIS pages that define normative requirements (MUST/SHOULD/MAY statements) and conformance rules.
'''Dev Rules''' — specs for writing and maintaining AOWIS
* '''REQ-AI:''' [[AOWIS:AI_Usage_Guide|AI Usage Guide]]
'''Technical Standard''' — system behavior and data models
* '''REQ-MEAS, REQ-MEAS-UI:''' [[Measurement:Units|Unit System Requirements]]
* '''REQ-MEAS-UNI:''' [[Measurement:Unit_Identifiers|Unit Identifiers]]
}}
</div>
{{Header box
| title = Access the Standard
| color = purple
| body =
The AOWIS standard is organized into dedicated namespaces. 
These sections form the technical backbone of the project.
* [[Motivation:Main_Page|'''Motivation''']] - Causal justification of design requirements based on real-world failures, constraints, and operational realities
* [[Standard:Main_Page|'''Standard''']] – Normative requirements and definitions that specify what AOWIS-compliant systems must do.
* [[Concepts:Main_Page|'''Concepts''']] – Core ideas, philosophy, and contextual understanding that explain the system but do not prescribe implementation.
* [[Architecture:Main_Page|'''Architecture''']] – High-level system structure, including controllers, layers, and their interactions.
* [[Infrastructure:Main_Page|'''Infrastructure''']] – Physical and deployed systems such as pumps, pipes, valves, energy systems, and field hardware.
* [[Measurement:Main_Page|'''Measurement''']] – Definition and handling of sensor data, manual measurements, calibration, and derived physical values.
* [[Data:Main_Page|'''Data''']] – Data models, schemas, logging structures, synchronization formats, and data lifecycle rules.
* [[Operations:Main_Page|'''Operations''']] – Runtime behavior, control logic, state transitions, and decision-making hierarchy during system execution.
* [[Modules:Main_Page|'''Modules''']] – Reusable functional extensions that implement domain-specific capabilities within the system.
* [[Reference:Main_Page|'''Reference''']] – Concrete examples, reference implementations, sample deployments, and illustrative systems.
* [[Databases:Main_Page|'''Databases''']] – Federated and distributed knowledge bases, storage backends, and data persistence systems.
* [[Governance:Main_Page|'''Governance''']] – Rules for certification, compliance, auditing, trust, licensing, and organizational control structures.
* [[Training:Main_Page|'''Training''']] – Human skill development, operator training, documentation literacy, and capacity building systems.
* [[External:Main_Page|'''External''']] - External projects, standards, technologies, and systems that relate to or influence AOWIS.
For a full overview, see the '''[[AOWIS:Table_of_Contents|Table of Contents]]'''.
}}


----
{{Header box
| title = Roadmap
| color = grey
| body =
[[File:Boring.jpg|250px|frameless|right]]


== Governance & Legitimacy ==
At this stage, AOWIS is in an early development and conceptualization phase. The following areas outline the current technical priorities:
 
=== Research ===
* Decide which [[Architecture:Protocols:Main_Page|Wireless Protocols]] could or should be used for AOWIS.
** Result: The first iteration will be built with [[Architecture:Protocols:LoRa/LoRaWAN|LoRaWAN]] and [[Architecture:Protocols:MQTT|MQTT]]
 
=== Hardware ===
* Develop sensors for measuring water levels in reservoirs.
* Develop voltage monitoring to support sizing and management of solar battery systems.
* Design mechanisms for emergency shutdown of electrical systems within milliseconds in case of overvoltage or critical faults.
** This should be done low-tech with regular electrician solutions.
 
=== Software ===
* Begin conceptualization of the core controller.
** The controller must be capable of modeling and evaluating complex graphs representing water distribution networks in real time, enabling dynamic adaptation to changing conditions.
}}
 
<div class="hbox-row">
{{Header box
| title = Governance & Legitimacy
| color = turquoise
| body =  
AOWIS includes a transparent governance model to ensure:
AOWIS includes a transparent governance model to ensure:


Line 95: Line 171:
* long‑term protection of the standard   
* long‑term protection of the standard   


See: [[Governance:|Governance]].
See: [[Governance:Main_Page|Governance]].
}}


----
{{Header box
 
| title = Navigation
== Real‑World Impact ==
  | color = grey
AOWIS is designed for practical use in:
  | body =
 
* rural water systems  
* smallholder agriculture  
* community irrigation 
* livestock and poultry systems 
* greenhouses and controlled environments 
 
Case studies and implementation examples can be found in the [[Reference:|Reference]] namespace.
 
----
 
== Navigation ==
* [[AOWIS:Table_of_Contents|Table of Contents]]   
* [[AOWIS:Table_of_Contents|Table of Contents]]   
* [[Reference:Glossary|Glossary]]   
* [[Reference:Glossary|Glossary]]   
Line 118: Line 183:
* [[Reference:Change_Log|Change Log]]   
* [[Reference:Change_Log|Change Log]]   


----
* [https://github.com/aowis-org GitHub]
}}
</div>
 
{{Header box
| title = Partners
| color = indigo
| body =
[[File:Afriticgroup.webp|250px|frameless|center|link=https://afriticgroup.com/]]
}}


''AOWIS is an open, evolving standard. Contributions are welcome.''
''AOWIS is an open, evolving standard. Contributions are welcome. For contact, please visit us on [https://github.com/aowis-org GitHub]''

Latest revision as of 21:20, 13 July 2026

AOWIS – Afritic Open Standard for Water & Agricultural Infrastructure

AOWIS (Afritic Open Water Infrastructure Standard) is an open technical standard for safe and reliable water and agricultural infrastructure, designed for low-resource environments.

It defines how systems are operated through sensors and actuators, either autonomously, manually, or in combination. AOWIS is designed to function under conditions such as unstable power, limited connectivity, and minimal technical support, supporting both online and offline operation.

Motivation

In less developed regions, such as rural areas and small towns in Africa, water distribution remains a significant challenge. While NGOs have been successfully supporting communities for decades by drilling wells, installing pumps, and sometimes building water towers, distributing water across a network on the surface is often difficult.

Local initiatives that take on these projects frequently encounter a situation where operating the system manually becomes unsustainable, requiring constant attention. Qualified personnel are scarce, and suitable technology to support automated or semi-automated operation is either unavailable under local constraints or too expensive.

This is where AOWIS aims to contribute: by providing an open standard for designing, deploying, and managing water and agricultural infrastructure in such environments. AOWIS supports both the planning phase—helping initiatives evaluate and design systems based on regional conditions such as topography—and the operational phase, including system monitoring, control, and maintenance.

In addition, AOWIS aims to support the training of local technicians and to collaborate closely with experienced NGOs and local initiatives that already operate and maintain such systems, in order to improve sustainability and reduce operational burden.

Why an Open Standard is Needed

In environments where infrastructure is built over decades by many different actors using solutions from different vendors and manufacturers, systems become fragmented, forcing operators to manage multiple incompatible tools and workflows while making daily operation, maintenance, expansion, and staff training increasingly complex and costly.

This fragmentation often results in vendor lock-in, where systems depend on specific tools, expertise, or suppliers that may not remain available over the full lifecycle of the infrastructure.

An open standard provides a shared technical foundation that enables interoperability and ensures systems can be maintained and extended independently of any single product or provider.

AOWIS defines such a foundation for water and agricultural infrastructure under real-world operational constraints.

Operation Conditions of AOWIS

AOWIS is designed to operate under the real-world conditions faced by local initiatives. These include, among others:

  • unreliable power supply
  • intermittent connectivity
  • diverse or aging equipment
  • limited availability of trained personnel
  • the need for safety and autonomous operation

AOWIS enables systems that continue to function safely and reliably, even under degraded or adverse conditions.

Facing the Challenges

AOWIS addresses these operational challenges through the following principles:

  • human-in-the-loop control
  • offline-first operation
  • safe fallback behavior
  • modular and extensible logic
  • shared infrastructure models
  • training programs for local operators
  • transparent governance

The goal is to make essential systems robust, maintainable, and locally operable.

List of Requirement Pages

This index lists AOWIS pages that define normative requirements (MUST/SHOULD/MAY statements) and conformance rules.

Dev Rules — specs for writing and maintaining AOWIS

Technical Standard — system behavior and data models

Access the Standard

The AOWIS standard is organized into dedicated namespaces. These sections form the technical backbone of the project.

  • Motivation - Causal justification of design requirements based on real-world failures, constraints, and operational realities
  • Standard – Normative requirements and definitions that specify what AOWIS-compliant systems must do.
  • Concepts – Core ideas, philosophy, and contextual understanding that explain the system but do not prescribe implementation.
  • Architecture – High-level system structure, including controllers, layers, and their interactions.
  • Infrastructure – Physical and deployed systems such as pumps, pipes, valves, energy systems, and field hardware.
  • Measurement – Definition and handling of sensor data, manual measurements, calibration, and derived physical values.
  • Data – Data models, schemas, logging structures, synchronization formats, and data lifecycle rules.
  • Operations – Runtime behavior, control logic, state transitions, and decision-making hierarchy during system execution.
  • Modules – Reusable functional extensions that implement domain-specific capabilities within the system.
  • Reference – Concrete examples, reference implementations, sample deployments, and illustrative systems.
  • Databases – Federated and distributed knowledge bases, storage backends, and data persistence systems.
  • Governance – Rules for certification, compliance, auditing, trust, licensing, and organizational control structures.
  • Training – Human skill development, operator training, documentation literacy, and capacity building systems.
  • External - External projects, standards, technologies, and systems that relate to or influence AOWIS.

For a full overview, see the Table of Contents.

Roadmap

At this stage, AOWIS is in an early development and conceptualization phase. The following areas outline the current technical priorities:

Research

Hardware

  • Develop sensors for measuring water levels in reservoirs.
  • Develop voltage monitoring to support sizing and management of solar battery systems.
  • Design mechanisms for emergency shutdown of electrical systems within milliseconds in case of overvoltage or critical faults.
    • This should be done low-tech with regular electrician solutions.

Software

  • Begin conceptualization of the core controller.
    • The controller must be capable of modeling and evaluating complex graphs representing water distribution networks in real time, enabling dynamic adaptation to changing conditions.
Governance & Legitimacy

AOWIS includes a transparent governance model to ensure:

  • open participation
  • clear certification processes
  • stable versioning
  • long‑term protection of the standard

See: Governance.

Partners

AOWIS is an open, evolving standard. Contributions are welcome. For contact, please visit us on GitHub