DSLinux: Difference between revisions

From GameBrew
No edit summary
m (Text replacement - "Category:DS homebrew applications" to "")
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox homebrew
{{Infobox DS Homebrews
| title       = DSLinux
|title=DSLinux
| image       = [[File:Dslinuxlogin.jpg]]
|image=Dslinux2.png
| type       = Operating system
|description=Port of Linux to the Nintendo DS handheld device.
| version     =  
|author=DSLinux team
| licence    = Free and open source software
|lastupdated=2013/06/21
| author      = DSLinux team
|type=Operating systems
| website    = http://www.dslinux.org/
|version=2010
| download    = http://kineox.free.fr/DS/
|license=GPL, LGPL, or BSD
| source     = http://forums.steampowered.com/forums/forumdisplay.php?f=45
|download=https://dlhb.gamebrew.org/dshomebrew/dslinux.7z?k33p0fil35
|website=http://www.dslinux.org
|source=http://dslinux.gits.kiev.ua/trunk
}}
}}
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.


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 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.


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.  
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.


*Slot-1 Devices
More details can be found [http://www.dslinux.org/wiki/RunningDSLinux.html here]. For best use, use DSLinux with a Slot2 expansion pack.
Slot-1 devices go into the DS game slot.


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.
==User guide==
===Login and usage===
Some versions will prompt for a login, where the default username is root and password is uClinux (case-sensitive).  


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.
When you have logged in successfully, DSLinux will open up a shell.


*Slot-2 devices
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.  
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.


Some Slot-2 devices provide extra RAM, allowing DSLinux to run more sophisticated programs.  
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.


*DSLinux device support
Please see the [http://www.dslinux.org/wiki/UsingDSLinux.html official documentation] of the list of available features and commands.


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.  
===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.


==Features==
==Controls==
*Text-only web browser, text writer.  
D-Pad - Cursor keys (up/down/left/right)
 
A  - Return
 
B - Space
 
X - Page up
 
Y - Page down
 
L - Shift
 
R - Ctrl
 
L+X/Y - Scroll up/down through the buffer
 
'''Note:''' The K in the upper right corner of the soft keyboard switches to M when pressed and back to K when pressed again. That means switching between keyboard and mouse mode.
 
==Screenshots==
https://dlhb.gamebrew.org/dshomebrew/dslinux2.png
https://dlhb.gamebrew.org/dshomebrew/dslinux3.png


==Compatibility==  
==Compatibility==  
[http://www.dslinux.org/wiki/moin.cgi/ComparisonOfHomebrewHardware Hardware known to be compatible with DSLinux]
[http://www.dslinux.org/wiki/moin.cgi/ComparisonOfHomebrewHardware Hardware known to be compatible with DSLinux.]
 
==Known issues==
Use on emulators is not entirely supported.


==Installation==
Both of the graphical browsers are very buggy at the moment. Flash and javascript are not supported.
#Download [http://kineox.free.fr/DS/dslinux.nds dslinux.nds] to the 'apps' folder of your card
#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


For best use, use DSLinux with a Slot2 expansion pack.  
If you do not have a RAM extension you may experience crashes and out of memory errors when running most of the applications.


==User guide==
==Changelog==
Log in with the login 'root' and the password 'uClinux' *case-sensitive*.  
'''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 [http://www.dslinux.org/wiki/ContactingDevelopers.html here].


==Known Issues==
==External links==
Does NOT work on emulators (Tested on no$gba)
* Official website - http://www.dslinux.org
* Official website - http://kineox.free.fr/DS


==Changelog==
*Changes since the last build
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
*Updated to revision 2428.


[[Category:Homebrew applications]]
[[Category:Operating systems on DS]]

Latest revision as of 07:07, 1 May 2024

DSLinux
Dslinux2.png
General
AuthorDSLinux team
TypeOperating systems
Version2010
LicenseGPL, LGPL, or BSD
Last Updated2013/06/21
Links
Download
Website
Source

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 can be found 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.

Controls

D-Pad - Cursor keys (up/down/left/right)

A - Return

B - Space

X - Page up

Y - Page down

L - Shift

R - Ctrl

L+X/Y - Scroll up/down through the buffer

Note: The K in the upper right corner of the soft keyboard switches to M when pressed and back to K when pressed again. That means switching between keyboard and mouse mode.

Screenshots

dslinux2.pngdslinux3.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.

If you do not have a RAM extension you may experience crashes and out of memory errors when running most of the applications.

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: