
History
    98/07/24 First Edition
    98/08/24 Adds DLL dialog box display/hide flag (or timeout switch)
             Adds error code descriptions
             Adds description for specification of filename with full-path
             Modifies other description errors
    98/08/31 Adds description for XMODEM upload/download library module
    99/10/12 Adds [Usage of DLL], description for u_ver

Title
  List of interface DLL commands (remote shell commands) for communication between devices 


  This manual describes the remote shell commands that establish interface communication between onHand/Ruputer and PC terminals.

--------------------------------------------------------------------------------
***** Overview *****
Remote shell utility enables this device (onHand/Reputer) to connect with another PC (Windows machine) through a serial port. It is controlled and operated from the PC. This utility consists of one program running on onHand/Ruputer (also called remote shell agent) and the other program running on the PC. You will be provided with a DLL Library which can run on Windows95 or later.
    

    The following is the list of remote shell Utility functions.

        u_nego      ...Executes a negotiation
        u_copy      ...Copies a file
        u_del       ...Deletes a file
        u_dir       ...Obtains directory information in flash memory
        u_format    ...Formats flash memory disk
        u_ren       ...Renames a file
        u_reset     ...Reset
        u_ver       ...Obtains its system version
        u_download  ...Copies a file in the disk of onHand/Ruputer to PC
        u_upload    ...Copies a file in PC to the disk of onHand/Ruputer
        u_mkdir     ...Creates a new directory
        u_rmdir     ...Deletes a directory
        u_chdir     ...Changes the current directory
        u_gtime     ...Obtains time 
        u_stime     ...Sets time 
        u_gpower    ...Detects battery voltage 
        u_chkdsk    ...Checks the consistency of flash memory
        u_end       ...Exits this utility 

***** Operations *****
    The following shows how to start and exit the utility.
    1. Start the remote shell agent.
        This agent runs as a child process of application program.
    2. Run the utility on your PC.
        Start the utility program on your PC. Since the utility is provided as a Windows DLL file, you have to create and run a EXE file that calls it.
    3. Exit
        Reset the utility and reboot, or, exit with a command.



***** Usage of DLL *****

This library is provided as a Windows 32-bit DLL. To use this library from an application, you have to include the include file in the source file to link the LIB file.
  It is also necessary to start a memory-resident program prior to calling DLLs.
        Memory-resident file name:  'ruprshell.exe'(memory-residing in StartUp)
        DLL file name:      	    'ruprsh32.dll' (stored in system\windows)
        LIB file name:          	'ruprsh32.lib' (located in RupSDK\rshell\lib)
        Include file name:     		'ruprsh32.h'   (located in RupSDK\rshell\lib)


***** DLL error codes *****
      Error codes (error information) for this library are as follows:
             0      Normal termination 
            -1      Communication error 
            -2      Voltage drop 
            -3      Cancel button pressed
            -4      An error detected by BIOS on onHand/Ruputer 
            -5      User-specified time-out error
            -6      An error occurred when DLL is in use by another application.
            -16     An error detected by Windows
            -17     Resident process error
            Others  An error detected by onHand/Ruputer Ps-DOS


***** DLL functionality and interface *****

          The following function formats describe the type of each fuction. 
          Including ruprsh32.h eliminates the need of prototype declaration.


u_nego  ... Negotiation

    ***** Format *****
        int     u_nego(whd, port, flg, baud, errcode){}

        Function values:  0: Normal termination  ?1:Abnormal termination
        parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
                                    1:  9600bps (115200bps)
                                    2:  9600bps (57600bps)
                                    3: 38400bps
                                    4: 19200bps
                                    5:  9600bps
                                    6:  4800bps
                                    7:  2400bps
                                    8:  1200bps
                                    9:   600bps
                                    10:   300bps
                                Or else: 9600bps
            LPINT   errcode;    Error information 

    ***** Functionality *****
           Negotiates with onHand/Ruputer.
           This function has to be called prior to other commands.
           Baud rates of 115K, 57.6K are handled as 9600bps due to the restriction of Win32API.
           With flg, you can specify the shape of dialog box displayed during process.
           Hide option actually minimizes the window. Thus, clicking x button on the task bar has the same effect as pressing the Cancel button on the dialog box. 


u_copy  ... Copies a file.

    ***** Format *****
        int     u_copy(whd, port, flg, baud, sfile, dfile, errcode){}

        Function values: 0: Normal termination  -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   sfile;      Source file(s)
            LPSTR   dfile;      Target file(s)
            LPINT   errcode;    Error information 
                                2: Source file error
                                3: Target file error

    ***** Functionality *****
          Copies a file within flash memory of onHand/Ruputer.
          A full-path description with directory name is available for sfile and dfile.




u_del   ...  Deletes a file.

    ***** Format *****
        int     u_del(whd, port, flg, baud, file, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   file;       File name to be deleted
            LPINT   errcode;    Error information
                                2:File error

    ***** Functionality *****
          Deletes a file.
          A full-path description with directory name is available for file. 




u_dir       ...Obtains directory data in flash memory

    ***** Format *****
        int     u_dir(whd, port, flg, baud, dpath, dir_inf, len, space, errcode){}

        Function values:  -1:Abnormal termination,  Except-1:Number of files in a directory 
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   dpath;      Directory path
            LPSTR   dir_inf;    Directory data storage area.
                      Directory data contains 22 bytes of data which specify name, size, and date of each file.
                      The following is its format.

            Directory information storage area
                                                    15                      0
            +-----------------------+-------------->+-----------------------+
            |  File information 1   |               |   Written time        |  0
            |   (22 bytes)          |               +-----------------------+
            +-----------------------+-------+       |   Written date        | +2
            |  File information 2   |       |       +-----------------------+
            |                       |       |       |                       | +4
            +-----------------------+       |       +-     File size       -+
            |                       |       |       |                       | +6
            ===                     ===     |       +-----------+-----------+
            |                       |       |       |           | Attribute | +8
            +-----------------------+       |       +-          +-----------+
            |  File information  n  |       |       |                       | +0a
            |                       |       |       +-                     -+
            +-----------------------+       |       |   File name(13B)      | +0c
                                            |       +-                     -+
                                            |       |       (ASCIZ)         | +0e
                                            |       +-                     -+
                                            |       |                       | +10
                                            |       +-                     -+
                                            |       |                       | +12
                                            |       +-                     -+
                                            |       |                       | +14
                                            +------>+-----------------------+
                                                
            int     len;       Byte count of directory data storage area
                               Directory information storage area requires 22 bytes for the number of files
                               If this value is 0, only the number of files returns, thus no data is set to the directory data storage area. 

            LPLONG  space;      Free byte count of flash memory
            LPINT   errcode;    Error information
                                2: Directory reading error

    ***** Functionality *****
          Obtains directory data in flash memory.
          A full-path description is available for dpath.




u_format/u_stdform      ...Formats flash memory disk

    ***** Format *****
        int     u_format(whd, port, flg, baud, byte, sec, cyl, head, level, errcode){}
        int     u_stdform(whd, port, baud, level, errcode);

        Function values:  0:Normal termination     -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            int     byte;       Byte count in a sector
            int     sec;        Number of sectors in a track 
            int     cyl;        Number of cylinders
            int     head;       Number of heads
            int     level;      Format level
                                1: "Level 1" -   Erasing only 
                                2: "Level 2" -  a)Writes 0 in all blocks to check for errors
                                                b)Erases 
                                3: "Level 3" -  a) Writes 0 in all block check for errors
                                                b)Erases
                                                c)Checks that all blocksare Oxff after erasing
                                        (Any specified value other than 1,2, and 3 defaults to 1) 
            LPINT   errcode;    Error information
                                2:Flash memory access error

    ***** Functionality *****
          Formats flash memory disk.
          For byte, sec, cyl, and head specified values according to the type of flash memories are set.
          With u_stdform, an appropriate formatting is made according to the implementation types.




u_ren       ...Renames a file

    ***** Format *****
        int     u_ren(whd, port, flg, baud, oldname, newname, errcode);

        Function values:  0:Normal termination     -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   oldname;    Old file name
            LPSTR   newname;    New file name
            LPINT   errcode;    Error information
                                2:File error

    ***** Functionality *****
          Renames a file.
          A full-path description with directory name is available for oldname and newname.




u_reset     ...Resets 

    ***** Format *****
        int     u_reset(whd, port, flg, baud, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPINT   errcode;    Error information

    ***** Functionality *****
          Resets CPU.




u_ver       ...Obtains the system version 

    ***** Format *****
        int     u_ver(whd, port, flg, baud, vers, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   vers;       Version information 
            LPINT   errcode;    Error information

    ***** Functionality *****
          Obtains the system version. 
          Major version (integer part) is set in the leading byte.
          Minor version (decimal part) is set in the first byte 
          Note that LPSTR vers contains 8-byte data. 




u_download  ...Copies a file in the disk of onHand/Ruputer to PC.

    ***** Format *****
        int     u_download(whd, port, flg, baud, file, copyfile, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   file;       Source file name
            LPSTR   copyfile;   Target file name 
            LPINT   errcode;    Error information
                                2:Source file error
                                3:Target file error

    ***** Functionality *****
          Copies a file in the disk of onHand/Ruputer to PC.
          A full-path description with directory name is available for file and copyfile. 




u_upload    ...Copies a file in PC to the disk of onHand/Ruputer.

    ***** Format *****
        int     u_upload(whd, port, flg, baud, file, copyfile, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   file;       Source file name
            LPSTR   copyfile;   Target file name
            LPINT   errcode;    Error information
                                2:Source file error
                                3:Taeget file error

    ***** Functionality *****
          Copies a file in PC to the disk of onHand/Ruputer.
          If a file with the same name exits in onHand/Ruputer, it is overwritten.
          A full-path description with directory name is available for file and copyfile.




u_mkdir     ...Creates a new directory 

    ***** Format *****
        int     u_mkdir(whd, port, flg, baud, dname, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   dname;      Name of new directory (path can be specified) 
            LPINT   errcode;    Error information
                                3:Specified path invalid 
                                5:No disk space, or the directory with the same name already exists. 




u_rmdir     ...Deletes a directory 

    ***** Format *****
        int     u_rmdir(whd, port, flg, baud, dname, errcode);

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   dname;      Name of directory to be deleted (path can be specified) 
            LPINT   errcode;    Error information
                                3:Specified path invalid 
                                5:Could not be deleted since the specified directory was not empty, not a directory, or a root directory
                                16:Attempted to delete the current directory




u_chdir     ...Changes the current directory.

    ***** Format *****
        int     u_chdir(whd, port, flg, baud, dname, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   dname;      Directory name (path can be specified) 
            LPINT   errcode;    Error information
                                Specified path invalid 




u_gtime     ...Obtains time 

    ***** Format *****
        int     u_gtime(whd, port, flg, baud, ymdhms, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   ymdhms;     6 bytes area 
                                Year, month, day, hour, minute, and second are set in BCD.
            LPINT   errcode;    Error information




u_stime     ...Sets time 

    ***** Format *****
        int     u_stime(whd, port, flg, baud, ymdhms, errcode);

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPSTR   ymdhms;     Year, month, day, hour, minute, and second 
                                Should be specified in 6 bytes area in BCD
            LPINT   errcode;    Error information




u_gpower    ...Detects battery voltage 

    ***** Format *****
        int     u_gpower(whd, port, flg, baud, battery, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPLONG  battery;    sets count value of charging and discharging
            LPINT   errcode;    Error information




u_chkdsk    ...Checks the consistency of flash memory 

    ***** Format *****
        int     u_chkdsk(whd, part, flg, baud, ctrl, finfp,  filep, eclup, errcode){}

        Function values:  0: check completed    1:not completed -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            int     ctrl        check method 
                                CDSK_DO : 0     Execution of chkdsk
                                CDSK_END: 1     End command
            LPINT   finfp;       Shows how the file shown by filep is destroyed 
                                0: The file is incomplete
                                1: The file has something unnecessary
                                2: The file overlaps with other file
                                3: FAT link incorrect (linked to reserved clusters)
            LPSTR   filep;      Should have an ample space since an complete path name beginning from the buffer root that stores an abnormal file name is stored.
            LPINT   eclup;      The total number of bad clusters is set in seclup[0],
                                while the total number of floating clusters is set in eclup[1].
            LPINT   errcode;    Error information

    ***** Functionality *****
          Checks flash memory. Since this function returns to the original caller when any error is found, it requires CDSK_DO to call it back to continue the check and CDSK_END to stop it to call this function again (other function must not be called).
          Calling CDSK_DO requires to specify the appropriate pointer as an argument (even though the same pointer was specified previously).
          If the function value at the time of recovery is a check completion, the data is set in the place pointed by eclup, but not in finfp/filep.
          On the other hand, if the value is a check incompletion, the data is set in finfp/filep, but not in eclup.
          If it is called by CDSK_END, what is set varies.




u_end       ...Exits the utility

    ***** Format *****
        int     u_end(whd, port, flg, baud, errcode){}

        Function values:  0: Normal termination    -1:Abnormal termination
        Parameters:
            HWND    whd;        Handle number of parent window
            int     port;       Port number(1-)
            int     flg;        Display/Hide dialog box 
                                Display : -2 = Displays a message of aborting process
                                        : -1 = Enables progress bar 
                                Hide    : 0 = Hides dialog box 
                                        : 1 or more = Specifies timeout(in seconds)
            int     baud;       Baud rate
            LPINT   errcode;    Error information




--------------------------------------------------------------------------------------------

***** Calling a remote shell on onHand/Ruputer *****
  A remote shell agent is created as a process and called as a child process using dos_execute. In this instance, you have to specify the type of communication (1=Ir communication, 2=RS-232C) as an argument and baud rates/process type. Note that even if you specify either 115K or 57.6K for a baud rate, the corresponding DLL cannot catch up with that speed. The argument should be specified as the content of PSP+80H at the time of dos_execute. It must be specified as a 16-bit whole number, not a character string.
  The file with the name "a:\rshellds.exe" must be activated (ROMdisk). 

      Parameter block of dos_execute 
      +-------------------------+
      |   0                     |0
      +-------------------------+        15                         0    Baud rate: 1:(115200bps)
      | Pointer to argument     |4 ----->+---------------------------+              2:( 57600bps)
      +-------------------------+        |   Communication type(1/2) |0             3: 38400bps
      |   0                     |8       +---------------------------+              4: 19200bps
      +-------------------------+        |  Baud rate                |2             5:  9600bps
      |   0                     |12      +---------------------------+              6:  4800bps
      +-------------------------+        |  Process type             |4             7:  2400bps
                                         +---------------------------+              8:  1200bps
                                                                      6             9:   600bps
                                                                                   10:   300bps

       Process type 0:  Carries out a negotiation and command sequence 
                    1:  Carries out a negotiation only
                	      (Returns to the caller when the negotiation is established)
                    2:  Carries out a command sequence only
      		              (Becoming a command waiting state, provided a negotiation has already been established)

  Communication type and Baud rate are valid only when process type is either 0 or 1. 
  Factors that cause to return to the original caller will be later discussed. However, during negotiation, a timer watching function will not be executed and returning will not basically occur until the negotiation is established.
    Only the following factors cause an error return. 
        1)  A failure of setting the timer in a command sequence
        2)  A RS-232C cable is not connected




***** Invocation of upload/download  on onHand/Ruputer *****
  To carry out a file transmission with xmodem from an application program, a routine in the remote shell agent can be called as a shared routine.
  Before calling a shared routine, necessary information, such as the name of file to be sent must be verified on both terminals. When upload/download is called, an xmodem sequence will start right away responding to sending a NAK.

 To send a file, use dwlcall.
    int  dwlcall( char *fname );
        char  *fname;                 /* A file name to be sent */
        Return value: Described later

 uplcall is used to receive files.
    int  uplcall( char *fname, long size, int date, int time, int attr );
        char  *fname;                 /* A file name to be received     */
        long   size;                  /*  File size        	    */
        int    date;                  /*  File date(pack type)  */
        int    time;                  /*  File time(pack type)  */
        int    attr;                  /*  File attribute        */
        Return value: Described later 


  Although the command upload/download  is located in a fixed address outside of the application program space, if you use the above function (libxmodem.a), they can be called just like ordinary functions. Those functions initialize the pointer to the upload/download  with a constant and call an appropriate routine by the pointer.
  When the upload is called, receiving buffers for SIO-BIOS are flashed immediately to move on to an xmodem sequence by sending a NAK code. For download, receiving buffers are not flashed but just wait for a NAK code to be sent (all other codes are ignored). Since the receiver (upload side) immediately sends a NAK code, a pre-procedure that calls the sender (on download side) first likely helps to realize a more stable file transmission. Sample directory contains a sample that uses XMODEM upload/download the library module libxmodem.a.





***** Return values of remote shell agent and upload/download *****
  Return values returned by the remote shell agent or upload/download  are defined in "rsh.h" as follows: Unless otherwise specified, an error can appear in both remote shell agent and upload/download. This means, that a value returns to the caller at the time of a normal termination or of an error occurrence.

    #define ERR_TIMER_FAILED    0x01            Remote shell agent only
    #define ERR_ FILE _IO       0x02            upload/download only
    #define ERR_LOW_BATTERY     0x03
    #define ERR_NEGO_TOUT       0x04            Remote shell agent only
    #define ERR_COMINIT_FAILED  0x80            Remote shell agent only
    #define ERR_COMOPEN_FAILED  0x81            Remote shell agent only
    #define ERR_COMMAND_FAILED  0x82            Remote shell agent only
    #define ERR_NOTOPEN         0x83
    #define ERR_XMODEM          0x84
    #define ERR_CAN_RECEIVE     0x85            upload/download only

  A return code for a normal termination is 0, an error related to communication is 80H and more, and other errors are less than 80H. The following describes the meaning of each return code.

    ERR_TIMER_FAILED    The timer could not be set.
                        This error occurs when the timer is already up. 

    ERR_ FILE _IO       This error occurred at the time of input or output of a file
                        It also occurs when the file name is invalid, directory entry is full,
                        or there is not enough disk space.

    ERR_LOW_BATTERY     Low voltage was detected on onHand/Ruputer 
    ERR_NEGO_TOUT       A timeout occurred during negotiation

    ERR_COMINIT_FAILED  Communication initialization failed
                        This error could occur when the communication cable is not connected.

    ERR_COMOPEN_FAILED  A communication port failed to open
                        This error can occur when the communication cable is not connected.

    ERR_COMMAND_FAILED  Retry-over of sending and receiving commands and responses
    ERR_NOTOPEN         The communication port is close
                        This error occurs when an xmodem transmission is executed without opening the communication port or when the cable is not connected.
    ERR_XMODEM          This communication error occurred during xmodem transmission
                        A timeout and a retry-over cause this error.

    ERR_CAN_RECEIVE     Indicates that CAN(Cancel) is received from the terminal (PC) while executing xmodem.
                        Note that if the remote shell agent is called, the error is not returned.


===============================================================================
 Copyright (c) 1998-1999.  Seiko Instruments Inc.  All rights reserved. 
===============================================================================
