WabbitDS
  - Created by: James Montelongo
  - Email:      James20@gmail.com
  - Website:    www.revsoft.org

WabbitDS is a TI-83+ emulator for the Nintendo DS.  This project is released under the GNU Public License.  Please include this file if you distribute WabbitDS.

DOCUMENT LAYOUT:

1.  Loading the rom
2.  First time run
3.  Main menu
3.1 Key configuration
3.2 File sending
3.3 Rom loading
3.4 Dissembler
4.  File browser
5.  Default button layout
6.  TODO
7.  Credits
8.  License

USAGE:

Patch WabbitDS.nds with your card's dldi patch.

1.  Loading the rom

Make sure to have a TI-83+ rom some where on you card with the extension "*.rom".  If you own a TI-83+ but are unable to dump a rom from your calculator, you may use TI's OS updates.  These have the extension "*.8xu" and are freely available from TI's website under the condition you own the calculator.

2.  First time run

The first time you run WabbitDS, you will be prompted to select your rom.  Once the rom is loaded, it is converted into a save file (extension "*.tisv").  You no longer need the original rom file since the save file includes all flash memory.  Because of this, you cannot legally distribute save files.  After the first running of the emulator a file called "TIDS.CFG" is written to the default fat device.  It contains the settings for current save state, key configuration, screen rotation, and other info.  Should you wish to have a clean start, you can delete that file to reset all configuration info.

3.  Main menu

Pressing Select while the emulator is running opens the main menu.  There you have access to the options: Key Configuration, File Sending, Rom loading, and Disassembler.  Pressing B or Select exits the main menu.  You may use the D-pad or the touch screen to navigate.

3.1 Key configuration

Key Configuration lets you change which TI keys map to DS buttons A, B, X, Y, Start, and the D-pad.  For now, this is done by scrolling through a list of all of the TI keys.  Press Select to exit back to the emulator or B to return to the main menu.  Pressing Start will set the keys to their Default settings.

3.2 File sending

File Sending lets you send TI varibles to the emulated calculator.  Applications(*.8xk) may occasionally require you to delete old apps of the same name, or reset the ram.  Typically this isn't required.  For linking you must be on TI's Homescreen.

3.3 Rom loading

Rom loading lets you load a new rom, save, or 8xu file.  Do not try loading 8xu or rom files that were not meant for the 83+, it simply won't work.

3.4 Disassembler

Disassembler is a bit buggy and limited but its still functional.   A steps, X steps over, and Y attempts to run to the cursor.  Select exits back to the emulator and B returns to the main menu.

4.  File browser

While in the File browser you may double-tap to open/close folders or to load files.  The D-pad and A button can also be used.  You can drag up or down in whitespace to scroll, or use the scrollbar on the right.  Select exits back to the emulator and B returns to the menu screen.  

5.  Default button layout
 DS        Calc
 --------------
 A . . . . Alpha
 B . . . . 2nd
 X . . . . Mode
 Y . . . . XT0N
 Start . . Enter
 Left. . . Left
 Right . . Right
 Down. . . Down
 Up. . . . Up

 DS        Function
 ------------------
 Select. . Menu
 L . . . . Rewind
 R . . . . Double speed
 R+L . . . Rotate layout (You must press R first)
 Close DS. Sleep and Save

Touchscreen can be used for the rest of the keys as present on the skin.


6.  TODO:
 - Allow multiple files to be selected in the browser and sent.
 - Support external skins


7.  Credits:
 Spencer Putt for his constant critique and code from our PC emulator Wabbitemu.
 DRZ80, written by Reesy, is the z80 core.
 Bootfree included, written by Ben Moody, slightly modified due to bad interaction with DRZ80.
 kusuma for the skin.
 Ramzee for his contribution.


8.  License:
WabbitDS is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
Copyright 2007, James Montelongo
