___________________________________________________________________

                      Elan Digital Systems Limited.
___________________________________________________________________
HD717 Card Family 
Last Update    : 22/12/2003
Latest Release : V1-03
-------------------------------------------------------------------

	INSTALLATION NOTES
	------------------
	

	Additional Information 
	----------------------
	Installed to sub-directory ElanPCCard\cards\hd717 (<INSTALLDIR>) are :

	DIRECTORY			FILES
	<INSTALLDIR>\doc		Documentation for HD717 card hd717ug.pdf,	
					Documentation for DLL/DRIVER	
	<INSTALLDIR>\drv		hd717lib.dll and hd717drv.sys files +
					Registry patch files + pccardgo driver/lib files
					
	<INSTALLDIR>\dll_src		source files for hd717lib.dll
	<INSTALLDIR>\drv_src		source files for hd717drv.sys
	<INSTALLDIR>\test_c		source files for BC++ 5-02 test program
	<INSTALLDIR>\vb6		header file for use with VB6 application
	

	Installation Notes for HD717 drivers
	------------------------------------

	For Elan PCI fitting PCMCIA adapter hardware:
	1. Install P-Series driver software (CD).
	2. Install hardware adapter.
	3. Install Card Centre Pro (CD).
           -this installs pccgo32.dll pccgocls.sys & pccardgo.sys drivers.
	   -documentation about HD717 hardware/software registers provided here.	
	4. Provide information to introduce dll & driver to system.
	   Run file HDNT4.reg on NT4 system and copy driver hd717drv.sys into 
           \winnt\system32\drivers. For Windows 2000/XP use HDW2000.reg and copy 
	   hd717drv.sys into  \windows\system32\drivers. 
	5. Copy hd717lib.dll to the windows directory unless it is in the directory
	   that you will be running your application from. 
	6. Re-boot the PC.

	Steps 1. & 2. should not be required on laptops, or on desktops using ISA
	PCMCIA Adapters

NT4,2000,XP
-----------
	Directories 
	-----------

	pccgo32.dll to	windows\system or same directory as application .exe
	hd717drv.dll in	windows\system or same directory as application .exe
	pccgocls.sys to	winnt\system32\drivers
	pccardgo.sys to	winnt\system32\drivers
	hd717drv.sys in	winnt\system32\drivers

	Registry
	--------

Make Registry Key:-
	\HKEY_LOCAL_MACHINE\System\CurrrentControlSet\Services\HD717drv
 & set the following values (Strings in quotes, all DWORDS for raw data):-	 
	NAME		VALUE
	Default
	DisplayName	"HD717drv"
	ErrorControl	0x00000000
	ImagePath	"\SystemRoot\System32\Drivers\HD717drv.sys"
	Start		0x00000002
	Type		0x00000001

W2000 & XP require Unicode text files.

--------------------------------------------------------------------
REVISION NOTES/HISTORY:
--------------------------------------------------------------------

	Beta release Notes June 25th 2002
	---------------------------------
	
	hd717drv :
	----------
	Driver works, error conditions may not be fully reliable
	Driver developed using Microsoft Developers Network DDK,
	Microsoft Visual C V6.0 & Application Studio V6.0.

	Header files provided only for beta release.
	Source files to be provided for 1st issue release.

	hd717lib.dll : driver developed using Borland C++ 5.02
	--------------
	All library functions defined - most are as seen in DOS library.
	Socket number is passed in to most function calls. Currently
        driver will only support one HD717 card per PC. This may change but
	for now one card only is allowed.


	bc++ 5.02 project :	hd717tst.exe
	-------------------

	This project shows primitive setup and TX/RX of data from files
	txfile.bin & to rxfile.bin. 
	To send more/less Tx data use larger/smaller
	file named txfile.bin & place in the same directory as executable.
	<Txfile file must be greater than 64K for this simple test program)

	Rx data is collected to file until a Rx character timeout occurs where
	no characters have been received for a period of time.

	Three Primary Test Options provided at the four different Clock rates.
	*1 Tx File data.
	*2 Collect Rx data to File.
	*3 Tx File whilst receiving another to file (files of same size required).

	Two Supplemental tests at the four different Clock rates:
	*4 Loopback Direct TX FIFO to Rx FIFO data 	
	*5 Loopback Direct TX FIFO to Rx Buffer (collected under interrupt control)

	Test 1 TX File

	Can Send data only : Rate 0.5,1.0,2.0 Mbit/sec file sizes 1M-8M
	In short bursts can transmitt at 4Mbit/sec.

	Test 2 Rx File

	Receive data	   : Rate 0.5,1.0,2.0 Mbit/sec file sizes 1M-8M
	In short bursts can receive at 4Mbit/sec.

	Test 3 Tx/RX (Loopback optional)

	Can Tx data whilst receiving data sent from 2nd HD card on seperate
	PC.  Rates : 0.5,1.0M for files 1M in size. 
	This test may used with a Loopback connector 
	Send/recieve on same card functioning version 1-01

	Test 4 Tx/Rx FIFO (Loopback)
	Put a preprepared message into the Tx FIFO buffer and collect the message from Rx 
	FIFO buffer.
	
	Test 5 Tx FIFO Rx Buffer (Loopback)
	Put a preprepared message into the Tx FIFO buffer and collect the message from the
	Rx Buffer and the Rx FIFO.

      

	Ceta release Notes July 22nd 2002
	---------------------------------

	Issue now contains source code for driver.
	Please note that driver source files are still under modification, with	respect 
	particularily to error reporting.
		


	***************************************************
	HD717 DRIVER KIT ISSUE V1-00 Release date Aug. 2002
	***************************************************

	1st release August 28th 2002 -files integrated with Card Center Pro CD installation.


	***************************************************
	HD717 DRIVER KIT ISSUE V1-01 Release date Oct. 2002
	***************************************************
	ENHANCEMENTS
	Programmers guide added.
	Source code tidy DLL/DRIVER
	Install modified. HD717 Drivers NOT installed as part of CCP installation. 
	Supplied documentation guides installation of HD717 driver.

	
	Hd717tst.exe:
	Test code basic functionality complete. Test functions working reliably up to 
	2MBit/sec. Short bursts (<buffer size) work at 4Mbit/sec.
	Adjustments made to tests 1,2 & 3.

	Test 1: TX data from file. New Function DLL_HDTXGetBSpace enhances performance 
	Test 2: RX data saved directly to file .no filesize limitation
	Test 3: TX/RX Loopback:RX data saved to heap copied to rxfile.bin at end of RX 
		collection (caution max filesize = 1Mbyte).
	
	Hd717lib.dll:
	Function DLL_HDTXGetBSpace() added to return available bytes left in buffer.

	Hd717drv.sys:
	New Device IO call to Get TX Buffer Space = HD_GETTXBSPACE  


	FIXES
	

	***************************************************
	HD717 DRIVER KIT ISSUE V1-02 Release date Jan. 2003
	***************************************************
	
	ENHANCEMENTS
	
	These software enhancements are only available for HD hardware of the following
	issue or higher:
	HD717 Iss 2-07+, HD713 1-05+, HD712 1-04+ only
	
	Hd717lib.dll:

	Reset of SCC device:
	FPGA Hardware now forces the SCC to reset when DLL_PutCardIntoKnownState() is 
	called. 

	New Interrupt:
	Rx Interrupt available for condition Rx buffer not empty.
	Introduced support functions:-
	DLL_MaskRX4KFIFOEInterrupt(),DLL_UnMaskRX4KFIFOEInterrupt()
	GetRX4KFIFOEInterrupt()

	Improved Clock Rate coverage:
	8MHz clock now can be routed out to RX and TX clock pins

	Low level functions DLL_EnablePRESCALE() and DLL_DisablePRESCALE(),
	recommend use of new clock setting function DLL_SetSCCClockRate() to
	select clock source and rate.

	Hd717drv.sys:
	Extra stub code added to handle new interrupt source= interrupt on
	RX FIFO buffer NOT empty.

	***************************************************
	HD717 DRIVER KIT ISSUE V1-03 Release date Dec. 2003
	***************************************************

	FIXES
	
	File hd717log.rc omission  - file included with driver code, documentation
	amended.

--------------------------------------------------------------------
	End of readme.txt file
--------------------------------------------------------------------