This is a (partial) re-implementation of ps2client in ruby - intended to form
the non-ps2-side of the testing harness, as well as (eventually) having a
command-line script like the ps2client binary itself.
The reason for making this is mainly that I want one program to be able to
orchestrate the ps2's bootup, ps2link, program-launching and test result
collection. Also, ps2client listen eats a core because the devs didn't add a
sleep or using non-blocking i/o, which is a bit yikes.
Each part of the process will be individually runnable (for debugging purposes, or in case your needs are more complex than mine), so you could use this program for, say, booting up the ps2 to ps2link, so you can run a program via other means. Or running a program assuming ps2link is already booted (could be useful for working with an emulator perhaps?)
The plan is for it to supercede the scripts in [ps2runner][ps2runner] - so ps2client-rb will implement the ps2boot, ps2bootlink and ps2shutdown commands (probably as subcommands), and to implement the server-side of the exit-code protocol to allow propagation of exit codes. The idea is something like this:
$ ps2client execee host:hello-world.elf
Hello world
$ echo $?
0
$ ps2client execee host:hello-world-exit-1.elf
Hello world, this program returns exit code 1.
$ echo $?
1
You will need Ruby 2.7 and LIRC installed, with LIRC configured to act as a ps2 remote.
TODO: put instructions here for configuring LIRC
$ git clone https://github.com/telyn/ps2client-rb.git
$ gem build ps2client
$ gem install *.gem
### Docker
TODO: Dockerfile, docker instructions
TODO: divide into sections, document flags
General concept is to be similar to git - a few 'porcelain' commands, dedicated to providing a nice UI / wrapping up lots of functionality, and a bunch of smaller commands for the nitty-gritty.
(at least) the following will be implemented from ps2client, with completely compatible flags and arguments (though perhaps not output & exit codes):
- execee
- execiop
- listen
- netdump
- scrdump
In addition, the following will be implemented, in a compatible manner with the
scripts from ps2runner:
- boot
- bootlink
- shutdown
And finally, a single command to wrap things up:
- run
- boots the PS2 (into ps2link)
- executes the program on the ps2
- shuts down the PS2 afterwards.
Bug reports and pull requests are welcome on GitHub at https://github.com/telyn/ps2client-rb.
If you fork this repo or otherwise make changes to the code - please do open a PR. Also if you just use this repo for whatever, I'd love to hear what you're doing with it - just open an issue to say hi!
- Secondary stream to receive framebuffer data from a framebuffer-capturing library I intend to write.
The gem is available as open source under the terms of the MIT License.
