view · edit · print · history

Tested on the following SlugOS-variants: Unslung 6.8beta, OpenSlug 3.10.
If you've tested this on another SlugOS variant, please add it to this list.

How to install a Pertelian X2040 LCD display


This page describes how to add a Pertelian X2040 LCD display to your slug.
This is a 4 line, 20 character, green backlit LCD display with a USB connector.
Why this specific device: simple: it is the only LCD display that I could find that does not require fiddling with hardware, and more-over it comes in a nice cabinet. (and yes, I would have preferred something graphical and/or with OLED technology, but I could not find any pre-assembled hardware and I am not really good at soldering). I am not affiliated with Pertelian other than being a happy customer.

Installation on OpenSlug 3.10

  1. install modules ftdi-sio and usbserial by issueing the command ipkg install kernel-module-ftdi-sio
  2. connect your display to the slug
  3. if you want to automatically load the module upon bootup create /etc/modutils/modules if it does not exist.
    Add a line containing only ftdi_sio to that file. After saving the file run update-modules. This will assure that the module always gets loaded.
    Without this the modules will get loaded when you connect your device, but not if you boot with the device connected.

Installation and configuration of LCDproc

  1. install libusb by issueing the command ipkg install libusb
  2. install lcdproc and LCDd by issueing the command ipkg install lcdproc.
  3. edit /etc/LCDd.conf. Note that as the package can also be used for a lot of other displays, I could not modify it to have the Pertelian defaults.
    At line 35 insert a # before the line Driver=CFontzPacket (so it becomes #Driver=CFontzPacket).
    At line 36 remove the leaing # before the line #Driver=hd44780 (making it Driver=hd44780).
    Change line 79 from DriverPath=server/drivers/ to DriverPath=/usr/lib/lcdproc/. Do not forget the trailing backslash!=]
    At line 348 insert a # before the line Port=0x378 (making it #Port=0x378.
    After line 348 insert the following two lines:
    Device=/dev/ttyUSB0 (assuming your display is on ttyUSB0, which is normally the case if you have no other usb serial ports)
    Change line 351 from ConnectionType=4bit to ConnectionType=lcdserializer
    That concludes the editing.
  4. start LCDd by issueing the command (as root): /etc/init.d/lcdd start
  5. edit /etc/lcdproc.conf to your liking. The screens that you can display are listed using by running lcdproc --help.
  6. start lcdproc by issueing the command: /etc/init.d/lcdproc start

That's it. You should now have a running display. Note that the backlight is not working. There is a patch for that on http://pertelian.com/forums/viewtopic.php?p=332, but I did not add it yet (with backlight in an always on situation I feel the display is too prominently present).

Installation on Unslung 6.8-beta

It is also possible to connect the Pertelian X2040 display using USB to Unslung 6.8. A perl script can be used to print characters to the screen.

Follow these instructions.

  1. install module kernel-module-usbserial by issueing the command ipkg install kernel-module-usbserial
  2. install libusb by issueing the command ipkg install libusb
  3. install ftdi-sio module by issueing the command ipkg install kernel-module-ftdi-sio
  4. depmod -a
  5. insmod usbserial
  6. insmod ftdi_sio
  7. use a perl script to print characters to the screen, like the example script provided on http://pertelian.com/forums/viewtopic.php?t=19.
view · edit · print · history · Last edited by bsmeets.
Based on work by bsmeets, lxs4ever, and eFfeM.
Originally by eFfeM.
Page last modified on January 07, 2008, at 10:49 PM