Skip to content

Latest commit

 

History

History
181 lines (106 loc) · 7.63 KB

post-install-guide.md

File metadata and controls

181 lines (106 loc) · 7.63 KB
Raw

Post Installation Guide

Prerequisites

  • Make sure that UEFI/secure boot is disabled!

  • When you are logging into your session you are using X server (X11) and not Wayland.

  • After install you must reboot to apply the changes.

  • After reboot, make sure DispayLink is running by running debug i.e: sudo ./displaylink-debian.sh --debug

Then check DisplayLink info section, i.e:

---------------- DisplayLink info ----------------

Driver version: 5.1.26
DisplayLink service status: up and running
EVDI service version: 1.6.0

  • Check providers to see if your monitors were detected, i.e:

    xrandr --listproviders

If you get a list of more then one provider, it means your displays were properly detected.

If that's not the case and you have an Intel graphics card try following suggestion, if that doesn't work try this.

If you have Nvidia or ATI/AMD graphics card, try removing: /etc/X11/xorg.conf.d/20-displaylink.conf file followed by reboot and check again if you're getting more then one provider.

If none of the suggestions in Prerequsites section solved your problem, make sure to consult Troubleshooting most common issues.

Screen Layout Configuration

There are couple of tools to help you configure screen layout of your external monitors.

Set provider sources

Only do this in case your monitors weren't automatically detected, i.e:

xrandr --setprovideroutputsource 1 0
   
xrandr --setprovideroutputsource 2 0

This will manually connect you to two external monitors.

xrandr

Depending on your setup, to connect provider 1 to provier 0, you'd run:

xrandr --output DVI-1-0 --auto --right-of eDP1

For further reference I suggest reading: How to use xrandr

GNOME Displays

If you're GNOME desktop user, simply run:

gnome-control-center display

arandr

Another very easy and intuative (gui) tool is arandr (Another XRandR GUI)

Make sure to install it first: sudo apt-get install arandr

Automated (persistent) display configuration

Since hotplug doesn't work (on Debian and Kali) and every time you connect your computer to Displaylink you'll need to re-configure your displays.

I've set-up couple of aliases which help me accomplish this in semi-automated manner.

Every time I connect my computer to DisplayLink ...

two

I simple run two which is an alias for setting up two external displays as primary and secondary, whilst turning off laptop built in display. So I can close the lid.

one

Every time I want to diconnect my displays I run one. Which turns off both external displays, turns on built in laptop display and makes it a primary (default behaviour).

I did this by simply adding following code to my ~/.bashrc

# two
alias two="xrandr --setprovideroutputsource 1 0 && xrandr --setprovideroutputsource 2 0 && xrandr --output VIRTUAL1 --off --output DVI-1-0 --primary --auto --pos 0x0 --rotate normal --output DP1 --off --output HDMI2 --off --output HDMI1 --off --output eDP1 --off --output DVI-2-1 --auto --pos 1680x0 --rotate normal"

# one
alias one="xrandr --output VIRTUAL1 --off --output DVI-1-0 --off --output DP1 --off --output HDMI2 --off --output HDMI1 --off --output eDP1 --primary --mode 1366x768 --pos 0x0 --rotate normal --output DVI-2-1 --off"

Note, in case you're editting ~/.bashrc, make sure you run source ~/.bashrc to appy the changes without having to log in/out.

Troubleshooting most common issues

Monitoring for errors
  • Monitor dmesg | grep Display output while plugging in Displaylink
  • Monitor /var/log/displaylink/DisplayLinkManager.log file
Most common Debian Jessie related issues:
  • systemctl status dlm.service failure
  • Glibc GLIBCXX_3.4.21 missing

Due to older version of libstdc++6 in Jessie, you need to download and install version from Stretch release. After package has been updated, run displaylink-debian and select "Re-install" option.

Reference: issue #42

Should you experience problems with the display either remaining black, only showing mouse pointer or a frozen image of your main screen, then this could be due to Intel graphics driver interfering with displaylink.

Reference: issue #68

syntax error near unexpected token `newline'...

If you just downloaded the script and tried to execute it, you might get the following error:

$ ./displaylink-debian.sh
./displaylink-debian.sh: line 1: syntax error near unexpected token `newline'
./displaylink-debian.sh: line 1: `<!DOCTYPE html>'

The line number might be different.

Solution:

Download the script again as a ZIP file: https://github.com/AdnanHodzic/displaylink-debian/archive/master.zip

Extract it and run it:

$ unzip displaylink-debian-master.zip
Archive:  displaylink-debian-master.zip
075594536fe4683a5e25aec99e3b6379662ef2ea
   creating: displaylink-debian-master/
  inflating: displaylink-debian-master/README.md  
  inflating: displaylink-debian-master/displaylink-debian.sh  
  inflating: displaylink-debian-master/post-install-guide.md  
$ cd displaylink-debian-master
$ sudo ./displaylink-debian.sh

References: issue #111, issue #102, issue #89, issue #65

Having a different problem?

When submitting a new issue, include debug information by running: sudo ./displaylink-debian.sh --debug