
                    Informations about HIMES
                   ==========================

HIMES is a signal-processing-program for Hitachi-DSO's.
With  this program you have the possibility to take over the data
from the DSO and to make a numerical processing of this data.


                         Data-structure

HIMES  allows  you to work with up to 8  signals.  The  2  normal
channels  and the 2 reference-channels of the DSO are fixed to  to
the  first 4 signals of the program.  This means that if you read
or write one channel of the DSO, the data comes from or to one of
the first 4 signals. The other 4 signals can used for storage and
calculation purposes.

                             Display

HIMES  has a graphic-oriented usersurface.  In the center of  the
screen  there  is the display for the  signals.  You  can  select
between 1 big window or 2 smaller ones. For every window you have
to  determine which signals should be active in this window.  One
window is the aktive one.  The signals showed in this windows are
the  aktive  signals  and you  can  make  cursormeasurements  and
zooming  in this window.   At the top you see a bar with  several
menus.  At  the  right  side  there are  informations  about  the
horizontal  and vertical deflection of all used signals.  At  the
bottom is a bar where all active signals of the active window are
marked and the coordinates of the cursors.


                            Commands

The  program works with 2 modes.  When the program starts you are
in the command-mode,  which you can recognize by one of the menus
is surrounded by a red field.  This is the command-selector.  You
can move it by mouse,  cursor-keys or by key in the first  letter
of the command or menu The other mode is the graphic-mode,  where
you  can  move  the 2 crosshair-cursors for  measurement  or  for
selection  of  the zooming area.  You can toggle between  this  2
modes  with the right mouse-button or the ESC-key.  The  commands
are grouped together in several pull-down menus.  Their names are
showed  in the menu-bar at the top.  When the command-selector is
on  the  menu-bar and you move it down,  the  pull-down  menu  is
opened  and you can see the several commands.  With the  command-
selector  you  can select one and start it with the  left  mouse-
button  or the RETURN-key.  By moving the selector to the left or
to the right you can go directly into other sub_menus.  With  the
right  mouse-button  or the ESC-key you can go back to the  menu-
bar.  Some special commands you can also start directly with  the
function-keys from everywhere.



                         Input / Output

The program has 3 possibilities to communicate with the different
DSO's :
          - RS232-C    : VC-6023/24, VC-6025/45, VC-6145, VC-6155
                         and VC-7xxx
          - GPIB       : VC-6x65, VC-6x75 and VC-7xxx
          - direct
            connection : VC-6x75

The  program  can also read and write the memory-cards used  with
the VC-6x75 via the card-reader ( connected via RS232-C ) and  of
course it can store and recall from the computer's disks.


                     Requirements for the PC

To run HIMES the computer needs :
   - mouse
   - GPIB-board or RS232-interface
   - 1 floppy disk
   - memory depends on how many signals you want to use



                    Commandline parameters

To start HIMES type the following commandline :

     HIMES [Filename] [/R] [/E]

The 3 parameters are optional. The first specifies a filename of a
programfile which is loaded at the progamstart. If the secand
parameter is given then the program is started immediatly after start
of HIMES. If third parameter is given, then HIMES ends after the
interpreterprogram has finished.



                   Description of the commands
                  =============================

1     DATA

1.1   Read

    The  active ones of the first 4 channels are readed from  the
    DSO. Can be started also with F1-key.

1.2   Write

    If  channel  3  or 4 (5 to 8 for VC-6145)are aktive they will be
    written  to  the reference-channels of the DSO. This command don't
    work on VC-54xx and VC-7xxx.

1.3   Load

    You can load signals from disk or card-reader. A window opens
    and ask you for input. You have to key in 2 parameters :

       - filename on the disk or signalnumber on the memory-card.
         If   the  first  character  is  a 'S' and then follows
         number  between 1 and 15 the  it is interpreted  as a
         signalnumber on the memory-card. If the filename is like
         'WAVExxxx.DAT' (xxxx is a number between 1 and 9999) and the
         connected DSO is a VC-7xxx the data are read from the IC-card
         which is plugged in the DO.If the connected DSO is a VC-54xx
         the data are read from the internal 100 savememories.
         Otherwise the data are read from disk.
         For filenames you  can  also  use wildcards like '*.DSO' .
       - signalnumber on the pc to store the data. If this signal-
         number is 0 then all active channels in the active windows
         are loaded from files where the channelnumber is added to the
         given filename.

    The 2 parameters should be separated by blank or comma.

1.4   Save

    Save  of signals on disk or memory-card.  Parameters are  the
    same as with load. No wildcard are allowed. If you use an 'a'
    or 'A' as an optional third parameter, the data are stored as
    a readable ASCII-File. If you use an 'd' or 'D' as an optional
    third parameter, the data are stored as a readable DADISP-File.
    If you use an 'i' or 'I' as an optional third parameter or the
    filename has the format 'WAVExxxx.DAT', where 'xxxx' is a number
    the data are stored in the format which is used on IC-cards for
    VC-710x. If the filename is like 'WAVExxxx.DAT' the data are written
    via the DO to the plugged in IC-card.


1.5   Quit

    Quit the program.


2     Display

2.1   Window

    Configuring  the display.  First you can select which  window
    should be the active one.  Then you can determine the  active
    channels  of  these  window.
    With the F2-key you can quickly toggle between the 2 windows.


2.2   Continous

    Continous  display.  The  data  are read  from  the  dso  nad
    displayed until a key is pressed.


2.3   Zoom/Curs

    You will reach the cursormode.

2.4   Move

    Copy one channel to another.

2.5   Delete

    Delete one channel.


2.6   Plot

    Plots the aktive window to a plotter or a file.

2.7   Print

    Prints the aktive window to a printer or a file. If you specify
    an outputfilename with the extension ".PCX" then the printdata
    are stored in the PCX-format. This format can be used to manipulate
    the picture and to export the picture to several DTP- or wordprocessor-
    programs. The size and the orientation can be selected by the option
    "LANDSCAPE" in "DIV OPT'NS".

3     Calc

3.1   Interpr

    Starts  the built in interpreter.  With this interpreter  you
    can make your own special calculations and programs.  Can  be
    selected by F3-key. ( only full-version ).

3.2   Math

    You will reach a selector-table with mathematical functions.

3.3   Filter

    You will reach a selector-table with filter-functions for the
    FFT. ( only full-version ).

3.4   FFT

    You  will  reach  a selector-table with  the  different  FFT-
    functions. ( only full-version ).


4     Watch

    With this submenu you can make an automatic control of 1 or 2
    signals.  You  can  create borders for every signal and  then
    start  an automatic checking if the signals are  inside  this
    borders. ( only full-version ).

4.1   Edit

    Editing of the borders. The reference signal is displayed and
    you  can draw the borders by mouse.  When you press the  left
    button  a new part of the border is calculated from the  last
    point  to the new cursor-position.  When you reach the  right
    rand  of the window the border is finished  and you can start
    with  the next one.  If you have created the 2 borders  press
    the right button to leave the edit-mod  ( only full-version).
    When this function is used to create borders for the internal 
    GO-NOGO-mode of a VC-54xx or VC-7xxx the the option DISP-MEM 
    in DIV OPT'NS should be activated before reading the 
    reference-signal.

4.2   Start

    Start  of  the  automatic control.  In every cycle  there  is
    always made a new measurement and the data are transferred to
    the DSO.  Then the data are compared with tha borders. If the
    data  are outside the borders this is written on the  screen.
    The  first signal which was outside is also  saved. The
    displayed data is stored in a log-file. It is also possible to
    select a filename to store wrong signals.( only full-version )

4.3   Alarm

    You  can  select between an acustic alarm only at  the  first
    error, at every error, or no alarm.( only full-version ).

4.4   Transfer

    Transfer the signals in CH5 and CH6 to the DO (VC-7xxx or VC-54xx) as
    borders for the GO-NOGO-mode.

5     Scope

5.1a  Time Range             ( if DSO-type is not VC-7xxx or VC-54xx )

    Selection of the timerange for the DSO.

5.1b  Man Setup              ( only if DSO-type is VC-7xxx or VC-54xx )

    Remotecontrol of channelsetting, timebase, delay and trigger
    for DO.

5.2   Shot Norm

    Selection between normal shot,  average shot and no shot. The
    selected shot is performed every time read the data from  the
    DSO.

5.3a  Exec Shot              ( if DSO-type is not VC-7xxx or VC-54xx )

    Execute the selected shot on the DSO.

5.3b  Run / Hold             ( only if DSO-type is VC-710x or VC-54xx )

    Set the DO to the selected status.

5.4a  Request                ( if DSO-type is not VC-7xxx or VC-54xx )

    Execute a service-request.

5.4b  Rec Setup              ( only if DSO-type is VC-7xxx or VC-54xx )

    Load a selectable setupfile from disk and send it to the DO or recall an
    internal setupmemory ( filename S1 to S10 ).

5.5a  Init                   ( if DSO-type is not VC-7xxx or VC-54xx )

    Initialize the DSO.

5.5b  Save Setup             ( only if DSO-type is VC-7xxx or VC-54xx )

    Read setup from DO and save it in a selectable file on disk or to an
    internal setupmemory ( filename S1 to S10 ).

5.6   Autosetup              ( only if DSO-type is VC-7xxx or VC-54xx )

    Activate the Autosetup at the DO.

5.7   Dial/Hngup

    Connection to a VC-54xx via modem and telephoneline.

6     Option

6.1   Div-Opt'ns

    Switching on and off for 9 settings :
    Grid : display of the grid on the screen.
    Interp : interpolation of the datapoints.
    Envelope : envelope-mode
    Disp-mem : if this option is on, then at the RSO's VC-6023/24/25/45, 
               VC-6145 and VC-6155  and the DO's VC-54xx and VC-7xxx
               only the part of signal is transferred to the PC which is
               visible on the scope's screen.
    Persistance : works in connection with the continous-mode. The old
                  signals will be not deleted from the screen, but
                  displayed in a lighter color.The new signals will be
                  added. After some time you will have a picture of many
                  signals, where you can detect minima, maxima and
                  phaseshifting. Ypu can also detect slow changes of the
                  signal. A documentation of this picture is only
                  possible with a hardcopy of the screen. As soon as the
                  display will be refreshed, the older lighter displayed
                  signals will disappear, because the are only 'stored'
                  on the screen.
    Condensed   : if this option is on, a hardcopy started by the
                  print-screen-button will be printed condensed. On
                  some printers the characters will be hard to read.
    XY-mode     : if this option is on the signals will be displayed
                  in xy-mode. The x-channel can be selected for each
                  window in the WINDOW-command, the y-channels are the
                  active channels.
    Landscape   : if this option is on the printout is done in the
                  landscape-format, otherwise it is done in the
                  portrait-format. In landscape-format there is one
                  picture per sheet, in the portrait-format there are
                  2 pictures per sheet. If you use a laserprinter in
                  portrait-format the paper will be ejected only after
                  the second picture. If you want to eject after the
                  first picture you have to do this manually using the
                  laserprinter's frontpanel.
    Parameter   : if this option is on the parameters are calculated and
                  displayed on the print- or plotout. ( only full version )

6.2   Disp

    Selection of the kind how to display the cursor-position.
    Selections  :  - disp  normal :  absolute position of  actual
                      cursor is displayed
                   - disp  delta  :   difference  between  the  2
                      cursors is displayed
                   - disp  freq  :  like  disp  delta  but  time-
                      difference is displayed as a frequency
                   - disp off : no display

6.3   DSO-type

    Selection of DSO-type. You can select between :
      - VC-6023/24/25
      - VC-6045
      - VC-6145
      - VC-6155
      - VC-6x65
      - VC-6x75
      - VC-7102
      - VC-7104
      - VC-7124
      - VC-5410
      - VC-5430
      - VC-5460


                     Commands in cursormode
                    ========================

In the cursormode you can make the cursormeasurements.
The  cursors  can  be moved by mouse  or  cursorkeys.  To  toggle
between the 2 cursors use the right mousebutton or the returnkey.
Several commands can be started by functionkeys.

F1   : Read data from DSO.
F2   : Toggle between the 2 windows.
F3   : Start interpreter    ( fullversion only )
F4   : Math calculations.
F5   : Select measure-channel.
F6   : Calculation of rise- or falltime, over- and undershoot.
       The  horizontal  part of the 2 cursors is used to get  the
       amplitude  of  the  signal  at  this  positions.   This  2
       amplitudes are used as 0% and 100% amplitude to  calculate
       the rise- or falltime, the over- and undershoot.
       ( only full-version ).
F7   : The  horizontal part of the 2 cursors is used to extract a
       part of the signal.
       Calculate  the  signal-parameters of the signal between the 2 cursors.
       ( only full-version ).
F8   : The  vertical  part  of the aktive  cursor  determines  an
       amplitude.
       Count the events crossing this amplitude,  calculating the
       frequency  out of this events,  and calculating the  ratio
       of  the part which are above this level by the part  which
       is lower than this level.
       ( only full-version ).
F9   : Zoom  the  area between the 2 cursors to the full size  of
       the window.
F10  : Fix the cursors on the signal.

Shift + F3  : Start program in interpreter ( only full-version )
Shift + F5  : Toggle the way of cursor-measurement
Shift + F9  : Resize the signal to its original size.

Print-screen : Start printing out a hardcopy of the screen. The file
               or interface specified in the PRINT-command is used
               as output-device.

"#"  : Shortcut for "Man Setup".      ( only in version for VC-710x, VC-54xx )
"<"  : Read setup-information from DO. Necessary to update setup-
       information in PC after manual changes was made on DO.
       ( only in version for VC-710x, VC-54xx )
"@"  : Connect to a VC-54xx via modem ( only in full version )


                           Interpreter
                          =============

The  interpreter  offers  the  possibility  to  write  your   own
application  programs  for HIMES.

This programs you can either write in the built-in editor or outside
HIMES with any textprocessor.

You can use only one statement per line. When a line ends with "\"
then it means that the actual statement is carried on in the next line.

The built-in editor supports the following special-function-keys :
  - the four cursor-keys
  - the Page-up- and Page-down-key
  - the Home- and End-key
  - the Delete-key
  - the Backspace-key
  - the Insert-key
  - Ctrl-Y                  (delete the actual line)

For an easier handling of single-line commands, which you enter at the
prompt, the interpreter offers a repeat-function. When you type a
space-character directly after the prompt "# " then the last command
will be copied in the actual line and you have the possibility to edit
this line and to execute the resulting command.



                         Available data

In your programs you can use 2 kinds of data :
  - 9 registers which can store one number  (R1 .. R9)
  - 8 channels which can store one signal as you can read it from
      the DSO ( CH1 .. CH8 )


                      Available structures

The interpreter offers 3 kinds of program-structures.
  - if-clause

        if < boolean expression >
          command
          .                         ( part 1 )
          .
        else
          command
          .                         ( part 2 )
          .
        endif

    If  the  boolean  expression is true,  then part  1  will  be
    executed, else part 2.


  - while-loop

        while < boolean expression >
          command
          .
          .
        endwhile

    While the boolean expression is true, the commands within the
    loop will be executed.


  - call subprogram

        .
        .
        call label
        .
        .


        label:
          command
          .
          .
        return

    The program execute the commands between the label and return
    then it execute the next command after the call-command.

All of these structures can be nested.



                           Operators

The  operators  can be divided in several groups  with  different
priorities :

  high pr.    -  parents, math-functions (sin, cos...), negation
              -  *, /, and
              -  +, -, or, xor
  low pr.     -  =, <>, >, >=, <, <=



                           Expressions

Expressions  are built up recursive.  The forms of an  expression
are :
               expression1  operator expression 2

                               or

                             operand

Operands can be channels or registers.




                  Syntax of functions of HIMES


value  := arctan(value)            calculates the arctan in grad
value  := sin(value)               calculates the sine
value  := cos(value)
value  := ln(value)
value  := exp(value)

  value can be a number (register or constant) or a channel, both
  values must have the same format.

number := average(chx)             calculates  the  average-value
                                   of a channel
number := length(chx)              returns the number of points - 1
                                   of a channel
number := min(chx)                 returns minimum amplitude of a
                                   channel
number := max(chx)                 returns maximum amplitude of a
                                   channel
number := interval(chx)            returns the time-interval
                                   between 2 datapoints of the
                                   selected channel

number := chx[number]              extract one datapoint  of  a
                                   signal
number := success                  returns 1 if the last READ-, LOAD- or Dial-
                                   operation was succesfull, otherwise 0
chx[number] := number              modify one datapoint  of  a
                                   signal.  Usefull  for  signal-
                                   generation,
chy    := deriv(chx)               calculates the derivation
chy    := integ(chx, start-point)  calculates the integration of a
                                   channel beginning at the startpoint

chy    := blackman(chx, start-point, length)
                                   calculates the  blackmanwindow
                                   of chx starting at start-point
                                   with length points.  length is
                                   rounded   down  to  the   next
                                   exponent of 2.
chy    := hamming(chx, start_point, length)  see blackman
chy    := hanning(chx, start_point, length)  see blackman
chy    := rect(chx, start_point, length)     see blackman
chy    := movavg(chx, length)      calculates the moving average with
                                   the selected windowlength of a
                                   channel

chy    := spectrum(chr)            calculates   the   normalized
                                   amplitude-spectrum.
chy    := fftm(chr [, chi])        calculates   the   amplitude-
                                   spectrum.   chr  is  the  real
                                   input-channel, if chi is given
                                   this  is the imaginary  input-
                                   channel,     otherwise     the
                                   imaginary part is set to 0.
chy    := fftp(chr [, chi])        calculates the phase-spectrum.
chy    := fft(chr [, chi])         calculates  both spectra.  the
                                   amplitude-spectrum  is  stored
                                   in chy,  the phase-spectrum is
                                   stored in the next channel. if
                                   chy is the last channel,  then
                                   the  phase-spectrum is  stored
                                   in the first channel.
chy    := ifft(chm, chp)           calculates the inverse fft. in
                                   chm  must  be  the  amplitude-
                                   spectrum,  in  chp the  phase-
                                   spectrum.

refcalc(cha, chb)                  change scaling of chb to the
                                   scalling of cha

display(w-nr)                      display  the specified  window
                                   again. w-nr in 1..3 .
window(w_nr, cha [, chb, ...])     specifies  the active  channel
                                   for  a  window  and  make   it
                                   active.
plot(w-nr, name, size, position, comment1, comment2)
                                   plots a window to the file name
                                   size = 1   position 1
                                              ͻ
                                                         
                                                   1     
                                                         
                                              ͼ

                                   size = 2   position 1 .. 2
                                              ͻ
                                                         pictures
                                                1    2   are
                                                         rotated
                                              ͼ

                                   size = 4   position 1 .. 4
                                              ͻ
                                                1    2  
                                              ͹
                                                3    4  
                                              ͼ

print(w-nr, name, comment1, comment2)
                                   prints a window to the file name

read(cha [, chb, ...])             reads  the specified  channels
                                   from the dso. only ch1..ch4.
write(cha [, chb, ...])            writes  the specified channels
                                   to the dso. only ch3..ch4.

message('const-text', number:length:decimal-digits)
                                   prints a  message.  parameters
                                   can  be  a textconstant  or  a
                                   number.  number  of parameters
                                   is not limited. if a parameter
                                   is  a number you  can  specify
                                   the  format of output.  length
                                   is  the  total length  of  the
                                   number,  decimal digits is the
                                   number  of  digits  after  the
                                   decimal-point.

rx := readnum                      you  can  input  a  number  at
                                   runtime of the program.

key                                returns  the code of  the  the
                                   key or 0 if no key is pressed.

printer on/off                     when   printer  is   on,   all
                                   output,  which is displayed on
                                   the screen is also send to the
                                   printer.

debug on/off                       when  debug  is on,  then  the
                                   text of each executed line  is
                                   displayed.

load('name', cha)                  loads the file 'name' in cha.
save('name', cha)                  save cha in file 'name'.
delete(chx, chy, ...)              deletes the selected channels
create(length, interval)           create a signal with length data
                                   -points. Samplerate is the reziprok
                                   value of interval. Amplitude is 1V.
dial('const-text')                 dial a telephonenumber to connect to a
                                   VC-54xx
hangup                             disconnect the telephoneline
psave ['name']                     save the program-text. if name
                                   is  specified  the program  is
                                   stored in file name, otherwise
                                   it  is  stored in  the  files,
                                   which  was specified the  last
                                   time.
exec ['name']                      execute the program.  if name  is
                                   specified,  then the file name
                                   is load first,  otherwise  the
                                   program   in  the  memory   is
                                   executed.

edit ['name']                      you   can  edit  the  program.
                                   parameter like run.
new                                clear programtext
quit                               exit the interpreter.



                    Format of the ASCII-File
                    ========================

az 1                         Identification and versionnumber
                             Commentline
0  0.00000000000000E+0000  2.50062498707848E-0006 S    Horizontal reference,
                                                       horizontal origin,
                                                       time per point,
                                                       horizontal unit
 0.00000000000000E+0000  3.92156885936856E-0003 V      Vertical offset,
                                                       volt per point,
                                                       vertikal unit
511                                                    Number of datapoints - 1
 0.00000000000000E+0000                                Data
 4.91635893931042E-0002
 9.82082649416682E-0002
 1.47015449392107E-0001
 1.95467029238374E-0001
 2.43445885787690E-0001
 2.90835947519135E-0001


 Informations in the configurationfile "HIMES.CFG"
 =================================================

DSO-model                       : VC-7104           Type of dso you want to use
                                                    with HIMES
serial port                     : COM2              serial port used for
                                            VC-6023/24/25/45, VC-6145, VC-6155
                                            VC-7xxx, VC-54xx and card-reader
aktive channels in window 1, 2  : 2
aktive channels in window 3     : 1
aktive window                   : 2
x-channel in window 1, 2        : 1
x-channel in window 3           : 2
interpolation                   : ON
grid                            : on
envelope-mode                   : off
display-transfer only           : off               When on the in case of
                                                    VC-6023/24, VC-6025/45
                                                    VC-6155, VC-6145 
                                                    VC-54xx and VC-71xxx only
                                                    the displaymemory is read
                                                    from the scope.
xy-mode                         : off
cursor                          : norm
shot-type                       : NORM
GPIB-adress of DSO              : 1                 GPIB-adress of the dso
Baseadress of NEC7210           : $2b8              baseadress of the
                                                    controller-chip
                                                    on your GPIB-board.
                                                    Please refer to the
                                                    manual of this board.

                                                    board  baseadr
                                                    CEC     $2b8

type of graphic-adaptor         :                   you can select between
                                                    CGA, EGA, VGA and HERCULES
                                                    if nothing is selected then
                                                    the program looks auto-
                                                    matical for the rigth
                                                    adaptor

monochrome or color display     :                   use monochrome when you have
                                                    only a monchrome display
Plot-position (x1 x2 x3 x4)     : 0 5300 5500 10800   you can modify the size of
Plot-position (y1 y2 y3 y4)     : 0 3332 3468  6800   your plotout. Refer your
number of plotter-pens          : 4                   plottermanual.

                                        ͻ y4
                                                            
                                                             y3
                                        ͹ y4
                                                            
                                                            
                                        ͼ  y1
                                        x1       x2  x3       x4

printer-type                    : EPSON LANDSCAPE         can be EPSON or HP
                                                          can be LANDSCAPE
                                                             or PORTRAIT

Modem-baudrate and timeout      : 9600 40                 baudrate can be max.
                                                          9600
                                                          timeout is used to
                                                          check time from dialing
                                                          until connection
Modem-initialising              : ATZS7=20                input your modem-
                                                          initialization
Dial-prefix                     : ATDT                    your dialprefix
                                                          (tone- or pulsedialing)
Hangup-string                   : +++ATH
Telephone-number                : 49                      default telephonenumber


 Informations about the dipswitch-setting on RSO's
 =================================================

The dipswitch-setting on VC-6023/24, VC-6025/45 and VC-6145 should
be as following :

1  2  3  4  5  6  7  8                            u  =  up     ( off )
                                                  d  =  down   ( on  )
x  x  x  u  u  u  d  u                            x  =  don't care

This setting means : 9600 BAUD, 8 databit, 1 stopbit, delimiter = CR


 Informations about cabel between PC and DSO
 ===========================================

For all DSO's except VC-54xx

DSO                                   PC
25 pin male con.        25 pin female con.      9 pin female con.

1  ---------------------  1  -----------------  not available
2  ---------------------  3  -----------------  2
3  ---------------------  2  -----------------  3
4  ---------------------  5  -----------------  8
5  ---------------------  4  -----------------  7
7  ---------------------  7  -----------------  5
                          \                   /
                               alternately

For VC-54xx

DSO                                   PC
9 pin male con.        25 pin female con.       9 pin female con.

2  ---------------------  2  -----------------  3
3  ---------------------  3  -----------------  2
5  ---------------------  7  -----------------  5
                          \                   /
                               alternately
