NAME

stdf4_to_atdf2.pl - Converts an STDF version 4 file to an ATDF version 2 file

SYNTAX

        perl stdf4_to_atdf2.pl [OPTIONS] ARGUMENTS
        OPTIONS
                -a, --about
                        Displays information about this program.
                -d, --debug
                        Enables debug mode which outputs debug information to
                        standard output.
                -h, --help
                        Displays help for this program.
                -l, --log
                        Enables log mode which outputs log information to
                        standard output.
                -w, --wrap
                        Enables wrap mode which outputs the ATDF records as a
                        maximum of 80 characters per file line.  Continuation
                        lines begin with a space character. For example:
                        00000000011111111112222222222333333333344444444445555555555666666666677777777778
                        12345678901234567890123456789012345678901234567890123456789012345678901234567890
                        MIR:char_dig_highv_0C|   MATRIX_MODE|char_ad1843_a580|joe_t|A585|
                         10:09:41 12-Sep-1995|11:46:14 12-Sep-1995|kan|E|1|1||||IMAGE V5.7 D1 081795||||
        ARGUMENTS
                StdfFileSpec
                        The input STDF file specification.
                AtdfFileSpec
                        The output ATDF file specification.
        RETURNS
                The program returns a value of unix true (0) if no errors
                occur; otherwise, a value of unix false (1) is returned.
        STANDARD INPUT
                Standard input is ignored.
        STANDARD OUTPUT
                There is no output to standard output unless the log (-l, --log)
                or debug (-d, --debug) options are specified.
        STANDARD ERROR
                If an error occurs then a message is output to standard error.

SYNOPSIS

        perl stdf4_to_atdf2.pl -a
        perl stdf4_to_atdf2.pl --about
                Displays information about the program.
        perl stdf4_to_atdf2.pl -h
        perl stdf4_to_atdf2.pl --help
                Displays the help for the program.
        perl stdf4_to_atdf2.pl StdfFileSpec AtdfFileSpec
                Converts the STDF file specified by StdfFileSpec to the ATDF
                file specified by AtdfFileSpec.
        perl stdf4_to_atdf2.pl -l StdfFileSpec AtdfFileSpec
        perl stdf4_to_atdf2.pl --log StdfFileSpec AtdfFileSpec
                Converts the STDF file specified by StdfFileSpec to the ATDF
                file specified by AtdfFileSpec and outputs log information
                to standard output.
        perl stdf4_to_atdf2.pl -d StdfFileSpec AtdfFileSpec
        perl stdf4_to_atdf2.pl --debug StdfFileSpec AtdfFileSpec
                Converts the STDF file specified by StdfFileSpec to the ATDF
                file specified by AtdfFileSpec and outputs debug information
                to standard output.
        perl stdf4_to_atdf2.pl -l -d StdfFileSpec AtdfFileSpec
        perl stdf4_to_atdf2.pl --log --debug StdfFileSpec AtdfFileSpec
                Converts the STDF file specified by StdfFileSpec to the ATDF
                file specified by AtdfFileSpec and outputs log and debug
                information to standard output.
        NOTE: Use command line redirection to capture standard
        output to a file.

DESCRIPTION

This program converts an STDF Version 4 file to an ATDF Version 2 file.

BINARY (STDF) TO ASCII (ATDF) CONVERSION

This program implements the BINARY to ASCII conversion as defined in the Teradyne ATDF and STDF specifications. However, the operating system and the Perl that this program executes on determines the actual binary values.

REQUIRES

• Perl 5.6 or newer.

• Perl core module strict.

• Perl custom module TDF.pm.

SEE ALSO

• perl core and module documentation.

• STDF Specification V4 published by Teradyne, Inc.

• ATDF Specification V2 published by Teradyne, Inc.

AUTHORS

• Michael Hackerott, michael.hackerott@mrhackerott.org

COPYRIGHT

Copyright © 2004-2005 Michael Hackerott. All rights reserved.

This program is free software; you can redistribute it and/r modify it under the terms of either the GNU General Public License or the Artistic License as specified in the Perl README file.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

ACKNOWLEDGEMENT

The Standard Test Data Format (STDF) and ASCII Test Data Format (ATDF) specifications are the original works of Teradyne Inc.

KNOWN BUGS

• Does not write an ATR record to the ATDF file.

• GDR handler is not working and has been disabled.

• PLR handler is not working and has been disabled.

HISTORY

1.0.0 (200412240425) Michael Hackerott

• Created program.

1.0.1 (200402080725) Michael Hackerott

• Moved about() subroutine to TDF.pm module.

• Added help() subroutine.

1.1.0 (200512012020) Michael Hackerott

• Fixed endian logic.

1.1.1 (200512030625) Michael Hackerott

• Added BEGIN block to add lib and ../lib to @INC.

1.1.2 (200512030659) Michael Hackerott

• Updated documentation.

• Fixed dbugEnabled() logic.