
DOC 6501_Release V
ATS-6501 Users Guide
25
o
file: Name of the bit code file to download to the specified memory block. If FILE is an
empty string the memory block shall be marked unused and all other option values shall
be ignored. If not specified and the --nofile option is not specified, the bit code file
assigned to the memory block shall remain unchanged. This option may not be specified
with the --nofile option.
o
nofile: Marks the specified memory block as unused and causes all other option values to
be ignored. This option may not be specified with the --file option.
o
format: Data format of the bit code file. If not specified and the --file and --nofile
options are not specified, the format shall remain unchanged. If not specified and the --
file option is specified, the file name extension shall be used to determine the format.
o
bitcount: Number of data bits to download to the specified memory block. If greater
than the number of data bits in the file, the data block shall be padded with zero bits. If
not specified and the --file and --nofile options are not specified, the bit count shall
remain unchanged. If not specified and the --file option is specified, the bit count shall be
set to the number of data bits in the file.
o
SLOT: Slot number of the 4391A output card onto which the bit code file is to be
downloaded. SLOT must be an integer between 1 and 6.
o
BLOCK: Memory block into which the bit code file is to be downloaded. BLOCK must
be an integer between 1 and 4.
Bit Code File Formats
•
Binary Format:
Binary format bit code files shall be treated as an array of data bits.
The data bits shall be ordered from the least significant bit of the first byte in the file to
the most significant bit of the final byte in the file.
•
ASCII Format:
ASCII format bit code files shall be treated as an array of 8-bit
characters. The character ‘0’ (ASCII 48, 0x30) shall be considered a data bit with value
zero. The character ‘1’ (ASCII 49, 0x31) shall be considered a data bit with value one.
All other characters shall be discarded. The data bits shall be ordered from the first byte
in the file to the last byte in the file, with discarded characters excluded. The application
software shall convert the data bits to a binary format before downloading the data to a
4391A output card.
•
Legacy Format:
Legacy format bit code files shall have the format emitted by the
‘tsc2152data’ data conversion program. Bytes 0 - 3 shall contain the magic number
0xdb24bd42 in little endian or big endian format. Bytes 4 - 7 shall contain the number of
bytes in the comment field, interpreted with the same endian format as the 4 bytes of the
magic number field. The data bits shall be ordered from the least significant bit of the
first byte after the comment field to the most significant bit of the final byte in the file.
The file header shall be removed before downloading the data to a 4391A output card.
•
Data Truncation and Padding:
An operator shall have the ability to truncate a
sequence of data bits at any point when downloading the data to a 4391A output card, and