summaryrefslogtreecommitdiff
path: root/README
blob: 22cc517a57422c4e81609b09c51e83ccae97b0c7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
AMD Geode(TM) LX/GX Processor Xorg Display Driver - Release Notes
Version 04.00.00-01
June 18, 2006

--------------------------------------------------------------------------------
PRODUCT INFORMATION
--------------------------------------------------------------------------------
- This driver is the Xorg Display Driver for the AMD Geode(TM) Geode LX and 
  GX processors

This product is avaiable as a standalone patch comprising:
	Graphics_LinuxXorg_Common_03.00.0101.patch
	README.txt (this file)

or as a tarball Graphics_LinuxXorg_Common_03.00.0101.tar.gz containing:
	Graphics_LinuxXorg_Common_03.00.0101.patch
	xorg.conf_lx
	xorg.conf_gx
	README.txt (this file)

The patch adds the following documenation to the Xorg tree:
xc/programs/Xserver/hw/xfree86/drivers/amd/amd.man
xc/programs/Xserver/hw/xfree86/drivers/amd/gfx/release.txt (GX only)
xc/programs/Xserver/hw/xfree86/drivers/amd/panel/readme.txt (GX only)

The following example files are provided in the tarball release only
	xorg.conf_lx
	xorg.conf_gx

For bugs, patches, and info requests, please subscribe to:
info-linux@geode.amd.com

To subscribe, send a blank message to:  info-linux-subscribe@geode.amd.com
	
Features
--------
The AMD Geode Linux Xorg driver implements Xorg XAA driver interface.
Through a hardware abstraction layer called Durango (GX) and Cimarron (LX),
the full accelerated functionality of the graphics processor is exposed to
the driver.

The AMD Geode Xorg driver implements:

 - Xv video overlay extension support 
 - Geode hardware color-space conversion 
 - V4L2 overlay functionality (Geode LX processor only)
 - Rotated graphical output
 - DDC support
 - DPMS support
 - Common X.org patch support both Geode LX and GX processors

Dependencies
------------
This release depends on and includes the following subcomponents:

Linux Build Tool - Base GeodeLinux Build System - Version 00.00.0021
Linux Build Tool - AMD Embedded - Version 00.00.0022
Linux Build Tool - Bitbake engine - Version 00.00.0011
Linux Build Tool - Openembedded - Version 00.00.0008


Functional Changes
------------------
_____________________________________________________________________________
Change: 78946
_____________________________________________________________________________
Add multiple BUILDCONFIG functionality to Tinderbox glue.

_____________________________________________________________________________
Change: 79682
_____________________________________________________________________________
Initial add of LinuxBIOSv2 source tree to Perforce. This code base matches
upstream SVN version 2296. Add P4MOD BOMs and Tinderbox configuration/linuxbios-
devel GeodeLinux targets.

_____________________________________________________________________________
Change: 81342
_____________________________________________________________________________
mplayer: enable qtx, opengl, libdvd, and alsa. xorg: enable Xft and Xinerama
icewm: configure and .bb patches for identifying correct X includes/libs

_____________________________________________________________________________
Change: 80914
_____________________________________________________________________________
Add a klocwork DISTRO and some task-*-klocwork meta files to define the
projects to build for klocwork. Move KWBUILD to the configuration file. Add
some klocwork report generation to klocwork.bbclass.

_____________________________________________________________________________
Change: 80794
_____________________________________________________________________________
klocwork.bbclass updates to support client/host and build renaming. Add a
draft nightly build script for klocwork builds. Only those .bb files with
KWBUILD=1 will be built here. Add COMPATIBLE_HOST for geode .bb files.
virtual/geode-aes must point to linux-geodelx with 2.6.16 now that this
is integrated. recent gcc-sdk-native changes were resulting in empty
packages. Revert and disable task-compilers from validation-image for
swval until this can be repaired.

_____________________________________________________________________________
Change: 79683
_____________________________________________________________________________
Release and devel .bb files for linuxbios pass build on morlock.

_____________________________________________________________________________
Change: 81340
_____________________________________________________________________________
Add libxinerama to xorg 6.8.1 config for icewm. xscreensaver depends upon intltool-
native. Use '/usr/bin/env perl' as intltool-* interpreter.

_____________________________________________________________________________
Change: 81186
_____________________________________________________________________________
Add geodelx-6.8.1 machine for norwich validation on 2.6.16+xorg6.8.1. Leave
geodelx machine at X11R7.0 because upgrade to X11R7.1 is imminent. Move x11
clients from validation-image to task-xorg because the packages differ
between 6.8.1 and 7.0. Add p4 binaries to validation-image. Add icewm to
validation-image.

_____________________________________________________________________________
Change: 80319
_____________________________________________________________________________
* Cleanup X11R6.8.1 PROVIDERS for 'gentoo' builds.
        * Created a new .bb file to correctly handle the 'gentoo'->other
          branch of validationtests.
        * ztv for 2.4.24 depends upon libxv as well
        * Add 'Kernel Build Directory' to /etc/openembedded/version for gcov
          builds so that GCOV_PREFIX environment variables may be used
          effectively.
        * disable ica-bin download error in amd/packages/ica because we have
          this downloaded to the internal mirror morlock.

_____________________________________________________________________________
Change: 80637
_____________________________________________________________________________
add project/geodelx/unittest/ and configuration files

_____________________________________________________________________________
Change: 80373
_____________________________________________________________________________
libxft and libxrandr PROVIDERS for geodelx and dimsum are X11R7.0. configure
proxy variables in environment rather than command line for LSF builds.

_____________________________________________________________________________
Change: 79322
_____________________________________________________________________________
dimsum cleanup.

_____________________________________________________________________________
Change: 80630
_____________________________________________________________________________
Disable CCACHE for gcov builds so gcda files go to the correct location.

_____________________________________________________________________________
Change: 80370
_____________________________________________________________________________
Merge with OE snapshot from 2006/06/02:
http://eloi.amd.com/openembedded/oe/oe_20060602030001.tgz

and Bitbake version 1.4.2: http://eloi.amd.com/openembedded/bitbake/bitbake-
1.4.2.tar.gz

_____________________________________________________________________________
Change: 80969
_____________________________________________________________________________
Propegate 80912 to local.rules for other images. Add x11perf, xclock, xvinfo,
rdesktop, and xpandmodes to validation-image. Add xvtest to amdtools RDEPENDS
so that it makes it to the image.

_____________________________________________________________________________
Change: 78809
_____________________________________________________________________________
Update task-compilers. This appears to build the 2.6.16 kernel OK (save
storage requirements for object files). Im adding this to the validation-
image for a quick build on LSF. Next, I will make this an optional package.

_____________________________________________________________________________
Change: 79843
_____________________________________________________________________________
Merge //drivers/buildroot/geodelinux/...@79818 and
//depot/tools/buildroot/geodelinux/...@51650.

_____________________________________________________________________________
Change: 79588
_____________________________________________________________________________
Merge //drivers/buildroot/geodelinux/...@79560 and
//depot/tools/buildroot/geodelinux/...@51580

_____________________________________________________________________________
Change: 81291
_____________________________________________________________________________
Add serf for 2.6.11 to OE and Gentoo.

_____________________________________________________________________________
Change: 81312
_____________________________________________________________________________
intltool-native perl script use #/usr/bin/env perl interpreter. more validation-
tests postinst updates. Update PREFERRED_PROVIDERS for devel targets to
geode-v4l2lx-devel. Leave release at linux-geodelx until we have a release
to replace it with.

_____________________________________________________________________________
Change: 79362
_____________________________________________________________________________
PBz#8158: Add /etc/modules.autoload.d/kernel-2.6 file including lxv4l2 to
2.6.11, 2.6.15, and 2.6.16 Gentoo kernel builds. Add lxv4l2 to autoload list
for processing by kernel.bbclass for GeodeLinux kernel builds. Add /etc/udev/rules.d/10-
local.rules file for symlinking videox -> video0 at hotplug event for Gentoo.
Update /etc/udev/local.rules file for symlinking videox -> video0 at hotplug
event for GeodeLinux.

_____________________________________________________________________________
Change: 78909
_____________________________________________________________________________
Patches for $ 'cross' compile. Gentoo and Debian store 32bit libraries in
/lib32 and 64bit in /lib64. There are apparently two standards for this, but
I'm patching gcc to follow Gentoo/Debian multilib convention. This is still
giving a build failure in libstdc++-v3, however, pulling in multilib
libraries.

_____________________________________________________________________________
Change: 81109
_____________________________________________________________________________
Remove xterm from validation-image. Symlink rxvt -> xterm instead. Replace
eog with gqview in validation-image. Remove AMD_DRIVER_VERSION mangling from
klocwork.bbclass. Add defconfig for klocwork kernel build.

_____________________________________________________________________________
Change: 81004
_____________________________________________________________________________
Move to libtool 1.5.22. Appears to resolve some obscure cross-linking issues.
klocwork.bbclass - mipsel analysis was failing due to $ definition from
project name to build name. If AMD_DRIVER_VERSION is defined, prefix project
name with amd_, otherwise oe_ Add task kwinstall for installing report files.
Add .bb files for X11R7.0 75DPI fonts. Add font-bh-75dpi to task-xorg Add xf86-video-
vga to task-org as a fallback. Add xauth to validation-image Update default
xorg.conf. z4l has been renamed to ztv. Add Eye of Gnome image viewer to validation-
image. This depends upon *alot* of gnome, so it should be replaced or gnome
should take over matchbox as session manager.

_____________________________________________________________________________
Change: 80378
_____________________________________________________________________________
Mesa compiles using the correct compiler. Remove redundant files from glib-
2.0 packaging. More DEPENDS and site-packages.conf cleanup. Disable exclusive
bsub for now. gcov-tools listed twice in validation-image.

_____________________________________________________________________________
Change: 80372
_____________________________________________________________________________
syslinux was moved upstream. Add to site-packages.conf.

_____________________________________________________________________________
Change: 80359
_____________________________________________________________________________
Add matchbox and xterm to validation-image. Replaces xfce. Add ica-bin-9.0,
but this is broken until openmotif builds.

_____________________________________________________________________________
Change: 79975
_____________________________________________________________________________
Add perl and python to validation-image. record-play and pio_check use perl.
pixel-depth and i2cval use python.

_____________________________________________________________________________
Change: 79680
_____________________________________________________________________________
Move GeodeLinux to ldcperforce1.

_____________________________________________________________________________
Change: 78811
_____________________________________________________________________________
Disable task-compilers in validation-image by default.

Unit Test 
---------
_____________________________________________________________________________
Change: 81004 : Move to libtool 1.5.22. Appears to resolve some obscure cross
_____________________________________________________________________________
HOST_ARCH definition. Move $PN

--------------------------------------------------------------------------------
VALIDATION ENVIRONMENT
--------------------------------------------------------------------------------
Validated on AMD Geode(TM) Norwich Development Board - Rev 2 Rework H and
Rev 3 Rework E with:
	
Processor:		AMD Geode LX processor, silicon rev. C1 @ 433 MHz
Chipset:		AMD Geode CS5536 companion device, silicon rev. B1
PCI Bus Speed:		66 MHz
Memory:			256 MB PC3200 RAM
CRT:			NEC MultiSync FP2141SB
Flat Panel:		Samsung LTM213U3-L07 1600x1200 2-channel LVDS,
Keyboard/Mouse:		PS/2 on Moray 1.1
	
BIOS:			GeodeROM 1.06.06
Operating System:	Gentoo 2005.0
Kernel:			v2.6.11
Kernel Patch:		LX Kernel Patch v02.02.0100
Graphics Driver:	LX Xorg Graphics driver v03.00.0100
Audio Driver:		5536 ALSA Audio driver v01.00.0500
AES Driver: 		LX AES driver v02.01.0100
AccessBus Driver: 	LX ACB Driver v01.00.0401
Video4Linux2 Driver: 	LX Video4Linux2 driver v03.02.0100
Other Software:		N/A

--------------------------------------------------------------------------------
INSTALLATION INSTRUCTIONS  
--------------------------------------------------------------------------------
Acquire Xorg Tarball from the Xorg web site:
http://www.x.org/X11R6.8.1/

For more information on X.org:
http://xorg.freedesktop.org/wiki/

Acquire Graphics_LinuxXorg_Common_03.00.0100.patch

Unpack Xorg Tarball
Patch the Source
Make Xorg
Construct Install
Apply Install image

for example:
  # tar -xzf X11R6.8.1-src.tar.gz
  # cd xc
  # patch -p1 < Graphics_LinuxXorg_Common_03.00.0100.patch 
  # cp config/cf/xorgsite.def config/cf/host.def

Edit config/cf/host.def
uncomment the line:

#define BuildSpecsDocs		No

Add the line (directly following the above line)

#define InstallHardcopyDocs	No

  # make World
  # mkdir <install_path>
  # make DESTDIR=<install_path> install install.man
  # tar -C <install_path> -czf <path>/xorg-x11-geode.tgz .
      move xorg-x11-geode.tgz to the target system
      login as root on the target system and make path to tarball available
  # tar -C / -xzpf <path>/xorg-x11-geode.tgz
  # mv /etc/X11/xorg.conf /etc/X11/xorg.conf.orig
  # cp <path>/xorg-<gx/lx>.conf /etc/X11/xorg.conf


++++++++++++++++++++++++++++++++++++++++++++++++++
AMD Geode(TM) LX processor Xorg.conf Specification
++++++++++++++++++++++++++++++++++++++++++++++++++

Linux Xorg AMD GeodeLX Processor Configuration Specification


The AMD Geode driver supports an accelerated interface to the
hardware access layer for the graphical devices (cimarron library).
To operate this API with a widely, a set of operational customizations
were added to the xorg.conf configuration file.  These specifications
for the most part are passed unmodified to cimarron.  This document
only provides an overview of the customizations to the standard
configuration file definitions.

The xorg configuration (xorg.conf) file usually exists in the system
configuration directory /etc/X11.  The standard contents are documented
in the manual pages, and can typically be accessed using:
man XF86Config
The file is divided into "sections".  The following information
illustrates the custom features added section by section.


1. Device section:

The devices section specifies the graphics driver selection.  Currently,
for the drivers that may be specified include:
Section "Device"
        Identifier  "DevId"
        Driver      "vesa"   - or
        Driver      "fbdev"  - or
        Driver      "amd"
...
EndSection

The "vesa" and "fbdev" selections are documented by the manual pages
man fbdev   - or
man vesa
The "amd" driver has many selections that can be used to operate
the interface configuration.  These selections follow:


2. Hardware Accelerations:

This set of options are standard to the xorg "xaa" accelerations.
The presents of the option disables the named functionality.
Note that many accelerations depend on combinations with others,
and so disabling one may have a more pervasive effect.

        Option "XaaNoCPUToScreenColorExpandFill"
        Option "XaaNoColor8x8PatternFillRect"
        Option "XaaNoColor8x8PatternFillTrap"
        Option "XaaNoDashedBresenhamLine"
        Option "XaaNoDashedTwoPointLine"
        Option "XaaNoImageWriteRect"
        Option "XaaNoMono8x8PatternFillRect"
        Option "XaaNoMono8x8PatternFillTrap"
        Option "XaaNoOffscreenPixmaps"
        Option "XaaNoPixmapCache"
        Option "XaaNoScanlineCPUToScreenColorExpandFill"
        Option "XaaNoScanlineImageWriteRect"
        Option "XaaNoScreenToScreenColorExpandFill"
        Option "XaaNoScreenToScreenCopy"
        Option "XaaNoSolidBresenhamLine"
        Option "XaaNoSolidFillRect"
        Option "XaaNoSolidFillTrap"
        Option "XaaNoSolidHorVertLine"
        Option "XaaNoSolidTwoPointLine"

Certain hardware accelerations may be armed or disarmed by using:

        Option "HWcursor"    (default)  -or
        Option "SWcursor" 

        Option "Compression" (default)  -or
        Option "No Compression"


Additionally, all accelerations may be armed or disarmed using:

        Option "Accel"       (default) -or
        Option "No Accel"

This option enables/disables all rendering accelerations, HW/SW cursor,
and display compression.  Certain accelerations may not be armed, even
though they are inferred by the configuration, if video memory is in
short supply.


3. Modes section:

The configuration file included with the driver delivery contains an
optional "modes" section.  This section asserts all of the standard
graphics/video mode configuration data.  This set of modes is a subset
of the mode data in the cimarron library.  Because these modes are
included, they are passed to the cimarron driver for validation.  Be
aware that cimarron will select modes using a filtering function that
uses a constrained distance search.  The mode in cimarron's definitions
that is "closest" to a mode defined - either builtin or user supplied -
will normally be used by cimarron.  

This filtering effect can be factored out by specifying:

       Option "CustomMode"

This has the effect of causing the mode validation to pass any mode
in the mode pool, and allowing the selection of the specified mode
during mode switch.  Unfortunately, because the interface specification
is not complete enough to support video modes.  Only video modes that
exist in cimarron are possible when selecting a TVOUT mode.


4. More "Device" section Options:

Since flat panels have fixed timing - that is, only one "real" mode -
the mode switch operation that normally might select a wide variety
of operational states must "adjust" the mode selection to fit the
fixed panel timing.  To communicate that the mode selection is for
a flat panel, use:
       Option "FlatPanel"
Note that the code expects that the flat panel will have been already
selected by the BIOS setup.  Conflicts produce configuration errors.
The size adjustment usually involves scaling the source buffer
dimensions to the raster image size supported by the flat-panel.  The
hardware supports this scaling operation transparently, and normally
no special considerations are needed.  The hardware scaling is limited
to modes with horizontal aspects of less than 1024 pixels (buffer size
limitation for scaling/filtering).

The display may be "rotated" in three ways, ClockWise, Upside-Down and
CounterClocwise using:
       Option "Rotate" "CW"
       Option "Rotate" "Invert"
       Option "Rotate" "CCW"  
This is accomplished using a "shadow" frame buffer, and using either
a hardware or software operation to transform the image to the
operational display buffer.

Even though there is not strategic advantage, if you wish to use a
shadow frame buffer and display the unrotated image - this is specified
by using:

       Option "ShadowFB" 


5. TVOUT video modes.

In order to enable TVOUT mode selection, a TV known encoder
must be selected in the following way:
       Option "TV_Encoder" "ADV7171"   -or
       Option "TV_Encoder" "SAA7127"   -or
       Option "TV_Encoder" "FS454"     -or
       Option "TV_Encoder" "ADV7300"
There is no default for the encoder.  This selection is mandatory
to enable TVOUT modes.

Most encoders support a variety of bus formats.  Similarly, the
amd driver can select the bus data format from the following list:
       Option "TV_Bus_Fmt" "disabled"       - VOP output is disabled
       Option "TV_Bus_Fmt" "vip1_1"         - VIP 1.1
       Option "TV_Bus_Fmt" "ccir656"        - CCIR 656 output
       Option "TV_Bus_Fmt" "vip20_8bit"     - 8-bit VIP 2.0 output
       Option "TV_Bus_Fmt" "vip20_16bit"    - 16-bit VIP 2.0 output
       Option "TV_Bus_Fmt" "601_yuv_8bit"   - 601 output, 8-bit YUV 4:2:2
       Option "TV_Bus_Fmt" "601_yuv_16bit"  - 601 output, 16-bit YUV 4:2:2
       Option "TV_Bus_Fmt" "601_rgb_8_8_8"  - 601 output, 24-bit RGB
       Option "TV_Bus_Fmt" "601_yuv_4_4_4"  - 601 output, YUV 4:4:4
Note that the "601" modes may need sync signals for correct operation.
See the 601 flags below to operate these selections.

Colorspace conversion requires a projective transformation to
perform downsampling for the implied transformation.  The sampling
method may be specified by selecting from:
       Option "TV_Conversion" "cosited"
       Option "TV_Conversion" "interspersed"
       Option "TV_Conversion" "alternating"

The TV standard selected normally specifies a known frame buffer/
TV mode geometry.  However, it is quite common that TV output
devices may expect a blanked  "overscan" area.  The dx,dy marginal
widths for the overscan area can be specified using:
        Option          "TV_Overscan" "40:30"
Note that the TV standard geometry will be scaled (and filtered) to
downscale the source buffer to destination raster image.

TVOUT operation may be conditioned with the following set of flags.
Some of these flags are not especially usable except to the kernel,
but are included for completeness.

These "TV_Flags" identifiers are specified in a quoted comma
separated list from the following identifier set: 
 singlechipcompat - Enables SCx2xx compatibility mode..
 extendedsav      - Enables extended SAV/EAV codes.
 vbi              - Use the task bit to indicate VBI data.
 task             - Set Task Bit to 1in VIP 2.0 mode. Default is 0.
 swap_uv          - Swap the U and V data prior to output.
 swap_vbi         - Swap the VBI bytes prior to output.
for example:
       Option "TV_Flags" "swap_uv"  -or
       Option "TV_Flags" "extendedsav:swap_uv"

These "TV_601_Flags" identifiers are specified in a quoted comma
separated list from the following identifier set: 
 inv_de_pol       - Invert the polarity of display enable
 inv_hs_pol       - Invert the polarity of hsync
 inv_vs_pol       - Invert the polarity of vsync
 vsync-4          - The VSync occurs 4 clocks earlier
 vsync-2          - The VSync occurs 2 clocks earlier
 vsync+0          - The VSync is not shifted at all
 vsync+2          - The Vsync occurs 2 clocks later
for example:
       Option "TV_601_Flags" "inv_vs_pol"

These "TV_Vsync_Select" identifiers are specified in a quoted comma
separated list from the following identifier set: 
 disabled         - VSync out disabled
 vg               - The VSync signal from the VG (video generator)
 vg_inv           - The VSync signal from the VG (inverted)
 statreg17        - 1 written to VIP status bit 17 toggles vsync (0-1-0)
 statreg17_inv    - 1 written to VIP status bit 17 toggles vsync (1-0-1)
for example:
       Option "TV_Vsync_Select" "disabled"


6. Screen section:

The screen section selects among the other various sections for
sets of operational parameters and constraints.  A typical
"Screen" section has the form:

Section "Screen"
    Identifier  "ScreenId"
    Device      "Geode"
    Monitor     "MonitorId"
    DefaultDepth 24

    SubSection "Display"
        Depth           24
        FbBpp           32
        Modes          "1280x1024" "1024x768" "800x600" "640x480" "tv-ntsc" "tv-pal"
    EndSubsection
...

EndSection

In this example, the "Modes" selection of the display subsection specifies a
list of available modes.  These modes are selectable using "Ctl-Alt-KpPlus" or
"Ctl-Alt-KpMinus" on most PC keyboards.  It is also possible to select a mode
using the xrandr utility, as well as using the X library API.

The DefaultDepth may be 24, 16 or 8.  If the depth is 24, then the "FbBpp" line
is needed to specify the frame buffer format as 32 bits (hardware limitation).
If a custom mode is specified, care should be taken to be sure it does not
collide with a "builtin" mode, since the builtin mode will supersede.

For a more complete functional description, review that the cimarron
reference and Geode LX processor functional specifications.

-----------------------------------------------------------------------------
RELEASE HISTORY
-----------------------------------------------------------------------------
Version 04.00.0000
April 30, 2006

Dependencies 
------------
This release depends on and includes the following subcomponents:

Linux Build Tool - Base GeodeLinux Build System - Version 00.00.0015
Linux Build Tool - AMD Embedded - Version 00.00.0016
Linux Build Tool - Bitbake engine - Version 00.00.0010
Linux Build Tool - Openembedded - Version 00.00.0006

Functional Changes
------------------
_____________________________________________________________________________
Change: 77478
_____________________________________________________________________________
Archive 2.6.11 kernel and kernel modules.

_____________________________________________________________________________
Change: 78502
_____________________________________________________________________________
Tinderbox script name and version must match .bb

_____________________________________________________________________________
Change: 78443
_____________________________________________________________________________
Changes to xorg_7.0 BOM did not take the first time.

_____________________________________________________________________________
Change: 78552
_____________________________________________________________________________
Rename norwich and norwich-2.6.11 machines to geodelx and geodelx-2.6.11.

_____________________________________________________________________________
Change: 78556
_____________________________________________________________________________
Move geodelx machine to X11R7.0. Prepend BBPATH with devel directory for
overriding local.conf without p4 edit.

_____________________________________________________________________________
Change: 78423
_____________________________________________________________________________

_____________________________________________________________________________
Change: 77505
_____________________________________________________________________________
More path and version updates after projects/norwich to
projects/geodelx rename.

_____________________________________________________________________________
Change: 78527
_____________________________________________________________________________
Don't let xorg try to identify the LinuxDistribution.

_____________________________________________________________________________
Change: 78561
_____________________________________________________________________________
Misc changes after geodelx and geodelx-2.6.11 X build testing.

_____________________________________________________________________________
Change: 78535
_____________________________________________________________________________
Move to tcltk 8.4.11 from upstream in attempts to squash this Tindebox
failure.

_____________________________________________________________________________
Change: 78108
_____________________________________________________________________________
First stab at dvb-image. Everything compiles, but I am worried about DRI
support in X, missing geode support in X, openGL support in qt-x11-free.
Also, directFB may be a better direction; it is currently disabled in this
mythtv build.

_____________________________________________________________________________
Change: 77965
_____________________________________________________________________________
Syncronize travis, sands, gcov, and simnow busybox configurations. Remove
grep and tar from travis-db1200-2.6 and validation-image images. These are
provided by busybox. Move IMAGE_ROOTFS_SIZE to the meta .bb files as this is
psp specific and not necessarily distro specific.

_____________________________________________________________________________
Change: 77612
_____________________________________________________________________________
Monotone OE Sync

_____________________________________________________________________________
Change: 77802
_____________________________________________________________________________
CVSDATE renamed to SRCDATE.

_____________________________________________________________________________
Change: 77847
_____________________________________________________________________________
Decrease the size on the etx2 partition. norwich/sands/conf/local.conf points
to norwich machine and not norwich-2.6.11.

_____________________________________________________________________________
Change: 77978
_____________________________________________________________________________
1. Update Norwich.conf and Samba.conf to 2.6.16
2. Change version file: BBFile to BBFile2 and LinuxKernel to LinuxKernel2

_____________________________________________________________________________
Change: 77947
_____________________________________________________________________________
Adding samba machine configuration file. The difference right now, from
existing norwich.conf is that this samba configures an X11R7 build. xserver-xorg-X11R7.0-
1.0.1 builds with this changelist but has not been tested. Additionally, the
AMD driver checked into Perforce has not yet been built here.

================================================================================
Version 03.00.0102
April 10, 2006

Dependencies 
------------
This release depends on and includes the following subcomponents:

Linux Build Tool - Base GeodeLinux Build System - Version 00.00.0013
Linux Build Tool - AMD Embedded - Version 00.00.0014
Linux Build Tool - Bitbake engine - Version 00.00.0009
Linux Build Tool - Openembedded - Version 00.00.0006

Functional Changes
------------------
_____________________________________________________________________________
Change: 77441
_____________________________________________________________________________
Rename //drivers/projects/norwich to //drivers/projects/geodelx. This
change includes:
 * Updates to P4MOD BOMs for 2.6.11 and 2.6.15 releases.
 * Updates to GeodeLinux .bb files for 2.6.11 and 2.6.15 builds.
 * P4MOD search path update.

================================================================================
Version: 03.00.0101, Release Notes
Release Date: December 19, 2005

Dependencies 
------------
- Built with xorg-x11-6.7.0 from Fedora Core 2 Source Updates
- Built with X11R6.8.1 from freedesktop.org
                                                                                
- This driver has been tested with Linux Kernel 2.6.11
    using the Fedora Core 2 image environment
    using the Gentoo 2005.0 image environment

- To use the Xv adaptor interface
   1) create a "videox" link to the geodev4l2 video device in /dev
      ln -s video0 /dev/videox
   2) uncomment the '  Load "z4l"' line in xorg.conf

Functional Changes
------------------
Issue #4027

Defects Corrected 
-----------------
PBZ#6538 - X.org patch is incompletely licensed
PBZ#4027 - HWCursor/Rotation, cursor does not traverse entire resolution area
Description:
When using HWCursor, cursor can not traverse the entire visable area of *MOST* 
(there are exceptions) rotated modes.  The failures exist as edges which the 
cursor can not travel to.  Failing edges differ according to rotation.
Resolution:
Cursor "hotspot" error corrected.

PBZ#4463 - 8 bpp, x11perf SWCRC --> HWCRC comparison fails paint8_03 ...
PBZ#4665 - LX Xorg Driver will not patch successfully if GX Xorg Pat...
PBZ#5025 - mode changes with xrandr, graphics distorted

Known Errata 
------------
PBZ#4025 X - Rotations{90,270}, only lowest refresh rate pass mode validation
Description: 
At 90 and 270 degree rotations, only the lowest supported refresh
rate can be entered.  The rest of the refresh rates appear to fail mode 
validation (xrandr does not see them as options, and I can not CTL->ALT->+/- 
through the modes).  This issue does not occur at 0 or 180 degree rotations.  
Resolution: 
This is an inherent weakness of the X mode switch -- where even a 
full X R&R implementation would not fix this.
Steps to address will need to be:
(1) convert AMD rotation support to X R&R
(2) patch X to better handle X R&R
This may be addressed in a future version.

PBZ#5993 - HWScaling mode hsync out of range error

================================================================================
Previous Version: 1.02.0900
Release Date: 26 May 2005

Dependencies
------------
- Built with xorg-x11-6.7.0 from Fedora Core 2 Source Updates
- Built with X11R6.8.1 from freedesktop.org
                                                                                
- This driver has been tested with Linux Kernel 2.6.11
    using the Fedora Core 2 image environment
    using the Gentoo 2004.3 image environment

- To use the Xv adaptor interface
   1) create a "videox" link to the geodev4l2 video device in /dev
      ln -s video0 /dev/videox
   2) uncomment the '  Load "z4l"' line in xorg.conf


Functional Changes
------------------
- First release

Defects Corrected
-----------------
- First release

Known Errata
------------
Issue: 

PBZ#4025 X - Rotations{90,270}, only lowest refresh rate pass mode validation
Description: 
At 90 and 270 degree rotations, only the lowest supported refresh
rate can be entered.  The rest of the refresh rates appear to fail mode 
validation (xrandr does not see them as options, and I can not 
CTL->ALT->+/- through the modes).  This issue does not occur at 0 or 
180 degree rotations.  
Resolution: 
This is an inherent weakness of the X mode switch -- where even a full X R&R 
implementation would not fix this.
Steps to address will need to be:
(1) convert AMD rotation support to X R&R
(2) patch X to better handle X R&R
This may be addressed in a future version.

================================================================================
Copyright
---------
Copyright 2005 Advanced Micro Devices, Inc. All rights reserved.
The contents of this document are provided in connection with Advanced Micro
Devices, Inc. ("AMD") products. AMD makes no representations or warranties
with respect to the accuracy or completeness of the contents of this
publication and reserves the right to make changes to specifications and
product descriptions at any time without notice. No license, whether express,
implied, arising by estoppel or otherwise, to any intellectual property rights
is granted by this publication. Except as set forth in AMD's Standard Terms
and Conditions of Sale, AMD assumes no liability whatsoever, and disclaims any
express or implied warranty, relating to its products including, but not
limited to, the implied warranty of merchantability, fitness for a particular
purpose, or infringement of any intellectual property right. AMD's products
are not designed, intended, authorized or warranted for use as components in
systems intended for surgical implant into the body, or in other applications
intended to support or sustain life, or in any other application in which the
failure of AMD's product could create a situation where personal injury,
death, or severe property or environmental damage may occur. AMD reserves the 
right to discontinue or make changes to its products at any time without notice.


Trademarks
----------
AMD, the AMD Arrow logo, and combinations thereof, and Geode are trademarks 
of Advanced Micro Devices, Inc.

Other product names used in this publication are for identification purposes
only and may be trademarks of their respective companies.
================================================================================