Nitrofs

Nitrofs Filesystem Driver

Why is this needed?

The nitrofs driver allows accessing of files from a read-only nitro-filesystem that is appended to the end of an .nds file.

The previous solutions to appending filesystems to .nds files were kinda suxy.

Examples

Firstly, you'll need this includes:

#include <nds.h>
#include <stdio.h>
#include "nitrofs.h"
#include <fat.h>
#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>

Then you will need to initialize the FAT driver, and the nitrofs driver:

fatInitDefault();
nitroFSInit("myndsfile.nds"); //See * Notes Below

• Replace this with the name of your .nds file. You could try using argv[0] here (which points to the current file) but as of this writing it is not supported on all cards.

Lastly open a file as you would in any other OS specifying nitro: as the drive:

fd=open("nitro:/Th04_01.raw",O_RDONLY);
read(fd, myBuffer, mybufferSize);
close(fd);

(Author's Note: Really dislike that they did not use Unix style nodes for drives and devices such as '/dev/device' or '/media/drive'. Instead opting for DOS 'drive:' style.. buy jaja.. it works :D )

You may want to add some error checking and reporting in case the filename or filepath passed to nitroFSInit are incorrect, the card does not support DLDI, or are not using the correct build for emulators not supporting DLDI (which are most of em'). This can be done somewhat like this:

int fd;
	bool imfat;	//indicate fat driver loaded properly
	printf("initalizing fat\n");
	if(fatInitDefault()) {
		imfat=true;
		printf("Success...\n");
	} else {
		imfat=false;
		printf("Failed... (normal for some emulators. Dont worry, yet :p)\n");
	}
	printf("initalizing nitrofs\n");
	if(nitroFSInit("myndsfile.nds")) {
		fd=open("nitro:/myreadonlynitrofsfile.txt",O_RDONLY);
		if(fd) {
			len=read(fd,sample,st.st_size);
			close(fd);
			}
		} else {
			printf("read only file open failed\n");
		}
	} else {
		printf("Failed...\n");
		if(imfat) { //error if fat was initialized...
			printf("Cannot open %s please check filename and path are correct.\n",FILENAME);
		} else { //error if fat/dldi failed
			printf("FAT/DLDI error, please to ensure your card supports DLDI.\n\nIf using emulators  that do not support fat/dldi (such as no$gba) be sure you are using a nds.gba or .sc.nds build.\n");
		}
	}

Releases

Nitrotstprojectv0.1.tar.bz2

---