*** *** Readme file for the Adaptoid driver, ver 1.00 beta. *** 1. Installation Instructions ---------------------------- The driver file NA1_100B.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,003 12-29-99 8:16p This file sample.c 5,695 12-29-99 1:49a API sample source file sample.exe 30,720 12-29-99 1:49a API sample executable wishna1.sys 15,008 12-29-99 8:15p Kernel driver wishna1.inf 7,422 12-28-99 7:53p Installation script wishna1f.dll 8,704 12-29-99 7:16p Force feedback driver wishna1m.dll 97,792 12-29-99 7:17a Mempak filesystem driver To install this driver: a) Insert a blank floppy in the A: drive. b) Run NA1_100B.EXE and click the unzip button. This will create the driver floppy. c) Plug the Adaptoid into a USB port d) An "Add New Hardware" wizard should pop up. If it doesn't you probably already have the system drivers installed. To remove the system drivers, follow the instructions below entitled "Removing the system drivers", unplug the Adaptoid from the USB port, wait a few seconds, and plug it back in. You should then see the "Add New Hardware" wizard. e) Click "Next" on the first 2 screens. f) Check the "Floppy disk drives" checkbox and click "Next" on this and the next 2 screens. g) Click "Finish" on the final screen. The drivers are now installed. h) Press F5 to refresh the desktop, and you should see the "Adaptoid" icon which looks like an N64 controller. This icon provides access to the mempak data transfer features. If you are familiar with installing downloaded drivers, you can skip using the floppy and extract the files to a folder on the hard disk instead. Specify a hard disk folder during the USB install process instead of checking the "Floppy disk drives". After installing, you can delete the installation folder from your hard disk if you wish. Removing the system drivers: a) With the Adaptoid plugged in, right click on the "My Computer" icon and select the "properties" menu item. b) Click on the "Device Manager" tab. c) Make sure the "View devices by type" circle is selected. d) Click on the "+" to the left of "Human Interface Device" to expand it. e) Click on "USB Human Interface Device" to select it. f) Click on the "Remove" button to remove the driver, and click "OK" to confirm. g) Close the dialog with the "Close" button. h) You may need to repeat this process for each USB port you have installed the Adaptoid on. Removing the Adaptoid driver: We are in the process of creating an uninstall program so you can remove the beta Adaptoid drivers. In the meantime, if you really need to remove the Adaptoid drivers from your system, follow these steps: a) With the Adaptoid plugged in, go into the Device Manager and remove the Adaptoid (USB) device from the "Sound, video and game controllers" section. You may need to repeat this step for each USB port you have plugged plugged the Adaptoid into. b) Run regedit and remove the following key (this removes the Adaptoid folder and icon): HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/explorer/Desktop/NameSpace/{CCD 67C21-B733-11D3-8527-00A0C99BA19DF) c) Unplug the Adaptoid d) Reboot your computer e) When it reboots, delete the following files (your windows directory name may be different): 1) c:\windows\inf\other\Wish TechnologiesWISHNA1.INF 2) c:\windows\system\wishna1f.dll 3) c:\windows\system\wishna1m.dll 4) c:\windows\system32\drivers\wishna1.sys 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. 4. Limitations -------------- This beta version of the driver has the following limitations: a) If more than one Adaptoid is installed, all force feedback will be sent to the rumble pak in the first Adaptoid. The first Adaptoid is the one in the lowest numbered USB port. b) 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. c) Exporting mempak data to file formats other than .a64 is not supported yet. d) 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. 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, we will disable this workaround on systems which do not require it, which is about 99% of the systems out there. 5. Programming API ------------------ We have included a sample application which demonstrates how to communicate with the Adaptoid programmatically using a simple low level API. This API can be used to interface with the N64 controller including the memory pak and rumble pak without the complexity of DirectInput. The sample application continuously reports the positions of up to 4 controllers. If a rumble pak is installed in any controller, it will rumble when that controller's "A" button is pressed. Press any key on the keyboard to exit the application. The C source for this sample application is in the file sample.c, and a compiled version is sample.exe. 6. 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.