Jump to content

Main Page: Difference between revisions

From AOWIS
No edit summary
Tag: Reverted
mNo edit summary
 
(76 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{MainPageBanner}}
{{Header box
| title = Motivation
| color = teal
| body =
[[File:Countryside.jpg|class=fullwidth|center]]
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.
}}


{{MainPageBanner}}
{{Header box
| title = Why an Open Standard is Needed
| color = turquoise
| body =


[[File:Cooperation.jpg|400px|frameless|right]]


= AOWIS – Open Standard for Water & Agricultural Infrastructure =
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.
''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.
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.


== What AOWIS Is ==
AOWIS defines such a foundation for water and agricultural infrastructure under real-world operational constraints.
AOWIS provides a unified framework for designing, operating, and governing water and agricultural infrastructure.
}}
It is built for environments where:


* power is unreliable 
<div class="hbox-row">
* connectivity is intermittent  
{{Header box
* equipment is diverse or aging  
  | title = Operation Conditions of AOWIS
* trained staff may be limited  
  | color = lightblue
* safety and autonomy are essential 
  | body =
[[File:Village.jpg|250px|frameless|right]]


AOWIS enables systems that continue working safely — even when everything else fails.
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


== Why AOWIS Exists ==
AOWIS enables systems that continue to function safely and reliably, even under degraded or adverse conditions.
Many communities rely on infrastructure that is fragile, manually operated, or dependent on unstable networks.
}}
AOWIS addresses this by defining:


* offline‑first operation 
{{Header box
* human‑in‑the‑loop control 
  | title = Facing the Challenges
* safe fallback behavior  
  | color = lightblue
* modular, extensible logic  
  | body =
* shared infrastructure models  
AOWIS addresses these operational challenges through the following principles:
* transparent governance 


The goal is to make essential systems **robust, maintainable, and locally operable**.
* 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'''.
}}
</div>


== How AOWIS Works ==
<div class="hbox-row">
{{Header box
| title = How AOWIS Works
| color = brown
| body =  
AOWIS is built around a three‑layer control model:
AOWIS is built around a three‑layer control model:


Line 54: Line 88:
* Modular and extensible   
* Modular and extensible   
* Transparent and auditable   
* Transparent and auditable   
}}
{{Header box
| title = Start Here
| color = yellow
| body =
If you are new to AOWIS, begin with:
* [[Concepts:Design_Philosophy|Design Philosophy]] 
* [[Standard:Definitions|Definitions]] 
* [[Standard:Normative_Requirements|Normative Requirements]] 
* [[Modules:Module_Template|Module Template]] 
* [[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.
}}
</div>


== Access the Standard ==
{{Header box
| title = Access the Standard
| color = purple
| body =  
The AOWIS standard is organized into dedicated namespaces.   
The AOWIS standard is organized into dedicated namespaces.   
These sections form the technical backbone of the project.
These sections form the technical backbone of the project.


* '''[[Standard:|Standard]]''' – Normative requirements and definitions
* [[Motivation:Main_Page|'''Motivation''']] - Causal justification of design requirements based on real-world failures, constraints, and operational realities
* '''[[Concepts:|Concepts]]''' – Philosophy, rationale, and real‑world context 
* [[Standard:Main_Page|'''Standard''']] – Normative requirements and definitions that specify what AOWIS-compliant systems must do.
* '''[[Architecture:|Architecture]]''' – System structure and controller design 
* [[Concepts:Main_Page|'''Concepts''']] Core ideas, philosophy, and contextual understanding that explain the system but do not prescribe implementation.
* '''[[Infrastructure:|Infrastructure]]''' – Physical systems and components 
* [[Architecture:Main_Page|'''Architecture''']] High-level system structure, including controllers, layers, and their interactions.
* '''[[Measurement:|Measurement]]''' – Sensors, manual readings, derived values
* [[Infrastructure:Main_Page|'''Infrastructure''']] – Physical and deployed systems such as pumps, pipes, valves, energy systems, and field hardware.
* '''[[Data:|Data]]''' – Data models, logs, sync formats
* [[Measurement:Main_Page|'''Measurement''']] Definition and handling of sensor data, manual measurements, calibration, and derived physical values.
* '''[[Operations:|Operations]]''' – Runtime logic and decision hierarchy
* [[Data:Main_Page|'''Data''']] – Data models, schemas, logging structures, synchronization formats, and data lifecycle rules.
* '''[[Modules:|Modules]]''' – Domain‑specific extensions
* [[Operations:Main_Page|'''Operations''']] – Runtime behavior, control logic, state transitions, and decision-making hierarchy during system execution.
* '''[[Databases:|Databases]]''' – Federated knowledge bases
* [[Modules:Main_Page|'''Modules''']] Reusable functional extensions that implement domain-specific capabilities within the system.
* '''[[Governance:|Governance]]''' – Certification, compliance, licensing
* [[Reference:Main_Page|'''Reference''']] – Concrete examples, reference implementations, sample deployments, and illustrative systems.
* '''[[Training:|Training]]''' – Human capacity building
* [[Databases:Main_Page|'''Databases''']] – Federated and distributed knowledge bases, storage backends, and data persistence systems.
* '''[[Reference:|Reference]]''' – Examples, glossary, FAQ 
* [[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]]'''.
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]]


== Start Here ==
At this stage, AOWIS is in an early development and conceptualization phase. The following areas outline the current technical priorities:
If you are new to AOWIS, begin with:


* [[Concepts:Design_Philosophy|Design Philosophy]]
=== Research ===
* [[Standard:Definitions|Definitions]] 
* Decide which [[Architecture:Protocols:Main_Page|Wireless Protocols]] could or should be used for AOWIS.
* [[Standard:Normative_Requirements|Normative Requirements]]
** Result: The first iteration will be built with [[Architecture:Protocols:LoRa/LoRaWAN|LoRaWAN]] and [[Architecture:Protocols:MQTT|MQTT]]
* [[Modules:Module_Template|Module Template]] 
* [[AOWIS:Contributor_Guide|Contributor Guide]]


These pages explain how to read, use, and contribute to the standard.
=== 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 ==
<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 99: Line 173:
* long‑term protection of the standard   
* long‑term protection of the standard   


See: [[Governance:|Governance]].
See: [[Governance:Main_Page|Governance]].
 
}}
----
 
== Real‑World Impact ==
AOWIS is designed for practical use in:


* rural water systems 
{{Header box
* smallholder agriculture  
  | title = Navigation
* community irrigation 
  | color = grey
* livestock and poultry systems  
  | body =
* 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 122: Line 185:
* [[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 10:55, 4 June 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.

How AOWIS Works

AOWIS is built around a three‑layer control model:

  • Field Controller – Local, autonomous, safety‑critical
  • Farm Controller – Coordination, scheduling, logic
  • HQ Controller – Oversight, reporting, governance

Core principles include:

  • Offline‑first
  • Measurement‑driven
  • Fail‑safe by design
  • Human‑operable at all times
  • Modular and extensible
  • Transparent and auditable
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