
Setup

Structure of Download file
 * gnu_mn10200_bin.zip
     A set of C compiler for GNUPro MN10L200 series (GNUPro execution file only)
 * rupSDK.zip
     onHand/RuputerAPI library&tool, manual, a set of sample programs


file size
 * gnu_mn10200_bin.zip         --- zip file    10.6MB -> after unzipped 34.3MB
 * rupSDK.zip                  --- zip file       1MB -> after unzipped  3.1MB


You need to have the zip archive application.


Procedure
(1)Unzip the file by using Zip archive application (Please keep the directory structure). 
 The directory is as follows.

 GNUPro compiler related files
       mec-980228          <<< This is different depend on your downloaded version.
         |- H-i386-cygwin32
              |- bin
              |- lib
              |    |- gcc-lib
              |         |- mn10200-elf
              |              |- 2.7-mec980228   <<<This is different depend on 
              |                   |-include          your downloaded version.
              |- mn10200-elf
                   |- bin
                   |- include
                   |    |- machine
                   |    |- sys
                   |- lib
                        |- ldscripts


 onHand/RuputerAPI library&tool
       RupSDK
         |- bin     (Format conversion and transfer tools)
         |- inc     (onHand/RuputerAPI header file)
         |- lib     (onHand/RuputerAPI library file)
         |- manual  (Development environment manual)
         |- Remcon  (remote control sample)
         |    |- manual
         |    |- sample
         |- Rshell  (Remote shell specification details)
         |    |- lib
         |    |- manual
         |- sample1 (Sample for the first class W-PsDOS version)
         |    |- test
         |    |- lesson1
         |    |- lesson2
         |    |- lesson3
         |- sampel2 (Sample for the middle class onHand/RuputerAPI version)
         |    : 
         :    
         |- src     (library resource file)
              |- rups    (onHand/RuputerAPI library resource file)
              |   |- inc
              |   |- sys
              |   |- menu
              |   |- tool
              |- syscall (W-PsDOS library resource file)
                  |- bioscall
                  |- doscall
                  |- inc
                  |- lcdcall



(2)Start DOS prompt and set an environment variable.

 Example: When you unzip both gnu_mn10200_bin.zip and rupSDK.zip and store these files under C:\onHand_SDK, type the following commands in the DOS prompt and set the environment variable.


set ONHANDSDK=C:\onHand_SDK
set CYGWIN32=%ONHANDSDK%\mec-980228\H-i386-cygwin32
set GCC_EXEC_PREFIX=%CYGWIN32%\lib\gcc-lib\
set PATH=%CYGWIN32%\bin;%CYGWIN32%\Mn10200-elf\bin;%ONHANDSDK%\RupSDK\Bin;%PATH%;


Please note that "mec-980228" of CYGWIN32 is different depending on the downloaded version.

 Please do not forget to put the final "\" in GCC_EXEC_PREFIX.

 All the remaining operations should be done in DOS prompt.  It is useful if you prepare a batch file that handles the above mentioned environment settings.

 You can set the environment settings by onHandLab.pif(Shortcut to MS-DOS Program) in ..\RupSDK\Bin. It is open command prompt window and execute setpath.bat in ..\RupSDK\Bin. 
<<NOTE>>
 This "onHandLab.pif" works on Windows 95 and Windows 98 only. It will be copied on "C:\Windows\Desktop" folder.
 It does not work on Windows NT4.0. 
 For Windows NT4.0, use "onHandLab for NT.pif". 
 The "onHandLab for NT.pif" exists in "C:\onHand_SDK\RupSDK\BIN".

 In addition, we assume that compile operation is done by make.exe that is included in gcc.
 If you already have another development environment (make.exe and etc.), you should specify the above mentioned path or follow the make procedure of that development environment.


***** Caution *****
  In this example, the drive name is "C:".  You need to select an appropriate drive according to your environment.
  If you are told that you do not have enough DOS environment variables, you need to change the initial size of the environment variable by the memory settings of MS-DOS.



(3)Please test whether compile is completed successfully.
 Please create a sample program hello.exf.  This program displays "Hello,World!!" when it is started.
 When the above mentioned environment variable is used as an example,

 Open onHandLab.pif(Shortcut to MS-DOS Program) in ..\RupSDK\Bin. 

 C:>
 At the state of command typing, type the following command.

 cd c:\onhand_sdk\rupsdk\sample1\test

 Then, change the current directory as show below.

 C:\onHand_SDK\RupSDK\sample1\test>

 Please confirm that the following files can be found by using dir and etc.
    main.c
    makefile
    mk.bat
    startup.s
    FuncManu.txt

 When you confirmed, type
 make

 and press the Enter key.

 Messages are displayed on the screen while the compiler is running.

 "Completed successfully."

 When the above message is displayed, hello.exf was created.


 In addition, you can make exf by using a batch file.  Please refer to mk.bat.

***** Caution *****
  In this example, the drive name is "C:".  You need to change "makefile" or "mk.bat" according to your environment.



(4)Please confirm the execution.
 Currently, the debug environment on PC is not available for RupSDK development environment.  You need to confirm the operation after the execution format file is transferred to onHand/Ruputer.  It is inconvenient for user developer but we would ask your cooperation.



 When the above mentioned environment setting is used as an example,

 ---<<Transfer by PC Filer>>---
 (1)Put onHand/Ruputer to docking station, start PC Filer and change it to the remote state.

 (2)Transfer C:\onHand_SDK\RupSDK\sample\test\hello.exf to onHand/Ruputer by drug&drop.
          (For information on how to transfer a file, refer to onHand/Ruputer Users Manual)

 (3)After the transfer is completed, confirm the operation by starting hello.exf on onHand/Ruputer.



 The following tools are available other than the conventional PC Filer transfer.

 ---<<Transfer by Rshstation.exe>>---
 (1)Start Rshstation.exe located under C:\onHand_SDK\RupSDK\Bin.

 (2)Set the COM port and baud rate:38400bps by using <Settings> button.
                               				    (This setting is recorded in the registry.)

 (3)Press <Commander> button and display the remote command screen.

 (4)Put onHand/Ruputer to the docking station and change it to the remote ready state.

 (5)Press <Connect> button.
   When the negotiation is completed successfully, it becomes the remote state.

 (6)You can transfer hello.exf to onHand/Ruputer by using <Upload> button or drug&drop.

 (7)After the transfer is completed, confirm the operation by starting hello.exf on onHand/Ruputer.

 *We do not explain about other function buttons.  Please refer to <ToolManu.txt>.




Explanation of RupSDK directory

1.bin
 Many format conversion tools and transfer tools are placed as onHand/RuputerSDK tool.

 setico.exe   VC++5.0 DOS program
 This is a tool that pastes an icon to the completed execution format file.

 sf2bin.exe   VC++5.0 DOS program
 This tool converts the Motorola S3 format file generated by GNUPro tool mn10200-elf-objcopy.exe to onHand/Ruputer execution format tool.

 RshStation.exe   VC++5.0 Windows program
 As the same way of PC Filer, the remote connection between onHand/Ruputer and PC can be established (by command). 

 Ruprsh32.dll   VC++5.0 Win32 program
 This is a remote shell module that is used by PC Filer (Rupshell.exe must be resided).

 Rupshell.exe	VC++5.0 Win32 program
 This is a resident remote shell module that is used by PC Filer / RshStation.

2.inc
 There are all included files that are required when onHand/RuputerAPI library is used.

 address.def
 This is the required system address information when the startup routine startup.s is used.

 font.h
 This is the definition of SII Monomap data address that stores SII Pictograph code (double-byte) and MROM.

 psdos.h
 This is the definition of W-PsDOS library psdos function.

 wbios.h
 This is the definition of W-PsDOS library bios function.

 lcdbios.h
 This is the definition of W-PsDOS library lcd drawing function.

 rupsys.h
 This is the definition of onHand/RuputerAPI library filer management event and button operation function and etc.

 softkey.h
 This is the definition of soft keyboard call function that a filer provides.

 ruptool.h
 This is the definition of string conversion and other useful functions.

 rupmenu.h
 This is the definition of input menu library function.

3.lib
 This is a directory where onHand/RuputerAPI library body is stored.

 libpsdos.a
 W-Psdos library psdos function.

 libwbios.a
 W-Psdos library bios function.

 liblcdbios.a
 W-Psdos library lcd drawing function.

 librupsys.a
 onHand/RuputerAPI library filer management event, button operation function and etc.

 libruptool.a
 onHand/Ruputer tool library string conversion and other useful functions.

 librupmenu.a
 onHand/Ruputer menu library input/edit menu functions.


4.manual
 This is the development manual.


5.sample1-
 These are sample programs.


6.src
 This is a source code of onHand/RuputerAPI library.
 

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