Первый успешный запуск CLI

Вычислите небольшой запрос XLS на CPU, затем при необходимости автономно проверьте оболочку задания и границу исходника.

Обзор

Сначала выполните проверку и установку. Команды ниже используют alti из установленного каталога PREFIX/bin. Выполняйте их от обычного пользователя, а не root.

Небольшое вычисление XLS на CPU

Этот запрос складывает два 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

Успешная команда записывает один JSON-массив в stdout и ничего в 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

Успешный результат — один JSON-объект в stdout со следующим контрактом:

Поле

Обязательная интерпретация

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 и записывает один объект altifigence.cli.error.v1 в stderr. Например, некорректный JSON задания выдаёт ENGINE_JOB_JSON_INVALID с retryable: false и завершается с кодом 1.

Для проверки манифеста и автономной предварительной проверки:

Код завершения

Значение

0

Манифест выведен либо автономная клиентская предварительная проверка пройдена

1

Ошибка реестра, ввода-вывода, границы исходника или проверки задания

2

Ошибка синтаксиса командной строки или разбора аргументов

Другие команды alti используют коды завершения вне этой таблицы. 3 означает CLASS_NOT_ALLOWED; 4 помечает запрос, отклонённый до диспетчеризации, и оба alti whoami и alti login завершаются с кодом 4 в этом выпуске; команда с движком передаёт его собственный код завершения, а также 126 при невозможности запуска движка и 127 при его отсутствии. Если ваш скрипт будет запускать что-либо помимо двух команд выше, используйте полный контракт из Справочника команд и по умолчанию считайте любой ненулевой код ошибкой.

Разделяйте stdout и stderr и проверяйте код завершения до разбора квитанции. Для явного выполнения или отправки используйте страницы команд движков и Cloud; ни то ни другое не происходит как побочный эффект автономной предварительной проверки.

Выбор следующего шага

Сохраните результат CPU для двух векторов как быструю проверку установки. Для вычисления собственного проекта меняйте по одному входному значению и сохраняйте полный запрос и результат. Более широкие возможности языка могут потребовать отдельного пути Google XLS; запуск CUDA требует явного выбора бэкенда и работоспособного устройства.

Для графической работы с RTL перейдите к Первому запуску RTL в DDS. Для скриптов используйте Команды движков. Для удалённых сохранённых файлов войдите через нативную аутентификацию Cloud и выберите правильную организацию/проект.