====== 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 {
Driver 'SamsungSPF'
Model
Font
Update
Backlight
Dimming
GoodbyeScale
Foreground
Background
Basecolor
}
----
===== 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 x. Default is '6x8', every size from 6x8 upwards is possible (the built-in 6x8 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 6x8 font for the goodbye message. Default is 4, i.e. 24x32 pixels per character.|
|**Foreground**|color of active pixels (RRGGBBAA or RRGGBB), default is opaque black '000000ff' (see [[:lcd4linux:colors]] for details)|
|**Background**|color of inactive pixels (RRGGBBAA or RRGGBB), default is transparent 'ffffff00' (see [[:lcd4linux:colors]] for details)|
|**Basecolor**|color of the virtual backlight (RRGGBB), default is white 'ffffff' (see [[:lcd4linux: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|800x480|
|SPF-75H|800x480|
|SPF-76H|800x480|
|SPF-83H|800x600|
|SPF-83M|800x600|
|SPF-85H|800x600|
|SPF-85P|800x600|
|SPF-86H|800x600|
|SPF-86P|800x600|
|SPF-87H|800x480|
|SPF-87H-v2|800x480|
|SPF-105P|1024x600|
|SPF-107H|1024x600|
|SPF-107H-v2|1024x600|
|SPF-700T|800x600|
|SPF-800P|800x480|
|SPF-1000P|1024x600|
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//.
----