src/doc/rustc/src/platform-support/mipsel-sony-psx.md

   1 # mipsel-sony-psx
   2
   3 **Tier: 3**
   4
   5 Sony PlayStation 1 (psx)
   6
   7 ## Designated Developer
   8
   9 * [@ayrtonm](https://github.com/ayrtonm)
  10
  11 ## Requirements
  12
  13 This target is cross-compiled.
  14 It has no special requirements for the host.
  15
  16 ## Building
  17
  18 The target can be built by enabling it for a `rustc` build:
  19
  20 ```toml
  21 [build]
  22 build-stage = 1
  23 target = ["mipsel-sony-psx"]
  24 ```
  25
  26 ## Cross-compilation
  27
  28 This target can be cross-compiled from any host.
  29
  30 ## Testing
  31
  32 Currently there is no support to run the rustc test suite for this target.
  33
  34 ## Building Rust programs
  35
  36 Since it is Tier 3, rust doesn't ship pre-compiled artifacts for this target.
  37
  38 Just use the `build-std` nightly cargo feature to build the `core` and `alloc` libraries:
  39 ```shell
  40 cargo build -Zbuild-std=core,alloc --target mipsel-sony-psx
  41 ```
  42
  43 The command above generates an ELF. To generate binaries in the PSEXE format that emulators run, you can use [cargo-psx](https://github.com/ayrtonm/psx-sdk-rs#readme):
  44
  45 ```shell
  46 cargo psx build
  47 ```
  48
  49 or use `-Clink-arg=--oformat=binary` to produce a flat binary.