SuperWaba Virtual Machine - Runtime Environment

This document describes the installation procedure of SuperWaba for end users. Developer should download another package from http://www.SuperWaba.org . The Runtime Environment can be downloaded at http://www.SuperWaba.org/install .

GENERAL REQUIREMENTS

SuperWaba runs on most PDAs with PalmOS and most Windows CE/PocketPC models with WinCE^? 2.11 and higher. SuperWaba as of version 3.5 is known NOT to run on the following devices:

• Visor (with PalmOS 3.1H1)
• Sony NR70 Japanese Version

PalmOS INSTALLATION

Download and install the following files:

• For Palm OS < 5
  Download the file PalmOS2_3_4.zip
  Install at least the following files on your Palm:
  • SuperWaba.prc
  • SWNatives.prc
  • SuperWaba.pdb

• For Palm OS >= 5 and devices that has at least Palm OS 4.0 and works only in 16 bits per pixel screens
  (Kyocera 7135, Tungsten C, Tungsten W)
  ­ Download file PalmOS_5_or_4_with_16bits_screen.zip Install at least the following files on your Palm:
  • SuperWaba.prc
  • SWNatives.prc
  • SuperWaba.pdb

• For Zire 71 device and others that may reset alone (the device reboots alone)
  Download file PALMOS_AutoReset.zip Install at least the following files on you Palm:
  • SuperWaba.prc
  • SWNatives.prc
  • SuperWaba.pdb

After this installation-process you should see a new program called SuperWaba on your Palm. Launching this program will give you a welcome screen of SuperWaba and you know that the installation of SuperWaba succeeded. The other files coming with SuperWaba are additional libraries which might be used by applications. You should install those only when mentioned by an application you intent to install. Some SuperWaba examples included in the SDK require them, so don't forget to check the SuperWaba.pdf file (included in the SDK).

As of 4.1, SuperWaba will work on Alphasmart Dana devices with a 1.2 ROM fitted. To find out the ROM version of your Dana go to the Apps menu then: Press Cmd-I, select Version, press Function-I.

General Installation of Programs which use SuperWaba under PalmOS

Each program which uses SuperWaba consists of at least two files:

• PROGRAM.prc
• PROGRAM.pdb

where PROGRAM is the name of the program to be installed. Several programs come with additional .pdb or .prc files, and might require the installation of some of SuperWaba's additional libraries, as stated in the program's documentation.

Windows CE / Pocket PC INSTALLATION

Find out version the platform and processor your handheld is using. Possible platforms are HPC211, PPC211 and PocketPC; possible processors are MIPS, SH3 and ARM. Open Internet Explorer from within your handheld, choose this page and download the zip file with the correct platform_processor combination.

• SuperWaba.PLATFORM_PROCESSOR.cab

After this installation-process you should see a new program called SuperWaba on your PDA. Launching this program will give you a welcome screen of SuperWaba and you now that the installation of SuperWaba succeeded. The other files coming with SuperWaba are additional libraries which might be used by applications. You should install those only when mentioned by an application you intent to install. Some SuperWaba examples included in the SDK require them, so don't forget to check the SuperWaba.pdf file (included in the SDK).

Windows 98 / ME / NT / 2000 / XP INSTALLATION:

Please download the file win98_and_beyond.zip Expand this file in a folder called c:\SuperWaba (don't expand the folders inside the zip file). You can then click the SuperWaba.exe program to see that the VM is correctly installed. The VM stored in this file lets you test all SuperWaba programs in the Windows 32-bits operating systems. To run a program, you must install it in a folder under the c:\SuperWaba (the same folder you use for the Windows CE / Pocket PC installation).

Maybe I'm missing something, but the above instructions are not correct. If you you do that you'll get the error

   Error: no fonts found. Make sure [H,M,L]SW*.pdb font files are located under SuperWaba default directory.

See /SuperWabaSDK/docs/SuperWaba.pdf for the correct instructions. You'll need to copy files from c:\SuperWabaSDK into a new directory c:\SuperWaba. Also note that you need to download the Palm SDK even if you're just doing Pocket PC development. The WinCE^? SDK download only contains the additional files needed for Pocket PC development. JamshidAfshar^?

General Installation of Programs which use SuperWaba under Windows PDA

Most programs can be installed in the same way SuperWaba has been installed, using a cab file. Download the program, then search for a bat file called PROGRAM_install.bat. Launch it and the installation will start. And don't forget to read the program's documentation.

LICENSE

SuperWaba can be used under the

AMENDED GNU LESSER GENERAL PUBLIC LICENSE
                 GNU LGPL Version 2.1, February 1999
                 Amended, October, 2001

Read the file http://www.superwaba.com.br/etc/license.txt (also included in the SDK).