
 				   MC2PARLX.EXE
	
    Adds PARALLAX PIC Device Information to Microchip Assembler Object Files

				   Version 1.0

		 	         By Matt Dralle

				January 31, 1994
			       Livermore CA U.S.A
		         Internet: dralle@matronics.com
			      Voice 1+ 510-447-9886
		     BBS 1+ 510-447-9886, 22 after first ring.
			  FAX 1+ 510-447-9886 autodetect

	Permission to freely distribute this code is hereby granted as
	long as proper credit to the author is noted.							
Definition:

	MC2PARLX.EXE is used with the Microchip PIC assembler.  It allows
	using the PARALLAX Programmer and Downloader (P&D) with the object
	files generated by the Microchip assembler by embedding the 
	required device information into the object file.  Normally, this
	information would not be present in the object data from the Microchip
	assembler and would require that it be entered by hand via the
	menued version of the PARALLAX download software each time
	the object code was loaded into the PARALLAX P&D.  This embedding
	becomes very valuable when the code download is done via a batch 
	process such as a makefile where interactive programs cannot be used.

Purpose:

	The B_LO_C 'C' compiler by Butterfly Signal Processing (416-929-5754)
	generates ASM output that is designed for the Microchip assembler and 
	makes extensive use of the macro capability there in.  This
	functionallity is currently not available with the PARALLAX assembler.
	MC2PARLX.EXE was designed with the intent of using the B_LO_C 'C'
	compiler, the Mircochip assembler, and the PARALLAX Programmer and
	Downloader hardware, with all phases handled by a makefile.

Operation:

	MC2PARLAX.EXE will add device information for the PIC16C54, 55, 56,
	57, 71, and 84 processors.  Any permutation of the following device
	parameters will be handled correctly:

		--> Processor Type
	
		--> Oscillator Type

		--> Watch Dog Timer

		--> Code Protect

	MC2PARLX.EXE will read data from the specified filename, add the 
	indicated device information, then write specified filename back
	out.

	The command line syntax for MC2PARLX.EXE is as follows:

	1)	Processor:	-< 54 | 55 | 56 | 57 | 71 | 84 >

	2)	Oscillator:	-< lp | xt | hs | rc >

	3)	WatchDogTimer:	-wtd = on		(OPTIONAL, default=off)

	4)	Protect:	-protect = on	 	(OPTIONAL, default=off)

	5)	Object File:	-f < filename.ext >	(Must list full name)

	6)	Help:		-h | -help | ?| -? | help | h	

Example:

	prlxinfo -57 -hs -wdt -f iotest.obj

	This would add PARALLAX device information for a PIC16C57 with
	the Highspeed Xtal, and enable the Watch Dog Timer.

