FAME Files

This README file gives some instructions on how to compile the FAME example.


-1- FAME

   In order to have the example functioning you first need to install the libfame:

   http://sourceforge.net/projects/fame-polito/files/libfame-1.1.tar.gz/download


-2- COMPILATION:

    To compile the example just execute 'make' in the example library.

	In order for to correctly link the example program with libfame, 
	you need to instruct the compiler on the locatin of the library.
	First of all, locate the library with the following command:

	$> whereis libfame

	The default answer will be similar to:
	"libfame: /usr/local/lib/libfame.la /usr/local/lib/libfame.a /usr/local/lib/libfame.so"

	In any case, the default location is '/usr/local/lib'.

	Once you have located the library (suppose in '/usr/local/lib'), 
	you can do one of the following:

	1) in the compilation command specify the library path by means of the -L option:
	   e.g. gcc -L/usr/local/include my_prog.c -lfame

	2) set the default environment library path variable to include the '/usr/local/lib':
	   $> export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib


-3- USE:

	In the 'library' folder there is an example FAME User Library.
	You can use the example application both by script and by the FAME command prompt.

	1) Script:
		in the 'ex-script.fame' file, in the 'test' directory,
		there is a sample script to call the GPFS command.
		Cd to the 'test' directory and call the example application 'fame-ex' in the following way:

		$> ../fame-ex -s ex-script.fame 8051_test.edn ../library 8051_test.pdc

	2) Command prompt:
		Cd to the 'test' directory and call the example application:

		$> ../fame-ex 8051_test.edn ../library 8051_test.pdc

		after some information, the FAME will show you the prompt. Type the following command:

		$> GPFS test_mine/work/CORE8051S_i0lii/netlist/CORE8051S_lol0i_0

		and to terminate the execution type the 'END' command.

	The sample application, using the mentioned commands, will print the logic paths that begins
	from the 'CORE8051S_lol0i_0' instance and that ends with another memory element.


This is a very simple application that just shows how to interact with the FAME library.
Try to play with the FAME APIs and built-in commands to have a better idea of what are the offered services.