From a6bbc28e2bfe58924f8b1554f0c18c4fb672e7aa Mon Sep 17 00:00:00 2001
From: Eddy de Vink <github@eddydev.ink>
Date: Thu, 13 Aug 2026 13:20:17 +0200
Subject: [PATCH] Document Linux requirements in README

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 38db630..66b4ffd 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,29 @@ Zonder poortargument zoekt het script de module zelf: het probeert alle
 CH340-poorten met het `id`-commando en gebruikt de eerste die `ID
 usbtoggle-relay` antwoordt — waar de module ook is aangesloten.
 
+## Linux
+
+Het script draait ongewijzigd op Linux. Vereisten:
+
+```bash
+# Fedora / RHEL
+sudo dnf install python3-pyserial
+# Debian / Ubuntu
+sudo apt install python3-serial
+```
+
+De seriële poort is op Linux meestal `/dev/ttyUSB0` en eigendom van
+`root:dialout`. De gebruiker moet in de `dialout`-groep zitten, anders
+weigert het script de poort te openen:
+
+```bash
+sudo usermod -aG dialout $USER
+# opnieuw inloggen om de groep actief te maken
+```
+
+De poortnaam is verder niet relevant: de auto-detectie vindt de module
+zonder dat een pad opgegeven hoeft te worden.
+
 ## Pinnen
 
 | Component | GPIO |