# LocoLink voor Linux

Voor Ubuntu 22.04 of nieuwer, Intel/AMD 64-bit (amd64/x86_64).
Een grafische desktop en werkende OpenGL/EGL-driver zijn nodig.

## Installeren en bijwerken

Download het `.deb`-bestand van LocoLink en open het met de software-installer.
Via de terminal, vanuit je downloadmap:

```sh
sudo apt install ./LocoLink-1.7.16+44-linux-amd64.deb
```

Start daarna **LocoLink** via het applicatiemenu. Installeer een volgende versie
op dezelfde manier: het pakket vervangt de app en behoudt je projecten,
instellingen en licentie. Maak voor een update een projectback-up in de app.
Je hoeft Flutter of ontwikkelgereedschap niet te installeren.

Een Windows-licentie geldt niet voor Linux. Linux heeft eigen LocoLink+- en
LocoLink Pro-licenties. Activeren en kopen kan in de app.

## USB/serieel en gamepads

Netwerkcentrales zijn bereikbaar wanneer de computer op hetzelfde netwerk zit.
Voor een seriële USB-centrale heeft je gebruiker toegang tot het apparaat nodig.
Op Ubuntu kun je daarvoor eenmalig dit uitvoeren en daarna opnieuw aanmelden:

```sh
sudo usermod -aG dialout "$USER"
```

De installer verandert je gebruikersgroepen niet. Gamepads worden zichtbaar
wanneer Linux ze als leesbaar joystickapparaat (`/dev/input/js*`) aanbiedt.
Een ontbrekende gamepad verhindert het opstarten niet.
RTSP-camera's gebruiken het mee geïnstalleerde FFmpeg; de Windows-specifieke
USB-cameraoptie is niet beschikbaar op Linux.

## Verwijderen

```sh
sudo apt remove locolink
```

Persoonlijke projecten en instellingen blijven staan.

## Download controleren

Sla `SHA256SUMS` naast de installer op en voer daar uit:

```sh
sha256sum -c SHA256SUMS
```

## 3D en grafische drivers

Gebruik bij voorkeur een Wayland-desktopsessie met bijgewerkte grafische drivers.
Voor X11 vereist de 3D-engine toegang tot `/dev/dri/renderD128`. Zonder deze
ondersteuning blijft de app bruikbaar, maar kan de 3D-weergave niet starten.
De Linux-ondersteuning van de gebruikte 3D-engine is nog experimenteel.

Bij problemen met GPU-versnelling onder WSLg kun je vanuit een Wayland-sessie
softwareweergave proberen (langzamer):

```sh
LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=llvmpipe GDK_BACKEND=wayland /opt/locolink/locolink
```