linux4media l4m132c
usb colour display module

this page contains all changes and additions that have been added to serdisplib version 1.97.9.
for library versions <= 1.97.8 the old page should be used.

new features:

• support for monochrome mode (much faster full frame update).
• support for the alarm features if provided by the firmware of the module.
• selection between resolutions 128x64 and 132x65. if 128x64 is selected the remaining pixels are used for a visual feedback when receiving IR-remote signals.
• introduction of an improved, non-linear way of setting display contrast (the non-linear contrast setting tries to neutralise the non-linear contrast levels of the display module).
  now the hardware contrast values for CONTRAST=0/5/10 are pre-set in the code, the hardware contrast values in between are calculated using a power function. this leads to a much better use of the contrast range provided by the display module.

important:

• options RESMODE and ALARM* can only be used with current firmware versions !
• if your display has erraneous pixels drawn at the right side try using RESMODE=1 (maybe you've got a firmware which only supports resolution 128x64)

l4m132c usb display modules are developed by www.digitaldevices.de.

the package that was sent to me contained the following items: display module (132x65, 64k colours) with USB module RTC (real-time clock) on board IR sensor + RUWIDO keyboard+mouse remote control the USB module can be extended to support the following features: input and output ports, both analogue or digital pin-head to connect a PSoC programmer for firmware upgrading the USB module registers with three USB interfaces when connected to a UNIX system: two interfaces receive keyboard and mouse HID-sequences the remaining interface is used for controlling the display (through ioctl-calls or libusb) both mouse and keyboard functionality, in combination with the RUWIDO remote control, worked just fine out of the box without the need of additional configuration (tested on linux-systems).   L4M132C display module, IR sensor, RUWIDO remote control

test image generated by testserdisp	rgb test-pattern
coloured test-pattern with numbers	test-pattern with animated bar

the L4M132C is a multifunctional USB device and may be driven either using the HID support provided by the operating system (linux only) or by using libusb.

libusb-support for this module is de-activated because of too many problems with the current implementation (there seem to be severe problems when using libusb together with cypress-chips on linux).
on linux, accessing the module using HID support is the better choice anyways.

using the third parameter of serdisp_init(), driver specific options and custom wiring can be set.
common information about passing options and customisable wiring can be found in a separate document.

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

this small utility is automatically compiled if serdisplib is configured with support for l4m-modules. it supports the following features:

• changing the boot logo
• setting date and time (using local date and time of host computer)
• setting alarm

the utility can be found in tools/ after compiling the library.

some options only work with recent firmware versions and/or modules with built-in RTC-chip!

  l4m132c_tool -p dev|port [<options>]
    -p dev|port      output device or port

  Options:
    -t               set date/time to local date/time
    -a  "HH:MM"      set alarm time
    -c  value        contrast/brightness (default: 5, value = [0, 10])
    -d "%6543210"    set alarm days (bit field, to be entered as hexadecimal or decimal)
                       bit 6: saturday   bit 5: friday
                       bit 4: thursday   bit 3: wednesday
                       bit 2: tuesday    bit 1: monday
                       bit 0: sunday
                     examples:
                       -d 0x7F: %1111111 -> all days
                       -d 0x41: %1000001 -> saturday and sunday
                       -d 0:    de-activate alarm
    -f imagefile     change bootlogo (only uncompressed BMP with depth=1 and 128x64 are accepted)
    -v               verbose (-v repeated: <= 2: log to syslog, >= 3: log to stderr, >= 5: log to stdout)
    -V               version information
   

  l4m132c_tool -p "/dev/hiddev0"                      # show bootlogo
  l4m132c_tool -p "/dev/hiddev0" -t                   # set date/time of display module
  l4m132c_tool -p "/dev/hiddev0" -c 0                 # set contrast/brightness to 0 (dark), set date/time, and quit
  l4m132c_tool -p "/dev/hiddev0" -f bootlogo.bmp      # change bootlogo
  l4m132c_tool -p "/dev/hiddev0" -a "23:30" -d 0x41   # set alarm at 23:30, saturday (bit6) and sunday (bit0)
  l4m132c_tool -p "/dev/hiddev0" -a "23:30" -d 0x7F   # set alarm at 23:30, all days
  l4m132c_tool -p "/dev/hiddev0" -a "23:30" -d all    # set alarm at 23:30, all days (all = alias for '0x7F')
  l4m132c_tool -p "/dev/hiddev0" -d 0                 # de-activate alarm
   

custom bootlogo, uploaded with l4m132c_tool	clock modus