c't includ (usb display)

disclaimer / info:

DISCLAIMER:
THIS IS EXPERIMENTAL SOFTWARE AND HARDWARE. USE AT YOUR OWN RISK. THE MAINTAINER(S) OF THESE PAGES AND THE DEVELOPER(S) OF SOFTWARE AND HARDWARE PRESENTED ON THESE PAGES CAN NOT BE HELD LIABLE UNDER ANY CIRCUMSTANCES FOR DAMAGE TO HARDWARE OR SOFTWARE, LOST DATA, OR OTHER DIRECT OR INDIRECT DAMAGE RESULTING FROM THE USE OF THIS SOFTWARE OR HARDWARE. IF YOU DO NOT AGREE TO THESE CONDITIONS, YOU ARE NOT PERMITTED TO USE OR FURTHER DISTRIBUTE THIS SOFTWARE OR TO USE ANY TEMPLATES FOR BUILDING HARDWARE PRESENTED HERE.

• this page deals with connecting a c't includ usb-display to an usb port and drive it using serdisplib
• i'm not responsible for the content of external web pages
• external web pages will generally open in separate browser windows or tabs
• english is not my native language. please keep that in mind (corrections of english grammar and formulations are very welcome!)
• email: mrwastl at users.sourceforge.net

c't includ ('maeusekino') usb display:

description

c't includ ('maeusekino') usb displays are developed by www.ct-maeusekino.de.

hack value added(tm): frontal view of c't includ usb display running on a fresh Fedora Core 5 install with a pre-released fc5-kernel (iowarrior-module needed some modifications to work) ...

Linksys NSLU2 network storage link (architecture: ARM) running linux-based firmware openslug driving a c't includ display. picture contributed by maf from includ-forum. more info on this item: thread in includ forum (german only).

some images

test image generated by testserdisp	output generated by multidisplay
lcd4linux output using libusb + kernel 2.4	lcd4linux output using iowarrior-module by code mercenaries + kernel 2.6
output generated by graphlcd
the picture of maf's NSLU2 made me buy such a nice toy, too ;-) (command line for this output)	lcd4linux output on an NSLU2

connecting a c't includ usb display:

intro

NOTA BENE!

pros and cons

• kernel module (ioctl):

  +   ioctl-based
  +   load- and controllable by hotplug, ...
  -   restricted to linux only
  -   linux: restricted to kernel 2.6.x (not working on 2.4.x and below)
  -   not part of the kernel, has to be compiled and installed by the user

  
  
• libusb:

  +   universal (usable on all plattforms providing libusb - at least in theory)
  +   libusb is included in many current unix-system / distributions by default
  +   linux: not restriced to kernel 2.6.x
  -   configuration (devices, rights, ...) not that easy ...
  -   not enabled by default (use './configure --enable-libusb' to include libusb-support when building serdisplib)

kernel module

• the kernel module provides two nodes: /dev/iowarrior0 and /dev/iowarrior1 depending on amount of connected display and used version of usbdevfs
  (on some distributions the nodes may be /dev/usb/iowarriorX)
• only /dev/iowarrior1 is needed for controlling the display
• the device-string for accessing the dislay is: IOW24:/dev/iowarrior1
  ('1' is to be replaced through '3', '5', ... if more than one display is connected and to be controlled)

examples

configuration in lcd4linux

 Display SerDispLib {
   Driver 'serdisplib'
   Port 'IOW24:/dev/iowarrior1'
   Model 'CTINCLUD'
 } 

configuration in graphlcd

 [serdisp]
 Driver=serdisp
 Device=IOW24:/dev/iowarrior1
 Controller=ctinclud

calling test program testserdisp

 testserdisp -n ctinclud -p 'IOW24:/dev/iowarrior1'

libusb

• the vendor/production IDs for the display are: 7c0/1501 (hex)
• the device-string for accessing the dislay is: 'USB:7c0/1501'

examples

configuration in lcd4linux

 Display SerDispLib {
   Driver 'serdisplib'
   Port 'USB:7c0/1501'
   Model 'CTINCLUD'
 } 

configuration in graphlcd

 [serdisp]
 Driver=serdisp
 Device=USB:7c0/1501
 Controller=ctinclud

calling test program testserdisp

 testserdisp -n ctinclud -p 'USB:7c0/1501'

passing options through serdisp_init():

intro

    examples:
    
      serdisp_init(sdcd, "CTINCLUD", "INVERT=YES");
      serdisp_init(sdcd, "CTINCLUD", "ROTATE=90");
    

options

ranges, aliases

annotations

• options for driving the user controllable LEDs will be added in a next version of serdisplib

links:

thanks:

history: