PS2Client

ATTENTION

If you are confused on how to start developing for PS2, see the getting started section on the ps2dev main page.

PS2CLIENT USAGE AND INFORMATION

THE INTRODUCTION

These programs, ps2client & fsclient, are command line tools used for interacting with a ps2 system running ps2link and/or ps2netfs. It will allow you to send various commands as well as respond to requests for data. This program was written and tested under Linux, Cygwin and Mac OS X but should compile on any reasonably unixlike system.

BUILDING THE CLIENTS

Building and installing is very simple:

make clean; make install

There are some build options, however:

PREFIX=/dir

Install directory, defaults to: $PS2DEV. /bin will be automatically appended. The software will be installed to the /bin sub-directory, under PREFIX (PREFIX/bin).

These options can be used as follows:

make clean; make PREFIX=/new/path/prefix install

BUILDING WINDOWS BINARIES

For building windows binaries on Unix system, you need to setup mingw cross-compiler and win32 threads. Build command:

make -f Makefile.mingw32

BASIC CLIENT USAGE

Basic usage:

ps2client [-h hostname] [-t timeout] [-e marker] <command> [arguments]
fsclient [-h hostname] <command> <arguments>

[-h hostname]

The address of the remote ps2. This can be an IP or a hostname. If none is given, the environment variable $PS2HOSTNAME will be checked for a valid address. If this variable isn't set, a default of 192.168.0.10 will be used.

[-t timeout]

An idle timeout period in seconds that the client will wait before exiting. This is useful to allow a script to continue after calling ps2client to send a command to ps2link or ps2netfs. For ping, it is how long to try (default 2 seconds).

[-e marker]

Exit as soon as a line of console output contains marker. The exit status is the number after status= on that line, or 0 if there is none. A test program can print for example @@END@@ status=1 as its last line, so a script gets the result without waiting for a timeout.

EXIT STATUS

• 0: done (or the idle timeout passed, without -e)
• 64: usage error
• 69: ps2link is not answering
• 74: ps2link closed the connection (reset, reboot or crash of the ps2)
• 75: the console port is in use, probably by another ps2client
• 124: with -e: the idle timeout passed before the marker
• with -e: the status from the marker line

Error messages go to stderr; stdout carries only the console output of the ps2.

PS2LINK COMMANDS

• reset

Send a reset request to ps2link.

• execiop <filename> [arguments]

Tell ps2link to load and execute a file on the IOP.

• execee <filename> [arguments]

Tell ps2link to load and execute a file on the EE.

• poweroff

Send a poweroff request to ps2link.

• scrdump

Tell ps2link to dump exceptions to the screen.

• netdump

Tell ps2link to dump execetions to the network console.

• dumpmem <offset> <size> <filename>

Dump the contents of memory into a file.

• startvu <vu>

Tell the specified vector unit to start operation.

• stopvu <vu>

Tell the specified vector unit to stop operation.

• dumpreg <type> <filename>

Dump the registers of a given type into a file. The type is a number or one of dma, intc, timer, gs, sif, fifo, gif, vif0, vif1, ipu, all, vu0, vu1.

• gsexec <size> <filename>

Tell ps2link to load and send a file to the GS.

• writemem <offset> <size> <filename>

Write the contents of a file into memory.

• iopexcep

I really don't know! OH NOES!!

• listen

Listen to the ps2link network console.

• ping

Check that ps2link is up: ps2link is asked to dump two registers to a host file, which the client discards, so this checks the EE side, the IOP side and the host connection. Exits 0 and prints the round trip time, or exits 69. Note that ps2link serves one host connection, and a new client replaces the old one: do not ping while another client is serving a running program.

Commands that load host files (execee, execiop, ...) do the same check before they send the command, instead of waiting a fixed time.

TESTS

tests/run-tests.sh runs the client against a fake ps2link (tests/fake_ps2link.py) in unprivileged Linux network namespaces, so no ps2 is needed.

Community

Links for discussion and chat are available here.