1
2		Video issues with S3 resume
3		~~~~~~~~~~~~~~~~~~~~~~~~~~~
4		  2003-2006, Pavel Machek
5
6During S3 resume, hardware needs to be reinitialized. For most
7devices, this is easy, and kernel driver knows how to do
8it. Unfortunately there's one exception: video card. Those are usually
9initialized by BIOS, and kernel does not have enough information to
10boot video card. (Kernel usually does not even contain video card
11driver -- vesafb and vgacon are widely used).
12
13This is not problem for swsusp, because during swsusp resume, BIOS is
14run normally so video card is normally initialized. It should not be
15problem for S1 standby, because hardware should retain its state over
16that.
17
18We either have to run video BIOS during early resume, or interpret it
19using vbetool later, or maybe nothing is necessary on particular
20system because video state is preserved. Unfortunately different
21methods work on different systems, and no known method suits all of
22them.
23
24Userland application called s2ram has been developed; it contains long
25whitelist of systems, and automatically selects working method for a
26given system. It can be downloaded from CVS at
27www.sf.net/projects/suspend . If you get a system that is not in the
28whitelist, please try to find a working solution, and submit whitelist
29entry so that work does not need to be repeated.
30
31Currently, VBE_SAVE method (6 below) works on most
32systems. Unfortunately, vbetool only runs after userland is resumed,
33so it makes debugging of early resume problems
34hard/impossible. Methods that do not rely on userland are preferable.
35
36Details
37~~~~~~~
38
39There are a few types of systems where video works after S3 resume:
40
41(1) systems where video state is preserved over S3.
42
43(2) systems where it is possible to call the video BIOS during S3
44  resume. Unfortunately, it is not correct to call the video BIOS at
45  that point, but it happens to work on some machines. Use
46  acpi_sleep=s3_bios.
47
48(3) systems that initialize video card into vga text mode and where
49  the BIOS works well enough to be able to set video mode. Use
50  acpi_sleep=s3_mode on these.
51
52(4) on some systems s3_bios kicks video into text mode, and
53  acpi_sleep=s3_bios,s3_mode is needed.
54
55(5) radeon systems, where X can soft-boot your video card. You'll need
56  a new enough X, and a plain text console (no vesafb or radeonfb). See
57  http://www.doesi.gmxhome.de/linux/tm800s3/s3.html for more information.
58  Alternatively, you should use vbetool (6) instead.
59
60(6) other radeon systems, where vbetool is enough to bring system back
61  to life. It needs text console to be working. Do vbetool vbestate
62  save > /tmp/delme; echo 3 > /proc/acpi/sleep; vbetool post; vbetool
63  vbestate restore < /tmp/delme; setfont <whatever>, and your video
64  should work.
65
66(7) on some systems, it is possible to boot most of kernel, and then
67  POSTing bios works. Ole Rohne has patch to do just that at
68  http://dev.gentoo.org/~marineam/patch-radeonfb-2.6.11-rc2-mm2.
69
70(8) on some systems, you can use the video_post utility and or 
71  do echo 3 > /sys/power/state  && /usr/sbin/video_post - which will 
72  initialize the display in console mode. If you are in X, you can switch
73  to a virtual terminal and back to X using  CTRL+ALT+F1 - CTRL+ALT+F7 to get
74  the display working in graphical mode again.
75
76Now, if you pass acpi_sleep=something, and it does not work with your
77bios, you'll get a hard crash during resume. Be careful. Also it is
78safest to do your experiments with plain old VGA console. The vesafb
79and radeonfb (etc) drivers have a tendency to crash the machine during
80resume.
81
82You may have a system where none of above works. At that point you
83either invent another ugly hack that works, or write proper driver for
84your video card (good luck getting docs :-(). Maybe suspending from X
85(proper X, knowing your hardware, not XF68_FBcon) might have better
86chance of working.
87
88Table of known working notebooks:
89
90Model                           hack (or "how to do it")
91------------------------------------------------------------------------------
92Acer Aspire 1406LC		ole's late BIOS init (7), turn off DRI
93Acer TM 230			s3_bios (2)
94Acer TM 242FX			vbetool (6)
95Acer TM C110			video_post (8)
96Acer TM C300                    vga=normal (only suspend on console, not in X), vbetool (6) or video_post (8)
97Acer TM 4052LCi		        s3_bios (2)
98Acer TM 636Lci			s3_bios,s3_mode (4)
99Acer TM 650 (Radeon M7)		vga=normal plus boot-radeon (5) gets text console back
100Acer TM 660			??? (*)
101Acer TM 800			vga=normal, X patches, see webpage (5) or vbetool (6)
102Acer TM 803			vga=normal, X patches, see webpage (5) or vbetool (6)
103Acer TM 803LCi			vga=normal, vbetool (6)
104Arima W730a			vbetool needed (6)
105Asus L2400D                     s3_mode (3)(***) (S1 also works OK)
106Asus L3350M (SiS 740)           (6)
107Asus L3800C (Radeon M7)		s3_bios (2) (S1 also works OK)
108Asus M6887Ne			vga=normal, s3_bios (2), use radeon driver instead of fglrx in x.org
109Athlon64 desktop prototype	s3_bios (2)
110Compal CL-50			??? (*)
111Compaq Armada E500 - P3-700     none (1) (S1 also works OK)
112Compaq Evo N620c		vga=normal, s3_bios (2)
113Dell 600m, ATI R250 Lf		none (1), but needs xorg-x11-6.8.1.902-1
114Dell D600, ATI RV250            vga=normal and X, or try vbestate (6)
115Dell D610			vga=normal and X (possibly vbestate (6) too, but not tested)
116Dell Inspiron 4000		??? (*)
117Dell Inspiron 500m		??? (*)
118Dell Inspiron 510m		???
119Dell Inspiron 5150		vbetool needed (6)
120Dell Inspiron 600m		??? (*)
121Dell Inspiron 8200		??? (*)
122Dell Inspiron 8500		??? (*)
123Dell Inspiron 8600		??? (*)
124eMachines athlon64 machines	vbetool needed (6) (someone please get me model #s)
125HP NC6000			s3_bios, may not use radeonfb (2); or vbetool (6)
126HP NX7000			??? (*)
127HP Pavilion ZD7000		vbetool post needed, need open-source nv driver for X
128HP Omnibook XE3	athlon version	none (1)
129HP Omnibook XE3GC		none (1), video is S3 Savage/IX-MV
130HP Omnibook XE3L-GF		vbetool (6)
131HP Omnibook 5150		none (1), (S1 also works OK)
132IBM TP T20, model 2647-44G	none (1), video is S3 Inc. 86C270-294 Savage/IX-MV, vesafb gets "interesting" but X work.
133IBM TP A31 / Type 2652-M5G      s3_mode (3) [works ok with BIOS 1.04 2002-08-23, but not at all with BIOS 1.11 2004-11-05 :-(]
134IBM TP R32 / Type 2658-MMG      none (1)
135IBM TP R40 2722B3G		??? (*)
136IBM TP R50p / Type 1832-22U     s3_bios (2)
137IBM TP R51			none (1)
138IBM TP T30	236681A		??? (*)
139IBM TP T40 / Type 2373-MU4      none (1)
140IBM TP T40p			none (1)
141IBM TP R40p			s3_bios (2)
142IBM TP T41p			s3_bios (2), switch to X after resume
143IBM TP T42			s3_bios (2)
144IBM ThinkPad T42p (2373-GTG)	s3_bios (2)
145IBM TP X20			??? (*)
146IBM TP X30			s3_bios, s3_mode (4)
147IBM TP X31 / Type 2672-XXH      none (1), use radeontool (http://fdd.com/software/radeon/) to turn off backlight.
148IBM TP X32			none (1), but backlight is on and video is trashed after long suspend. s3_bios,s3_mode (4) works too. Perhaps that gets better results?
149IBM Thinkpad X40 Type 2371-7JG  s3_bios,s3_mode (4)
150IBM TP 600e			none(1), but a switch to console and back to X is needed
151Medion MD4220			??? (*)
152Samsung P35			vbetool needed (6)
153Sharp PC-AR10 (ATI rage)	none (1), backlight does not switch off
154Sony Vaio PCG-C1VRX/K		s3_bios (2)
155Sony Vaio PCG-F403		??? (*)
156Sony Vaio PCG-GRT995MP		none (1), works with 'nv' X driver
157Sony Vaio PCG-GR7/K		none (1), but needs radeonfb, use radeontool (http://fdd.com/software/radeon/) to turn off backlight.
158Sony Vaio PCG-N505SN		??? (*)
159Sony Vaio vgn-s260		X or boot-radeon can init it (5)
160Sony Vaio vgn-S580BH		vga=normal, but suspend from X. Console will be blank unless you return to X.
161Sony Vaio vgn-FS115B		s3_bios (2),s3_mode (4)
162Toshiba Libretto L5		none (1)
163Toshiba Libretto 100CT/110CT    vbetool (6)
164Toshiba Portege 3020CT		s3_mode (3)
165Toshiba Satellite 4030CDT	s3_mode (3) (S1 also works OK)
166Toshiba Satellite 4080XCDT      s3_mode (3) (S1 also works OK)
167Toshiba Satellite 4090XCDT      ??? (*)
168Toshiba Satellite P10-554       s3_bios,s3_mode (4)(****)
169Toshiba M30                     (2) xor X with nvidia driver using internal AGP
170Uniwill 244IIO			??? (*)
171
172Known working desktop systems
173~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
174
175Mainboard	    Graphics card                 hack (or "how to do it")
176------------------------------------------------------------------------------
177Asus A7V8X	    nVidia RIVA TNT2 model 64	  s3_bios,s3_mode (4)
178
179
180(*) from https://wiki.ubuntu.com/HoaryPMResults, not sure
181    which options to use. If you know, please tell me.
182
183(***) To be tested with a newer kernel.
184
185(****) Not with SMP kernel, UP only.
186