[Milkymist-devel] Quick data sheet access with dsv
werner at almesberger.net
Tue Mar 6 14:24:45 PST 2012
Few things are as painful as reviewing schematics when access to
data sheets is slow. Since we have quite a bit of reviewing to do
now for M1r4, I started a database of links to data sheets (PDF) for
M1r4, for use with the "dsv" data sheet viewer .
"dsv" downloads data sheets and stores them in a local cache. After
that, "dsv" can be invoked from the shell with a suitable keyword
and then displays the corresponding data sheet. Access is from the
local cache and thus instantaneous.
"dsv" is hierarchical. It starts searching for a cache in the local
directory and if it doesn't find one or if the cache doesn't
contain the desired item, it searches under the parent directory,
and so on.
The keywords "dsv" uses are assigned when setting up the link
collection. It can be the manufacturer's part number (e.g., WM9707),
a project-specific alias (e.g., codec), or also a component
reference (e.g., U1).
The link collection is stored in a file called BOOKSHELF. I used
manually maintained BOOKSHELF files already in other projects. E.g.,
in ben-wpan 
For Milkymist, I generate BOOKSHELF from Adam's M1rc3 BOM  and
apply some updates and fixes based on a variant of the BOOKSHELF
file with a script .
For accessing data sheets, the part number or the component
reference can be used. E.g., "dsv U1" would bring up the audio
codec. Keywords are case-sensitive.
The changes are in the file SUPPLEMENT . Adam, you may find this
useful as a source for updated URLs and also for URLs that point
straight to the PDF file instead of going to some intermediate pages
that can'tbe easily downloaded.
The resulting data sheet cache is a mix of M1rc3 and M1r4, but
shouldn't contain too much misleading information. I still have a
bit more work to do there, e.g., with all the Yageo links that don't
point to a PDF, and also with a few component updates. So you may
want to git pull and make from time to time to get the latest
Once Adam finishes the M1r4 BOM, I'll regenerate the BOOKSHELF from
his file and trim SUPPLEMENT accordingly.
More information about the Devel