PSFreedom source code released!

Hi again,

As promised yesterday, I’ve just released the source code for PSFreedom. You can grab it now on github.

If you want to port it to work on another device, then fork the repository and start working, you can send me a pull request once it’s done. See the end of this post for a little howto on porting it to a new device.

I have also decided to remove that video I put yesterday on youtube. I didn’t give the link to anyone, but somehow people found it and it got linked on multiple news sites… that video is useless, hard to watch, and I’m sorry! I’ve made a new video that you can view here :

Since yesterday I’ve been spammed with emails, comments on my blog, PMs and pings on IRC, etc.. and my server even went down (doesn’t seem to be because of high traffic). So I’d like to answer everyone with this FAQ :

Q : What is your relationship with the PSGroove project ?

A: PSGroove was released a while ago while I was already working (about 50% done) on PSFreedom. I had help from Mathieulh and Phire from the PSGroove team, who gave me insight on what the jailbreak does. When PSGroove was released, I read its code to understand what it does and to make sure my code worked in the same way. I copied the descriptors and payload from the code of PSGroove, and I give them credit for what they did, and for what I copied from their project. I set my license to GPL v3 to match theirs, and I gave credits to those who helped me on IRC. However, I say and I insist that PSFreedom is not a port of PSGroove, because I never took their code and ported it to the N900, this is my original work, and I wrote all of its code from scratch. Some of the PSGroove team seem to be in conflict with me because of that, they insist that “if you looked at our code, then it is a without question a port of PSGroove”, and I believe we have two very different understanding of the term ‘port’.

Q : Can/when is it going to work on the iPhone/Symbian/My phone ?

A: PSFreedom is a  Linux driver, so it will only work on Linux-enabled devices.. which means, not on iOS, and not on Symbian, so please stop asking about that!

Q: Will it work on the 770/N800/N810 ?

A: I only did this for the N900, I might port it to other devices, but right now, I cannot give any guarantees to anyone that it will be ported or that it will work on another device… The source code has been released and whoever wants to contribute can go ahead, fork my repository, and send me a pull request when you got something working.

These are linux devices, so yes, it should work, but just like any other device, they use a different controller than the N900, so a little porting will be necessary.

Q: Will it work from a linux PC ?

A: Unfortunately, no, most PCs have a USB controller  that only supports Host mode, but you need Slave mode to be able to make this work.

Q: Can I run backups with this ?

A: At the moment, no, I have used the same payload as PSGroove, which means backups are disabled, although someone already released a version of PSFreedom with backups enabled. In the future, I will hopefully  make the module load any payload at runtime, this way you could choose between different payloads.

Q: Can you make it easier to use ?

A: Me? No.. someone else? Yes.. there is already someone working on a UI for PSFreedom, and it will be available once it’s ready.

Q: What do I need to use PSFreedom on my N900 ?

A: First, you need a N900 (duh) and a PS3 (duh) with firmware 3.41. The N900 should be running the stock kernel (-omap1) not a modified kernel. Then you just need to scp the files to the N900 and run the -enable script.

Q: How much of the source is Nokia N900 specific? Are you using the Linux USB Gadgets library?

A: Very little is N900 specific, I’m using the include/linux/gadget.h if that’s what you mean. See next Q/A for more info.

Q: How hard is it to port it to a new device ?

A: Well, I’ve just separated my code from the N900 specific stuff, so it’s quite easy, there are mainly two functions to write, one to get and one to set the USB address.. two other functions that only return some static result depending on the configuration of the controller (the name of the endpoints, and whether the controller supports high speed or full speed mode).

Read the README file provided with PSFreedom, and check the psfreedom_machine.c file for specifics on what to implement.

Q: How can I port it to a new device.

A: Well, first, you need to figure out what controller your device uses, in the case of the N900, it’s ‘musb’..

Then go to the driver code for that controller (probably in drivers/usb/gadget) and look for ‘SET_ADDRESS’. In the case of musb, it was in drivers/usb/musb/musb_gadget_ep0.c. In there it was setting the address to the USB device, so just copy that code into the psfreedom_machine.c to allow setting the address, and add a similar function to be able to retreive the address.

Then add a function to return 0 or 1 depending on whether the controller supports HIGH, FULL or LOW speed mode (go to usb_gadget_register_driver for your controller, and in the first lines, it should validate the speed argument, it will tell you which ones are acceptable), set LOW speed mode to return TRUE only if FULL speed isn’t available .

Finally, add a function to return the endpoint names.. it will usually be something like ‘epXin’ and ‘epXout’ (where X is the endpoint number), or “epXin-bulk”, etc.. look at how the driver initializes its endpoints or grep for “->name” in the file to find where it sets it…

That should be enough!

Ok this is it for now with the FAQ. Next time, I’ll tell you all about my experience, what problems I encountered and how I fixed them, maybe it will help others!

Enjoy it!


48 thoughts on “PSFreedom source code released!

  1. Pingback: PSFreedom source code released!KaKaRoTo’s Blog |

  2. Pingback: PSFreedom source code released! « KaKaRoTo's Blog « Amazing Source

  3. Actualy it is possible to be ported for iPhone – a jailbroken iPhone has Darwin Linux for ARM architecture…there are also apps that make the phone act like a generic USB mass storage device – perhaps they are usin slave mode too?

  4. will all code compile on Android?, it´s possible to make it work on Android with no so much changes?.

    Thanks for your GREAT Work.

  5. IS this possible i know not with a standard pc usb controller. But using an external hub instead. Since most hubs basically run in both slave and host mode.

    You would have to reverse the mode with in the hub and make it so instead of running host to slave on the pc. it would have to be slave to slave.

    then from there you would just have to make a port for that usb external so it runs and changes the device ids while being loaded on the ps3 from the pc

  6. Hi, I’m trying to compile this for the n800 under the Maemo 4 SDK, and I get the following errors:

    [sbox-DIABLO_ARMEL: ~/kakaroto-PSFreedom-8344509] > make n800
    make -C /usr/src/kernel-source-diablo M=/home/tarball/kakaroto-PSFreedom-8344509 EXTRA_CFLAGS=”-I/usr/include -DENABLE_MUSB_CONTROLLER” EXTRAVERSION=-omap1 modules
    make[1]: Entering directory `/targets/DIABLO_ARMEL/usr/src/kernel-source-diablo’
    CC [M] /home/tarball/kakaroto-PSFreedom-8344509/psfreedom.o
    In file included from /home/tarball/kakaroto-PSFreedom-8344509/psfreedom.c:120:
    /home/tarball/kakaroto-PSFreedom-8344509/psfreedom_machine.c: In function `psfreedom_get_address’:
    /home/tarball/kakaroto-PSFreedom-8344509/psfreedom_machine.c:82: warning: implicit declaration of function `gadget_to_musb’
    /home/tarball/kakaroto-PSFreedom-8344509/psfreedom_machine.c:82: warning: initialization makes pointer from integer without a cast
    /home/tarball/kakaroto-PSFreedom-8344509/psfreedom_machine.c: In function `psfreedom_set_address’:
    /home/tarball/kakaroto-PSFreedom-8344509/psfreedom_machine.c:100: warning: initialization makes pointer from integer without a cast
    /home/tarball/kakaroto-PSFreedom-8344509/psfreedom_machine.c:103: error: structure has no member named `address’
    make[2]: *** [/home/tarball/kakaroto-PSFreedom-8344509/psfreedom.o] Error 1
    make[1]: *** [_module_/home/tarball/kakaroto-PSFreedom-8344509] Error 2
    make[1]: Leaving directory `/targets/DIABLO_ARMEL/usr/src/kernel-source-diablo’
    make: *** [N8x0] Error 2

    The n800 uses musb just like the n900, so I’m not sure what the issue is?

  7. Well I managed to get it compiled and loaded on the n800, however it doesn’t seem to work as intended. The n800 just sees the ps3 as a USB device accessing the memory card, it doesn’t run the exploit.

  8. Hey Tarball, Can you do a test compile for the n810? Or just send me your files since the n810 and n800 are suppose to be similar. I want to test it out too. Email it to me at koobazzzz at gmail dot com. Much thanks.

  9. I’ve sent you the module compiled for the n800/n810, azz.
    Also, my previous post was incorrect. The exploit doesn’t just “not work”. My n800 freezes and reboots when connected to my ps3 after pressing the power and eject buttons. I’m assuming this means something in the code needs to be fixed for n800/n810.

  10. Great work Goku! 😉 It is a shame Sony locked the PS3 down so tightly. I know of one Linux HTPC distro that would be ported to the PS3 if full access to the RSX was available.

  11. Pingback: Hack je PS3 met de N900 | N900 - De n900 site van de Benelux | N900 – De n900 site van de Benelux

  12. Pingback: Led Lamps| Silver Byte : DIY Arduino RGB LED Lamp : SB002

  13. those symbian beggers are pain in the ass! hit your stupid heads with something heavy.. The guy made a nice piece of soft for the phone he owns! Do you think that anybody would buy some symbian shit just to port psfreedom for lame script kiddies? That kind of software should be freely available only for open OSes.

  14. Hi and congratulations as well as infinite thanks!

    Amazing work, and incredible to have this running on the n900! More people should develope for that “phone”, but that’s beside the point.

    I was wondering whether you would arrange a donate function, I would certainly be willing to donate a nice amount.

    Regards and quite giddy about this,

  15. Pingback: Nokia N900 kan door hack PS3 jailbreaken » TechFreak

  16. Pingback: Hermes Handbags Sale » Blog Archive » Information when Shopping for Balenciaga Handbags-Handbagseshop

  17. Pingback: webos新闻:用pre来帮助PS3越狱(有视频) | simon的个人日志

  18. eii ola esta grandioso tu trabajo lo ke lei eske solo por ahora soporta con telefonos linux con un motorola v8 se podraa

  19. Is it possible to make this work with fw 3.15? Any information you have regarding this would be very valuable.

  20. Hi can you please add the HTC Wildfire to the android phones your trying to crack. I believe it uses the msm72k controller aswell but im not sure so you might want to look into it.
    Thanks for all the hard work

  21. Hello Mr.kakaroto
    your work is AMAZING my friend
    as what Mr.UntiTLeD had syaing .. Can you do this with S60 phones ?
    please ! the most of phone users in the world are using the phones wich compatiable with S60 .. so I hope you to work on it too ..
    Thanks alot my friend !

  22. How about using a dreambox? Im pretty sure they have a usb slave controller. And they often sit right next to the ps3, while running linux 24/7! 🙂

  23. KaKaRoTo,

    I think I have one other port ready
    can we talk on efnet this evening ?



  24. THANKS Kakaroto and PSGroove Team! This is AWESOME!

    I bought the n900 2 weeks ago and PSFreedom is the best gift I could have ever dreamed.

    I´ll stay tuned for any update.

    Thank you so much from Spain.

  25. hey, so much thx for this 🙂 i love my n900 even more now 😛

    one question: psfreedom was updated today, is there a chance to get this on our phone?

  26. psfreedom wasn´t updated today, it was psgroove, they are different thinks
    The psgroove update isn´t usefull for normal users

  27. PSFreedom was also updated… the number of commits that were pushed on git is surprising.. we had multiple ‘updates’ everyday since release.

  28. kakaroto isit possible for the samasung wave bada linux based can you get it testes or findout what controller it uses to see if it would actually work thank you

  29. Hi,

    Any chance of this working on iDroid? That is a port of Android running in a dual boot mode on an iPhone.

    Can you look at the souce of iDroid and see if it would work using PSFreedom?


  30. Hi again,

    Could you post what are the new features or when will you release PSFreedom 2.0, please?

    Can´t wait for that.

    Thank you so much

  31. 2 questions:

    I just wanna know, is it possible to port it to symbian 60 or not?

    If not, can we use a emulator of some kind of the n900 to make this work (on pc) ?

Comments are closed.