initial commit

Author: gitlarryf

ChangeLog

@@ -0,0 +1,31 @@
+1.1
+	df1d
+	- Changed acknowledge timeout to be a configurable parameter via
+	the configuration file.
+	- Added support for embedded responses.
+	- Fixed UTF-8 conversion while parsing configuration file.
+	- Fixed memory leaks during XML configuration parsing.
+	
+	lib
+	- Fixed some memory leaks.
+	- Additional command testing.
+	- Fixed various return values for connection management functions.
+	- Added support for string elements.
+	- Added support for status elements.
+	- Added checks for calling functions with NULL connection pointers.
+	- Created more descriptive function return values.
+	- Fixed a slight ACK delay in rare cases where a reply is received
+	before the ACK for the originating command.
+	- More correct reporting of error codes received in replies.
+	- Modified the transaction number initialization so multiple processes
+	sending the same command in quick succession get different tranaction
+	number values.
+	- Added SetTimeout command.
+	- Added SetNAKs command.
+	- Added SetENQs command.
+	- Added ReadModifyWrite command.
+	- Changed various function arguments and structure members to size_t
+	where appropriate.
+	
+1.0
+	- Initial Release

Makefile

@@ -0,0 +1,23 @@
+CC = cc
+CFLAGS = -Wall -O2
+
+all : common
+	cd lib && make
+	cd df1d && make
+
+common : buf.o byteorder.o
+
+buf.o : buf.c common.h
+	$(CC) $(CFLAGS) -c buf.c
+
+byteorder.o : byteorder.c common.h
+	$(CC) $(CFLAGS) -c byteorder.c
+
+install :
+	cd lib && make install
+	cd df1d && make install
+
+clean :
+	rm -f *.o *~
+	cd lib && make clean
+	cd df1d && make clean

README

@@ -0,0 +1,65 @@
+Allen Bradley PCCC protocol library and DF1 link layer service.
+
+
+!!!WARNING!!!
+=============
+These programs are capable of modifying data within programmable logic
+controllers, which can result in equipment damage, personal injury and/or
+loss of life. I assume no responsibility for the use of these programs.
+
+
+
+Requirements
+============
+
+	libxml2(for df1d only): http:\\www.xmlsoft.org
+	doxygen(only for libpccc HTML API docs): http:\\www.doxygen.org
+
+
+Installation
+============
+
+	make
+	become root
+	make install
+
+This will install the libpccc shared library in /usr/local/lib and the df1d
+executable in /usr/local/bin. The pccc.h header file will be installed in
+/usr/local/include. These defaults can be changed by editing the Makefiles
+as desired.
+
+No configuration file is installed for df1d. Modify the example, df1d.cfg.xml,
+and place it where you like.
+
+
+Using libpccc
+=============
+Programs will need to #include <pccc.h> and add -lpccc when linking.
+
+
+
+libpccc documentation
+=====================
+HTML documentation is available for the libpccc API.
+It can be made as follows:
+
+cd lib
+make docs
+
+Point your browser to index.html in the lib/docs directory.
+
+
+
+Starting the DF1 link layer service
+===================================
+df1d <config file>
+
+Running df1d without any configuration file specified will print out detailed
+usage.
+
+
+
+
+Contact information
+===================
+Please report any bugs, comments, suggestions, etc to [email protected].