Prima esecuzione riuscita con la CLI
Valutare una piccola richiesta XLS sulla CPU, poi facoltativamente validare un involucro di job offline e i limiti del sorgente.
Panoramica
Completare prima verifica e installazione. I comandi seguenti usano alti della directory installata PREFIX/bin. Eseguirli come utente normale, non come root.
Eseguire una piccola valutazione XLS sulla CPU
Questa richiesta somma due valori a 8 bit. Usa il motore XLS nativo limitato, non richiede toolchain Google, GPU né sessione Cloud e rende visibile l'overflow nel risultato.
alti capabilities
alti xls eval --request - <<'JSON'
{
"schema": "altifigence.xls.operation-request.v1",
"operation": "eval",
"input_kind": "xls-ir",
"source": "package demo\ntop fn compute(x: bits[8], y: bits[8]) -> bits[8] { ret sum: bits[8] = add(x, y) }",
"top": "compute",
"backend": "cpu",
"vectors": [["255", "1"], ["0x10", "0b11"]]
}
JSON
Richiedere uscita 0 e il risultato del motore per entrambi i vettori: bits[8]:0x0 e bits[8]:0x13. Questo dimostra soltanto la valutazione di questi input. Per un supporto più ampio del linguaggio DSLX, usare il distinto percorso Google XLS.
Controllo preliminare offline facoltativo del job
Il seguente flusso legge il manifesto delle azioni e valida un involucro di job e un file sorgente locale. Non legge credenziali, non contatta server, non carica sorgenti, non invia lavoro e non esegue un motore RTL. La ricevuta descrive soltanto la validazione locale; invio e autorità server rimangono false.
1. Esaminare il manifesto delle azioni distribuito
alti commands
Un comando riuscito scrive un array JSON su stdout e nulla su stderr. Ogni voce contiene name, description, inputSchema, executes e class. La CLI pubblica corrente restituisce 25 voci. Il valore di executes descrive il contratto di inoltro; il comando può comunque richiedere un motore locale, autorizzazioni dell'account o un servizio ospitato.
2. Preparare un sorgente locale privato
Creare un'area di lavoro privata nella directory di lavoro corrente di proprietà dell'utente:
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"
Salvare questo sorgente innocuo come $ALTI_WORKSPACE/inputs/rtl/top.sv:
module top(input logic clock, output logic value);
always_ff @(posedge clock) value <= ~value;
endmodule
Rendere il sorgente leggibile e scrivibile soltanto dal proprietario:
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"
Il controllo preliminare rifiuta un sorgente esterno all'area di lavoro, collegato più di una volta, non di proprietà dell'utente corrente o scrivibile da un gruppo o da altri utenti. Non allentare il controllo delle autorizzazioni.
Salvare quanto segue come $ALTI_WORKSPACE/job.json:
{
"schema": "altifigence.engine.job.v1",
"job_id": "offline-job-1",
"operation": {
"engine_id": "rtl-engine",
"operation_id": "analyze",
"contract_id": "rtl-analysis-request.v1"
},
"execution_placement": "cloud",
"device_preference": {
"selection": { "mode": "class", "value": "cpu" },
"fallback": "deny"
},
"resources": {
"cpu_slots": 1,
"memory_bytes": 536870912,
"device_slots": 0,
"device_memory_bytes": 0,
"max_wall_time_ms": 30000
},
"inputs": [
{
"artifact_id": "rtl-source-bundle",
"role": "source_bundle",
"artifact_schema": "rtl-source-bundle.v1",
"uri": "workspace://inputs/placeholder",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000"
}
],
"cancellation": { "cancellation_id": "cancel-offline-job-1" }
}
Il client sostituisce URI e digest segnaposto nella propria copia di validazione in memoria con il sorgente selezionato relativo all'area di lavoro e lo SHA-256 calcolato.
3. Produrre la ricevuta offline
alti --json job validate \
--job "$ALTI_WORKSPACE/job.json" \
--workspace-root "$ALTI_WORKSPACE" \
--source rtl/top.sv
Un risultato riuscito è un oggetto JSON su stdout con questo contratto:
Campo | Interpretazione richiesta |
|---|---|
|
|
|
|
| Deve essere |
| Deve essere |
| L'identità dell'involucro validata localmente |
| La collocazione richiesta nell'involucro, non una prova di invio |
| L'URI sorgente normalizzato relativo all'area di lavoro |
| Le prove sul sorgente calcolate localmente |
Lo stato di uscita 0 significa soltanto che questo controllo preliminare del client è riuscito. Non significa che il sorgente sia stato compilato, che un server abbia accettato il job o che sia stato eseguito del lavoro.
Output di errore e stato di uscita
Con --json, una validazione fallita non scrive alcuna ricevuta di successo su stdout e scrive un oggetto altifigence.cli.error.v1 su stderr. Per esempio, un JSON del job malformato produce ENGINE_JOB_JSON_INVALID con retryable: false e termina con stato 1.
Per l'ispezione del manifesto e il controllo preliminare offline:
Stato di uscita | Significato |
|---|---|
| Il manifesto è stato stampato o il controllo preliminare offline del client è riuscito |
| Errore di registro, I/O, limiti del sorgente o validazione del job |
| Errore di sintassi della riga di comando o parsing degli argomenti |
Gli altri comandi alti usano stati di uscita non elencati in questa tabella. 3 è CLASS_NOT_ALLOWED; 4 indica una richiesta rifiutata prima dell'inoltro ed entrambi alti whoami e alti login terminano con 4 in questa release; un comando supportato da un motore trasmette lo stato di uscita del motore, oltre a 126 quando non è possibile avviare il motore e 127 quando non viene trovato. Se lo script eseguirà altri comandi oltre ai due sopra, usare il contratto completo in Riferimento dei comandi e trattare per impostazione predefinita ogni stato diverso da zero come errore.
Tenere separati stdout e stderr e controllare lo stato di uscita prima di analizzare una ricevuta. Usare le pagine dei comandi dei motori e Cloud per esecuzione o invio espliciti; nessuno dei due avviene come effetto collaterale del controllo preliminare offline.
Scegliere il passo successivo
Conservare il risultato CPU a due vettori come rapida verifica dell'installazione. Per valutare il proprio progetto, cambiare un input alla volta e mantenere richiesta e risultato completi. Una funzionalità più ampia del linguaggio può richiedere il distinto percorso Google XLS; un'esecuzione CUDA richiede la selezione esplicita del backend e un dispositivo utilizzabile.
Per il lavoro RTL grafico, proseguire con Prima esecuzione RTL in DDS. Per gli script, usare Comandi dei motori. Per file salvati remoti, accedere con l'autenticazione Cloud nativa e selezionare l'organizzazione/il progetto corretto.