This file contains release notes on the ASN2TXT 3.2 release.
ASN2TXT (ASN.1 to text translator) is a dynamically-linked library (DLL) and accompanying command-line and GUI program that are used to translate data encoded using various ASN.1 encoding rules (BER/CER/DER, PER/UPER, XER/XML, and JSON/JER) to various output formats. Output formats could either be ASN.1-encoded data or textual XML, JSON, or Comma-Separated-Value (CSV).
Users are encouraged to consult the documentation in the
docsubdirectory for information regarding the transformation of input files into output binary and textual formats.Up to date change log information is made available on our website.
New features appearing in the 3.2 release of ASN2TXT include the following:
- A new "-stdin" option that reads text data from STDIN rather than a message file. Also allowed for binary data to be written to STDOUT.
- A new "-strict-charval" option that causes ASN2TXT to validate ASN.1 character string types.
- The ASN2TXT GUI application has been updated to use Qt version 5.14.
- New ASN2TXT project (.atproj) files are now created as XML readable files rather than binary files. Older binary project files will be converted to XML upon saving as well.
- General stability and bug fixes.
Documentation for this release is provided in the doc
subdirectory of the installation.
ASN2TXT for UNIX/Linux is packaged as a gzipped .tar archive file. This distribution file can be unpacked in any directory on the target system by executing the following commands:
- gunzip asn2txt<version><platform>.tar.gz
- tar xf asn2txt<version><platform>.tar
- rm asn2txt<version><platform>.tar
An osyslic.txt license is necessary to enable the product to run. This should have been sent as an attachment in an E-mail message or should be available on the user's product download web page. Copy this file into the 'bin' subdirectory of the asn2txt installation.
ASN2TXT should now be operational. Refer to the ASN2TXT User's Guide document in the doc subdirectory for instructions on how to run the program.
The following subdirectories contain the following files (note: <installdir> refers to the installation directory that was specified during the installation process):
- <installdir>/bin/asn2txt
- The asn2txt command-line program executable file.
- <installdir>/bin/libasn2txt.so
- The asn2txt shared object library file. This may be linked into a user's application program to access the functions in the shared object.
- <installdir>/bin/asn2txtgui
- (Unavailable for 32-bit Linux) Simple GUI wizard that uses the DLL and allows parameters to be specified through a GUI interface rather than on the command-line.
- <installdir>/doc
- This directory contains the ASN2TXT User's Guide file asn2txt.pdf file as well as HTML-based information on the ASN2TXT shared object library.
- <installdir>/asn1specs
- This directory contains a collection of common ASN.1 specification files from existing standards that have been used with the tool.
- <installdir>/python
- This directory contains the Python wrapper file which provides access to the DLL, as well as a sample Python program showing how to use the wrapper.
- <installdir>/sample
- This directory contains sample programs containing encoded BER/DER message files (these files have a '.dat' or '.bin' extension) and corresponding ASN.1 schema files (these have extension '.asn'). ASN2TXT can be used to translate these files to text formats. A perl script (asn2txt.pl) is provided to test the translation of all files to text formats.
- <installdir>/sample_per
- This directory contains sample data containing PER message files and corresponding ASN.1 schema files. ASN2TXT can be used to translate these files to XML. A Perl script is provided for this purpose.
- <installdir>/sample_dll
- This directory contains sample data showing how to use various functions of the DLL, including those related to DOM support.
Report problems you encounter by sending E-mail to support@obj-sys.com. The preferred format of example programs is the same as the sample programs. Please provide a message file and an ASN.1 syntax file and also indicate where the problem occurs.
If you have any further questions or comments on what you would like to see in the product or what is difficult to use or understand, please communicate them to us. Your feedback is important to us.