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' |
| Model | model 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. |
| Font | font 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). |
| Update | interval (msec) in which a changed picture is transmitted to the frame, default is 1000 |
| Backlight | brightness, 0 (darkest) .. 10 (brightest, the default). This is an expression, see below. |
| Dimming | 'hardware' (default) or 'software', see below |
| GoodbyeScale | scale factor (1..20) of the 6×8 font for the goodbye message. Default is 4, i.e. 24×32 pixels per character. |
| Foreground | color of active pixels (RRGGBBAA or RRGGBB), default is opaque black '000000ff' (see Colors for details) |
| Background | color of inactive pixels (RRGGBBAA or RRGGBB), default is transparent 'ffffff00' (see Colors for details) |
| Basecolor | color 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
| Model | Resolution |
| SPF-AUTO | detect the model by its USB product ID |
| SPF-72H | 800×480 |
| SPF-75H | 800×480 |
| SPF-76H | 800×480 |
| SPF-83H | 800×600 |
| SPF-83M | 800×600 |
| SPF-85H | 800×600 |
| SPF-85P | 800×600 |
| SPF-86H | 800×600 |
| SPF-86P | 800×600 |
| SPF-87H | 800×480 |
| SPF-87H-v2 | 800×480 |
| SPF-105P | 1024×600 |
| SPF-107H | 1024×600 |
| SPF-107H-v2 | 1024×600 |
| SPF-700T | 800×600 |
| SPF-800P | 800×480 |
| SPF-1000P | 1024×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.
- If the file exists, its first line is displayed and the file is removed. This also happens when the splash screen is disabled.
- If the file does not exist, 'goodbye!' is displayed, but only if LCD4Linux was started with -s.
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.
