Logo

dev-resources.site

for different kinds of informations.

Golang on PSP (and other languages)

Published at
12/27/2024
Categories
go
webassembly
psp
tinygo
Author
brownnpc
Categories
4 categories in total
go
open
webassembly
open
psp
open
tinygo
open
Author
8 person written this
brownnpc
open
Golang on PSP (and other languages)

I decided to try using Golang on the PSP and explored several approaches, including porting Clang, using TinyGo, and compiling Golang to JavaScript with GopherJS. Then, I came across a user named aethiopicuschan on the PSP homebrew Discord, who was attempting the same goal using WebAssembly. His example worked on PPSSPP but not on actual hardware.

Anyways, I had to put my project on hold due to upcoming exams. But, a few months later, I found an article where aethiopicuschan successfully compiled Golang to WASM and ran it on the PSP using a WASM interpreter.
His approach used a Wasm interpreter called Wasm3 to run the code, but I knew I could do better. I knew about projects like Wasm2C which convert your Wasm binaries to C.
Excited, I dove deeper into the topic and discovered an article about compiling WebAssembly to portable C code. They used a compiler called w2c2, which I guess is the sequel.

After hours of tinkering with CMake, I managed to create a working example using TinyGo and targeting WASI. I also wrapped a raylib function, InitWindow (the psp has a raylib port by the way), with the goal of porting raylib-go bindings to this WASM-to-C platform. The example successfully binds the C InitWindow function to the compiled WASM code.

As you can see, it looks like any other golang code

package main

import "time"

import rl "github.com/gen2brain/raylib-go/raylib"

func main() {

    rl.InitWindow(480, 272, "Psp test")
    for {
        time.Sleep(time.Millisecond * 16)
    }
}
Enter fullscreen mode Exit fullscreen mode

but in the rl package, we are importing a C function, we give it a function signature as well. Keep it in mind.


package rl

//go:wasmimport rl InitWindow
func c_InitWindow(width int32, height int32, title string)

// InitWindow - Initialize Window and OpenGL Graphics

func InitWindow(width int32, height int32, title string) {
    c_InitWindow(width, height, title)
}
Enter fullscreen mode Exit fullscreen mode

lets break this code down step by step.

#define __GLIBC_USE

#include <raylib.h>
#include <stdio.h>
#include <time.h>

#include <pspkernel.h>
PSP_MODULE_INFO("WasiExample", 0, 1, 0);
PSP_MAIN_THREAD_ATTR(THREAD_ATTR_USER);
#include "pspdebug.h"
#define printf pspDebugScreenPrintf

Enter fullscreen mode Exit fullscreen mode

first we import psp libraries, and setup the boiler plate, we also import the raylib port

here we are importing the compiled module app.h
we also import the wasi "runtime" which is provided by w2c2


// // the compiled wasm -> C code
#include "app.h"
// // wasi runtime
#include "w2c2_base.h"
#include "wasi.h"

extern wasmMemory* e_memory;  // the WASM memory.
void trap(Trap trap)
{
  fprintf(stderr, "TRAP: %s\n", trapDescription(trap));
  abort();
}

wasmMemory* wasiMemory(void* instance)
{
  return app_memory((appInstance*)instance);
}
extern char** environ;

Enter fullscreen mode Exit fullscreen mode

The trap function is boiler plate,
the wasiMemory function is a helper function I made for another helper function

char* getCStringFromMemory(void* memoryptr, U32 offset, U32 length)
{
  wasmMemory* memory = wasiMemory(memoryptr);
  char* str = (char*)(memory->data + offset);
  char* result = (char*)malloc(
    length + 1);  // Allocate space for the string + null terminator
  if (result == NULL) {
    fprintf(stderr, "Memory allocation failed\n");
    return NULL;
  }

  // Copy the string from WASI memory to local memory
  for (U32 i = 0; i < length; ++i) {
    result[i] = str[i];
  }
  result[length] = '\0';  // Null-terminate the string

  return result;
}
Enter fullscreen mode Exit fullscreen mode

all this function does is it takes the memory pointer for a string memory pointer (in wasm we handle strings by passing a memory offset, and the string's length), and returns a C string using the offset and length

this is the C function we call from our golang code, I had to define it myself.

void rl__InitWindow(
  void* memoryptr, U32 width, U32 height, U32 offset, U32 length)
{
  char* title = getCStringFromMemory(memoryptr, offset, length);
  InitWindow(width, height, title);
  bool ready = IsWindowReady();
  if (ready) {
    // this will print to the psp screen.
    printf("Window was created");
  }
}

Enter fullscreen mode Exit fullscreen mode

we are reading the args passed by the transpiled wasm, and passing them on to raylib.


this is some more boilerplate, all we're doing is running the main function of the golang code, which is exported as app_start()

int main(int argc, char* argv[])
{
  pspDebugScreenInit();
  appInstance i;
  appInstantiate(&i, NULL);
  if (!wasiInit(argc, argv, environ)) {
    fprintf(stderr, "failed to initialize WASI\n");
    return 1;
  }

  app__start(&i);
  appFreeInstance(&i);
  return 0;
}
Enter fullscreen mode Exit fullscreen mode

Image description

it works!

This is a screenshot of a psp ๐Ÿšจemulator๐Ÿšจ.
but it also works on original hardware.

Leave any questions in the comment section!

webassembly Article's
30 articles in total
Favicon
How to Build an Image Processor with React and Transformers.js
Favicon
A Gentle Introduction to WebAssembly in Rust (2025 Edition)
Favicon
How to Build a Speech-to-Text App with React and Transformers.js
Favicon
The Dev Tools Evolution: LLMs, Wasm, and What's Next for 2025
Favicon
Progressive Web Apps: New FE systems
Favicon
Run Python programs easily in the browser.
Favicon
Scaling Spin Apps With KEDA
Favicon
How to Build a Text-to-Image Generator with React and Transformers.js
Favicon
Shocking! AI Instantly Removes Backgrounds in Your Browser-Netizens Exclaim: This is Absolutely Magical!
Favicon
Using SpinKube on Kairos
Favicon
Golang on PSP (and other languages)
Favicon
Introduction to WebAssembly (WASM)
Favicon
Sneak Peek at 2024 Volume 4: Flutter
Favicon
Orchestrating Distributed Apps (Spin/Rust and .NET/C#) with .NET Aspire/Dapr
Favicon
How React and WebAssembly Can Speed Up Your Web Apps in 2025
Favicon
Level Up Your WordPress Skills with WebAssembly
Favicon
The Wasm Component Model and idiomatic codegen
Favicon
The 2024 Highlights
Favicon
Currency converter in Rust + WebAssembly
Favicon
Wasm3 + TinyGo on PSP
Favicon
Is the browser always the right tool for the job?
Favicon
Rust for JavaScript Developers: Your First WebAssembly Module
Favicon
You Are Already Using Wasm In Production
Favicon
Tic Tac Toe in Rust + Webassembly
Favicon
eval() with WASM instead of sandbox with Web Extensions
Favicon
Integrating Spin with Azure services
Favicon
Spin Verman - The Version Manager Plugin
Favicon
Harnessing the Potential of Blazor: Revolutionizing Web Development with C#
Favicon
Building for WebAssembly
Favicon
ALKANES: Smart Contracts on Bitcoin UTXOs

Featured ones: