FreeCalypso > hg > freecalypso-hwlab
annotate linux-patch/README @ 163:5f9dd4056420
vbat-adc/crude-cal-test: an experiment to prove VBAT MADC linearity
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Fri, 04 Jun 2021 03:02:18 +0000 |
parents | 95c2a67e1219 |
children | b8473892b0ce |
rev | line source |
---|---|
83
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 This directory contains several versions of the Linux kernel ftdi_sio driver |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 patch that adds support for FreeCalypso DUART28C adapter, i.e., the optional |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 configuration of DUART28 with boot control outputs. |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 The version in the orig-202007 directory was produced at the end of 2020-07, |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 when DUART28 hardware was still being designed; this original version of the |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 patch was created to test the idea and to prove it working (using a generic |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 FT2232D board and an oscilloscope), and it was created with the mindset of a |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 hardware engineer, rather than that of Linux kernel maintainers. This original |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 patch version was made against kernel version 4.4.14 (the version used by the |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 Mother), and it predates all later mainline submission and integration attempts. |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12 |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 A patch series against then-current mainline was submitted to ftdi_sio driver |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 maintainer Johan Hovold in 2020-09 for inclusion in mainline Linux. The |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 preliminary patch adding support for FreeCalypso JTAG+UART USB ID codes was |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 readily accepted and has since been propagated to several stable kernel branches |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 (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), |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 but this patch by itself does not help in any way with DUART28C support. The |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 remaining two patches from the original 2020-09 patch series (a preliminary |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 patch fixing an oversight in the quirk interface and then the main patch of |
128
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
21 interest) were met with resistance, however - please see the article in |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
22 doc/Linux-DTR-RTS-flaw for the full explanation. The short version is that |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
23 Linux kernel maintainers are refusing to accept our patch on the basis of their |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
24 assininity, and thus We The End Users will need to apply this patch locally on |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
25 our own systems, probably forever, or at least for the next few billion years |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
26 until the Sun swells into a red giant and engulfs the Earth. |
83
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 3 end user patch series versions are presented in minpatch-4.4.14, |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29 minpatch-4.4.240 and minpatch-4.9.240. 4.4.240 and 4.9.240 already include the |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 preliminary JTAG+UART USB ID code support patch (which serves mainly as an |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31 anchor marking the place where the new DUART28C USB ID code needs to go in |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 ftdi_sio_ids.h and in the ftdi_sio.c ID code table), but 4.4.14 predates this |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33 patch by a few years, thus minpatch-4.4.14 includes a backport of this |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 preliminary patch as well. After this preliminary patch, each minpatch-* |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35 version includes the quirk port_probe patch and the main patch adding DUART28C |
d7a1e7a6d6ba
linux-patch: current best offering of minpatch-*
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 support with the needed quirk. These latter patches are the closest version we |
128
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
37 ever got to a mainline-acceptable state: they already underwent rounds of |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
38 revision in response to the maintainer's criticism, addressing and fixing |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
39 various nitpick issues before the whole idea got shot down on more ideological |
95c2a67e1219
doc, linux-patch: update for failure to mainline DUART28C support
Mychaela Falconia <falcon@freecalypso.org>
parents:
83
diff
changeset
|
40 grounds. |