New Zoomer FAQ Part 2

PDCChrisD@aol.com
Sat, 11 Feb 95 16:27 PST

Zoomer DOS Config & Commands
Here's a list of the commands available for the Zoomer. Please note that=

Datalight provided the ROM-DOS v3.31 which is included in the Zoomer.

For users that are used to using MS-DOS, ROM-DOS is nearly identical. Ke=
ep
in mind that only commands for v3.3 are supported on the Zoomer.

Thanks to the support of Datalight the following information is available=
=2E

Let me know if you find any additional commands that are not documented.

Chris De Herrera
ChrisD16@AOL.COM

Config.sys Commands:
On the following pages configuration commands are listed.

Each command must be on a separate line on the config.sys. The commands =
can
be in upper or lower case. The config.sys and autoexec.bat file must be =
on
the B:\ drive in order to work.

BREAK - Stop program execution
BREAK - Turns on and off the ability to stop program execution at a non-i=
/o
point.

Default: OFF

Ex: BREAK=3DON

Note: This wil not benefit the Zoomer due to it's lack of a keyboard.

BUFFERS - Sets # of internal buffers
BUFFERS - Sets the number of internal data buffers.

Default: 2

Ex: BUFFERS=3D20

Note: The benefit of buffers is minimal insystems that do nothave physica=
l
disk drives.

DEVICE - Allows for new device drivers
DEVICE - Installs a new device driver in6o ROM DOS.

Ex: DEVICE=3DA:SDPCHAR.SYS

FCBS - CPM style file handles
FCBS - Specifies the number of File Control Blocks open at one time.

Default: 4,0

Max: 255

Ex: FCBS=3D10,20

Note: Most dos applications do not use these file handles. These file
handles are for backward compatibility to old dos applications.

FILES - Max # of files open
FILES - Sets the maximum number of files that can be open at one time on =
the
system.

Default: 8

Max: 255

Ex: FILES=3D20 =

LASTDRIVE - Sets last drive available
LASTDRIVE - Sets the maximum number of drives available.

Default: E

Max: Z

Ex: LASTDRIVE=3DF

SHELL - Use a different Command Processor
SHELL - Allows the selection of an alternate command processor other than=
the
default COMMAND.COM. Parameters /P make permanent, /E:size changes
environment size [size in bytes].

Default: The COMMAND.COM must be on the boot device.

Ex: SHELL=3DA:\COMMAND.COM /P

NEWFILE - Chain to Another File
This allows for a second file with config.sys commands to be prodessed.

Ex: NEWFILE=3DMYCONF.SYS

The config.sys is processed until the NEWFILE command, then the myconfig.=
sys
is processed.

Autoexec.bat and Batch Commands:
The following commands are for use in AUTOEXEC.BAT and other batch files.=

CALL - Spawn another batch file
CALL - Invokes execution of a secondary batch file. The original batch f=
ile
will continue after the secondary one is complete.

Ex: CALL TEST.BAT parm1 parm2 ... parm9

CHDIR or CD - Change Directory
CHDIR or CD - Changes the default directory .

Ex: CD B:\GEOWORKS
CD \GEOWORKS\WORLD

CLS - Clear Screen
CLS - Clears the screen.

Ex: CLS

COPY - Copy Files
COPY - Copies files from one drive/directory to another one.

Ex: COPY A:\COMMAND.COM B:\
COPY B:\GEOWORKS\GEOS.INI B:\GEOS.INI

CTTY - Change TeleTYpe
CTTY - Changes the default terminal for interacting with ROM-DOS.

Ex: CTTY COM1:

Note: Currently no devices are known to work with this command.

DATE - Change System Date
DATE - Allows the user to change the date and time.

Ex: DATE 10/1/94

Note: If you do not provide the date as a parameter, the system must be s=
oft
reset because it will be waiting for the user to type the date in on the
prompt. The user will not lose any data, however.

DEL - Delete Files
DEL - Deletes specified files.

Ex: DEL *.* (Delete all files)
DEL B:\TEST.BAT
DEL B:\*.DAT (Delete all .dat files)

Note: Files that are deleted cannot be recovered.

DIR - Display the File Directory
DIR - Lists the contents of a specified directory.

Ex: DIR (Display all files)
DIR *.BAT (Display all .bat files)
DIR A:\

ECHO - Turn Echo on or Off
ECHO - Turns on or off the display of batch commands on the monitor.

Default: Echo is on

Ex: ECHO OFF
ECHO ON

ERASE - Erase Files
ERASE - Same as DEL. See DEL for more details

EXIT - End Spawned Command Processor
EXIT - Ends control of spawned command processor or CALL comand.

Ex: EXIT

Note: You cannot exit from the base command processor.

FOR - Processs a Set of Files
FOR - Performs one DOS command on a set of files.

Ex: FOR [%%variable] IN (*.*) DO [command] [parameters]

Note: The %%variable will contain the single file name to be processed. =
The
IN clause can be adjusted to contain any set of files. the command can b=
e
any command or batch file and the %% variable may be used as a parameter =
to
this command

GOTO - Jump to a label & run commands
GOTO - Moves control to a specified label in the batch file.

Ex: :TEST
ECHO Hello
GOTO TEST
=

Note: The above example will create a loop which can only end with a soft=

reset. Be careful with the Zoomer since it can not issue a control-break=
to
end programs.

IF - Decision Support for Commands
IF - Performs a command based upon a specific condition.

Ex: IF EXIST(A:\COMMAND.COM) ECHO HERE
IF NOT EXIST(A:\COMMAND.COM ECHO THERE

Note: This can be combined with the use of GOTO to create conditional lo=
ops
(while do, do until).

MKDIR or MD - Create a Directory
MKDIR or MD - Creates a directory.

Ex: MKDIR B:\BACKUP
MD B:\REPORTS

Note: This will only create a directory one level below existing
directories.

PATH - Change/Display Path
PATH - Allows the user to change or display the current search path for
executing programs.

Default: Path is not set.

Ex: PATH (displays current path)
PATH B:\UTIL

Note: The longer the path, the slower the Zoomer will operate.

PAUSE - Wait for a Key Press
PAUSE - Causes execution to halt until a key is pressed.

Ex: PAUSE

Note: The Zoomer does not stop and wait for a keystroke prior to continu=
ing.
It does wait about 10 seconds prior to continuing.

PROMPT - Changes Command Prompt
PROMPT - Changes the apearance of the system prompt line.

Ex: PROMPT $P$G
(Display the drive and the directory)

Note: There are many parameters for this command. Please consult your DO=
S
manual for details.

REM - Remark
REM - Identifies non-executing batch lines.

Ex: REM This does nothing

Note: The use of REMs is encouraged to document what the batch file is
doing at critical stages.

REN - Rename a File
REN - Renames one or more files.

Ex: REN TEST.BAT TEMP.BAT

Note: This command can use wildcards (* or ?) as parameters.

RMDIR or RM - Removes a Directory
RMDIR or RM - Delete a specific directory.

Ex: RMDIR B:\TEST
RM B:\DOC

Note: The directory must be empty before it may be removed. Once a
directory is removed, it cannot be recovered.

SET - Set Environment Variables
SET - Sets environment variables and command processor strings.

Ex: SET COMSPEC=3DC:\COMMAND.COM
SET TEMP=3DB:\
SET (Displays all environment variables)

Note: The use of this command may require you to increase the environmen=
t
space. See SHELL.

SHIFT - Shifts Params to the Left
SHIFT - Shifts parameters one to the left.

Ex: TEST.BAT ONE TWO THREE FOUR
SHIFT
(%1=3D TWO, %2=3DTHREE, %3=3DFOUR)

TIME - Change or Display Time
TIME - Displays the current time from the system's internal clock.

Ex: TIME 10:00 (changes time to 10:00 am)
TIME 23:00 (changes time to 11:00 pm)
TIME (displays current time and prompts for a new time)

Note: If you use TIME to display the current time, you must soft reset th=
e
Zoomer in order to recover.

TYPE - Displays File Contents
TYPE - Displays the contents of a text file on the monitor.

Ex: TYPE B:\GEOWORKS\GEOS.INI

Note: You can not stop a long file from being displayed completely.

VER - Displays DOS Version
VER - Displays current version of ROM-DOS. Parameter /R displays the kern=
al
rev and command rev.

Ex: VER
VER /R

kernel rev:1.52-AF
command rev:1.57A

VERIFY - Toggles Verify On or Off
VERIFY - Displays the current VERIFY state or set the VERIFY state on or =
off.

Ex: VERIFY (displays state)
VERIFY ON
VERIFY OFF

Note: Turning VERIFY ON will result in reduced performance since the sys=
tem
must write the data and then read it, thus taking twice as long.

Zoomer Hardware
The following is a description of the Zoomer's hardware. This discussion=
is
very technical. It is drawn from the Tandy Service Manual p/n 25-3100.

THE FOLLOWING IS MY BEST GUESS BASED UPON READING THE SCHEMATICS. PLEASE=
USE
THIS INFORMATION WITH CAUTION!

Major Components:

CPU: NEC V20 equivalent p/n =E6PD 95130GD-5ML. This chip includes the
interrupt controller, timers, infrared, and LCD controller. Also include=
s
memory management unit (similar to EMS). The data bus is 8 bits and the
address bus is 20 bits (1mb address space). Also has a custom timing
generator for all the above components.

Bus Controller: p/n MBCG25173-5104 Controls the Touch Panel, Sound Interf=
ace,
PCMCIA Card Interface, and RS-232 Interface. Also provides real time clo=
ck.

RS-232 Driver: p/n MAX223CAI-T Converts power from 3v to 5v.

Sound DAC: p/n uPD65043GF-U01-3B8 It is an 8 bit DAC known to be drivable=
at
8khz.

PCMCIA Card Interface circuit: This interface only supports 8 bit cards n=
ot
16 bit cards. It is limited to 50 milliaperes and 5 volts. PCMCIA type =
II
cards are supported.

Power: AC adapter 6 volts, collar is positive, battery 4.5 volts.

System Information:

Timers:
0 - IRQ0
1 - IRQ1
2 - IRQ2
3 - Buzzer

Interrupts:
0 - Timer0
1 - Timer1
2 - Timer2
3 - Keypad
4 - Serial/Infrared
5 - Time Alarm from Real Time Clock
6 - Real Time Clock
7 - Touch Panel
8 - PCMCIA Card
9 - Sound
A - Keypad
B,C - Card Lock Switch Status
D - Memory Management Trap

Known Memory Addresses:

0000 to AFFF - RAM
B000 to EFFF - suspected memory management swap area. (some parts may not=
be
used).
F000 to FFFF - ROM BIOS - CASIO CBIOS

Note: The LCD screen is not memory mapped. Applications must use dos or b=
ios
routines for display.

Memory Management Chip Selects:

CS0 - 512k RAM HM65V8512LTT-15V
CS1 - 512k RAM HM65V8512LTT-15V
CS2 - unused (RAM)
CS3 - unused (RAM)
CS4 - 1mb ROM MB838200L15PFTN700
CS5 - 1mb ROM MB838200L15PFTN701
CS6 - 1mb ROM MB838200L15PFTN702
CS7 - 1mb ROM MB838200L15PFTN703

All RAM is pseudo-static. RAM appears to be 0 wait state.
All of the above RAMs and ROMs are on a daughter card so they can be upgr=
aded
easily. There is no room to expand the RAM on the daughter card.

All I/O addresses are unknown at this time.

The custom serial connector's p/n:
TX20A-10RV-D2ITAIL

Serial port pinout
1 - Ground
2 - Recieve
3 - Transmit
4 - Data Terminal Ready
5 - Frame Ground (internally not connected)
6 - Data Set Ready
7 - Request to Send
8 - Clear to Send
9 - Ring Indicator
10 - Carrier Detect

Note: The serial port is not an 8250 or compatible.

GEOS.INI TIPS
The tips and tricks that follow are unsupported and/or undocumented. The =
use
of these modifications may result in data loss. USE THESE TECHNIQUES AT Y=
OUR
OWN RISK!!! These techniques will improve the useability and efficiency o=
f
your Zoomer.

Enjoy!

Remember to reset the Zoomer in order for your changes to go into effect.=

PS: Don't forget to look in the Geoworks or PDA forums on AOL for many
enhancements to the GEOS.INI. =

File Linking [link] @ 19.2k!
[link] Section - File Linking -Twice the Speed
The [link] section is for the file linking function:

name =3D system name
port =3D 0 - rs232
2 - infrared
baudRate =3D 12 - 9600 bps
6 - 19200 bps
3 - 38400 bps (doesn't work)
drives =3D add and delete the drives based on what you want to be availab=
le on
the other PC.
{
A:
B:
C:
SYS:
}

Note you must have your ram card installed before you file link. If you d=
o
not, the ram card will not be seeen by the other PC. Just disconnect and =
then
reconnect.

Here is an example:
[link]
name =3D zoomer
port =3D 0
baudRate =3D 6
drives =3D
{
A:
B:
C:
SYS:
}

The above setup will allow you file link at 19200 and allow you to access=
al
the Zoomer drives from your PC. Don't forget to change your PC's preferen=
ces,
connect baud rate to 19200 bps.

Then you can enjoy twice the speed!

Run 15 Apps!
Heres how to run many more applications at the same time.

Change the line under [system]:
maxSystemHeapSpace =3D 31000
to
maxSystemHeapSpace =3D 65000

Just be careful not to run out of ram or the system will reboot. We need=
an
app that tells how much ram is available.

To add more ram to Geoworks, change the line under [system]:
memory =3D { }
to
memory =3D {
disk.geo
}

This will allow Geoworks to swap to the B: drive. So make sure you have =
ram
card (sram or flash, it does not matter) and have deleted as much as poss=
ible
from the B: drive.

Speed up Screen and Buttons!
The [motifoptions] has a parameter that controls the delay between each
action of the user interface(eachclick with the pen)
It is measured in 1/60ths of a second.

Default: gagetRepeatDelay =3D 18

Recommended: 6 to 10 depending on your sensitivitry.

Remember, the lower the number, the faster the response. If the number i=
s
very low, it is easy to have characters repeated unexpectedly.

Smaller Scroll Bar - More Screen Space!
Almost all Geoworks applications usecscroll bars. By changing [motifopti=
ons]
scrol arrow size,(size in pixels)

Default: scroll arrow size =3D 8

Recommend: 6 or 7

Remember, the smaller the number, the more precise you need to be with th=
e
stylus.

Smaller Font - More Screen Space
The font size for the Geoworks display under the [system]:

Default: fontsize =3D 10

Recommended: 9

Supported sizes: 9, 10, 12, 18

The smaller the number, the smaller.the font.

Non-Blinking Cursor
To make the cursor not blink, add the line in [input]:

cursor blink =3D false

File Transfer @ 38.4k!
To use file transfer @ 38.4k, create a batch file (zdriver.bat if you hav=
e
not enhanced your Zoomer) on the Zoomer:
a:\pccom /c:1 /b:38400

Then use ZDOS to connect to the Zoomer:
ZDOS /b:38400

I also use this batch file to move a whole directory at a time from the P=
C to
the Zoomer (requires Zdos v1.1):

FOR %%F IN (*.*) DO ZDOS /b:38400 /c=3D"send %%F"

Now, restoring the Zoomer is much easier!

Faster Screen Updates!
The screen on the Zoomer can be faster. This enhancement improves scrol=
ling
up an down, as well as whole screen repaints.

The speed up is accomplished by upgrading the MOTIF.GEO (224,236 bytes) f=
ile:
1. From Geopublish (\geopubl\system\motif.geo)

2. From Ensemble 2.01 upgrade. The upgrade must be installed.
(\geos20\system\motif.geo)

To install the new motif.geo, you need about 225k of free disk space on b=
: or
c: Type the following with Zdos and File Transfer:
C:
CD \
MD GEOWORKS
CD GEOWORKS
MD SYSTEM
CD SYSTEM
SEND MOTIF.GEO

Then exit Zdos and File Transfer. This will load the new motif.geo.

This should improve screen scrolling for Zcomlite users, especially at 96=
00
baud.