Первый успешный запуск CLI
Вычислите небольшой запрос XLS на CPU, затем при необходимости автономно проверьте оболочку задания и границу исходника.
Обзор
Сначала выполните проверку и установку. Команды ниже используют alti из установленного каталога PREFIX/bin. Выполняйте их от обычного пользователя, а не root.
Небольшое вычисление XLS на CPU
Этот запрос складывает два 8-битных значения. Он использует ограниченный нативный движок XLS, не требует инструментов Google, GPU или сеанса Cloud и показывает переполнение в результате.
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. Проверка поставляемого манифеста действий
alti commands
Успешная команда записывает один JSON-массив в stdout и ничего в stderr. Каждая запись содержит name, description, inputSchema, executes и class. Текущий публичный CLI возвращает 25 записей. Значение executes описывает контракт диспетчеризации; команде всё ещё могут требоваться локальный движок, разрешение учётной записи или размещённый сервис.
2. Подготовка частного локального исходника
Создайте частную рабочую область в текущем рабочем каталоге, принадлежащем пользователю:
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"
Сохраните этот безвредный исходник как $ALTI_WORKSPACE/inputs/rtl/top.sv:
module top(input logic clock, output logic value);
always_ff @(posedge clock) value <= ~value;
endmodule
Сделайте исходник доступным для чтения и записи только его владельцу:
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"
Предварительная проверка отклоняет исходник вне рабочей области, с несколькими жёсткими ссылками, не принадлежащий текущему пользователю или доступный для записи группе либо другим пользователям. Не ослабляйте проверку разрешений.
Сохраните следующее как $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" }
}
Клиент заменяет URI-заполнитель и дайджест в своей копии проверки в памяти выбранным исходником относительно рабочей области и вычисленным SHA-256.
3. Создание автономной квитанции
alti --json job validate \
--job "$ALTI_WORKSPACE/job.json" \
--workspace-root "$ALTI_WORKSPACE" \
--source rtl/top.sv
Успешный результат — один JSON-объект в stdout со следующим контрактом:
Поле | Обязательная интерпретация |
|---|---|
|
|
|
|
| Должно быть |
| Должно быть |
| Идентификатор локально проверенной оболочки |
| Запрошенное размещение в оболочке, а не свидетельство отправки |
| Нормализованный URI исходника относительно рабочей области |
| Локально вычисленное свидетельство исходника |
Код завершения 0 означает только успешную предварительную проверку этим клиентом. Это не означает компиляцию исходника, принятие задания сервером или выполнение работы.
Вывод ошибок и код завершения
При --json ошибка проверки не записывает квитанцию успеха в stdout и записывает один объект altifigence.cli.error.v1 в stderr. Например, некорректный JSON задания выдаёт ENGINE_JOB_JSON_INVALID с retryable: false и завершается с кодом 1.
Для проверки манифеста и автономной предварительной проверки:
Код завершения | Значение |
|---|---|
| Манифест выведен либо автономная клиентская предварительная проверка пройдена |
| Ошибка реестра, ввода-вывода, границы исходника или проверки задания |
| Ошибка синтаксиса командной строки или разбора аргументов |
Другие команды alti используют коды завершения вне этой таблицы. 3 означает CLASS_NOT_ALLOWED; 4 помечает запрос, отклонённый до диспетчеризации, и оба alti whoami и alti login завершаются с кодом 4 в этом выпуске; команда с движком передаёт его собственный код завершения, а также 126 при невозможности запуска движка и 127 при его отсутствии. Если ваш скрипт будет запускать что-либо помимо двух команд выше, используйте полный контракт из Справочника команд и по умолчанию считайте любой ненулевой код ошибкой.
Разделяйте stdout и stderr и проверяйте код завершения до разбора квитанции. Для явного выполнения или отправки используйте страницы команд движков и Cloud; ни то ни другое не происходит как побочный эффект автономной предварительной проверки.
Выбор следующего шага
Сохраните результат CPU для двух векторов как быструю проверку установки. Для вычисления собственного проекта меняйте по одному входному значению и сохраняйте полный запрос и результат. Более широкие возможности языка могут потребовать отдельного пути Google XLS; запуск CUDA требует явного выбора бэкенда и работоспособного устройства.
Для графической работы с RTL перейдите к Первому запуску RTL в DDS. Для скриптов используйте Команды движков. Для удалённых сохранённых файлов войдите через нативную аутентификацию Cloud и выберите правильную организацию/проект.