%INSTALL

1. Environment
	Language/OS : ESP/SIMPOS, KL1/PIMOS

2. How to install
	(0) Execution of directories
		I assume that current directory is ">sys>user>haisen".
		There are three directories as follows.
		KL1:KL1 sources
		ESP:ESP sources
		DATA:"gridsize","blocklist","netlist","pointlist"
		(a)"gridsize" shows the size of a routing grid.
		     {horizontal size,vertical size}.
		(b)"blocklist" shows pathing through inhibition area.
		     [{Rtouing Layer,{left-bottom point,right-top point}},...].
		(c)"netlist" shows the set of 2-terminal nets.
		     [{start point,target point},...].
		(d)"pointlist" shows the set of through hole inhibition points,
		    that are bending inhibition points
		     [{x-coordinate,y-coordinate},...].

	(1) Catalogue ESP source files
		Create "librarian" process, and define new package "haisen".
		Catalogue all ESP source files under "haisen" package.
		And also save all classes after catalogue has completed.

	****** How to catalogue and save ******
	1) Call "librarian" from system menu
	2) Select "Package" commnad.
	3) Select "Define package" command.
	4) Type "haisen" for Package name.
	5) Select "Yes" item to execute creation.
	6) Confirm environment as "simpos", select "do it" item.
	7) Select "Package" command.
	8) Select "Set default package" command.
	9) Type "haisen" as default package.
	10) Select "do it" item.
	11) Select "Catalogue" command.
	12) Type ">sys>user>haisen>ESP>*.esp" for filenames
	13) Select "do it" item.
	14) Select "Save" command after "Catalogue" command
	    has beeen completed.
	15) Confirm that all catalogue classes are selected and
	    select "do it" command.

	(2) Compile KL1 source files
		(Set package name to "haisen"  from pimos shell.)
		Compile all KL1 source.
		Unload all modules after compile has been completed.

	***** How to compile and unload ******
	1) Login on "PIMOS" (See PIMOS manual)
	2) Execute a following command.
		cd ">sys>user>haisen>KL1"
	3) Execute a following command.
		compile(["top_l","part1","part2","part3",
		 "top_p","dists","masters",
		 "lines","terminals","utilities"])
	4) Execute a following command after compile has been completed.
		unload([top_level,part1,part2,part3 top_process,
			distributors,master_lines,lines,terminals,
			utilities],"router")

	   When you login next time, you can load a saved file by 
	   executing a following command.
		load("router")

	(3) Create "block.bin"
		Create a binary file named "block.bin" from a text file named 
		"blocklist".

	****** How to create a binary file ******
	1) Call "debugger" from system menu
	2) Execute a following command.
		package.
	3) Select "haisen".
	4) Execute a following command.
		:go(#block_f_conv,">sys>user>haisen>DATA>blocklist",
		    ">sys>user>haisen>DATA>block.bin").

	(4) Execution of a main program
		Let's execute a main program from "Listener" as follows.

	****** How to execute a main program ******
	1) Execute a following command.
		top_level:router(A).
	2) Select "do it" with a left button of mouse.
	3) Wait until "Setup complete" is displayed.
	4) Push a middle button of mouse twice quickly at the window area of 
	   this program to start the routing process.
	5) When the execution finish, "Routing Completed" is displayed.
	6) Push a middle button of mouse twice quickly at the window area of 
	   this program to terminate the routing process.