home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / MULTITIM / README.TXT < prev   
Encoding:
Text File  |  1996-01-10  |  10.4 KB  |  244 lines
  1. README.TXT
  2.  
  3. MultiTimer 
  4.    for the Psion 3a handheld computer
  5.    Created 1995 by Erik Johansen <ej@it.dtu.dk>
  6.  
  7.    Version 1.00  -  Released December 1995 / January 1996
  8.  
  9. DESCRIPTION
  10.    Many a time have I longed for a timer program for the Psion.
  11.    I have tried out most available timer programs and none have
  12.    matched my needs. Most timers can have only one counter, and
  13.    require the time length to be retyped every time restarted.
  14.  
  15.    With MultiTimer things work a bit different. Only one counter
  16.    (the first counter to expire) is visible at a time. But still
  17.    up to 30 timers/jobs can be active at a time. MultiTimer does
  18.    its work the same way as a multitasking scheduler. [This is
  19.    still not perfect. Menus and dialogs temporarily stops the
  20.    scheduler - so remember to exit dialogs]
  21.  
  22.    Up to 255 functions can be predefined (one for each ascii key
  23.    combination).
  24.  
  25.    A 'timer' is started by pressing the associated key.  F.ex.:
  26.    If the 'b' function is defined as 'W(28) B W(28) B', every
  27.    time the 'b' key is pressed a new job shows up, first waiting
  28.    28 seconds, giving a beep, waits another 28 seconds and gives
  29.    another beep. This function I often use as a Waffle Timer when
  30.    baking waffles.
  31.  
  32.    Internal functions that require parameters will prompt
  33.    if a function name is typed directly from keyboard. For example
  34.    press the 'W' key and you will be prompted for the wait time.
  35.    Furthermore 'W' defaults to adding a 'B' bell when started
  36.    from the keyboard.
  37.  
  38.    Jobs can be stopped/killed by placing the cursor over the job
  39.    in the rightmost column and pressing delete. Tha last one
  40.    killed can be inserted (restarted) by pressing Psion-I.
  41.  
  42.    Some examples of often used functions are:
  43.  
  44.    W(2h30m)S(Parking)           Remember to put a coin in the parking
  45.                                 meter after 2 hours 30 min
  46.  
  47.    h:  W(:00) B W(:30) B h      Forever: beep every half hour
  48.  
  49.    W(19:30) V(s) W(20:00) V(S)  Turn off all sounds from 19:30 to 20:00
  50.  
  51.  
  52. FUNCTIONS
  53.    Built-in functions are in uppercase to make it easier to define true
  54.    one-key user definitions.
  55.  
  56.    Function          Example(s)            Description
  57.    ----------------  --------------------  ------------------------------
  58.    A(Time,Message)   A(12:30,Hello)         Schedule a regular alarm
  59.                                             at specified time.
  60.  
  61.    B                 B                      Beep/Bleep 3 tone sound
  62.  
  63.    D(PhoneNumber)    D(1,555 1234)          Dials the phone number using
  64.                      D(*2# *3212#)          touch tone dial codes.
  65.  
  66.    M(MacroName)    M(\macro\mco\Hangup.mco) Calls macro system
  67.                                             (Tom Dolbilin)
  68.  
  69.    N(Notes/Tones)    N(3abcdefg)            Plays the notes represented
  70.                      N(wow wow)             by letters:
  71.                      N(20z)       <number>  Tone length in 1/20 sec for
  72.                      N(25gjgjgj)            notes follwing.
  73.                      N(5abk log)  a-z       Notes to play
  74.                      N(10bac8 d d)          freq=440+2**(n%/12)
  75.                                             n%=3,5,8,10,12 skipped.
  76.                                   <space>   Silence (freq=0)
  77.                                   <other>   Includes the function definition
  78.                                             specified by that character.
  79.                                             The definition should not
  80.                                             include N()
  81.                      N(10y y y 20y 10y 20y 10y y)
  82.  
  83.    O(Commands)       O(Commands)            Starts a new process with a
  84.                      O(W(:00)S(bell))       definition that is not bound
  85.                                             to a key. This is the same
  86.                                             as the &() function.
  87.                                             Can be used in a definiton to
  88.                                             start parallel functions.
  89.  
  90.    P(Options)        P                      Power off (unconditionally)
  91.                                             Currently all options are
  92.                                             ignored.
  93.                                             [Planned: P(?) off after alarm
  94.                                             caused Psion to turn on. P(n)
  95.                                             set auto switch off time]
  96.  
  97.    R<n>(Commands)    R25(S(Wroom))          Repeat sequence of commands
  98.                                             number of times
  99.  
  100.    S(SoundFile,Time) S(Wroom)               Plays the specified sound
  101.                      S(Wroom,30)            Internal sounds can be
  102.                      S1  or  S(1)           specified as 1/2/3
  103.                                             The optional time parameter
  104.                                             limits the sound to x/20 sec.
  105.  
  106.    T                 T                      Start/Stop Stopwatch
  107.                                             The Stopwatch timer has lower
  108.                                             priority than all alarms and
  109.                                             is only shown when no other
  110.                                             timers are active. The stopwatch
  111.                                             can be used as a simple flag
  112.                                             to synchronize two jobs. First
  113.                                             job starts the timer, Second
  114.                                             job makes both jobs continue.
  115.  
  116.    V(Volume control) V(3)                   Sets volume of Psion sounds
  117.                      V(s)             s/S   Sound system (all) off/on
  118.                      V(5KBNa)         k/K   Keyboard click off/on
  119.                                       b/B   Beep off/on
  120.                                       a/A   Alarms off/on
  121.                                       c/C   Low/High Click (keyboard)
  122.                                       n/N   Low/High Notes (Beep)
  123.                                       1-5   Sound level
  124.  
  125.  
  126.    W(Time)           W(1/jun/)              Wait until time specified
  127.                      W(tomorrow)            The Psion is automatically
  128.                      W(3m)                  turned on when the timer expires
  129.                      W200                   If no other commands follow the
  130.                      W(12:00)               Wait function, then a Beep is
  131.                                             automatically added.
  132.                      W(mon thu fri 12:30)   <= Absolute time
  133.                      W(1d 10h 30m 10s)      <= Relative time
  134.                      W(//1995)              =  1/jan/1995 00:00:00
  135.                      W(25/12 18: 19:30)     = 25/dec/1995 18:30:00 or 19:30:00
  136.                      W(oct)                 = October (next match)
  137.                      W(1/ 2/ 3/ mon)        = next monday that is 1st-3rd
  138.                                               day of the month
  139.  
  140.    FunctionName      a                      Call/include definition of
  141.                      k                      other function.
  142.  
  143.    "Comment"         "Good morning"         Print text at bottom right
  144.                                             for a few seconds.
  145.  
  146.    &(Commands)       &(W(:30)B)&(W(:00)B)   Starts a parallel job
  147.  
  148.    <space>                                  Ignored
  149.  
  150.  
  151. Psion combination keys
  152.  
  153.    Psion-A     Save as
  154.    Psion-C     Copy
  155.    Psion-D     Delete
  156.    Psion-E     Edit
  157.    Psion-I     Insert
  158.    Psion-J     Jump to
  159.    Psion-M     Merge file
  160.    Psion-N     New file
  161.    Psion-O     Open file
  162.    Psion-R     Repaint screen
  163.    Psion-S     Save
  164.    Psion-W     Who did this?
  165.    Psion-X     Exit
  166.  
  167. Other keys
  168.  
  169.    ESC         During sound: Stop sound. Otherwise return to system screen.
  170.    DEL         Delete definition / Kill job  (use Psion-I to reinsert)
  171.    MENU        Gives menu of the above functions
  172.    HELP        Gives a few help screens
  173.    ENTER       Edit function definition
  174.  
  175.    Cursor keys behave differently depending on the what field the cursor is in
  176.  
  177.       Input field:       DOWN moves to Function Definiton field
  178.       Definition field:  UP/DOWN moves between definitions (scrolls)
  179.                          LEFT moves to Input field
  180.                          RIGHT moves to Active Job field
  181.       Active job field:  UP/DOWN moves between jobs
  182.                          LEFT moves to Function Definition field
  183.    
  184. INSTALLATION
  185.  
  186.   Copy MULTITIM.OPA into an \APP\ directory and install Multitim
  187.   from the system screen (Psion-I), and you should be ready to run.
  188.  
  189.   \OPL\MULTITIM.OPL and \OPD\MULTITIM.PIC are only needed if you want
  190.   to recompile the program.
  191.  
  192. AVAILABILITY
  193.  
  194.    New versions will be announced by mail to registered users and on my
  195.    psion home page at   http://www.it.dtu.dk/~ej/psion.html
  196.  
  197.    ftp://ftp.frontiernet.net/pub/psion/utils/multitim.zip
  198.    ftp://src.doc.ic.ac.uk/packages/psion/icdoc/utils/multitim.zip
  199.    ftp://ftp.it.dtu.dk/pub/ej/psion/multitimer/mt100.zip
  200.    comp.binaries.psion newsgroup and archives 
  201.       
  202.  
  203. REGISTRATION
  204.  
  205.    Multitimer is shareware
  206.  
  207.    You have a 30 days test period. After that you are required to send
  208.    a $10 ShareWare fee (in any currency - no coins, please) to
  209.  
  210.    Erik Johansen
  211.    Danish Technical University
  212.    Department of Information Technology
  213.    Building 344/345
  214.    2800 Lyngby
  215.    Denmark
  216.  
  217.    Please include your Name and E-mail address.
  218.  
  219.    When your registration has been processed, you will receive the newest
  220.    version by mail (uuencoded zip file). Your address will be added to
  221.    a mailing list for registered users. New versions of Multitimer will be
  222.    announced on the mailing list. I am currently working on setting up
  223.    WWW access for registered users to download the most recent versions.
  224.  
  225.    Here are just some of the features that are planned in the next version,
  226.    only available to registered users:
  227.  
  228.    *  Edit/Modification of jobs after queueing. This makes it easy to just
  229.       press W <time>, then modify the action or time afterwards.
  230.  
  231.    *  Extended note capability for N().
  232.  
  233.    *  Auto power-off feature. Checks if the psion is active.
  234.  
  235.    *  E(time,function)    Every <time> do <function>
  236.       F.ex.:  E(9:00 10: 11: 12: 13: 14: 19: 20: 21:, S(Cuckoo))
  237.  
  238.    *  And other new exciting features.
  239.  
  240.  
  241. If you have ideas for changes or improvements to MultiTimer,
  242. you are more than welcome to send them to me.
  243.  
  244. ej@it.dtu.dk