home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / packet / w2vyroxe / rosesys.txt < prev    next >
Text File  |  1989-07-09  |  95KB  |  1,932 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                           
  8.                                           
  9.                                           
  10.                                           
  11.                         RATS Open Systems Environment (ROSE)
  12.                                           
  13.                                ROSE X.25 Packet Switch
  14.                                           
  15.                                 System Manager Manual
  16.                                           
  17.                                           
  18.                                           
  19.                                           
  20.                                           
  21.                                          by
  22.                                           
  23.                                Thomas A. Moulton, W2VY
  24.                                           
  25.                                           
  26.                                           
  27.                                           
  28.                                           
  29.                                           
  30.                                           
  31.                                           
  32.                                           
  33.                                           
  34.                                           
  35.                                           
  36.                                           
  37.                                           
  38.                                           
  39.                                           
  40.                                           
  41.                                           
  42.                                           
  43.                                    Distributed by
  44.                                           
  45.                                           
  46.                                           
  47.                                           
  48.                                           
  49.                                     Xanthus, Inc
  50.                                   Thomas A. Moulton
  51.                                   9 Rosalie Avenue
  52.                                Clifton, NJ 07011-1906
  53.                               United States of America
  54.                                    (201) 478-7919
  55.  
  56.  
  57.  
  58.  
  59.  
  60.      
  61.      Introduction                                               1
  62.      Use Guidelines                                             1
  63.      Notational Syntax                                          1
  64.      Network Definition                                         3
  65.      Network Configuration                                      3
  66.      Configuration of Default Parameters                        4
  67.      Configuration of This Switch                               5
  68.      Configuration of Local Switches                            7
  69.      Configuration of Routing Information                       8
  70.      Additional Configuration Commands                         10
  71.      Special Characters to the Configuration Program           10
  72.      ROSE X.25 Packet Switch Applications                      10
  73.      LOADER Application                                        11
  74.      USERS Application                                         13
  75.      MEMSIZ Application                                        15
  76.      CONFIG Application                                        15
  77.      Running the Configuration Program                         17
  78.      Configuration Program Command Summary and Error Messages  17
  79.      Programming the EPROM                                     17
  80.      Permanent Configuration of the Switch                     17
  81.      Power ON Indications for TNC-2                            19
  82.      Configuring a switch for the first time                   19
  83.      Configuring a switch for the second time                  22
  84.      Configuring a Remote Switch                               23
  85.      Hardware Installation - TNC-2 or Clone                    23
  86.      Hardware Installation - PacComm DR-100/DR-200             25
  87.      Hardware Modifications - TNC-2 or Clone                   25
  88.      Hardware Modifications - DR-100/DR-200                    26
  89.      Wiring TNCs for Back-to-Back Mode                         28
  90.      Differences between ROSE and Net/ROM Back-to-Back Cable   28
  91.      Asynchronous Radio Port Cable                             28
  92.      Appendix 1 - Files Supplied in archive                    29
  93.      Appendix 2 - ROSE X.25 Packet Switch User's Manual         1
  94.      Appendix 3 - Network Configuration Example                 1
  95.      Appendix 4 - Terminology                                   1
  96.      Appendix 5 - Shifted ASCII Table                           1
  97.      Appendix 6 - ROSE Registration Form                        1
  98.  
  99.  
  100.                                                                         1
  101.  
  102.  
  103.      Introduction     Introduction
  104.  
  105.                The ROSE  X.25 Packet Switch is an  advanced replacement for
  106.           the common  digipeater or  other node  switching EPROM.  The ROSE
  107.           Switch represents  the state  of  the  art  in  packet  switching
  108.           technology using international standard protocols. It is based on
  109.           the CCITT  X.25 Network  Layer, and  the ARRL  AX.25  Link  Layer
  110.           Protocols.
  111.  
  112.                The ROSE X.25 Packet Switch is the best solution for Amateur
  113.           Packet Radio  Networking.  A  ROSE  Switch  can  be  accessed  by
  114.           standard AX.25 TNCs supporting the AX.25 Link Layer protocol. The
  115.           AX.25 Link  Layer protocol is also used on paths between backbone
  116.           switches. The X.25 Network Layer protocol is used by the switches
  117.           to transfer  the users'  data through the network. See Appendix 2
  118.           (Users Manual) for a complete list of features.
  119.  
  120.      Use Guidelines     Use Guidelines
  121.  
  122.                The ROSE  switch is  a shareware  product within the Amateur
  123.           Radio Community.  The executable  firmware is available from many
  124.           sources, including many land-line BBSs, as well directly from the
  125.           author. The  switch firmware  may be  used  free  of  charge  for
  126.           amateur radio purposes.
  127.  
  128.                Shareware registration will entitle the user to notification
  129.           of  updates,  information  about  new  applications  as  well  as
  130.           assistance with network coordination. Informational mailings will
  131.           be sent bimonthly. See Appendix 6, ROSE Registration Form.
  132.  
  133.                Answers to  questions,  special  help,  such  as  customized
  134.           EPROMs,  assistance  with  configurations,  can  be  arranged  by
  135.           contacting the author.
  136.  
  137.                Commercial use  of the  ROSE X.25 Packet Switch is expressly
  138.           forbidden.
  139.  
  140.                Contact Xanthus for commercial licensing information.
  141.  
  142.      Notational Syntax     Notational Syntax
  143.  
  144.                Words that have the first character capitalized are being
  145.           emphasized and are defined in Appendix 4 Terminology. In examples of                                                   Terminology                
  146.           interactions with the Switch commands you typed are underlined and                                                              __________    
  147.           replies from the Switch are bold.                                      bold 
  148.  
  149.      Addressing/Routing     Addressing/Routing
  150.  
  151.                The ROSE  X.25 Packet  Switch supports the global addressing
  152.           plan adopted  by CCITT and ISO. This plan includes a country code
  153.           and a  national network  number.  The  ROSE  Switch  follows  the
  154.           numbering plan  in use  in the  national  X.25  packet  switching
  155.           network, most packet networks follow the telephone numbering plan
  156.  
  157.  
  158.                                                                         2
  159.  
  160.  
  161.           used in  that country. North America uses the telephone Area Code
  162.           and Exchange.
  163.  
  164.                This system  will allow  a user to request a connection with
  165.           another station  without any  concern given to the exact path the
  166.           data will  follow. This  is in  sharp contrast  to the explicitly
  167.           specified approach  used by  digipeaters. The motivation for this
  168.           is that the general user population doesn't care to, or have time
  169.           to, keep  abreast of  the networking  changes  over  time.    The
  170.           routing is  under your  complete control, so users can't clog the
  171.           network with  retries on  obsolete RF  paths. Users  only need to
  172.           know the  Network Address  of the  destination, which  is like  a
  173.           telephone number.
  174.  
  175.                The ROSE  Switch may  be configured  with several  paths  to
  176.           remote Area  Codes or countries. Each of the specified links will
  177.           be tried  in the order they were specified to find an operational
  178.           route. This is an improvement on several existing amateur systems
  179.           which can  only provide  implicit destination routing to switches
  180.           known by the source switch.
  181.  
  182.                The  telephone   exchanges  are   allocated  based   on  the
  183.           population density  of each   area. A single ROSE X.25 Switch can
  184.           provide RF  coverage of  many different exchanges. A full list of
  185.           exchanges that  the switch  should  handle  as  its  own  can  be
  186.           specified.
  187.  
  188.                The addressing  also needs  to support  routing to different
  189.           countries, the  X.121 standard handles this with a prefix country
  190.           code. In  data networks  the country  code  is  called  the  Data                                                                       D   
  191.           Network Identification  Code (DNIC),  the ROSE Switch supports up          N       I               C                                        
  192.           to 8  different DNICS, and will be expanded as the networks grow.
  193.           The user  can specify  the DNIC  in the  TNC connect  command  by
  194.           adding an  extra four  digit digipeater  field between the switch
  195.           callsign and  the network  address, for  example  to  connect  to
  196.           VE7APU in Canada you could enter the following command:
  197.  
  198.                     C VE7APU V N2DSY-3,3020,617385
  199.  
  200.                The ROSE  Switch would see the four digit group and the fact
  201.           that another  digit field  followed it  and  merge  the  numbers,
  202.           resulting in an address of 3020167385.
  203.  
  204.                If you get a call from a station that is in a different DNIC
  205.           than the  ROSE Switch you use, it will insert the correct DNIC in
  206.           the digipeater field preceding the network address in the connect
  207.           request. This  insures that  you know  how to reach the user at a
  208.           later date,  as well as providing identification of international
  209.           contacts which  sometimes require  special considerations  by the
  210.           users in the contact.
  211.  
  212.  
  213.                                                                         3
  214.  
  215.  
  216.      Network Definition     Network Definition
  217.  
  218.                Designing local  network topology  can be  an art in itself.
  219.           The following  is a good template that can be used to determine a
  220.           first best  guess as  to how  the various  paths should  be used.
  221.           Once you  have a network operational you should try various paths
  222.           to optimize  the traffic flow.  In many cases gut feelings should
  223.           be tried  as there  are things  we all know about RF paths that I
  224.           haven't been able to put into words.
  225.  
  226.                In order  to define  a network of ROSE X.25 Packet Switches,
  227.           perform the following steps:
  228.  
  229.                1) Draw  a network  layout consisting  of switches  and  the
  230.           usable RF paths between each adjacent switch.
  231.  
  232.                2) Assign  each switch  a callsign and address consisting of
  233.           the telephone  Area Code  and Exchange  of the  location  of  the
  234.           switch.
  235.  
  236.                3) Prioritize  the reliability  of  each  switch's  outbound
  237.           links.   Preferred  paths  should  have  many  of  the  following
  238.           characteristics;  Solid  paths,  low  volume  paths;  high  speed
  239.           channels; and  low contention.  In general the number of emitters
  240.           on a  given frequency should kept low. Hidden transmitters should
  241.           be eliminated.  All the  emitters should  hear  each  other  well
  242.           enough to  cause the  carrier to  be detected  by the  modem. The                                                                        ___
  243.           shortest path  between two  points is  the  path  with  the  most          _________________________________________________________________
  244.           available band width, not the shortest distance!          ________________________________________________
  245.  
  246.                4) Next  decide the  best path  for  traffic  from  switches
  247.           outside your  control should  follow.   These can  be thought  of
  248.           general directions, such as North, South, etc. Usually the inter-
  249.           LAN boundary  is obvious, all you have to do is decide what route
  250.           through your  switches you  want this  foreign traffic to follow.
  251.           This route  is a  good candidate  for a  backbone  channel  on  a
  252.           different band.
  253.  
  254.                When each of these items is defined, you will have completed
  255.           a basic  network design.   The  method is  minimal, but  it  will
  256.           assist you  in understanding the workings of the network when you
  257.           start the  deployment phase.  It will also be helpful when trying
  258.           to debug network problems.
  259.  
  260.      Network Configuration     Network Configuration
  261.  
  262.                In a ROSE X.25 Network each switch has a description of what
  263.           the network  looks like from it's point of view. This consists of
  264.           a list  of  switches  that  it  talks  to  directly  and  routing
  265.           information.  The  routing  information  describes  what  network
  266.           addresses each  of the  switches in  the list  can handle. When a
  267.           connect request is received by a switch it must be able to decide
  268.           where the request should be sent next. Connection requests can be
  269.           from either a local user or from another switch.
  270.  
  271.  
  272.                                                                         4
  273.  
  274.  
  275.                The configuration  of a  switch is  stored in  a  file  that
  276.           contains four sections. These are:
  277.  
  278.                1) Default Parameters
  279.                2) Information about the switch being configured
  280.                3) A list of switches local to the switch being configured
  281.                4) Routing information, who should handle what addresses
  282.  
  283.                Appendix 4  contains a list of terms that should be reviewed
  284.           to aid in clarity of the descriptions.
  285.  
  286.                Default Parameters               Default Parameters
  287.  
  288.                There are  four switch parameters that can be defaulted, the
  289.           form of the default command is:
  290.  
  291.                DEFAULT par Value
  292.  
  293.                Where the  "par" is one of the following and the value is as
  294.           described.
  295.  
  296.                L3W 1..7               L3W 1..7
  297.  
  298.                This  configures  the  Level  3  Packet  Window,  much  like
  299.           MAXFRAME for TNC Links.  As noted valid values are 1 through 7.
  300.  
  301.                TimeOut 0..65535               TimeOut 0..65535
  302.  
  303.                When a  network Link  is not  operational  due  to  a  radio
  304.           failure or  interference a  timer is  started to  keep the switch
  305.           from continuously  trying to  bring up  the link. This is done to
  306.           reduce the  time required to route around a malfunctioning switch
  307.           or path.  The suggested  value is  900 seconds  (15 Minutes), but
  308.           other values can be used from 0 to 65535 seconds (18 Hours).
  309.  
  310.                MaxVC 0..254               MaxVC 0..254
  311.  
  312.                This parameter  sets the  number  of  VCs,  or  simultaneous                                                     ___                   
  313.           connections, that  will be  allowed on  a Link to another switch.
  314.           The recommended  value for this is 20. A special case occurs when
  315.           this statement appears in a USER block statement.
  316.  
  317.                Port 0..4               Port 0..4
  318.  
  319.                This defines  which serial  port on  the switch  the Node or
  320.           User is  said to be listening. On a TNC-2 the radio is Port 0 and
  321.           the RS-232 connector is Port 1.
  322.  
  323.                The recommended values for these defaults are:
  324.  
  325.                DEFAULT PORT 0
  326.                DEFAULT TIMEOUT 900
  327.                DEFAULT L3W 4
  328.                DEFAULT MAXVC 20
  329.  
  330.  
  331.                                                                         5
  332.  
  333.  
  334.                Information about the switch being configured               Information about the switch being configured
  335.  
  336.                The first  thing that  must be done is a declaration of what
  337.           country this  switch is  in.  This is done with the DNIC command,
  338.           which has the form:
  339.  
  340.                THIS DNIC 3100 United States of America
  341.  
  342.                The THIS  command is used on the beginning of a statement to
  343.           identify that  the rest  of the  line is  for the  switch that is
  344.           being configured.
  345.  
  346.                The 3100  is the  country code  for the  USA within the data
  347.           networks. A  complete list of DNICs can be found in Appendix C of
  348.           the ROSE  X.25 Packet Switch Users Manual, which is in Appendix 2
  349.           of this manual.
  350.  
  351.                Once this  is done  you can  define the internal information
  352.           about the  switch being  configured. Again we use the THIS prefix
  353.           to identify we are talking about the switch being configured.
  354.  
  355.                THIS NODE Clifton
  356.  
  357.                The NODE  statement is  a Block Statement that is terminated
  358.           with an END statement.
  359.  
  360.                Note: The  location name, Clifton in this case, is only used
  361.           within the configuration file, not on the air.
  362.  
  363.                Each switch  must have  a Network  Address, this  is what is
  364.           used to reference the switch as the destination of a Call Request
  365.           from anywhere in the network.
  366.  
  367.                ADDRESS 201478
  368.  
  369.                The address  can be  from 1 to 6 digits long and must follow
  370.           the national  numbering plan  in use for the X.25 network. In the
  371.           United States  of America  this must  be the  Area Code and local
  372.           Exchange of the location of the switch.
  373.  
  374.                In order  for users and other switches to establish Links to
  375.           this switch it must have an Amateur callsign.
  376.  
  377.                CALL W2VY-3
  378.  
  379.                CALL is  short for  CALLSIGN in this case. The EPROM default
  380.           for the callsign is ROSE-3.
  381.  
  382.                Each switch  also has  a  callsign  that  can  be  used  for
  383.           digipeating, this  may be  the same  as  the  CALL.  The  default
  384.           digipeat callsign  is ROSE-2.  If the  CALL and DIGI are the same
  385.           they both still need to be specified.
  386.  
  387.                DIGI W2VY-2
  388.  
  389.  
  390.                                                                         6
  391.  
  392.  
  393.                If a  switch has  a RF  coverage that  crosses more than one
  394.           telephone exchange then these extra exchanges can be specified in
  395.           the  COVERAGE  statement.  This  is  a  Block  Statement  and  is
  396.           terminated with  an END.  This is  an example  of a  nested block
  397.           statement, we are still in the "This Node Clifton" Block.
  398.  
  399.                COVERAGE
  400.                201472 201473 201777 201779 201470 201478
  401.                201778 201772
  402.                END
  403.  
  404.                Each of  the Network  Addresses listed above will be treated
  405.           as if they were the switch Network Address, 201478 in this case.
  406.  
  407.                When a  Call Request is received that has this switch as the
  408.           destination, address  201478 or  one in  the Coverage  list,  the
  409.           switch will  attempt to establish a Link with the specified user.
  410.           If the  switch is  running on  multi-port  hardware,  such  as  a
  411.           PacComm DR-200  there are  times when  you need  to specify which
  412.           Port the  users are resident on. The USERPORT statement specifies
  413.           which Port should be used to establish Links to users. On a TNC-2
  414.           the Radio  port is  port 0. On a PacComm DR-100 the radio port is
  415.           port 1.
  416.  
  417.                USERPORT 0
  418.  
  419.                A user  can connect  to the switch and get information about
  420.           how to use the network, or other information of general interest.
  421.           This is  specified in a TEXT block, which is ended with "$EOF". A
  422.           blank line is inserted by having a "$" on a line by itself.
  423.  
  424.           TEXT
  425.           $
  426.           While Disconnected From THIS X.25 Switch issue a command like:
  427.           $
  428.           C CALLSIGN-SSID V W2VY-3,201256
  429.           $
  430.                        Switches Available for User Access are:
  431.                Address   Callsign   Location             User Port Freq
  432.                 201256   W2VY-3     Montclair              221.11 Mhz
  433.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  434.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  435.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  436.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  437.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  438.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  439.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  440.           $
  441.           Possible connect paths available to access BBS User ports.
  442.           C KB1BD-4 V W2VY-3,609426   :   C WA2VXT-4 v W2VY-3,609426
  443.           C KD6TH-4 V W2VY-3,201744   :   C N2ELC-4 v W2VY-3,201663
  444.           $
  445.           Connect Paths Available to KA-Nodes or TheNET Facilities:
  446.           C WB2DRD-3 V W2VY-3,609426  :   C WB2MNF-3 V W2VY-3,609530
  447.  
  448.  
  449.                                                                         7
  450.  
  451.  
  452.           $
  453.           When connecting  to TheNet  Nodes act  as if  you have  connected
  454.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  455.           either of  the TheNet  nodes listed above, to connect to the next
  456.           desired node. Type NODES to get a node list after your connect or
  457.           type Info to get information about the particular TheNet node you
  458.           are connected to. Example:  To connect to ELK TheNet node use the
  459.           following sequence:
  460.           C WB2DRD-3 V W2VY-3,6o9530
  461.           C ELK
  462.           $
  463.           You will  shortly be  Disconnected from  this switch.  If you are
  464.           currently connected  via either  TheNET or  KA-Node RECONNECT  to
  465.           THAT node  and then issue a connect as shown above.  Note: It has
  466.           come to our attention that those systems using old TNC1 code will
  467.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  468.           the all digit field and you will be successful.  Disconnect codes
  469.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  470.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  471.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  472.           $EOF
  473.  
  474.                This connect TEXT can be up to 2048 bytes long.
  475.  
  476.                To terminate  the definition  of the  Clifton Node  the  END
  477.           statement is used, completing the block statement.
  478.  
  479.                END
  480.  
  481.                Local Switches               Local Switches
  482.  
  483.                The next  section describes  the switches  that this  switch
  484.           communicates with directly.
  485.  
  486.                NODE Manhattan
  487.                ADDRESS 212456
  488.                PATH KD6TH-3
  489.                END
  490.  
  491.                This defines  a local  switch that  has the callsign KD6TH-3
  492.           and network  address 212456 and is located in Manhattan. Based on
  493.           the current  defaults it is also on PORT 0 with a link timeout of
  494.           15 Minutes and can support up to 20 calls. Each call will operate
  495.           with a level 3 packet window of 4.
  496.  
  497.                For the  purposes of  this description  we will  also define
  498.           three other local switches.
  499.  
  500.                NODE LittleFalls
  501.                ADDRESS 201744
  502.                PATH N2DSY-3
  503.                END
  504.  
  505.  
  506.                                                                         8
  507.  
  508.  
  509.                NODE Clifton2
  510.                ADDRESS 201779
  511.                PATH W2VY-9
  512.                PORT 1
  513.                END
  514.  
  515.                NODE Montclair
  516.                ADDRESS 201256
  517.                PATH W2VY-12 Via KB1BD-2
  518.                END
  519.  
  520.                Each  of  these  are  pretty  standard  with  the  following
  521.           exceptions.     Clifton2  is  on  PORT  1,  which  would  be  the
  522.           asynchronous port  if we  are running  on a  TNC-2 and  that port
  523.           could be  connected to either a modem and radio or a back to back
  524.           cable to  another TNC.  Montclair has a digipeater specified, the
  525.           path to a switch can include up to ONE digipeater.
  526.  
  527.                If you  have a  special device  that is  not on the USERPORT
  528.           channel you  can configure  it in  the switch  as a USER. If this
  529.           USER is not an X.25 Pad (ie it's a TNC or TheNet/NetROM) you must
  530.           specify MAXVC 0.
  531.  
  532.                USER KD6THbbs
  533.                PATH KD6TH-4
  534.                PORT 1
  535.                MAXVC 0
  536.                END
  537.  
  538.                If a  call came  in for  KD6TH-4 with  a switch  address  of
  539.           201478 the  switch would attempt to establish the link on Port 1,
  540.           as was specified. This can be done for any AX25L2 device, such as
  541.           a TheNet or NetROM, as well as a BBS. Users are not encouraged to
  542.           be placed  on the  backbone. If  using a  TNC-2  you  would  just
  543.           specify the  address of the switch that had the radio port on the
  544.           backbone. This  feature is used mostly when the switch is running
  545.           a PacComm DR-200.
  546.  
  547.                Routing Information               Routing Information
  548.  
  549.                The route  statements specify  what local switches should be
  550.           given calls for which network addresses.  This is usually divided
  551.           into two  parts, first  specifying the  routing  needed  for  the
  552.           switches within  the local network (the switches you control) and
  553.           the second  specifying  the  routing  for  out  of  area  network
  554.           addresses.
  555.  
  556.                The general form of the ROUTE statement is:
  557.  
  558.                ROUTE TO NODES node-list
  559.                CALLS FOR
  560.                network-address-list
  561.                END
  562.  
  563.  
  564.                                                                         9
  565.  
  566.  
  567.                Where "node-list"  is a  sequence of switches; and "network-
  568.           address-list" is  a list  of Network Addresses. If a Call Request
  569.           is received  for one of the addresses in the list the switch will
  570.           use this routing information to pass the Call to the next switch.
  571.           The switches  are tried in the order they are listed, so the best
  572.           route should  be listed  first, worse last. It has been done this
  573.           way because by in large there are a limited number of ways to get
  574.           from this  switch to  a remote  region. From the Clifton switch I
  575.           can route  calls for New England to Manhattan or Little Falls, so
  576.           the  following  statement  would  set  up  the  required  routing
  577.           entries.
  578.  
  579.                Route to Nodes Manhattan LittleFalls
  580.                Calls for
  581.                207 802 617 508 413 203 401
  582.                518 607 212 718 716 516 914 315
  583.                end
  584.  
  585.                I also included the Area Codes for New York.
  586.  
  587.                We also  need to  include the routes for the local switches.
  588.           The routing  information here  should include the address of each
  589.           switch as well as the addresses in it's coverage.
  590.  
  591.                Route to Node Manhattan
  592.                Calls for
  593.                212456
  594.                end
  595.  
  596.                Route to Node LittleFalls
  597.                Calls for
  598.                201744
  599.                end
  600.  
  601.                As well as addresses to the south and west:
  602.  
  603.                Route to Node LittleFalls
  604.                Calls for
  605.                609 215 717 202
  606.                end
  607.  
  608.                There are files included with the distribution diskette that
  609.           have the Area Codes for the entire USA,  broken down by state and
  610.           call district, see NPA.ARC.
  611.  
  612.                Now that  we have  defined the  configuration of a switch we
  613.           need to  create, and  save to  disk, the file that the switch can
  614.           understand. The WRITE statement is used to create this file.
  615.  
  616.                WRITE w2vy-3.tbl
  617.  
  618.                The file  naming conventions  that we use here in NJ are the
  619.           statements that  were used  in the  example are  stored in a file
  620.  
  621.  
  622.                                                                         10
  623.  
  624.  
  625.           with the  name CallSign.CNF  and the output is stored in the file
  626.           CallSign.TBL. (".CNF" Configuration; ".TBL" Table)
  627.  
  628.                The last  statement of  each .CNF  file should  be a QUIT to
  629.           tell the  configuration program  to terminate  and return  to the
  630.           operating system.
  631.  
  632.      Additional Configuration Commands     Additional Configuration Commands
  633.  
  634.                If you  are having problems figuring out an error, it can be
  635.           helpful to  see the commands that the program is reading. You can
  636.           cause the  configuration program  to print  each statement  as it
  637.           reads it in by including a VERIFY statement.
  638.  
  639.                VERIFY
  640.                ... statements causing problems...
  641.                NOVERIFY
  642.  
  643.                The NOVERIFY  statement turns this feature off, there can be
  644.           any number of VERIFY/NOVERIFY statements in a configuration file.
  645.  
  646.      Special Characters to the Configuration Program     Special Characters to the Configuration Program
  647.  
  648.                Any line  in the  configuration file (.CNF) that starts with
  649.           an asterisk  (*) is  treated as a comment, which can be useful to
  650.           indicate extra  information about  a switch, such as equipment at
  651.           the location, access rules, failure history, etc.
  652.  
  653.                There is  one exception,  if a  line starts  with  "*<"  the
  654.           configuration program will treat the text on the rest of the line
  655.           as a  file name. The file, if found, will be read in as if it had
  656.           been inserted  in the  main file  (the  one  that  contained  the
  657.           *<filename).
  658.  
  659.                The file  that is being read in can not have another "*<" in
  660.           it, this  may be  revised in  later versions of the configuration
  661.           program.
  662.  
  663.                Route to Nodes Manhattan LittleFalls
  664.                Calls for
  665.                *<w1.npa
  666.                *<ny.npa
  667.                end
  668.  
  669.                This would  be the  same as  the previous example of routing
  670.           the calls  for New England and New York, using the supplied files
  671.           in NPA.ARC.
  672.  
  673.      ROSE X.25 Packet Switch Applications     ROSE X.25 Packet Switch Applications
  674.  
  675.                A  Switch   Application  is   a  special   type  of  network
  676.           destination, like  a BBS  is a  special callsign that you connect
  677.           to. Once  connected to it you can issue commands and get replies.
  678.  
  679.  
  680.                                                                         11
  681.  
  682.  
  683.           The following  sections describe  the existing  applications  and
  684.           list any commands and example replies.
  685.  
  686.                To connect to a switch application you would follow the same
  687.           procedure that  you would  to connect  to a  user, but instead of
  688.           entering a user's callsign you enter the name of the application.
  689.           If your local switch is N4DWY-3 and you want to interact with the
  690.           MEMSIZ application at network address 201478, you would issue the
  691.           following connect command:
  692.  
  693.                C MEMSIZ Via N4DWY-3,201478
  694.  
  695.                This is  a standard ROSE X.25 Packet Switch connect request.
  696.           The local  switch would route the Call Request to the switch with
  697.           the network  address 201478.  That  switch  would  recognize  the
  698.           MEMSIZ application and set up connection with the application. If
  699.           the application  was not  loaded it  would assume  that it  was a
  700.           local user and attempt a connect on the userport.
  701.  
  702.                Once connected  to the  MEMSIZ application you would get the
  703.           ROSE banner:
  704.  
  705.           ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  706.  
  707.                This would  indicate that the connection is complete and you
  708.           could start interacting with that switch.
  709.  
  710.                The applications  that  accept  commands  currently  use  an
  711.           obscure format that has the general form:
  712.  
  713.                :ccoollll[dd]xx
  714.  
  715.                Where:
  716.  
  717.                cc   is a command number
  718.                00   is an object number
  719.                llll is the length of any optional data
  720.                dd   is the data if the length is non-zero
  721.                xx   is the checksum of the data field
  722.  
  723.                The only application that supports data fields is CONFIG and
  724.           the correct  values are  created by  the  configuration  compiler
  725.           (CONFIGUR.EXE).   All other  commands are  simply single commands
  726.           that end  with  six  zeros.    These  will  be  listed  with  the
  727.           description  of   each  application.  In  future  releases  these
  728.           commands will  be replaced with easier to remember plain language
  729.           commands.
  730.  
  731.      LOADER Application     LOADER Application
  732.  
  733.                The LOADER application is resident in the EPROM, this means
  734.           it is always present. As you may be able to guess from the name,
  735.           it is used to load other programs into the switch. This will
  736.           allow you to chose which switches will have what functions.
  737.  
  738.  
  739.                                                                         12
  740.  
  741.  
  742.                The files with the filename extension ".LOD" are files that
  743.           can be sent to this application, which will cause the specific
  744.           application to be loaded into memory. The file "CONFIG.LOD" when
  745.           sent (ASCII/TEXT upload) to LOADER would cause the CONFIG
  746.           application to be loaded into memory.
  747.  
  748.                When loading a .LOD file you should get three "OK"'s back,
  749.           the only other message you could get would be "Error n" where N
  750.           is a numeric value indicating what type of error occurred, the
  751.           following table lists the possible error numbers.
  752.  
  753.                Error #   Meaning               _________________
  754.                01        Invalid command
  755.                02        Invalid Object
  756.                03        Unable to allocate memory for program
  757.                04        Incorrect checksum
  758.                09        Length mismatch of code segment in .LOD file
  759.                0C        Can't delete non-existent application
  760.                0D        Need to load code segment before relocation info
  761.                0E        To many applications loaded, max is 15
  762.                0F        Unsupported object
  763.                10        Unsupported command
  764.  
  765.                LOADER also supports two other commands:
  766.  
  767.                List Applications ":0000000000"
  768.  
  769.                This command will cause the switch to list all the
  770.           applications that are currently loaded into the memory. When the
  771.           switch is first powered on the list will look like this:
  772.  
  773.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  774.                OK               OK
  775.  
  776.                If the switch has all the applications loaded into memory
  777.           then the list might look like this:
  778.  
  779.           Entry #0 LOADER - Application Boot interface          Entry #0 LOADER - Application Boot interface
  780.           Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...          Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...
  781.           Entry #2 USERS  - ROSE Switch User List Display, Version 1.0          Entry #2 USERS  - ROSE Switch User List Display, Version 1.0
  782.           Entry #3 MEMSIZ - ROSE Memory Utilization Display          Entry #3 MEMSIZ - ROSE Memory Utilization Display
  783.           OK          OK
  784.  
  785.                The entry # is just the position in the list that the
  786.           application is listed, this number is only important when you are
  787.           using the Delete command.
  788.  
  789.                Delete Application ":02ee000000"
  790.  
  791.                This command will remove an application from memory, thus
  792.           freeing the memory to be used for other things such as data
  793.           buffers or additional connections. The "ee" is the entry number
  794.           the application is in the list.
  795.  
  796.  
  797.                                                                         13
  798.  
  799.  
  800.                Lets say you want to delete the CONFIG application from a
  801.           switch, first you would connect to the LOADER and then list the
  802.           applications:
  803.  
  804.           :0000000000          ___________
  805.           Entry #0 LOADER - Application Boot interface          Entry #0 LOADER - Application Boot interface
  806.           Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...          Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...
  807.           Entry #2 USERS  - ROSE Switch User List Display, Version 1.0          Entry #2 USERS  - ROSE Switch User List Display, Version 1.0
  808.           Entry #3 MEMSIZ - ROSE Memory Utilization Display          Entry #3 MEMSIZ - ROSE Memory Utilization Display
  809.           OK          OK
  810.  
  811.                Notice that the CONFIG application is in entry #1 this time,
  812.           you would enter the following command, replacing the "ee" with
  813.           "01".
  814.  
  815.           :0201000000          ___________
  816.           OK          OK
  817.                You could then verify that it was done by entering the list
  818.           command again. The "OK" does tell you that it was in fact done,
  819.           but we'll check anyway, you don't have to check.
  820.  
  821.           :0000000000          ___________
  822.           Entry #0 LOADER - Application Boot interface          Entry #0 LOADER - Application Boot interface
  823.           Entry #1 USERS  - ROSE Switch User List Display, Version 1.0          Entry #1 USERS  - ROSE Switch User List Display, Version 1.0
  824.           Entry #2 MEMSIZ - ROSE Memory Utilization Display          Entry #2 MEMSIZ - ROSE Memory Utilization Display
  825.           OK          OK
  826.  
  827.                Note that all other applications moved up in the application
  828.           list.
  829.  
  830.                When you are done interacting with the LOADER you just
  831.           disconnect.
  832.  
  833.      USERS Application     USERS Application
  834.  
  835.                The USERS  application is  used to  list the  users that are
  836.           currently using  the  switch;  connected  to  a  local  user/bbs;
  837.           passing  through  to  another  switch;  or  interacting  with  an
  838.           application that has been loaded. Once you are connected just hit
  839.           return to view the current status of the connections.
  840.  
  841.  
  842.                                                                         14
  843.  
  844.  
  845.           ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY          ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  846.           [You Press Return]
  847.           
  848.           User List for N2DSY-3   3100201744          User List for N2DSY-3   3100201744
  849.           
  850.           W2VY     AX25L2 User Linked to USERS     @ 3100201744          W2VY     AX25L2 User Linked to USERS     @ 3100201744
  851.           W2VY     AX25L2 User Linked to LOADER    @ 3100201744          W2VY     AX25L2 User Linked to LOADER    @ 3100201744
  852.           W2VY-3    X.25 Trunk (R1) with the following connections:          W2VY-3    X.25 Trunk (R1) with the following connections:
  853.           KD6TH-4   @ 3100201256     ( 20 P4 D1) <-- KB1BD-5   @ 3100609443          KD6TH-4   @ 3100201256     ( 20 P4 D1) <-- KB1BD-5   @ 3100609443
  854.           WB2JQR-3  X.25 Trunk (R1) with the following connections:          WB2JQR-3  X.25 Trunk (R1) with the following connections:
  855.           KB1BD-5   @ 3100609443     ( 20 P4 D1) --> KD6TH-4   @ 3100201256          KB1BD-5   @ 3100609443     ( 20 P4 D1) --> KD6TH-4   @ 3100201256
  856.           
  857.           There are no calls Pending.          There are no calls Pending.
  858.           
  859.           The Following X.25 Trunks are listed as Out of Order:          The Following X.25 Trunks are listed as Out of Order:
  860.           <None> - All Links Operational          <None> - All Links Operational
  861.           
  862.                The first line identifies the callsign and address of the
  863.           switch that the display is for.
  864.  
  865.                The second section shows all active connections. The first
  866.           connection is my station connected to the USERS application (its
  867.           how I generated the above display). The second connection is my
  868.           station connected to the LOADER application. Note that a
  869.           connection that is listed as "AX25L2 User" is a user directly
  870.           connected to that switch.
  871.  
  872.                Now things start to get interesting, W2VY-3 is another ROSE
  873.           X.25 Packet Switch and it has one VC. The VC is between KB1BD-5
  874.           at address 609443 and KD6TH-4 at 201256, these are two BBSs doing
  875.           forwarding.
  876.  
  877.                In this case neither BBS is local so the call also shows up
  878.           on a second X.25 Trunk. The arrow indicates the direction that
  879.           the connect request went in, ie. KB1BD-5 called KD6TH-4.
  880.  
  881.                Note that this connection shows up twice, once to enter the
  882.           switch and once to leave. If a user was using the switching
  883.           function to connect to a station on the same switch there would
  884.           be two entries listed as AX25L2 Users.
  885.  
  886.                A pending call is a connect request that came in while the
  887.           trunk, or link, to the required switch was not ready. A Call is
  888.           left in the pending state while the Switch attempts to bring the
  889.           link into the ready state (R1).
  890.  
  891.                If a link to a switch is not operational then it is marked
  892.           as being Out of Order for a specified time. Right now this time
  893.           is listed in Hexadecimal seconds, it will be changed to HH:MM:SS
  894.           in the next release.
  895.  
  896.  
  897.                                                                         15
  898.  
  899.  
  900.      MEMSIZ Application     MEMSIZ Application
  901.  
  902.                The MEMSIZ  application was  just a  test program  for me to
  903.           verify correct  operation of the loader. It turns out that it can
  904.           be useful  to monitor  the amount of memory that is being used by
  905.           the switch  from time  to time. This information will be included
  906.           in the USERS application display in the next release.  The values
  907.           are listed in hexadecimal.
  908.  
  909.           Memory Size is: 7578
  910.           Memory Used is: 4155
  911.  
  912.      CONFIG Application     CONFIG Application
  913.  
  914.                The CONFIG  application is  not designed to be used directly
  915.           by the switch manager. It is just an interface that processes the
  916.           file created by the Network Configuration Program (CONFIGUR.EXE).
  917.           This section  will describe  the interface  for completeness, and
  918.           there may  be times  when you  might want  to check  some of  the
  919.           settings.   All replies  are in  hexadecimal and  are not easy to
  920.           interpret. As  with  the  LOADER  interface  every  command  will
  921.           generate either  an "OK"  or "Error n" when the processing of the
  922.           command is  complete, the  meaning of  each of  the errors are as
  923.           follows:
  924.  
  925.                Error #   Meaning               _________________
  926.                01        Invalid command
  927.                02        Invalid Object specified
  928.                03        No working memory!
  929.                04        Bad checksum!
  930.                05        Unsupported Command
  931.                06        Odd number of data bytes for type
  932.                07        Item is Read-Only
  933.  
  934.                For 0D object only:
  935.                01        No working memory
  936.                02        Invalid DNIC
  937.  
  938.                The commands have the same format as the LOADER commands.
  939.  
  940.                The following commands are currently supported:
  941.  
  942.                #    Function
  943.                01*  Write new information for object
  944.                02   Read current value of object
  945.                
  946.                NOTE: IT IS NOT RECOMMENDED THAT USERS USE THE 01 COMMAND!
  947.  
  948.                The following data objects are supported:
  949.  
  950.           00   This object contains the TEXT that a user can access if they
  951.                connect directly to the switch and hit return.
  952.  
  953.  
  954.                                                                         16
  955.  
  956.  
  957.           01   This is the list of callsigns of other switches and special
  958.                users configured via the PATH statement Node and User
  959.                configuration blocks. It also contains the CALL of this
  960.                switch.
  961.  
  962.           02   These are digipeater callsigns that optionally appeared in
  963.                the "via" field of the PATH statement of Node and User
  964.                configuration blocks. It also contains the DIGI callsign of
  965.                this switch.
  966.  
  967.           03   These are the PORT numbers of the Node and User
  968.                configuration blocks.
  969.  
  970.           04   These are the MAXVC limits specified in the Node and User
  971.                configuration blocks. This limits the number of simultaneous
  972.                network connections that can occur between the this switch
  973.                and the switch of the Node configuration block. This is also
  974.                used in the User configuration block to indicate that it is
  975.                a local AX25L2 user, and when found in a User block must be
  976.                0.
  977.  
  978.           05   These set the L3W for the connections going through a
  979.                network link, valid values are 1-7.
  980.  
  981.           06   These set the TIMEOUT value for a failed network link. This
  982.                is the time it will be considered Out of Order when it
  983.                fails, ie it gets a "Retry count exceeded".
  984.  
  985.           07   This sets the USERPORT which is used for connecting to
  986.                AX25L2 users, this can be overridden by User configuration
  987.                blocks.
  988.  
  989.           08   This contains the node address of this switch.
  990.  
  991.           09   This contains the default level 2 parameters for AX25L2
  992.                connections. (Maxframe, Paclen, Resptime, Frack, Retry)
  993.  
  994.           0A   This contains the default level 2 parameters for X.25
  995.                Network links.
  996.  
  997.           0B   This object is used in conjunction with the routing tables.
  998.                This contains a compressed set of routing alternatives,
  999.                since by in large the various routes and back-up routes are
  1000.                common for getting out of the local network.
  1001.  
  1002.           0C   Not used.
  1003.  
  1004.           0D   This contains the routing tables for all the DNICs. It is
  1005.                really a table of pointers to the routing table for each
  1006.                known DNIC.
  1007.  
  1008.           0E   Not used.
  1009.  
  1010.           0F   Direct memory examine and modify, used for debugging.
  1011.  
  1012.  
  1013.                                                                         17
  1014.  
  1015.  
  1016.      Running the Configuration Program     Running the Configuration Program
  1017.  
  1018.                You should  run this  program  after  you  have  created  or
  1019.           modified the  configuration file  (.CNF) for a switch. It is used
  1020.           the generate  the file  that gets  uploaded (TEXT/ASCII)  to  the
  1021.           switch CONFIG application, which is described elsewhere.
  1022.  
  1023.                To invoke  the program you insure the program (CONFIGUR.EXE)
  1024.           is in the current directory, or is in the MS-DOS path.
  1025.  
  1026.                C>CONFIGUR w2vy-3.CNF                 ___________________
  1027.                ROSE Interactive Network Monitor by W2VY
  1028.                Largest displacement used = 48
  1029.  
  1030.                Done!
  1031.                C>
  1032.  
  1033.                The message  "Largest Displacement  Used" is  a reference on
  1034.           the size of the routing table and as the routing table grows this
  1035.           number will  change. Any  errors will  be distinctive by starting
  1036.           with "***" with an arrow (^) pointing to the line with the error.
  1037.  
  1038.                If you do not specify the input filename (W2VY-3.CNF in this
  1039.           case) or  if the  file you  specified did  not exist, you will be
  1040.           prompted for the file name.
  1041.  
  1042.                C>CONFIGUR                 ________
  1043.                ROSE Interactive Network Monitor by W2VY
  1044.                Node data file name? w2vy-3.cnf                                    __________
  1045.                Largest displacement used = 48
  1046.  
  1047.                Done!
  1048.                C>
  1049.  
  1050.      Configuration Program Command Summary and Error Messages     Configuration Program Command Summary and Error Messages
  1051.  
  1052.      Programming the EPROM     Programming the EPROM
  1053.  
  1054.                     If you  have access  to an EPROM programmer you can use
  1055.           one of the files supplied, either the Intel HEX file ROSEZSW.HEX,
  1056.           or the  binary image  ROSEZSW.BIN. If you do not have access to a
  1057.           programmer you can obtain a pre-programmed EPROM from the author.
  1058.  
  1059.           NOTE: The  SAME EPROM  will  function  in  TNC-2/Clones  and  the
  1060.           PacComm DR-100/200, the initialization code checks it all out and
  1061.           sets up the system. A test switch will work fine with 16K, but it
  1062.           is  recommended   that  a  fully  functional  network  switch  is
  1063.           installed with 32K.
  1064.  
  1065.      Permanent Configuration of the Switch     Permanent Configuration of the Switch
  1066.  
  1067.                The distribution  includes a  ".MAP" file  that contains the
  1068.           EPROM address  of all entry points and important variables. Using
  1069.           this information  you can  modify the  default parameters  in the
  1070.  
  1071.  
  1072.                                                                         18
  1073.  
  1074.  
  1075.           EPROM. The  format of  the data  falls into four forms. A byte, a
  1076.           word, a callsign and a network address.
  1077.  
  1078.                A byte  is simply  a single  location in the EPROM which can
  1079.           hold a value from 00 to FF (that is 0 to 255 decimal).
  1080.  
  1081.                A word  is a  two byte  value with the low order byte of the
  1082.           word stored  at the  lower EPROM  address. A  word can  contain a
  1083.           value from 0000 to FFFF (that is 0 to 65535 decimal). Since it is
  1084.           stored low  byte at low address the value 01 00 is 1 decimal, and
  1085.           00 01 is 256 decimal, or 0100 hexadecimal.
  1086.  
  1087.                A callsign  is stored  in AX.25  format,  the  same  way  it
  1088.           appears in packets sent over the air. Each callsign is a six byte
  1089.           shifted ASCII  callsign followed  by  a  single  byte  SSID,  for
  1090.           example in the EPROM the callsign ROSE-3 would have the following
  1091.           format:
  1092.  
  1093.                A4 9E A6 8A 40 40 06
  1094.  
  1095.                Appendix 5  contains a  table for  conversion  from  and  to
  1096.           shifted ASCII as used in AX.25.
  1097.  
  1098.                A network  address is  stored in  CCITT X.25 address format,
  1099.           which is  a length  byte followed  by a BCD representation of the
  1100.           address, for  example  the  address  3100201779  would  have  the
  1101.           following format:
  1102.  
  1103.                0A 31 00 20 17 79
  1104.  
  1105.                Note that  the length  (0A, 10 decimal) is the number of BCD
  1106.           digits, ie "31" is two digits.
  1107.  
  1108.                If you  are outside  the USA  the  numbering  plan  may  use
  1109.           something other  than six  digit codes, if the length is ODD then
  1110.           just pad the last byte with an extra 0, but leave the length ODD.
  1111.           I know  Australia uses  a variable  length  numbering  plan,  the
  1112.           format for  node address  50502 (which  is the  region  code  for
  1113.           Sydney) would be:
  1114.  
  1115.                05 50 50 20
  1116.  
  1117.                Note that  the length  is 5  (50502) and  the last  digit is
  1118.           ignored and should be 0.
  1119.  
  1120.                The following  ".MAP" file  labels identify  the location of
  1121.           the following EPROM defaults:
  1122.  
  1123.                "myaddr" - Network address of this switch
  1124.                "mycall" - Callsign of this switch
  1125.                "mydigi" - Callsign this switch recognized for digipeating
  1126.                "defdnic" - Default local DNIC, EPROM has USA: 04 31 00
  1127.  
  1128.  
  1129.                                                                         19
  1130.  
  1131.  
  1132.      Power ON Indications for TNC-2     Power ON Indications for TNC-2
  1133.  
  1134.           Ensure that  the power  switch is off. Insert the power connector
  1135.           and then turn the power on.
  1136.  
  1137.           The ROSE  X.25 Packet  Switch  has  a  two  phase  initialization
  1138.           sequence.
  1139.  
  1140.           In the  first phase  you should  see the  PWR, CON and STA lights
  1141.           come on  for TWO  (2) seconds  while the  Switch  tests  RAM  and
  1142.           verifies the battery backed up RAM.
  1143.  
  1144.           The second  phase the  CON and STA LEDs are used to indicate what
  1145.           was going  on when the switch was powered off. This indication is
  1146.           displayed for  THREE (3) seconds (they both normally stay on). If
  1147.           they both  go out,  then the  switch was processing data when the
  1148.           power was  removed. When powering a unit as a ROSE Switch for the
  1149.           first time, this display is meaningless.
  1150.  
  1151.           At this  point the  CON and STA lights should alternately turn on
  1152.           and off  once  a  second,  this  indicates  that  the  switch  is
  1153.           operating correctly.
  1154.  
  1155.      Configuring a switch for the first time     Configuring a switch for the first time
  1156.  
  1157.                This section  will take you step by step through configuring
  1158.           a switch  for the  first time.  It is  assumed that the ROSE X.25
  1159.           Packet Switch has been installed and you are using a standard TNC
  1160.           on the air to connect to the switch.
  1161.  
  1162.                When a  switch is being installed for the first time it is a
  1163.           good idea  to run  the following  tests. First  you should verify
  1164.           that the  switch can  digipeat frames. Since the default callsign
  1165.           is ROSE-2, set UNPROTO as follows:
  1166.  
  1167.                cmd:unproto test via rose-2               cmd:                                          _______________________
  1168.                cmd:conv               cmd:                       ____
  1169.                Test               ____
  1170.                W2VY>TEST,ROSE-2*:Test               W2VY>TEST,ROSE-2*:Test
  1171.                
  1172.  
  1173.                The test  frame was digipeated successfully, indicating that
  1174.           the connections to the radio should be ok.
  1175.  
  1176.  
  1177.                                                                         20
  1178.  
  1179.  
  1180.                Now we should verify that the switching callsign is correct,
  1181.           return to command mode (usually by typing Control-C) and enter:
  1182.  
  1183.                cmd:c rose-3               cmd:                           ________
  1184.                *** CONNECTED to ROSE-3               *** CONNECTED to ROSE-3
  1185.                [Hit return or wait 60 Seconds]
  1186.                ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1187.                *** DISCONNECTED               *** DISCONNECTED
  1188.                cmd:               cmd:
  1189.                
  1190.                This is  the default  information  message  and  so  all  is
  1191.           working correctly.
  1192.  
  1193.                The preceding  steps could  have been skipped, but these are
  1194.           strongly suggested  for any packet boards that have undergone any
  1195.           hardware modifications to install the switch.
  1196.  
  1197.                Now we can start the configuration process.
  1198.  
  1199.                At this  point it  is assumed  that  you  have  created  the
  1200.           configuration file  for this  switch (.CNF  file) and have run it
  1201.           through the  CONFIGUR program,  to  create  the  .TBL  file.  See
  1202.           Network Configuration and Running the Configuration Program.          Network Configuration     Running the Configuration Program 
  1203.  
  1204.                The  .TBL   file  needs   to  be   uploaded  to  the  CONFIG
  1205.           Application, See  Switching Applications,  first we  must  verify                            Switching Applications                         
  1206.           that the  CONFIG program is loaded in the switch. This is done by
  1207.           connecting to the application LOADER with the following command:
  1208.  
  1209.                cmd:c loader via rose-3,000000               cmd:                                             __________________________
  1210.                *** CONNECTED to LOADER VIA ROSE-3,000000               *** CONNECTED to LOADER VIA ROSE-3,000000
  1211.                ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1212.                :0000000000               ___________
  1213.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  1214.                OK               OK
  1215.                
  1216.                This display  shows that  none of  the optional applications
  1217.           are loaded.   In  order  to  upload  the  .TBL  file  the  CONFIG
  1218.           application must be resident in memory.
  1219.  
  1220.                To load  the CONFIG  application into  memory  you  need  to
  1221.           upload the  file CONFIG.LOD  to the Loader. This file is an ASCII
  1222.           TEXT file, no special protocol should be used to send the file.
  1223.  
  1224.                You should  receive 3  OK's back  from the  loader. At  this                                      OK                                   
  1225.           point you can verify that the CONFIG application was successfully
  1226.           loaded by entering the following command:
  1227.  
  1228.                :0000000000               ___________
  1229.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  1230.                Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration...               Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration...
  1231.                OK               OK
  1232.                
  1233.  
  1234.  
  1235.                                                                         21
  1236.  
  1237.  
  1238.                We are  now done  loading the  CONFIG  application  and  can
  1239.           disconnect from  the LOADER and connect to CONFIG to complete the
  1240.           configuration process.
  1241.  
  1242.                cmd:disc               cmd:    
  1243.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1244.                cmd:c config v rose-3,000000               cmd:                                           ________________________
  1245.                *** CONNECTED to CONFIG VIA ROSE-3,000000               *** CONNECTED to CONFIG VIA ROSE-3,000000
  1246.                ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1247.                
  1248.                We are now connected to the CONFIG application, and can send
  1249.           the .TBL file to it. This file is also an ASCII TEXT file, upload
  1250.           with no special protocol.
  1251.  
  1252.                The CONFIG  application will  return  10  OK's  through  the                                                         OK                
  1253.           course  of   processing  the  file.  If  you  included  ROUTE  TO
  1254.           statements then  you should  get 11  OK's.  Later  versions  will                                               OK                          
  1255.           include a message stating that the configuration is complete.
  1256.  
  1257.                When you have gotten all the OK's you can disconnect.
  1258.  
  1259.                cmd:disc               cmd:                       ____
  1260.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1261.                
  1262.                The configuration  process is  now complete! At this point I
  1263.           usually like  to  verify  that  the  connect  text  was  uploaded
  1264.           correctly, since it is the last portion of the .TBL file.
  1265.  
  1266.                Since the switch is now configured you now use the switches'
  1267.           callsign, instead of ROSE-3, which is in this case W2VY-3
  1268.  
  1269.           cmd:c w2vy-3          cmd:                      ________
  1270.           *** CONNECTED to W2VY-3          *** CONNECTED to W2VY-3
  1271.           [Hit Return or wait 60 Seconds]
  1272.           ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY          ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1273.           
  1274.           While Disconnected From THIS X.25 Switch issue a command like:          While Disconnected From THIS X.25 Switch issue a command like:
  1275.           
  1276.           C CALLSIGN-SSID V W2VY-3,201256          C CALLSIGN-SSID V W2VY-3,201256
  1277.           
  1278.                        Switches Available for User Access are:                       Switches Available for User Access are:
  1279.                Address   Callsign   Location             User Port Freq               Address   Callsign   Location             User Port Freq
  1280.                 201256   W2VY-3     Montclair              221.11 Mhz                201256   W2VY-3     Montclair              221.11 Mhz
  1281.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz                201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  1282.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz                609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  1283.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz                609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  1284.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz                212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  1285.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz                609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  1286.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz                609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  1287.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz                201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  1288.                                              
  1289.              Possible connect paths available to access BBS User ports.             Possible connect paths available to access BBS User ports.
  1290.           C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426          C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426
  1291.           C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663          C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663
  1292.  
  1293.  
  1294.                                                                         22
  1295.  
  1296.  
  1297.                                              
  1298.               Connect Paths Available to KA-Nodes or NETROM Facilities:              Connect Paths Available to KA-Nodes or NETROM Facilities:
  1299.           C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530          C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530
  1300.                                              
  1301.           When connecting  to NETROM  Nodes act  as if  you have  connected          When connecting  to NETROM  Nodes act  as if  you have  connected
  1302.           direct to  it.   Type C  NODENAME, after  you have  connected  to          direct to  it.   Type C  NODENAME, after  you have  connected  to
  1303.           either of  the netrom  nodes listed above, to connect to the next          either of  the netrom  nodes listed above, to connect to the next
  1304.           desired node. Type NODES to get a node list after your connect or          desired node. Type NODES to get a node list after your connect or
  1305.           type Info to get information about the particular netrom node you          type Info to get information about the particular netrom node you
  1306.           are connected to. Example:  To connect to ELK netrom node use the          are connected to. Example:  To connect to ELK netrom node use the
  1307.           following sequence:          following sequence:
  1308.           C WB2DRD-3 V W2VY-3,6o9530          C WB2DRD-3 V W2VY-3,6o9530
  1309.           C ELK          C ELK
  1310.           
  1311.           You will  shortly be  Disconnected from  this switch.  If you are          You will  shortly be  Disconnected from  this switch.  If you are
  1312.           currently connected  via either  NETROM or  KA-Node RECONNECT  to          currently connected  via either  NETROM or  KA-Node RECONNECT  to
  1313.           THAT node  and then issue a connect as shown above.  Note: It has          THAT node  and then issue a connect as shown above.  Note: It has
  1314.           come to our attention that those systems using old TNC1 code will          come to our attention that those systems using old TNC1 code will
  1315.           not accept  all digit  fields, substitute  o for 0 and i for 1 in          not accept  all digit  fields, substitute  o for 0 and i for 1 in
  1316.           the all digit field and you will be successful.  Disconnect codes          the all digit field and you will be successful.  Disconnect codes
  1317.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please          can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  1318.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch          address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  1319.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY          brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  1320.           *** DISCONNECTED          *** DISCONNECTED
  1321.           cmd:          cmd:
  1322.  
  1323.                The configuration process is now complete.
  1324.  
  1325.      Configuring a switch for the second time     Configuring a switch for the second time
  1326.  
  1327.                The following  example shows  how to configure a switch that
  1328.           knows it's  callsign,  but  otherwise  it  is  identical  to  the
  1329.           preceding example.
  1330.  
  1331.                cmd:c w2vy-3               cmd:                           ________
  1332.                *** CONNECTED to W2VY-3               *** CONNECTED to W2VY-3
  1333.                [Hit Return]
  1334.                ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1335.                *** DISCONNECTED               *** DISCONNECTED
  1336.                
  1337.                Since the text is not loaded, there must have been a power
  1338.           failure at the site, and therefore the CONFIG application needs
  1339.           to be reloaded.
  1340.  
  1341.                cmd:c loader v w2vy-3,201478               cmd:                                           ________________________
  1342.                *** CONNECTED to LOADER VIA W2VY-3,201478               *** CONNECTED to LOADER VIA W2VY-3,201478
  1343.                ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1344.                :0000000000               ___________
  1345.                Entry #0 LOADER - Application Boot interface               Entry #0 LOADER - Application Boot interface
  1346.                OK               OK
  1347.                
  1348.  
  1349.  
  1350.                                                                         23
  1351.  
  1352.  
  1353.                The CONFIG application is NOT loaded, so now you would send
  1354.           the file CONFIG.LOD, it is an ASCII TEXT file.
  1355.  
  1356.                You then get the 3 OK's and disconnect.
  1357.  
  1358.                cmd:d               cmd:                    _
  1359.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1360.                
  1361.                cmd:c config v w2vy-3,201478               cmd:c config v w2vy-3,201478
  1362.                *** CONNECTED to CONFIG VIA W2VY-3,201478               *** CONNECTED to CONFIG VIA W2VY-3,201478
  1363.                ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY               ROSE X.25 Switch Version 060289 by Thomas A. Moulton, W2VY
  1364.                
  1365.                Now send the .TBL file and receive 10 (or 11, see note
  1366.           above) OK's, when done disconnect.
  1367.  
  1368.                cmd:d               cmd:d
  1369.                cmd:*** DISCONNECTED               cmd:*** DISCONNECTED
  1370.                cmd:               cmd:
  1371.                
  1372.                The switch is now reconfigured.
  1373.  
  1374.      Configuring a Remote Switch     Configuring a Remote Switch
  1375.  
  1376.                In an operational network any switch can be loaded from any
  1377.           point within the network. You just need to issue a connect
  1378.           command to your TNC that had the callsign of the local switch,
  1379.           followed by the network address of the switch you wish to
  1380.           interact with.
  1381.  
  1382.                When accessing a completely unconfigured switch remember the
  1383.           default callsign is ROSE-3 and the default address is 000000.
  1384.           This should only happen the first time you bring up a switch, see
  1385.           the section Configuring a Switch for the first time for a step by                      Configuring a Switch for the first time              
  1386.           step example. If you notice that the switch fails to remember
  1387.           it's callsign after the power has been removed for a short time,
  1388.           that may indicate that the battery needs replacing. Lithium
  1389.           batteries are usually good for 3 Years - TAPR TNC-2's should be
  1390.           needing new batteries soon!
  1391.  
  1392.      Hardware Installation - TNC-2 or Clone     Hardware Installation                 
  1393.  
  1394.      Tools  Required:   Small  Philips   screwdriver  and   small  standard
  1395.           screwdriver.
  1396.  
  1397.           Remove power and all external connections to the TNC.
  1398.  
  1399.           Remove the  two philips  screws on the front panel and remove the
  1400.           screw in the heat sink. There is no screw on TNC-2 Rev 1 boards.
  1401.  
  1402.           If the  unit is  an MFJ  remove two  standard screws  on sides of
  1403.           cabinet and remove the lid.
  1404.  
  1405.  
  1406.                                                                         24
  1407.  
  1408.  
  1409.           Locate the program EPROM, this is normally U23, towards the front
  1410.           of the  packet controller,  next to the Z80 (big 40 pin chip that
  1411.           is 2" long). The EPROM is along side the Z80 and RAMs.
  1412.  
  1413.           The EPROM should be a labeled with something like 1.1.6 (1.1.1 up
  1414.           to 1.1.6).  It should NOT say "STATE 1.09", that EPROM is part of
  1415.           the modem. The program EPROM is U23.
  1416.  
  1417.           When you have located the EPROM note the direction the end with a
  1418.           small notch is pointing. This designates which end pin #1 located
  1419.           on. If  you install  an EPROM backwards you can damage it, either
  1420.           destroying the program or making the EPROM completely unusable.
  1421.  
  1422.           Use the  small standard  screwdriver to  lift the  EPROM a little
  1423.           above the socket.
  1424.  
  1425.           WARNING: Make  SURE you are not lifting the socket off the board.          WARNING: Make  SURE you are not lifting the socket off the board.
  1426.           Just put the corner of the screwdriver under the EPROM for now.          Just put the corner of the screwdriver under the EPROM for now.
  1427.  
  1428.           Once the  EPROM is above the surface of the socket you can insert
  1429.           the screwdriver a bit further. Try to lift the EPROM straight up,
  1430.           insert the  screwdriver as  far as it will easily go and lift the
  1431.           EPROM a  little more.  Repeat until the screwdriver is completely
  1432.           under the EPROM.
  1433.  
  1434.           If you bend any of the pins it might be a good idea to leave them
  1435.           alone until it is reused.  (The person erasing/re-programming the
  1436.           EPROM will very likely have experience with bent pins!)
  1437.  
  1438.           Make sure  the socket  is flat  and not lifted on either end from
  1439.           the board.
  1440.  
  1441.           When pressing  the EPROM into the socket it is best to press from
  1442.           the bottom  of the board as well as the on EPROM. If the EPROM is
  1443.           new the  pins will  be spread much wider than the pin rows in the
  1444.           socket. To  better align the pins you can place the EPROM on each
  1445.           edge (pins  on a table) and apply firm pressure while raising the
  1446.           chip portion  to the  vertical position. Do this for both rows of
  1447.           pins.
  1448.  
  1449.           Don't go to far! It is easier to do it again then it is to unbend
  1450.           the pins.
  1451.  
  1452.           Take the  ROSEZSW (ROSE  Z80 SWitch)  EPROM and  install  in  the
  1453.           vacated socket. Ensure the notch is pointed in the same direction
  1454.           as the  old EPROM,  as well as the silhouette on the board. Align
  1455.           both rows of pins and let the EPROM slide in a little, then check
  1456.           for stuck  pins. Slight  pressure on  the side  of each  pin will
  1457.           insure it is started into the socket straight.
  1458.  
  1459.           Go little by little watching for bending pins.
  1460.  
  1461.           After the  EPROM is  installed, check  for bent  pins by  looking
  1462.           under and along the sides for an unusual seating.
  1463.  
  1464.  
  1465.                                                                         25
  1466.  
  1467.  
  1468.           Make sure  the notch in the new EPROM has the same orientation as
  1469.           the original EPROM.
  1470.  
  1471.           Re-assemble the unit.
  1472.  
  1473.      Hardware Installation - PacComm DR-100/DR-200     Hardware Installation                        
  1474.  
  1475.           Read the  installation instructions for the TNC-2, above for some
  1476.           precautions on EPROM handling, removal and insertion.
  1477.  
  1478.           The program EPROM is located at position U2, in the center of the
  1479.           board, near the Z80.
  1480.  
  1481.           See also Hardware Modifications - DR-100/DR-200 for some required                   Hardware Modifications - DR-100/DR-200                  
  1482.           changes to the board.
  1483.  
  1484.           The port  that is  next to  the RESET  pin is  SCC Port B, and is
  1485.           called Port 0 by the ROSE Switch.
  1486.  
  1487.           DR-100 Note:  You will  need to  change the USERPORT statement in
  1488.           the configuration   file to  be "USERPORT  1" as  the DR-100 only
  1489.           has one  port and  it is set up at the same address as the DR-200
  1490.           Port 1.
  1491.  
  1492.           The daughter  board is  not currently  supported. (It has a TNC-2
  1493.           style modem disconnect so it's the simplest way to attach the NB-
  1494.           9600 High Speed modem)
  1495.  
  1496.      Hardware Modifications - TNC-2 or Clone     Hardware Modifications                 
  1497.  
  1498.           There are  no modifications  that are required to set up a single
  1499.           port switch, there are a couple of things that would be desirable
  1500.           for a busy switch.
  1501.  
  1502.           These are:
  1503.  
  1504.           1) 32K RAM upgrade
  1505.  
  1506.           2) Change the CPU clock to 4.9 MHz (JMP2 on TNC-2)
  1507.  
  1508.           The following modifications are required if you intend to use the
  1509.           asynchronous port  on a  radio or  tied back to back with another
  1510.           TNC:
  1511.  
  1512.           1) Add  a jumper  from J1  pin 23 to JMP 9 pin 3, note that JMP 9
  1513.           has pins 1, 2 and 3 tied together.
  1514.  
  1515.           2) If you want to run the asynchronous port at 4800 baud or above
  1516.           U3 (LM324) should be changed to a TL084.
  1517.  
  1518.           3) If running back to back with other TNCs add jumper from J1 Pin
  1519.           10 to  J1 Pin 20, this should be done in the cable. If connecting
  1520.           to a  Radio do  not add this jumper, see Wiring TNCs for Back-to-                                                   Wiring TNCs for Back-to-
  1521.           Back Mode for a complete description.          Back Mode                            
  1522.  
  1523.  
  1524.                                                                         26
  1525.  
  1526.  
  1527.      Hardware Modifications - DR-100/DR-200     Hardware Modifications                
  1528.  
  1529.           There are  two types  of modifications  listed  for  the  DR-200,
  1530.           required and  optional. The  required changes  are to  supply the
  1531.           Transmit and  Receive Clocks  to the  Zilog Serial  Communication
  1532.           Controller (Z8530)  chip, which sets the baud rate for each port,
  1533.           and removal  of the "Processor WatchDog Timer" which was found to
  1534.           be ineffective.  The optional  changes are  modifications to  the
  1535.           modem circuit  that have,  in some  cases  increased  performance
  1536.           dramatically.
  1537.  
  1538.           Note: Ux/n  means chip  marked Ux pin n, on IC's the end with the
  1539.           notch has pin #1. When viewed from the top, pin #1 is just to the
  1540.           left of the notch.
  1541.  
  1542.           Required:          Required:
  1543.  
  1544.           U14 = 7910 Port A; U15 = 8530 SCC; U16 = 7910 Port B
  1545.  
  1546.           Jumper U14/25 to U15/19
  1547.           Jumper U16/25 to U15/21
  1548.  
  1549.           This connects the DCD outputs of the 7910's to the SCC.
  1550.  
  1551.           The baud rate generator is U12, which is located next to the 7910
  1552.           (U14) on the same side as the Z80.  A jumper is required for both the
  1553.           TX and RX clock of each port, FOUR (4) jumpers should be installed.
  1554.           This allows different baud rates for each port. To select the correct
  1555.           clocks use the following table:
  1556.  
  1557.                U12 Pin   RXClock        TXClock
  1558.                 7        9600
  1559.                 5        4800
  1560.                 4        2400
  1561.                 6        1200
  1562.                13         600
  1563.                12         300           9600
  1564.                14                       4800
  1565.                15                       2400
  1566.                 1                       1200
  1567.                 2                       600
  1568.                 3                       300
  1569.      
  1570.                The SCC Pins are defined as follows:
  1571.  
  1572.                Port #    RXClock        TXClock
  1573.                  0       U15 28         U15 26
  1574.                  1       U15 12         U15 14
  1575.                
  1576.  
  1577.  
  1578.                                                                         27
  1579.  
  1580.  
  1581.                For dual port operation with both ports running at 1200
  1582.                baud install the following jumpers:
  1583.  
  1584.                U15/28 and U15/12 to U12/6  (RXClock)
  1585.                U15/26 and U15/14 to U12/1  (TXClock)
  1586.                
  1587.                For Port 0 at 1200 Baud and Port 1 at 300 Baud
  1588.                
  1589.                U15/28 to U12/6  (RXClock Port 0)
  1590.                U15/26 to U12/1  (TXClock Port 0)
  1591.                U15/12 to U12/12 (RXClock Port 1)
  1592.                U15/14 to U12/3  (TXClock Port 1)
  1593.  
  1594.           A Processor  Watchdog Timer  is a  circuit that  is  designed  to
  1595.           ensure the  CPU does  not get  hung (dead)  due to a power glitch
  1596.           (normally a programmer's bug).  The Processor Watchdog circuit is
  1597.           not compatible  with the normal operation of a ROSE Switch and if
  1598.           it is  not removed  the ROSE  Switch will  operate in  an erratic
  1599.           fashion.
  1600.  
  1601.           Remove U19  located next to one of the audio lines, opposite edge
  1602.           of board  from EPROM.   Also  remove C32 and install U7 (74HC132)
  1603.           with pins  3, 12  and 13 uninserted and add a jumper from U7/3 to
  1604.           U7/12, this  cleans up  the reset  line since the watchdog is now
  1605.           out of the circuit.
  1606.  
  1607.           Optional:          Optional:
  1608.  
  1609.           Remove the  RX Audio filtering (U17 and U20), the modem will work
  1610.           better on  it's own.  I removed  U17, R21, R23, Diodes at C24 and
  1611.           installed a  0.1 uf at C24 and Jumper JP-FA. And the same for the
  1612.           other port (Remove U20, R34, R33, Diodes at C45 and installed 0.1
  1613.           uf at  C45 and Jumper JP-FB). If you use the modem on HF remember
  1614.           the tones are 425 hz higher (.5 khz on dial should be ok) and you
  1615.           need to reduce the RF Gain so the background static is below 10mv
  1616.           (audio). Might  want to  use the  R33/R30 voltage divider and add
  1617.           jumper from  their junction to the other side of JP-FB and remove
  1618.           C41 and leave JP-FB uninstalled.
  1619.  
  1620.  
  1621.                                                                         28
  1622.  
  1623.  
  1624.      Wiring TNCs for Back-to-Back Mode     Wiring TNCs for Back-to-Back Mode
  1625.  
  1626.           Asynchronous pin definitions:
  1627.  
  1628.           All connections are to J1 (DB 25)
  1629.  
  1630.           Pin #     Direction/EIA Pin Designation/Usage
  1631.            1 [5]    NA/Frame Ground
  1632.            2 [3]    In/TXD/Data On
  1633.            3 [2]    Out/RXD/Data Out
  1634.            5 [8]    Out/CTS/Request To Send (Async PTT)
  1635.            7        NA/Ground
  1636.           10        Out/LO/Pull Down signal
  1637.           20        In/DTR/If LO wired Back to Back
  1638.           -         . /If not LO used as Radio Port
  1639.           23 [9]    In/SEL/Carrier Detect
  1640.  
  1641.           Note: Pin numbers in brackets are for PacComm Tiny-2 and
  1642.           Micropower. For Tiny and Micropower in Back-To-Back configuration
  1643.           also need to add jumper from U15 (MAX231) Pin 3 to U15 Pin 4.
  1644.  
  1645.           Each output line should be wired through a diode, DB25 outputs
  1646.           current to the external device. (DB25 pin -->|-- rest)
  1647.  
  1648.           CAPS mean this tnc, lower means all other tnc's
  1649.  
  1650.           GND PIN  1 ------ gnd pin 1
  1651.           TXD PIN  2 ------ rxd pin 3
  1652.           RXD PIN  3 -->|-- txd pin 2
  1653.           CTS PIN  5 -->|-- sel pin 23
  1654.           GND PIN  7 ------ gnd pin 7 (Optional)
  1655.           DTR PIN 20 ------ LO PIN 10
  1656.           SEL PIN 23 ------ cts pin 5
  1657.  
  1658.      Differences between ROSE and Net/ROM Back-to-Back Cable     Differences between ROSE and Net/ROM Back-to-Back Cable
  1659.  
  1660.      For further study.
  1661.  
  1662.      Asynchronous Radio Port Cable     Asynchronous Radio Port Cable
  1663.  
  1664.           Radio Port Cable Needs:
  1665.  
  1666.           CAPS mean TNC, lower means Modem DB25
  1667.  
  1668.           GND PIN  1 - gnd pin 1
  1669.           TXD PIN  2 - rxd pin 3
  1670.           RXD PIN  3 - txd pin 2
  1671.           CTS PIN  5 - rts pin 4 (Radio keying circuit/PTT)
  1672.           DSR PIN  6 - dtr pin 20 (depending on Modem)
  1673.           GND PIN  7 - gnd pin 7 (Optional)
  1674.           SEL PIN 23 - dcd pin 8 (Tie Modem DCD to sio dcdb)
  1675.  
  1676.  
  1677.                                                                         29
  1678.  
  1679.  
  1680.      Appendix 1 - Files Supplied in archive     Appendix 1 - Files Supplied in archive
  1681.  
  1682.           The following files are included in the archive ROSEZSW.ARC:
  1683.  
  1684.           READZSW.ME   - Boot strap information as well as changes from the
  1685.                          previous release.
  1686.  
  1687.           ROSESYS.DOC  - SYSOP Information on installation and
  1688.                          configuration (THIS FILE).
  1689.  
  1690.           ROSEUSER.DOC - User manual for the Switch.
  1691.  
  1692.           CONFIGUR.EXE - IBM PC executable that converts the network
  1693.                          description file (xyz.CNF) to a file that is
  1694.                          loadable into a switch CONFIG application
  1695.                          (xyz.TBL).
  1696.  
  1697.           CONFIG.LOD   - The configuration interface that is executed on
  1698.                          the switch while uploading the ".TBL" file.
  1699.  
  1700.           MEMSIZ.LOD   - Simple test application, gives you the amount of
  1701.                          memory used.
  1702.  
  1703.           USERS.LOD    - Application that provides the user with a list of
  1704.                          all active connections to or through a switch.
  1705.  
  1706.           NPA.ARC      - Archive that contains all the Area Codes in the
  1707.                          USA and Canada broken down by state/province and
  1708.                          by call area.
  1709.  
  1710.           ROSEZSW.BIN  - Binary image suitable for EPROM programming.
  1711.  
  1712.           ROSEZSW.HEX  - Intel HEX format file suitable for EPROM
  1713.                          programming.
  1714.  
  1715.           ROSEZSW.LST  - Assembly listing to aid the custom modification of
  1716.                          some of the default parameters.
  1717.  
  1718.           ROSEZSW.MAP  - Address map of all entry points and global
  1719.                          variables, useful in custom modification of
  1720.                          default parameters.
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.      Appendix 2 - ROSE X.25 Packet Switch User's Manual     Appendix 2 - ROSE X.25 Packet Switch User's Manual
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.      Appendix 3 - Network Configuration Example     Appendix 3 - Network Configuration Example
  1733.      
  1734.           THIS DNIC 3100 United States of America
  1735.           
  1736.           THIS NODE Clifton
  1737.           ADDRESS 201478
  1738.           CALL W2VY-3
  1739.           DIGI W2VY-2
  1740.           COVERAGE
  1741.           201472 201473 201777 201779 201470 201478
  1742.           201778 201772
  1743.           END
  1744.           USERPORT 0
  1745.           TEXT
  1746.           $
  1747.           While Disconnected From THIS X.25 Switch issue a command like:
  1748.           $
  1749.           C CALLSIGN-SSID V W2VY-3,201256
  1750.           $
  1751.                        Switches Available for User Access are:
  1752.                Address   Callsign   Location             User Port Freq
  1753.                 201256   W2VY-3     Montclair              221.11 Mhz
  1754.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  1755.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  1756.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  1757.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  1758.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  1759.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  1760.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  1761.           $
  1762.              Possible connect paths available to access BBS User ports.
  1763.           C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426
  1764.           C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663
  1765.           $
  1766.               Connect Paths Available to KA-Nodes or NETROM Facilities:
  1767.           C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530
  1768.           $
  1769.           When connecting  to TheNet  Nodes act  as if  you have  connected
  1770.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  1771.           either of  the TheNet  nodes listed above, to connect to the next
  1772.           desired node. Type NODES to get a node list after your connect or
  1773.           type Info to get information about the particular TheNet node you
  1774.           are connected to. Example:  To connect to ELK TheNet node use the
  1775.           following sequence:
  1776.           C WB2DRD-3 V W2VY-3,6o9530
  1777.           C ELK
  1778.           $
  1779.           You will  shortly be  Disconnected from  this switch.  If you are
  1780.           currently connected  via either  TheNET or  KA-Node RECONNECT  to
  1781.           THAT node  and then issue a connect as shown above.  Note: It has
  1782.           come to our attention that those systems using old TNC1 code will
  1783.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  1784.           the all digit field and you will be successful.  Disconnect codes
  1785.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  1792.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  1793.           $EOF
  1794.           END
  1795.           
  1796.           NODE Manhattan
  1797.           ADDRESS 212456
  1798.           PATH KD6TH-3
  1799.           END
  1800.           
  1801.           NODE LittleFalls
  1802.           ADDRESS 201744
  1803.           PATH N2DSY-3
  1804.           END
  1805.           
  1806.           NODE Clifton2
  1807.           ADDRESS 201779
  1808.           PATH W2VY-9
  1809.           PORT 1
  1810.           END
  1811.           
  1812.           NODE Montclair
  1813.           ADDRESS 201256
  1814.           PATH W2VY-12 Via KB1BD-2
  1815.           END
  1816.           
  1817.           USER KD6THbbs
  1818.           PATH KD6TH-4
  1819.           PORT 1
  1820.           MAXVC 0
  1821.           END
  1822.           
  1823.           Route to Nodes Manhattan LittleFalls
  1824.           Calls for
  1825.           207 802 617 508 413 203 401
  1826.           518 607 212 718 716 516 914 315
  1827.           end
  1828.           
  1829.           Route to Node Manhattan
  1830.           Calls for
  1831.           212456
  1832.           end
  1833.           
  1834.           Route to Node LittleFalls
  1835.           Calls for
  1836.           201744
  1837.           end
  1838.           
  1839.           Route to Node LittleFalls
  1840.           Calls for
  1841.           609 215 717 202
  1842.           end
  1843.           WRITE w2vy-3.tbl
  1844.           QUIT
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.      Appendix 4 - Terminology     Appendix 4 - Terminology
  1851.  
  1852.                A Link  is a  connection between  two stations,  either  two                 ____                                                      
  1853.           users, two switches or a user and a switch.
  1854.  
  1855.                A Virtual  Circuit, or  VC is a connection for data transfer                 ________________________                                  
  1856.           between two  users, in a multi-switch networking environment this
  1857.           may involve more than one Link.                                    ____ 
  1858.  
  1859.                A Network  Address is  a number  that  identifies  an  entry                 ________________                                          
  1860.           and/or exit point of the network.
  1861.  
  1862.                A Call  or Call  Request is  what a  user or switch sends to                 ______________________                                    
  1863.           another switch to attempt to set up a VC to the specified Network                                                __                  _______
  1864.           Address.          _______ 
  1865.  
  1866.                A Clear  is an  indication  that  a  Call  or  VC  is  being                 _____                              ____________           
  1867.           disconnected, a clearing cause is supplied to indicate the reason
  1868.           for the disconnection.
  1869.  
  1870.                A Routing  Alternative is  the list of switches that will be                 ____________________                                      
  1871.           tried when  a Call  Request is  received for  a specific  Network                        _____________                               _______
  1872.           Address.          _______ 
  1873.  
  1874.                A Block  Statement is a collection of commands that effect a                 ________________                                          
  1875.           common item  that was  specified  at  the  start  of  the  block.
  1876.           Examples of  Block Statements are NODE and USER, see below. Block
  1877.           Statements can be nested.
  1878.  
  1879.                A TNC-2  Clone includes, but is not limited to the following                 ____________                                              
  1880.           packet  controllers;   TAPR  TNC-2;   PacComm  TNC-200,   TINY-2,
  1881.           Micropower-2;  AEA   PK-80;  MFJ  1270,  1278  and  is  generally
  1882.           identifiable has a TNC having a Z80 CPU and Z80 SIO/0.
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.      Appendix 5 - Shifted ASCII Table     Appendix 5 - Shifted ASCII Table
  1889.                      Character Hex Value   Shifted
  1890.                         A         41        82
  1891.                         B         42        84
  1892.                         C         43        86
  1893.                         D         44        88
  1894.                         E         45        8A
  1895.                         F         46        8C
  1896.                         G         47        8E
  1897.                         H         48        90
  1898.                         I         49        92
  1899.                         J         4A        94
  1900.                         K         4B        96
  1901.                         L         4C        98
  1902.                         M         4D        9A
  1903.                         N         4E        9C
  1904.                         O         4F        9E
  1905.                         P         50        A0
  1906.                         Q         51        A2
  1907.                         R         52        A4
  1908.                         S         53        A6
  1909.                         T         54        A8
  1910.                         U         55        AA
  1911.                         V         56        AC
  1912.                         W         57        AE
  1913.                         X         58        B0
  1914.                         Y         59        B2
  1915.                         Z         5A        B4
  1916.                         0         30        60
  1917.                         1         31        62
  1918.                         2         32        64
  1919.                         3         33        66
  1920.                         4         34        68
  1921.                         5         35        6A
  1922.                         6         36        6C
  1923.                         7         37        6E
  1924.                         8         38        70
  1925.                         9         39        72
  1926.                       space       20        40
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.      Appendix 6 - ROSE Registration Form     Appendix 6 - ROSE Registration Form