# HG changeset patch # User Mychaela Falconia # Date 1702323021 0 # Node ID b8473892b0ceebc0a9ebb8e7bd0917e7fbd9efcf # Parent 4f5abad5dd4005c668ed9d69321f035dfbea8d41 linux-patch directory: indicate deprecation via README diff -r 4f5abad5dd40 -r b8473892b0ce linux-patch/README --- a/linux-patch/README Mon Sep 11 07:23:18 2023 +0000 +++ b/linux-patch/README Mon Dec 11 19:30:21 2023 +0000 @@ -1,40 +1,9 @@ -This directory contains several versions of the Linux kernel ftdi_sio driver -patch that adds support for FreeCalypso DUART28C adapter, i.e., the optional -configuration of DUART28 with boot control outputs. - -The version in the orig-202007 directory was produced at the end of 2020-07, -when DUART28 hardware was still being designed; this original version of the -patch was created to test the idea and to prove it working (using a generic -FT2232D board and an oscilloscope), and it was created with the mindset of a -hardware engineer, rather than that of Linux kernel maintainers. This original -patch version was made against kernel version 4.4.14 (the version used by the -Mother), and it predates all later mainline submission and integration attempts. +The collection of patches to Linux kernel ftdi_sio driver (adding support for +USB device 0403:7152 and the special quirk it requires) has moved to a new Hg +repository of its own: -A patch series against then-current mainline was submitted to ftdi_sio driver -maintainer Johan Hovold in 2020-09 for inclusion in mainline Linux. The -preliminary patch adding support for FreeCalypso JTAG+UART USB ID codes was -readily accepted and has since been propagated to several stable kernel branches -(4.4.240, 4.9.240, 4.14.202, 4.19.152, 5.4.72, 5.8.16, 5.9.1 and mainline 5.10), -but this patch by itself does not help in any way with DUART28C support. The -remaining two patches from the original 2020-09 patch series (a preliminary -patch fixing an oversight in the quirk interface and then the main patch of -interest) were met with resistance, however - please see the article in -doc/Linux-DTR-RTS-flaw for the full explanation. The short version is that -Linux kernel maintainers are refusing to accept our patch on the basis of their -assininity, and thus We The End Users will need to apply this patch locally on -our own systems, probably forever, or at least for the next few billion years -until the Sun swells into a red giant and engulfs the Earth. +https://www.freecalypso.org/hg/fc-linux-patch/ -3 end user patch series versions are presented in minpatch-4.4.14, -minpatch-4.4.240 and minpatch-4.9.240. 4.4.240 and 4.9.240 already include the -preliminary JTAG+UART USB ID code support patch (which serves mainly as an -anchor marking the place where the new DUART28C USB ID code needs to go in -ftdi_sio_ids.h and in the ftdi_sio.c ID code table), but 4.4.14 predates this -patch by a few years, thus minpatch-4.4.14 includes a backport of this -preliminary patch as well. After this preliminary patch, each minpatch-* -version includes the quirk port_probe patch and the main patch adding DUART28C -support with the needed quirk. These latter patches are the closest version we -ever got to a mainline-acceptable state: they already underwent rounds of -revision in response to the maintainer's criticism, addressing and fixing -various nitpick issues before the whole idea got shot down on more ideological -grounds. +The old versions contained in this directory are just that - old versions; +the new repository contains updated versions of the patches that apply against +newer kernels. diff -r 4f5abad5dd40 -r b8473892b0ce linux-patch/README.old --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/linux-patch/README.old Mon Dec 11 19:30:21 2023 +0000 @@ -0,0 +1,40 @@ +This directory contains several versions of the Linux kernel ftdi_sio driver +patch that adds support for FreeCalypso DUART28C adapter, i.e., the optional +configuration of DUART28 with boot control outputs. + +The version in the orig-202007 directory was produced at the end of 2020-07, +when DUART28 hardware was still being designed; this original version of the +patch was created to test the idea and to prove it working (using a generic +FT2232D board and an oscilloscope), and it was created with the mindset of a +hardware engineer, rather than that of Linux kernel maintainers. This original +patch version was made against kernel version 4.4.14 (the version used by the +Mother), and it predates all later mainline submission and integration attempts. + +A patch series against then-current mainline was submitted to ftdi_sio driver +maintainer Johan Hovold in 2020-09 for inclusion in mainline Linux. The +preliminary patch adding support for FreeCalypso JTAG+UART USB ID codes was +readily accepted and has since been propagated to several stable kernel branches +(4.4.240, 4.9.240, 4.14.202, 4.19.152, 5.4.72, 5.8.16, 5.9.1 and mainline 5.10), +but this patch by itself does not help in any way with DUART28C support. The +remaining two patches from the original 2020-09 patch series (a preliminary +patch fixing an oversight in the quirk interface and then the main patch of +interest) were met with resistance, however - please see the article in +doc/Linux-DTR-RTS-flaw for the full explanation. The short version is that +Linux kernel maintainers are refusing to accept our patch on the basis of their +assininity, and thus We The End Users will need to apply this patch locally on +our own systems, probably forever, or at least for the next few billion years +until the Sun swells into a red giant and engulfs the Earth. + +3 end user patch series versions are presented in minpatch-4.4.14, +minpatch-4.4.240 and minpatch-4.9.240. 4.4.240 and 4.9.240 already include the +preliminary JTAG+UART USB ID code support patch (which serves mainly as an +anchor marking the place where the new DUART28C USB ID code needs to go in +ftdi_sio_ids.h and in the ftdi_sio.c ID code table), but 4.4.14 predates this +patch by a few years, thus minpatch-4.4.14 includes a backport of this +preliminary patch as well. After this preliminary patch, each minpatch-* +version includes the quirk port_probe patch and the main patch adding DUART28C +support with the needed quirk. These latter patches are the closest version we +ever got to a mainline-acceptable state: they already underwent rounds of +revision in response to the maintainer's criticism, addressing and fixing +various nitpick issues before the whole idea got shot down on more ideological +grounds.