forked from torvalds/linux
-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
README for the PlayStation 2 Linux kernel
- Loading branch information
Showing
1 changed file
with
98 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,98 @@ | ||
| # PlayStation 2 Linux kernel | ||
|
|
||
| This Linux kernel branch implements the [o32 ABI](https://www.linux-mips.org/wiki/MIPS_ABI_History) for the Sony [PlayStation 2](https://en.wikipedia.org/wiki/PlayStation_2). | ||
|
|
||
| ``` | ||
| # uname -mrs | ||
| Linux 5.4.169+ mips | ||
| # cat /proc/cpuinfo | ||
| system type : Sony PlayStation 2 | ||
| machine : SCPH-37000 L | ||
| processor : 0 | ||
| cpu model : R5900 V3.1 | ||
| BogoMIPS : 291.58 | ||
| wait instruction : no | ||
| microsecond timers : yes | ||
| tlb_entries : 48 | ||
| extra interrupt vector : yes | ||
| hardware watchpoint : no | ||
| isa : mips1 mips3 | ||
| ASEs implemented : toshiba-mmi | ||
| shadow register sets : 1 | ||
| kscratch registers : 0 | ||
| package : 0 | ||
| core : 0 | ||
| VCED exceptions : not available | ||
| VCEI exceptions : not available | ||
| ``` | ||
|
|
||
| ## Building | ||
|
|
||
| A `mipsr5900el-unknown-linux-gnu` target GCC cross-compiler is recommended, with for example the command `make ARCH=mips CROSS_COMPILE=mipsr5900el-unknown-linux-gnu- vmlinux`. A provisional configuration is available in [arch/mips/configs/ps2_defconfig](arch/mips/configs/ps2_defconfig). | ||
|
|
||
| The [wiki](https://github.com/frno7/linux/wiki) includes a guide on [building and installing PlayStation 2 Linux](https://github.com/frno7/linux/wiki/Building-and-installing-PlayStation-2-Linux). | ||
|
|
||
| ## Input/output processor (IOP) modules | ||
|
|
||
| The [input/output processor (IOP)](https://en.wikipedia.org/wiki/PlayStation_2_technical_specifications#I/O_processor) is a [MIPS R3000A](https://en.wikipedia.org/wiki/R3000), or in later PlayStation 2 models a [PowerPC 405GP](https://en.wikipedia.org/wiki/PowerPC_400#PowerPC_405) emulating a MIPS R3000A. This processor provides a number of kernel services, for example handling of USB OHCI interrupts. These are implemented as IOP modules that the kernel loads as firmware. | ||
|
|
||
| This kernel requires the IOP modules provided with the [iopmod](https://github.com/frno7/iopmod) repository, to be installed as kernel firmware. | ||
|
|
||
| See also [#11](https://github.com/frno7/linux/issues/11). | ||
|
|
||
| ## Installing | ||
|
|
||
| This kernel can be started directly from a USB flash drive, using for example uLaunchELF for the PlayStation 2. A special kernel loader is unnecessary. | ||
|
|
||
| See also [#4](https://github.com/frno7/linux/issues/4) and [#7](https://github.com/frno7/linux/issues/7). | ||
|
|
||
| ## Limitations | ||
|
|
||
| This PlayStation 2 Linux kernel is work in progress, and only a minimum of devices for a useful system have been ported to the latest kernel version. A much older version [2.6.35.14 kernel](https://github.com/frno7/linux/tree/ps2-v2.6.35.14) from 2010 supports more devices etc. | ||
|
|
||
| See also [#3](https://github.com/frno7/linux/issues/3), [#5](https://github.com/frno7/linux/issues/5), [#14](https://github.com/frno7/linux/issues/14), [#15](https://github.com/frno7/linux/issues/15), [#16](https://github.com/frno7/linux/issues/16), [#18](https://github.com/frno7/linux/issues/18), [#19](https://github.com/frno7/linux/issues/19), [#21](https://github.com/frno7/linux/issues/21), [#22](https://github.com/frno7/linux/issues/22), [#23](https://github.com/frno7/linux/issues/23), [#24](https://github.com/frno7/linux/issues/24) and [#25](https://github.com/frno7/linux/issues/25). | ||
|
|
||
| ## Graphics | ||
|
|
||
| The [Graphics Synthesizer](https://en.wikipedia.org/wiki/PlayStation_2_technical_specifications#Graphics_processing_unit) device driver supports 1920x1080p (noninterlace), with either an HDMI adapter or component video, as well as common video resolutions such as 720x576p, 720x480p, 640x512i, 640x480i, etc. Console text is accelerated with hardware texturing. | ||
|
|
||
| This kernel implements an early `printk`. The conventional `putc` prints to a serial port, that requires soldering on the PlayStation 2. This `putc` instead prints to a video frame buffer using the Graphics Synthesizer, which at the moment is fixed at the video resolution 1920x1080p for an HDMI adapter or component video. The following three lines are the first ones visible on the screen when the kernel boots: | ||
|
|
||
| ``` | ||
| zimage at: 00803BE0 00BDDE8C | ||
| Uncompressing Linux at load address 80010000 | ||
| Now, booting the kernel... | ||
| ``` | ||
|
|
||
| An experimental [Direct Rendering Manager](https://en.wikipedia.org/wiki/Direct_Rendering_Manager) (DRM) driver for the Graphics Synthesizer is implemented, as this is requirement for [#1](https://github.com/frno7/linux/issues/1). | ||
|
|
||
| See also [#9](https://github.com/frno7/linux/issues/9) and [#10](https://github.com/frno7/linux/issues/10). | ||
|
|
||
| ## USB devices | ||
|
|
||
| USB devices such as keyboards, flash drives, wifi, etc. are supported. However, due to memory limitations in the PlayStation 2 I/O Processor (IOP), some USB device drivers may need to be adjusted to work properly. | ||
|
|
||
| See also [#2](https://github.com/frno7/linux/issues/2) and | ||
| [#17](https://github.com/frno7/linux/issues/17). | ||
|
|
||
| ## Dependencies when compiling PlayStation 2 Linux programs | ||
|
|
||
| GCC 9.1 or later is recommended. Older GCC versions can be used if commit [d728eb9085d8](https://gcc.gnu.org/git/?p=gcc.git;a=commit;h=d728eb9085d8) (MIPS: Default to --with-llsc for the R5900 Linux target as well) is applied. | ||
|
|
||
| Glibc 2.29 or later is recommended. Older Glibc versions can be used if commit [8e3c00db16fc](https://sourceware.org/git/?p=glibc.git;a=commit;h=8e3c00db16fc) (MIPS: Use `.set mips2' to emulate LL/SC for the R5900 too) is applied. | ||
|
|
||
| GAS 2.32 or later is optional. It has the `-mfix-r5900` option to compile generic MIPS II and MIPS III code with the appropriate workaround for the R5900 short-loop hardware bug. | ||
|
|
||
| See also [#8](https://github.com/frno7/linux/issues/8). | ||
|
|
||
| ## PlayStation 2 Linux distributions | ||
|
|
||
| A modern [Gentoo Linux](https://gentoo.org/) can be compiled for the R5900 and the PlayStation 2. The Gentoo [sys-devel/crossdev](https://wiki.gentoo.org/wiki/Crossdev) package page and the [cross build environment guide](https://wiki.gentoo.org/wiki/Cross_build_environment) explain the details involving configuring for example a Gentoo profile and a corresponding overlay. Once those simple steps have been taken the command `# crossdev -s4 -t mipsr5900el-unknown-linux-gnu` can be used to obtain an R5900 cross toolchain as well as the basis of an R5900 Gentoo root filesystem in `/usr/mipsr5900el-unknown-linux-gnu`. As the guide explains, the R5900 base system can be built from scratch using the command `# mipsr5900el-unknown-linux-gnu-emerge -uva --keep-going @system`. The root filesystem can then be used with R5900 QEMU user mode emulation for further compilations and testing, or directly in Linux on PlayStation 2 hardware. | ||
|
|
||
| ## PlayStation 2 Linux emulation | ||
|
|
||
| [R5900 QEMU](https://github.com/frno7/qemu) can be used to emulate programs compiled for PlayStation 2 Linux. | ||
|
|
||
| ## General README | ||
|
|
||
| Read the general [README](README) for further information on the Linux kernel. |