[PATCHv5][ 7/7] board: tbs2910: add documentation

[Soeren Moch]

On 04.06.20 06:39, Denis 'GNUtoo' Carikli wrote:
> On Sat, 30 May 2020 19:18:33 +0200
> Soeren Moch <smoch at web.de> wrote:
>
>>> +Links:
>>> +------
>>> +  -
>>> https://www.tbsdtv.com/download/document/tbs2910/TBS2910-Matrix-ARM-mini-PC-SCH_rev2.1.pdf
>>> +    - The schematics for the revision 2.1 of the TBS2910 Matrix
>>> ARM miniPC.
>>> +  -
>>> https://cache.freescale.com/files/32bit/doc/ref_manual/IMX6DQRM.pdf
>>> - The
>>> +    SoC reference manual for additional details on the BOOT_CFG
>>> registers.
>> Unfortunately this link does not work for me. Is some sort of login
>> required? Or was this moved away?
> I didn't know it has moved.
>
> The old address has been archived by archive.org/web at the following
> address:
> https://web.archive.org/web/20190826025113/https://cache.freescale.com/files/32bit/doc/ref_manual/IMX6DQRM.pdf
>
> The Linux kernel has a unique link to this document at this URL:
> http://www.nxp.com/assets/documents/data/en/reference-manuals/IMX6DQRM.pdf
>
> And it's the same since since 2017, and it was introduced by this
> commit:
>> commit e130291212df5ce8160cd2e35387c96439863ad3
>> Author: Steve Longerbeam <slongerbeam at gmail.com>
>> Date:   Sat Jun 10 16:00:29 2017 -0300
>>
>>     [media] media: Add i.MX media core driver
>>     
>>     Add the core media driver for i.MX SOC.
>>     
>>     Switch from the v4l2_of_ APIs to the v4l2_fwnode_ APIs.
>>     Add the bayer formats to imx-media's list of supported pixel and
>>     bus formats.
>>     
>>     Signed-off-by: Steve Longerbeam <steve_longerbeam at mentor.com>
>>     Signed-off-by: Philipp Zabel <p.zabel at pengutronix.de>
>>     Signed-off-by: Russell King <rmk+kernel at armlinux.org.uk>
>>     Signed-off-by: Hans Verkuil <hans.verkuil at cisco.com>
>>     Signed-off-by: Mauro Carvalho Chehab <mchehab at s-opensource.com>
> However that redirects to https://www.nxp.com/doc/IMX6DQRM which
> redirects to a login page.
AFAIK a login (free of charge, besides registering the e-mail address)
is required to download NXP documents. This way you always get the
latest document version, not a old version from some archive.

Maybe Fabio knows a better way how to reference NXP manuals? Otherwise
for this u-boot board documentation the link from linux would be fine
with me, maybe with the additional archive reference.

Soeren
> Archive.org/web has many links for that page, but I only found one of
> them to work, which is older than the archive of the link I had: 
> https://web.archive.org/web/20180829173128/https://www.nxp.com/docs/en/reference-manual/IMX6DQRM.pdf
>
> I'm not aware of any project tracking datasheet / reference manual URLs
> and versions though, but it would probably be something very useful to
> have.
>
> At some point, I plan to see if it's possible to something like that
> with Wikidata, but I'm not sure if it's fit to track datasheets URLs
> over time.
>
> Denis.