Inhaltsverzeichnis

Samsung SPF driver

This driver supports Samsung digital picture frames of the SPF series, which can be used as a USB „mini monitor“. Every picture is compressed to JPEG by the driver and sent to the frame via USB.

A frame that is connected in mass storage mode is switched to mini monitor mode by the driver. At start the driver waits up to 20 seconds for the frame to appear on the USB bus.


Display Section

Display <name> {
    Driver       'SamsungSPF'
    Model        <string>
    Font         <string>
    Update       <number>
    Backlight    <expression>
    Dimming      <string>
    GoodbyeScale <number>
    Foreground   <color>
    Background   <color>
    Basecolor    <color>
}

Parameters

Driver'SamsungSPF'
Modelmodel of the frame, see the table below. Use 'SPF-AUTO' to let the driver detect the model. Upper and lower case do not matter. Required.
Fontfont size, specified as <width>x<height>. Default is '6×8', every size from 6×8 upwards is possible (the built-in 6×8 font is scaled).
Updateinterval (msec) in which a changed picture is transmitted to the frame, default is 1000
Backlightbrightness, 0 (darkest) .. 10 (brightest, the default). This is an expression, see below.
Dimming'hardware' (default) or 'software', see below
GoodbyeScalescale factor (1..20) of the 6×8 font for the goodbye message. Default is 4, i.e. 24×32 pixels per character.
Foregroundcolor of active pixels (RRGGBBAA or RRGGBB), default is opaque black '000000ff' (see Colors for details)
Backgroundcolor of inactive pixels (RRGGBBAA or RRGGBB), default is transparent 'ffffff00' (see Colors for details)
Basecolorcolor of the virtual backlight (RRGGBB), default is white 'ffffff' (see Colors for details)

The resolution is given by the model, there is no Size entry.


Models

ModelResolution
SPF-AUTOdetect the model by its USB product ID
SPF-72H800×480
SPF-75H800×480
SPF-76H800×480
SPF-83H800×600
SPF-83M800×600
SPF-85H800×600
SPF-85P800×600
SPF-86H800×600
SPF-86P800×600
SPF-87H800×480
SPF-87H-v2800×480
SPF-105P1024×600
SPF-107H1024×600
SPF-107H-v21024×600
SPF-700T800×600
SPF-800P800×480
SPF-1000P1024×600

Some models share their USB product IDs (SPF-75H and SPF-76H, SPF-85H and SPF-86H, SPF-85P and SPF-86P). With 'SPF-AUTO' the first one of such a pair is reported; this does not matter, as their resolutions are the same.

The list of models built into your binary is printed by lcd4linux -l.


Brightness

Backlight sets the brightness in 11 steps from 0 (darkest) to 10 (brightest). Without the entry the level is 10.

The entry is an expression that is evaluated with every update of the display. So instead of a fixed number the brightness can follow a file while LCD4Linux is running:

    Backlight file::readline('/tmp/lcd/brightness', 1)

If the expression returns an empty string (e.g. because the file does not exist), level 10 is used.

There are two ways the brightness is applied, selected with Dimming:

'hardware'The backlight of the frame is dimmed. The value is transmitted together with the picture and is the same setting as 'Brightness' in the menu of the frame. Level 0 is the lowest step of the backlight, not off: the picture is still visible.
'software'For frames that do not accept the brightness value: the backlight stays as it is, and the picture itself is darkened before it is transmitted. Here level 0 is black. The goodbye message is always shown undimmed, so it stays readable.

A new brightness takes effect with the next update, even if the picture has not changed.


Goodbye message

When LCD4Linux is stopped, the driver clears the display and looks for the file /tmp/lcd/goodbye.

The message is centered horizontally and vertically and is drawn with the font size given by GoodbyeScale. If the line is too long for this size, the scale is reduced until it fits.

echo "Rebooting..." > /tmp/lcd/goodbye

Examples

Display SamsungSPF {
    Driver     'SamsungSPF'
    Model      'SPF-75H'
    Font       '12x16'
    Update     500
}
Display SPF {
    Driver       'SamsungSPF'
    Model        'SPF-AUTO'
    Font         '6x8'
    Backlight    file::readline('/tmp/lcd/brightness', 1)
    GoodbyeScale 6
    Foreground   'ffffff'
    Background   '00000000'
    Basecolor    '000000'
}

Requirements

To build this driver you need libusb (0.1) and libjpeg. The driver is selected at build time with –with-drivers=SamsungSPF.