Remove generated files
[framework/connectivity/libgphoto2.git] / camlibs / st2205 / README.st2205
1 About this driver
2 =================
3
4 This driver allows you to upload / download and delete pictures from
5 Sitronix st2205 based picture frames. This are small, cheap picture
6 frames with a 1.1, 1.5, 1.8 or 2.4 inch display and a USB id of 1403:0001
7
8 st2205 based frames present themselves as a regular usb mass storage device,
9 but cannot be used as a normal disk! Communication with the device happens by
10 a special protocol which consist of reading / writing sectors of the disk at
11 certain magic offsets. This driver uses the special "usbdiskdirect" port
12 driver, which allows the direct sector access the camlib for these devices
13 needs.
14
15
16 About the st2205 access protocol
17 ================================
18
19 The protocol for these devices was reverse engineered by Jeroen Domburg, who
20 has created a hack which allows directly displaying an image on them from the
21 PC (IOW using these picture frames as a second monitor). See the spritesmods
22 wiki: http://picframe.spritesserver.nl/ . Many thanks to Jeroen for this work,
23 on which this camlib is based!
24
25 The protocol basically allows raw access to the flash chip on the picture
26 frame, for example you need to do separate erase and program commands, and
27 as an erase block is larger then what you program in a single program command
28 you must make sure to always reprogram the entire range the single erase
29 command cleared (and read the entire range before clearing, so you can write
30 it back).
31
32
33 About the st2205 image compression
34 ==================================
35
36 See README.st2205-compression.