Disponibile un nuovo aggiornamento per la toolchain OpenOrbis, la raccolta di strumenti open source dedicato allo sviluppo di applicazioni homebrew su console PlayStation 4 e PlayStation 4 Pro jailbroken.

Questa nuova versione aggiunge il supporto per le eccezioni C++ e per la creazione di librerie/PRX. Sono stati inoltre aggiunti e aggiornati prototipi/tipi per oltre 13 intestazioni specifiche per console PS4.

Roadmap

Nei prossimi aggiornamenti è prevista l’aggiunta di quanto segue:

• v0.6 – Strumenti di debug (debugger, integrazione VS).
• v0.7 – Finalizzare il supporto per il rendering GPU.
• v1.0 – Rilascio stabile che funziona senza problemi e ha le discrepanze di intestazione per lo più risolte.

Documentazione

La documentazione specifica per lo strumento può essere trovata insieme al codice sorgente. La sottodirectory docs contiene anche materiali e documentazione aggiuntivi. Di seguito è riportata una panoramica dello scopo di ciascuna sottodirectory:

Directory	Contenuti
/bin	Eseguibili per strumenti per ogni piattaforma (Windows in /bin/windows, Linux in /bin/linux e macOS in /bin/macos)
/docs	Documentazione per le specifiche del formato PS4 (reverse engineering) e la toolchain stessa.
/extra	File extra/varie. Attualmente, questo include i modelli di progetto per Visual Studio.
/include	Contiene intestazioni specifiche per PS4 + EGL/GLES e freetype.
/lib	Segnaposto per i file di libreria creati.
/samples	Programmi di esempio per iniziare e per riferimento.
/scripts	Script utili per visualizzare le informazioni Orbis ELF (OELF) e altri vari strumenti.
/src	Contiene il codice sorgente per CRT, moduli e modelli VS.

Setup e installazione

La toolchain clang e il linker llvm (lld) sono necessari per compilare e collegare utilizzando questo SDK. Per Windows, questi possono essere scaricati utilizzando i file binari predefiniti forniti da LLVM. Per Linux e macOS, la stessa pagina contiene file binari predefiniti, tuttavia è anche possibile usare i seguenti comandi (Debian/Ubuntu):

sudo apt-get update
sudo apt-get install clang
sudo apt-get install lld

Nel caso in cui si utilizzi un derivato Arch:

sudo pacman -S clang
sudo pacman -S lld

Gli utenti macOS possono utilizzare Homebrew per installare una copia pura di LLVM (la versione Apple non funzionerebbe con la toolchain).

brew install llvm

In futuro, potremmo includere binari predefiniti per clang/lld, tuttavia per il momento è necessario installarli separatamente, è inoltre necessario impostare la variabile di ambiente OO_PS4_TOOLCHAIN.

Su Windows, questo può essere fatto utilizzando il pannello di controllo delle variabili d’ambiente. Su Linux e macOS, è possibile aggiungere il seguente comando a ~/.bashrc (Debian/Ubuntu), ~/.bash_profile (macOS Mojave e inferiore) o ~/.zshrc (macOS Catalina):

export OO_PS4_TOOLCHAIN=[directory di installazione]

Ciò è necessario affinché gli script di compilazione e lo strumento di conversione sappiano dove cercare determinati file. Si consiglia inoltre di aggiungere la directory root SDK + /bin alla variabile del percorso.

Windows Installer

Per PC Windows, viene fornito un programma di installazione tramite script Nullsoft, che automatizzerà il processo di estrazione dei file della toolchain e l’impostazione della variabile di ambiente OO_PS4_TOOLCHAIN.

Linux

Per Linux, dopo aver installato le dipendenze richieste e aver impostato la variabile d’ambiente come indicato sopra, ti consigliamo di eseguire lo script setup-toolchain.sh in /extra. Ciò contrassegnerà tutti i file binari di Linux come eseguibili, poiché per impostazione predefinita sono in lettura/scrittura.

macOS

Per macOS, viene fornito un programma di installazione PKG, che automatizzerà il processo di estrazione dei file della toolchain e l’impostazione della variabile di ambiente OO_PS4_TOOLCHAIN nelle shell bash e zsh.

Creazione di progetti homebrew

Per Windows, /extra fornisce modelli di Visual Studio che possono essere aggiunti nella directory dei modelli dell’installazione VS per consentire una facile creazione di progetti homebrew, è inoltre possibile copiare e modificare le soluzioni dagli esempi forniti.

Per Linux e macOS, /extra contiene uno script setup-project.sh che creerà una directory di progetto basata sull’esempio hello_world.

Strumenti

Ogni strumento avrà un file README.md dedicato con informazioni più specifiche sullo strumento. Di seguito viene elencata una panoramica generica degli strumenti inclusi attualmente nella toolchain.

create-eboot

Lo strumento create-eboot prende i normali file ELF (Executable Linkable Format) ed esegue le patch e il ricollegamento necessari per creare un ELF (OELF) Orbis.

Prenderà ulteriormente questo OELF e lo trasformerà in Signed Executable Linkable Format (SELF). Ciò è stato reso possibile grazie al precedente lavoro di flatz sullo script make-fself.py, che può essere trovato in /scripts. Per ulteriori informazioni su questi formati, consultare il wiki o /docs.

Autore: Specter + flatz (fself stuff)

create-lib

Lo strumento create-lib è simile allo strumento create-eboot, tuttavia produce file della libreria Playstation Relocatable eXecutable (PRX) da un determinato file ELF.

Autore: Specter + flatz (fself stuff)

create-pkg

Lo strumento create-pkg prende una serie di file che le applicazioni dovrebbero avere (eboot.bin, param.sfo, moduli necessari, ecc..) e crea un file di pacchetto (pkg) che può essere installato su PS4.

Autore: maxton

stub-generator

Il generatore di stub genera i file header e i file delle librerie condivise (.so) per il collegamento con le librerie di sistema PS4. L’output di questo strumento è disponibile in /include/orbis e in /lib. Queste directory sono essenziali per collegarsi correttamente con le librerie PS4.

Autore: CrazyVoid

miralib

La libreria miralib contiene codice C# e Python per interagire con Mira sul lato desktop delle cose. Ciò include la gestione di un elenco locale di console, la connessione a una console e l’esecuzione di varie azioni una volta connesse tramite RPC.

Autore: Specter + Kiwi

assistant

Assistant è in realtà una suite di strumenti per aiutare nello sviluppo di homebrew per PS4. Ciò include un visualizzatore di registri, un debugger, un launcher per Mira e un’applicazione della barra delle applicazioni per avviarli facilmente.

Autore: Specter

readelf replacement

Questo è uno strumento sostitutivo per la lettura di file ELF compatibili con PS4, altrimenti noto come ELF Orbis (OELF).

Autore: Specter

Script

Tutti gli script presenti nella directory /scripts sono script Python 3, specifici per Python 3.7.0, ad eccezione di /scripts/make_fself.py. Avrai bisogno di Python installato sul tuo sistema per eseguire questi script. L’uso di questi script è disponibile in /scripts/README.md.

autobuild.py – è uno script per la generazione automatica di file pkg basato sul contenuto della directory del progetto (potrebbe essere instabile, attendere la compilazione del rilascio).

dynamic_entries.py – Questo script ottiene un elenco di voci dinamiche dalla tabella dinamica degli ELF Orbis.

make_fself.py – Copia dello script flatz’ per generare file SELF falsi. Questa funzionalità è stata ora integrata come parte di create-eboot e create-lib.

program_headers.py – Ottiene un elenco di intestazioni del programma dalla tabella delle intestazioni del programma degli ELF Orbis.

rela_entries.py – Ottiene un elenco di voci di trasferimento con aggiunta (RELA) dalla tabella di trasferimento degli ELF Orbis.

symbol_entries.py – ottiene un elenco di simboli dalla tabella dei simboli degli ELF Orbis.

Changelog

• Aggiunto il supporto per le eccezioni C++ (grazie Nikita Krapivin)!
• Aggiunto campione di rendering GPU OpenGL/piglet + intestazioni (grazie Nikita Krapivin)!
• Aggiunta la generazione automatizzata di pacchetti per esempi di script di compilazione!
• Aggiunto il supporto C++ per la creazione di librerie/PRX!
• Aggiunti e aggiornati prototipi/tipi per oltre 13 intestazioni specifiche per PS4 (grazie 0x199, sleirsgoevy, Nikita Krapivin, OSM, al-azif, bucanero)!
• Aggiornato il sistema/script di compilazione per gli esempi e i modelli di progetto VS in un sistema più pulito e conveniente.
• Corretto un problema per cui era difficile eseguire il debug delle app homebrew in GDB a causa di una sezione .dynamic errata (grazie sleirsgoevy)!
• Corrette più discrepanze tra le intestazioni BSD e MUSL (grazie sleirsgoevy, al-azif).
• Corretto un problema per cui le intestazioni cmath C++ non riuscivano a utilizzare determinati spazi dei nomi (grazie Nikita Krapivin).
• Corretti vari bug di errore di calcolo in create-fself.
• Rielaborato musl per utilizzare libkernel invece di syscalls per la compatibilità (grazie sleirsgoevy, John Tornblom).
• Unite create-eboot e create-lib in un unico strumento per facilità d’uso.

Video

Download: OpenOrbis PS4 Toolchain v0.5.2 (exe)

Download: OpenOrbis PS4 Toolchain v0.5.2 (pkg)

Download: Pacchetto esempi

Download: OpenOrbis PS4 Toolchain v0.5.2 (zip)

Download: Source code OpenOrbis PS4 Toolchain v0.5.2

Fonte: github.com