Message-ID: <CAL_JsqL-wLzHmYN9Lntth3TKgpjfj3jxoGD5T49gSkDSMR=S_Q@mail.gmail.com>
Date: Tue, 9 Jul 2024 14:48:49 -0600
From: Rob Herring <robh@...nel.org>
To: Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org>
Cc: Krzysztof Kozlowski <krzk+dt@...nel.org>, Conor Dooley <conor+dt@...nel.org>, devicetree@...r.kernel.org, 
	linux-kernel@...r.kernel.org, Marek Vasut <marex@...x.de>, 
	Jonathan Cameron <jic23@...nel.org>, Sebastian Reichel <sebastian.reichel@...labora.com>
Subject: Re: [PATCH] dt-bindings: non-dt-devices: document ltr,ltrf216a used
 via ACPI PRP0001

On Tue, Jul 9, 2024 at 11:15 AM Rob Herring <robh@...nel.org> wrote:
>
> On Tue, Jul 09, 2024 at 10:44:01AM +0200, Krzysztof Kozlowski wrote:
> > There is a device in the wild with non-updatable firmware coming with
> > ACPI tables with rejected "ltr,ltrf216a" compatible.  Linux kernel still
> > supports this device via ACPI PRP0001, however the compatible was never
> > accepted to bindings.  Lack of bindings causes checkpatch.pl warning
> > about undocumented compatible.
>
> Why do we care? For checkpatch.pl I really don't. That hack check I
> wrote makes any string in binding docs a documented compatible. I have a
> better check using the schema written, but that would make checkpatch
> dependent on dtschema tools. So maybe just time to drop this check from
> checkpatch as we have other ways to check and track this.
>
> However, I do care about 'make dt_compatible_check'. Besides these ACPI
> cases, there's a bunch of cases that we'll never have schemas for. Like
> everything from Sparc... Old PowerMac stuff... So I would like to
> 'document' them just to exclude from dt_compatible_check. So perhaps
> this should be generalized.

Here's my list of what's really not documented. It's just a grep of
the bindings of each compatible found by 'make dt_compatible_check'.
Probably anything with SUNW, ibm, amcc, or mpc5 is never going to be
documented.

There are some false positives such as cases documented like "fsl,<chip>-guts".

1682m-rng
abb,socrates-nand
adi,ad2s1200
adi,ad2s1205
adi,ad7816
adi,ad7817
adi,ad7818
adi,ad9833
adi,ad9834
adi,ad9837
adi,ad9838
adi,adis16203
adi,adm1024
adi,adm1027
adi,adt7316
adi,adt7317
adi,adt7318
adi,adt7463
adi,adt7468
adi,adt7516
adi,adt7517
adi,adt7519
adi,adxl34x
adm1030
allwinner,sun4i-a10-codec-clk
allwinner,sun4i-a10-pll2-clk
allwinner,sun4i-emac
allwinner,sun50i-h6-dwc3
allwinner,sun5i-a13-pll2-clk
allwinner,sun6i-a31-ahb1-mux-clk
allwinner,sun6i-a31-display-clk
allwinner,sun7i-a20-pll4-clk
allwinner,sun8i-a33-ahb1-gates-clk
alphascale,asm9260-icoll
altr,socfpga-a10-gate-clk
altr,socfpga-a10-perip-clk
altr,socfpga-a10-pll-clock
altr,socfpga-perip-clk
amcc,ppc440epx-rng
amcc,ppc460ex-rng
amcc,ppc4xx-crypto
amcc,sata-460ex
amlogic,meson-gxl-mmc
amlogic,meson-gxm-mmc
ams,as3722-pinctrl
ams,as3722-regulator
apm,xgene2-sgenet
apm,xgene2-xgenet
apm,xgene-ahci-v2
apm,xgene-gpio-v2
apm,xgene-reboot
apm,xgene-shadowcat
arcx,anybus-controller
arm,amba-bus
arm,armv7m-nvic
arm,core-module-versatile
arm,coresight-replicator
arm,external-bus-interface
arm,integrator-cp-timer
arm,integrator-timer
aspeed,ast2400-scu-ic
aspeed,ast2600-gfx
aspeed,g4-pinctrl
aspeed,g5-pinctrl
atmel,at91rm9200-clk-main
atmel,at91rm9200-clk-main-osc
atmel,at91rm9200-clk-master
atmel,at91rm9200-clk-peripheral
atmel,at91rm9200-clk-pll
atmel,at91rm9200-clk-programmable
atmel,at91rm9200-clk-system
atmel,at91rm9200-clk-usb
atmel,at91rm9200-usart-serial
atmel,at91sam9260-clk-slow
atmel,at91sam9261-pmc
atmel,at91sam9263-pmc
atmel,at91sam9g20-clk-pllb
atmel,at91sam9g45-clk-pll
atmel,at91sam9g45-clk-programmable
atmel,at91sam9n12-clk-usb
atmel,at91sam9rl-dma
atmel,at91sam9rl-ssc
atmel,at91sam9x5-clk-main
atmel,at91sam9x5-clk-main-rc-osc
atmel,at91sam9x5-clk-master
atmel,at91sam9x5-clk-peripheral
atmel,at91sam9x5-clk-plldiv
atmel,at91sam9x5-clk-programmable
atmel,at91sam9x5-clk-smd
atmel,at91sam9x5-clk-usb
atmel,at91sam9x5-clk-utmi
atmel,atmel_mxt_tp
atmel,atmel_mxt_ts
atmel,mXT224
atmel,qt602240_ts
atmel,sama5d2-clk-audio-pll-frac
atmel,sama5d2-clk-audio-pll-pad
atmel,sama5d2-clk-audio-pll-pmc
atmel,sama5d2-clk-generated
atmel,sama5d2-clk-i2s-mux
atmel,sama5d2-sfr
atmel,sama5d3-adc
atmel,sama5d3-clk-pll
atmel,sama5d3-tcb
atmel,sama5d4-clk-h32mx
atmel,sama5d4-sfr
atmel,samx7-rstc
audio-graph-card2-custom-sample
bcm,kona-sdhci
bcm,kona-smc
bcm,kona-timer
bmac+
bosch,bmp181
bq4802
brcm,40nm-ephy
brcm,bcm58535-srab
brcm,bcm7125-sun-top-ctrl
brcm,bcm7211-dpfe-cpu
brcm,bcm7278-dpfe-cpu
brcm,bcm7346-sun-top-ctrl
brcm,bcm7358-sun-top-ctrl
brcm,bcm7360-sun-top-ctrl
brcm,bcm7362-sun-top-ctrl
brcm,bcm7420-sun-top-ctrl
brcm,bcm7425-sun-top-ctrl
brcm,bcm7429-sun-top-ctrl
brcm,bcm7435-sun-top-ctrl
brcm,brcmstb-sun-top-ctrl
brcm,ehci-brcm-v2
brcm,vc4-v3d
broadcom,bcm5241
buffalo,ls421d
buffalo,ls421de
cavium,mdio-mux
cavium,mdio-mux-sn74cbtlv3253
cdns,pc302-gem
cdns,xtfpga-clock
chrp,mesh0
compat2
compat3
dallas,max6654
dlg,da9053-ba
dlg,da9053-bc
ds1287
electra-cf
epapr,hv-byte-channel
epson,rx8803
fcu
fsl,1s1021a-msi
fsl,1s1043a-msi
fsl,avic
fsl,b4860-l3-cache-controller
fsl,bsc9131-guts
fsl,bsc9132-guts
fsl,elbc-fcm-nand
fsl,ep8248e-bcsr
fsl,ep8248e-mdio-bitbang
fsl,icoll
fsl,imx1-dma
fsl,imx1-iomuxc
fsl,imx21-dma
fsl,imx21-nand
fsl,imx25-iomuxc
fsl,imx25-nand
fsl,imx51-ipu
fsl,imx51-nand
fsl,imx53-nand
fsl,imx53-tve
fsl,imx6q-ipu
fsl,imx6q-mlb150
fsl,imx8qm-ahci
fsl,ls1021a-esdhc
fsl,ls1028a-ahci
fsl,ls1043a-ahci
fsl,ls1046a-ahci
fsl,ls1088a-ahci
fsl,ls2080a-ahci
fsl,ls2088a-ahci
fsl,lx2160a-ahci
fsl,mc34708
fsl,mpc5121-fec
fsl,mpc5121-fec-mdio
fsl,mpc5121-gpio
fsl,mpc5121-localbus
fsl,mpc5121-mbx
fsl,mpc5121-nfc
fsl,mpc5121-pci
fsl,mpc5121-rtc
fsl,mpc5121-sdhc
fsl,mpc5121-sram
fsl,mpc5125-fec
fsl,mpc5125-psc-spi
fsl,mpc5125-psc-uart
fsl,mpc5200b-mdio
fsl,mpc5200b-psc-ac97
fsl,mpc5200b-psc-i2s
fsl,mpc5200b-psc-uart
fsl,mpc5200-mdio
fsl,mpc5200-sram
fsl,mpc8272-cpm-usb
fsl,mpc8379-esdhc
fsl,mpc8536-guts
fsl,mpc8544-guts
fsl,mpc8548-pcie
fsl,mpc8568-guts
fsl,mpc8569-guts
fsl,mpc8572-guts
fsl,mpc8610-pci
fsl,mpc8641-pcie
fsl,p1010-esdhc
fsl,p1010-guts
fsl,p1010-pcie
fsl,p1020-guts
fsl,p1021-guts
fsl,p1022-guts
fsl,p1022-pcie
fsl,p1023-guts
fsl,p1023-pcie
fsl,p2020-guts
fsl,p4080-l3-cache-controller
fsl,p4080-pcie
fsl,pq1-fec-enet
fsl,pq2pro-localbus
fsl,pq3-gpio
fsl,pq3-localbus
fsl,pq-sata-v2
fsl,qoriq-pcie
fsl,qoriq-pcie-v2.1
fsl,qoriq-pcie-v2.2
fsl,qoriq-pcie-v2.3
fsl,qoriq-pcie-v2.4
fsl,qoriq-pcie-v3.0
fsl,sec4.0
fsl,sec4.0-job-ring
fsl,t4240-l3-cache-controller
fsl,timrot
fsl,tzic
fsl,vf610-pit
fsl,vmpic-msi
fsl,vmpic-msi-v4.3
fujitsu,coral
fujitsu,lime
fujitsu,MB86276
fujitsu,MB86277
fujitsu,MB86293
fujitsu,MB86294
fujitsu,mint
gef,fpga-wdt
gef,sbc310-gpio
gef,sbc610-gpio
ge,imp3a-gpio
gen_nand
giantplus,gpg482739qs5
google,arche-platform
gpio-mockup
gpio-simulator
grmn,lidar-lite-v3
hawk-bridge
heathrow-media-bay
himax,hx8369
hisilicon,hi3670-dwc3
hisilicon,hi3798mv100-usb2-phy
hisilicon,hip04-clock
hisilicon,hip04-intc
hisilicon,histb-rng
hisilicon,usbhub
honeywell,hih6130
i2cpcf,8584
ibm,axon-msic
ibm,coherent-platform-facility
ibm,ebc
ibm,fsi2pib
ibm,i2cr-scom
ibm,iic
IBM,lhca
IBM,lhea
IBM,lhea-ethernet
ibm,opal-console-hvsi
ibm,opal-console-raw
ibm,opal-flash
ibm,opal-ipmi
ibm,opal-prd
ibm,opb
ibm,plb3
ibm,plb4
ibm,plb6
ibm,pmemory
ibm,pmemory-v2
ibm,power-rng
ibm,ppc4xx-spi
ibm,sdram-4xx-ddr2
ibm,secureboot
ibm,secureboot-v1
ibm,secureboot-v2
ibm,secvar-backend
ibm,tah
idt,82p33811
idt,8v19n850
idt,8v19n851
ingenic,jz4725b-bch
ingenic,jz4740-ecc
ingenic,jz4780-bch
ingenic,x2000h
inside-secure,safexcel-eip197c-mxl
intel,i8259
intel,lgm-asc
invensense,icp10100
invensense,itg3200
invn,mpu3050
isa-m5819p
isa-m5823p
isl,isl12022
isl,isl29028
isl,isl9305
isl,isl9305h
keylargo-media-bay
lantiq,ase-pinctrl
lantiq,dcdc-xrx200
lantiq,gptu-xway
lantiq,icu
lantiq,nand-xway
lantiq,nor
lantiq,pci-xway
lantiq,sflash-falcon
lantiq,vmmc-xway
lantiq,xrx100-pinctrl
lantiq,xrx200a1x-gphy-fw
lantiq,xrx200a2x-gphy-fw
lantiq,xrx200-pinctrl
lantiq,xrx300-pinctrl
linux,spi-loopback-test
liteon,ltr303
lltc,ltc7132
lm87cimt
ltr,ltrf216a
m5819
mailbox-test
marvell,88E1111
marvell,88e1116
marvell,88e1118
marvell,88e1145
marvell,88e1149r
marvell,88e1310
marvell,88E1510
marvell,88E1514
marvell,ap806-system-controller
marvell,armada-3700-rwtm-firmware
marvell,armada-380-ahci
marvell,armada-38x-uart
marvell,cp110-system-controller0
marvell,mv88f6710-pinctrl
marvell,mv88f6720-pinctrl
marvell,mv88f6810-pinctrl
marvell,mv88f6820-pinctrl
marvell,mv88f6828-pinctrl
marvell,mv88f6920-pinctrl
marvell,mv88f6925-pinctrl
marvell,mv88f6928-pinctrl
marvell,pxa1928-gpio
marvell,pxa250-core-clocks
marvell,pxa25x-pinctrl
marvell,pxa270-clocks
marvell,pxa27x-pinctrl
marvell,pxa300-clocks
marvell,pxa-intc
marvell,pxa-timer
max6690
maxim,max20710
maxim,max30208
maxim,max3100
maxim,max31785b
maxim,max6639
maxim,max7318
mediatek,mt6660
mediatek,mt6765-cqdma
mediatek,mt6765-pinctrl
mediatek,mt6779-audio
mediatek,mt6873-dvfsrc
mediatek,mt7620-pci
mediatek,mt7623-moore-pinctrl
mediatek,mt8167-disp-aal
mediatek,mt8167-disp-ccorr
mediatek,mt8167-disp-dither
mediatek,mt8167-disp-gamma
mediatek,mt8167-disp-ovl
mediatek,mt8167-disp-rdma
mediatek,mt8176
mediatek,mt817x
mediatek,mt8183-audiosys
mediatek,mt8183-dvfsrc
mediatek,mt8188-vpp-mutex
mediatek,mt8192-dvfsrc
microchip,lan9354-mdio
microchip,pic32mzda-infra
microchip,sama7g5-ohci
microchip,sama7g5-sdhci
microcrystal,rv2123
moxa,moxart-ic
moxa,moxart-mdio
moxa,moxart-rtl8201cp
mpc5200b-fec-phy
mpc5200-serial
mpc5200-sram
mps,mp2629_adc
mps,mp2629_charger
mps,mp5023
mrvl,pwri2c
mti,ranchu
national,lm64
national,lm85b
national,lm85c
national,lm95235
national,lm95245
national,lm96163
nintendo,latte-exi
nvidia,tegra114-apbdma
nvidia,tegra114-kbc
nvidia,tegra114-mc
nvidia,tegra124-mipi
nvidia,tegra132-emc
nvidia,tegra132-mc
nvidia,tegra132-mipi
nvidia,tegra132-pmc
nvidia,tegra148-apbdma
nvidia,tegra194-hte-test
nvidia,tegra210-ictlr
nvidia,tegra210-mc
nvidia,tegra239-ccplex-cluster
nvidia,tegra30-apbdma
nvidia,tegra30-kbc
nxp,isp1707
nxp,rtc-pcf2123
nxp,uda1380
ohare-media-bay
ohare-swim3
ohci-bigendian
ohci-le
ohci-littledian
omapdss,composite-video-connector
omapdss,dvi-connector
omapdss,hdmi-connector
omapdss,lgphilips,lb035q02
omapdss,nec,nl8048hl11
omapdss,panel-dpi
omapdss,panel-dsi-cm
omapdss,sharp,ls037v7dw01
omapdss,sony,acx565akm
omapdss,svideo-connector
omapdss,ti,opa362
omapdss,ti,tfp410
omapdss,ti,tpd12s015
omapdss,toppoly,td028ttec1
omapdss,tpo,td028ttec1
omapdss,tpo,td043mtea1
onnn,nct214
onnn,nct218
onnn,nct72
onnn,pca9655
opencores,ocfb
pasemi,localbus
pasemi,localbus-nand
pasemi,pwrficient-rng
pasemi,sdc
pciex108e,80f0
phytec,pcm030-audio-fabric
picochip,pc3x2-rtc
picochip,pc3x2-timer
pmem-region-v2
ppc4xx-rng
qca,qca9530-pll
qca,qca9560-pll
qcom,adreno-3xx
qcom,gcc-mdm9615
qcom,kgsl-3d0
qcom,mdss_mdp
qcom,sc7180-ipa-virt
qcom,sc7180-qmp-usb3-phy
qcom,sc8180x-dpu
qcom,sc8180x-ipa-virt
qcom,sc8180x-mdss
qcom,sc8180x-qmp-usb3-phy
qcom,sdm845-qmp-usb3-phy
qcom,sdx55-ipa-virt
qcom,sm8150-camnoc-virt
qcom,sm8150-ipa-virt
qcom,sm8150-qmp-usb3-phy
qcom,sm8250-ipa-virt
qcom,sm8250-qmp-usb3-phy
qcom,sm8350-qmp-gen3x2-pcie-phy
qcom,sm8350-qmp-usb3-phy
qcom,sm8450-qmp-usb3-phy
qcom,usb-snps-femto-v2-phy
qt1070
ralink,mt7620a-memc
ralink,rt2880-memc
ralink,rt2880-pinmux
ralink,rt2880-reset
ralink,rt288x-pci
ralink,rt3050-memc
ralink,rt3883-memc
raspberrypi,sensehat-joystick
realtek,rt1305
realtek,rt1306
regulator-virtual-consumer
renesas,cmt-48
renesas,cmt-48-gen2
renesas,mlp
rockchip,rk3366-tsadc
rohm,bh1780gli
sab82532
sgx,vz89te
sgy,gpio-halt
silabs,si544a
silabs,si544c
smsc,emc6d100
smsc,emc6d101
smsc,emc6d102
smsc,emc6d103
smsc,emc6d103s
smsc,lan91c94
smu-sat
snps,archs-timer-gfrc
snps,archs-timer-rtc
socionext,mn884433
socionext,mn884434-0
socionext,mn884434-1
sprd,sc9860-dwc3
sprd,sc9860-suspend-timer
st,6556002
stericsson,ab8500-ponkey
st-ericsson,u8540
st-ericsson,u9540
st,iis2mdc
st,nomadik-src-clock
st,pm6764tr
st,rv4162
st,spear-plgpio
st,st21nfca_i2c
st,st21nfcb_i2c
st,sta529
st,stih407-compositor
st,stih407-flash-pinctrl
st,stih407-front-pinctrl
st,stih407-hda
st,stih407-hdmi
st,stih407-rear-pinctrl
st,stih407-tvout
st,stih416-mpe-thermal
st,sti-pwm
st,stmpe1801
st,stmpe610
st,stw4810
st,stw4811
st,stw481x-vmmc
sun4v
SUNW,bbc-beep
SUNW,bbc-i2c
SUNW,CS4231
SUNW,ebus-pic16f747-env
SUNW,kt-cwq
SUNW,kt-mau
SUNW,n2-cwq
SUNW,n2-mau
SUNW,niusl
SUNW,smbus-beep
SUNW,sun4v-console
SUNW,sun4v-pci
SUNW,vf-cwq
SUNW,vf-mau
swim3
synaptics,synaptics_i2c
tcs,tcs4526
test-device
ti,741g74
ti,am33xx-ecap
ti,am33xx-ehrpwm
ti,bq24157s
ti,cd9200
ti,cd9220
ti,cd9222
ti,cd9224
ti,cd9240
ti,cd9244
ti,cd9246
ti,cd9248
ti,dm6441-mmc
ti,dm814-pllss
ti,dm814-scm
ti,drv2604l
ti,emif-4d5
ti,musb-dm816
ti,omap2420-sdma
ti,omap2430-sdma
ti,omap3430-sdma
ti,omap3630-sdma
ti,omap3-sham
ti,omap5-usb2
ti,omap-infra
ti,tlv320aic23
ti,tps53647
ti,tps53667
ti,tps53681
ti,tps546d24
ti,tps65217-bl
ti,tps65218-gpio
ti,tps80036-pmic
ti,twl4030-power-omap3-evm
ti,twl4030-power-omap3-ldp
ti,twl4030-power-omap3-sdp
ti,ucd9000
ti,ucd90120
ti,ucd90124
ti,ucd90160
ti,ucd9090
ti,ucd90910
toppoly,td028ttec1
toshiba,apb-dummy-codec
ucc_uart
unittest-gpio
unittest-pci
via,vt8500-ehci
virtio,uml
wm,prizm-ehci
wm,wm8750-pinctrl
wrs,epld-localbus
xlnx,axi4-os62420_3pin-1.00.a
xlnx,axi4-os62420_6pin-1.00.a
xlnx,axi-fifo-mm-s-4.1
xlnx,opb-intc-1.00.c
xlnx,plb-dvi-cntlr-ref-1.00.c
xlnx,plb-tft-cntlr-ref-1.00.a
xlnx,xillybus-1.00.a
xlnx,xps-intc-1.00.a
xlnx,xps-ll-temac-1.01.b
xlnx,xps-ll-temac-2.00.a
xlnx,xps-ll-temac-2.02.a
xlnx,xps-ll-temac-2.03.a
xlnx,xps-ps2-1.00.a
xlnx,xps-tft-1.00.a
xlnx,xps-tft-2.00.a
xlnx,xps-tft-2.01.a
xlnx,xps-usb-host-1.00.a
zte,zx296718-reset

Powered by blists - more mailing lists