TOP

What's New in ASN-1Step

Applies to: ASN-1Step 10.3

What's New in ASN-1Step 10.3

New Features

ASN-1Step now includes ASN.1 Studio v10.3.

ASN-1Step supports the new command line option, -generateMessages, which can be used to generate multiple random unique or non-unique messages for the specified PDU using one or more sets of encoding rules.

  • The maximum number of generated messages is limited to 10 in the trial version and to 10,000 in the production version of ASN-1Step.
  • By default, ASN-1Step attempts to create files with unique messages. The number of attempts is 10 or the number specified in the third argument of the option. If the specified number of attempts is 0, the output files could include duplicate messages.
  • By default, each message is written to a separate file with a filename prefix derived from the PDU type name and a suffix consisting of an underscore and a number, starting with "1". You can change the location of the output files or a filename prefix by specifying the -putFiles command line option. You can also use the -output option to write all generated messages that are encoded using the same encoding rules to a single file.
  • The new -randomLimits command line option can be used to change pre-defined limits on several ASN.1 type-specific properties used in random value generation for unconstrained ASN.1 types, for example, a range of values for INTEGER types or number of bits, octets, or characters for BIT STRING, OCTET STRING, and unrestricted character string types accordingly.
  • The new -seed command line option can be used to specify your own seed to be used in the random value generator instead of using the current time by default.

ASN-1Step supports the new command line option, -getFiles, which can be used along with the -decodePdu option to obtain a list of input encoding files that are filtered based on the specified filename extension that corresponds to the encoding rules used to create the files. An optional third parameter specifies a non-default format of the input files, such as a text format with hexadecimal or binary digits for files created using binary encoding rules or a special CSV format for CSV files.

  • The new -putFiles option is supported with the -allEncode, -encodeValue, -decodePDU with re-encoding, or -generateMessages options. It specifies the location for the multiple output encoding files, an optional common filename prefix, and an optional number suffix for the first output file, which is increased by '1' for other files. When an input encoding file contains multiple concatenated messages, those messages are re-encoded and written in the same order into the corresponding output file.
  • The -encodeValue command line option can now be used to specify the location from which all .txt files that contain values in value notation format should be encoded.

ASN-1Step now recognizes the new -2021 option. The existing -2015 option is now an alias of the -2021 option. Also, the ASN1.Version compiler directive will now accept '2021' as an argument.

Improvements

ASN-1Step now correctly processes non-parameterized types that include nested references to parameterized types that are

  • not yet defined
  • imported using WITH SUCCESSORS
  • used inside actual parameters with inner subtype constraints in instances of parameterized types.

Previously, warnings or errors in non-relaxed mode about Parameterized<X> not being processed were issued.

ASN-1Step now correctly resolves references to parameterized types that are imported with the WITH SUCCESSORS syntax when an instance of one of them is used as an actual parameter in an instance of the other parameterized type. Previously, an unexpected A0413 message about an undefined parameterized reference was issued.


What's New in ASN-1Step 10.2

New Features

ASN-1Step now includes ASN.1 Studio v10.2.

ASN.1-Step supports the new "extended" CSV header format as one of the parameters passed to the -csv option. The format includes absolute reference names with the following additions:

  • The PDU name prefix is added for all nodes.
  • The * token is used for unnamed components of SET OF and SEQUENCE OF types.
  • The component index, starting with "1", is used for unnamed components of SET, SEQUENCE, and CHOICE types.

Example: asn1step bcas.asn test.ber -decodePdu BBCard -csv extended,dash,bcd

ASN-1Step supports the new command line option, -allCsvMax, which can be used to specify the maximum number of all CSVs to create for a top-level PDU type value that can have multiple components for multiple SET OF and SEQUENCE OF type values for which extra CSVs are created.
Example: asn1step bcas.asn test.ber -decodePdu BBCard -csv dash,10 -allCsvMax 20
Previously, the total number of CSVs was set at the maximum between the user-specified number on the number of CSVs per each SET OF and SEQUENCE OF type and 50, multiplied by 50.

ASN-1Step supports the new -csvSkipEmpty command line option, which can be used to skip CSVs that include only column separators and spaces; that is, CSVs with empty values for all nested simple types.

When OCTET STRING values with OSS.PrintFunctionName directives applied cannot be converted to the specified OSS format, ASN-1Step now includes the original values in hexadecimal format, prefixed with the "???" string, when creating the CSVs. The CSV decoder skips conversion for such values and processes the hexadecimal format as regular OCTET STRING values. For backward compatibility, ASN-1Step supports the new command line option, -csvEmptyOctStrIfFails, which can be used to instruct the CSV encoder to include empty OCTET STRING values with OSS.PrintFunctionName directives if conversion fails.

Improvements

When ASN-1Step is invoked with an input ASN.1 that contains SET or CHOICE types, the order in which the components of those types are processed depends on whether PER-based or canonical encoding rules are needed for a given invocation. The same order is used to create or decode comma-separated values (CSV). Sometimes ASN-1Step could issue an error when an attempt was made to use a sorted order to decode an input CSV that was created using the original non-sorted order. ASN-1Step now uses the original order of components in SET and CHOICE types when decoding from .csv files and no other options that require sorting are specified on the command line. The new command line option, -sortSetChoice, can be used to force the sorting of SET and CHOICE components according to PER-based and canonical encoding rules requirements if other than the original order is used when encoding to CSV or decoding from .csv files.

The -notrace option will no longer print extra tracing information from the PER-based encoder, from CSV conversion, or extra value notations. Note that -notrace does not suppress some ASN-1Step-specific informatory and error messages.


What's New in ASN-1Step 10.1

New Features

ASN-1Step now includes ASN.1 Studio v10.1.

The limit of 50 on the user-specified maximum number of CSVs created for multiple components of each SET OF and SEQUENCE OF type values has been removed in the -csv option. See the following example:
     asn1step bcas.asn test.ber -decodePdu BBCard -csv dash,4000
The total number of additional CSVs for all SET OF and SEQUENCE OF types is limited to the maximum between the user-specified number and 50, multiplied by 50.

Improvements

ASN-1Step now issues a warning when an untagged open type precedes the extension marker in an extensible type in violation of the tag uniqueness requirement (see X.680 clauses 25.7, 52.7.3, 52.7.4, X.681 14.2 b) NOTE 2).

ASN-1Step now correctly considers extensible internal subtype constraints on TIME types as OER-invisible. Previously, such constraints were treated as OER-visible, which could prevent optimized encoding of some TIME types. For example, a value of the following type T was previously encoded using the non-optimized TIME encoding:
     T ::= DATE ("2020-10-10", ...)
It is now encoded using the optimized DATE encoding.


What's New in ASN-1Step 10.0.1

New Features

ASN-1Step now includes ASN.1 Studio v10.0.1.

ASN-1Step now allows you to specify the maximum number of messages to decode and optionally, when possible, to skip the specified number of messages before decoding starts.

When creating and printing ASN.1 types and values, ASN-1Step now supports open types derived from a component relation constraint nested within a contents constraint applied to fields that contain BIT STRING or OCTET STRING types.

When an OSS.PrintFunctionName directive that contains an OSS conversion function specified as a parameter is applied to OCTET STRING types and conversion is possible, the value notation will now include the actual BCD, TBCD, ASCII, IP address, or time stamp values inside an ASN.1 comment, for example:
'0711071136492B0000'H -- 2007-11-07 11:36:49 --

Improvements

ASN-1Step now creates values that can be re-encoded to other encoding rules when the values include inline types and their values inside open type values are derived from component relation constraints.

ASN-1Step will now correctly apply the EXTENSIBILITY IMPLIED option in the module definition by making the following inextensible types defined in the module to be implicitly extensible:

  • All ENUMERATED types
  • SET, SEQUENCE, and CHOICE types whose type definitions match some other type definitions inside other modules that do not have the EXTENSIBILITY IMPLIED option

Previously, the EXTENSIBILITY IMPLIED option did not affect the above types, which could cause incorrectly packed encodings of their values at runtime. The new -allow BadExtensibilityImplied option can be used to restore the old behavior.

ASN-1Step now supports INTEGER types with the OSS.HUGE directive that are constrained to have a limited range of values.

ASN-1Step will now issue an error when governors of an information object set or value set used as actual parameters and the actual parameter of the paramdummy governor included in an instance of a parameterized type are not compatible.

ASN-1Step will now check whether the value of the day component of a TIME type corresponds to the number of days of the specified month. Previously, the runtime checked whether the value exceeded 31. Also, negative values for the year component are now rejected.


What's New in ASN-1Step 9.0

New Features

ASN-1Step now includes ASN.1 Studio v9.0.

ASN-1Step now supports X.680 Amendment 1, which relaxes the IMPORTS clause to allow symbols to be imported from the latest module version, as indicated by the object identifier. The IMPORTS clause can now include WITH SUCCESSORS and WITH DESCENDANTS as the SelectionOption.

The JSON encoders now support an alternative form of encoding values of BIT STRING or OCTET STRING types with contents constraints when an ENCODED BY is absent. When you select this method, the values are encoded as text (the JSON value represents the contained value) rather than hex string.


What's New in ASN-1Step 8.3

New Features

ASN-1Step now includes ASN.1 Studio v8.3.

Support for the Canonical Packed Encoding Rules (ALIGNED and UNALIGNED), as specified by ITU-T Recommendation X.691 (08/2015) | ISO/IEC 8825-2:2015 has been added:

  • The new -cper and -cuper compiler options instruct ASN-1Step to enable support for CPER.
  • For better security, the CPER decoder operates in strict mode: every deviation from the X.691 standard is reported.

Improvements

ASN-1Step will now accept any valid value of GeneralizedTime and UTCTime types and will encode it according to X.690 Clause 11.7 and 11.8. Previously, it was assumed that the input value already satisfied the restrictions imposed on its encoding by these clauses. Therefore

  • All encoders reported an error if the time differential was present in the input value.
  • The DER/CER/COER encoders reported an error if the input value represented as a NULLTERM string did not contain the minutes or seconds component.

The XER and E-XER encoders now encode any valid NULLTERM values of GeneralizedTime and UTCTime types without making additional changes. Previously, when the input value did not contain a minutes or seconds component, the encoders unnecessarily included a zero minutes or seconds component in the encoding and recalculated the fractional part, if any.

The JSON encoders now encode non-special REAL values as JSON numbers. The JSON decoders will accept both encoding forms: JSON number and JSON object encodings. Previously, non-special REAL values could be encoded as JSON objects. For example, an unconstrained REAL type value was encoded as {base10value: N } The decoders reported an error when such values were encoded as JSON numbers.

ASN-1Step no longer skips adding or removing trailing zero bits when PER encoding a bitstring type value that is defined with a "NamedBitList", has a PER-visible constraint applied, and the -noconstraint option is specified. This is in conformamce with X.691 clause 16.3.

ASN-1Step will automatically disable the default -relaxedMode option when the -designerWarnings option is specified.


What's New in ASN-1Step 8.2

New Features

ASN-1Step now includes ASN.1 Studio v8.2.

JSON Encoding Rules support in ASN-1Step now conforms to Draft ITU-T Recommendation X.jsoner.

JSON encodings inside files with the .jer extension are now accepted.

ASN-1Step conforms to the draft version of the JSON encoding rules (X.jsoner document) as regards the encoding of REAL types. Previously, REAL types were encoded according to the OSS Technical Specification for JSON Encoding Rules.

ASN-1Step supports 3GPP CDR files with messages encoded using various encoding rules that are specified inside 3GPP record headers. Currently the BER, Aligned and Unaligned PER, and XER encoding rules are supported.

Improvements

Previously, when the -sampleAsn1Value option was specified, ASN-1Step created invalid sample values that had missing values for non-optional components inside SET or SEQUENCE types with constraints that are not yet supported by sample code generation. Now sample values are created, though they might not satisfy all applied constraints.

ASN-1Step issues an error without attempting to decode when the -decode option is used with an invalid PDU type identifier or a 0-PDU number and the Aligned PER, Unaligned PER, OER, COER, or JSON rules are used. Previously, ASN-1Step attempted to decode messages and relied on the corresponding decoder to issue an error.

Trace data generated when decoding PER Aligned messages now prints a whole number of octets in the "Total encoded length" string. Previously, "Total encoded length" was printed without taking the mandatory padding bits into account. For example, 3.2 was printed instead of 4.0 (or 4).


What's New in ASN-1Step 8.1.1

New Features

ASN-1Step now includes ASN.1 Studio v8.1.1.


What's New in ASN-1Step 8.1

New Features

ASN-1Step now includes ASN.1 Studio v8.1.

ASN-1Step now supports 64-bit precision (19-20 decimal digits) in TIME type fractions.

The PER encoder-decoder implementation now conforms to the recent X.691 corrigendum (2015): an encoding contained in a BIT STRING should be at least one octet for PER ALIGNED and 1 bit for PER UNALIGNED.

OER encoding of untagged CHOICE values is now aligned with Corrigendum 1 of the X.696 standard. Previously, such CHOICE values were encoded BER-style: the outermost tag of the chosen alternative was encoded only once.

Improvements

When OER is used, ASN-1Step now correctly processes ISO 8601 TIME type values with a property settings constraint that specifies "Basic=Date" and "Date=Y", "Date=YM", or "Date=YMD", with no Year settings. Previously, the OER encoder produced a verbose encoding instead of an optimized binary encoding.

ASN-1Step now fully conforms to ITU-T X.680 Clause 46.3c. This clause states that the minutes component of a GeneralizedTime type value can be omitted when the difference between local time and UTC is an integral number of hours. Previously, a false error could be issued when the minutes component was absent.


What's New in ASN-1Step 8.0

New Features

ASN-1Step now includes ASN.1 Studio v8.0.

ASN-1Step now includes support for the 2015 version of the ASN.1 standard.

New command-line options

The following command-line options enable support for the new JSON flags and features:

  • The -json option allows you to specify one or more valid JSON runtime flags to control the way the JSON encodings are created.
  • The -jsonIndent option allows you to specify the indentation size for the JSON encoding generated by ASN-1Step.

For example:

asn1step -json JSON_ENC_ABSENT_COMPONENTS:JSON_ENC_DEFAULT_VALUES jtest.asn -encode value1 -jsonIndent 4

What's New in ASN-1Step 7.4

New Features

ASN-1Step now includes ASN.1 Studio v7.4.

New Command-line Options

OSS runtime flags are now available through the following ASN-1Step options:

-flags <flags>
-encFlags <flags>
-decFlags <flags>

You can specify one or more valid runtime flags separated by commas or colons, immediately after the option. To disable a flag, precede it by an exclamation point ("!").

Use the -csv <flags> command-line option to enable support for Comma-Separated Values (CSV) format when decoding messages.

Improvements

ASN-1Step skips over pad bytes (0x00 or 0xFF) when decoding concatenated BER messages.

When encoding with PER, ASN-1Step no longer encodes components defined with a DEFAULT value when the value to be encoded is the default one (of a simple type, as noted in clause 19.5 of X.691).


What's New in ASN-1Step 7.1

New Features

ASN-1Step now includes ASN.1 Studio v7.1.

Enhanced OER Support

ASN-1Step now supports Octet Encoding Rules (OER) and Canonical Octet Encoding Rules (COER) as defined in "Rec. ITU-T X.696 | ISO/IEC 8825-7", rather than only the subset of ASN.1 types as defined in the "NTCIP 1102:2004 Octet Encoding Rules (OER) Base Protocol" document.
The Octet Encoding Rules (OER), like the Packed Encoding Rules (PER), produce compact encodings by taking advantage of information present in the ASN.1 schema to limit the amount of information included in each encoded message. However, in contrast to PER, OER favors encoding/decoding speed over compactness of the encodings.


What's New in ASN-1Step 7.0

New Features

ASN-1Step now includes ASN.1 Studio v7.0.

New Command-line Options

Use the new -allSampleAsn1Values and -sampleAsn1Value options to create files that contain sample messages for PDU types in the ASN.1 input that are in ASN.1 value notation format.

Improvements

Command-line Utility
  • The -listPduIds option now accepts the optional true argument which, when specified, instructs ASN-1Step to limit the number of printed PDU identifiers available for decoding to unreferenced PDU types and to types marked with PDU directives.
  • Error messages and warnings issued now have the same format as error messages issued by other OSS ASN.1 Tools components. Note that ASN-1Step messages used as headers or as part of a trace may still start with the "ASN1STEP" prefix to visually separate output from different operations.

This documentation applies to release 10.3 and later of ASN-1Step®.

Copyright © 2022 OSS Nokalva, Inc. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording or otherwise, without the prior permission of OSS Nokalva, Inc.
Every distributed copy of ASN-1Step is associated with a specific license and related unique license number. That license determines, among other things, what functions of ASN-1Step are available to you.