Article # 40, added by Geoworks, historical record
| first | previous | index | next | last |

How to connect Swat to an actual OmniGo device.




Question:
How can I debug my application on an actual OmniGo device?

Answer:
There is a batch file called ss1 which will start the Swat stub at
9600 baud. You can start the Swat stub in one of two ways:

   1. Remove "geos" from the last line of the OmniGo's autoexec.bat file.
      Rebooting with the new autoexec file will land you at the DOS prompt
      (which is hidden behind the splash screen). From here you can
      type "ss1" to launch the Swat stub or "geos" to continue the
      OmniGo's normal startup.

or

   2. To start the Swat stub during OmniGo startup:
	1) Reboot the OmniGo by pressing SHIFT-ON-NEXT keys.

	2) Hold down the 'c' key until a dialog box comes up. It will
           ask "Discard all data?"

	3) Press 'n' (to keep data).  

	4) Wait about three seconds.

	5) Hit CTRL-C. This will break out of autoexec.bat. The splash
           screen is still up (and will be throughout the DOS session).
           Type 'y' to cancel execution of the autoexec.bat process.

	6) Type the following:
		mcb
		cd geoworks
		ss1
	   This will put you in b:\geoworks and run ss1.

   The only catch is, on boot-up, the power driver will turn off the
   on-board serial port to save power. To get around this, after you
   attach with Swat, you need to do the following:

   1. Hit CTRL-C to halt Swat right after the line:
      Looking for "geos    kern"...C:/OMNIGO/LIBRARY/KERNEL/OMNI100.SYM

   2. In DOS or whatever File Manager you're using, delete the file
      \OMNIGO\DRIVER\POWER\JEDI\JPWR.GYM
      Make a copy of
      \OMNIGO\DRIVER\POWER\JEDI\JPWR.SYM and name it JPWR.GYM.
      You'll only have to do this step once.

   3. Type "spawn jpwr".

   4. Type "continue".

   5. When Swat halts in jpwr, type "assign serialPowerStatus 3" and
      then "continue".

   This will cause the power driver to leave the serial port on, and
   therefore you can continue to debug.

Another thing you can try is downloading the "OmniGo DOS Mode" text
driver by Jan Sedlak. Although this is not a Geoworks supported
program, it does make debugging on the OmniGo significantly easier.
Here are the basic steps:

  1. Find the DOS text mode driver by Jan Sedlak (or an equivalent one).
     You can get one from my web site, in the Software page. Use your
     web browser to go to http://members.aol.com/nfiedler/
  2. Use Geoworks Installer to install the DOS text mode driver on your
     OmniGo. Installer is now known as Install Manager. You can find
     Installer at http://members.aol.com/nfiedler/software.html
  3. Reboot the OmniGo using the SHIFT-ON-NEXT keys.
  4. At the DOS prompt, perform step 6 of the procedure outlined above.
     Don't forget you'll have to deal with JPWR as mentioned above.

When you need to enter GEOS from the DOS prompt, type "geos".