NAME

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

SYNTAX

        perl atdf2_to_stdf4.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.
        ARGUMENTS
                AtdfFileSpec
                        The input ATDF file specification.
                StdfFileSpec
                        The output STDF 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 atdf2_to_stdf4.pl -a
        perl atdf2_to_stdf4.pl --about
                Displays information about the program.
        perl atdf2_to_stdf4.pl -h
        perl atdf2_to_stdf4.pl --help
                Displays the help for the program.
        perl atdf2_to_stdf4.pl AtdfFileSpec StdfFileSpec
                Converts the ATDF file specified by AtdfFileSpec to the STDF
                file specified by StdfFileSpec.
        perl atdf2_to_stdf4.pl -l AtdfFileSpec StdfFileSpec
        perl atdf2_to_stdf4.pl --log AtdfFileSpec StdfFileSpec
                Converts the ATDF file specified by AtdfFileSpec to the STDF
                file specified by StdfFileSpec and outputs log information
                to standard output.
        perl atdf2_to_stdf4.pl -d AtdfFileSpec StdfFileSpec
        perl atdf2_to_stdf4.pl --debug AtdfFileSpec StdfFileSpec
                Converts the ATDF file specified by AtdfFileSpec to the STDF
                file specified by StdfFileSpec and outputs debug information
                to standard output.
        perl atdf2_to_stdf4.pl -l -d AtdfFileSpec StdfFileSpec
        perl atdf2_to_stdf4.pl --log --debug AtdfFileSpec StdfFileSpec
                Converts the ATDF file specified by AtdfFileSpec to the STDF
                file specified by StdfFileSpec 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 ATDF Version 2 file to an STDF Version 4 file.

ASCII (ATDF) TO BINARY (STDF) CONVERSION

This program implements the ASCII to BINARY 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.

SUPPORTED PLATFORMS

• Unix

• Windows.

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.

AUTHOR

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

• None.

HISTORY

1.0.0 (200501011408) Michael Hackerott

• Created program.

1.0.1 (200402080725) Michael Hackerott

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

1.0.2 (200402131512) Michael Hackerott

• Changed ATDF read logic to improve performance.

1.0.3 (200512030625) Michael Hackerott

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

1.0.4 (200512030659) Michael Hackerott

• Updated documentation.

• Fixed dbugEnabled() logic.