DSFTP: Difference between revisions

	DSFTP
	File:DSFTP.png
General
Author(s)	Bjoern Giesler
Type	Utility
Version	2.6
Licence	Mixed
Links
	[Media:DSFTP26.zip Download]
	Website

Revision as of 02:55, 19 May 2021

Installation

Download and unzip file.

Copy the DSFTP.nds (or .ds.gba) file to your flash card.

For development, it's best to copy libDSFTP.a and libDSFTPd.a to your devkitpro's lib directory, and the include directory to your devkitpro's include dir.

User guide

When you start the application it will auto connect using the WiFi settings in your DS and confirm the IP address at the bottom of the screen. If a config file is not found then it creates and displays a default user and password that you can use to access the DS. Use your favourite FTP program to connect to the IP address and authenticate with the username and password. You can then copy to/from and delete files from your card.

Create config

Create a text file called ftp.conf in (root)/data/settings/. File name and location is critical.

Using a text editor (eg. notepad) add the following text to the file:

user joe
pass whatever
root /
home /
write true
boot true
end user

Change the user and pass to one of your choosing. Then save the file. Further details on setting up the server with custom settings.

Note from developer:

Performance tested using the following clients. Performance with other clients unknown, but should work.

command-line FTP on Mac/DOS
RBrowser Lite on Mac
MacOS X virtual FTP ﬁle system
Firefox
FileZilla
FireFTP (Firefox plugin)
WS_FTP

Known issues

"Acquiring DHCP - Could not connect. Please restart." Many Homebrew WiFi apps can't connect to Access Points using DHCP. The work around is to use a fixed IP address.

Seems to crash at the end of a long upload.

Upload speeds can be very slow (<1kb/sec).

Booting only veriﬁed to work on Supercard CF and Supercard SD.

Changelog

Version 2.6

Fixed hangs on some hardware combinations.
Fixed bug which caused directory contents not to be reported correctly.
Introduced new conﬁg option transferblocksize.

Version 2.5

Upgraded to devkitpro 21, so linking to libDSFTP should work now.
Uses DSWiﬁ 0.34, so people with newer DS Lites should have no problems.
Uses libfat instead of gba_nds_fat, which should be more stable.
Uses DSGUI for graphics and ﬁle-system interface.

Version 2.4

The FAT driver has been upgraded to chishm's DLDI ﬁle system driver interface. The pre-compiled version comes with Supercard CF driver installed. No other interfaces will be supported any more. If you have a different ﬂash card, please patch the DSFTP binary yourself.

Version 2.3

UNZP added (submitted by Bertrand Augereau).
DS->PC ﬁle transfer speeded up a lot (patch to DSWiﬁ submitted by masscat).
Linked with Devkit R18 again (ﬁxes some showstopper bugs).
More bugﬁxes.

Version 2.2

Glaring bug ﬁxed that caused GBAMP not to work anymore.
Booting veriﬁed on SuperCard and GBAMP now.
CDUP command supported.
More bugﬁxes.

Version 2.1

Uniﬁed bootloading should now support most cards.
Auto-generated user & pass if none speciﬁed.
More bugﬁxes.

@@ Line 2: / Line 2: @@
 | title       = DSFTP
 | image       = [[File:DSFTP.png]]
-| type        = Utilites
+| type        = Utility
 | version     = 2.6
 | licence     = Mixed
@@ Line 18: / Line 18: @@
 ==Installation==
-#Download and unzip file.
+Download and unzip file.
-#Copy the DSFTP.nds (or .ds.gba) file to your flash card.
+Copy the DSFTP.nds (or .ds.gba) file to your flash card.
 For development, it's best to copy libDSFTP.a and libDSFTPd.a to your devkitpro's lib directory, and the include directory to your devkitpro's include dir.
 ==User guide==
-When you start the app it will auto connect using the Wifi settings in your DS and confirm the IP address at the bottom of the screen. If a config file is not found then it creates and displays a 'default' user and password that you can use to access the DS. Use your favourite FTP program to connect to the IP address and authenticate with the username and password. You can then copy to/from and delete files from your card.
+When you start the application it will auto connect using the WiFi settings in your DS and confirm the IP address at the bottom of the screen. If a config file is not found then it creates and displays a default user and password that you can use to access the DS. Use your favourite FTP program to connect to the IP address and authenticate with the username and password. You can then copy to/from and delete files from your card.
 ===Create config===
-. Create a text file called 'ftp.conf' in '(root)/data/settings/' File name and location is critical.
+Create a text file called ftp.conf in (root)/data/settings/. File name and location is critical.
-. Using a text editor (eg. notepad) add the following text to the file:
+Using a text editor (eg. notepad) add the following text to the file:
   user joe
   pass whatever
@@ Line 36: / Line 37: @@
   write true
   boot true
-  end user
+  end user <br>
-. Change the user and pass to one of your choosing.
+Change the user and pass to one of your choosing. Then save the file. [http://giesler.biz/bjoern/en/sw_dsftp.html#usage Further details on setting up the server with custom settings.]
-. Save the file .
+'''Note from developer:'''
-[http://giesler.biz/bjoern/en/sw_dsftp.html#usage Further details on setting up the server with custom settings.]
+Performance tested using the following clients. Performance with other clients unknown, but should work.
+command-line FTP on Mac/DOS<br>
+RBrowser Lite on Mac<br>
+MacOS X virtual FTP ﬁle system<br>
+Firefox<br>
+FileZilla<br>
+FireFTP (Firefox plugin)<br>
+WS_FTP<br>
 ==Known issues==
-*Acquiring DHCP - Could not connect. Please restart.
+"Acquiring DHCP - Could not connect. Please restart." Many Homebrew WiFi apps can't connect to Access Points using DHCP. The work around is to use a fixed IP address.
-:Many Homebrew Wifi apps can't connect to Access Points using DHCP. The work around is to use a fixed IP address.
-*Seems to crash at the end of a long upload
+Seems to crash at the end of a long upload.
-*Upload speeds can be very slow (<1kb/sec)
-*Booting only veriﬁed to work on Supercard CF and Supercard SD.
+Upload speeds can be very slow (<1kb/sec).
-*Performance tested using the following clients. Performance with other clients unknown, but should work.
-:command-line FTP on Mac/DOS
+Booting only veriﬁed to work on Supercard CF and Supercard SD.
-:RBrowser Lite on Mac
-:MacOS X virtual FTP ﬁle system
-:Firefox
-:FileZilla
-:FireFTP (Firefox plugin)
-:WS_FTP
 ==Changelog==
 '''Version 2.6'''
-*Fixed hangs on some hardware combinations
+* Fixed hangs on some hardware combinations.
-*Fixed bug which caused directory contents not to be reported correctly
+* Fixed bug which caused directory contents not to be reported correctly.
-*Introduced new conﬁg option transferblocksize
+* Introduced new conﬁg option transferblocksize.
 '''Version 2.5'''
-*Upgraded to devkitpro 21, so linking to libDSFTP should work now
+* Upgraded to devkitpro 21, so linking to libDSFTP should work now.
-*Uses DSWiﬁ 0.34, so people with newer DS Lites should have no problems
+* Uses DSWiﬁ 0.34, so people with newer DS Lites should have no problems.
-*Uses libfat instead of gba_nds_fat, which should be more stable
+* Uses libfat instead of gba_nds_fat, which should be more stable.
-*Uses DSGUI for graphics and ﬁle-system interface
+* Uses DSGUI for graphics and ﬁle-system interface.
 '''Version 2.4'''
-*The FAT driver has been upgraded to chishm's DLDI ﬁle system driver interface. The pre-compiled version comes with Supercard CF driver installed. No other interfaces will be supported any more. If you have a different ﬂash card, please patch the DSFTP binary yourself.
+* The FAT driver has been upgraded to chishm's DLDI ﬁle system driver interface. The pre-compiled version comes with Supercard CF driver installed. No other interfaces will be supported any more. If you have a different ﬂash card, please patch the DSFTP binary yourself.
 '''Version 2.3'''
-*UNZP added (submitted by Bertrand Augereau)
+* UNZP added (submitted by Bertrand Augereau).
-*DS->PC ﬁle transfer speeded up a lot (patch to DSWiﬁ submitted by masscat)
+* DS->PC ﬁle transfer speeded up a lot (patch to DSWiﬁ submitted by masscat).
-*Linked with Devkit R18 again (ﬁxes some showstopper bugs)
+* Linked with Devkit R18 again (ﬁxes some showstopper bugs).
-*More bugﬁxes
+* More bugﬁxes.
 '''Version 2.2'''
-*Glaring bug ﬁxed that caused GBAMP not to work anymore
+* Glaring bug ﬁxed that caused GBAMP not to work anymore.
-*Booting veriﬁed on SuperCard and GBAMP now
+* Booting veriﬁed on SuperCard and GBAMP now.
-*CDUP command supported
+* CDUP command supported.
-*More bugﬁxes
+* More bugﬁxes.
 '''Version 2.1'''
-*Uniﬁed bootloading should now support most cards
+* Uniﬁed bootloading should now support most cards.
-*Auto-generated user & pass if none speciﬁed
+* Auto-generated user & pass if none speciﬁed.
-*More bugﬁxes
+* More bugﬁxes.
-[[Category:Homebrew applications]]
+<br>
+[[Category:DS homebrew applications]]
+[[Category:Utility homebrews on DS]]