3DS PDN: Difference between revisions

3ds_pdn
3ds_pdn
General
Author	hax0kartik
Type	Media Players
Version	2021
License	Mixed
Last Updated	2021/06/14
Links
	Download
	Website
	Source
	Support Author

Latest revision as of 04:11, 17 May 2024

3ds_pdn is an open source implementation of PDN sysmodule which plays a MP3 from the sd card. Up until now, it was unknown whether this was possible, but as it turns out it is possible to do this. As anyone who has developed for 3DS before, should know that 3DS has two ways of playing audios, one through CSND and one through DSP. Apparently, it is possible to use CSND with modules to play music.

This is a functional POC of the music player (3DS PDN module rewrite) intended for developers and is able to play a MP3 off the sd card.

Building

To build you need to have ctrtool in your path, after which do make.

User guide

To use you need to put a MP3 file named as sound.mp3 on the root of your sd card and then enable game patching. The PDN sysmodule will spawn a thread in appcore for MP3 decoding and playing.

The POC works (atleast on N3DS, for O3DS you might need to change appcore to syscore or change the prio) but not smoothly, every time the system/game spawns a new thread there is a small break in audio due to the audio thread freezing and there are constant pop sounds. One possible reason is that the audio decoding and playing code will need soft-tuning.

Notes

Please remove patches for any other sysmodule before trying this as they can cause issues.
3DS sleep mode will be broken by this, you'll need to restart your console.
On a N3DS, enabling Clock+L2C seems to make the code run a bit more smoother.
It might be better if we do not use PDN for our purposes, instead create a new sysmodule to be launched by the homebrew audio player app.

Credits

@luigoalma - Help improving the code.

External links

@@ Line 1: / Line 1: @@
-{{Infobox-3DS-Homebrews
+{{Infobox 3DS Homebrews
-| title = Background mp3 player
+|title=3ds_pdn
-| image = https://dlhb.gamebrew.org/3dshomebrew/Background-mp3-player-3DS.jpg|250px
+|image=3ds.png
-| type = Media players
+|description=(POC) 3DS PDN module rewrite.
-| version = unknown
+|author=hax0kartik
-| lastupdated = 2021/06/14
+|lastupdated=2021/06/14
-| licence = Mixed
+|type=Media Players
-| author = hax0kartik
+|version=2021
-| website = https://gbatemp.net/threads/poc-developer-only-background-3ds-mp3-player.589949/
+|license=Mixed
-| download = https://dlhb.gamebrew.org/3dshomebrew/Background-mp3-player-3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/3dspdn.7z
-| source = https://github.com/hax0kartik/3ds_pdn/tree/music-player
+|website=https://gbatemp.net/threads/poc-developer-only-background-3ds-mp3-player.589949
+|source=https://github.com/hax0kartik/3ds_pdn/tree/music-player
+|donation=https://ko-fi.com/hax0kartik
 }}
-<youtube></youtube>
+ds_pdn is an open source implementation of PDN sysmodule which plays a MP3 from the sd card. Up until now, it was unknown whether this was possible, but as it turns out it is possible to do this. As anyone who has developed for 3DS before, should know that 3DS has two ways of playing audios, one through CSND and one through DSP. Apparently, it is possible to use CSND with modules to play music.
-People for the longest time have wanted to play mp3(s) while games are running. Up until now, it was unknown whether this was possible, but as it turns out it is possible to do this.As anyone who has developed for 3ds before, should know that 3ds has two ways of playing audios, one through CSND and one through DSP. Apparently, it is possible to use CSND with modules to play music.
+This is a functional POC of the music player (3DS PDN module rewrite) intended for developers and is able to play a MP3 off the sd card.
-Attached is a functional POC of the music player, it just plays a mp3 off your sd card. You need to put a mp3 file named as `sound.mp3` on the root of your sd card and then enable game patching. I rewrote the PDN sysmodule, so now it spawns a thread in appcore for mp3 decoding and playing. The POC works (atleast on n3ds, for o3ds you might need to change appcore to syscore or change the prio) but not smoothly, every time the system/game spawns a new thread there is a small break in audio due to the audio thread freezing and there are constant "pop" sounds. My guess is the audio decoding and playing code will need soft-tuning(do note I'm not the best when it comes to audio stuff). The code for the POC is located here:- https://github.com/hax0kartik/3ds_pdn/tree/music-player.
+==Building==
+To build you need to have ctrtool in your path, after which do <code>make</code>.
+==User guide==
+To use you need to put a MP3 file named as sound.mp3 on the root of your sd card and then enable game patching. The PDN sysmodule will spawn a thread in appcore for MP3 decoding and playing.
-Notes:-
+The POC works (atleast on N3DS, for O3DS you might need to change appcore to syscore or change the prio) but not smoothly, every time the system/game spawns a new thread there is a small break in audio due to the audio thread freezing and there are constant pop sounds. One possible reason is that the audio decoding and playing code will need soft-tuning.
-Please remove patches for any other sysmodule before trying this as they can cause issues.
-It might be better if we do not use PDN for our purposes but create a entirely new sysmodule which will be launched by the homebrew audio player app.
-ds sleep mode will be broken by this, you'll need to restart your console.
-On a n3ds, enabling "Clock + L2C" seems to make the code run a bit more smoother.
-I hope the scene will be able to work its magic and fix the issues my POC has and then incorporate the code in other homebrew audio players!:yay3ds:
-Also if you test this and if this works/does not work for you, please let me know!
+===Notes===
+* Please remove patches for any other sysmodule before trying this as they can cause issues.
+* 3DS sleep mode will be broken by this, you'll need to restart your console.
+* On a N3DS, enabling Clock+L2C seems to make the code run a bit more smoother.
+* It might be better if we do not use PDN for our purposes, instead create a new sysmodule to be launched by the homebrew audio player app.
+==Credits==
+@luigoalma - Help improving the code.
-[[Category:3DS homebrew applications]]
+==External links==
-[[Category:Homebrew media players on 3DS]]
+* GitHub - https://github.com/hax0kartik/3ds_pdn/tree/music-player
+* GBAtemp - https://gbatemp.net/threads/poc-developer-only-background-3ds-mp3-player.589949