DSLinux: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 6: Line 6:
| licence    = GPL, LGPL, or BSD
| licence    = GPL, LGPL, or BSD
| author      = DSLinux team
| author      = DSLinux team
| website    = http://www.dslinux.org/
| website    = http://www.dslinux.org
| download    = http://kineox.free.fr/DS/
| download    = http://kineox.free.fr/DS
| source      = http://forums.steampowered.com/forums/forumdisplay.php?f=45
| source      = http://dslinux.gits.kiev.ua/trunk
}}
}}


DS Linux is a port of the Linux operating system to the Nintendo DS. DSLinux was maintained until sometime in 2010. It works on real hardware, use on emulators is not supported. Since Apr 28 2007, RAM build is integrated in the [[DLDI|DLDI]] build.
DS Linux is a port of the Linux operating system to the Nintendo DS. DSLinux works on real hardware and was maintained until sometime in 2010. Since Apr 28 2007, RAM build is integrated in the [[DLDI|DLDI]] build.


==Features==
==Features==
Line 25: Line 25:


==Installation==
==Installation==
Download [http://kineox.free.fr/DS/dslinux.nds dslinux.nds] to the apps folder of your card.
Multiple builds are available, for the following 3 builds, you must extract the linux directory in the root directory of your card.
* dslinux-dldi.tgz - For many devices, including Supercard and M3 with RAM support (requires DLDI).
* dslinux-gbamp.tgz - For GBA Movie Player.
* dslinux-dsmem.tgz - For Amadeus' Memory Extension.


[[DLDI|DLDI]] patch .nds file and copy it to the root directory of the card.
Alternaitvely you can use the single file build.
* dslinux.ds.gba - For GBA flash, G6.
* dslinux.nds - For WMB.


Download and extract [http://kineox.free.fr/DS/dslinux-dldi.tgz dslinux-dldi.tgz] to a folder called linux in the root of your card.
There is also the gbamp-ext2 build, which uses an ext2 partition as root filesystem.
* dslinux-gbamp-ext2.tgz - For GBA Movie Player, uses an ext2 partition.


For best use, use DSLinux with a Slot2 expansion pack.  
More details is availble [http://www.dslinux.org/wiki/RunningDSLinux.html here]. For best use, use DSLinux with a Slot2 expansion pack.


==User guide==
==User guide==
In order to trick DS into booting unofficial code, it requires either having FlashMe installed or more commonly some kind of device in Slot-1. In addition to a way to boot homebrew, you also need an add-on device to store homebrew programs on. There are several different devices that allow you to do this. They can be divided into two categories: Slot-1 devices and Slot-2.  
===Login and usage===
Some versions will prompt for a login, where the default username is root and password is uClinux (case-sensitive).  


'''Slot-1 Devices:'''
When you have logged in successfully, DSLinux will open up a shell.


Slot-1 devices go into the DS game slot.
A shell is a command interpreter. It displays a prompt (#) and a blinking cursor. You can type a command, and when you hit return, the command will execute.  


They have been appearing on the market since December 2006. Typically, these devices include an integrated NoPass and some kind of storage in the form of a removable MicroSD or fixed flash memory, making them 'all-in-one' solutions for running homebrew.
The command may produce output on the screen. Or the command may not produce output at all, but do something else instead, like deleting a file, for example.


Whilst popular, Slot-1 cannot provide extra RAM that DSLinux needs for lots of its features. Therefore, a Slot-2 RAM extension such as the one supplied with the Opera DS browser is recommended if you want to run DSLinux with a Slot-1 device.
Please see the [http://www.dslinux.org/wiki/UsingDSLinux.html official documentation] of the list of available features and commands.


'''Slot-2 devices:'''
===Games===
The following games are available in DSLinux, simply type the name of the game and press enter to launch.
* advent4 Colossal Cave Adventure! A text based game that is really fun.
* bs Battleship - Information on how to play it is included in the game.
* dungeon - Yet another text adventure.
* hanoi Towers of Hanoi - A game where you must move the stacked disks from one pole to another in order of size, largest to smallest.
* knight KnightSMove - a logical solitaire Some version of solitaire. Instructions are in game.
* blue Another solitaire game. Refer to the in-game instructions for help.
* sudoku - It was all the rage last year
* snake - Grab the money and escape before the snake eats you
* fish - Play "GO FISH!" with your DS
* tetris - The old classic that everybody knows
* hangman - spell out the word before you get hanged!
* boggle - Find words hidden in the random letters.


Slot-2 devices go into the GBA game slot. To allow the DS to run code from Slot-2 you'll need either some kind of NoPass in Slot-1 or FlashMe installed.
==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/dslinux2.png


Some Slot-2 devices provide extra RAM, allowing DSLinux to run more sophisticated programs.
https://dlhb.gamebrew.org/dshomebrew/dslinux3.png
 
'''DSLinux device support:'''
 
DSLinux supports devices via the DLDI interface, so if a DLDI driver is available for a device it should be supported. Most devices now support DLDI autopatching in the latest firmwares.  
 
Log in with the login 'root' and the password 'uClinux' *case-sensitive*.  


==Compatibility==  
==Compatibility==  
Line 60: Line 75:


==Known issues==
==Known issues==
Does NOT work on emulators (Tested on no$gba)
Use on emulators is not entirely supported.


Both of the graphical browsers are very buggy at the moment. Flash and javascript are not supported.
Both of the graphical browsers are very buggy at the moment. Flash and javascript are not supported.


==Changelog==
==Changelog==
*Changes since the last build
'''revision 2428'''
Restored 'lib/audiofile/src/audiofile.spec'
* Restored 'lib/audiofile/src/audiofile.spec'
Restored 'user/games/noiz2sa/src/bulletml/tinyxml/xmltest'
* Restored 'user/games/noiz2sa/src/bulletml/tinyxml/xmltest'
Restored 'user/esd/src/esddsp'
* Restored 'user/esd/src/esddsp'
Restored 'user/esd/src/esound.spec'
* Restored 'user/esd/src/esound.spec'
Restored 'user/bzip2/src/manual.html'
* Restored 'user/bzip2/src/manual.html'
Restored 'user/bzip2/src/manual.ps'
* Restored 'user/bzip2/src/manual.ps'
Restored 'user/bzip2/src/manual.pdf'
* Restored 'user/bzip2/src/manual.pdf'
Restored 'user/mc/src/intl/libintl.h'
* Restored 'user/mc/src/intl/libintl.h'
A    user/fbview/pixmap.c
* A    user/fbview/pixmap.c
A    user/fbview/pixmap.h
* A    user/fbview/pixmap.h
A    user/fbview/ds_bmp.c
* A    user/fbview/ds_bmp.c
A    user/fbview/ds_bmp.h
* A    user/fbview/ds_bmp.h
A    user/fbview/ds_gpm.c
* A    user/fbview/ds_gpm.c
A    user/fbview/ds_jpeg.c  
* A    user/fbview/ds_jpeg.c  
A    user/fbview/ds_gpm.h
* A    user/fbview/ds_gpm.h
A    user/fbview/ds_jpeg.h
* A    user/fbview/ds_jpeg.h
*Updated to revision 2428.


==Credits==
==Credits==
See all the contributors [http://www.dslinux.org/wiki/moin.cgi/ContactingDevelopers here].
See all the contributors [http://www.dslinux.org/wiki/moin.cgi/ContactingDevelopers here].


<br>
==External links==
* Official website - http://www.dslinux.org
 
[[Category:DS homebrew applications]]
[[Category:DS homebrew applications]]
[[Category:Operating systems on DS]]
[[Category:Operating systems on DS]]

Revision as of 07:13, 5 September 2021

DSLinux
File:Dslinuxlogin.jpg
General
Author(s)DSLinux team
TypeOperating system
Version2010
LicenceGPL, LGPL, or BSD
Links
Download
Website
Source
Advertisements

<htmlet>adsense</htmlet>


DS Linux is a port of the Linux operating system to the Nintendo DS. DSLinux works on real hardware and was maintained until sometime in 2010. Since Apr 28 2007, RAM build is integrated in the DLDI build.

Features

  • Web browsing: DSLinux features 2 text mode browsers, links and retawq. For graphical browsers you can use the graphical mode of links or the web browser in PIXIL.
  • SSH: You can use it as a handheld wireless ssh/telnet terminal or ssh in remotely from your PC.
  • FTP/WWW: You can use it to download from FTP/WWW sites using the aforementioned web browsers or the ncftp client. You can also use your DS as a FTP/WWW server using ftpd and boa.
  • Games: You can play various text based games, including frotz. GPF has also ported xrick.
  • IRC: You can use irssi to chat on irc networks.
  • MP3/MOD: You can use madplay to play mp3's or use xmp to play modules whilst doing other tasks. You can also use EsounD and MPD to listen to mp3's remotely.
  • File management and editing: Along with the usual basic file operations you can also unzip, untar, gunzip, bunzip and dldi patch files. You can also edit files using Vi, nano and hexedit.
  • Mail: You can use nail to read and send POP3/IMAP emails. Most web based emails such as Hotmail and GMail can be accessed using the text mode browsers.
  • Spreadsheet: You can create spreadsheets using sc.

Installation

Multiple builds are available, for the following 3 builds, you must extract the linux directory in the root directory of your card.

  • dslinux-dldi.tgz - For many devices, including Supercard and M3 with RAM support (requires DLDI).
  • dslinux-gbamp.tgz - For GBA Movie Player.
  • dslinux-dsmem.tgz - For Amadeus' Memory Extension.

Alternaitvely you can use the single file build.

  • dslinux.ds.gba - For GBA flash, G6.
  • dslinux.nds - For WMB.

There is also the gbamp-ext2 build, which uses an ext2 partition as root filesystem.

  • dslinux-gbamp-ext2.tgz - For GBA Movie Player, uses an ext2 partition.

More details is availble here. For best use, use DSLinux with a Slot2 expansion pack.

User guide

Login and usage

Some versions will prompt for a login, where the default username is root and password is uClinux (case-sensitive).

When you have logged in successfully, DSLinux will open up a shell.

A shell is a command interpreter. It displays a prompt (#) and a blinking cursor. You can type a command, and when you hit return, the command will execute.

The command may produce output on the screen. Or the command may not produce output at all, but do something else instead, like deleting a file, for example.

Please see the official documentation of the list of available features and commands.

Games

The following games are available in DSLinux, simply type the name of the game and press enter to launch.

  • advent4 Colossal Cave Adventure! A text based game that is really fun.
  • bs Battleship - Information on how to play it is included in the game.
  • dungeon - Yet another text adventure.
  • hanoi Towers of Hanoi - A game where you must move the stacked disks from one pole to another in order of size, largest to smallest.
  • knight KnightSMove - a logical solitaire Some version of solitaire. Instructions are in game.
  • blue Another solitaire game. Refer to the in-game instructions for help.
  • sudoku - It was all the rage last year
  • snake - Grab the money and escape before the snake eats you
  • fish - Play "GO FISH!" with your DS
  • tetris - The old classic that everybody knows
  • hangman - spell out the word before you get hanged!
  • boggle - Find words hidden in the random letters.

Screenshots

dslinux2.png

dslinux3.png

Compatibility

Hardware known to be compatible with DSLinux.

Known issues

Use on emulators is not entirely supported.

Both of the graphical browsers are very buggy at the moment. Flash and javascript are not supported.

Changelog

revision 2428

  • Restored 'lib/audiofile/src/audiofile.spec'
  • Restored 'user/games/noiz2sa/src/bulletml/tinyxml/xmltest'
  • Restored 'user/esd/src/esddsp'
  • Restored 'user/esd/src/esound.spec'
  • Restored 'user/bzip2/src/manual.html'
  • Restored 'user/bzip2/src/manual.ps'
  • Restored 'user/bzip2/src/manual.pdf'
  • Restored 'user/mc/src/intl/libintl.h'
  • A user/fbview/pixmap.c
  • A user/fbview/pixmap.h
  • A user/fbview/ds_bmp.c
  • A user/fbview/ds_bmp.h
  • A user/fbview/ds_gpm.c
  • A user/fbview/ds_jpeg.c
  • A user/fbview/ds_gpm.h
  • A user/fbview/ds_jpeg.h

Credits

See all the contributors here.

External links

Advertising: