1WCT(1)                User Contributed Perl Documentation               WCT(1)
2
3
4

NAME

6       wct - Whozz Calling Ethernet Link Device interactive tool
7

SYNOPSIS

9        wct [--debug             | -D]
10            [--help              | -h]
11            [--logfile-append    | -l <filename>]
12            [--logfile-overwrite | -L <filename>]
13            [--configfile        | -C <filename>]
14            [--man               | -m]
15            [--set-wc]
16            [--pidfile           | -p <filename>]
17            [--discover          | --discovery | -d
18            [--discover-loop     | --discovery-loop <secs>]
19            [--verbose           | -v <1-9>]
20            [--version           | -V]
21            [--wchost            | -w <address1>[,address2][,...]
22

DESCRIPTION

24       This script allows you to interact with a Whozz Calling device in order
25       to view or change its configuration. This script is generic as
26       configuration settings vary depending on the Whozz Calling model and
27       firmware version.
28
29       Enter the commands one per line, or simply hit <ENTER> alone to see if
30       there are pending responses.
31
32       DO NOT type the '^^Id' prefix as it will be included automatically.
33

OPTIONS

35       -w <address1[,address2][,...]>, --wchost <address1[,address2],[,...]>
36         Specifies the Whozz Calling Ethernet Link Device or devices.
37         Multiple addresses for devices are comma separated.
38
39         Input must be <address> or <address1,address2,etc>.
40
41         Default: 192.168.0.90
42
43         This option is ignored if --discover or --discover-loop is in effect.
44
45       -D, --debug
46         Debug mode, displays all messages that go into the log file.
47
48       -h, --help
49         Prints the help message and exits.
50
51       -m, --man
52         Prints the manual page and exits.
53
54       -C, --configfile <filename>
55         Specifies the configuration file to use.  The program will still run
56         if a configuration file is not found.
57
58         If --discover or --discover-loop is in effect, the configuration file
59         will still be processed but any "wcaddr" addresses will be ignored.
60
61         Default: /etc/ncid/wc2ncid.conf
62
63       --set-wc
64         Sets the IP address, beginning line number, number of telephone lines
65         and sending port for each Whozz Calling Ethernet Link Device.
66
67         It sets the IP address for the WC device from the address for
68         "wcaddr" in the configuration file or --wchost on the command line.
69
70         It automatically sets the beginning line number for the WC device
71         which is used as a line label prefixed with "WC".  Each device gets a
72         beginning line number that is the ending line number plus one from
73         the preceeding device, for example; device 1 (WC01 WC02) device 2
74         (WC03 WC04 WC05 WC06).
75
76         NOTE: All devices are automatically configured to send call
77         information on port 3520.
78
79         This option is ignored if --discover or --discover-loop is in effect.
80
81       -l, --logfile-append <filename>
82       -L, --logfile-overwrite <filename>
83         Specifies the logfile name to write.  The program will still run if
84         it does not have permission to write to it.
85
86         If both options are present, --logfile-append takes precedence.
87
88         Default: Append to wct.log in your current directory.
89
90       -p, --pidfile <filename>
91         Specifies the pidfile name to write. The program will still run if it
92         does not have permission to write a pidfile. The pid filename that
93         should be used is /var/run/wc2ncid.pid.
94
95         Default: no pidfile
96
97       -d, --discover, --discovery =item --discover-loop <secs>,
98       --discovery-loop <secs>
99         Force discovery of all powered-on Whozz Calling Ethernet Link
100         Devices.  IP addresses in the configuration file, or on the command
101         line, will be ignored.
102
103         Using --discover-loop causes continuous looping with a new discovery
104         ("^^IdX") being sent every <secs> seconds.
105
106         Normal invocation of this script functions the same as wc2ncid,
107         including the initialization of each device's configuration
108         "toggles." Use the --discover or --discover-loop options if you want
109         to bypass this initialization.
110
111       -v, --verbose <1-9>
112         Output information, used for the logfile and the debug option.  Set
113         the level to a higher number for more information.  Levels range from
114         1 to 9, but not all levels are used.
115
116         Default: verbose = 1
117
118       -V, --version
119         Displays the version.
120

EXAMPLES

122       Start wct and look for all powered-on devices:
123         wct -d
124
125       Start wct, set IP address to 192.168.1.90 from command line, set the
126       beginning line number automatically and set the sending Ethernet port
127       to 3520 (the default):
128         wct --set-wc --wchost 192.168.1.90
129

INTERACTIVE COMMAND MODE

131       d2h
132         Decimal-to-hex conversion.
133
134         User will be asked for the decimal number to be converted to hex.
135
136         An IP address may also be typed (e.g., 192.168.1.90) to show the
137         proper hex digits for the 'D' and 'I' commands.
138
139       help
140         Displays this interactive command mode help. Press letter 'q' to
141         return to the command prompt at any time.
142
143       select
144         When multiple Whozz Calling Ethernet Link Devices are being used,
145         allows selecting which one to interact with.
146
147         A special "ALL DEVICES" choice is also available, meaning all typed
148         commands will be broadcast to all devices. For example, selecting
149         "ALL DEVICES" and then typing the Z command will cause all powered on
150         devices to be reset to their factory defaults. Use "ALL DEVICES" with
151         care because you could set all devices to have the same IP address,
152         same MAC address, etc.
153
154       1-9
155         Entering a single digit changes the verbosity level on-the-fly.
156
157       Not all of the commands below are supported by all WC devices.
158
159   Single character commands
160       N       Set destination IP and MAC addresses to THIS computer.
161
162       X       Show unit#, serial#, network settings. This command can be used
163               to discover all powered-on WC devices. It is the same as
164               runnning wct with the --discover command line option.
165
166       Z       Reset unit# to '123' and network settings to factory defaults;
167               does NOT change: toggles, block/pass numbers in memory,
168               date/time or the device's starting line#. See also "Other ways
169               to reset a device" on the last page of this manual.
170
171               Settings changed by this command will not be reflected under
172               the 'select' menu until the next time you do an 'X' to discover
173               all available devices.
174
175   Two character commands
176       -@      Causes a device to respond with "#" sign. Can be used for
177               establishing device communication.
178
179       -J      Show contents of block/pass numbers stored in memory. Be sure
180               to first set the verbose level to 4 or greater to see the
181               actual numbers.
182
183       -R      Perform power-on reset and sets all toggles to uppercase.
184               Leaves network configuration and block/pass memory and the
185               device's starting line# unchanged. See also "Other ways to
186               reset a device" on the last page of this manual.
187
188       -t      Where 't' is any single toggle, case sensitive (e.g., -E, -b).
189
190               Uppercase usually means the feature/setting is OFF, lowercase
191               means it is ON.
192
193                E, e   Command echo
194                C, c   Leading '$' and dashes in numbers (wc2ncid and wct
195                       always strip both)
196                X, x   Comprehensive (X) or limited (x) data format
197                U, u   Use phone numbers in internal block/pass memory
198                D, d   Detail information (rings, hook on/off/flash)
199                A, a   Data sent at start AND end of a call
200                S, s   See below
201                O, o   Only inbound (O) calls reported, or inbound and
202                       outbound (o)
203                B, b   Suppress first ring (B) or always pass through (b)
204                K, k   See below
205                T, t   Inbound DTMF monitoring
206
207                The 'U' and 'A' toggles each have a companion toggle as
208                described below.
209
210                If 'U' is set, blocking/passing is turned OFF and toggles
211                'K' and 'k' are ignored.
212
213                If 'u' is set, blocking/passing is turned ON. The toggle 'K'
214                will pass all calls by default (i.e., only the phone numbers
215                in the internal memory will be blocked) and 'k' will block
216                all calls by default (i.e., only the phone numbers in the
217                internal memory will be passed through).
218
219                If 'A' is set, data is sent at the start AND end of a call
220                and toggles 'S' and 's' are ignored.
221
222                If 'a' is set, data is sent only at start(S) or end(s) of a
223                call.
224
225       -V      Show processor version, all toggles, line# of channel 1, date,
226               time.
227
228       -v      Show internal jumper settings.
229
230   Multiple character commands requiring HEX digits.
231       Numbers in parentheses () indicate required number of hex digits.
232
233       Commands I, T and U are typically the only ones that will be used.
234
235       Hex digits A - F may be entered in lowercase or uppercase.
236
237       Chhhhhhhhhhhh
238               Set destination MAC address (12) of the computer to receive WC
239               data (use all 'F's for entire LAN).
240
241       Dhhhhhhhh
242               Set destination IP address (8) of the computer to receive WC
243               data (use all 'F's for entire LAN).
244
245       Ihhhhhhhh
246               Set device IP address (8).
247
248               Changing the IP address will not be reflected under the
249               'select' menu until the next time you do an 'X' to discover all
250               available devices.
251
252       Mhhhhhhhhhhhh
253               Set device MAC address (12).
254
255               Changing the MAC address will not be reflected under the
256               'select' menu until the next time you do an 'X' to discover all
257               available devices.
258
259       Phhhh   Set destination port number (4 hex digits) of the computer to
260               receive WC data. This is normally 0DC0, or 3520 in decimal.
261
262               It is very rare that this command would be used. You most
263               likely would want to use 'Thhhh' instead.
264
265       Thhhh   Set device port number (4 hex digits). This is normally 0DC0,
266               or 3520 in decimal.
267
268               Changing the port number will not be reflected under the
269               'select' menu until the next time you do an 'X' to discover all
270               available devices.
271
272       Uhhhhhhhhhhhh
273               Set unit number (12).
274
275               Changing the unit number will not be reflected under the
276               'select' menu until the next time you do an 'X' to discover all
277               available devices.
278
279               Note that wc2ncid will change and use the unit number to track
280               the number of telephone lines (2, 4, or 8) that can be
281               connected to the device. This is used when establishing the
282               starting line# of channel#1, i.e., the "L=xx" parameter seen
283               when executing the '-V' command.
284
285   Multiple character commands requiring DECIMAL digits.
286       Normally these require a terminating carriage return character, but the
287       wct script takes care of this for you by sending a terminating carriage
288       return after all commands.
289
290       -Nnnnnnnnnnnnn
291               Add a 7 to 12 digit phone number to block/pass memory, maximum
292               of 40 phone numbers.
293
294               The WC device will not check to see if the number you're adding
295               is already stored in memory. It lets you add duplicates.
296
297               If the memory becomes full, additional numbers will be silently
298               ignored.
299
300       -N66    Add Out-of-area callers to block/pass memory. '-J' command will
301               list as the letter 'O' ("oh") and not '66'. This counts against
302               the maximum of 40 phone numbers.
303
304       -N77    Add Private callers to block/pass memory. '-J' command will
305               list as the letter 'P' and not '77'. This counts against the
306               maximum of 40 phone numbers.
307
308       -N00000077nn
309               Special undocumented command to set line# of channel#1 instead
310               of using the 'Line No. Select' button on back of the device.
311               And unlike the 'Line No. Select' button, you're not restricted
312               to increments of four.  'nn' is base 16 but accepts digits only
313               (no letters 'A' to 'F').  For example, '-N0000007710' sets
314               line# to '16' not '10'.
315
316               The echo toggle ('E') must be OFF for this setting to be saved
317               in the device's memory.
318
319               You should wait at least 9 seconds after sending this command
320               before sending the next one. Otherwise, the next command sent
321               may be ignored.
322
323               Unlike the other uses of '-N', this special command does not
324               affect the internal block/pass memory.
325
326       -Wnn    If toggle 'u' is set, block or pass the real-time inbound call
327               on logical line 'nn'. Note that this is NOT the physical
328               channel# that a phone line is hooked into.
329
330       -Zmmddhhmm
331               Manually set date and time (24 hour format). Normally the date
332               and time are set automatically by the first incoming ring.
333
334   Other ways to reset a device
335       The download section at CallerID.com has a Windows program called "EL
336       Config". To use wct to emulate the EL Config reset options, do the
337       following commands:
338
339       Config->Reset Unit Defaults
340
341           -N0000007701
342           -R
343
344           The above sets the line# of channel#1 ('N') to be 1, followed by a
345           power-on reset ('R') that sets all toggles to uppercase. It does
346           not change the network settings nor the block/pass memory.
347
348       Config->Reset Ethernet Defaults
349
350           DFFFFFFFF
351           U000000000001
352           IC0A8005A
353           CFFFFFFFFFFFF
354           T0DC0
355
356           The above will set the destination IP address ('D') to be the
357           entire LAN, the unit number ('U') to 1, the device's IP address
358           ('I') to 192.168.0.90, the destination MAC address ('C') to be the
359           entire LAN and the device's port# ('T') to 3520. It does not change
360           the device toggles, nor the block/pass memory, nor the device's
361           starting line#.
362

REQUIREMENTS

364       perl 5.6 or higher, perl(Config::Simple), perl(Data::HexDump)
365

FILES

367       /etc/ncid/wc2ncid.conf
368

SEE ALSO

370       ncidd.8, wc2ncid.8, wc2ncid.conf.5
371
372
373
374perl v5.36.1                      2023-10-03                            WCT(1)
Impressum