Ga naar inhoud

🔒 Aoostar WTR Max Part 4: LCD Scherm Software & Sensor Drivers

Dit projectverslag documenteert de exacte installatie en configuratie van de officiële LCD-schermsoftware op de AOOSTAR WTR Pro Max (AMD Ryzen 7 8845HS) binnen een Proxmox VE omgeving. Deze handleiding combineert de officiële fabrieksinstructies met noodzakelijke bugfixes voor Linux, lost crashes door spaties in mappenstructuren op, en activeert de IT87-kernelmodule voor een volledige weergave van alle hardware-sensoren.

  • Officiële Aoostar Downloadlink: Mega.nz Download-omgeving
  • Veiligheidscontrole: Alle binaire bestanden en scripts zijn gecontroleerd via VirusTotal en bevatten geen schadelijke code.

🏗️ Het Vertaalde Installatiescript (create_service.sh)

De originele Chinese code van het installatiescript is volledig opgeschoond en vertaald naar het Engels om foutloze werking en duidelijke logging onder Proxmox VE te garanderen.

#!/bin/bash
SCRIPT_DIR=(dirname (realpath \$0))
BINARY_PATH=\${SCRIPT_DIR}/AOOSTAR-X

# Check if running with root privileges
if [ \$(id -u) -ne 0 ]; then
    echo -e "\033[31mError: This script must be run with root privileges or sudo\033[0m" >&2
    exit 1
fi

# Check if file exists
if [ ! -f \$BINARY_PATH ]; then
    echo "Error: Binary file does not exist: \$BINARY_PATH"
    exit 1
fi

# Check and fix execution permissions
if [ ! -x \$BINARY_PATH ]; then
    echo "Notice: Detected that \$BINARY_PATH is not executable, automatically adding privileges..."
    chmod +x \$BINARY_PATH || { echo "Error: Unable to add execution permission (insufficient privileges?)"; exit 1; }
    echo "Permissions fixed!"
fi

# Define variables
SERVICE_NAME=aoostar-x-service
SERVICE_FILE_PATH=/etc/systemd/system/\${SERVICE_NAME}.service

# Check for service file conflicts
if [ -f \$SERVICE_FILE_PATH ]; then
    echo "Error: Service file already exists: \$SERVICE_FILE_PATH"
    exit 1
fi

# Create service file
sudo tee \$SERVICE_FILE_PATH > /dev/null <<EOF
[Unit]
Description=AOOSTAR-X Service
After=trim_main.service
After=sysinfo_service.service
After=usersrv.service
After=resmon.service
After=filestor_service.service
After=network.target

[Service]
Type=simple
ExecStart=\$BINARY_PATH
Restart=always
RestartSec=5
WorkingDirectory=\$SCRIPT_DIR
StandardError=file:\$SCRIPT_DIR/monitor3_error.log

[Install]
WantedBy=multi-user.target
EOF

# Reload and enable service
sudo systemctl daemon-reload || { echo -e "\033[31mError: systemctl daemon-reload failed\033[0m"; exit 1; }
sudo systemctl enable \$SERVICE_NAME || { echo -e "\033[31mError: Service enablement failed\033[0m"; exit 1; }

# Start service and check status
sudo systemctl start \$SERVICE_NAME || { echo -e "\033[31mError: Service start command failed\033[0m"; exit 1; }

# Wait for service initialization
echo -n "Waiting for service to start..."
sleep 5

# Double-check service status
if sudo systemctl is-active \$SERVICE_NAME >/dev/null 2>&1; then
    echo -e "\033[32mSuccess\033[0m"
    echo -e "\n\033[32mService has started normally\033[0m"
    echo "Real-time status check: sudo systemctl status \$SERVICE_NAME"
    echo "Management interface address: http://127.0.0.1:5123"
else
    echo -e "\033[31mFailed\033[0m"\n
    echo -e "\033[31mCritical Error: Service failed to remain running\033[0m"
    echo "Analysis of possible causes:"
    echo "1. Port conflict (check port 5123)"
    echo "2. Dependent services are not ready"
    echo "3. Binary file permission issue"
    echo "4. Resource limits (memory/disk space)"

    # Display last 10 lines of error log
    echo -e "\n\033[33m==== Error Log Trace (Last 10 Lines) ====\033[0m"
    tail -n 10 \$SCRIPT_DIR/monitor3_error.log 2>/dev/null || echo "Log file not found"

    # Display concise service status
    echo -e "\n\033[33m==== Service Status Summary ====\033[0m"
    systemctl status \$SERVICE_NAME --no-pager -l
    exit 1
fi

🛠️ Stapsgewijze Installatiegids

Stap 1: Voorbereiding & Uitpakken

Open de terminal van je Proxmox host en installeer de vereiste uitpakeextensies: 

apt update && apt install -y unzip
Pak het hoofd-ZIP-bestand uit. Opmerking: Gebruik harde aanhalingstekens vanwege de spaties in de fabriekskwaliteit-bestandsnaam: 
unzip 'WTR MAX+GEM12+ PRO Screen Software.zip'
Navigeer naar de uitgepakte map en pak het specifieke Linux-pakket uit: 
cd 'WTR MAX+GEM12+ PRO Screen Software'
unzip 'AOOSTAR-X-linux V1.3.6.zip'

Stap 2: Bestanden Verplaatsen (Verplichte Pad-Fix)

Belangrijk: Het actieve installatiepad mag absoluut geen spaties, speciale symbolen of Chinese karakters bevatten, anders crasht de achtergronddienst direct met een Status 203/EXEC fout.

Verplaats de software naar een schone, afgeschermde systeemmappructuur: 

sudo mkdir -p /opt/aoostar
sudo cp -r "/root/WTR MAX+GEM12+ PRO Screen Software/AOOSTAR-X-linux/." /opt/aoostar/
cd /opt/aoostar

Stap 3: Systeemeisen & Scherm-Service Installeren

Proxmox vereist de aanwezigheid van sudo om de achtergrondprocessen correct te kunnen registreren: 

apt update && apt install -y sudo
Maak het vertaalde installatiescript (create_service.sh) uitvoerbaar en start de installatie om de systemd-service aan te maken: 
chmod +x ./create_service.sh
sudo ./create_service.sh

Stap 4: Hardware Sensors & IT87-Driver Installeren

Zonder deze stap kan het LCD-scherm geen fantoerentallen, temperaturen of hardware-voltages uitlezen.

Installeer de basis sensor-architectuur: 

sudo apt install -y lm-sensors
Installeer de benodigde kernel-compilatiepakketbronnen voor Proxmox VE: 
apt update && apt install -y pve-headers proxmox-headers-\$(uname -r) dkms flex bison
Installeer de custom hardware-driver via het meegeleverde DKMS-pakket: 
dpkg -i it87-dkms_1.0.63-1_all.deb
Verifieer of de achtergrondservice nu vlekkeloos en stabiel draait: 
sudo systemctl status aoostar-x-service
De status moet een groen oplichtende melding active (running) vertonen.

🌐 Web-Interface & Vertaling

Parameter Standaardwaarde Actie bij eerste login
Adres http://[IP-adres-van-je-Proxmox-host]:5123 Openen in een moderne desktopbrowser
Taal-Fix Chinees (Standaard) Rechtermuisknop ➔ Vertalen naar Nederlands
Gebruikersnaam admin Invoeren op de inlogpagina
Wachtwoord 123456 Direct na login wijzigen via het tandwiel-icoon (Instellingen)