skeleton for J2735

examples/README

@@ -25,8 +25,11 @@ This directory contains a few examples.
    Before trying to compile, read the README file in that directory.
 
 8. The ./sample.source.ULP directory contains the Open Mobile Alliance
-   UserPlane Location Protocol decoder. Before trying to compile, read the
-   README file in that directory.
+   UserPlane Location Protocol decoder.
+   Before trying to compile, read the README file in that directory.
+
+9. The ./sample.source.J2735 directory contains the SAE J2735-201603 decoder.
+   Before trying to compile, read the README file in that directory.
 
 The crfc2asn1.pl script can be used to extract ASN.1 data from RFC texts.
 For instance, it is used to extract X.509, MEGACO, and LDAPv3 ASN.1 modules

examples/sample.source.J2735/README

+
+GENERAL INFORMATION
+===================
+
+The SAE J2735-201603 Dedicated Short Range Communications (DSRC)
+Message Set Dictionary decoder.
+Invoking `make` will compile the ASN.1 specifications from the
+../j2735.asn1 file.
+
+THERE IS NO j2735.asn1 FILE THERE YET!
+
+OBTAINING THE J2735 SPECIFICATION
+=================================
+
+Go to http://standards.sae.org/j2735_201603/ and download the files.
+
+You should extract the ASN.1 module from there and save it
+as the ../j2735.asn1 file. The ../j2735.asn1 file should start with
+the following line
+	"DSRC DEFINITIONS AUTOMATIC TAGS ::="
+and end with the "END" token.
+Be careful not to copy any non-ASN.1 preambles from that .DOC file.
+
+After obtaining the j2735.asn1, type `make` in the directory containing
+this README file.
+
+j2735-dump USAGE
+================
+
+The j2735-dump utility may be used to dump the contents of the UPER-encoded
+DSRC message record file:
+
+	./j2735-dump j2735file.per	# Print as XML (BASIC-XER)
+
+The full list of recognized command line options may be obtained with
+
+	> ./j2735-dump -h
+

examples/sample.source.J2735/config.h

+
+extern int opt_debug;
+
+#define	ASN_DEBUG(fmt, args...)	do {		\
+		if(opt_debug < 2) break;	\
+		fprintf(stderr, fmt, ##args);	\
+		fprintf(stderr, " (%s:%d)\n",	\
+			__FILE__, __LINE__);	\
+	} while(0)
+