From d688cd3d26816fb9577ad91514a507dda6ffac9d Mon Sep 17 00:00:00 2001
From: Martin Preuss <martin@aquamaniac.de>
Date: Mon, 16 Mar 2026 18:03:13 +0100
Subject: [PATCH] work on documentation.

---
 README.md | 39 ++++++++++++++++++++++++++++++++-------
 1 file changed, 32 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 8d2e9c1..5a203bd 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,39 @@
 
 # Aquamaniac Home Control System (AqHCS)
 
+## Quickstart
+
+### Prerequisites
+
+To compile the project the following software needs to be installed:
+- gwenhywfar (general purpose library, also containing some development tools)
+- avrasm (Opensource avr assembler)
+- gcc  (GNU C compiler)
+
+
+### Building
+
+- download and unpack this project
+- cd into the main folder
+- create a build folder (e.g. "mkdir build")
+- cd into that "build" folder
+- configure package for building ("gwbuild -s ../")
+- build autogenerated files ("gwbuild -p" and "gwbuild -Btm2builder")
+- build project ("gwbuild -j NUM_OF_CPUS")
+- install project ("sudo gwbuild -i")
+
+
 ## Overview
 
-Home automation/control system consists of multiple parts:
+See https://gitea.aqbanking.de/martin/aqhome/wiki for more information (in German).
+
+The Aquamaniac Home automation/control system consists of multiple parts:
 - nodes
+  - small PCBs with AVR microcontrollers, for now:
+    - AtTiny84
+    - AtTiny85
+    - AtTiny841
+    - AtMega644
   - decentralized, nodes just broadcast measured data over a two-wire
     communication network (clock/data), addresses are auto-assigned, no prior 
     setup necessary, no central bottleneck or single point of failure
@@ -12,11 +41,6 @@ Home automation/control system consists of multiple parts:
     - environmental measuring (temperature, humidty, CO2 and others)
     - motion detection, door/window sensors
     - LED strip controllers
-  - small PCBs based on AVR microcontrollers
-    - AtTiny84
-    - AtTiny85
-    - AtTiny841
-    - AtMega644
   - modular operating system written in AVR assembler
   - event-driven GUI
   - driver modules for busses:
@@ -24,12 +48,13 @@ Home automation/control system consists of multiple parts:
     - two-wire-bus
     - SPI bus
     - UART
-  - driver modules for devices/sensors:
+  - driver modules for devices/sensors (incomplete list):
     - DS18b20  sensors for temperature measurement
     - SI7021   sensors for temperature and humidity measurement
     - SGP_30   sensors for air quality measurement
     - ccs811   sensors for air quality measurement
     - SK6812   LED driver
+    - ds3231   realtime clock module
     - I2C displays (work-in-progress)
     - SPI displays (work-in-progress)