Clone wiki

Asus OLED command line utility / Home


Install-scripts and distribution packages will come... stay tuned... Meanwhile, use the simple step-by-step instructions below.

Manual step by step install guide: (Rough. Adapt to your configuration and preference)

1: Create a directory to house the utilities.

$ sudo mkdir /opt/asus_oled

2: Copy folders to the newly created directoy

$ sudo cp -r {bin,conf,pictures,cache,README,INSTALL} /opt/asus_oled/

3: Set permissions

$ sudo chmod +x /opt/asus_oled/bin/{asus_oled-ctl,xpm2asus_oled}

Create links to users home/bin folder

$ ln -s /opt/asus_oled/bin/{asus_oled-ctl,xpm2asus_oled} /home/$USER/bin/

Creates links to system bin folder

$ sudo ln -s /opt/asus_oled/bin/{asus_oled-ctl,xpm2asus_oled} /usr/bin/

5: Load module (If not done already)

$ sudo modprobe asus_oled

Make sure module 'asus_oled' has been built. It is in the staging area of the kernel confguration Put 'asus_oled' in your distributions autoload configuration if it isn't loaded per default.

6: Configure. (Choose one method)

Udev: Set your prefered user permissions, or leave it as is.

$ $EDITOR /opt/asus_oled/conf/asus_oled.rules
$ sudo cp /opt/asus_oled/conf/asus_oled.rules /etc/udev/rules.d/

Restart udev, or reboot computer


$ sudo chown root:users /sys/class/asus_oled/oled_1/{enabled,pictures}
$ sudo chmod 0220 /sys/class/asus_oled/oled_[1-9]/picture
$ sudo chmod 0440 /sys/class/asus_oled/oled_[1-9]/enabled

7: RTFM (Obligatory)

$ cat README | less
$ asus_oled-ctl --help
$ xpm2asus_oled --help

8: Done and done! Have icecream. Celebrate!