Permalink
Switch branches/tags
Nothing to show
Find file Copy path
150 lines (89 sloc) 5.16 KB

Post Installation Guide

Prerequisites

  • After install you must reboot to apply the changes.

  • After reboot, make sure dispaylink is running, i.e:

    systemctl status dlm.service

    If it's not running, start it by running:

    systemctl start dlm.service

    To start automatically at boot run:

    systemctl enable dlm.service

Setting provider sources

  • Check providers, i.e:

    xrandr --listproviders

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

  • Set provider sources, i.e:
    xrandr --setprovideroutputsource 1 0
    
    xrandr --setprovideroutputsource 2 0
    

This will connect you to two external monitors.

Screen Layout Configuration

There are couple of tools to help you configure screen layout of your 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 configuration

Since hotplug doesn't work (on Debian) 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

  • Monitor dmesg output while plugging in Displaylink
  • Monitor /var/log/displaylink/DisplayLinkManager.log file
Most common Ubuntu related issues:
  • displaylink.service fails to start

UEFI needs to be disabled. Reference: issue #15

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?

Please submit an issue