*** *** Readme file for the Adaptoid driver, ver 1.1.63 (beta). *** 1. Installation Instructions ---------------------------- The driver file NA1_1163B.EXE is a self-extracting zip archive which will extract to the A: floppy drive by default. It extracts the following files: _readme.txt 9,566 5-07-00 1:24p This file butord.exe 32,256 5-05-00 6:39p Button Order utility setup.exe 44,544 5-07-00 11:26a Driver Installer test.exe 32,768 5-05-00 1:17p Rumble test program testdx.exe 43,008 5-05-00 3:16a DirectX test program wishna1.inf 10,265 5-07-00 11:26p Installation script wishna1.sys 18,624 5-07-00 11:27p Kernel driver wishna1f.dll 10,240 5-07-00 11:28p Force feedback driver wishna1m.dll 100,352 5-07-00 11:29p Mempak filesystem driver To install this driver: a) Insert a blank formatted floppy in the A: drive. b) Run NA1_1163B.EXE and click the unzip button. This will create the driver floppy. c) Run the setup.exe driver installer from the floppy. (Start | Run | a:\setup.exe) d) Click the "Install" button. e) Plug the Adaptoid into a USB port. It will automatically install itself. f) Click the "Exit" button. If you don't want to create a driver floppy, you can extract the archive to a hard disk folder instead and run the setup.exe from there. You can run the driver installer before, during, or after you plug in the Adaptoid. If you plug in the Adaptoid before running the driver installer, you may see a driver installation wizard pop up. Just cancel out of this wizard and run the driver installer program. To remove this driver: Run the setup.exe driver installer program. Click on "Uninstall". To remove just the mempak driver (and the Adaptoid icon on the desktop) but leave the rumble driver installed: In the control panel, select "Add/Remove programs" and remove the entry with the description "Adaptoid Desktop Icon (Mempak Driver)". 2. Force Feedback support ------------------------- To enable force feedback in a DirectX game which offers it, just plug a rumble pack into your N64 controller before starting the game. The Adaptoid force feedback driver should be detected automatically by the game. Some games may require that force feedback be enabled via a menu item in the game, or require you to enable or set up a joystick using a configuration menu in the game. Since force feedback commands used by DirectX games usually describe force feedback on the joystick itself, the driver translates these commands into ones suitable for a rumble pack. For this reason, the rumble effects may not be exactly what the game designers intended. If you find any game which produces particularly bad rumble effects, please let us know at support@wishtech.com and we'll see if we can improve it in our next driver release. 3. Mempack Data Transfer ------------------------ Memory paks are used to store data used by N64 games. The Adaptoid allows you to transfer this data to and from your computer. This is useful for backing up this data, archiving important game saves, sending game saves to your friends, or downloading game saves from the internet to help you through a tough part of a game. The way the Adaptoid gives you access to this mempak data is by extending the filesystem on your computer to include files that are on a mempak which is plugged into a N64 controller, which is plugged into an Adaptoid, which is plugged into a USB port on your computer. The mempak files are located in a special Adaptoid folder which exists on your desktop, similar to the "My Computer" folder or the recycle bin folder. This folder can be opened in either an explorer window or a folder window. The easiest way to get to the mempak files is to double click on the Adaptoid icon on your desktop. This will open a window which shows what files are on your Memory Pak. You can drag these files from the Adaptoid folder onto your desktop or into another folder, and you can drag these files back into the Adaptoid folder at a later time to restore them. To delete files from a Memory Pak, select them in the Adaptoid explorer window and press the "Del" key to delete them. You will be prompted to confirm deletion of each file. When you drag files out of the Adaptoid folder, they are encoded into .a64 files. This file format is a text format which hex-encodes the binary mempak data. This text format allows you to add notes to the file (in the a64-notes section). When you drag an .a64 file back into the Adaptoid folder, the data section in the file is parsed out and decoded before copying it back to the Memory Pak. Any text preceding or following the a64-data section is ignored. You can also import other memory pak file formats by dragging the file into the Adaptoid folder. Formats supported for importing are 32768 byte raw binary files, and 36928 byte .n64 files. There is no method provided for exporting to other data formats in this beta version. Before a brand new mempak can be used it must be formatted by a N64 console. To do this, insert the mempak and power up a game which uses the mempak while holding down the "Start" button. This will launch the mempak manager, and will automatically format the mempak if it isn't already formatted. 4. Button Order --------------- The default order of the controller buttons reported by the Adaptoid is: A, C-down, C-right, B, C-left, C-up, Left, Right, Start, Z, D-up, D-down, D-left, D-right This button order is similar to that used by the majority of gamepads, and provides the best compatability with existing PC games. If you wish to change this button order, you can use the supplied "butord" command-line utility program to select a different order. Button order changes are temporary and will be reset to the default order when the computer is rebooted. Run the "butord" utility program from a DOS box and it will give usage instructions and show the current button order. The button names are 1 or 2 letter abbreviations, with CU/CD/CL/CR meaning the yellow "C" buttons (up,down,left,right), and DU/DD/DL/DR meaning the gray directional pad (up,down, left,right). 5. Limitations -------------- This beta version of the driver has the following limitations: a) If more that one Adaptoid is installed, the Adaptoid folder will show only the contents of a mempak in the first Adaptoid. The first Adaptoid is the one in the lowest numbered USB port. b) Exporting mempak data to file formats other than .a64 is not supported yet. c) Sometimes when you drag a file into the Adaptoid folder, the file is opened as a text file in an Explorer window instead of transferring it to the memory pak. To get Explorer to stop doing this, close the window and re-open it from the Adaptoid icon. d) You cannot transfer game saves to or from a mempak by using a single explorer window. You must open two windows and drag/drop between them, or drag/drop between one window and the desktop. e) Writing to mempaks is somewhat slow in this beta version, requiring up to 30 seconds to write a 123-page file. Reading is considerably faster. The slow writing is due to a workaround for a bug in certain USB host controllers which caused system lockups in certain cases. In a future release, this workaround will be disabled on systems which do not require it, which is about 99% of the systems out there. 6. Programming API ------------------ A SDK is available which describes how to programmaticaly communicate with the Adaptoid and includes some sample programs with source code. This SDK can be downloaded from www.wishtech.com/drivers/sdk_101b.zip 7. Change Log -------------- Rev 1.1.63 - 5/7/00 * Fixed bug in device detection process (doh!) Rev 1.1.59 - 5/5/00 * New driver installer application * Added support for Win2000 * Added support for force feedback on multiple Adaptoids simultaneously * Added communication timing workaround to get Arcade Shark joystick working (controls only... no mempak or rumble pack support for this joystick) * Fixed problem in mempak driver regarding game save name corruption when transferring saves from hard disk to mempak that have an extension as part of the name. * Fixed incorrect detection of some 3rd party memory paks as rumble paks * Added DirectInput escapes for SDK * Enabled octagonal-rectangular mapping transformation when using rumble driver * Fixed bug in DirectX force feedback where rumble effects were not being stopped when they should * Added capability to remove desktop icon & mempak driver from within Add/Remove programs control panel (leaves rumble driver installed) * Gave proper names to buttons for DirectX * Added capability to rearrange the order of the controller buttons via a command line utility program. Altered button arrangement persists until a reboot occurs. Rev 1.0.0 - 12/29/99 * Initial release 8. Legal Stuff -------------- The Adaptoid is a product of Wish Technologies, Inc., and is not manufactured, distributed or endorsed by Nintendo of America Inc. N64 and Nintendo are trademarks of Nintendo of America Inc.