From c808299140e4f11995736ff19e8c1f1d6ef0273c Mon Sep 17 00:00:00 2001 From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com> Date: Tue, 8 Sep 2026 20:34:44 +0800 Subject: [PATCH 1/4] build: wipe generated manpage tree on clean GENERATED_MANPAGES depends on BUILD_SYS, so removing manpages by list leaves stale files behind on uspace trees (e.g. the kbuild-only driver manpages pluto_servo.9, pluto_step.9, pcl720.9). gen_complist.py then picks up the stale files and generates links to manpages the current build configuration cannot produce, making local doc builds diverge from CI. Everything under docs/build/man is generated (halcompile output, asciidoctor output from docs/src/man, alias pages, translations), so wipe the whole tree in both clean-manpages and genclean. --- docs/src/Submakefile | 9 ++++++--- src/Makefile | 4 +--- 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/src/Submakefile b/docs/src/Submakefile index b585ee4574b..f3ebf26ca2d 100644 --- a/docs/src/Submakefile +++ b/docs/src/Submakefile @@ -495,9 +495,12 @@ docs: manpages clean: clean-manpages clean-translated -rm -f $(DOC_DIR)/html clean-manpages: - -rm -f $(GENERATED_MANPAGES) - # Remove generated alias man pages too. - $(RM) $$(grep -lr '^\.so ' $(DOC_MAN)/man*) + # Everything under $(DOC_MAN) is generated (halcompile output, + # asciidoctor output from docs/src/man, alias pages, translations). + # GENERATED_MANPAGES depends on BUILD_SYS, so removing by list leaves + # stale files behind (e.g. kbuild-only driver manpages on a uspace + # tree), which later confuse gen_complist.py. Wipe the whole tree. + -$(RM) -r $(DOC_MAN) clean-translated: -$(RM) -r $(GENERATED_TRANSLATED) diff --git a/src/Makefile b/src/Makefile index ce0192abd38..eae4da93a43 100644 --- a/src/Makefile +++ b/src/Makefile @@ -543,7 +543,7 @@ genclean: -rm -rf objects -rm -f $(TARGETS) -rm -f ../lib/*.so.[0-9]* - -rm -f $(GENERATED_MANPAGES) + -rm -rf ../docs/build/man -rm -f ../rtlib/*.$(MODULE_EXT) -rm -f hal/components/conv_*.comp @@ -1002,8 +1002,6 @@ obj-$(CONFIG_HAL_MOTENC) += hal_motenc.o hal_motenc-objs := hal/drivers/hal_motenc.o $(MATHSTUB) obj-$(CONFIG_HAL_AX521H) += hal_ax5214h.o hal_ax5214h-objs := hal/drivers/hal_ax5214h.o $(MATHSTUB) -obj-$(CONFIG_HAL_SKELETON) += hal_skeleton.o -hal_skeleton-objs := hal/drivers/hal_skeleton.o $(MATHSTUB) obj-$(CONFIG_OPTO_AC5) += opto_ac5.o opto_ac5-objs := hal/drivers/opto_ac5.o $(MATHSTUB) endif From 339ca56de6a3b6b7e98282397ef772e58d42898f Mon Sep 17 00:00:00 2001 From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com> Date: Tue, 8 Sep 2026 20:35:02 +0800 Subject: [PATCH 2/4] docs: deprecate the RTAI-kernel-only hardware drivers These drivers only build for RTAI kernels and have never been available in uspace builds (the only builds current users run): hal_stg, hal_motenc, hal_vti, hal_evoreg, hal_ax5214h, opto_ac5, pci_8255, pcl720, pluto_servo, pluto_step They serve ISA/PCI/parport cards from the early 2000s. The poll on the forum and emc-developers found one pci_8255 user on a legacy install (unaffected by removal from master) and Vital Systems reported no Motenc cards remaining and none known in use. Mark them deprecated in the driver docs, the component list, the opto_ac5 manpage, and the comp-embedded docs of pcl720, pluto_servo and pluto_step, and note the deprecation in the changelog. Removal is intentionally not tied to a specific release. If a user with hardware shows up, the driver can still be ported to uspace; see https://github.com/LinuxCNC/linuxcnc/issues/4505 --- debian/changelog | 6 ++++++ docs/src/drivers/ax5214h.adoc | 6 ++++++ docs/src/drivers/motenc.adoc | 6 ++++++ docs/src/drivers/opto22.adoc | 6 ++++++ docs/src/drivers/pluto-p.adoc | 6 ++++++ docs/src/drivers/servo-to-go.adoc | 6 ++++++ docs/src/hal/components.adoc | 13 ++++++++++--- docs/src/man/man9/opto_ac5.9.adoc | 6 ++++++ src/hal/drivers/pcl720.comp | 5 ++++- src/hal/drivers/pluto_servo.comp | 2 ++ src/hal/drivers/pluto_step.comp | 2 ++ 11 files changed, 60 insertions(+), 4 deletions(-) diff --git a/debian/changelog b/debian/changelog index 6d24473b7ab..765ea4966b7 100644 --- a/debian/changelog +++ b/debian/changelog @@ -6,6 +6,12 @@ linuxcnc (1:2.10.0~pre1) UNRELEASED; urgency=medium [ andypugh ] * Add a finite-jerk trajectory planner + [ Luca Toniolo ] + * Deprecate the RTAI-kernel-only hardware drivers (hal_stg, hal_motenc, + hal_vti, hal_evoreg, hal_ax5214h, opto_ac5, pci_8255, pcl720, + pluto_servo, pluto_step). They are not built for uspace and will be + removed in a future release. + -- andypugh Wed, 07 Jan 2026 22:15:18 +0000 linuxcnc (1:2.9.8) UNRELEASED; urgency=medium diff --git a/docs/src/drivers/ax5214h.adoc b/docs/src/drivers/ax5214h.adoc index d1365899503..3da254247b9 100644 --- a/docs/src/drivers/ax5214h.adoc +++ b/docs/src/drivers/ax5214h.adoc @@ -4,6 +4,12 @@ [[cha:ax5214-driver]] = AX5214H Driver +WARNING: This driver is deprecated and will be removed in a future +release. It is only built for RTAI kernels; it is not available in the +standard preempt-rt (uspace) builds. If you still use this hardware, +let us know on the LinuxCNC forum or the emc-developers mailing list, +see https://github.com/LinuxCNC/linuxcnc/issues/4505. + The Axiom Measurement & Control AX5214H is a 48 channel digital I/O board. It plugs into an ISA bus, and resembles a pair of 8255 chips. In fact it may be a pair of 8255 chips, but I'm not sure. If/when someone diff --git a/docs/src/drivers/motenc.adoc b/docs/src/drivers/motenc.adoc index fee21dac40c..73c7d9ac0c0 100644 --- a/docs/src/drivers/motenc.adoc +++ b/docs/src/drivers/motenc.adoc @@ -4,6 +4,12 @@ [[cha:motenc]] = Motenc Driver +WARNING: This driver is deprecated and will be removed in a future +release. It is only built for RTAI kernels; it is not available in the +standard preempt-rt (uspace) builds. If you still use this hardware, +let us know on the LinuxCNC forum or the emc-developers mailing list, +see https://github.com/LinuxCNC/linuxcnc/issues/4505. + Vital Systems Motenc-100 and Motenc-LITE The Vital Systems Motenc-100 and Motenc-LITE are 8- and 4-channel diff --git a/docs/src/drivers/opto22.adoc b/docs/src/drivers/opto22.adoc index e6c18d4e1a8..b9641aacb4b 100644 --- a/docs/src/drivers/opto22.adoc +++ b/docs/src/drivers/opto22.adoc @@ -4,6 +4,12 @@ [[cha:opto22]] = Opto22 Driver +WARNING: This driver is deprecated and will be removed in a future +release. It is only built for RTAI kernels; it is not available in the +standard preempt-rt (uspace) builds. If you still use this hardware, +let us know on the LinuxCNC forum or the emc-developers mailing list, +see https://github.com/LinuxCNC/linuxcnc/issues/4505. + *PCI AC5 ADAPTER CARD / HAL DRIVER* == The Adapter Card diff --git a/docs/src/drivers/pluto-p.adoc b/docs/src/drivers/pluto-p.adoc index f98605368d4..c8a1892fee8 100644 --- a/docs/src/drivers/pluto-p.adoc +++ b/docs/src/drivers/pluto-p.adoc @@ -4,6 +4,12 @@ [[cha:pluto-p-driver]] = Pluto P Driver +WARNING: This driver is deprecated and will be removed in a future +release. It is only built for RTAI kernels; it is not available in the +standard preempt-rt (uspace) builds. If you still use this hardware, +let us know on the LinuxCNC forum or the emc-developers mailing list, +see https://github.com/LinuxCNC/linuxcnc/issues/4505. + == General Info The Pluto-P is a FPGA board featuring the ACEX1K chip from Altera. diff --git a/docs/src/drivers/servo-to-go.adoc b/docs/src/drivers/servo-to-go.adoc index 205a8ced029..c9dd81d73f5 100644 --- a/docs/src/drivers/servo-to-go.adoc +++ b/docs/src/drivers/servo-to-go.adoc @@ -4,6 +4,12 @@ [[cha:servo-to-go]] = Servo To Go Driver +WARNING: This driver is deprecated and will be removed in a future +release. It is only built for RTAI kernels; it is not available in the +standard preempt-rt (uspace) builds. If you still use this hardware, +let us know on the LinuxCNC forum or the emc-developers mailing list, +see https://github.com/LinuxCNC/linuxcnc/issues/4505. + The Servo-To-Go (STG) is one of the first PC motion control cards supported by LinuxCNC. It is an ISA card and it exists in different flavors (all supported by this driver). The board includes up to 8 channels of diff --git a/docs/src/hal/components.adoc b/docs/src/hal/components.adoc index 8e04a648a93..3744fafd797 100644 --- a/docs/src/hal/components.adoc +++ b/docs/src/hal/components.adoc @@ -116,6 +116,13 @@ To search in the man pages, use the UNIX tool `apropos`. | hal_ppmc | Pico Systems <> for analog servo, PWM and Stepper controller || | link:../man/man9/hal_bb_gpio.9.html[hal_bb_gpio] |Driver for BeagleBone GPIO pins || | link:../man/man9/hal_parport.9.html[hal_parport] |Realtime HAL component to communicate with one or more PC parallel ports || +| hal_ax5214h |Axiom AX5214H <> for the 48 channel ISA digital I/O board (deprecated, RTAI kernel builds only) || +| hal_evoreg |Driver for the Siemens EVOREG motion control board (deprecated, RTAI kernel builds only) || +| hal_motenc |Vital Systems <> for the Motenc-100 and Motenc-LITE servo boards (deprecated, RTAI kernel builds only) || +| hal_stg |Servo-To-Go <> for the ISA motion control card (deprecated, RTAI kernel builds only) || +| hal_vti |Driver for the Vigilant VTI card (deprecated, RTAI kernel builds only) || +| pci_8255 |Driver for PCI cards based on the 8255 digital I/O chip (deprecated, RTAI kernel builds only) || +| pcl720 |Driver for the Advantech PCL720 ISA digital I/O card (deprecated, RTAI kernel builds only) || | link:../man/man9/hm2_7i43.9.html[hm2_7i43] |Mesa Electronics driver for the 7I43 EPP Anything IO board with HostMot2. (See the man page for more information) || | link:../man/man9/hm2_7i90.9.html[hm2_7i90] |LinuxCNC HAL driver for the Mesa Electronics 7I90 EPP Anything IO board with HostMot2 firmware || | link:../man/man9/hm2_eth.9.html[hm2_eth] |LinuxCNC HAL driver for the Mesa Electronics Ethernet Anything IO boards, with HostMot2 firmware || @@ -127,9 +134,9 @@ To search in the man pages, use the UNIX tool `apropos`. | link:../man/man9/mesa_7i65.9.html[mesa_7i65] |Mesa Electronics driver for the 7I65 eight-axis servo card. (See the man page for more information) || | link:../man/man9/mesa_pktgyro_test.9.html[mesa_pktgyro_test] |PktUART simple test with Microstrain 3DM-GX3-15 gyro || | link:../man/man9/mesa_uart.9.html[mesa_uart] |An example component demonstrating how to access the Hostmot2 UART || -| link:../man/man9/opto_ac5.9.html[opto_ac5] |Realtime driver for opto22 PCI-AC5 cards || -| pluto_servo |Pluto-P <> and firmware for the parallel port FPGA, for servos || -| pluto_step |Pluto-P <> for the parallel port FPGA, for steppers || +| link:../man/man9/opto_ac5.9.html[opto_ac5] |Realtime <> for opto22 PCI-AC5 cards (deprecated, RTAI kernel builds only) || +| pluto_servo |Pluto-P <> and firmware for the parallel port FPGA, for servos (deprecated, RTAI kernel builds only) || +| pluto_step |Pluto-P <> for the parallel port FPGA, for steppers (deprecated, RTAI kernel builds only) || | link:../man/man9/serport.9.html[serport] |Hardware driver for the digital I/O bits of the 8250 and 16550 serial port || | link:../man/man9/setsserial.9.html[setsserial] |An utility for setting Smart Serial NVRAM parameters || | link:../man/man9/sserial.9.html[sserial] |hostmot2 - Smart Serial LinuxCNC HAL driver for the Mesa Electronics HostMot2 Smart-Serial remote cards || diff --git a/docs/src/man/man9/opto_ac5.9.adoc b/docs/src/man/man9/opto_ac5.9.adoc index 0461756caf2..85134448cf2 100644 --- a/docs/src/man/man9/opto_ac5.9.adoc +++ b/docs/src/man/man9/opto_ac5.9.adoc @@ -10,6 +10,12 @@ opto_ac5 - Realtime driver for opto22 PCI-AC5 cards == DESCRIPTION +WARNING: This driver is deprecated and will be removed in a future +release. It is only built for RTAI kernels; it is not available in the +standard preempt-rt (uspace) builds. If you still use this hardware, +let us know on the LinuxCNC forum or the emc-developers mailing list, +see https://github.com/LinuxCNC/linuxcnc/issues/4505. + These pins and parameters are created by the realtime *opto_ac5* module. The portconfig0 and portconfig1 variables are used to configure the two ports of each card. The first 24 bits of a 32 bit number represent the diff --git a/src/hal/drivers/pcl720.comp b/src/hal/drivers/pcl720.comp index 1c455490200..963a636ec58 100644 --- a/src/hal/drivers/pcl720.comp +++ b/src/hal/drivers/pcl720.comp @@ -1,5 +1,8 @@ component pcl720 """Driver for the Advantech PCL 720 card."""; -description """This driver supports the Advantech PCL720 ISA card. It might +description """ +.SH DEPRECATED +This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. +This driver supports the Advantech PCL720 ISA card. It might work with the PCI version too, but this is untested. It creates hal pins corresponding to the digital inputs and outputs, but does not support the the counters/timers."""; diff --git a/src/hal/drivers/pluto_servo.comp b/src/hal/drivers/pluto_servo.comp index 000d5580776..79c53ad61ef 100644 --- a/src/hal/drivers/pluto_servo.comp +++ b/src/hal/drivers/pluto_servo.comp @@ -17,6 +17,8 @@ component pluto_servo """Hardware driver and firmware for the Pluto-P parallel-port FPGA, for use with servo machines."""; description """ +.SH DEPRECATED +This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. Pluto_servo is a LinuxCNC software driver and associated firmware that allow the Pluto-P board to be used to control a servo-based CNC machine. The driver has 4 PWM channels, 4 quadrature channels with index pulse, 18 diff --git a/src/hal/drivers/pluto_step.comp b/src/hal/drivers/pluto_step.comp index eba52022e01..7a27750dfae 100644 --- a/src/hal/drivers/pluto_step.comp +++ b/src/hal/drivers/pluto_step.comp @@ -62,6 +62,8 @@ may give improved step regularity at low step speeds. .RE"""; description """ +.SH DEPRECATED +This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. Pluto_step is a LinuxCNC software driver and associated firmware that allow the Pluto-P board to be used to control a stepper-based CNC machine. The driver has 4 step+direction channels, 14 dedicated digital outputs, and 16 From 4f4defaf297f1acbc780741fdb31f576bdcc6302 Mon Sep 17 00:00:00 2001 From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com> Date: Tue, 8 Sep 2026 20:35:12 +0800 Subject: [PATCH 3/4] build: stop building hal_skeleton hal_skeleton is not a hardware driver but John Kasunich's code template for writing new drivers. It only builds on kbuild (RTAI), is never loaded by any config, and the source file stays in the tree as a reference. --- src/Makefile.inc.in | 1 - 1 file changed, 1 deletion(-) diff --git a/src/Makefile.inc.in b/src/Makefile.inc.in index c0ab1ceb631..e66aba7a6d7 100644 --- a/src/Makefile.inc.in +++ b/src/Makefile.inc.in @@ -214,7 +214,6 @@ CONFIG_PROBE_PARPORT=m CONFIG_HAL_TIRO=m CONFIG_HAL_EVOREG=m CONFIG_HAL_MOTENC=m -CONFIG_HAL_SKELETON=m CONFIG_HAL_SPEAKER=m CONFIG_HAL_STG=m CONFIG_HAL_VTI=m From c060966aafbc04ed7769813189f315826680532f Mon Sep 17 00:00:00 2001 From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com> Date: Fri, 11 Sep 2026 15:02:37 +0800 Subject: [PATCH 4/4] docs: address review comments on the deprecation warnings - Use admonition blocks instead of one-line WARNING paragraphs - Drop the troff .SH markup from the comp descriptions, plain text is enough and the descriptions are asciidoc now - Do not add the seven never-listed drivers to components.adoc; keep the deprecation marker only on the three existing rows (opto_ac5, pluto_servo, pluto_step) --- docs/src/drivers/ax5214h.adoc | 13 +++++++++---- docs/src/drivers/motenc.adoc | 13 +++++++++---- docs/src/drivers/opto22.adoc | 13 +++++++++---- docs/src/drivers/pluto-p.adoc | 13 +++++++++---- docs/src/drivers/servo-to-go.adoc | 13 +++++++++---- docs/src/hal/components.adoc | 7 ------- docs/src/man/man9/opto_ac5.9.adoc | 13 +++++++++---- src/hal/drivers/pcl720.comp | 4 ++-- src/hal/drivers/pluto_servo.comp | 4 ++-- src/hal/drivers/pluto_step.comp | 4 ++-- 10 files changed, 60 insertions(+), 37 deletions(-) diff --git a/docs/src/drivers/ax5214h.adoc b/docs/src/drivers/ax5214h.adoc index 3da254247b9..d1c3b4ccc3d 100644 --- a/docs/src/drivers/ax5214h.adoc +++ b/docs/src/drivers/ax5214h.adoc @@ -4,11 +4,16 @@ [[cha:ax5214-driver]] = AX5214H Driver -WARNING: This driver is deprecated and will be removed in a future -release. It is only built for RTAI kernels; it is not available in the -standard preempt-rt (uspace) builds. If you still use this hardware, -let us know on the LinuxCNC forum or the emc-developers mailing list, +[WARNING] +.Deprecation warning +==== +This driver is deprecated and will be removed in a future release. +It is only built for RTAI kernels; it is not available in the standard +preempt-rt (uspace) builds. +If you still use this hardware, let us know on the LinuxCNC forum or +the emc-developers mailing list, see https://github.com/LinuxCNC/linuxcnc/issues/4505. +==== The Axiom Measurement & Control AX5214H is a 48 channel digital I/O board. It plugs into an ISA bus, and resembles a pair of 8255 chips. In diff --git a/docs/src/drivers/motenc.adoc b/docs/src/drivers/motenc.adoc index 73c7d9ac0c0..fc38e7040d1 100644 --- a/docs/src/drivers/motenc.adoc +++ b/docs/src/drivers/motenc.adoc @@ -4,11 +4,16 @@ [[cha:motenc]] = Motenc Driver -WARNING: This driver is deprecated and will be removed in a future -release. It is only built for RTAI kernels; it is not available in the -standard preempt-rt (uspace) builds. If you still use this hardware, -let us know on the LinuxCNC forum or the emc-developers mailing list, +[WARNING] +.Deprecation warning +==== +This driver is deprecated and will be removed in a future release. +It is only built for RTAI kernels; it is not available in the standard +preempt-rt (uspace) builds. +If you still use this hardware, let us know on the LinuxCNC forum or +the emc-developers mailing list, see https://github.com/LinuxCNC/linuxcnc/issues/4505. +==== Vital Systems Motenc-100 and Motenc-LITE diff --git a/docs/src/drivers/opto22.adoc b/docs/src/drivers/opto22.adoc index b9641aacb4b..ac351dcd834 100644 --- a/docs/src/drivers/opto22.adoc +++ b/docs/src/drivers/opto22.adoc @@ -4,11 +4,16 @@ [[cha:opto22]] = Opto22 Driver -WARNING: This driver is deprecated and will be removed in a future -release. It is only built for RTAI kernels; it is not available in the -standard preempt-rt (uspace) builds. If you still use this hardware, -let us know on the LinuxCNC forum or the emc-developers mailing list, +[WARNING] +.Deprecation warning +==== +This driver is deprecated and will be removed in a future release. +It is only built for RTAI kernels; it is not available in the standard +preempt-rt (uspace) builds. +If you still use this hardware, let us know on the LinuxCNC forum or +the emc-developers mailing list, see https://github.com/LinuxCNC/linuxcnc/issues/4505. +==== *PCI AC5 ADAPTER CARD / HAL DRIVER* diff --git a/docs/src/drivers/pluto-p.adoc b/docs/src/drivers/pluto-p.adoc index c8a1892fee8..0a295b3232c 100644 --- a/docs/src/drivers/pluto-p.adoc +++ b/docs/src/drivers/pluto-p.adoc @@ -4,11 +4,16 @@ [[cha:pluto-p-driver]] = Pluto P Driver -WARNING: This driver is deprecated and will be removed in a future -release. It is only built for RTAI kernels; it is not available in the -standard preempt-rt (uspace) builds. If you still use this hardware, -let us know on the LinuxCNC forum or the emc-developers mailing list, +[WARNING] +.Deprecation warning +==== +This driver is deprecated and will be removed in a future release. +It is only built for RTAI kernels; it is not available in the standard +preempt-rt (uspace) builds. +If you still use this hardware, let us know on the LinuxCNC forum or +the emc-developers mailing list, see https://github.com/LinuxCNC/linuxcnc/issues/4505. +==== == General Info diff --git a/docs/src/drivers/servo-to-go.adoc b/docs/src/drivers/servo-to-go.adoc index c9dd81d73f5..35b41db2666 100644 --- a/docs/src/drivers/servo-to-go.adoc +++ b/docs/src/drivers/servo-to-go.adoc @@ -4,11 +4,16 @@ [[cha:servo-to-go]] = Servo To Go Driver -WARNING: This driver is deprecated and will be removed in a future -release. It is only built for RTAI kernels; it is not available in the -standard preempt-rt (uspace) builds. If you still use this hardware, -let us know on the LinuxCNC forum or the emc-developers mailing list, +[WARNING] +.Deprecation warning +==== +This driver is deprecated and will be removed in a future release. +It is only built for RTAI kernels; it is not available in the standard +preempt-rt (uspace) builds. +If you still use this hardware, let us know on the LinuxCNC forum or +the emc-developers mailing list, see https://github.com/LinuxCNC/linuxcnc/issues/4505. +==== The Servo-To-Go (STG) is one of the first PC motion control cards supported by LinuxCNC. It is an ISA card and it exists in different flavors (all diff --git a/docs/src/hal/components.adoc b/docs/src/hal/components.adoc index 3744fafd797..975f7f4f6cc 100644 --- a/docs/src/hal/components.adoc +++ b/docs/src/hal/components.adoc @@ -116,13 +116,6 @@ To search in the man pages, use the UNIX tool `apropos`. | hal_ppmc | Pico Systems <> for analog servo, PWM and Stepper controller || | link:../man/man9/hal_bb_gpio.9.html[hal_bb_gpio] |Driver for BeagleBone GPIO pins || | link:../man/man9/hal_parport.9.html[hal_parport] |Realtime HAL component to communicate with one or more PC parallel ports || -| hal_ax5214h |Axiom AX5214H <> for the 48 channel ISA digital I/O board (deprecated, RTAI kernel builds only) || -| hal_evoreg |Driver for the Siemens EVOREG motion control board (deprecated, RTAI kernel builds only) || -| hal_motenc |Vital Systems <> for the Motenc-100 and Motenc-LITE servo boards (deprecated, RTAI kernel builds only) || -| hal_stg |Servo-To-Go <> for the ISA motion control card (deprecated, RTAI kernel builds only) || -| hal_vti |Driver for the Vigilant VTI card (deprecated, RTAI kernel builds only) || -| pci_8255 |Driver for PCI cards based on the 8255 digital I/O chip (deprecated, RTAI kernel builds only) || -| pcl720 |Driver for the Advantech PCL720 ISA digital I/O card (deprecated, RTAI kernel builds only) || | link:../man/man9/hm2_7i43.9.html[hm2_7i43] |Mesa Electronics driver for the 7I43 EPP Anything IO board with HostMot2. (See the man page for more information) || | link:../man/man9/hm2_7i90.9.html[hm2_7i90] |LinuxCNC HAL driver for the Mesa Electronics 7I90 EPP Anything IO board with HostMot2 firmware || | link:../man/man9/hm2_eth.9.html[hm2_eth] |LinuxCNC HAL driver for the Mesa Electronics Ethernet Anything IO boards, with HostMot2 firmware || diff --git a/docs/src/man/man9/opto_ac5.9.adoc b/docs/src/man/man9/opto_ac5.9.adoc index 85134448cf2..5293285c506 100644 --- a/docs/src/man/man9/opto_ac5.9.adoc +++ b/docs/src/man/man9/opto_ac5.9.adoc @@ -10,11 +10,16 @@ opto_ac5 - Realtime driver for opto22 PCI-AC5 cards == DESCRIPTION -WARNING: This driver is deprecated and will be removed in a future -release. It is only built for RTAI kernels; it is not available in the -standard preempt-rt (uspace) builds. If you still use this hardware, -let us know on the LinuxCNC forum or the emc-developers mailing list, +[WARNING] +.Deprecation warning +==== +This driver is deprecated and will be removed in a future release. +It is only built for RTAI kernels; it is not available in the standard +preempt-rt (uspace) builds. +If you still use this hardware, let us know on the LinuxCNC forum or +the emc-developers mailing list, see https://github.com/LinuxCNC/linuxcnc/issues/4505. +==== These pins and parameters are created by the realtime *opto_ac5* module. The portconfig0 and portconfig1 variables are used to configure the two diff --git a/src/hal/drivers/pcl720.comp b/src/hal/drivers/pcl720.comp index 963a636ec58..fd613bca3da 100644 --- a/src/hal/drivers/pcl720.comp +++ b/src/hal/drivers/pcl720.comp @@ -1,7 +1,7 @@ component pcl720 """Driver for the Advantech PCL 720 card."""; description """ -.SH DEPRECATED -This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. +DEPRECATED: This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. + This driver supports the Advantech PCL720 ISA card. It might work with the PCI version too, but this is untested. It creates hal pins corresponding to the digital inputs and outputs, but does diff --git a/src/hal/drivers/pluto_servo.comp b/src/hal/drivers/pluto_servo.comp index 79c53ad61ef..015dce003d2 100644 --- a/src/hal/drivers/pluto_servo.comp +++ b/src/hal/drivers/pluto_servo.comp @@ -17,8 +17,8 @@ component pluto_servo """Hardware driver and firmware for the Pluto-P parallel-port FPGA, for use with servo machines."""; description """ -.SH DEPRECATED -This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. +DEPRECATED: This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. + Pluto_servo is a LinuxCNC software driver and associated firmware that allow the Pluto-P board to be used to control a servo-based CNC machine. The driver has 4 PWM channels, 4 quadrature channels with index pulse, 18 diff --git a/src/hal/drivers/pluto_step.comp b/src/hal/drivers/pluto_step.comp index 7a27750dfae..5bf32c521d0 100644 --- a/src/hal/drivers/pluto_step.comp +++ b/src/hal/drivers/pluto_step.comp @@ -62,8 +62,8 @@ may give improved step regularity at low step speeds. .RE"""; description """ -.SH DEPRECATED -This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. +DEPRECATED: This driver is deprecated and will be removed in a future release. It is only built for RTAI kernels; it is not available in the standard preempt-rt (uspace) builds. + Pluto_step is a LinuxCNC software driver and associated firmware that allow the Pluto-P board to be used to control a stepper-based CNC machine. The driver has 4 step+direction channels, 14 dedicated digital outputs, and 16