background image

JK

 

microsystems

µFlashTCP-EP 

 

User’s Manual

16

DOS

JK microsystems’ controllers use XDOS, a compact operating system for embedded applications.
The XDOS command structure is nearly identical to MS/PC DOS version 3.3. The switches for
the DIR command have been changed and expanded. XDOS does not support redirected input or
output with the use of < and >, but does support pipes ( | ). None of the external DOS commands
are available due to size constraints. XDOS does not support installable file system functions.

XDOS Command Reference

In the list below, XDOS commands are followed by a function description and their format
including available parameters and switches. Items in boldface type must be entered. Capitals or
lowercase letters may be used. Items in italics are parameters. Those in boldface italics must be
entered, those in [ ] are optional. All switches are optional. They are shown as [/X]. Spaces and
punctuation are to be included. An ellipsis ... following items means that you may repeat the
items as often as needed. Do not enter the ellipsis or the square brackets. Most XDOS commands
allow the use of wildcards in filenames and extensions. When wildcards (?=one character, *=any
character or characters) are used, the command is executed once for each matching file.

Common parameters are:

[

 d:

]

drive specification - a letter followed by a colon (:), e.g. A:, if no drive is
specified, the default drive is used.

[

path

]

the path DOS must take in traveling from one directory to another; directory
names are separated by a backslash (\).

[

filename

] up to 8 characters used to name a file.

[

.ext

]

a three character extension may be added to a filename; an extension is
separated from a filename by a period.

CD / CHDIR

Function:

Changes the current directory

Format:

CD

 or 

CHDIR

 [[

d:

]

path

]

COPY

Function:

Copies a file, combines two or more files into one file, or transfers data
between files and DOS devices

Format:

COPY

[

d:

][

path

]

filename

[

.ext

][

switches

]

[+[

d:

][

path

]

filename

[

.ext

][

switches

]

[

d:

][

path

][

filename

[

.ext

]][

switches

]

Switches:

/V - verify the contents of new file
/A - copy file in ASCII format
/B - copy file in binary format

DATE

Function:

Displays or changes the current DOS date.

Format:

DATE

 [

mm-dd-yyyy

]

DOS

Summary of Contents for 89-0040

Page 1: ...µFlashTCP EP User s Manual ...

Page 2: ......

Page 3: ...tems Inc disclaims all liability for any loss or damage resulting from the use of this manual or any software described herein including without limitation contingent special or incidental liability JK microsystems Inc recognizes our customer s need for a consistent product and will make every effort to provide one In order to provide the best possible product for all of our customers we reserve t...

Page 4: ...abnormal conditions of operation repairs will be billed at a nominal cost The foregoing warranty is exclusive and in lieu of all other warranties expressed or implied including but not limited to any warranty of merchantability or fitness for any particular purpose JK microsystems shall not be liable for any special incidental or consequential damages whether in contract tort or otherwise Importan...

Page 5: ...1 RS485 Termination 10 JP2 3 COM1 Voltage Levels 11 JP5 RS 485 Transmit Enable Select 11 JP6 Socket Memory Type Boot Memory Location 11 Cables and Connectors 11 Table 2 Cable Specifications 11 Table 3a Power Connector Pinout 12 Table 3b Multi I O Pinout 12 Table 3c General I O Pinout 12 Applications 13 Supported PC BIOS Functions 13 Utilities 14 UP COM 14 DOWN COM 14 FORMAT COM 15 EDIT COM 15 DOS ...

Page 6: ...JKmicrosystems µFlashTCP EP User s Manual iv ...

Page 7: ...XE or COM form it is uploaded to the µFlashTCP EP s flash disk with your favorite telecommunications program using the X Modem protocol The application can then be tested and debugged through the console serial port When the application is running to your satisfaction the startup batch file can be modified so that the application will load and execute upon reset or powerup These features yield a q...

Page 8: ... is reset the board goes through its initialization procedure and then starts DOS A simple AUTOEXEC BAT file is executed and then the board is ready to use The batch file performs several functions before the user is given control The DOS search path is set the DOS prompt is set the CTRL C flag discussed later in this manual is checked and finally an attempt is made to execute a file named STARTUP...

Page 9: ... be changed or reformatted After you have looked at the programs on the µFlashTCP EP the next step is to try to upload a file This is the procedure for getting a file from your PC to the µFlashTCP EP On the µFlashTCP EP type the command UP followed by the name of the file you wish to upload The µFlashTCP EP will begin sending characters to your PC polling it for the file On your PC start the trans...

Page 10: ...te of the console When DOS runs its AUTOEXEC BAT file on drive A the state of the CNTL C flag is also checked and any user application set to run on drive B is not loaded This insures that a hung application or quiet console can always be interrupted Running QUIET will turn off both input and output on the console port allowing applications to use it as COM2 The QUIET flag is only read durring ini...

Page 11: ... DOS mode This mode provides access to the PC AT peripherals such as UARTs counter timers and the interrupt controller at their traditional I O port addresses Other 386Ex peripherals are accessible in expanded I O space For addressing and programming the peripherals specific to the 386Ex please refer to the Intel 386Ex Embedded Microprocessor User s Manual Intel document number 272485 002 The manu...

Page 12: ...rts REM LED TheµFlashTCP EP is equipped with an LED that can be controlled by user software This LED is tied to Port 3 bit 0 Writing a one to this bit will turn the LED on a zero will turn it off This port must be explicitly programmed as an output See the section on Port 3 for I O locations and programming of this port Programming the Ports The I O ports are mapped into the 386Ex I O space Using ...

Page 13: ...tains the low byte and IER contains the high byte To determine the required divisor divide 115200 by the required baud rate Program the divisor with the nearest integer value When access to the divisor value is no longer required clear the DLA bit 7 6 5 4 3 2 1 0 Base Receive Transmit Holding Register Divisor Latch Low DATA Data In Data Out Base 1 Interrupt Enable Register IER 0 0 0 0 Modem Status...

Page 14: ...X_MASK enable transmitter outportb TX_MASK_REG inportb TX_MASK_REG TX_MASK disable transmitter The RS 485 driver is internally looped back Characters transmitted will appear in the UART receiver Software will need to be written to handle this condition Two utility programs are available to aid RS 485 development 485RX accepts RS 485 data and displays it on the console 485TX accepts console data an...

Page 15: ...d by setting bit zero of the WDTEN register at F4CAh Please refer to the Intel 386EX Embedded Microprocessor User s Manual for more information Ethernet The Ethernet port is a 16 bit design that supports direct connection to a 10BASE T network jumperless configuration and NE2000 software compatibility The controller has a default base address of 300 hex and IRQ9 using full duplex twisted pair wiri...

Page 16: ... Flash File System technology allowing full read write disk emulation TrueFFS provides hard disk compatibility at both the sector and file level Drives with capacities from 8 to 144 Mbytes are available Drives larger than 32 Mbytes require partitioning to allow XDOS to access the entire drive Install the DiskOnChip module in the memory expansion socket U4 Note the location of pin 1 Set the Memory ...

Page 17: ...and 6 8 to boot from the on board memory or jumper pins 7 9 and 8 10 to boot from the expansion socket Default position 1 3 and 2 4 Flash memory expansion 5 7 and 6 8 Boot from on board flash Cables and Connectors Proper cabling is required for optimal performance of the µFlashTCP EP and for compliance with EMI and EMC regulations The following table summarizes the recomended cable type and length...

Page 18: ...s are round This should be visible on the bottom of the PCB Pin one will also be identified on the board silkscreen with a 1 and or a dot Dual row headers have ODD numbered pins on one side and EVEN numbered pins on the other The dual row header numbering scheme follows the numbering for an IDC style ribbon cable This numbering may not be identical to connectors with discrete wires Use caution whe...

Page 19: ...ask Name Server address DNS and Gateway address This information will be required during the configuration process Other types of LANs require node names workgroup names etc Proceed cautiously networks can be easily disrupted when nodes are added without careful configuration Supported PC BIOS Functions The Flashlite BIOS supports the following functions software interrupts common to PC compatible...

Page 20: ...e current drive Be sure that B is the current drive or a write protect error will occur when UP tries to write to the read only A drive B up Upload file with X MODEM Protocol Usage up file Version 2 0 for JK microsystems Flashlite V25 and 386Ex B up test exe Ready start X modem upload now Press CNTL C to abort CCCC B DOWN COM This utility facilitates downloading files from the µFlashTCP EP via the...

Page 21: ...ation of batch files or other text files EDIT is similar to Microsoft s EDLIN provided in earlier versions of MS DOS It allows list insert delete and modify Upon exit a backup of the original file is created filename BAK and the edits are saved If a backup file with the same name already exists it is overwritten A list of commands and their usage is available by entering h at the edit prompt The n...

Page 22: ...may repeat the items as often as needed Do not enter the ellipsis or the square brackets Most XDOS commands allow the use of wildcards in filenames and extensions When wildcards one character any character or characters are used the command is executed once for each matching file Common parameters are d drive specification a letter followed by a colon e g A if no drive is specified the default dri...

Page 23: ... include system and hidden files in output h display this Help screen any invalid key MD MKDIR Function Creates a subdirectory Format MD or MKDIR d path PATH Function Specifies directories that DOS is to search when trying to locate executable files Format PATH d path d path PROMPT Function Sets the DOS system prompt Format PROMPT text Text Resulting Character s t The current time stored by DOS d ...

Page 24: ... Deletes a subdirectory Format RD or RMDIR d path TIME Function Displays or changes the current DOS time Format TIME hh mm ss xx TYPE Function Display the contents of a file Format TYPE d path filename ext VER Function Displays the DOS version number Format VER VOL Function Displays the volume label of specified drive Format VOL d DOS ...

Page 25: ...an INPUT statement will not echo the data entered by the user To work around this problem we have added a feature which allows the application to enable a console echo function in the BIOS This feature is enabled by setting the byte at 40 8Ah to a one Likewise the local echo is disabled by setting 40 8Ah to a zero The following BASIC code demonstrates both of these workarounds start OPEN o 1 cons ...

Page 26: ...facturer could result in violation of Part 15 of the Federal Communications Commissions rules The FCC has prepared the following booklet How to Identify and Resolve Radio TV Interference Problems It is available from the US Government Printing Office Washington DC 20402 Stock Number 004 00 00345 4 Notice for Canada This Class B digital apparatus complies with Canadian ICES 003 Cet appareil numériq...

Page 27: ...densing I O Port Characteristics Symbol Parameter MIN MAX Units Condition VIL Input Low 0 3 0 8 V VIH Input High 2 0 Vcc 0 3 V VOL Output Low 0 45 V IOL 8mA VOH Output High Vcc 0 5 V IOH 8mA Mechanical Dimensions 3 6 x 4 3 x 1 75 without baseplate 91 4mm x 109 2mm x 44 5mm 4 6 x 4 3 x 1 8 with baseplate 116 8mm x 109 2mm x 45 7mm Weight 12oz 340gm Specifications ...

Page 28: ...kOnChip 2000 39899 Balentine Drive Suite 335 Newark CA 94560 Telephone 510 413 5950 Fax 510 413 5980 Email info m sys com Web http www m sys com Rev Date Author Changes 1 4 30AUG01 EW Add change log Fix JP1 default location closed Fix JP5 pin definition was 1 2 RTS control 1 5 12SEP01 EW Supply Voltage was 9 34 VDC Operating Temperature was 40 to 70 C 1 6 1MAY02 EW JP4 not a user jumper fixed loca...

Reviews: