rust-psp 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
rust-psp 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
rust-psp 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 View license
开发语言 C/C++
操作系统 未知
软件类型 开源软件
所属分类 游戏/娱乐
开源组织
地区 不详
投 递 者 首席测试
适用人群 未知
收录时间 2021-12-24

软件简介

rust-psp

A library for building full PSP modules, including both PRX plugins and regular homebrew apps.

#![no_std]
#![no_main]

psp::module!("sample_module", 1, 1);

fn psp_main() {
    psp::enable_home_button();
    psp::dprintln!("Hello PSP from rust!");
}

See examples directory for sample programs.

What about PSPSDK?

This project is a completely new SDK, with no dependency on the original C/C++ PSPSDK. It aims to be a complete replacement, with more efficient implementations of graphics functions, and the addition of missing libraries.

Features / Roadmap

  • core support
  • PSP system library support
  • alloc support
  • panic = "unwind" support
  • Macro-based VFPU assembler
  • Full 3D graphics support (faster than PSPSDK in some cases!)
  • No dependency on PSPSDK / PSPToolchain
  • Reach full parity with user mode support in PSPSDK
  • Port definitions to libc crate
  • Add support for creating kernel mode modules
  • Add std support
  • Automatically sign EBOOT.PBP files to run on unmodified PSPs
  • Implement / reverse undiscovered libraries

Dependencies

To compile for the PSP, you will need a Rust nightly version equal to or later than 2021-05-21 and the rust-src component. Please install Rust using https://rustup.rs/

Use the following if you are new to Rust. (Feel free to set an override manually per-project instead).

$ rustup default nightly && rustup component add rust-src

You also need cargo-psp installed:

$ cargo install cargo-psp

Running Examples

Enter one of the example directories, examples/hello-world for instance, and run cargo psp.

This will create an EBOOT.PBP file under target/mipsel-sony-psp/debug/

Assuming you have a PSP with custom firmware installed, you can simply copy this file into a new directory under PSP/GAME on your memory stick, and it will show up in your XMB menu.

.
└── PSP
    └── GAME
        └── hello-world
            └── EBOOT.PBP

If you do not have a PSP, we recommend using the PPSSPP emulator. Note that graphics code is very sensitive so if you're writing graphics code we recommend developing on real hardware. PPSSPP is more relaxed in some aspects.

Advanced usage: PRXEncrypter

If you don't have a PSP with CFW installed, you can manually sign the PRX using PRXEncrypter, and then re-package it using pack-pbp.

Advanced usage: PSPLink

If you have the PSPSDK installed and have built a working copy PSPLink manually, you can also use psplink and pspsh to run the .prx under target/mipsel-sony-psp/debug/ if you prefer. Refer to the installation and usage guides for those programs.

Debugging

psp-gdb is currently too old to support printing Rust types. rust-lldb may be possible but it has not be experimented with yet.

Usage

To use the psp crate in your own Rust programs, add it to Cargo.toml like any other dependency:

[dependencies]
psp = "x.y.z"

In your main.rs file, you need to setup a basic skeleton like so:

#![no_std]
#![no_main]

// Create a module named "sample_module" with version 1.0
psp::module!("sample_module", 1, 0);

fn psp_main() {
    psp::enable_home_button();
    psp::dprintln!("Hello PSP from rust!");
}

Now you can simply run cargo psp to build your EBOOT.PBP file. You can also invoke cargo psp --release to create a release build.

If you would like to customize your EBOOT with e.g. an icon or new title, you can create a Psp.toml file in the root of your project. Note that all keys are optional:

title = "XMB title"
xmb_icon_png = "path/to/24bit_144x80_image.png"
xmb_background_png = "path/to/24bit_480x272_background.png"
xmb_music_at3 = "path/to/ATRAC3_audio.at3"

More options can be found in the schema defintion here.

Known Bugs

This crate breaks on builds with opt-level=0. Likely due to a bug in EABI interop. cargo-psp patches over this by passing -C opt-level=3.

error[E0460]: found possibly newer version of crate ...

If you get an error like this:

error[E0460]: found possibly newer version of crate `panic_unwind` which `psp` depends on
 --> src/main.rs:4:5
  |
4 | use psp::dprintln;
  |     ^^^
  |
  = note: perhaps that crate needs to be recompiled?

Simply clean your target directory and it will be fixed:

$ cargo clean
展开阅读全文

代码

评论

点击引领话题📣
暂无内容
发表了博客
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
发表了问答
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
0 评论
0 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部
返回顶部
顶部