ASN1VE v1.7 README

This file contains release notes on the ASN1VE 1.7 release.

Contents

Introduction

ASN1VE (ASN.1 Viewer/Editor) is a graphical user interface (GUI) tool for analyzing and editing BER/DER encoded data. It provides the capability to assign an ASN.1 schema to binary data to produce multiple views of the data showing all of the assigned type and element names. It also provides editing capabilities to allow data elements embedded within a message to be modified, added, or deleted.

Release Notes

The major improvement in this release was in large file performance. Extensive work was done to load files faster and consume less memory than previous versions. Files that would take several minutes to load now only take a few seconds.

The other noteworthy improvement was in the asn2xml command-line tool. This tool can now translate PER-encoded messages (both aligned and unaligned) to XML format.

In addition, other minor changes include a modernized look-and-feel, and the capability to load and save to/from hexadecimal text and base64 formats.

For a complete list of recent changes and bug fixes, see the change log .

Documentation

Documentation for this release is available in the ASN1VE help menu. The help HTML document can also be accessed directly from the help subdirectory of the installation. The documentation is also available in HTML format in the doc subdirectory of the installation or online in the ASN1VE-Manual.html and ASN2XML-Manual.html files.

Windows Installation

The steps to install ASN1VE on a Windows system are as follows:

  1. Download the ASN1VE package distribution file.
  2. ASN1VE for Windows is packaged in a self-extracting executable file format. To install, all that should be necessary is to double-click this file after downloading and then following the setup wizard instructions.
  3. The free edition of ASN1VE is now ready. To use the Pro version options, a license file must be installed. This was sent in the osyslic.txt file that was attached to the E-mail message that was sent at the time the product was downloaded. If you did not receive a license file, please contact us.

  4. The osyslic.txt file must be copied to a location where the ASN1VE application can find it. This can be done in one of three ways:
  5.  
    a. The file can be copied into <ASN1VE installation directory>/bin directory, or
     
    b. The file can be copied into any of the directories specified within your PATH environment variable, or
     
    c. The file can be copied to a different directory and an environment variable named OSLICDIR created to point at this directory location.

  6. ASN1VE should now be operational. It should be available from both the desktop and as a start menu item under the group that was selected at installation time (by default, this would be the ASN1C group).

Contents of the Release

The following subdirectories contain the following files (note: <installdir> refers to the installation directory that was specified during the installation process):
<installdir>\bin\asn1ve.exe
The main ASN1VE executable file. This program is invoked to run the ASN1VE graphic interface. If you need to run the program from the command line, it is recommended you modify your PATH environment variable to include \bin to allow the ASN1VE executable to be run from anywhere.

<installdir>\bin\asn2xml.exe
The asn2xml utility program. This command-line program converts an instance of BER-decoded data to XML form using element names from a given ASN.1 schema.

<installdir>\bin\qt-mt333.dll
This runtime library is required for the ASN1VE graphic interface.

<installdir>\doc
This directory contains the help documentation files. The main file is 'help.html'. The asn2xml documentation can be found in the asn2xmlManual.pdf file.

<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'). ASN1VE can be used to view/edit these files by opening a message file (File/Open) and then assigning the schema (ASN.1/Assign ASN.1).
 

Getting Started

Sample messages and their ASN.1 files can be found in the asn1ve/sample directory. The steps to open/edit/save a message are as follows:

  1. Start ASN1VE.
  2. Click on the File > Open Message menu item.
  3. Open the message.dat file in the asn1ve/sample/employee directory.
  4. The message is opened and displayed in generic format.
  5. Click on the ASN.1 > Assign ASN.1  menu item.
  6. Assign the employee.asn file in the asn1ve/sample/employee directory.
  7. ASN1VE automatically finds the main type for the message and decodes it. If ASN1VE is not able to determine the main type, it will display the Select PDU Type dialog where a PDU type can be selected for the message.
  8. You can now edit the message and save as binary/xml/text format.

 

Reporting Problems

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 BER/DER message file and an ASN.1 syntax file (if it exists) 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.