{"id":539,"date":"2011-08-24T14:09:54","date_gmt":"2011-08-24T14:09:54","guid":{"rendered":"http:\/\/www.raveon.com\/data_radio_info\/?p=539"},"modified":"2011-08-24T15:49:20","modified_gmt":"2011-08-24T15:49:20","slug":"using-a-macro-file-to-configure-a-data-radio-modem","status":"publish","type":"post","link":"https:\/\/www.raveon.com\/data_radio_info\/using-a-macro-file-to-configure-a-data-radio-modem-539\/","title":{"rendered":"Using a Macro File to Configure a Data Radio Modem"},"content":{"rendered":"

<\/a><\/p>\n

The terminal emulation program Tara Term is an easy-to-use terminal emulator, similar in function to HyperTerminal or Procomm.\u00a0 But, Raveon finds it is easier to use, more reliable, and has better features.\u00a0 One of its new features is the ability to process a “Macro File”.\u00a0 It is a very handy program to communicate with a Raveon data radio modem, and\u00a0is a good way to automate the\u00a0configuing your radio modem.\u00a0<\/p>\n

Tera Term is an open-source terminal emulation program that is easy to use, and very powerful.\u00a0 Raveon recommends using it over Hyperterminal.\u00a0 Version 4.7 is currently available for download at logmett.com here: http:\/\/logmett.com\/index.php?\/download\/download-tera-term-470-freeware.html<\/a>\u00a0\u00a0 Tera Term\u00a0has a Macro FIle\u00a0script processor that allows a person to create\u00a0a script file of macro commands. The Script file can configure the radio modem, prompt the user for input, and validate the programming of the radio modem.<\/p>\n

Tera Term Macro files have an extension .TTL.\u00a0\u00a0 When in install Tera Term, the .TTL extension will be associated with Tera Term, so anytime you click on a .TTL file, the Tera Term maco processor should run it.\u00a0 If it does not, you can manually associate the “TLL” file as described below.\u00a0<\/p>\n

The macro File with the .TTL extension must be created before you can run it.\u00a0 Raveon may provide this for you, or you may create this yourself.\u00a0 Information about Tera Term’s Macro abilities is here:http:\/\/ttssh2.sourceforge.jp\/manual\/en\/macro\/<\/a>\u00a0 although you may have to search the Internet for more details.\u00a0 A good way to understand it, is to study a macro file provided by Raveon.<\/p>\n

When you run a macro file, there will be at least two windows pop-up, and maybe three windows.\u00a0 The\u00a0largest window is the Tera Term program itself.\u00a0 As the macro runs, there will be a small window titled MACRO – xxxxx where xxxxx is the name of the macro file that is running.\u00a0 You can pause or end the macro execution by clicking on a button on this window.\u00a0<\/p>\n

At various plces in the macro file script, the user may be promoted to enter a paramter, or answer yes\/no to a question.\u00a0 A good practice at the end of the script is\u00a0have the macro script close Tera Term so another script may be started.<\/p>\n

\"\"<\/a><\/p>\n

How to associate “TTL” files with MACRO<\/h2>\n

Since Tera Term 4.59, you can associate “.TTL” files with MACRO with installer.\u00a0 To associate the file extension “.TTL” with MACRO, do the following steps.<\/p>\n

    \n
  1. Execute the [View] Options command of Explorer.<\/li>\n
  2. Select the “File Types” tab.<\/li>\n
  3. Click the “New Type” button and specify items like the following.\n
    Description of type: Tera Term macro files Associated extension: TTL<\/pre>\n<\/li>\n
  4. Click the “New” button and specify items like the following.\n
    Action: Execute Application used to perform action: \"C:\\Program Files\\teraterm\\ttpmacro.exe\" \"%1\" (If Tera Term Pro is installed in C:\\Program Files\\teraterm.)<\/pre>\n<\/li>\n
  5. Close all the dialog boxes by clicking “OK” buttons.<\/li>\n<\/ol>\n
    Macro Example<\/h2>\n
    Below is a simple example macro script to program a Raveon M7 radio modem.\u00a0<\/p>\n
    CONNECT '\/C=1'\r\nSEND '+++'<\/span><\/pre>\n
    :START\r\n;READ UNIT ID\r\nPAUSE 1\r\nSENDLN 'MYID'\r\nPAUSE 1<\/span><\/pre>\n
    yesnobox 'CHANGE UNIT ID?' 'CHANGE UNIT ID?' <\/span><\/pre>\n
    if result goto CHANGEID GOTO DESTINATION \r\n<\/span>:CHANGEID \r\n<\/span>;CHANGE UNIT ID \r\n<\/span>inputbox 'ENTER UNIT ID' 'MYID' \r\n<\/span>SENDLN 'MYID ' INPUTSTR<\/span><\/pre>\n
    :DESTINATION \r\n<\/span>;READ DESTINATION ID \r\n<\/span>PAUSE 1 \r\n<\/span>SENDLN 'TOID' \r\nPAUSE 1 \u00a0 \r\nyesnobox 'CHANGE DESTINATION ID?' 'CHANGE DESTINATION ID?' \r\nif result goto DESTID GOTO RXFREQ \r\n:DESTID \r\n;CHANGE DESTINATION ID \r\ninputbox 'ENTER DESTINATION ID' 'TOID' \r\nSENDLN 'TOID ' INPUTSTR<\/span><\/pre>\n
    :RXFREQ\r\n;READ RX FREQ\r\nPAUSE 1\r\nSENDLN 'ATFR'\r\nPAUSE 1<\/span><\/pre>\n
    yesnobox 'xxx.xxxx' 'CHANGE FREQUENCY?' \r\nif result goto SETFREQ GOTO ECHOSTEP \r\n:SETFREQ\r\n;CHANGE FREQUENCY \r\ninputbox 'ENTER FREQUENCY' 'ATFX' \r\nSEN<\/span>DLN 'ATFX ' INPUTSTR<\/span><\/pre>\n
    ;SET ECHO ON \r\n:ECHOSTEP\r\n<\/span>\r\n\r\n\r\n\r\nSENDLN 'ATE 1'<\/span>\r\n
    ;SET CARRIER DETECT TO SHOW ON-LINE STATUS (BASE AND REMOTE)\r\nSENDLN 'ATR1 2'\r\nPAUSE 1<\/span><\/pre>\n
    ;SET ON-LINE AFTER DIAL (DISABLED ON BASE ONLY)\r\nSENDLN 'ATCS 0'\r\nPAUSE 1<\/span><\/pre>\n
    SENDLN 'SHOW'\r\nPAUSE 2<\/span><\/pre>\n
    yesnobox '\"Y\"= FINISHED, \"N\"= RESTART' 'ALL PARAMETERS CORRECT?' \r\nif result goto CLOSE GOTO START<\/span><\/pre>\n
    :CLOSE\r\ndisconnect 0 ;disconnect from teraterm, no confirmation\r\nclosett ;close tera term window\r\nEND<\/span><\/pre>\n
    \u00a0<\/h1>\n
    Tera Term Macro Language Information<\/h1>\n
    Following is a quick overview of the Tera Term Macro Language. \u00a0<\/p>\n
    Identifiers and reserved words<\/h2>\n
    1) Variable identifiers<\/h3>\n
    The first character must be an alphabetic (A-Z, a-z) or an underscore character \"_\". Subsequent characters can be alphabetic, underscore or numeric (0-9). Variable identifiers are not case sensitive. The maximum length is 32.<\/p>\n
    Example:\r\n    VARIABLE\r\n    _flag<\/pre>\n
    2) Label identifiers<\/h3>\n
    Label identifiers consist of alphabetic, underscore or numeric characters, and are not case sensitive. The maximum length is 32.<\/p>\n
    Example:\r\n    label1\r\n    100<\/pre>\n
    3) Reserved words<\/h3>\n
    The following words are reserved:<\/p>\n
    [Command] bplusrecv, bplussend, changedir... (see the command list<\/a>) [Operator] and, not, or, xor [System variable] groupmatchstr1, groupmatchstr2, groupmatchstr3, groupmatchstr4, groupmatchstr5, groupmatchstr6, groupmatchstr7, groupmatchstr8, groupmatchstr9, inputstr, matchstr, param2, param3, param4, param5, param6, param7, param8, param9, result, timeout, mtimeout<\/pre>\n
    Line formats<\/h2>\n
    There are four kinds of line formats for macro files. Any line can contain a comment which begins with a \";\" character. Also, a user can use the C language style comment(\/* - *\/).
    \nComments give no effect on the execution of MACRO.
    \nOne line can contain up to 500 characters. The part that exceeded 500 characters is ignored.<\/p>\n
    1) Empty lines<\/h3>\n
    Lines which have no character or contain only space or tab characters or a comment. They give no effect on the execution of the macro.<\/p>\n
    Example:\r\n    ; Tera Term Language<\/pre>\n
    Example: showtt 0 MessageBox 'message 1' 'title 1' \/* This is 'comment' \"string\" *\/ MessageBox 'message 2' 'title 2' closett<\/pre>\n
    2) Command lines<\/h3>\n
    Lines containing a single command with parameters.<\/p>\n
    Format: <command> <parameter> ... Example: connect'myhost' wait 'OK' 'ERROR' if result=2 goto error sendln 'cat' pause A*10 end<\/pre>\n
    3) Assignment lines<\/h3>\n
    Lines which contain an assignment statement.<\/p>\n
    Format: <Variable> = <Value (constant, variable, expression)> Example: A = 33 B = C C must already have a value. VAL = I*(I+1) A=B=C The value of B=C (0 for false, 1 for true) is assigned to A. Error=0<J Username='MYNAME'<\/pre>\n
    4) Label lines<\/h3>\n
    Lines which begin with a ':' character followed by a label identifier.<\/p>\n
    Format:\r\n    :<Label>\r\n\r\nExample:\r\n    :dial\r\n    :100<\/pre>\n
    Communication commands<\/h2>\n
      \n
    • bplusrecv<\/li>\n
    • bplussend<\/li>\n
    • callmenu (version 4.56 or later)<\/li>\n
    • changedir<\/li>\n
    • clearscreen<\/li>\n
    • closett<\/li>\n
    • connect<\/li>\n
    • cygconnect (version 4.57 or later)<\/li>\n
    • disconnect<\/li>\n
    • dispstr (version 4.67 or later)<\/li>\n
    • enablekeyb<\/li>\n
    • flushrecv<\/li>\n
    • gethostname (version 4.61 or later)<\/li>\n
    • gettitle<\/li>\n
    • kmtfinish<\/li>\n
    • kmtget<\/li>\n
    • kmtrecv<\/li>\n
    • kmtsend<\/li>\n
    • loadkeymap<\/li>\n
    • logclose<\/li>\n
    • logopen<\/li>\n
    • logpause<\/li>\n
    • logstart<\/li>\n
    • logwrite<\/li>\n
    • quickvanrecv<\/li>\n
    • quickvansend<\/li>\n
    • recvln<\/li>\n
    • restoresetup<\/li>\n
    • scprecv (version 4.57 or later)<\/li>\n
    • scpsend (version 4.57 or later)<\/li>\n
    • send<\/li>\n
    • sendbreak<\/li>\n
    • sendbroadcast (version 4.62 or later)<\/li>\n
    • sendfile<\/li>\n
    • sendkcode<\/li>\n
    • sendln<\/li>\n
    • sendlnbroadcast (version 4.62 or later)<\/li>\n
    • sendmulticast (version 4.62 or later)<\/li>\n
    • setbaud (version 4.58 or later)<\/li>\n
    • setdebug (version 4.64 or later)<\/li>\n
    • setdtr (version 4.59 or later)<\/li>\n
    • setecho<\/li>\n
    • setmulticastname (version 4.62 or later)<\/li>\n
    • setrts (version 4.59 or later)<\/li>\n
    • setsync<\/li>\n
    • settitle<\/li>\n
    • showtt<\/li>\n
    • testlink<\/li>\n
    • unlink<\/li>\n
    • wait<\/li>\n
    • wait4all (version 4.63 or later)<\/li>\n
    • waitevent<\/li>\n
    • waitln<\/li>\n
    • waitn (version 4.62 or later)<\/li>\n
    • waitrecv<\/li>\n
    • waitregex (version 4.21 or later)<\/li>\n
    • xmodemrecv<\/li>\n
    • xmodemsend<\/li>\n
    • ymodemrecv (version 4.66 or later)<\/li>\n
    • ymodemsend (version 4.66 or later)<\/li>\n
    • zmodemrecv<\/li>\n
    • zmodemsend<\/li>\n<\/ul>\n
      Control commands<\/h2>\n
        \n
      • break (version 4.53 or later)<\/li>\n
      • call<\/li>\n
      • do, loop (version 4.56 or later)<\/li>\n
      • end<\/li>\n
      • execcmnd<\/li>\n
      • exit<\/li>\n
      • for, next<\/li>\n
      • goto<\/li>\n
      • if, then, elseif, else, endif<\/li>\n
      • include<\/li>\n
      • mpause (version 4.27 or later)<\/li>\n
      • pause<\/li>\n
      • return<\/li>\n
      • until, enduntil (version 4.56 or later)<\/li>\n
      • while, endwhile<\/li>\n<\/ul>\n
        String operation commands<\/h2>\n
          \n
        • code2str<\/li>\n
        • expandenv (version 4.71 or later)<\/li>\n
        • int2str<\/li>\n
        • sprintf (version 4.52 or later)<\/li>\n
        • sprintf2 (version 4.62 or later)<\/li>\n
        • str2code<\/li>\n
        • str2int<\/li>\n
        • strcompare<\/li>\n
        • strconcat<\/li>\n
        • strcopy<\/li>\n
        • strinsert (version 4.67 or later)<\/li>\n
        • strjoin (version 4.67 or later)<\/li>\n
        • strlen<\/li>\n
        • strmatch (version 4.59 or later)<\/li>\n
        • strremove (version 4.67 or later)<\/li>\n
        • strreplace (version 4.67 or later)<\/li>\n
        • strscan<\/li>\n
        • strspecial (version 4.67 or later)<\/li>\n
        • strsplit (version 4.67 or later)<\/li>\n
        • strtrim (version 4.67 or later)<\/li>\n
        • tolower (version 4.53 or later)<\/li>\n
        • toupper (version 4.53 or later)<\/li>\n<\/ul>\n
          File operation commands<\/h2>\n
            \n
          • basename (version 4.69 or later)<\/li>\n
          • dirname (version 4.69 or later)<\/li>\n
          • fileclose<\/li>\n
          • fileconcat<\/li>\n
          • filecopy<\/li>\n
          • filecreate<\/li>\n
          • filedelete<\/li>\n
          • filemarkptr<\/li>\n
          • fileopen<\/li>\n
          • filereadln<\/li>\n
          • fileread (version 4.48 or later)<\/li>\n
          • filerename<\/li>\n
          • filesearch<\/li>\n
          • fileseek<\/li>\n
          • fileseekback<\/li>\n
          • filestat (version 4.66 or later)<\/li>\n
          • filestrseek<\/li>\n
          • filestrseek2<\/li>\n
          • filetruncate (version 4.67 or later)<\/li>\n
          • filewrite<\/li>\n
          • filewriteln<\/li>\n
          • findfirst, findnext, findclose<\/li>\n
          • foldercreate (version 4.69 or later)<\/li>\n
          • folderdelete (version 4.69 or later)<\/li>\n
          • foldersearch (version 4.69 or later)<\/li>\n
          • getdir<\/li>\n
          • getfileattr (version 4.69 or later)<\/li>\n
          • makepath<\/li>\n
          • setdir<\/li>\n
          • setfileattr (version 4.69 or later)<\/li>\n<\/ul>\n
            Password commands<\/h2>\n
              \n
            • delpassword<\/li>\n
            • getpassword<\/li>\n
            • passwordbox<\/li>\n<\/ul>\n
              Miscellaneous commands<\/h2>\n
                \n
              • beep<\/li>\n
              • closesbox<\/li>\n
              • clipb2var (version 4.46 or later)<\/li>\n
              • crc32 (version 4.60 or later)<\/li>\n
              • crc32file (version 4.60 or later)<\/li>\n
              • exec<\/li>\n
              • filenamebox (version 4.54 or later)<\/li>\n
              • getdate<\/li>\n
              • getenv<\/li>\n
              • gettime<\/li>\n
              • getttdir (version 4.60 or later)<\/li>\n
              • getver (version 4.58 or later)<\/li>\n
              • ifdefined (version 4.46 or later)<\/li>\n
              • inputbox<\/li>\n
              • messagebox<\/li>\n
              • random (version 4.27 or later)<\/li>\n
              • rotateleft (version 4.54 or later)<\/li>\n
              • rotateright (version 4.54 or later)<\/li>\n
              • setdate<\/li>\n
              • setdlgpos<\/li>\n
              • setenv (version 4.54 or later)<\/li>\n
              • setexitcode<\/li>\n
              • settime<\/li>\n
              • show<\/li>\n
              • statusbox<\/li>\n
              • var2clipb (version 4.46 or later)<\/li>\n
              • yesnobox<\/li>\n<\/ul>\n
                PAUSE 1<\/p>\n","protected":false},"excerpt":{"rendered":"
                The terminal emulation program Tara Term is an easy-to-use terminal emulator, similar in function to HyperTerminal or Procomm.\u00a0 But, Raveon finds it is easier to use, more reliable, and has better features.\u00a0 One of its new features is the ability to process a “Macro File”.\u00a0 It is a very handy program to communicate with a […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[47],"tags":[],"_links":{"self":[{"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/posts\/539"}],"collection":[{"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/comments?post=539"}],"version-history":[{"count":6,"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/posts\/539\/revisions"}],"predecessor-version":[{"id":546,"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/posts\/539\/revisions\/546"}],"wp:attachment":[{"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/media?parent=539"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/categories?post=539"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.raveon.com\/data_radio_info\/wp-json\/wp\/v2\/tags?post=539"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}