CLI की पहली सफलता

CPU पर छोटा XLS अनुरोध मूल्यांकित करें, फिर वैकल्पिक रूप से ऑफ़लाइन जॉब एनवेलप और स्रोत सीमा सत्यापित करें।

परिचय

पहले सत्यापन और इंस्टॉलेशन पूरा करें। नीचे के कमांड इंस्टॉल alti का उपयोग PREFIX/bin डायरेक्टरी से करते हैं। उन्हें सामान्य उपयोगकर्ता के रूप में चलाएँ, root के रूप में नहीं।

छोटा CPU XLS मूल्यांकन चलाएँ

यह अनुरोध दो 8-बिट मान जोड़ता है। यह सीमित नेटिव XLS इंजन उपयोग करता है, Google टूलचेन, GPU या Cloud सत्र नहीं माँगता और परिणाम में ओवरफ़्लो दिखाता है।

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

निकास 0 और दोनों वेक्टर के इंजन परिणाम अनिवार्य रूप से जाँचें: bits[8]:0x0 और bits[8]:0x13। इससे केवल इन इनपुट के मूल्यांकित होने का प्रमाण मिलता है। अधिक व्यापक DSLX भाषा समर्थन के लिए अलग Google XLS मार्ग उपयोग करें।

वैकल्पिक ऑफ़लाइन जॉब पूर्व-जाँच

निम्न वर्कफ़्लो कार्रवाई मैनिफ़ेस्ट पढ़ता है और जॉब एनवेलप के साथ एक स्थानीय स्रोत फ़ाइल सत्यापित करता है। यह क्रेडेंशियल नहीं पढ़ता, सर्वर से संपर्क नहीं करता, स्रोत अपलोड नहीं करता, कार्य सबमिट नहीं करता और RTL इंजन नहीं चलाता। इसकी रसीद केवल स्थानीय सत्यापन बताती है; सबमिशन और सर्वर अधिकार false रहते हैं।

1. दिए गए कार्रवाई मैनिफ़ेस्ट की जाँच करें

Bash
alti commands

सफल कमांड stdout पर एक JSON ऐरे लिखता है और stderr पर कुछ नहीं। हर प्रविष्टि में name, description, inputSchema, executes, और class होते हैं। वर्तमान सार्वजनिक CLI 25 प्रविष्टियाँ लौटाता है। executes का मान डिस्पैच अनुबंध बताता है; कमांड को अब भी स्थानीय इंजन, खाता अनुमति या होस्ट की गई सेवा की ज़रूरत हो सकती है।

2. निजी स्थानीय स्रोत तैयार करें

अपनी वर्तमान उपयोगकर्ता स्वामित्व वाली कार्य डायरेक्टरी में निजी वर्कस्पेस बनाएँ:

Bash
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"

यह हानिरहित स्रोत $ALTI_WORKSPACE/inputs/rtl/top.sv के रूप में सहेजें:

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

स्रोत केवल उसके स्वामी के लिए पढ़ने और लिखने योग्य बनाएँ:

Bash
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"

पूर्व-जाँच ऐसे स्रोत को अस्वीकार करती है जो वर्कस्पेस से बाहर हो, एक से अधिक लिंक वाला हो, वर्तमान उपयोगकर्ता का न हो या समूह अथवा अन्य उपयोगकर्ताओं द्वारा लिखने योग्य हो। अनुमति जाँच ढीली न करें।

निम्न सामग्री $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" }
}

क्लाइंट अपनी मेमोरी में मौजूद सत्यापन कॉपी के प्लेसहोल्डर URI और डाइजेस्ट को चुने हुए वर्कस्पेस सापेक्ष स्रोत तथा गणना किए SHA-256 से बदलता है।

3. ऑफ़लाइन रसीद बनाएँ

Bash
alti --json job validate \
  --job "$ALTI_WORKSPACE/job.json" \
  --workspace-root "$ALTI_WORKSPACE" \
  --source rtl/top.sv

सफल परिणाम stdout पर इस अनुबंध वाला एक JSON ऑब्जेक्ट है:

फ़ील्ड

आवश्यक व्याख्या

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

यह होना चाहिए: false

server_authority_verified

यह होना चाहिए: false

job_schema, job_id, operation

स्थानीय रूप से सत्यापित एनवेलप पहचान

execution_placement

एनवेलप में माँगा गया प्लेसमेंट, सबमिशन का प्रमाण नहीं

source.workspace_uri

सामान्यीकृत वर्कस्पेस सापेक्ष स्रोत URI

source.sha256, source.size_bytes

स्थानीय रूप से गणना किया स्रोत प्रमाण

निकास स्थिति 0 केवल इस क्लाइंट की पूर्व-जाँच सफल होने का अर्थ है। इसका अर्थ स्रोत संकलित होना, सर्वर द्वारा जॉब स्वीकार करना या कोई कार्य चलना नहीं है।

विफलता आउटपुट और निकास स्थिति

विकल्प --json के साथ, सत्यापन विफलता stdout पर सफलता रसीद नहीं लिखती और stderr पर एक altifigence.cli.error.v1 ऑब्जेक्ट लिखती है। उदाहरण के लिए, विकृत जॉब JSON ENGINE_JOB_JSON_INVALID के साथ retryable: false देता है और स्थिति 1 से बाहर निकलता है।

मैनिफ़ेस्ट निरीक्षण और ऑफ़लाइन पूर्व-जाँच के लिए:

निकास स्थिति

अर्थ

0

मैनिफ़ेस्ट छपा या ऑफ़लाइन क्लाइंट पूर्व-जाँच सफल हुई

1

रजिस्ट्री, I/O, स्रोत सीमा या जॉब सत्यापन विफलता

2

कमांड लाइन सिंटैक्स या तर्क पार्सिंग विफलता

अन्य alti कमांड वे निकास स्थितियाँ उपयोग करते हैं जो इस तालिका में नहीं हैं। 3 का अर्थ CLASS_NOT_ALLOWED है; 4 डिस्पैच से पहले अस्वीकृत अनुरोध दर्शाता है, और इस रिलीज़ में alti whoami तथा alti login दोनों 4 से बाहर निकलते हैं; इंजन आधारित कमांड इंजन की अपनी निकास स्थिति आगे देता है, साथ ही इंजन शुरू न हो सके तो 126 और इंजन न मिले तो 127 देता है। आपकी स्क्रिप्ट कभी भी ऊपर के दो कमांड से अधिक चलाएगी तो कमांड संदर्भ का पूरा अनुबंध उपयोग करें और डिफ़ॉल्ट रूप से हर गैर-शून्य स्थिति को विफलता मानें।

stdout और stderr अलग रखें और रसीद पार्स करने से पहले निकास स्थिति जाँचें। स्पष्ट निष्पादन या सबमिशन के लिए इंजन तथा Cloud कमांड पृष्ठ उपयोग करें; ऑफ़लाइन पूर्व-जाँच के सह-प्रभाव के रूप में इनमें से कोई नहीं होता।

अगला चरण चुनें

दो वेक्टर वाला CPU परिणाम त्वरित इंस्टॉलेशन जाँच के रूप में रखें। अपने डिज़ाइन का मूल्यांकन करने के लिए एक बार में एक इनपुट बदलें और पूरा अनुरोध तथा परिणाम रखें। व्यापक भाषा सुविधा को अलग Google XLS मार्ग चाहिए हो सकता है; CUDA रन के लिए स्पष्ट बैकएंड चयन और उपयोग योग्य डिवाइस चाहिए।

ग्राफ़िकल RTL कार्य के लिए DDS की पहली RTL रन से आगे बढ़ें। स्क्रिप्ट के लिए इंजन कमांड उपयोग करें। रिमोट सहेजी गई फ़ाइलों के लिए नेटिव Cloud प्रमाणीकरण से साइन इन करें और सही संगठन/प्रोजेक्ट चुनें।