home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / PAGE-ILL.ZIP / PD-102.EXE / PD.TXT < prev    next >
Text File  |  1995-06-27  |  9KB  |  335 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                           PD  -  POCSAG Decoder
  16.  
  17.                            User Documentation
  18.  
  19.                         Version 1.02   June 1995
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                               Contents
  31.  
  32.  
  33.     1.        Introduction
  34.     
  35.     2.        Registration
  36.     
  37.     3.        Installation
  38.     
  39.     4.        Interfacing
  40.     
  41.     5.        Configuration
  42.     5.1        PD.INI
  43.     5.1.1        General Parameters
  44.     5.1.2        Function Codes
  45.     5.2        PAGERS.INI
  46.     5.3        REJECT.INI
  47.     
  48.     6.        Running the program
  49.     6.1        Command Line Options
  50.     6.2        Supported Keys
  51.     6.3        Status Line
  52.     6.4        Normal Mode
  53.     6.5        Debug Mode
  54.     
  55.  
  56.  
  57.  
  58. 1.    Introduction
  59.  
  60. PD, together with a receiver or scanner, allows the off-air decoding of
  61. POCSAG paging signals at either 1200 or 512 bits/second. This makes it
  62. extremely useful for the testing of paging transmitters and systems.
  63.  
  64. Decoding of both numeric and alphanumeric pager data is supported, as is
  65. the hex dumping of raw POCSAG codewords.
  66.  
  67. PD runs on an IBM PC or equivalent, anything from an 8086 upwards. It 
  68. requires 512K of conventional memory and a small amount of hard disk
  69. or floppy. Hard disk is recommended.
  70.  
  71. PD runs from DOS, running from Windows is not recommended.
  72.  
  73.  
  74. 2.    Registration
  75.  
  76. PD is freely distributed as a shareware version. This has a timeout of
  77. about 5 minutes, after which a registration message is displayed and
  78. the program exits. Also the logging of pager data to disk is disabled.
  79.  
  80. To obtain a fully functional registered copy of PD send a cheque or money
  81. order for 20.00 pounds sterling to:-
  82.  
  83.             Peter Baston,
  84.             7 Allerton Close,
  85.             Pen-y-ffordd,
  86.             Clwyd,
  87.             CH4 0NJ,
  88.             U.K.
  89.  
  90.  
  91.  
  92. 3.    Installation
  93.  
  94. In order to install the program copy the following files into a directory
  95. on a hard drive, or onto a floppy:-
  96.  
  97.     PD.EXE        Pocsag Decoder program
  98.     PD.INI        Configuration file
  99.     PAGERS.INI    List of pager codes (7 digit RIC's) to be logged
  100.     REJECT.INI    List of pager codes to reject
  101.     PD.TXT        This documentation file
  102.  
  103.  
  104.  
  105. 4.    Interfacing 
  106.  
  107.  
  108. The PD program requires serial POCSAG data to be applied to the CTS pin
  109. of one of the PC's COM ports. RS232 levels are required, ie at least +/-
  110. 3v. PD is insensitive to polarity, ie it doesn't matter which way up mark 
  111. and space are.
  112.  
  113.  
  114. As POCSAG is transmitted as direct FSK of the VHF/UHF carrier the ideal
  115. way is to take the data direct from the discriminator, via a data slicer.
  116. The following circuit, however, has been fairly successful, taking audio
  117. directly from the receiver's speaker output:-
  118.  
  119.  
  120.   0.1 uF                    |\ +12v
  121. ---||-----------------------|- \|
  122. AF IN    |                  |741 \
  123. ----     |                  |    /--------------------- Data Out
  124.     |    \            ------|+ /|  |                    CTS (pin 5/8)
  125.     |    / 100K       |     |/-12v |
  126.     |    \            |            |         GND ------ GND (pin 7/5)
  127.    GND   /            ----/\/\/\---- 
  128.          |            |    100K
  129.          |            \                  N.B. Pin Numbers for com port are
  130.         GND           /                  given as x/y, where x is for a 25
  131.                       \  10K             way, y for a 9 way.
  132.                       /
  133.                       |
  134.                      GND      
  135.  
  136. The +/- 12v for the op-amp can be derived from unused signals on the COM
  137. port (gives more like +/- 10v but works fine !):-
  138.  
  139.  
  140.     TxD (2/3) --------------|<-------------------------------------- -12v
  141.                                      |                  |
  142.     RTS (4/7) --------------|<--------       GND        - -
  143.                    |                          |         _ +  1uF
  144.                     --------->|-------        - -       |
  145.                     Diodes 1N4148    |        - + 1uF  GND
  146.                                      |        |
  147.     DTR (20/4) ------------->|-------------------------------------- +12v
  148.  
  149.  
  150.  
  151.  
  152. 5.    Configuration
  153.  
  154. 5.1    PD.INI
  155.  
  156. The PD.INI file allows a limited amount of configuration of the PD program.
  157. Any text editor can be used to edit this file. The file is divided up into
  158. sections, headed by a name in square brackets, eg [general], [functions].
  159. In each section are parameters, set to a value with an "=" sign, eg:-
  160.  
  161. logbeep=100
  162. func1=alpha
  163.  
  164.  
  165.  
  166. 5.1.1    General Parameters
  167.  
  168. These parameters come under the [general] heading. This version only supports
  169. one parameter in this section
  170.  
  171. 5.1.1.1    logbeep
  172.  
  173. This parameter allows the length of the "beep", sounded when a pager message
  174. is logged, to be set. It's format is:-
  175.  
  176. logbeep=<number>
  177.  
  178. eg:-
  179.  
  180. logbeep=100
  181.  
  182. Where <number> is the length of the beep in milliseconds. A value of zero
  183. turns off the beeping, this is the default.
  184.  
  185.  
  186. 5.1.2    Function Codes
  187.  
  188. These parameters come under the [functions] heading. Four parameters are
  189. supported - func0, func1, func2 and func3. These allow the decoding of
  190. the pager data to be determined by the function code, transmitted in the
  191. address codeword. The format for setting these parameters is:-
  192.  
  193. funcx=<string>
  194.  
  195. Where <string> is one of:- 
  196.  
  197. alpha        -    The message will be decoded as alphanumeric ASCII 
  198.             data.
  199.  
  200. numeric        -    The message will be decoded as BCD numeric data.
  201.  
  202. raw        -    The message will be dumped in raw form, as hex
  203.             codewords
  204.  
  205. eg:-
  206.  
  207. func0=raw
  208. func1=numeric
  209. func2=numeric
  210. func3=alpha
  211.  
  212. The program defaults to decoding all function codes as "alpha" data.
  213.  
  214.  
  215. 5.2    PAGERS.INI
  216.  
  217. This file contains a list of pager addresses to be logged and is simply
  218. a list of 7 digit RIC's, eg:-
  219.  
  220. 1234567
  221. 0012345
  222. etc
  223.  
  224. This file may contain up to 100 addresses. Every time one of these
  225. addresses is encountered it is highlighted on the screen, a beep is
  226. sounded if configured, and the page is logged to disk with a date/time
  227. stamp. The log filename is <RIC>.TXT, eg 1234567.TXT.
  228.  
  229.  
  230. 5.3    REJECT.INI
  231.  
  232. This file contains a list of pager addresses to be rejected, eg to save
  233. screen clutter. This file has the same format as described in 5.3 above.
  234.  
  235.  
  236.  
  237. 6.    Running the Program
  238.  
  239.  
  240. 6.1    Command Line Options
  241.  
  242. PD is run from the DOS prompt with the following format:-
  243.  
  244. PD <-Px> <-B512>
  245.  
  246. Where the command line options are:-
  247.  
  248. -Px    Use COM port x. Default is COM1.
  249.  
  250. -B512    Forces 512 bits/second POCSAG decoding, default is 1200 bps.
  251.  
  252.  
  253. 6.2    Supported Keys
  254.  
  255. The following keys are supported whilst PD is running:-
  256.  
  257. ESC        Exits the program
  258.  
  259. F1        Toggles between NORMAL and DEBUG modes
  260.  
  261. SPACE BAR    Toggles PAUSE mode on and off
  262.  
  263.  
  264. 6.3    Status Line
  265.  
  266. After PD starts up it displays a status line across the top of the screen,
  267. with a data area below. The status line is as shown below:-
  268.  
  269.  
  270. NORMAL COM1 1200           * PD Version 1.02 *           PAUSE REJ / 09:30:57
  271.  
  272.  
  273. The items on the status line are described below, from left to right:-
  274.  
  275. *  NORMAL/DEBUG indicator - shows which mode PD is currently operating in.
  276.  
  277. *  COM port currently in use.
  278.  
  279. *  Current POCSAG bit rate.
  280.  
  281. *  Version of PD being used.
  282.  
  283. *  PAUSE indicator - appears when paused by the space bar.    
  284.  
  285. *  REJ indicator - appears when a pager address matches one listed in
  286.    REJECT.INI
  287.  
  288. *  Rotating signal indicator. Appears to rotate when data is being
  289.    received on the correct pin of the COM port. This is no indication of
  290.    good data, just that the levels are correct.
  291.  
  292. *  The current time from the PC's real time clock.
  293.  
  294.  
  295. 6.4    Normal Mode
  296.  
  297. In NORMAL mode, as long as good POCSAG data is being received, lines of
  298. the following form are displayed:-
  299.  
  300. [RIC] [Function Code] <data>
  301.  
  302. eg:-
  303.  
  304. 1234567 3 Please call 1234 - 5688
  305. 0345678 1 Test call
  306.  
  307. [RIC] is the 7-digit RIC pager address
  308. [Function Code] is the transmitted function code 0,1,2 or 3
  309. <data> is numeric,alphanumeric or hex depending on the function code.
  310.  
  311. The data field may overflow onto multiple lines.
  312.  
  313. Before data is displayed in NORMAL mode the address codeword is checked
  314. for errors and must be error-free. Subsequent data codewords are not
  315. checked for errors. Some "garbling" of data may therefore occur if a
  316. good signal is not being received, although received RIC codes are
  317. guaranteed to be good.
  318.  
  319.  
  320. 6.5    Debug Mode.
  321.  
  322. In Debug mode the raw POCSAG codewords are dumped to the screen in hex
  323. form, eg:-
  324.  
  325. 7A89C197 7A89CI97 7A89C197 7A89C197 7A89C197 7A89C197 7A89C197 7A89C197
  326. 7A89C197 7A89C197 14083EE2 7A89C197 7A89C197 7A89C197 7A89C197 7A89C197
  327.  
  328. Any codewords which do not pass the BCH and parity error checking are
  329. highlighted. This is very useful for checking the quality of the
  330. received signal.
  331.  
  332.  
  333.                            <<<<=====>>>>>
  334.  
  335.