SETUPInstructional *.Pdf as found in Software Package.KeyWiz Uploader 2 TM
Software Reference
Copyright 2007, IDVT Inc. / www.GroovyGameGear.com
Advance Release v.90
Installation: If you have properly executed the install program, you should have a folder with the "KeyWiz_Uploader2" executable and another under that one called "config". The config folder will contain the profiles used by the software. Do not manually modify any files in these folders. You may create shortcuts to the executable, so long as the starting folder is the one containing the executable.
Startup: If your KeyWiz has a keyboard switch, make sure the switch isn't pointed to your keyboard before running the software. If it is, the software will try to connect 5 times and fail and you'll have to exit and re-start the software. If you do not have a keyboard switch, just make sure the KeyWiz is connected and run the software. If connection fails, you may click on the wizard character and another attempt will be made.
Profile Uploading: The first thing the software will do attempt to verify that the KeyWiz hardware is present. All functions are disabled until the status window says "KeyWiz Ready". If connection fails, you may click on the wizard character and another attempt will be made.
After connection has been made, you can select a profile button. Letting the cursor hover over any of the profile buttons will show you the name of that profile. Click on any of the profile buttons and you will see a RED letter for that profile appear in the window to the right of the action buttons. Click on the radio button under "Configuration to be active after upload" to reflect the state you want the KeyWiz to be left in after the upload. Pressing the "Upload" action button will upload the selected profile to the KeyWiz. If it gets interrupted, it will try again until it finishes and the letter in the window will turn GREEN. It is recommended that you don't disturb the PC while the profile is being uploaded to KeyWiz. When your profile has been uploaded, click the "Exit" button to exit the software.
Diagnostic Feature: From the main screen, you may check for proper operation of your controls by simply activating them. The screen will show (in a rather interesting way) the key that the system is receiving. If more than one input is activated, the screen will simply show "Multiple." This is an indicator of a problem if only one input is being activated. Likewise, if you are attempting to activate an input and the screen shows no inputs activated, this is also a problem indicator. The only current exception to the above is the input assigned to the "TAB" key. This key is ignored in this version of the software.
Profile Editing: Click on any of the profile buttons and you will see a RED letter for that profile appear in the window to the right of the action buttons.
Click on the "Edit" action button and you'll see the Profile Editor. The first thing you'll probably want to do is change the "Profile Name". Click on that window and you'll notice the background will start blinking. Use the on-screen keyboard to enter a profile name up to 15 characters in length. Only alpha-numerics and "Space" will be accepted. The software prevents you from using anything else.
The next step is to click on any of boxes associated with the inputs on theKeyWiz, including their Shazaaam! key counterparts. These are on the upper portion of the screen. After clicking on the input you wish to change, you will see its box begin to blink.You can then click on a key on the on-screen keyboard to assign that key to the input. Repeat this step until all the inputs are set the way you want them.
Then click on the "Save" button to save your changes to that profile. Or, click "Cancel". If you clicked on "Save", a file requestor will pop up and ask what application or "KeyWiz Link" file you would like to associate with the profile you just edited. Navigate to the application or .kwl file you want to associate with that profile and click "OK". If you want to keep the current file, click "Keep Current" and if you don't want an executable assigned to the profile, click the button that states that.
You will then return to the main screen. If you want to use the profile you just modified, you would upload it at this point.
Launching Programs: Click on any of the profile buttons and you will see a RED letter for that profile appear in the window to the right of the action buttons. If there is an executable associated with the profile you just clicked, you can click on the "Launch" action button. This will automatically change the "Configuration After Upload" radio button to the Custom set, upload the profile, exit the KeyWiz software and boot the associated executable.
A note about .lnk files: These are also known as "shortcut" files and some of these can be launched under 98se and some cannot. 2K/XP does not allow these to be launched from the KeyWiz software at all, and therefore the option to select these has been removed when the software is run from these OS's. The only advantage to using .lnk files is the ability to launch a file with command line parameters. This has been remedied in the KeyWiz software through the use of"KeyWiz Link" files. These will be explained in a later section.
Startup Options: The startup options are new for version 2.0 and make it much simpler to automate the hardware configuration. They are as follows:
- The Stealth option will prevent the software from showing the main screen with the wizard animation while uploading the keycodes to the unit. It will, however, show the upload progress in theWindows menu bar (if visible) and will use a standard pop-up to inform you of any problems during the process. The software will allow selection of the Stealth option only when either the "E-EEPROM" or "Default Set" is selected.
- aka the "Virtual EEPROM Feature" - This option allows your KeyWiz to act exactly as though it used onboard EEPROM storage for the codeset when used in conjunction with the KeyWiz Uploader 2 software. That is to say that every time you upload a set of data to the KeyWiz, it is remembered by the system. The next time the system is started, the same data is uploaded so the unit is always configured as you last left it, even between re-boots of the system. This option can be selected at any time.
- The "Default Set" option allows a specific set to be persistent. This will allow the KeyWiz to always be configured to a specific, user defined state between re-boots of the system, regardless of what a user may have uploaded to the unit during the previous session. The Default Set is selected by first selecting a profile and then choosing the "Default Set" Option. The current Default Set is indicated by a letter to the right of the selection indicator. To change the Default Set once one is already selected, you must first click on the Default Set option to disable it, and then make a new selection.
It is important to note that the /L or "Launch" command is assumed for all automatic startup options. If a profile has an executable associated with it, and it is used for automatic operation, it
will be launched after upload. If this is not desirable, create an identical profile, omitting the launch executable, and use it instead.
Command line switches are as follows:
/A - Automode. Fully automatic operation and exiting of program. Without this switch, no
other switches are active.
/P - Profile to use
/L - Launch. This switch will launch the executable associated with the selected profile (if it
exists) immediately after the profile is uploaded.
/S - Stealth. This will activate the Stealth startup option as described earlier.
Examples of use: (NOTE These methods are for demonstration purposes only. These functions are now performed automatically by the “startup options” described earlier)
Create a shortcut to the KeyWiz Software.
Add /A to the end of the command line in the Shortcut's properties.
Apply the change and then drag it into your startup folder.
Create a shortcut to the KeyWiz Software.
Add /A /P to the end of the command line in the Shortcut's
properties.
Apply the change and then drag it into your startup folder.
To make the software automatically upload a selected profile to the KeyWiz and launch into the associated application:
Create a shortcut to theKeyWiz Software.
Add /A /L /P to the end of the command line in the Shortcut's
properties.
Apply the change and then drag it into your startup folder.
Note: Any of the shortcuts created in the above examples can also be left on the desktop, and the
same functions will be performed by simply double-clicking on them.
KeyWiz Link Files: (.kwl)
Sometimes you will want the KeyWiz software to launch applications that require command line
options to work properly. To do this, you will need to useKeyWiz Link files. A KeyWiz Link file is a standard text file which has the complete path and filename of the application you want to launch, as well as any command line parameters, encased in quotes and residing on the first line of the .kwl file.
Example: Run a standard text editor
On the first line, you would type something like "c:\MyFolder\Myfile.exe /myparameters" including the quotes.
Then you would save the file as something like MyApp.kwl
Since the KeyWiz software recognizes .kwl files as applications, you can select these to be launched like any other application.
The information inside the .kwl file is read and executed at launch time.
Differences between 98 and 2K/XP:
The major difference is speed. Due to OS constraints, a different upload method is used when the
software is run on 2K/XP machines than with 98 se machines. Due to the use of updated methods of data transfer, the speed is now very fast on any system. However,the 2K/XP upload times are still about 2 times as long as on a 98se machine. 98 se has limited support for launching "shortcut" files and 2K/XP has none. Limited support means some work and some don't depending on the application the shortcut is pointing to. The best way to use the software is to launch the actual executable files, or use the .kwl files in cases where command line arguments are necessary.
Special thanks to Mike Quinlan for his efforts in helping to accelerate the profile uploads under 2K/XP. And a thank you to all current KeyWiz users who have helped to made the product the success that it has become and who ensure that we can continue to provide improvements like those contained in this software.
Main Screen, once KeyWiz has been booted. Note: KeyWiz Ready and Green Bar indicates the PC is communicating with the KeyWiz.
Assigning Keys Example in this case one of my red buttons has been assigned to position A.
Quick directional check, to ensure the North Vertice of the Joystick is communicating as "UP"
READ MORE - KeyWiz Software
