chore: readme expand

README.md

@@ -1,3 +1,56 @@
-# rpi-charon
+# Akarton TV
 
-Systemec Raspberry Pi Remote File Transfer Program
+Systemec Akarton Raspberry Pi TV Program  
+Pi, Raspberry, Raspberry Pi = De Raspberry Pi hardware  
+
+## Digest
+
+AkartonTV (of SystemecTV) is een programma of opstelling van verschillende softwarepakketten die het mogelijk maken om videos en presentaties op een willekeurig scherm af te spelen.  
+Dit wordt mogelijk gemaakt door kleine computers, vaak Single-Board Computers (SBC) die Linux gebruiken.  
+
+In het geval van dit project is het opgesteld in 2 gedeeltes, algemene installatie - waarbij Raspberry Pi devices als standaard worden gemarkeerd.  
+
+## Installatie Raspberry
+
+De manier waarop een Raspberry Pi (het liefst 5 of hoger) wordt geinstalleerd is:  
+
+Operating System Configuratie:
+- Gebruik de Raspberry Pi Imager (v2+).
+- Flash Raspberry Pi OS (64-bit) op de bijgeleverde SD-kaart.
+- Bij het aangeven van de hostnaam is de policy om het bestaande formaat te gebruiken: RPI-<KLANT>-<NR> (Voorbeeld: RPI-AKAR-01).
+- Localisatie is relevant voor de locatie waar de Raspberry Pi terrecht komt.
+- Bij het aanmaken van een gebruiker is er niet een verplichte gebruikersnaam en wachtwoord maar het is wel essentieel dat de gekozen gebruikersnaam en wachtwoord ergens worden genoteerd.
+- WiFi configureren is altijd handig maar niet verplicht wanneer er een Ethernet kabel aanwezig is.
+- SSH MOET aanstaan, en hierbij moet enkel 'use password authentication' aangevinkt zijn.
+- Raspberry Pi Connect is niet nodig.
+
+Vervolgens wordt de SD-kaart door de applicatie klaargemaakt.  
+Zodra dit klaar is kan je de SD-kaart in de Raspberry stoppen en aanzetten - vervolgens zou de Raspberry moeten booten naar een desktop omgeving  
+
+In deze omgeving moet je [dit script uitvoeren, met sudo](./install.sh). Hoe je het script op de Pi krijgt is iets wat zelf beslist kan worden.  
+Een aantal voorbeelden om het script over te brengen:
+- SCP/SFTP/SSH
+- USB-drive
+- Uploaden & Downloaden via het internet (of intern netwerk)
+
+Dit alles concludeert eigenlijk de installatie van de Raspberry Pi.
+
+## Installatie van de client software.
+
+De client software is beschikbaar in de actions tab van het Gitea repository. Te vinden aan de bovenkant van de webpagina.  
+Hier kan je bij een tab genaamd 'cross-compile' aan de linker zijde de Windows en Linux varianten vinden.  
+
+Deze applicatie is enkel afhankelijk van [de configuratiefile](./templates/raspis.yaml.template) genaamd 'raspis.yaml'.  
+Zie in de vorige zin de link voor een voorbeeld.  
+
+Hoe deze 'raspis.yaml' moet worden geinstalleerd is naast het .exe (executable) bestand, dus een directory/map moet er zo uitzien:  
+
+```
+./
+  - akartontv.exe
+  - raspis.yaml
+```
+
+## Feedback
+
+Voor feedback van klanten of van jouwzelf kan je terecht bij Daan Selen, dselen@systemec.nl