readme.txt

AU1200嵌入式处理器媒体加速引擎（mae）的驱动

////////////////////////////////////////////////////////////////////////

July 17, 2005: Started to new driver sriver architecture based on the main-2 branch Linux driver.

FEATURE NAME: MAE WinCE Driver for Au1200



MANUFACTURER: Advanced Micro devices Inc.



CONTACT INFO: Jatinder Pancar & Muhammad Kafil



DATE: 6/1/05



VERSION: 1.0.1.2



DESCRIPTION: 
This is Media Acceleration Engine driver for Au1200. This
will decode and present video data to Au1200 hardware and display the
video on LCD.



BUILD INSTRUCTIONS: 
This project is built with Platform Builder 5.0. Open your platform 
builder 5.0, load your workspace and selet insert existing project from 
Project/Insert tab. Point it to the .pbxml file and click open. The 
project should open in your workspace. From there you can build
the project by right click and pressing build current project.

HOW TO USE:
The driver is loaded automatically at bootup if you follow the procedures
above. The Init routine is called during bootup. In your application a
wrapper is used to talk to this driver. The wrapper opens the driver by 
making the following call:

	filehandle = CreateFile(
			TEXT("MAE1:"),
			GENERIC_READ | GENERIC_WRITE,
			0,
			0,
			OPEN_EXISTING,
			FILE_ATTRIBUTE_NORMAL,
			0);

Once this call passes, you will need to do IOCTL call to AU1XXXMAE_INIT as
follows:

	DeviceIoControl(filehandle, AU1XXXMAE_INIT, (LPVOID)&ioc, sizeof(ioc),
			 (LPVOID)&DB, sizeof(DebugBuffers),
			 &BytesReturned ,NULL);

This will do rest of the initialization of the driver. After this call, you
should do a setmode call as follows:

	DeviceIoControl(filehandle, AU1XXXMAE_SETMODE, IPB_FRAME_MODE, sizeof(IPB_FRAME_MODE),
			 (LPVOID)&DB, sizeof(DebugBuffers),
			 &BytesReturned ,NULL);

At this point the driver is ready. The other calls that are supported in the
driver are as follows:

AU1XXXMAE_REQUEST		// This will request a buffer for FE
AU1XXXMAE_SUBMIT		// This will submit a buffer to FE
AU1XXXMAE_PRIME_FE		// This will setup the hardware for FE
AU1XXXMAE_GETYUVBUFADDR		// This will get you a yuv buffer address
AU1XXXMAE_GETYUVBUF		// This will get you a yuv buffer
AU1XXXMAE_DISPLAYSIZE		// This will set the display video size
AU1XXXMAE_GETDISPLAYSIZE	// This will get the display size
AU1XXXMAE_SUBMIT_BE		// This will submit a buffer to BE
AU1XXXMAE_REQUEST_BE		// This will request a buffer for BE



History:
========
1.0.1.2 - 8/2/05
- added a registry key to change the playback mode for video only. IgnorePTS registry key
  was added. Set it to 1 for max playback mode; set it to 0 for normal playback mode.
  Default is Normal Playback mode

1.0.1.1
Initial driver with AVsync added. 




////////////////////////////////////////////////////////////////////////