Datasheet

agentee datasheet (MCP datasheet_fetch, datasheet_text, datasheet_add) scarica i datasheet dei componenti una volta in una cache condivisa da ogni progetto e agente, ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS o $XDG_CACHE_HOME la spostano), e li legge di nuovo come testo.

agentee datasheet fetch lna                    # every part of a layout or schematic
agentee datasheet fetch U3                     # one part, by reference, symbol or part number
agentee datasheet fetch TMC2209-LA
agentee datasheet fetch U3 --url https://example.com/u3.pdf
agentee datasheet text TMC2209-LA --find VS    # passages holding VS, with page and line
agentee datasheet text U3 --pages 4-6
agentee datasheet add XYZ123 ~/Downloads/xyz123.pdf --manufacturer Acme
agentee datasheet list
agentee datasheet purge                        # drop every copy no library part pins

Il datasheet di un componente viene cercato in ordine: il suo campo datasheet nello schema, l'URL datasheet del suo simbolo, poi il datasheet che ogni distributore con una chiave elenca per il suo mpn (un campo Maker MPN viene suddiviso, e un numero di parte che è l'inizio di uno elencato, come TMC2209-LA per TMC2209-LA-T, prende il suo datasheet). I download usano un user agent di browser, riprovano su HTTP 429 e 5xx, seguono una pagina HTML al PDF che linka, e rinunciano a un host che ha avuto un timeout una volta per il resto dell'esecuzione. Solo un PDF viene conservato.

Le copie vivono in MAKER/MPN/HASH.pdf con un meta.json che contiene l'URL, la fonte, il SHA-256, la data di scaricamento e la riga di revisione letta dalle sue prime o ultime pagine, in modo che un componente venga scaricato una volta e una revisione più recente stia accanto a quella vecchia. text legge una copia con pdftotext -layout e mantiene il testo accanto al PDF; non tocca mai la rete quando il componente è in cache, e lo scarica prima quando non lo è (--offline rifiuta invece). --find corrisponde a parole intere, sensibile alle maiuscole quando la parola ha maiuscole, con righe di --context attorno a ogni corrispondenza.

Un download di un progetto, o di un componente in esso, registra cosa ha usato in datasheets.toml alla radice del progetto:

[[parts]]
key = "TPS7A9101DSKR"
manufacturer = "TI"
refs = ["U9", "U24"]
url = "https://www.ti.com/lit/ds/symlink/tps7a91.pdf"
source = "symbol TPS7A91"
sha256 = "1ab38416..."
revision = "SBVS282A – DECEMBER 2016 – REVISED SEPTEMBER 2026"
fetched = "2026-10-09"

[[parts]]
key = "SPF5189Z"
refs = ["U1"]
missing = "https://www.qorvo.com/products/d/da001910: HTTP 429"

check avvisa (regola datasheet) per un componente con un mpn che non ha un URL del datasheet sul suo simbolo o componente e nessun record qui, e per un componente il cui ultimo download non ha trovato un datasheet. La correzione è il PDF dell'utente attraverso datasheet add, o un URL che funziona.