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.

Bash
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

Bash
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:

Bash
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:

SystemVerilog
module top(input logic clock, output logic value);
    always_ff @(posedge clock) value <= ~value;
endmodule

Rendere il sorgente leggibile e scrivibile soltanto dal proprietario:

Bash
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:

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

Bash
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

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

Deve essere false

server_authority_verified

Deve essere false

job_schema, job_id, operation

L'identità dell'involucro validata localmente

execution_placement

La collocazione richiesta nell'involucro, non una prova di invio

source.workspace_uri

L'URI sorgente normalizzato relativo all'area di lavoro

source.sha256, source.size_bytes

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

0

Il manifesto è stato stampato o il controllo preliminare offline del client è riuscito

1

Errore di registro, I/O, limiti del sorgente o validazione del job

2

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.