-
-
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/GNOME.png b/docs/GNOME.png
deleted file mode 100644
index dad3734..0000000
Binary files a/docs/GNOME.png and /dev/null differ
diff --git a/docs/RPi.png b/docs/RPi.png
deleted file mode 100644
index 7975ced..0000000
Binary files a/docs/RPi.png and /dev/null differ
diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle
index 9926106..60799f5 100644
Binary files a/docs/build/doctrees/environment.pickle and b/docs/build/doctrees/environment.pickle differ
diff --git a/docs/build/doctrees/index.doctree b/docs/build/doctrees/index.doctree
index 1d37c5d..545e0a3 100644
Binary files a/docs/build/doctrees/index.doctree and b/docs/build/doctrees/index.doctree differ
diff --git a/docs/build/html/.buildinfo b/docs/build/html/.buildinfo
index bf351ee..46cf52b 100644
--- a/docs/build/html/.buildinfo
+++ b/docs/build/html/.buildinfo
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: f8da516a4c01458efcaab50cf2a597cf
+config: a9222a8de56e8140ddb3be6ef6c463bd
tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/build/html/_sources/index.rst.txt b/docs/build/html/_sources/index.rst.txt
index 3911c55..e434dc8 100644
--- a/docs/build/html/_sources/index.rst.txt
+++ b/docs/build/html/_sources/index.rst.txt
@@ -3,9 +3,7 @@ minihil
**minihil** is development device which can be used for HWIL.
-The README is used to introduce the tool and provide instructions on
-how to install the tool, any machine dependencies it may have and any
-other information that should be provided before the tool is installed.
+The docs introduce the tool and provide instructions on how to install, build, and use the MiniHIL software.
.. toctree::
:hidden:
@@ -23,33 +21,97 @@ other information that should be provided before the tool is installed.
.. |Documentation Status| image:: https://readthedocs.org/projects/minihil/badge/?version=latest
:target: https://minihil.readthedocs.io/projects/minihil/en/latest/?badge=latest
-Installation
--------------
+About minihild
+--------------
-Navigate to release `page`_ download and extract release archive.
+The core of the software is ``minihild`` — a POSIX C++ daemon running as a server on the Raspberry Pi target. It listens for incoming connections on TCP port ``9000`` and parses **JSON-RPC 2.0** commands. It controls the **Waveshare Relay Board (B)** (an 8-channel relay board) via standard Linux character device GPIO controls (``libgpiod`` v2).
-.. _page: https://github.com/electux/minihil/releases
+It is designed with a decoupled architecture to allow easy expansion (e.g. adding WebSockets) and supports **Software-in-the-Loop (SIL) simulation** so that you can compile and test the server and its API directly on your local developer PC without Raspberry Pi hardware.
-To install **minihil** type the following
+SIL (Software-in-the-Loop) Host Build
+-------------------------------------
+
+To compile and run the daemon locally on your developer PC in SIL mock mode:
+
+Prerequisites
+~~~~~~~~~~~~~
+Install the required JSON header libraries:
.. code-block:: bash
- in progress
+ sudo apt-get install nlohmann-json3-dev
+
+Compile and Run
+~~~~~~~~~~~~~~~
+.. code-block:: bash
-Dependencies
--------------
+ # Configure and compile using CMake
+ cmake -B sw/minihil/build -S sw/minihil
+ cmake --build sw/minihil/build
-**minihil** requires next modules and libraries
- in progress
+ # Start the mock daemon
+ ./sw/minihil/build/minihild
-Project structure
-------------------
+The daemon will boot in SIL mode and print:
+``[SilRelayController] Software-in-the-Loop simulation initialized.``
-**minihil** is based on POP.
+Yocto Image Build (Raspberry Pi Target)
+---------------------------------------
+MiniHIL packages ``minihild`` into a custom Yocto Linux image (``minihil-image``) using ``meta-raspberrypi`` and Poky.
+
+Prerequisites
+~~~~~~~~~~~~~
+Ensure your build host has all required packages for Yocto Scarthgap (refer to ``sw/rpi-base-platform/README.md`` for the list of packages).
+
+Compile target image
+~~~~~~~~~~~~~~~~~~~~
.. code-block:: bash
- in progress
+ # 1. Initialize environment (sources Poky and sets up configs/layers)
+ source sw/setup-env.sh
+
+ # 2. Trigger the bitbake build
+ bitbake minihil-image
+
+This compiles the C++ application, bundles the systemd daemon config (``minihil.service``) to start automatically on boot, and outputs a flashable image.
+
+JSON-RPC 2.0 API Specification
+------------------------------
+
+You can send JSON-RPC text frames (terminated by ``\n``) to port ``9000``.
+
+set_relay
+~~~~~~~~~
+Energize or de-energize a relay channel (1 to 8):
+
+* **Request**:
+
+ .. code-block:: json
+
+ {"jsonrpc": "2.0", "method": "set_relay", "params": {"relay_id": 3, "state": true}, "id": 1}
+
+* **Response**:
+
+ .. code-block:: json
+
+ {"jsonrpc": "2.0", "result": {"relay_id": 3, "state": true, "success": true}, "id": 1}
+
+get_relays
+~~~~~~~~~~
+Query states of all 8 relay channels:
+
+* **Request**:
+
+ .. code-block:: json
+
+ {"jsonrpc": "2.0", "method": "get_relays", "id": 2}
+
+* **Response**:
+
+ .. code-block:: json
+
+ {"jsonrpc": "2.0", "result": {"1": false, "2": false, "3": true, "4": false, "5": false, "6": false, "7": false, "8": false}, "id": 2}
Copyright and licence
----------------------
@@ -62,5 +124,10 @@ Copyright and licence
.. |License: Apache 2.0| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
:target: https://opensource.org/licenses/Apache-2.0
-Copyright (C) 2020 by `electux.github.io/minihil