home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / packet / pak_34 / amsoft.iii next >
Text File  |  1997-02-01  |  17KB  |  395 lines
  1.                           Praffic with TVision
  2.  
  3.                        Release 2.0 DOS and DPMI16
  4.  
  5.                Copyright 1992ñ1995 Savegnago Marco IW3FQG
  6.  
  7.  
  8.  
  9.                 >>> PRAFFIC IS NOT A TERMINAL PROGRAM <<<
  10.  
  11.  
  12. What is Praffic?
  13. ----------------
  14. This program was made for my own hobby use only. Praffic is a useful tool to
  15. analyse the traffic on a packet channel using a common TNC running in KISS or
  16. SMACK mode. The program displays communication details in a simple way trough
  17. an user friendly interface (Turbo Vision 2.0X Borland International 1994).
  18. The rest of the program is based on my self-developed library PKLIB, which I'm
  19. going (sooner or later) to distribute freely in binary form to anyone
  20. interested in developing programs for digital communications, with NO
  21. commercial purpose.
  22.  
  23. Why Praffic?
  24. ------------
  25. Praffic his idea and his kernel are the natural evolution of the batch mode
  26. program PraK that I used to study the behaviour of packet broadcasts
  27. independently from the kind of information they carry on the air.
  28. Packet and its high inefficiency annoyed me, so I was induced to write an AX25
  29. implementation. I had to choose between doing something new or being forced to
  30. devote me to better hobbies. Because of the passion (it never dies!), some new
  31. doubts about radio operations in a chaos regime (a bit like car traffic in my
  32. medieval city) and a large amount of data transmitted due to new technologies,
  33. I decided to write a  program that helps to analyse the state of a transmission.
  34. This program should be serviceable from anyone interested, even though  not
  35. experienced of communication protocols, but capable of developing good ideas.
  36. The name, eventually. Even I don't like it, so if anybody finds another
  37. interesting one I'll arrange to change it, and to give him credit.
  38.  
  39. New features of this release.
  40. ----------------------------
  41. ╖   DPMI version;
  42. ╖   external MBBIOS or compatible management;
  43. ╖   some other minor improvements.
  44.  
  45.  
  46. Praffic features
  47. ----------------
  48. Fundamental features of the program are the following:
  49. ╖       traffic visualisation with TF-like presentation or Praffic
  50.         mode (fully configurable) with filtering capability on callsigns
  51.         to display, as well as on frame type.
  52. ╖       function QsoSpy that allows to filter and to isolate traffic
  53.         from a single station in a separate window, with one-to-one or one-
  54.         to-many capability - capability of opening concurrent windows
  55.         (limited only by available memory) to analyse the same frame from
  56.         different points of view
  57. ╖       continuous visualisation of the type of frame under
  58.         inspection, with possibility of including/excluding some frames or
  59.         performing an individual analysis
  60. ╖       MHeard function including listening time of first/last and
  61.         preceding frame, total bytes transferred, quantity and type of
  62.         frames heard from each station - Inspect function on particular
  63.         callsigns or frame types, triggering some configurable actions
  64. ╖       Frame Watch function on stated frame, with variable trigger
  65.         threshold and configurable action to take once or every time that
  66.         frame is received
  67. ╖       information output on a event driven environment, easy to use,
  68.         better if used with a mouse and with an EGA/VGA monitor in 43/50
  69.         lines display mode - use of a common TNC running in KISS or SMACK
  70.         mode connected to serial line COM (fully user configurable and
  71.         capable of using 16550A)
  72. ╖       the DOS release runs on a PC with Ms-DOS 3.3 or compatible
  73.         with any video card (Hercules, CGA, EGA/VGA), a Ms compatible
  74.         mouse and 512 KB RAM - the DPMI release runs on at least an AT
  75.         80286 with 1 MB of extended RAM an it can use all available
  76.         memory, breaking the 640 KB memory limit
  77.  
  78.  
  79. Praffic release
  80. ---------------
  81. If program heading shows the label ALFA, BETA or GAMMA the program may be
  82. (it surely will be!) still not completely safe in operation
  83.  
  84. DPMI16?
  85. -------
  86. Since release 2.0, the program is available also in DPMI protected mode of
  87. Borland C++ DOS extender. The 640 KB limit from the real mode microprocessor
  88. addressable memory is removed by the DOS extender and all free system memory
  89. can be used.  For this reason, the program needs RTM.EXE and DPMI16BI.OVL
  90. (freely distributable). They must reside in the program directory or in the
  91. system PATH.
  92. You can use any other DPMI v0.9 compatible extender (as Windows or OS/2)
  93. instead of this. Program options and operations are the same of the real mode
  94. DOS version but you can also set the following variables:
  95.  
  96. EXTLEAVE [nnnn]         forces extended memory amount  to be kept free
  97.                         (default:64 KB)
  98. EXTMAX [nnnn]           forces maximum extended memory amount to be
  99.                         allocated (default: all extended memory)
  100. EXTMIN[nnnn]            forces minimum extended memory amount required
  101.                         for running
  102. REALLEAVE [nnnn]        forces real memory (under the first MB) amount
  103.                         to keep free (default: 64 KB)
  104. REALMAX [nnnn]          forces maximum real memory amount to be allocated
  105.                         (default: all conventional memory)
  106. REALMIN [nnnn]          forces minimum extended memory amount required for
  107.                         running
  108.  
  109. Note: all amounts are expressed in KB.
  110. [nnnn] can be a decimal number or a hexadecimal one, if preceded by the 'x'
  111. character.
  112.  1000 [xABCD]
  113.  
  114. WARNING! The variables above work using the provided DPMI Borland Server.
  115. If you are using Windows or OS/2 DPMI Server, please refer to the relative
  116. manuals.
  117.  
  118. Why DOS is still in use?
  119. ------------------------
  120. At the actual state of  operating systems, DOS is the only one that still
  121. allows good throughputs, speaking of visualisation speed and serial I/O
  122. management on systems not so rich of dedicated hardware or portable computers.
  123. I thought a lot about a different way of representing information from a packet
  124. radio channel (charts, imagery designs, and so on) and after some tries (there
  125. is also a Praffic prototype running under Windows) I decided to implement a
  126. version capable of running on my Attila. If anybody has any good idea or
  127. suggestion I'm ready to listen. Program implementation is based on the PKLib
  128. library, with which I hope to port  next release of my program on other
  129. operative systems.
  130.  
  131.  
  132. Why use Praffic?
  133. ----------------
  134. Praffic basically is intended to be a tool to understand what goes wrong using
  135. the so diffuse and actual AX25 protocol. Praffic should be an easy-to-use
  136. platform for measures and experiments. The heart of Praffic indeed is based on
  137. PKLib 2.0 (Copyright (C) 1991-1995 Marco Savegnago) classes, a collection of
  138. objects written, re-written and modified many times by me with the goal of
  139. making some tools quickly reusable for the creation of digital communication
  140. applications. Additionally, Praffic can be used as a filtering and decoding
  141. tool for SWL stations.
  142.  
  143.  
  144. How to use Praffic
  145. ------------------
  146. The program works with a common TNC running in KISS or SMACK mode. You can set
  147. the TNC to this mode from the running program (before opening communications
  148. with the device) or at start-up. In case of difficulties managing TNC, the
  149. program pops up a dialogue box with a ôKiss Time-outö warning. If this happens,
  150. try to restart the TNC in Kiss mode. Once started, the program presents itself
  151. in the classical Turbo Vision environment, with which mouse or keyboard
  152. interact. Main program functions are accessible from View menu:
  153. ╖   Monitor
  154. ╖   QsoSpy
  155. ╖   Mheard
  156. ╖   Inspect
  157. ╖   FrameWatch
  158.  
  159.  
  160. MONITOR
  161. The view MONITOR allows to monitor AX25 packet traffic (Level 2 and FRMR,
  162. Netrom 3/4 and Broadcast) choosing what to show and how to display it.
  163. There are 2 kinds of monitor header format: The-Firmware-Like or
  164. Original-Praffic. Using options dialogue boxes you can configure any part of
  165. the frame to be displayed.
  166.  
  167. QSOSPY
  168. The QSOSPY view is intended for monitoring a conversation among stations.
  169. Using wildcards it is possible to monitor groups of callsigns:
  170.  
  171. IW3FQG->*       =       IW3FQG-0 toward all and vice-versa
  172. *->IW3FQG       =       all toward IW3FQG and vice-versa
  173. IW3F*->I3KUH    =       any call whose first four characters matching
  174.                         IW3F toward I3KUH
  175.  
  176. As for MONITOR, this view is fully user configurable.
  177.  
  178. MHEARD
  179. MHEARD view displays the list of stations you have been listening since the
  180. beginning of program execution, with information about number of frame received.
  181. For detailed analysis of frame heard, use INSPECTOR function.
  182.  
  183. INSPECTOR
  184. The INSPECTOR view displays detailed information relative to a call heard in
  185. Mheard list. Available data are:
  186.  
  187.         "Call"  -> Callsigns heard
  188.         " 1st"   -> Time of the first frame heard
  189.          "Prev"  -> Time of the previous frame heard
  190.          "Last"  -> Time of the last frame heard
  191.          "I #"  -> Number of  I frames heard
  192.          "I"   -> Numbers of  bytes contained in the I frames heard
  193.          "RR#"   -> Number of RR frames heard
  194.          "REJ#"  -> Number of REJ frames heard
  195.          "RNR#"  -> Number of RNR frames heard
  196.          "SREJ#" -> Number of SREJ frames heard (*)
  197.          "UI#"   -> Number of UI frames heard
  198.          "UI"    -> Numbers of bytes in UI frames heard
  199.          "DM#"   -> Number of DM frames heard
  200.          "SABM#" -> Number of SABM frames heard
  201.          "DISC#" -> Number of DISC frames heard
  202.          "UA#"   -> Number of UA frames heard
  203.          "FRMR#" -> Number of FRMR frames heard
  204.  
  205.          "TOTAL" -> Total number of frames heard
  206.  
  207.  (*) The SREJ frame is not available in the standard AX25 L2.
  208.  
  209. FRAMEWATCH
  210. FRAMEWATCH enables to schedule an event triggered by the reception of a frame
  211. from a stated station (or multiple ones), or by stated data inside the frame.
  212. Available actions managed by FRAMEWATCH are beyond a simple acoustic and visual
  213. message, ranging from the recording of a message in the log file to the
  214. activation of a Spy view, the activation/deactivation of another FRAMEWATCH
  215. and so on. Intervention threshold is adjustable on the number of received
  216. frames. FRAMEWATCH can be modified runtime or activated/deactivated by hotkey.
  217.  
  218. Integrated SETKISS
  219. ------------------
  220. From version 1.1 IÆve integrated SETKISS function in Praffic main menu.
  221. The selection dialogue box allows to use configuration strings for most used
  222. TNC's.
  223.  
  224. TAPR TNC2       "KISS ON\rRESTART\ r"
  225. TF 2.X          "\ x11\ x18\ x1b@ K\ r"
  226. AEA             "CONMODE TRANS ON\rPP ON\rRAW OFF\rHP ON\r KISS ON \rHOST\r"
  227. KANTRONICS 2.X  "KISSMODE ON\rRESET\r"
  228. KANTRONICS 3.X  "INTFACE KISS\rRESET\r"
  229.  
  230. The fifth selection sends the "\xC0\xFF\zC0" sequence to exit KISS
  231. mode, while the sixth selection sends a customisable command.
  232.  
  233. The TVision interface used in Praffic
  234. -------------------------------------
  235. The interface used in Praffic with Tvision is the standard Borland Turbo Vision
  236. interface, available in both C++ and Turbo Pascal programming languages. It
  237. works like the most modern graphical user interfaces in character mode,
  238. offering good performances and a programming environment similar to Windows or
  239. OS/2.
  240.  
  241. Mouse and Praffic
  242. -----------------
  243. The mouse in Praffic is very important. It is essential in many cases, because
  244. some functions are activable only by a mouse.
  245. Remember to click right button while pointing at a view to activate the
  246. context-sensitive options available.
  247.  
  248. Praffic command line options
  249. ----------------------------
  250. Command line options modify default settings relative to serial I/O, video
  251. display and other.
  252.  
  253. / Cc-   Set communication port to be used 1|2|3|4
  254.            e.g.: / C2= COM2
  255.  
  256. / D-    Search for the presence of DesqView and in this case forces
  257.         the use of its virtual screen pointer
  258.  
  259. / K[T|H|T|O|K]- Sends KISS to the TNC on execution using the
  260.         parameter compatible with:
  261.  
  262.                 T= TAPR TNC2 or clones with EPROM 1.xx
  263.                 H= TAPR TNC2 or clones with EPROM HOST TheFirmware
  264.                 T= TNC AEA
  265.                 O= TNC Kantronics with EPROM 2.XX
  266.                 K= TNC Kantronics with EPROM 3.XX
  267.  
  268. / I Sets interrupt to be used
  269.  
  270. / L Sends to TNC the standard string to exit KISS on shutdown.
  271.  
  272. / M[I|M]- Specifics the driver I)NTERNAL or M)BBIOS used.
  273.  
  274. / N- Avoid 'snow effect' on CGA
  275.  
  276. / P- Specifies the address of COM port to be used
  277.  
  278. / Ss- Sets the COM speed among one of the followings:
  279.             (3)00 (1)200 (2)400 (4)800 (9)600 192(0)0 3(8)400
  280.                 5(7)600 11(5)200 baud e.g.: / S0= 19200
  281.  
  282. / T[C|I]- Tells the program which parameter is in use between COM
  283.         and ADDRESS for COM port to be used (only for internal driver).
  284.  
  285. /?| H- Shows this text
  286.  
  287.  
  288. Praffic configuration
  289. ---------------------
  290. The program was written to be used by people with a certain knowledge about TNC,
  291. serial ports addresses and interrupts, configuration and use of drivers such as
  292. MBBIOS etc. Surely this program is not foolproof, as almost all commercial
  293. products are, nowadays. With internal driver, the program has the following
  294. default values for COMs:
  295.  
  296.     COM1-> Address= 0x3F8, Irq= 4
  297.     COM2-> Address= 0x2F8, Irq= 3
  298.     COM3-> Address= 0x3E8, Irq= 4
  299.     COM4-> Address= 0x2E8, Irq= 3
  300.  
  301. Beyond COM4 values are repeated so COM5 is the same as COM1 and so on...
  302. For external driver see its documentation.
  303.  
  304. The Author of Praffic
  305. ---------------------
  306. This text was not written with the intent of providing a detailed manual for
  307. less experienced users. The program is only a tool to analyse packet radio
  308. traffic and it should be used for this purpose. The program comes with no
  309. warranty and its author can decide to modify it at any time or to drop the free
  310. distribution policy at any moment. If anybody finds any bugs or has any
  311. improving ideas or hints (no personal adaptations, please!), he can send me a
  312. letter or anyway a WRITTEN message, NOT a VOCAL one (no radio, telephone,
  313. intercom messages :-) :-) )
  314.  
  315. My address is:
  316.  
  317.         Marco Savegnago
  318.         Stradella Ospedale 87
  319.         36100 Vicenza
  320.         Italy
  321.  
  322. Packet-Radio:   IW3FQG@I3KUH.IVEN.ITA.EU
  323. Internet:       mc2365@mclink.it
  324.  
  325. Copyright on Praffic
  326. --------------------
  327. The Praffic program and his components can  freely be copied and distributed in
  328. any form only for amateur radio purposes, from which no one is entitled to draw
  329. aside profit, however.
  330. Is also forbidden to use the program for demonstrations in private and public
  331. commercial business, institutional, town, regional, statal and government
  332. organization.  Any type of commercial exploitation not expressly authorized by
  333. the author is to be considered forbidden!
  334. No responsibility is taken by the author if, during execution, the program
  335. causes blocks that could result in loss of data or computer malfunctioning.
  336.  
  337. Copyright (c) 1995 Marco Savegnago. All right reserved.
  338.  
  339. Personal considerations on the program
  340. --------------------------------------
  341. A program like this may apper completely useless to many people.
  342. Yet, many others  wrote or phoned me to say  they have appreciated it, and to
  343. suggest me some new ideas. They proposed me traffic simulation to test a link
  344. or random frames generation, or packet cracking function. These features are
  345. included only in my private version of the program, and I'm not going to freely
  346. distribute this one. I do this to avoid that some guys act in strange ways...
  347. with good or bad intentions they could misuse and disturb any connection,
  348. without being discovered and prosecuted. The freely distributed copy doesn't
  349. contain all the functions available in the original version to avoid that
  350. anyone could be the unintentional or intentional cause of trouble.
  351.  
  352. Possible features added to next releases
  353. ----------------------------------------
  354. ╖   Management of HDLC modem directly connected to the COM port
  355.     (BAYCOM like) to see really ALL is on the air, flags txdelay
  356.     axdelay fcs error...
  357. ╖   Limited Traffic simulation!
  358. ╖   Limited Random Generation of frames
  359. ╖   Terminal
  360. ╖   Decoding of other protocols
  361. ╖   Multiport
  362.  
  363. Fonts and bibliographic references
  364. ---------------------------------
  365.  
  366. -       Implementation of AX25 in the NOS program of KA9Q
  367.  
  368. -       Implementation of AX25 of the TheFirmware program of the group German
  369.         NORTH><LINK
  370.  
  371. -       Tanenbaum, Andrew S., "Networks Computer" pp.  288-292.
  372.     Prentice-Hall 1981.
  373.  
  374. -    X.25 MADE EASY Nicolas M.Thrope, Derek Ross
  375.     Prentice-Hall 1992.
  376.  
  377.  
  378. Special Thanks
  379. --------------
  380.  
  381. This correct english text was made by:
  382.  
  383. Mauro Furin IW3FWK
  384.  
  385. Packet: IW3FWK@I3KUH.IVEN.ITA.EU
  386. email:  yoda@maya.dei.unipd.it
  387.  
  388.  
  389. Vicenza (Italy) Agosto 1995
  390.  
  391. Marco Savegnago
  392.  
  393. Ciao!
  394.  
  395.