______________________________________________________________________________

ReadMe.txt

______________________________________________________________________________

Copyright (C) 2007 Oxford Semiconductor Ltd.

Author: David D. Chen

______________________________________________________________________________

Device driver for native mode UARTs of PCIe95x/200 family devices.

Installation
____________

1. Install Windows CE 4.2 Platform Builder (PB) to hard disc. Note the 
   WINCEROOT i.e. the path where the CE 4.2 is installed (generally C:\WINCE420).

2. Run the batch file "CopyDriverToWinCERoot.bat" which will prompt the 
   user to enter the WINCEROOT. The batch file will then copy all files 
   and subfolders of the source code to the Windows CE 4.2 root directory. The 
   following directory structure shall be seen:

	C:\WINCE420\OXSEMI
                   |------UARTS
		   |          |
	           |          |-----....
	           |          |-----pcie950_uart
                   |                    |
                   |                    |---------pcie950_bus
                   |                    |---------pcie950_isr
                   |                    |---------pcie950_ser
	           |                    |-----....
                   |------APPS
	                    |
	                    |-----suart
	                    |------....


3. Start (configure and rebuild if required) PB

4. Click “File->Manage Catalog Features” to start “Manage Catalog Features” dialog

5. Click “Import…” button to start “Import Catalog Features” dialog and import 
   cec files of “pci954_uart.cec” under the “uarts” subdirectory

6. Select the target configuration (for example "CEPC:X86 Win32 (WCE x86) Release").
   by click "Target->Set Active Configuration.."

7. Add PCIe950 feature to OS by right-clicking on the pcie950_uart feature logo
   in catalogue view  and choose “Add to Platform”

8. Start platform build process by clicking “Build->Rebuild Platform”.

______________________________________________________________________________

Modifications required
______________________________________________________________________________

Interrupt triggering and flow control levels
____________________________________________

Four level control values can be defined in "pci954_uart.reg" file (brackets 
indicate the correcponding 16950 registers, to where the values will be stored 
when device driver being loaded):

    "RxIntTrigLevel" ------ Receive Interrupt Triggering Level (RTL)
    "TxIntTrigLevel" ------ Transmit Interrupt Triggering Level (TTL)
    "FlowCtrlLowLevel" ---- Automatic Flow Control Lower Trigger Level (FCL)
    "FlowCtrlHighLevel" --- Automatic Flow Control Higher Trigger Level (FCH)

The level control values defined in pci954_uart.reg file shall be used as default
values by all UART channels.

The level value are expressed in hexadecimal, NOT DECIMAL. For example, to set
the Receive Interrupt Triggering Level to 95, the following line should exist
under the corresponging key:

    "RxIntTrigLevel"=dword:5F

If required, the level control values of each UART channel can be changed
individually using "SUART", which runs on the target OS.

Interrupt triggering and flow control levels
____________________________________________

Baudrate Map List can be defined in "pci954_uart.reg" file using the two registry
values:

    "BaudrateMapListFrom" --- Baudrate Map List for From baudrates
    "BaudrateMapListTo" ----- Baudrate Map List for To baudrates

The baudrate map list defined in pci954_uart.reg file shall be used as default by
all UART channels.

The baudrate values are expressed in decimal. For example, to map baudrates of
230,400 and 1,843,200 to baudrates of 1,200 and 2,400, the following lines
should exist under the corresponding key:


    "BaudrateMapListFrom"=multi_sz:"1200","2400"
    "BaudrateMapListTo"=multi_sz:"230400","1843200"

If required, the baudrate map list of each UART channel can be modified
individually using "SUART", which runs on the target OS.

________________________________________________________________________________
                          End of ReadMe
________________________________________________________________________________

