move import directory to new branch kicad-contrib

File: README 

	Wed May  2 13:26:24 MDT 2012 fwb

This import directory contains tools for importing

to Kicad from other EDA tools.

  edif2kicad 		/ EDIF to EEschema schematic import

	Tools with EDIF out writer:

       o OrCad

       o DataXpress

       o Viewlogic

       o IntuSoft ICAP

       o Protel nVisage

       o PADS ?

       o P-CAD ?

       o EDIF viewer (www.cimmetry.com)

       o EDIF translator (www.elgris.com/content/edif_overview.html)

  pcb123net2kicad	/ converts a pcb123 netlist to Kicad default format

	-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

	edif.y, e2net, e2sch - Frank Bennett 

	see change_log.txt for status

	Tools with EDIF out writer:

	   o OrCad

	   o DataXpress

	   o Viewlogic

	   o IntuSoft ICAP

	   o Protel nVisage

   	   o PADS ?

           o P-CAD ?

 	   o EDIF viewer (www.cimmetry.com)

	   o EDIF translator (www.elgris.com/content/edif_overview.html)

	Modified to output a KiCad Netlist

	1) find/store InstanceNameDef. ViewRef - i.e. CMP31.cap

        2) find/store Nets: NetNameDef, InstRef, PortRef

	3) sort Nets by InstRef

	Files:

	makefile	- Unix style makefile, runs Bison & runs gcc

	ppedif.c	- pretty print EDIF

	edif.y  	- edif BNF Grammer, yylex, & main.c

	savlib.c	- output format

	e2net.c		- EDIF to netlist main

	e2sch.c		- EDIF to libs, schematic main

	e2lib.c		- EDIF to libs (obsolete)

	examples/

	eyespy		- ORCad schematic (ATX PS)

	PS10      	- OrCad schematic in EDIF format(reformated)

	PS10.EDF  	- Original PS10

	PS10.pdf  	- PS10 schematic

	PS10.net  	- KiCad netlist output see below

	batest.1  	- edif test file

	batest.2  	- edif test file

	hptest      	- edif test file

	hptest.net	- KiCad netlist output see below

	Tested under Linux and cygwin (http://www.cygwin.com)

	Install: (./run_tests or)

		make

		cd examples

		../ppedif < PS10.EDF > PS10

		../e2net < PS10 > PS10.net or

		../e2net PS10 or 

		../e2net hptest or

		../e2sch examples/eyespy

		../e2sch examples/PS10

		../e2sch examples/BCD

        Notes:

		e2lib is now obsolute

	Edif Notes:

	o hptest is more readable for parser debugging. This begs for

 	  EdifBeautifier for the OrCad output (use ppedif)

	o EDIF schematic file contain

		- symbol ports names, Direction, Designator

		- symbol graphics, justification, orientation, origin

		- sheet  ports, instances, instance location, symbol reference

		- sheet  Netlist, wire paths 

	  Doesn't seem to include footprint references

	TODO:

	  o find/output schematic drawing, symbol graphics

	-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

	roger's previous comments:

	  This is an EDIF 2.0.0 parser, well more like a recognizer. If

	you build the test case and run it with a valid EDIF file on the

	standard input the program will just terminate normally. Sounds

	real useful, huh. The nifty part is that the core of the parser

	is YACC-able, almost. The problem is that the EDIF grammer is

	so large that standard YACC just can't swallow it. So you need

	to either super charge your YACC or use a YACC clone like BISON.

	I used BISON, which is GNU-ware and so is freely available besides

	being a terrific program. I think BISON is available from the

	Free Software Foundation or on systems near you; even I am happy

	to pass it on to whoever wants it.

	  Enough BISON praise. The reason I made the parser YACC-able is

	because past experience indicates this one of the easiest forms

	to add actions too, as well as put in updates or fixes. EDIF is

	hardly context free though, and so I had to fold all sorts of

	ugliness into the lexical analyzer to keep the YACC part clean.

	  This version is raw, it doesn't build symbol tables, do

	semantic checking or create a database. The parser itself won't

	even run though a wrapper has been included for testing. I wanted

	to get out one version before I started adding such junk to it.

	Again experience indicates that it is no fun lobotimizing parsers

	so that you can do the low level stuff your way. Besides somebody

	might even find a bug in the code ... naw, that's a silly

	justification.

	  The 'makefile' I've included is not the one I use (and probably

	will get me in lots of trouble). I invoke gobs of debugging and

	profiling switches which are specific to our compilers, the

	'makefile' is intended to be generic and may require some diddling.

	I developed the code on a BSD 4.3 system and haven't added the

	changes for SYS V, though they should be minor. The parser was too

	large to post in one piece, so it got split and the 'makefile'

	should know how to patch it together. There is one definition of

	possible interest. Compiling with a '-DDEBUG' will cause the 8 most

	recently consumed tokens to be displayed in the event of a parse

	error. Profiling indicates a pretty costly item though.

	  Three test cases are included:

	 	hptest	 -	by Fabio Angelillis of Hewlett-Packard

		batest.1

		batest.2 -	by Bill Ames of Silicon Compilers

	Many thanks to them and the files are provide as is, no warrenty

	implied and brush after every meal ...

	  I find the parser code to be easily immediately obvious and so

	no documentation is included in the release. Humm ... don't buy that.

	Actually documentation is in the works but it would delay this

	posting too long if I waited for it to be completed. If you find

	the parser totally incomprehensible, E-mail me a request and I'll

	send you whatever I have written by the time I get your mail.

	  Lastly, as far as I'm concerned this parser is now in the public

	domain and you can do anything you want with it. My next task is

	to make it build a database and when that's through I'll probably

	post it again ... you have been warned! Enjoy, and I'd be happy to

	get bug reports or stories of how many ways you found to delete

	the source ...

--

-your friendly neighborhood Rogue Monster                     roger@mips.com

UUCP: {decvax,ucbvax,ihnp4,hplabs,sun,ames,prls}!decwrl!mips!roger

USPS: MIPS Computer Systems, 930 Arques, Sunnyvale, CA 94086, (408) 991-0220

FILE: change_log.txt

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2012-Apr-27 fwb

	-EDIF added OrCad test/openrd.edf & test/OPENRD_16-00050-02.pdf files

		-See OpenRD.org - Open Reference Designs

		-Marvel Sheeva 88F6281 ARM SOC, USB, DDR2, PCIe, SATA

		-multiple sheet symbol (netlister gives warning for

			multiple U1 - sheet 2,3,4,6) need to fix EEschema netlister

	-sheet ref [1,2,3] -> {1,2,3} (not bus members)

 	-bus range DDR2[15:0] ->DDR2[15..0]

	-pickup footprint, manufacture and MFG part number

TODO fixme

	-PARTSVALUE coordinates are wild

	-get rid of all the ANNOTATION "COMMENT" OutText

	-PORT LEFT,RIGHT,BOTH oxy s/b 0,0 not PWR symbols

testing

	$make

	$cd test

	$../e2sch openrd.edf

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Apr-28 fwb

	fix sig segv for eample/X375D_VER72.EDF

        some bug with ARCS position??

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Apr-1  fwb

	match top.sch sheet names with sch files

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Mar-31 fwb

	cleanup module, pin names

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Mar-28 fwb

	generate a top.sch if # pages >1

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Mar-26 fwb

	first attempt to write multi-page schematics

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Mar-3  fwb

  	Ref Desig, value location move with symbol

	netlist improved

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Feb-13 fwb

	Reference and value move with Instance

	added symbol text

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Feb-10 fwb

 	Improved Instance reference, value positions

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Feb-7  fwb

	1) OrCad version 10 doesn't xmit PIN_32_NUMBER_32_IS_32_VISIBLE

	   so for now all pins are visable

	2) Verion 10 uses portInstance to display PIN name/number but

	the coordinates are messed and without 1) no pin hotspots are shown

	3) added PCB_FOOTPRINT Instance property

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2008-Feb-6  fwb

	improved text scaling

 	automatically compute pin lenght and orientation

	Instances were getting confused with CellDefs

	Circles & Rectangles seem to be correct now

	Design can now include CellDefs

	e2sch works with OrCad version 9 , EDIF from ver 10 has problems

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-dec-3  fwb

	demote symbols (*XTIE* or *JUNCTION*) to connections

	improving netlist quality

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-nov-21 fwb

	fixed property property integer

	multi segment WIRE - OrCad ver 10

	text size per FigGrp

	pick up Instance Ref Designator

   TODO

	remove XTIEs form netlist

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-nov-16 fwb

	removed strndup from edif.y

	added OutPro function to generate a .pro file with libs listed

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-30 fwb 

	fixed CAPSYM.lib - power syms

	better netlist - caps have VCC & GND

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-23 fwb - clean up, fix core crash, pin visability

	TODO:

		o fix Power connections

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-17 fwb - Schematic is useable, not perfect

	eyespy works, PS10 doesn't

	need to hand edit 

	o library for PinUP, PinDown

	o OrCad mistakes (couple Cap positions)

	TODO:

	 	o debug/fix PS10

		o add TIE points

		o try to generate a netlist from EEschema

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-Oct-12 fwb - multiple libs, fixed ARC, DESIGNATOR/VALUE 

	position Demorgan convert & pin name renames

	Looks good enough to start schematic

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-Oct-10 fwb - major rewrite, cleanup

       	produces separate libs, KiCad style

       	symbol pins are close

       	but not quite ready for primetime

       	ARC needs some work

       	Note:OrCad puts out multiple Instance designators

	    Program warnings only

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-06 fwb - fewer errors on lib browse

  	symbls are recognizable

	need to work on text orientation	

	e2net broken

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-05 fwb - produces almost readable eyespy.lib

	need to fix:

	   DRAW

	   P 0 0 0 0

	after this error, ok, library browse

	draws some stuff.

	need to add curve/arc

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-03 fwb - initial ci e2lib.c

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

20071003 fwb - split main out of edif. Now have e2net, e2sch

	this also might keep the parser clean, which will 

	just build the structs

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-oct-02 fwb - added a pretty print edif program (ppedif.c) and 

	updated makefile

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2007-sep-19 fwb - Original release

/*

 * e2lib - EDIF to KiCad library

 */

#define global

#include <stdio.h>

#include <string.h>

#include "ed.h"

#include "eelibsl.h"

int yydebug=0;

int bug=0;  		// debug level: 

char *InFile = "-";

char  FileNameNet[64], FileNameLib[64], FileNameEESchema[64], FileNameKiPro[64];

FILE * FileEdf, * FileNet, * FileEESchema, * FileLib=NULL, * FileKiPro=NULL;

global char 	      		 *cur_nnam=NULL; 

global struct inst    		 *insts=NULL, *iptr=NULL; 

global struct con     		 *cons=NULL,  *cptr=NULL;

global float scale;

main(int argc, char *argv[])

{

  char * version      = "0.9";

  char * progname;

  progname = strrchr(argv[0],'/');

  if (progname)

    progname++;

  else

    progname = argv[0];

  fprintf(stderr,"*** %s Version %s ***\n", progname, version);

  if( argc != 2 ) {

     fprintf(stderr, " usage: %s EDIFsrc \n") ; return(1);

  }

  InFile= argv[1];

  if( (FileEdf = fopen( InFile, "rt" )) == NULL ) {

       fprintf(stderr, " %s non trouve\n", InFile);

       return(-1);

  }

  sprintf(FileNameEESchema,"%s.sch",argv[1]);

  if( (FileEESchema = fopen( FileNameEESchema, "wt" )) == NULL ) {

       fprintf(stderr, " %s impossible a creer\n", FileNameEESchema);

       return(-1);

  }

  sprintf(FileNameKiPro,"%s.pro",argv[1]);

  if( (FileKiPro = fopen( FileNameKiPro, "wt" )) == NULL ) {

       fprintf(stderr, " %s impossible a creer\n", FileNameKiPro);

       return(-1);

  }

  fprintf(stderr, "Parsing %s\n", InFile);

  Libs=NULL;

  ParseEDIF(FileEdf, stderr);

  fprintf(FileEESchema,"$EndSCHEMATC\n");

  for( ; Libs != NULL; Libs = Libs->nxt ){

	// fprintf(FileLib,"### Library: %s ###\n", Libs->Name);

  	sprintf(FileNameLib,"%s.lib", Libs->Name);

	if( (FileLib = fopen( FileNameLib, "wt" )) == NULL ) {

       	    printf( " %s impossible a creer\n", FileNameLib);

       	    return(-1);

  	}

  	fprintf(stderr," writing %s\n", FileNameLib);

	SaveActiveLibrary(FileLib, Libs );

  	fclose(FileLib);

  }

  fclose(FileEESchema);

  fprintf(stderr, " BonJour\n");

  return(0);

}

/*

 * e2net - EDIF to KiCad netlist

 */

#define global

#include <stdio.h>

#include <string.h>

#include "ed.h"

#include "eelibsl.h"

int yydebug=0;

int bug=0;  		// debug level: >2 netlist, >5 schematic, >8 all

char *InFile = "-";

char FileNameNet[64], FileNameSdtLib[64], FileNameEESchema[64], FileNameKiPro[64];

FILE * FileEdf, * FileNet, * FileEESchema, * FileSdtLib=NULL, * FileKiPro=NULL;

global char                      *cur_nnam=NULL;

global struct inst               *insts=NULL, *iptr=NULL;

global struct con                *cons=NULL,  *cptr=NULL;

global float scale;

main(int argc, char *argv[])

{

  char * version      = "0.91";

  char * progname;

  progname = strrchr(argv[0],'/');

  if (progname)

    progname++;

  else

    progname = argv[0];

  fprintf(stderr, "*** %s Version %s ***\n", progname, version);

  // if( argc != 2 ) {

  //    fprintf(stderr,  " usage: %s EDIDsrc \n") ; return(1);

  // }

  if( argc != 2 ){

     FileEdf = stdin;

     FileNet = stdout;

  }else{

     InFile= argv[1];

     sprintf(FileNameNet,"%s.net",argv[1]);

     fprintf(stderr, "Parsing %s\n", InFile);

     if( (FileEdf = fopen( InFile, "rt" )) == NULL ) {

          fprintf(stderr, " %s non trouve\n", InFile);

          return(-1);

     }

     if( (FileNet = fopen( FileNameNet, "wt" )) == NULL ) {

          fprintf(stderr, " %s impossible a creer\n", FileNameNet);

          return(-1);

     }

  }

  Libs=NULL;

  FileEESchema = NULL;

  ParseEDIF(FileEdf, stderr);

  fprintf(stderr,"Parse Complete\n");

  // bubble sort cons by ref

  struct con *start, *a, *b, *c, *e = NULL, *tmp;

  char line[80], s1[40], s2[40], *s;

//  for (start=cons ; start != NULL ; start = start->nxt ){

//      fprintf(stderr,"%s %25s %s\n", start->ref, start->pin, start->nnam);

//  }

  if(cons != NULL)

  while (e != cons->nxt ) {

    c = a = cons; b = a->nxt;

    while(a != e) {

      sprintf(s1, "%s%25s", a->ref, a->pin);

      sprintf(s2, "%s%25s", b->ref, b->pin);

      if( strcmp( s1, s2 ) >0 ) {

        if(a == cons) {

          tmp = b->nxt; b->nxt = a; a->nxt = tmp;

          cons = b; c = b;

        } else {

          tmp = b->nxt; b->nxt = a; a->nxt = tmp;

          c->nxt = b; c = b;

        }

      } else {

        c = a; a = a->nxt;

      }

      b = a->nxt;

      if(b == e)

        e = a;

    }

  }

  // dump connections by component

  strcpy(s1,  "" );

  for (start=cons ; start != NULL ; start = start->nxt ){

      if(strcmp(s1, start->ref) != 0)

	printf("\n");

      printf("%4s %3s %s\n", start->ref, start->pin, start->nnam);

      strcpy(s1,  start->ref);

  }

#ifdef NOT

  while(insts != NULL){

    printf("%5s %s\n", insts->ins, insts->sym);

    insts = insts->nxt;

  }

#endif

  // output kicad netlist

  int  first=1;

  fprintf(FileNet,"( { netlist created  13/9/2007-18:11:44 }\n");

  // by component

  strcpy(s1,  "" );

  while (cons != NULL){

    if(strcmp(s1, cons->ref) != 0) {

      if(!first) fprintf(FileNet," )\n");

      for( s=NULL, iptr=insts ; iptr != NULL && iptr->ins != NULL ; iptr = iptr->nxt ){

	if( !strcmp(cons->ref, iptr->ins)){

	   s = iptr->sym;

	   break;

	}

      }	

      fprintf(FileNet," ( 84DFBB8F $noname %s %s  {Lib=%s}\n", cons->ref, s, s);

      first=0;

    }

    fprintf(FileNet,"  (%5s %s )\n",cons->pin, cons->nnam);

    strcpy(s1,  cons->ref);

    cons = cons->nxt;

  }

  fprintf(FileNet," )\n)\n");

  fclose(FileEdf);

  fclose(FileNet);

  if( FileNet != stdout )

    fprintf(stderr,"  output is %s \n", FileNameNet);

  fprintf(stderr, " BonJour\n");

  return(0);

}