This is an automated email from Gerrit.
"zapb <d...@zapb.de>" just uploaded a new patch set to Gerrit, which you can
find at https://review.openocd.org/c/openocd/+/8349
-- gerrit
commit eb11f9e38d0ce510264f9fe13009d7f61d055554
Author: Marc Schink <d...@zapb.de>
Date: Wed Jun 12 21:53:25 2024 +0200
Deprecate parallel port adapters
Since USB almost completely replaced parallel port interfaces, parallel
port debug adapters are very rarely used these days. The poor hardware
availability and the lack of users prevents testing, maintenance and
adaptations to future changes.
Mark parallel port adapters as deprecated as a first step to give
potential users the opportunity to upgrade the hardware until the next
OpenOCD release. The documentation already recommends to use USB-based
adapters in instead of parallel port adapters.
Change-Id: Idd9fb75588246bc39e12ea17a71435ed77f0f50b
Signed-off-by: Marc Schink <d...@zapb.de>
diff --git a/configure.ac b/configure.ac
index becc531b0d..e003a293b2 100644
--- a/configure.ac
+++ b/configure.ac
@@ -848,6 +848,12 @@ AS_IF([test "x$enable_jlink" != "xno"], [
]])
)
+AS_IF([test "x$build_parport" = "xyes" || test "x$build_amtjtagaccel" = "xyes"
|| test "x$build_gw16012" = "xyes"], [
+ echo
+ echo
+ AC_MSG_WARN([Parallel port adapters are deprecated and support will be
removed in the next release!])
+])
+
echo
echo
echo OpenOCD configuration summary
diff --git a/doc/openocd.texi b/doc/openocd.texi
index e46e6004bc..d487bfdde0 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -2502,6 +2502,8 @@ enabled when OpenOCD is configured, in order to be made
available at run time.
@deffn {Interface Driver} {amt_jtagaccel}
+@b{Note: Parallel port adapters are deprecated and support will be removed in
the next release!}
+
Amontec Chameleon in its JTAG Accelerator configuration,
connected to a PC's EPP mode parallel port.
This defines some driver-specific commands:
@@ -2921,6 +2923,8 @@ image. To be used with USB-Blaster II only.
@end deffn
@deffn {Interface Driver} {gw16012}
+@b{Note: Parallel port adapters are deprecated and support will be removed in
the next release!}
+
Gateworks GW16012 JTAG programmer.
This has one driver-specific command:
@@ -3067,6 +3071,8 @@ version, and target voltage.
@end deffn
@deffn {Interface Driver} {parport}
+@b{Note: Parallel port adapters are deprecated and support will be removed in
the next release!}
+
Supports PC parallel port bit-banging cables:
Wigglers, PLD download cable, and more.
These interfaces have several commands, used to configure the driver
diff --git a/src/jtag/drivers/amt_jtagaccel.c b/src/jtag/drivers/amt_jtagaccel.c
index b28ce62ffb..9b27c10f5f 100644
--- a/src/jtag/drivers/amt_jtagaccel.c
+++ b/src/jtag/drivers/amt_jtagaccel.c
@@ -419,6 +419,8 @@ static int amt_jtagaccel_init(void)
#endif
uint8_t ar_status;
+ LOG_WARNING("Parallel port adapters are deprecated and support will be
removed in the next release!");
+
#if PARPORT_USE_PPDEV == 1
if (device_handle > 0) {
LOG_ERROR("device is already opened");
diff --git a/src/jtag/drivers/gw16012.c b/src/jtag/drivers/gw16012.c
index a4c6fd0f00..597a8dd4d4 100644
--- a/src/jtag/drivers/gw16012.c
+++ b/src/jtag/drivers/gw16012.c
@@ -462,6 +462,8 @@ static int gw16012_init(void)
{
uint8_t status_port;
+ LOG_WARNING("Parallel port adapters are deprecated and support will be
removed in the next release!");
+
if (gw16012_init_device() != ERROR_OK)
return ERROR_JTAG_INIT_FAILED;
diff --git a/src/jtag/drivers/parport.c b/src/jtag/drivers/parport.c
index d26a51048f..746db1ef32 100644
--- a/src/jtag/drivers/parport.c
+++ b/src/jtag/drivers/parport.c
@@ -259,6 +259,7 @@ static int parport_init(void)
#if PARPORT_USE_PPDEV == 1
char buffer[256];
#endif
+ LOG_WARNING("Parallel port adapters are deprecated and support will be
removed in the next release!");
cur_cable = cables;
--
