📄 dbgport.c
字号:
/****************************************************************************
*
* Open Watcom Project
*
* Portions Copyright (c) 1983-2002 Sybase, Inc. All Rights Reserved.
*
* ========================================================================
*
* This file contains Original Code and/or Modifications of Original
* Code as defined in and that are subject to the Sybase Open Watcom
* Public License version 1.0 (the 'License'). You may not use this file
* except in compliance with the License. BY USING THIS FILE YOU AGREE TO
* ALL TERMS AND CONDITIONS OF THE LICENSE. A copy of the License is
* provided with the Original Code and Modifications, and is also
* available at www.sybase.com/developer/opensource.
*
* The Original Code and all software distributed under the License are
* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
* EXPRESS OR IMPLIED, AND SYBASE AND ALL CONTRIBUTORS HEREBY DISCLAIM
* ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR
* NON-INFRINGEMENT. Please see the License for the specific language
* governing rights and limitations under the License.
*
* ========================================================================
*
* Description: WHEN YOU FIGURE OUT WHAT THIS FILE DOES, PLEASE
* DESCRIBE IT HERE!
*
****************************************************************************/
/*
* The WATCOM Connection
* ---------------------
* The AT parallel port uses pins 1 to 17 for data and 18 to 25 for
* ground. To send 8 bits of data between two ATs, we use 8 lines in one
* direction, 8 in the other direction, and 1 for handshaking (total 17).
* The 5 data lines from port 3BD/379 and 3 data lines from port 3BE/37A
* are combined for 8 input data bits. We use pin 17 for handshaking
* since it is bi-directional (i. e. , you can read/write this line).
*
* Here's how to hook up a WATCOM cable to make this work.
*
* Port Bit Pin -> Pin Port Bit
*
* GROUND 18 <-> 18
* CtlPort2 3 17 <-> 17 CtlPort2 3 (SLCT IN)
*
* DataPort 0 2 -> 1* CtlPort2 0 (STROBE)
* " 1 3 -> 14* " 1 (AUTO FD XT)
* " 2 4 -> 16 " 2 (-INIT)
* " 3 5 -> 15 CtlPort1 3 (-ERROR)
*
* " 4 6 -> 13 " 4 (Select)
* " 5 7 -> 12 " 5 (PE)
* " 6 8 -> 10 " 6 (-ACK)
* " 7 9 -> 11* " 7 (-BUSY)
*
* 1* <- 2
* 14* <- 3
* 16 <- 4
* 15 <- 5
*
* 13 <- 6
* 12 <- 7
* 10 <- 8
* 11* <- 9
*
* (*) means logic inverted
*
* The Fujistsu Connection
* -----------------------
* The Fujitsu FMR-xx also supports the transmission and reception of 8
* data bits. There are enough data lines to do this. Unfortunately,
* there are no bidirectional data lines. Therefore, we are short one pin
* on the AT side (we would require 8 data + 8 data + 2 handshaking lines
* on the AT since the Fujitsu has no bidirectional data lines).
*
* From the software point of view, we will be able to send 8 bits at a
* time in one direction (to the FMR-xx) and 4 bits at a time in the
* other direction (to the AT). Given that the higher volume of traffic
* is usually from the application machine to debugger machine, this
* seems to be the best choice.
*
* Here's how to hook up a Fujitsu WATCOM cable to make this work.
*
* AT side FM-R side
* -------------- -------------------
* Port Bit Pin Pin Port Bit
*
* GROUND 18 <-> 23 GROUND
* (-SLCT IN) CtlPort2 3 17 -> 13* StatReg2 3 (*SLCT)
*
* (+DB0) DataPort 0 2 -> 14 StatReg2 0 (RINF1)
* (+DB1) " 1 3 -> 15 " 1 (RINF2)
* (+DB2) " 2 4 -> 16 " 2 (RINF3)
* (+DB3) " 3 5 -> 17 StatReg1 3 (POW +5 VP)
*
* (+DB4) " 4 6 -> 22 " 4 (THSN)
* (+DB5) " 5 7 -> 21* " 5 (*FUSE)
* (+DB6) " 6 8 -> 12 " 6 (PE)
* (+DB7) " 7 9 -> 11 " 7 (BUSY)
*
* (-STROBE) CtlPort2 0 1* <- 2 DataReg 0 (PD1)
* (-AUTO FEED) " 1 14* <- 3 1 (PD2)
* (-INIT PRT) " 2 16 <- 4 2 (PD3)
* (-ERROR) CtlPort1 3 15 <- 5 3 (PD4)
* (+SELECT) " 4 13 <- 6 4 (PD5)
* (+P.END) " 5 12 <- 7 5 (PD6)
* (-ACKNOWLEDGE)" 6 10 <- 8 6 (PD7)
* (+BUSY) " 7 11* <- 9 7 (PD8)
*
* (*) means logic inverted
*
* The LapLink Connection
* ----------------------
* Here's how to hook up a LapLink cable.
*
* Port Bit Pin -> Pin Port Bit
*
* DataPort 0 2 -> 15 CtlPort1 3 (Error)
* " 1 3 -> 13 " 4 (Select)
* " 2 4 -> 12 " 5 (P End)
* " 3 5 -> 10 " 6 (Ack)
* " 4 6 -> 11* " 7 (Busy)
*
* 10 <- 5
* 11 <- 6
* 12 <- 4
* 13 <- 3
* 15 <- 2
*
* Ground 25 <-> 25
*
* The Flying Dutchman Connection
* ------------------------------
* Here's how to hook up a Flying Dutchman cable.
*
* Port Bit Pin -> Pin Port Bit
*
* CtlPort2 0 1 -> 11* CtlPort1 7
* DataPort 0 2 -> 15 " 3 (Error)
* " 1 3 -> 13 " 4 (Select)
* " 2 4 -> 12 " 5 (P End)
* " 3 5 -> 10 " 6 (Ack)
*
* 10 <- 5
* 11 <- 1
* 12 <- 4
* 13 <- 3
* 15 <- 2
*
* The following is some technical information on the AT parallel port.
* The pin numbers refer to the DB25 pins on the AT parallel port.
*
* IBM AT Parallel Port
* +-----------------------------------+
* |Input/Output to 3BC/378 |
* +-----------------------------------+
* |Bit 7 6 5 4 3 2 1 0|
* |Pin 9 8 7 6 5 4 3 2|
* +-----------------------------------+
*
* +-----------------------------------+
* |Output to 3BE/37A
* +-----------------------------------+
* |Bit 7 6 5 4 3 2 1 0|
* |Pin - - - IRQ 17 16 14 1|
* | Enable |
* +-----------------------------------+
*
* +-----------------------------------+
* |Input from 3BD/379
* +-----------------------------------+
* |Bit 7 6 5 4 3 2 1 0|
* |Pin 11 10 12 13 15 - - -|
* +-----------------------------------+
*
* +-----------------------------------+
* |Input from 3BE/37A
* +-----------------------------------+
* |Bit 7 6 5 4 3 2 1 0|
* |Pin - - - IRQ 17 16 14 1|
* | Enable |
* +-----------------------------------+
*/
#include <ntddk.h>
#include "parallel.h"
#include "dbgioctl.h"
#if defined( __WATCOMC__ )
typedef __int64 _int64;
#define PORTSTDCALL STDCALL
#endif
#ifdef TRUE
typedef UCHAR bool;
#else
typedef enum { FALSE, TRUE } bool;
#endif
#define _inp(p) READ_PORT_UCHAR((PUCHAR)(ext->Controller + (p)))
#define _outp(p,v) WRITE_PORT_UCHAR((PUCHAR)(ext->Controller + (p)), (UCHAR)(v))
/* 0x18 is used to ensure that the control lines stay in a high state
* until Synch is called
*/
#define WATCOM_VAL 0x1A
#define TWIDLE_ON WATCOM_VAL
#define TWIDLE_OFF ( WATCOM_VAL & 0xFD )
/*
* The Fujitsu FMR link looks like a busted WATCOM cable
* in which RaiseCtl1()/LowerCtl1() cannot be performed
*/
#define FMR_VAL 0x2A
/*
* How the LAPLINK_VAL calculation works:
*
* <<3 simulates the effect of being transmitted over the LAPLINK
* |0x2 0x2 is the value returned from a read of ctlport 2
* (after appropriate bit operations have be done by
* ReadData). This value is dependent on the value
* written when XX_RaiseCtl1 is called
*/
#define LAPLINK_VAL ( ( TWIDLE_ON << 3 ) | 0x2 )
/*
* The DUTCHMAN_VAL calculation works the same as the LAPLINK_VAL
* calculation except:
*
* &0x0f acounts for the fact that pin 6 is not connected in the
* flying dutchman cable
*/
#define DUTCHMAN_VAL ( ( ( TWIDLE_ON & 0x0f ) << 3 ) | 0x02 )
#define NULL_VAL 0
#define TWIDLE_TIME 1
#define TWIDLE_NUM 2
#define DONE_LINE_TEST 255
/* relinquish must be less than keep */
#define RELINQUISH 0
#define KEEP 1
#define LINE_TEST_WAIT 20
#define SYNCH_WAIT 40
#define TIMEOUT -1
/*********************** WATCOM CABLE MACROS **************************/
#define PC_CTL1 0x08
#define PC_CTL2 0x08
#define Ctl1Hi() ( ( _inp( ext->CtlPort2 ) & PC_CTL1 ) != 0 )
#define Ctl1Lo() ( ( _inp( ext->CtlPort2 ) & PC_CTL1 ) == 0 )
#define RaiseCtl1() ( _outp( ext->CtlPort2, PC_CTL1 | 0x04 ) )
#define LowerCtl1() ( _outp( ext->CtlPort2, 0x04 ) )
#define Ctl2Hi() ( ( _inp( ext->CtlPort1 ) & PC_CTL2 ) != 0 )
#define Ctl2Lo() ( ( _inp( ext->CtlPort1 ) & PC_CTL2 ) == 0 )
#define RaiseCtl2() ( _outp( ext->DataPort, PC_CTL2 ) )
#define LowerCtl2() ( _outp( ext->DataPort, 0x00 ) )
#define ReadData() ( ( ( _inp( ext->CtlPort1 ) ^ 0x80 ) & 0xF8 ) \
| ( ( _inp( ext->CtlPort2 ) ^ 0x03 ) & 0x07 ) )
#define WriteData(data) ( _outp( ext->DataPort, data ) )
/*********************** WATCOM FMR CABLE MACROS **********************/
#define FM_CTL1 0x40
/* Can't use ext->CtlPort2 & 0x08 (line disabled) */
#define FM_Ctl1Hi() ( ( _inp( ext->CtlPort1 ) & FM_CTL1 ) != 0 )
#define FM_Ctl1Lo() ( ( _inp( ext->CtlPort1 ) & FM_CTL1 ) == 0 )
/********************** LAPLINK CABLE MACROS **************************/
#define LL_Ctl1Hi() ( ( _inp( ext->CtlPort1 ) & 0x80 ) == 0 )
#define LL_Ctl1Lo() ( ( _inp( ext->CtlPort1 ) & 0x80 ) != 0 )
#define LL_RaiseCtl1() ( _outp( ext->DataPort, 0x10 ) )
#define LL_LowerCtl1() ( _outp( ext->DataPort, 0x00 ) )
#define LL_Ctl2Hi() ( ( _inp( ext->CtlPort1 ) & 0x40 ) != 0 )
#define LL_Ctl2Lo() ( ( _inp( ext->CtlPort1 ) & 0x40 ) == 0 )
#define LL_RaiseCtl2() ( _outp( ext->DataPort, 0x08 ) )
#define LL_LowerCtl2() ( _outp( ext->DataPort, 0x00 ) )
#define LL_ReadData() ( ( _inp( ext->CtlPort1 ) >> 3 ) & 0x0f )
/* write the data and raise control line 1 */
#define LL_WriteData(data) ( _outp( ext->DataPort, ( data | 0x10 ) ) )
/***************** FLYING DUTCHMAN CABLE MACROS ***********************/
#define FD_Ctl1Hi() ( ( _inp( ext->CtlPort1 ) & 0x80 ) != 0 )
#define FD_Ctl1Lo() ( ( _inp( ext->CtlPort1 ) & 0x80 ) == 0 )
#define FD_RaiseCtl1() ( _outp( ext->CtlPort2, 0x01 ) )
#define FD_LowerCtl1() ( _outp( ext->CtlPort2, 0x00 ) )
#define FD_Ctl2Hi() ( ( _inp( ext->CtlPort1 ) & 0x40 ) != 0 )
#define FD_Ctl2Lo() ( ( _inp( ext->CtlPort1 ) & 0x40 ) == 0 )
#define FD_RaiseCtl2() ( _outp( ext->DataPort, 0x08 ) )
#define FD_LowerCtl2() ( _outp( ext->DataPort, 0x00 ) )
#define FD_ReadData() ( ( _inp( ext->CtlPort1 ) >> 3 ) & 0x0f )
#define FD_WriteData(data) ( _outp( ext->DataPort, data ) )
/***************** Cable Detection MACROS ****************************/
/*
* This operation disables bits 3,2,0 in CtrlPort2 (LowerCtl1 fixes it)
*/
#define XX_RaiseCtl1() ( _outp( ext->CtlPort2, 0x01 ) )
/*********************************************************************/
#define TWIDDLE_THUMBS if( wait == RELINQUISH ) { NothingToDo(); }\
else if( wait != KEEP && wait < Ticks() ) return( TIMEOUT )
#define PARALLEL_REGISTER_SPAN 3
typedef struct _DEVICE_EXTENSION {
// Points to the device object that contains
// this device extension.
PDEVICE_OBJECT DeviceObject;
// Points to the port device object that this class device is
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -