[Opium]

Official DLDI Website
Linux DLDI Tutorial

What is DLDI? (how did it come about?)

DLDI stands for ‘Dynamically Linked Device Interface’. It is an interface for libfat that homebrew developers attached to their projects.

I’ll break it down to more understandable terms. Let’s say a homebrew developer makes a DS game where you can draw a picture and save the image to your flash cart. To save this image on the flash cart the developer would have to know the specific piece of code that allows you to write things to the cart. And if you wanted to read the image so you can edit it again you’d need access to the read capabilities of the flash cart. This forms the read/write commands which are essentially what libfat is.

There is a big problem however. Every flash cart uses different read/write commands. That would mean to get your game working on four different flashcarts you’d need to code it with all four different write/write methods. This is a big hassle for developers and flash cart owners a like. Under the old system homebrew projects that used read/write commands (FAT access) only worked on the flashcarts they were specifically coded for. As there are so many flash carts on the market many were left out because to keep your homebrew project working on 15 + different kits would be a nightmare!

Along came DLDI. This interface developed by Chishm unifies everything. It is a single interface that homebrew developers attach to their projects. The developers don’t have to worry about making their project compatible with a whole range of different carts. Instead each flashcart has a specific DLDI patch made for it which houses all the read/write commands. You would then simply patch the homebrew game or application with your cart’s DLDI patch and it will work on your cart. So if you have an R4 DS you apply the R4 DS DLDI patch to the homebrew .nds file. The beauty is that once a DLDI patch has been made for your cart it’ll be compatible with every piece of homebrew that has DLDI support.


What carts are supported?

As of the time of writing the following carts have a DLDI patch:

AceKard+
DSLink
DS-Xtreme
Ewin2
EZ-Flash IV
EZ-Flash V
G6-Flash (Lite)
M3 Adapter (CF)
M3 Adapter (SD)
Max Media Dock
GBA Movie Player (CF)
GBA Movie Player (SD)
NEO flash MK2 & MK3
NEO2
Ninja DS
NinjaPass X9
R4 DS
M3 DS Simply
Supercard (CF)
Supercard (SD)
Supercard Lite
Supercard DS One

You can download DLDI patches from the official site here.

Important note: many of the current slot-1 flashcarts now patch homebrew automatically, so you won't need to patch anything (providing you have the latest firmware/loader/updates for your cart). These carts feature automatic DLDI patching: CycloDS evolution, R4, M3 Simply, and other might add up to this list later.


What Homebrew games/apps do I need to patch?[/color]

Any homebrew game or application that uses FAT access and supports DLDI. Homebrew games/apps that do not read or write to your card do not need to be patched.


[size=7]How do I patch my homebrew games/apps?

1. Download a DLDI patcher from the homepage. I recommend this one.
2. Download the appropriate DLDI patch for your flash cart.
3. Select the DLDI file you want to use.
4. Select the homebrew you want to patch in the ‘binaries’ section.
5. Click ‘Patch’ and you’re done.



Note: EZ-Flash V users will need to use a separate DLDI patcher to make DLDI work. If you have an EZ-Flash V please use this DLDI patcher. No other files are needed, simply drag and drop the homebrew onto the exe file.

[Azimuth]

for the sake of tidying things up, could you link this Linux tutorial in the guide. If someone could find the mac guide post that too.

Edit: wrong link to guide

Edited by Azimuth, 23 February 2007 - 08:13 AM.

[Satangel]

Nice one, it confused me at the start too, but Ive found it out myself. I'm glad I'm not doing it wrong, I do it exactly the way you guys do!

BTW does it any harm if you patch a homebrew that doesnt need DLDI?

Edited by Satangel, 23 February 2007 - 09:48 AM.

[DEF-]

Nice little guide, will help alot of users for sure.

I myself prefer to read about DLDI and find out how it works by myself. But thats just geeky me

[blizeH]

Great explanation etc, thank you!

Just wondering where can I get a DLDI for my card though? It's a G6 Lite, doesn't seem to mention it anywhere above.

Thanks again!

[rest0re]

Great explanation etc, thank you!

Just wondering where can I get a DLDI for my card though? It's a G6 Lite, doesn't seem to mention it anywhere above.

Thanks again!

<{POST_SNAPBACK}>

lol owned

[Sentient]

Very nice! I'm going to get this going on some homebrew for my R4.

Edited by Sentient, 23 February 2007 - 11:19 AM.

[fli_guy84]

Nice guide Opium, but why did you leave out DS-X?

Is it because it's listed as 'No' under 'Tested?'

[alcaholjunkie]

Just wondering where can I get a DLDI for my card though? It's a G6 Lite, doesn't seem to mention it anywhere above.

<{POST_SNAPBACK}>

G6 and G6-lite are the exact same thing, just different shells for the carts.

[adgloride]

Great Tutorial explaining about DLDI. I've always thought that it was so easy to use, you never needed a tutorial.

[blizeH]

Awesome, thank you ^

[thegame07]

thanks i understand it now

Edited by thegame07, 24 February 2007 - 03:08 AM.

[Verocity]

Great, but whas the watermark of gbatemp.net on the top image really necessary?

Anyway good job!

[imgod22222]

quick suggestion, when you say the binary,you might want to make clear whether to use the .nds, or the .gba.ds file.

[jjkm4a1]

Thanks, this tutorial helped me.