background image

JK

 

microsystems

Flashlite 186 

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
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]

DEL / ERASE

Function: Deletes (erases) one or more files from a disk
Format:

DEL or ERASE [d:][path][filename[.ext]]

DOS

Summary of Contents for Flashlite 186

Page 1: ...Flashlite 186 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: ...ons 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 Important Notice Life Su...

Page 5: ...Programming the Ports 7 Asynchronous Serial Ports 8 RS 485 Configuration 8 Watchdog Timer 9 DiskOnChip 9 Jumpers 10 JP1 Socket Memory Type Boot Memory Location 10 JP2 Serial Port 0 Select 10 Cables and Connectors 10 Software 13 Supported PC BIOS Functions 13 Driver Library 13 Utilities 14 UP COM 14 DOWN COM 14 FORMAT COM 15 EDIT COM 15 DOS 16 XDOS Command Reference 16 QuickBASIC PowerBASIC Console...

Page 6: ...JKmicrosystems Flashlite 186 User s Manual iv ...

Page 7: ...on has been compiled or assembled and linked into EXE or COM form it is uploaded to the Flashlite s flash disk with your favorite telecommunications program using the X Modem protocol The application can then be tested and debugged through the serial console When the application is running to your satisfaction the startup batch file can be modified so that the application will load and execute upo...

Page 8: ...lied to the Flashlite or when it is reset the board goes through its initialization procedure and then starts DOS A simple read only 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 attem...

Page 9: ...up You must resolve the problem before you can continue If you were able to do a DIR take a few minutes to explore the contents of the Flashlite s file system You will find all of the essential utilities on drive A and some optional programs on drive B Drive A is write protected and cannot be altered Drive B is read write and can be changed or reformatted After you have looked at the programs on t...

Page 10: ... TIME 13 30 00 Sets the time to 1 30 pm B DATE 10 29 2002 Sets the date to October 29 2002 When power is applied to the Flashlite one of the first things the BIOS initialization code does is check for a CNTL C character typed at the console If this character is typed as soon as the board is powered up or reset a flag is set which overrides some of the initialization process When DOS runs its AUTOE...

Page 11: ...C compatible or located at their traditional I O port addresses For addressing and programming the peripherals specific to the R8822 please refer to the RDC R8822 Microcontroller User s Manual The manual is available in PDF format on the Development Kit CD or from our web site at http www jkmicro com Digital I O Ports The Flashlite has a total of 44 bits of I O 40 bits are generated by a CPLD and ...

Page 12: ... the port will be present on the port pins if the port is configured as an output Each port may be configured as either an input or an output Write a 0 to the appropriate bit in the direction register to configure the port as an input write a 1 to configure it as an output All ports default to inputs The CPLD is a low power device that operates from 3 3 Volts Although the inputs are 5V tollerant c...

Page 13: ...ven by a port pin as well as a larger inductive load connected to the contacts of a relay B If you are using a relay to switch an AC powered inductive load put a varistor in parallel with the load The varistor voltage rating should be about 1 5 times the peak to peak steady state voltage of the load C Relays switching an inductive load may require a capacitor placed across their contacts 0 1µF to ...

Page 14: ...ting RxD and TxD The Serial Debug Console port does not make use of a hardware UART It is intended for console and debugging purposes only and should not be used in a design requiring high data throughput Its design generates an interrupt for each bit of serial data and puts a large load on the processor when data is being received Driver functions for Serial 0 and Serial 1 are available in the CS...

Page 15: ...r than the MD2800 Install the DiskOnChip module in the memory expansion socket U6 Note the location of pin 1 Set the Memory Type jumpers JP1 for Flash memory If the DiskOnChip is installed and functioning there will be an installation message that is displayed during the boot process and a C drive will be available to DOS Bios Version 2 0 for Flashlite 186 DOC Socket Services Version 0 2 C Copyrig...

Page 16: ... for TTL RS 232 signals on J5 or 5 6 for RS 232 signals on J10 Default position 5 6 RS 232 Levels on J10 NOTE Only 1 jumper may be installed on JP2 Cables and Connectors The following tables show the signal name direction for each connector pin NOTE N C indicates no connection and PULLUP indicates a 1k ohm pullup resistor to Vcc Outputs are driven by the board and received by a peripheral Inputs a...

Page 17: ......

Page 18: ...CLKB 7 8 3 3V INT5 9 10 INT6 PE 7 11 12 PF 7 PE 6 13 14 PF 6 PE 5 15 16 PF 5 PE 4 17 18 PF 4 PE 3 19 20 PF 3 PE 2 21 22 PF 2 PE 1 23 24 PF 1 PE 0 25 26 PF 0 Table 2j Port E F Pinout J9 Port C D GND 1 2 Vcc GND 3 4 Vcc INT2 5 6 3 3V CLKA 7 8 3 3V PIO0 9 10 PIO1 PC 7 11 12 PD 7 PC 6 13 14 PD 6 PC 5 15 16 PD 5 PC 4 17 18 PD 4 PC 3 19 20 PD 3 PC 2 21 22 PD 2 PC 1 23 24 PD 1 PC 0 25 26 PD 0 Table 2i Po...

Page 19: ...ns 9 and 0Eh Int 11h Get Equipment Configuration Int 12h Get Memory Size Int 13h Disk Driver Functions 0 4 Int 14h Serial Port Driver Functions 0 3 Int 16h Keyboard Driver Functions 0 and 1 Int 19h Boot System Int 1Ch Hook Timer Tick Interrupt Driver Library Drivers for the hardware serial ports alphanumeric LCDs and matrix keypads are supplied on the utilities CD in the Drivers subdirectory For i...

Page 20: ...tive directory of the current drive A write protect error will occur if 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 Flashlite via the console port using the ...

Page 21: ...fication 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 Th...

Page 22: ...en 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 DO...

Page 23: ...splay only the file name h display Help screen any invalid key MD MKDIR Function Creates a subdirectory Format MD or MKDIR d path PATH Function Specifies directories DOS will 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 The current date stored by DO...

Page 24: ...t RD RMDIR Function 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 ...

Page 25: ...s that an INPUT statement will not echo the data entered by the user Workarounds for both of these problems can be found in the program BAS_INP BAS on the utilities CD Example subdirectory and shown here start OPEN o 1 cons PRINT 1 PRINT 1 Quickbasic PowerBasic Input Program PRINT 1 Enter a string GOSUB linein InputString linein PRINT 1 InputString PRINT 1 Enter a numeric value GOSUB linein InputN...

Page 26: ... MAX Units Condition VIL Input Low 0 0 8 V VIH Input High 2 0 5 5 V VOL Output Low 0 4 V IOL 8mA VOH Output High 2 4 V IOH 4mA Mating Connectors Connector Mfg MFG P N JK micro P N 2x5 Housing J6 J7 J8 J10 Molex 22 55 2101 28 0030 Oupiin 4072 2X05H 2x13 Housing J9 J11 Molex 22 55 2261 28 0031 Oupiin 4072 2X13H Pins Molex 16 02 0096 28 0033 Oupiin 404 PIN 10K 1x3 Housing Friction Lock J3 Molex 22 01...

Page 27: ...21 Flashlite 186 User s Manual JKmicrosystems Contact Information ...

Page 28: ...y of UART Timer PIC p4 Fix note for JP2 had double negative p9 1 1 3FEB03 EW Revise TOC Table 2 references 1 0 30Jan03 EW First Issue Contact Information JK microsystems Inc 1403 Fifth Street Suite D Davis CA 95616 Telephone 530 297 6073 Fax 530 297 6074 Email sales jkmicro com sales inquiries support jkmicro com technical support Web http www jkmicro com M Systems DiskOnChip 39899 Balentine Drive...

Reviews: