Erster Erfolg mit der CLI
Eine kleine XLS-Anfrage auf der CPU auswerten und optional eine Offline-Job-Hülle samt Quellgrenze validieren.
Überblick
Schließen Sie zuerst Verifizierung und Installation ab. Die folgenden Befehle verwenden alti aus dem installierten Verzeichnis PREFIX/bin. Führen Sie sie als gewöhnlicher Benutzer aus, nicht als root.
Eine kleine XLS-Auswertung auf der CPU durchführen
Diese Anfrage addiert zwei 8-Bit-Werte. Sie verwendet die begrenzte native XLS-Engine, benötigt weder Google-Toolchain noch GPU oder Cloud-Sitzung und macht Überlauf im Ergebnis sichtbar.
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
Verlangen Sie Exit-Code 0 und das Engine-Ergebnis für beide Vektoren: bits[8]:0x0 und bits[8]:0x13. Dies belegt nur, dass diese Eingaben ausgewertet wurden. Für umfassendere DSLX-Sprachunterstützung verwenden Sie den separaten Google-XLS-Pfad.
Optionale Offline-Job-Vorprüfung
Der folgende Workflow liest das Aktionsmanifest und validiert eine Job-Hülle sowie eine lokale Quelldatei. Er liest keine Zugangsdaten, kontaktiert keinen Server, lädt keine Quelle hoch, reicht keine Arbeit ein und führt keine RTL-Engine aus. Sein Beleg beschreibt nur lokale Validierung; Einreichung und Serverzuständigkeit bleiben false.
1. Das ausgelieferte Aktionsmanifest untersuchen
alti commands
Ein erfolgreicher Befehl schreibt ein JSON-Array nach stdout und nichts nach stderr. Jeder Eintrag enthält name, description, inputSchema, executes und class. Die aktuelle öffentliche CLI liefert 25 Einträge. Der Wert von executes beschreibt den Dispatch-Vertrag; der Befehl kann weiterhin eine lokale Engine, Kontoberechtigung oder einen gehosteten Dienst benötigen.
2. Eine private lokale Quelle vorbereiten
Erstellen Sie einen privaten Workspace im aktuellen Arbeitsverzeichnis, das Ihrem Benutzer gehört:
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"
Speichern Sie diese harmlose Quelle als $ALTI_WORKSPACE/inputs/rtl/top.sv:
module top(input logic clock, output logic value);
always_ff @(posedge clock) value <= ~value;
endmodule
Machen Sie die Quelle nur für ihren Eigentümer les- und schreibbar:
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"
Die Vorprüfung lehnt eine Quelle ab, die außerhalb des Workspaces liegt, mehr als einmal verlinkt ist, nicht dem aktuellen Benutzer gehört oder für eine Gruppe oder andere Benutzer beschreibbar ist. Lockern Sie die Berechtigungsprüfung nicht.
Speichern Sie Folgendes als $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" }
}
Der Client ersetzt Platzhalter-URI und Digest in seiner Validierungskopie im Speicher durch die gewählte workspacerelative Quelle und den berechneten SHA-256.
3. Den Offline-Beleg erzeugen
alti --json job validate \
--job "$ALTI_WORKSPACE/job.json" \
--workspace-root "$ALTI_WORKSPACE" \
--source rtl/top.sv
Ein erfolgreiches Ergebnis ist ein JSON-Objekt auf stdout mit folgendem Vertrag:
Feld | Erforderliche Interpretation |
|---|---|
|
|
|
|
| Erforderlicher Wert: |
| Erforderlicher Wert: |
| Die Identität der lokal validierten Hülle |
| Die angeforderte Platzierung in der Hülle, kein Einreichungsnachweis |
| Die normalisierte workspacerelative Quell-URI |
| Der lokal berechnete Quellnachweis |
Exit-Status 0 bedeutet nur, dass diese Client-Vorprüfung bestanden wurde. Er bedeutet nicht, dass die Quelle kompiliert wurde, ein Server den Job akzeptiert hat oder Arbeit ausgeführt wurde.
Fehlerausgabe und Exit-Status
Mit --json schreibt eine fehlgeschlagene Validierung keinen Erfolgsbeleg nach stdout, sondern ein altifigence.cli.error.v1-Objekt nach stderr. Beispielsweise erzeugt fehlerhaftes Job-JSON ENGINE_JOB_JSON_INVALID mit retryable: false und beendet sich mit Status 1.
Für Manifestprüfung und Offline-Vorprüfung:
Exit-Status | Bedeutung |
|---|---|
| Das Manifest wurde ausgegeben oder die Offline-Client-Vorprüfung bestanden |
| Fehler im Register, bei I/O, Quellgrenzen oder Job-Validierung |
| Fehler in Befehlszeilensyntax oder Argumentverarbeitung |
Andere alti-Befehle verwenden Exit-Statuswerte, die diese Tabelle nicht aufführt. 3 ist CLASS_NOT_ALLOWED; 4 kennzeichnet eine vor dem Dispatch abgelehnte Anfrage; sowohl alti whoami als auch alti login enden in diesem Release mit 4; ein Engine-gestützter Befehl reicht den eigenen Exit-Status der Engine durch, zusätzlich 126, wenn die Engine nicht gestartet werden kann, und 127, wenn sie nicht gefunden wird. Wenn Ihr Skript jemals mehr als die beiden obigen Befehle ausführt, verwenden Sie den vollständigen Vertrag in der Befehlsreferenz und behandeln Sie standardmäßig jeden Status ungleich null als Fehler.
Halten Sie stdout und stderr getrennt und prüfen Sie den Exit-Status, bevor Sie einen Beleg parsen. Verwenden Sie die Seiten für Engine- und Cloud-Befehle für explizite Ausführung oder Einreichung; beides geschieht nicht als Nebeneffekt einer Offline-Vorprüfung.
Den nächsten Schritt wählen
Bewahren Sie das CPU-Ergebnis mit zwei Vektoren als schnelle Installationsprüfung auf. Ändern Sie zur Auswertung Ihres eigenen Designs jeweils nur eine Eingabe und behalten Sie vollständige Anfrage und Ergebnis. Eine weitergehende Sprachfunktion kann den separaten Google-XLS-Pfad benötigen; ein CUDA-Lauf erfordert explizite Backend-Auswahl und ein nutzbares Gerät.
Fahren Sie für grafische RTL-Arbeit fort mit Erster RTL-Lauf in DDS. Verwenden Sie für Skripte Engine-Befehle. Melden Sie sich für entfernt gespeicherte Dateien über native Cloud-Authentifizierung an und wählen Sie die richtige Organisation und das richtige Projekt.