|
DataMuseum.dkPresents historical artifacts from the history of: Rational R1000/400 DFS Tapes |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Rational R1000/400 DFS Tapes Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - metrics - download
Length: 17408 (0x4400)
Types: HLP, TextFile
Names: »NETX.HLP«
└─⟦b4205821b⟧ Bits:30000743 8mm tape, Rational 1000, DFS, D_12_7_3 SEQ288
└─⟦this⟧ »NETX.HLP«
└─⟦b434774df⟧ Bits:30000528 8mm tape, Rational 1000, DFS, D_12_6_5
└─⟦this⟧ »NETX.HLP«
└─⟦bc1274df5⟧ Bits:30000750 8mm tape, Rational 1000, DFS backup from PAM's R1000
└─⟦this⟧ »NETX.HLP«
This program is used to test the ENP100 ethernet controller from CMC.
This program will use the DFS file TCP_IP_HOST_ID if it exists to
determine the IP address of this machine. Ensure that it is the
correct value since if it matches another machine on the network, things
will go sour on that other machine as soon as this one is downloaded.
The file should contain a single line with this machine's ip address
in decimal dotted notation e.g. 89.64.5.65 .
NETX contains a few commands to test the hardware and many commands that
are used to do iop firmware regression testing. Commands that are used for
hardware testing are:
* POUND
* TEST_ALL
* TEST_RAM
* CP_CLIENT
* CP_SEVER
COMMAND = ACCEPT_TCP
Used to do sc_acpt to 'complete' a connection.
Requires the CHANNEL that is connected to be specified and the
PORT number to be listening on for the 'new' open buffer.
applicable switches = CHANNEL, PORT
COMMAND = ASSERT_RST
Used to assert VME reset by the VMEGEN and leave it asserted.
Used to bind a raw ethernet channel.
applicable switches = COUNT, RAM_BASE, SA, VID
COMMAND = BIND_ETH
Used to bind a raw ethernet channel.
The channel is bound to the remote ethernet address for configuration
testing protocol.
applicable switches = CHANNEL, EPA
COMMAND = BIND_TCP
Used to bind a TCP channel.
The channel is bound to the specified port. Use SHOW_CHANNEL to see
addresses.
applicable switches = CHANNEL, PORT
COMMAND = BIND_UDP
Used to bind a udp channel.
The channel is bound to port = channel. Use SHOW_CHANNEL to see
addresses.
applicable switches = CHANNEL
COMMAND = CLOSE
Used to close a TCP cchannel.
applicable switches = CHANNEL
COMMAND = COMPARE
Used to compare the most current response with RESPONSE and MASK
data.
COMMAND = CONFIGURE
Used to send configure request to controller. See source for
channel and tx buffer configurations.
(0,0,0,0,0)
COMMAND = CONNECT_TCP
Used to do an active open to a channel.
CHANNEL specifies the active channel number, PORT specifies the
port numner to connect to (who is doing the passive open).
applicable switches = CHANNEL, PORT
COMMAND = CP_CLIENT
Used to invoke the ethernet configuration testing protocol client
function. The CP_CLIENT runs one pass and reports the addresses of
all echoed packets. It can be invoked simply by entering
"cp_client <return>" at the NETX> prompt in which case the program
will prompt the user for the IP address of this machine and will
download the default ENP100 firmware. One may also invoke it like
"cp_client/ip=89.3.4.5 <return>" or
"cp_client/filename=enpcode_2_6.s/ip=89.64.7.11 <return>"
After downloading and starting the enp controller, the program
will prompt the user for physical ethernet address of server.
One can use a specific address or the broadcast address. The program
sends one packet then 'listens' for responses and announces the
physical ethernet address of responders.
The rational server is available at
!tools.networking.debug.configuration_testing.client
applicable switches = FILENAME, IP, EPA
COMMAND = CP_SERVER
Used to invoke the ethernet configuration testing protocol server
function. The CP_SERVER runs until the user exits.
It can be invoked simply by entering
"cp_server <return>" at the NETX> prompt in which case the program
will prompt the user for the IP address of this machine and will
download the default ENP100 firmware. One may also invoke it like
"cp_server/ip=89.3.4.5 <return>" or
"cp_server/filename=enpcode_2_6.s/ip=89.64.7.11 <return>"
After downloading and starting the enp controller, the program
will announce the physical ethernet address of the enp controller
(in hex and decimal notations) and will idle waiting for
configuration testing packets to arrive and be forwarded. The user
should note the ethernet address and invoke a client to send a
packet to this machine. The rational client is available at
!tools.networking.debug.configuration_testing.client
applicable switches = FILENAME, IP
COMMAND = DEBUG
Used to set the debugging level via a single character switch
where [V = verbose debugging,
D = debugging,
I = information,
N = normal,
P = panic]
COMMAND = DOWNLOAD
Used to download an 'S_RECORD' file to the controller.
applicable switches = CONSOLE, FILENAME, RAM_BASE, SA, VID
COMMAND = DUMP_ENP_RAM
Queries for address (in hex) and word count (in decimal). The address
should be the 'VME SLAVE' address of the board.
E.g. 'dump_enp_ram/sa=1220/long/count=4' to see the ring pointers
applicable switches = COUNT, RAM_BASE, SA, VID
COMMAND = DUMP_IOP_RAM
Queries for address (in hex) count and display data size.
applicable switches = ASCII, BYTE, COUNT, LONG, SA, WORD
COMMAND = FILL_HUGE
This is used to fill the huge (0 .. 3071] byte buffer for large
tcp transfers. Filling starts at location specified by SA
and COUNT copies of the DATA are entered. The size of the huge
buffer is variable and is determined by the last byte entered.
one can enter multiple slices as long as the last is the highest.
applicable switches = COUNT, DATA, SA
COMMAND = FIX_SERIAL
Compares the real ENP100 board serial number to RESHA's notion of it
and updates the RESHA version if necessary (and possible).
Comparison will fail if called before DOWNLOAD and CONFIGURE.
Update will fail if EEPROM is write-locked.
ONLY VALID FOR SERIES 400, KERNEL VERSION 4_2_5 OR LATER:
OTHER SYSTEMS WILL CRASH IF THIS COMMAND IS CALLED.
COMMAND = GET_ETH_CHANNEL
Used to get a channel id from the raw ethernet group.
applicable switches = RESUME
COMMAND = GET_UDP_CHANNEL
Used to get a channel id from the udp group.
applicable switches = RESUME
COMMAND = GET_TCP_CHANNEL
Used to get a channel id from the tcp group.
applicable switches = RESUME
COMMAND = LP_CP_CLIENT
Like CP_CLIENT but loops for a user supplied iterations. Like
CP_CLIENT, it is possible for a busy server to ignore the
echo requests of the client. The test reports if any packets
are lost and will stop if there are any data compare errors.
For each iteration of the loop, the clock and power margins
are changed so all combinations of clock and power margins are
tested. If one uses the NO_MARGIN switch, the margins are not touched
so one could use FRU to set a particular margin set then use
LP_CP_CLIENT to test at that margin alone.
applicable switches = NO_MARGIN
COMMAND = LP_RAM_RD
Queries for location and loops a read. Reports data value if it
should change. Forces the first report.
applicable switches = RAM_BASE, VID
COMMAND = LP_RAM_WRT
Queries for location and loops a write of 16#1234.
applicable switches = RAM_BASE, VID
COMMAND = HARD_RST
Used to reset the board by asserting then negating the VME
SYSRESET line. Monitors SYSFAIL to verify it gets asserted then
negated.
applicable switches = RAM_BASE, VID
COMMAND = MASK
Sets the 16 byte EXPECTED_RESPONSE_MASK variable.
applicable switches = DATA
COMMAND = OPEN_ETH
Does an active open on a raw ethernet channel to put the channel
in the connected state.
applicable switches = CHANNEL, EPA
COMMAND = PO_TCP
Brings up a passive open on the specified channel listening on the
specified port.
applicable switches = CHANNEL, PORT, HOLD
COMMAND = POUND
This chains together all tests and loops forever. It runs at all
settings of clock and power.
applicable switches = RAM_BASE, VID
COMMAND = RECEIVE
Requires a channel to be specified and establishes a single credit
for the channel.
applicable switches = CHANNEL, CREDITS, TDB_COUNT
COMMAND = RECEIVE_CP
Receives a configuration testing protocol packet.
applicable switches = CHANNEL
COMMAND = READ_256
Reads a 256 byte block from enp base (E00000). Loops until stopped.
applicable switches = RAM_BASE, VID
COMMAND = RESPONSE
Sets the 16 byte EXPECTED_RESPONSE variable.
applicable switches = DATA
COMMAND = RESERVE_ETH
Reserves the specified raw ethernet channel.
applicable switches = CHANNEL
COMMAND = RESERVE_TCP
Reserves the specified TCP channel.
applicable switches = CHANNEL
COMMAND = RESERVE_UDP
Reserves the specified UDP channel.
applicable switches = CHANNEL
COMMAND = R1K_RAM_TEST
Uses the R1K interface to the ENP100 driver to check out reset, read
and write commands to the controller. Various boundary conditions
are checked. This is intended to be used for regression testing of
the driver firmware.
applicable switches = RAM_BASE, VID
COMMAND = R1K_RESET
This uses the normal ENP100 driver functions to reset the controller.
COMMAND = SET_RAM
Used to specify the base address of the RAM space on the ENP100
board. Will query for the base address if not specified.
applicable switches = RAM_BASE
COMMAND = SET_VMEGEN
Used to specify the ID of the VMEGEN board. Will query for the VMEGEN
ID if not specified.
applicable switches = VID
COMMAND = SHOW_ADDRS
Used to display addresses of VMEGEN registers and SPACES on
the ENP100 board. If VID or RAM_BASE switches are specified, the
new address settings are applied before being displayed.
applicable switches = RAM_BASE, VID
COMMAND = SHOW_CHANNEL
Used to display the IOP and ENP channel state. Requires the decimal
channel number.
applicable switches = CHANNEL
COMMAND = SHOW_EPA
Used to display the ethernet address of the board. Should only be
called after DOWNLOAD and CONFIGURE else the results may be
erroneous.
COMMAND = TEST_ALL
This chains together all tests.
applicable switches = RAM_BASE, VID
COMMAND = TEST_RAM
Used to test out the entire (almost) ram space. The reserved
portions of ram at the base of the space on the ENP100 and at the top
of useable ram as well as the interrupt and reset mailboxes on the
ENP100 are also not tested. This tests ram based on the RAM_BASE
address so be sure that the RAM_BASE is properly set. The RAM_BASE
should be 0 for HAWK and E00000 for ENP100.
applicable switches = RAM_BASE, VID
COMMAND = TERMINATE
Ends the program gracefully.
COMMAND = TRANSMIT_UDP
Used to transmit a udp ethernet packet. Requires channel number and
data and port number.
applicable switches = CHANNEL, DATA, PORT
COMMAND = TRANSMIT_TCP
Used to transmit TCP data. Requires channel number and data.
applicable switches = CHANNEL, DATA
COMMAND = TX_FULL_TCP
Used to send a full TCP page (1K byte) of data where the data is
0000 0001 0002 0003 0004 ... 01FF
applicable switches = CHANNEL
COMMAND = TX_HUGE_ETH
Used to send the HUGE ETH data previously filled with FILL_HUGE
commands. The FFO switch is used to send the FIRST_FRAGMENT_ONLY
for diagnostic testing.
applicable switches = CHANNEL, FFO, RESUME
COMMAND = TX_HUGE_TCP
Used to send the HUGE TCP page previously filled with FILL_HUGE
commands. The FFO switch is used to send the FIRST_FRAGMENT_ONLY
for diagnostic testing.
applicable switches = CHANNEL, FFO, RESUME
COMMAND = WRITE_RAM
Writes a single enp ram word. prompts the user for the address and
data. Uses ENP based ram address e.g. E01000, not 1000.
COMMAND = WRITE_256
Writes a 256 byte block to enp base (E00000). Loops until stopped.
applicable switches = RAM_BASE, VID
-----------------------------------------------------------------------------
SWITCH = ASCII
Specifies byte character quanta size.
SWITCH = BYTE
Specifies byte quanta size.
SWITCH = COUNT=D
Specifies a decimal count.
SWITCH = CHANNEL=D
Specifies a decimal channel number. Currently (0 .. 63).
SWITCH = CONSOLE
Specifies that the console flag bit in SHARED_INITIALIZATION_BLOCK
should be set to enable the CMC console port.
SWITCH = CREDITS=DDD
Specifies a decimal number of credits to be set for the channel
0 .. 127.
SWITCH = DATA=00112233445566778899AABBCCDDEEFF
Specifies 16 byte value for response mask and response data
variables. Can also be used with verify to specify a single
byte of data and with transmits to specify payload data.
SWITCH = EPA=11-22-EF-D3-44-AA
Specifies a remote ethernet physical address. Expects hex nibble
pairs.
SWITCH = FFO
The first fragment only switch is used by TX_HUGE to send the first
part only of a large buffer for diagnostic testing.
SWITCH = FILENAME=FOOBAR.S
Specifies the name of an 'S record' format file to be downloaded
to the controller.
SWITCH = HOLD
Specifies that the IOP does NOT enter the command on the H_TONET
ring.
SWITCH = IP
Specifies IP address in dotted notation e.g. IP=1.2.4.3
SWITCH = LONG
Specifies long word (32 bits) quanta size.
SWITCH = NO_MARGIN
Supresses auto margining of the IOP when running LP_CP_CLIENT.
SWITCH = PORT
Specifies UDP port to send data to.
SWITCH = RAM_BASE=H startup default = E00000
Specifies the base address of the shared ram on the ENP100 board
where 'H' is the base address specified in hex. For example
/RAM_BASE=E00000 -- standard address for board.
SWITCH = RESUME
Specifies that the 'resume' flag be set in the corresponding
command.
SWITCH = SA=H
Specifies starting address in hex. For example
/SA=E00000 -- standard address for board. Can also be used with
verify to specify the compare offset in the received data page.
SWITCH = TDB_COUNT=DDD
Specifies the type dependent count to be sent in a receive command.
Usage is TDB_COUNT=DDD where DDD is a decimal count 0 .. 255.
SWITCH = VID=D startup default = 1
Specifies the ID of the VMEGEN board where 0 <= D <= 6.
SWITCH = WORD
Specifies word (16 bits) quanta size.
-----------------------------------------------------------------------------
COMMANDS ACCEPT_TCP, ASSERT_RST, BIND_ETH, BIND_UDP, CLOSE, COMPARE,
CONFIGURE, CONNECT_TCP, CP_CLIENT, CP_SERVER, DEBUG, DOWNLOAD,
DUMP_ENP_RAM, FILL_HUGE, GET_ETH_CHAN, GET_UDP_CHAN, GET_TCP_CHAN,
HARD_RST, LP_CP_CLIENT, LP_RAM_RD, LP_RAM_WRT, MASK, OPEN_ETH, POUND,
READ_256, RECEIVE, RESERVE_ETH, RESERVE_UDP, RESPONSE, R1K_RAM_TEST,
R1K_RESET, SET_RAM, SET_VMEGEN, SHOW_ADDRS, SHOW_CHANNEL, SHOW_EPA,
TEST_ALL, TEST_RAM, TERMINATE, TRANSMIT_TCP, TRANSMIT_UDP,
TX_FULL_TCP, TX_HUGE_TCP, WRITE_RAM, WRITE_256
SWITCHES ASCII, BYTE, CHANNEL, CONSOLE, COUNT, CREDITS, D, DATA, EPA, FFO,
FILENAME, HOLD, I, IP, LONG, N, NO_MARGIN, P, PORT, RESUME,
RAM_BASE=H, SA=H, TDB_COUNT, V, VID=D, WORD
«nul»