/*****************************************************************************
$Workfile: Readme.txt $
$Revision: 14 $
$Date: 11/13/00 6:49p $
$Modtime: 11/13/00 6:49p $
$Author: Sarma $

Copyright (c) 1999-2000 Nationl Semiconductor Corporation
Copyright (c) 1990-1996 Microsoft Corporation
All Rights Reserved.

This software is the confidential and proprietary information of National 
Semiconductor Corporation Corporation. ("Confidential Information").
You shall not disclose such Confidential Information and shall use it only
in accordance with the terms of the license agreement you entered into
with National Semiconductor Corporation Corporation.
This code is supplied as is.

Version history of Linux Framebuffer driver

*****************************************************************************/

Table of Contents 
----------------- 
- Release description 
- Product files 
- Build instructions
- Installation instructions
- Notes, Problems, and Limitations 
- Version changes 


Release description 
------------------- 
This is the National Semiconductor Framebuffer driver 1.0.8
This version of the driver works with the new linux graphics driver architecture 
followed by National. This driver has been tested with Linux Kernel 2.4.0-test1. 

This product includes: 
 
- Framebuffer driver
 
Product files 
------------- 
   \readme.txt        This file 
   \vmlinuz-2.4.0-test1      Framebuffer driver built into 2.4.0 kernel

Build instructions
------------------

0. You must have built and currently be using the kernel you 
   intend to use with the geode framebuffer driver.

1. place all files and subdirectories from $:linux/framebuffer/Linux-2.4.0-test1
   into /usr/src/linux/drivers/video

2. Now move into "/usr/src/linux/drivers/video/geode". Build "crlf" by executing
   "cc -o crlf crlf.c".
  
3. Remove Carriage Returns on copied files 
	cd "/usr/src/linux/drivers/video/"
	geode/crlf Config.in
	geode/crlf Makefile
	geode/crlf fbmem.c
	cd "/usr/src/linux/drivers/video/geode"
	./crlf -a

4. Copy the corresponding Durango and copy into "/usr/src/linux/drivers/video/geode/gfx"
	cd "/usr/src/linux/drivers/video/geode/gfx"
	../crlf -a

5. If building on SCx200 system, to fix the PCI problem follow the instalation instructions
   provided in $:linux/kernel/SCx200/readme.txt

6. change directory to "/usr/src/linux"

7. a) Run "make menuconfig"
   b) Goto "Code maturity level options"
   c) Enable "Prompt for development drivers"
   d) Goto top level menu and select "Console drivers"
   e) Goto "Frame-buffer Support"
   f) Select "NSC Geode display support"
   g) Select "Advanced low level driver options"
   h) Select "8 and 16bpp packed pixel support"
   i) Save the kernel configuration

8. Run "make dep"

9. Run "make install"

10. Modify "/etc/lilo.conf" to use this kernel, an sample is given below

	boot=/dev/hda
	map=/boot/map
	install=/boot/boot.b
	prompt
	timeout=50
	vga=ask
	linear
	default=linux

	image=/boot/vmlinuz-2.4.0-test1
			label=linux
			read-only
			root=/dev/hda1


11. Run "lilo"
   
Installation instructions
------------------------- 
1. Make sure the kernel you just built is in the directory where
   Linux boots.

2. Modify "/etc/lilo.conf" to use this kernel, a sample is given below

	boot=/dev/hda
	map=/boot/map
	install=/boot/boot.b
	prompt
	timeout=50
	vga=ask
	linear
	default=linux

	image=/boot/vmlinuz-2.4.0-test1
			label=linux
			read-only
			root=/dev/hda1

3. Run "lilo"

Notes, Problems, and Limitations 
---------------------------------

1. Framebuffer driver has been tested with 2.4.0-test1 kernel. It may not
   work with other kernel versions.

Version changes
---------------
_______________________________________________________________________________

11/13/00    v1.0.8
_______________________________________________________________________________

	----------------------------------------------------------------------
	Bugs Fixed:
	----------------------------------------------------------------------
	Known Issues:
	----------------------------------------------------------------------
	Dependencies:
	- GAL Layer 1.0.4
	- Durango v2.13
	----------------------------------------------------------------------
- Added two APIs for compression support
geodeioctl.c
geodeioctl.h

- changed definitions for wsupported in isdisplaymodesupported
- Changed wSupported in isdiplaymodesupported to DWORD
geodeioctl.c

_______________________________________________________________________________

10/24/00    v1.0.7
_______________________________________________________________________________

	----------------------------------------------------------------------
	Bugs Fixed:
	- Cant switch from text to graphics mode
	----------------------------------------------------------------------
	Known Issues:
	----------------------------------------------------------------------
	Dependencies:
	- GAL Layer 1.0.3
	- Durango v2.13
	----------------------------------------------------------------------
- A new dynamic device (/dev/nscgal) is created for GAL to start functioning
- This device is active irrespective of whether framebuffer driver
  initializes /dev/fb0 or not.
_______________________________________________________________________________

10/24/00    v1.0.6
_______________________________________________________________________________

	----------------------------------------------------------------------
	Bugs Fixed:
	- None
	----------------------------------------------------------------------
	Known Issues:
	----------------------------------------------------------------------
	Dependencies:
	- depends on and supports GAL Layer 1.0.2
	- depends on durango v2.13
	----------------------------------------------------------------------
Added support for XFree 4.0.1.
Added (set/get)displaytiming and setpalette APIs
Added support for new fields in adapterinfo
_______________________________________________________________________________

version 1.05
------------
1. Companion - GAL lib v1.0.1
2. Support for GAL layer

version 1.04
------------
Support for SC1200

version 1.03
------------
1. Built for kernel 2.4.0-test1
2. color depth changes had fill blt problem. Fixed.
3. fbmem.c was added to the project.

version 1.02
------------
Added debug statements
Fixed graphics registers size problem
Added VESA dpms support
Correct timing and PLL values are returned.

version 1.01
------------
1. Built for kernel 2.4.0-test1
2. This version is based on virgefb driver.
3. Still has all the accelerated code from the 
   previous version

version 1.00
------------
1. Built for kernel 2.4.0-test1
2. Tested on a unicorn board.
3. Supports bmove and clear
4. Supports dynamic mode changes