/*****************************************************************************/
/*                                                                           */
/*       --- CAEN Engineering Srl - Computing Systems Division ---           */
/*                                                                           */
/*   Software support for A303/A High Speed CaeNet Controller                */
/*                                                                           */
/*   Documentation for Linux users                                           */
/*                                                                           */
/*   Created: January 2000                                                   */
/*                                                                           */
/*****************************************************************************/
  
 This archive contains the following files:                              
              
   readme.txt  - This file                
   a303drv.c   - Source file for A303 Module Linux device driver. It has     
                 been compiled for kernel version 2.0.32                     
   a303drv.h   - Include file to use with the driver                         
   a303drv.o   - Driver binary module, to load with "insmod"                 
   A303_load   - Shell script which loads module a303drv.o and creates the   
                 file system entry "/dev/A303" for the device.               
   sy527demo.c - Demo program which uses /dev/A303 to dialogate with SY527 
                 Universal Multichannel Power Supply System 
   a303.c      - Wrapper for the driver
   a303.h      - Declarations of functions in a303.c
   a303.o      - Object file of a303.c
   console.c   - Wrapper for console generic I/O (support for sy527demo)
   console.h   - Declarations of functions in console.c
   console.o   - Object file of console.c
   sy527demo.o - Object file of sy527demo.c
   sy527demo   - Executable of the demo program  
   Makefile    - Makefile to produce a303drv.o and sy527demo 
   a303diag    - Diagnostic program which verifies if A303 is correctly 
                 installed

 The driver works with A303 and A303A, because they are software         
 compatible.                                                             
 
 Installation notes:

 Have the A303 or A303A module user manual.
 Decide the I/O Port Address for A303 (it must not conflict with preinstalled hardware).
   The correct values depend on your PC setup, but typical values are:
   I/O Port           :  0x330, 0x300, 0x200, ...                                                                         
 Configure A303 module by specifing I/O addressing (SW7 on 
   A303A or SW1 on A303 in position OFF) and by setting the I/O port 
   (SW1 ... SW4 on A303A or SW3, SW4, SW5 on A303).
 Enable A303 Interrupt generation: (SW6 on A303A or SW2 on A303 in position ON).
   It is IRQ9; be sure it is not already in use on your PC. 
 Install the A303 module into a free ISA Bus slot and power up the PC.
 Login as root.
 Load the driver launching the "A303_load" script.
 Now you can run a program which sends CAENET commands through A303 module;
 you can launch for example "sy527demo" to verify the correct driver 
 installation.                                                                           
