1 /*******************************************************************************
3 * (c) 1999 by Computone Corporation
5 ********************************************************************************
8 * PACKAGE: Linux tty Device Driver for IntelliPort II family of multiport
9 * serial I/O controllers.
11 * DESCRIPTION: Definitions and support for In-line and Bypass commands.
12 * Applicable only when the standard loadware is active.
14 *******************************************************************************/
15 //------------------------------------------------------------------------------
18 // 10 October 1991 MAG First Draft
19 // 7 November 1991 MAG Reflects some new commands
20 // 20 February 1992 MAG CMD_HOTACK corrected: no argument.
21 // 24 February 1992 MAG Support added for new commands for 1.4.x loadware.
22 // 11 March 1992 MAG Additional commands.
23 // 16 March 1992 MAG Additional commands.
24 // 30 March 1992 MAG Additional command: CMD_DSS_NOW
25 // 18 May 1992 MAG Changed CMD_OPOST
27 //------------------------------------------------------------------------------
28 #ifndef I2CMD_H // To prevent multiple includes
33 // This module is designed to provide a uniform method of sending commands to
34 // the board through command packets. The difficulty is, some commands take
35 // parameters, others do not. Furthermore, it is often useful to send several
36 // commands to the same channel as part of the same packet. (See also i2pack.h.)
38 // This module is designed so that the caller should not be responsible for
39 // remembering the exact syntax of each command, or at least so that the
40 // compiler could check things somewhat. I'll explain as we go...
42 // First, a structure which can embody the syntax of each type of command.
44 typedef struct _cmdSyntax
46 UCHAR length; // Number of bytes in the command
47 UCHAR flags; // Information about the command (see below)
49 // The command and its parameters, which may be of arbitrary length. Don't
50 // worry yet how the parameters will be initialized; macros later take care
51 // of it. Also, don't worry about the arbitrary length issue; this structure
52 // is never used to allocate space (see i2cmd.c).
54 } cmdSyntax, *cmdSyntaxPtr;
56 // Bit assignments for flags
58 #define INL 1 // Set if suitable for inline commands
59 #define BYP 2 // Set if suitable for bypass commands
60 #define BTH (INL|BYP) // suitable for either!
61 #define END 4 // Set if this must be the last command in a block
62 #define VIP 8 // Set if this command is special in some way and really
63 // should only be sent from the library-level and not
64 // directly from user-level
65 #define VAR 0x10 // This command is of variable length!
67 // Declarations for the global arrays used to bear the commands and their
70 // Note: Since these are globals and the arguments might change, it is important
71 // that the library routine COPY these into buffers from whence they would be
72 // sent, rather than merely storing the pointers. In multi-threaded
73 // environments, important that the copy should obtain before any context switch
74 // is allowed. Also, for parameterized commands, DO NOT ISSUE THE SAME COMMAND
75 // MORE THAN ONCE WITH THE SAME PARAMETERS in the same call.
112 static UCHAR ct36a[];
163 // Now, refer to i2cmd.c, and see the character arrays defined there. They are
164 // cast here to cmdSyntaxPtr.
166 // There are library functions for issuing bypass or inline commands. These
167 // functions take one or more arguments of the type cmdSyntaxPtr. The routine
168 // then can figure out how long each command is supposed to be and easily add it
171 // For ease of use, we define manifests which return pointers to appropriate
172 // cmdSyntaxPtr things. But some commands also take arguments. If a single
173 // argument is used, we define a macro which performs the single assignment and
174 // (through the expedient of a comma expression) references the appropriate
175 // pointer. For commands requiring several arguments, we actually define a
176 // function to perform the assignments.
178 #define CMD_DTRUP (cmdSyntaxPtr)(ct02) // Raise DTR
179 #define CMD_DTRDN (cmdSyntaxPtr)(ct03) // Lower DTR
180 #define CMD_RTSUP (cmdSyntaxPtr)(ct04) // Raise RTS
181 #define CMD_RTSDN (cmdSyntaxPtr)(ct05) // Lower RTS
182 #define CMD_STARTFL (cmdSyntaxPtr)(ct06) // Start Flushing Data
184 #define CMD_DTRRTS_UP (cmdSyntaxPtr)(cc01) // Raise DTR and RTS
185 #define CMD_DTRRTS_DN (cmdSyntaxPtr)(cc02) // Lower DTR and RTS
187 // Set Baud Rate for transmit and receive
188 #define CMD_SETBAUD(arg) \
189 (((cmdSyntaxPtr)(ct07))->cmd[1] = (arg),(cmdSyntaxPtr)(ct07))
213 #define CBR_115200 23
214 #define CBR_C1 24 // Custom baud rate 1
215 #define CBR_C2 25 // Custom baud rate 2
216 #define CBR_153600 26
217 #define CBR_230400 27
218 #define CBR_307200 28
219 #define CBR_460800 29
220 #define CBR_921600 30
222 // Set Character size
224 #define CMD_SETBITS(arg) \
225 (((cmdSyntaxPtr)(ct08))->cmd[1] = (arg),(cmdSyntaxPtr)(ct08))
232 // Set number of stop bits
234 #define CMD_SETSTOP(arg) \
235 (((cmdSyntaxPtr)(ct09))->cmd[1] = (arg),(cmdSyntaxPtr)(ct09))
238 #define CST_15 1 // 1.5 stop bits
243 #define CMD_SETPAR(arg) \
244 (((cmdSyntaxPtr)(ct10))->cmd[1] = (arg),(cmdSyntaxPtr)(ct10))
246 #define CSP_NP 0 // no parity
247 #define CSP_OD 1 // odd parity
248 #define CSP_EV 2 // Even parity
249 #define CSP_SP 3 // Space parity
250 #define CSP_MK 4 // Mark parity
252 // Define xon char for transmitter flow control
254 #define CMD_DEF_IXON(arg) \
255 (((cmdSyntaxPtr)(ct11))->cmd[1] = (arg),(cmdSyntaxPtr)(ct11))
257 // Define xoff char for transmitter flow control
259 #define CMD_DEF_IXOFF(arg) \
260 (((cmdSyntaxPtr)(ct12))->cmd[1] = (arg),(cmdSyntaxPtr)(ct12))
262 #define CMD_STOPFL (cmdSyntaxPtr)(ct13) // Stop Flushing data
264 // Acknowledge receipt of hotkey signal
266 #define CMD_HOTACK (cmdSyntaxPtr)(ct14)
268 // Define irq level to use. Should actually be sent by library-level code, not
269 // directly from user...
271 #define CMDVALUE_IRQ 15 // For library use at initialization. Until this command
272 // is sent, board processing doesn't really start.
273 #define CMD_SET_IRQ(arg) \
274 (((cmdSyntaxPtr)(ct15))->cmd[1] = (arg),(cmdSyntaxPtr)(ct15))
276 #define CIR_POLL 0 // No IRQ - Poll
277 #define CIR_3 3 // IRQ 3
278 #define CIR_4 4 // IRQ 4
279 #define CIR_5 5 // IRQ 5
280 #define CIR_7 7 // IRQ 7
281 #define CIR_10 10 // IRQ 10
282 #define CIR_11 11 // IRQ 11
283 #define CIR_12 12 // IRQ 12
284 #define CIR_15 15 // IRQ 15
286 // Select transmit flow xon/xoff options
288 #define CMD_IXON_OPT(arg) \
289 (((cmdSyntaxPtr)(ct16))->cmd[1] = (arg),(cmdSyntaxPtr)(ct16))
291 #define CIX_NONE 0 // Incoming Xon/Xoff characters not special
292 #define CIX_XON 1 // Xoff disable, Xon enable
293 #define CIX_XANY 2 // Xoff disable, any key enable
295 // Select receive flow xon/xoff options
297 #define CMD_OXON_OPT(arg) \
298 (((cmdSyntaxPtr)(ct17))->cmd[1] = (arg),(cmdSyntaxPtr)(ct17))
300 #define COX_NONE 0 // Don't send Xon/Xoff
301 #define COX_XON 1 // Send xon/xoff to start/stop incoming data
304 #define CMD_CTS_REP (cmdSyntaxPtr)(ct18) // Enable CTS reporting
305 #define CMD_CTS_NREP (cmdSyntaxPtr)(ct19) // Disable CTS reporting
307 #define CMD_DCD_REP (cmdSyntaxPtr)(ct20) // Enable DCD reporting
308 #define CMD_DCD_NREP (cmdSyntaxPtr)(ct21) // Disable DCD reporting
310 #define CMD_DSR_REP (cmdSyntaxPtr)(ct22) // Enable DSR reporting
311 #define CMD_DSR_NREP (cmdSyntaxPtr)(ct23) // Disable DSR reporting
313 #define CMD_RI_REP (cmdSyntaxPtr)(ct24) // Enable RI reporting
314 #define CMD_RI_NREP (cmdSyntaxPtr)(ct25) // Disable RI reporting
316 // Enable break reporting and select style
318 #define CMD_BRK_REP(arg) \
319 (((cmdSyntaxPtr)(ct26))->cmd[1] = (arg),(cmdSyntaxPtr)(ct26))
321 #define CBK_STAT 0x00 // Report breaks as a status (exception,irq)
322 #define CBK_NULL 0x01 // Report breaks as a good null
323 #define CBK_STAT_SEQ 0x02 // Report breaks as a status AND as in-band character
324 // sequence FFh, 01h, 10h
325 #define CBK_SEQ 0x03 // Report breaks as the in-band
326 //sequence FFh, 01h, 10h ONLY.
327 #define CBK_FLSH 0x04 // if this bit set also flush input data
328 #define CBK_POSIX 0x08 // if this bit set report as FF,0,0 sequence
329 #define CBK_SINGLE 0x10 // if this bit set with CBK_SEQ or CBK_STAT_SEQ
330 //then reports single null instead of triple
332 #define CMD_BRK_NREP (cmdSyntaxPtr)(ct27) // Disable break reporting
334 // Specify maximum block size for received data
336 #define CMD_MAX_BLOCK(arg) \
337 (((cmdSyntaxPtr)(ct28))->cmd[1] = (arg),(cmdSyntaxPtr)(ct28))
339 // -- COMMAND 29 is reserved --
341 #define CMD_CTSFL_ENAB (cmdSyntaxPtr)(ct30) // Enable CTS flow control
342 #define CMD_CTSFL_DSAB (cmdSyntaxPtr)(ct31) // Disable CTS flow control
343 #define CMD_RTSFL_ENAB (cmdSyntaxPtr)(ct32) // Enable RTS flow control
344 #define CMD_RTSFL_DSAB (cmdSyntaxPtr)(ct33) // Disable RTS flow control
346 // Specify istrip option
348 #define CMD_ISTRIP_OPT(arg) \
349 (((cmdSyntaxPtr)(ct34))->cmd[1] = (arg),(cmdSyntaxPtr)(ct34))
351 #define CIS_NOSTRIP 0 // Strip characters to character size
352 #define CIS_STRIP 1 // Strip any 8-bit characters to 7 bits
354 // Send a break of arg milliseconds
356 #define CMD_SEND_BRK(arg) \
357 (((cmdSyntaxPtr)(ct35))->cmd[1] = (arg),(cmdSyntaxPtr)(ct35))
359 // Set error reporting mode
361 #define CMD_SET_ERROR(arg) \
362 (((cmdSyntaxPtr)(ct36))->cmd[1] = (arg),(cmdSyntaxPtr)(ct36))
364 #define CSE_ESTAT 0 // Report error in a status packet
365 #define CSE_NOREP 1 // Treat character as though it were good
366 #define CSE_DROP 2 // Discard the character
367 #define CSE_NULL 3 // Replace with a null
368 #define CSE_MARK 4 // Replace with a 3-character sequence (as Unix)
370 #define CMD_SET_REPLACEMENT(arg,ch) \
371 (((cmdSyntaxPtr)(ct36a))->cmd[1] = (arg), \
372 (((cmdSyntaxPtr)(ct36a))->cmd[2] = (ch), \
373 (cmdSyntaxPtr)(ct36a))
375 #define CSE_REPLACE 0x8 // Replace the errored character with the
376 // replacement character defined here
378 #define CSE_STAT_REPLACE 0x18 // Replace the errored character with the
379 // replacement character defined here AND
380 // report the error as a status packet (as in
384 // COMMAND 37, to send flow control packets, is handled only by low-level
385 // library code in response to data movement and shouldn't ever be sent by the
386 // user code. See i2pack.h and the body of i2lib.c for details.
388 // Enable on-board post-processing, using options given in oflag argument.
389 // Formerly, this command was automatically preceded by a CMD_OPOST_OFF command
390 // because the loadware does not permit sending back-to-back CMD_OPOST_ON
391 // commands without an intervening CMD_OPOST_OFF. BUT, WE LEARN 18 MAY 92, that
392 // CMD_OPOST_ON and CMD_OPOST_OFF must each be at the end of a packet (or in a
393 // solo packet). This means the caller must specify separately CMD_OPOST_OFF,
394 // CMD_OPOST_ON(parm) when he calls i2QueueCommands(). That function will ensure
395 // each gets a separate packet. Extra CMD_OPOST_OFF's are always ok.
397 #define CMD_OPOST_ON(oflag) \
398 (*(USHORT *)(((cmdSyntaxPtr)(ct39))->cmd[1]) = (oflag), \
399 (cmdSyntaxPtr)(ct39))
401 #define CMD_OPOST_OFF (cmdSyntaxPtr)(ct40) // Disable on-board post-proc
403 #define CMD_RESUME (cmdSyntaxPtr)(ct41) // Resume: behave as though an XON
406 // Set Transmit baud rate (see command 7 for arguments)
408 #define CMD_SETBAUD_TX(arg) \
409 (((cmdSyntaxPtr)(ct42))->cmd[1] = (arg),(cmdSyntaxPtr)(ct42))
411 // Set Receive baud rate (see command 7 for arguments)
413 #define CMD_SETBAUD_RX(arg) \
414 (((cmdSyntaxPtr)(ct43))->cmd[1] = (arg),(cmdSyntaxPtr)(ct43))
416 // Request interrupt from board each arg milliseconds. Interrupt will specify
417 // "received data", even though there may be no data present. If arg == 0,
418 // disables any such interrupts.
420 #define CMD_PING_REQ(arg) \
421 (((cmdSyntaxPtr)(ct44))->cmd[1] = (arg),(cmdSyntaxPtr)(ct44))
423 #define CMD_HOT_ENAB (cmdSyntaxPtr)(ct45) // Enable Hot-key checking
424 #define CMD_HOT_DSAB (cmdSyntaxPtr)(ct46) // Disable Hot-key checking
427 // COMMAND 47: Send Protocol info via Unix flags:
428 // iflag = Unix tty t_iflag
429 // cflag = Unix tty t_cflag
430 // lflag = Unix tty t_lflag
431 // See System V Unix/Xenix documentation for the meanings of the bit fields
432 // within these flags
434 #define CMD_UNIX_FLAGS(iflag,cflag,lflag) i2cmdUnixFlags(iflag,cflag,lflag)
437 #define CMD_DSRFL_ENAB (cmdSyntaxPtr)(ct48) // Enable DSR receiver ctrl
438 #define CMD_DSRFL_DSAB (cmdSyntaxPtr)(ct49) // Disable DSR receiver ctrl
439 #define CMD_DTRFL_ENAB (cmdSyntaxPtr)(ct50) // Enable DTR flow control
440 #define CMD_DTRFL_DSAB (cmdSyntaxPtr)(ct51) // Disable DTR flow control
441 #define CMD_BAUD_RESET (cmdSyntaxPtr)(ct52) // Reset baudrate table
443 // COMMAND 54: Define custom rate #1
444 // rate = (short) 1/10 of the desired baud rate
446 #define CMD_BAUD_DEF1(rate) i2cmdBaudDef(1,rate)
448 // COMMAND 55: Define custom rate #2
449 // rate = (short) 1/10 of the desired baud rate
451 #define CMD_BAUD_DEF2(rate) i2cmdBaudDef(2,rate)
453 // Pause arg hundredths of seconds. (Note, this is NOT milliseconds.)
455 #define CMD_PAUSE(arg) \
456 (((cmdSyntaxPtr)(ct56))->cmd[1] = (arg),(cmdSyntaxPtr)(ct56))
458 #define CMD_SUSPEND (cmdSyntaxPtr)(ct57) // Suspend output
459 #define CMD_UNSUSPEND (cmdSyntaxPtr)(ct58) // Un-Suspend output
461 // Set parity-checking options
463 #define CMD_PARCHK(arg) \
464 (((cmdSyntaxPtr)(ct59))->cmd[1] = (arg),(cmdSyntaxPtr)(ct59))
466 #define CPK_ENAB 0 // Enable parity checking on input
467 #define CPK_DSAB 1 // Disable parity checking on input
469 #define CMD_BMARK_REQ (cmdSyntaxPtr)(ct60) // Bookmark request
472 // Enable/Disable internal loopback mode
474 #define CMD_INLOOP(arg) \
475 (((cmdSyntaxPtr)(ct61))->cmd[1] = (arg),(cmdSyntaxPtr)(ct61))
477 #define CIN_DISABLE 0 // Normal operation (default)
478 #define CIN_ENABLE 1 // Internal (local) loopback
479 #define CIN_REMOTE 2 // Remote loopback
481 // Specify timeout for hotkeys: Delay will be (arg x 10) milliseconds, arg == 0
482 // --> no timeout: wait forever.
484 #define CMD_HOT_TIME(arg) \
485 (((cmdSyntaxPtr)(ct62))->cmd[1] = (arg),(cmdSyntaxPtr)(ct62))
488 // Define (outgoing) xon for receive flow control
490 #define CMD_DEF_OXON(arg) \
491 (((cmdSyntaxPtr)(ct63))->cmd[1] = (arg),(cmdSyntaxPtr)(ct63))
493 // Define (outgoing) xoff for receiver flow control
495 #define CMD_DEF_OXOFF(arg) \
496 (((cmdSyntaxPtr)(ct64))->cmd[1] = (arg),(cmdSyntaxPtr)(ct64))
498 // Enable/Disable RTS on transmit (1/2 duplex-style)
500 #define CMD_RTS_XMIT(arg) \
501 (((cmdSyntaxPtr)(ct65))->cmd[1] = (arg),(cmdSyntaxPtr)(ct65))
503 #define CHD_DISABLE 0
506 // Set high-water-mark level (debugging use only)
508 #define CMD_SETHIGHWAT(arg) \
509 (((cmdSyntaxPtr)(ct66))->cmd[1] = (arg),(cmdSyntaxPtr)(ct66))
511 // Start flushing tagged data (tag = 0-14)
513 #define CMD_START_SELFL(tag) \
514 (((cmdSyntaxPtr)(ct67))->cmd[1] = (tag),(cmdSyntaxPtr)(ct67))
516 // End flushing tagged data (tag = 0-14)
518 #define CMD_END_SELFL(tag) \
519 (((cmdSyntaxPtr)(ct68))->cmd[1] = (tag),(cmdSyntaxPtr)(ct68))
521 #define CMD_HWFLOW_OFF (cmdSyntaxPtr)(ct69) // Disable HW TX flow control
522 #define CMD_ODSRFL_ENAB (cmdSyntaxPtr)(ct70) // Enable DSR output f/c
523 #define CMD_ODSRFL_DSAB (cmdSyntaxPtr)(ct71) // Disable DSR output f/c
524 #define CMD_ODCDFL_ENAB (cmdSyntaxPtr)(ct72) // Enable DCD output f/c
525 #define CMD_ODCDFL_DSAB (cmdSyntaxPtr)(ct73) // Disable DCD output f/c
527 // Set transmit interrupt load level. Count should be an even value 2-12
529 #define CMD_LOADLEVEL(count) \
530 (((cmdSyntaxPtr)(ct74))->cmd[1] = (count),(cmdSyntaxPtr)(ct74))
532 // If reporting DSS changes, map to character sequence FFh, 2, MSR
534 #define CMD_STATDATA(arg) \
535 (((cmdSyntaxPtr)(ct75))->cmd[1] = (arg),(cmdSyntaxPtr)(ct75))
537 #define CSTD_DISABLE// Report DSS changes as status packets only (default)
538 #define CSTD_ENABLE // Report DSS changes as in-band data sequence as well as
541 #define CMD_BREAK_ON (cmdSyntaxPtr)(ct76)// Set break and stop xmit
542 #define CMD_BREAK_OFF (cmdSyntaxPtr)(ct77)// End break and restart xmit
543 #define CMD_GETFC (cmdSyntaxPtr)(ct78)// Request for flow control packet
546 // Transmit this character immediately
548 #define CMD_XMIT_NOW(ch) \
549 (((cmdSyntaxPtr)(ct79))->cmd[1] = (ch),(cmdSyntaxPtr)(ct79))
551 // Set baud rate via "divisor latch"
553 #define CMD_DIVISOR_LATCH(which,value) \
554 (((cmdSyntaxPtr)(ct80))->cmd[1] = (which), \
555 *(USHORT *)(((cmdSyntaxPtr)(ct80))->cmd[2]) = (value), \
556 (cmdSyntaxPtr)(ct80))
558 #define CDL_RX 1 // Set receiver rate
559 #define CDL_TX 2 // Set transmit rate
560 // (CDL_TX | CDL_RX) Set both rates
562 // Request for special diagnostic status pkt from the board.
564 #define CMD_GET_STATUS (cmdSyntaxPtr)(ct81)
566 // Request time-stamped transmit character count packet.
568 #define CMD_GET_TXCNT (cmdSyntaxPtr)(ct82)
570 // Request time-stamped receive character count packet.
572 #define CMD_GET_RXCNT (cmdSyntaxPtr)(ct83)
574 // Request for box/board I.D. packet.
575 #define CMD_GET_BOXIDS (cmdSyntaxPtr)(ct84)
577 // Enable or disable multiple channels according to bit-mapped ushorts box 1-4
579 #define CMD_ENAB_MULT(enable, box1, box2, box3, box4) \
580 (((cmdSytaxPtr)(ct85))->cmd[1] = (enable), \
581 *(USHORT *)(((cmdSyntaxPtr)(ct85))->cmd[2]) = (box1), \
582 *(USHORT *)(((cmdSyntaxPtr)(ct85))->cmd[4]) = (box2), \
583 *(USHORT *)(((cmdSyntaxPtr)(ct85))->cmd[6]) = (box3), \
584 *(USHORT *)(((cmdSyntaxPtr)(ct85))->cmd[8]) = (box4), \
585 (cmdSyntaxPtr)(ct85))
587 #define CEM_DISABLE 0
590 // Enable or disable receiver or receiver interrupts (default both enabled)
592 #define CMD_RCV_ENABLE(ch) \
593 (((cmdSyntaxPtr)(ct86))->cmd[1] = (ch),(cmdSyntaxPtr)(ct86))
595 #define CRE_OFF 0 // Disable the receiver
596 #define CRE_ON 1 // Enable the receiver
597 #define CRE_INTOFF 2 // Disable receiver interrupts (to loadware)
598 #define CRE_INTON 3 // Enable receiver interrupts (to loadware)
600 // Starts up a hardware test process, which runs transparently, and sends a
601 // STAT_HWFAIL packet in case a hardware failure is detected.
603 #define CMD_HW_TEST (cmdSyntaxPtr)(ct87)
605 // Change receiver threshold and timeout value:
606 // Defaults: timeout = 20mS
607 // threshold count = 8 when DTRflow not in use,
608 // threshold count = 5 when DTRflow in use.
610 #define CMD_RCV_THRESHOLD(count,ms) \
611 (((cmdSyntaxPtr)(ct88))->cmd[1] = (count), \
612 ((cmdSyntaxPtr)(ct88))->cmd[2] = (ms), \
613 (cmdSyntaxPtr)(ct88))
615 // Makes the loadware report DSS signals for this channel immediately.
617 #define CMD_DSS_NOW (cmdSyntaxPtr)(ct89)
619 // Set the receive silo parameters
620 // timeout is ms idle wait until delivery (~VTIME)
621 // threshold is max characters cause interrupt (~VMIN)
623 #define CMD_SET_SILO(timeout,threshold) \
624 (((cmdSyntaxPtr)(ct90))->cmd[1] = (timeout), \
625 ((cmdSyntaxPtr)(ct90))->cmd[2] = (threshold), \
626 (cmdSyntaxPtr)(ct90))
628 // Set timed break in decisecond (1/10s)
630 #define CMD_LBREAK(ds) \
631 (((cmdSyntaxPtr)(ct91))->cmd[1] = (ds),(cmdSyntaxPtr)(ct66))