-
Notifications
You must be signed in to change notification settings - Fork 12.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Andrés Martínez
committed
Dec 14, 2022
1 parent
2176e3a
commit 76430c3
Showing
6 changed files
with
172 additions
and
1 deletion.
There are no files selected for viewing
40 changes: 40 additions & 0 deletions
40
compiler/rustc_target/src/spec/armv7_sony_vita_newlibeabihf.rs
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,40 @@ | ||
use crate::abi::Endian; | ||
use crate::spec::{cvs, Cc, LinkerFlavor, Lld, PanicStrategy, RelocModel, Target, TargetOptions}; | ||
|
||
/// A base target for PlayStation Vita devices using the VITASDK toolchain (using newlib). | ||
/// | ||
/// Requires the VITASDK toolchain on the host system. | ||
|
||
pub fn target() -> Target { | ||
let pre_link_args = TargetOptions::link_args(LinkerFlavor::Gnu(Cc::Yes, Lld::No), &["-Wl,-q"]); | ||
|
||
Target { | ||
llvm_target: "armv7a-vita-newlibeabihf".into(), | ||
pointer_width: 32, | ||
data_layout: "e-m:e-p:32:32-Fi8-i64:64-v128:64:128-a:0:32-n32-S64".into(), | ||
arch: "arm".into(), | ||
|
||
options: TargetOptions { | ||
os: "vita".into(), | ||
endian: Endian::Little, | ||
c_int_width: "32".into(), | ||
dynamic_linking: false, | ||
env: "newlib".into(), | ||
vendor: "sony".into(), | ||
abi: "eabihf".into(), | ||
linker_flavor: LinkerFlavor::Gnu(Cc::Yes, Lld::No), | ||
no_default_libraries: false, | ||
cpu: "cortex-a9".into(), | ||
executables: true, | ||
families: cvs!["unix"], | ||
linker: Some("arm-vita-eabi-gcc".into()), | ||
relocation_model: RelocModel::Static, | ||
features: "+v7,+neon".into(), | ||
pre_link_args, | ||
exe_suffix: ".elf".into(), | ||
panic_strategy: PanicStrategy::Abort, | ||
max_atomic_width: Some(32), | ||
..Default::default() | ||
}, | ||
} | ||
} |
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
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
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
127 changes: 127 additions & 0 deletions
127
src/doc/rustc/src/platform-support/armv7-sony-vita-eabihf.md
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,127 @@ | ||
# armv7-sony-vita-eabihf | ||
|
||
**Tier: 3** | ||
|
||
This tier supports the ARM Cortex A9 processor running on a PlayStation Vita console. `armv7-vita-newlibeabihf` aims to have support for `std` crate using `newlib` as a bridge. | ||
|
||
## Designated Developers | ||
|
||
* [@amg98](https://github.com/amg98) | ||
|
||
## Requirements | ||
|
||
This target is cross compiled, and requires installing [VITASDK](https://vitasdk.org/) toolchain on your system. | ||
|
||
## Building | ||
|
||
You can build Rust with support for the target by adding it to the `target` | ||
list in `config.toml`: | ||
|
||
```toml | ||
[build] | ||
build-stage = 1 | ||
target = ["armv7-sony-vita-newlibeabihf"] | ||
``` | ||
|
||
## Cross-compilation | ||
|
||
This target can be cross-compiled from `x86_64` on either Windows, MacOS or Linux systems. Other hosts are not supported for cross-compilation. | ||
|
||
## Testing | ||
|
||
Currently there is no support to run the rustc test suite for this target. | ||
|
||
## Building and Running Rust Programs | ||
|
||
To test your developed rust programs for PlayStation Vita, first you have to prepare a proper executable for the device using the resulting ELF file you get from compilation step. The needed steps can be automated using tools like `cargo-make`. Use the example below as a template for your project: | ||
|
||
```toml | ||
[env] | ||
TITLE = "Rust Hello World" | ||
TITLEID = "RUST00001" | ||
# At least a "sce_sys" folder should be place there for app metadata (title, icons, description...) | ||
# You can find sample assets for that on $VITASDK/share/gcc-arm-vita-eabi/samples/hello_world/sce_sys/ | ||
STATIC_DIR = "static" # Folder where static assets should be placed (sce_sys folder is at $STATIC_DIR/sce_sys) | ||
CARGO_TARGET_DIR = { script = ["echo ${CARGO_TARGET_DIR:=target}"] } | ||
RUST_TARGET_PATH = { script = ["echo $(pwd)"]} | ||
RUST_TARGET = "armv7-sony-vita-newlibeabihf" | ||
CARGO_OUT_DIR = "${CARGO_TARGET_DIR}/${RUST_TARGET}/release" | ||
|
||
[tasks.xbuild] | ||
# This is the command where you get the ELF executable file (e.g. call to cargo build) | ||
|
||
[tasks.strip] | ||
description = "Strip the produced ELF executable." | ||
dependencies = ["xbuild"] | ||
command = "arm-vita-eabi-strip" | ||
args = ["-g", '${CARGO_OUT_DIR}/${CARGO_MAKE_CRATE_FS_NAME}.elf'] | ||
|
||
[tasks.velf] | ||
description = "Build an VELF executable from the obtained ELF file." | ||
dependencies = ["strip"] | ||
command = "vita-elf-create" | ||
args = ['${CARGO_OUT_DIR}/${CARGO_MAKE_CRATE_NAME}.elf', '${CARGO_OUT_DIR}/${CARGO_MAKE_CRATE_NAME}.velf'] | ||
|
||
[tasks.eboot-bin] | ||
description = "Build an `eboot.bin` file from the obtained VELF file." | ||
dependencies = ["velf"] | ||
command = "vita-make-fself" | ||
args = ["-s", '${CARGO_OUT_DIR}/${CARGO_MAKE_CRATE_NAME}.velf', '${CARGO_OUT_DIR}/eboot.bin'] | ||
|
||
[tasks.param-sfo] | ||
description = "Build the `param.sfo` manifest using with given TITLE and TITLEID." | ||
command = "vita-mksfoex" | ||
args = ["-s", 'TITLE_ID=${TITLEID}', '${TITLE}', '${CARGO_OUT_DIR}/param.sfo'] | ||
|
||
[tasks.manifest] | ||
description = "List all static resources into a manifest file." | ||
script = [ | ||
'mkdir -p "${CARGO_OUT_DIR}"', | ||
''' | ||
if [ -d "${STATIC_DIR}" ]; then | ||
find "${STATIC_DIR}" -type f > "${CARGO_OUT_DIR}/MANIFEST" | ||
else | ||
touch "${CARGO_OUT_DIR}/MANIFEST" | ||
fi | ||
''' | ||
] | ||
|
||
[tasks.vpk] | ||
description = "Build a VPK distribution of the project executable and resources." | ||
dependencies = ["eboot-bin", "param-sfo", "manifest"] | ||
script_runner = "@rust" | ||
script = [ | ||
''' | ||
use std::io::BufRead; | ||
use std::fs::File; | ||
fn main() { | ||
let crate_name = env!("CARGO_MAKE_CRATE_NAME"); | ||
let static_dir = env!("STATIC_DIR"); | ||
let out_dir = std::path::PathBuf::from(env!("CARGO_OUT_DIR")); | ||
let mut cmd = ::std::process::Command::new("vita-pack-vpk"); | ||
cmd.arg("-s").arg(out_dir.join("param.sfo")); | ||
cmd.arg("-b").arg(out_dir.join("eboot.bin")); | ||
// Add files from MANIFEST | ||
if let Ok(file) = File::open(out_dir.join("MANIFEST")) { | ||
let mut reader = ::std::io::BufReader::new(file); | ||
let mut lines = reader.lines(); | ||
while let Some(Ok(line)) = lines.next() { | ||
let p1 = ::std::path::PathBuf::from(line); // path on FS | ||
let p2 = p1.strip_prefix(static_dir).unwrap(); // path in VPK | ||
cmd.arg("--add").arg(format!("{}={}", p1.display(), p2.display())); | ||
} | ||
} | ||
cmd.arg(out_dir.join(format!("{}.vpk", crate_name))) | ||
.output() | ||
.expect("command failed."); | ||
} | ||
''' | ||
] | ||
``` | ||
|
||
After running the above script, you should be able to get a *.vpk file in the same folder your *.elf executable resides. Now you can pick it and install it on your own PlayStation Vita using, for example, [VitaShell](https://github.com/TheOfficialFloW/VitaShell/releases) or you can use an emulator. For the time being, the most mature emulator for PlayStation Vita is [Vita3K](https://vita3k.org/), although I personally recommend testing your programs in real hardware, as the emulator is quite experimental. |
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