Int 2F Fn CB12  - Communicating Applications Specification - Get Hardware  [F]

   AX = CB12h
   DS:DX -> 128-byte status buffer (see below)

Return: AX = 0000h successful
       buffer filled with hardware-dependent status information
      < 0     error code (see AX=CB01h)

See Also: AX=CB10h,AX=CB11h

Format of status buffer for Intel Connection CoProcessor:
Offset Size    Description
 00h   BYTE    Connection CoProcessor connection status flags (see below)
 01h   BYTE    number of kilobytes of free buffer space
 02h   BYTE    page buffer status
       bit 7: Connection CoProcessor has documents to send
       bits 6-0: number of pages in buffer
 03h   BYTE    number of retries left for dialing number
 04h   BYTE    page number to retransmit
 05h   BYTE    communications status (see below)
 06h   BYTE    baud rate
       bit 7: reserved
       bits 6-4: baud rate
           000 = 300 baud  (V.21 SDLC or HDLC mode)
           100 = 2400 baud (V.27 ter)
           101 = 4800 baud (V.27 ter)
           110 = 7200 baud (V.29)
           111 = 9600 baud (V.29)
       bits 3-0: reserved, should be 0110
 07h  3 BYTEs  reserved
 0Ah   BYTE    Connection CoProcessor hardware status (see below)
 0Bh   BYTE    Connection CoProcessor switch states (see below)
 0Ch   BYTE    communications flags (see below)
 0Dh   BYTE    reserved
 0Eh   WORD    error count (only valid while busy, reset when idle)
 10h   DWORD   size of nonstandard format (NSF) file in bytes
 14h   BYTE    'A' if Connection CoProcessor board present
 15h  9 BYTEs  reserved
 1Eh 21 BYTEs  ASCIZ CCITT identification
 33h 77 BYTEs  reserved

Note:  the Intel Connection CoProcessor and SatisFAXtion may be distinguished
     by examining the byte at offset 14h

Format of status buffer for Intel SatisFAXtion board:
Offset Size    Description
 00h   BYTE    SatisFAXtion connection status flags (see below)
 01h   BYTE    SatisFAXtion board state (see below)
 02h   BYTE    number of KB free in buffer
 03h   BYTE    number of pages or files in buffer
 04h   BYTE    number of redials remaining on current number
 05h   BYTE    FAX page number to retransmit
 06h   BYTE    current page/file in block transfer
 07h   BYTE    number of rings received (only if auto-answer enabled)
 08h   WORD    error count
 0Ah   DWORD   length of file being transferred
 0Eh  6 BYTEs  reserved
 14h   BYTE    'B' if SatisFAXtion board present
 15h 13 BYTEs  ASCIZ transfer agent name
 22h  5 BYTEs  ASCIZ transfer agent version number
 27h 13 BYTEs  ASCIZ resident loader name
 34h  5 BYTEs  ASCIZ resident loader version number
 39h 21 BYTEs  ASCIZ remote CSID
 4Eh 13 BYTEs  ASCIZ resident manager name
 5Bh  5 BYTEs  ASCIZ resident manager version number
 60h 32 BYTEs  reserved

Note:  the Intel Connection CoProcessor and SatisFAXtion may be distinguished
     by examining the byte at offset 14h

Bitfields for Connection CoProcessor connection status flags:
 bit 7 hardware busy sending or receiving
 bit 6 last page of data
 bit 5 no data on current page
 bit 4 retransmit request for current page being transmitted
 bit 3 NSF (nonstandard file) mode active
 bits 2-0 reserved

Bitfields for communications status:
 bit 7 originating call
 bit 6 FAX message to be sent
 bit 5 on line
 bit 4 ring detected and receive enabled
 bit 3 buffer dumped on receive
 bits 2-0  hardware sequence state
       000 idle
       001 dial
       010 answer
       011 transmit
       100 receive
       101 pre-message
       110 post-message
       111 disconnect

Bitfields for Connection CoProcessor hardware status:
 bit 7 modem option installed
 bit 6 Connection CoProcessor has control of DAA (not latched)
 bit 5 on line (not latched)
 bit 4 ring detected (not latched)
 bit 3 data in command buffer (not latched)
 bit 2 set if using DMA channel 1, clear if using DMA channel 3
 bit 1 line length compensation bit 1 set (not latched)
 bit 0 line length compensation bit 0 set (not latched)

Bitfields for Connection CoProcessor switch states:
 bit 7: reserved
 bit 6: unused
 bit 5: spare switch open
 bit 4: FAX ADR1 switch open
 bit 3: FAX ADR0 switch open
 bit 2: alternate interrupt switch open
 bit 1: COM SEL 1 switch open
 bit 0: COM SEL 0 switch open

Note: valid combinations of bits 0-2 are
   000  COM2 IRQ3 IObase 2F8h
   001  COM1 IRQ4 IObase 3F8h
   010  COM4 IRQ3 IObase 2E8h
   011  COM3 IRQ4 IObase 3E8h
   110  COM4 IRQ2 IObase 2E8h
   111  COM3 IRQ5 IObase 3E8h

Bitfields for communications flags:
 bit 7 reserved
 bit 6 auxiliary relay forced ON
 bit 5 modem select relay forced ON
 bit 4 offhook relay forced ON
 bit 3 9600 bps enabled
 bit 2 7200 bps enabled
 bit 1 4800 bps enabled
 bit 0 2400 bps enabled

Bitfields for SatisFAXtion connection status flags:
 bit 7 busy in T.30 CCITT fax protocol
 bit 6 data on current page/file (only used for block xfers)
 bit 5 retransmission of last page requested
 bit 4 in file transfer mode
 bit 3 data in buffer
 bit 2 data buffer dumped on receive
 bit 1 200x100 dpi resolution instead of 200x200 dpi
 bit 0 data modem in use, FAX image modem not available

Bitfields for SatisFAXtion board state:
 bit 7 reserved
 bit 6 handset jack active, data and FAX modems not available
 bits 5-3  current bit rate
       000  300 bps (V.21 HDLC)
       100 2400 bps (V.27 ter)
       101 4800 bps (V.27 ter)
       110 7200 bps (V.29)
       111 9600 bps (V.29)
 bits 2-0  T.30 CCITT protocol state
       000 idle
       001 dialing
       010 answering
       011 transmitting
       100 receiving
       101 pre-message
       110 post-message
       111 disconnect