Thành công đầu tiên với CLI
Đánh giá một yêu cầu XLS nhỏ trên CPU, rồi tùy chọn xác thực phong bì tác vụ ngoại tuyến và ranh giới nguồn.
Tổng quan
Hoàn tất xác minh và cài đặt trước. Các lệnh dưới đây dùng alti từ thư mục PREFIX/bin đã cài. Chạy dưới tài khoản người dùng thông thường, không phải root.
Chạy phép đánh giá XLS CPU nhỏ
Yêu cầu này cộng hai giá trị 8 bit. Nó dùng engine XLS native có giới hạn, không cần toolchain Google, GPU hay phiên Cloud và cho thấy tràn số trong kết quả.
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
Yêu cầu mã thoát 0 và kết quả engine cho cả hai vector: bits[8]:0x0 và bits[8]:0x13. Điều này chỉ chứng minh các đầu vào này đã được đánh giá. Để hỗ trợ DSLX rộng hơn, dùng đường Google XLS.
Kiểm tra trước tác vụ ngoại tuyến tùy chọn
Quy trình sau đọc bản kê hành động và xác thực phong bì tác vụ cùng một tệp nguồn cục bộ. Nó không đọc thông tin xác thực, liên hệ máy chủ, tải nguồn lên, gửi công việc hay chạy engine RTL. Biên nhận của nó chỉ mô tả xác thực cục bộ; việc gửi và thẩm quyền máy chủ vẫn là false.
1. Kiểm tra bản kê hành động được phân phối
alti commands
Lệnh thành công ghi một mảng JSON tới stdout và không ghi gì tới stderr. Mỗi mục chứa name, description, inputSchema, executes, và class. CLI công khai hiện tại trả về 25 mục. Giá trị executes mô tả hợp đồng điều phối; lệnh vẫn có thể cần engine cục bộ, quyền tài khoản hoặc dịch vụ lưu trú.
2. Chuẩn bị nguồn cục bộ riêng
Tạo workspace riêng trong thư mục làm việc hiện tại thuộc sở hữu người dùng:
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"
Lưu nguồn vô hại này dưới tên $ALTI_WORKSPACE/inputs/rtl/top.sv:
module top(input logic clock, output logic value);
always_ff @(posedge clock) value <= ~value;
endmodule
Đặt nguồn chỉ có thể đọc và ghi bởi chủ sở hữu:
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"
Kiểm tra trước từ chối nguồn nằm ngoài workspace, có nhiều hơn một hard link, không thuộc người dùng hiện tại hoặc có thể ghi bởi nhóm hay người dùng khác. Không nới lỏng kiểm tra quyền.
Lưu nội dung sau dưới tên $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" }
}
Máy khách thay URI và digest giữ chỗ trong bản sao xác thực trong bộ nhớ bằng nguồn tương đối với workspace đã chọn và SHA-256 đã tính.
3. Tạo biên nhận ngoại tuyến
alti --json job validate \
--job "$ALTI_WORKSPACE/job.json" \
--workspace-root "$ALTI_WORKSPACE" \
--source rtl/top.sv
Kết quả thành công là một đối tượng JSON trên stdout với hợp đồng sau:
Trường | Cách hiểu bắt buộc |
|---|---|
|
|
|
|
| Phải là |
| Phải là |
| Định danh phong bì được xác thực cục bộ |
| Vị trí được yêu cầu trong phong bì, không phải bằng chứng đã gửi |
| URI nguồn tương đối với workspace đã chuẩn hóa |
| Bằng chứng nguồn được tính cục bộ |
Trạng thái thoát 0 chỉ có nghĩa kiểm tra trước máy khách này đã vượt qua. Không có nghĩa nguồn đã biên dịch, máy chủ đã chấp nhận tác vụ hay công việc nào đã chạy.
Đầu ra thất bại và trạng thái thoát
Với --json, xác thực thất bại không ghi biên nhận thành công tới stdout và ghi một đối tượng altifigence.cli.error.v1 tới stderr. Ví dụ, JSON tác vụ sai định dạng tạo ENGINE_JOB_JSON_INVALID với retryable: false và thoát với trạng thái 1.
Với kiểm tra bản kê và kiểm tra trước ngoại tuyến:
Trạng thái thoát | Ý nghĩa |
|---|---|
| Bản kê đã được in hoặc kiểm tra trước máy khách ngoại tuyến đã vượt qua |
| Lỗi registry, I/O, ranh giới nguồn hoặc xác thực tác vụ |
| Lỗi cú pháp dòng lệnh hoặc phân tích đối số |
Các lệnh alti khác dùng trạng thái thoát không nằm trong bảng này. 3 là CLASS_NOT_ALLOWED; 4 đánh dấu yêu cầu bị từ chối trước điều phối, và cả alti whoami và alti login đều thoát với mã 4 trong bản phát hành này; lệnh được engine hỗ trợ truyền nguyên trạng thái thoát engine, cộng thêm 126 khi không khởi động được engine và 127 khi không tìm thấy nó. Nếu script sẽ chạy nhiều hơn hai lệnh trên, dùng hợp đồng đầy đủ tại Tham chiếu lệnh và mặc định coi mọi trạng thái khác không là thất bại.
Giữ stdout và stderr riêng, kiểm tra trạng thái thoát trước khi phân tích biên nhận. Dùng các trang lệnh engine và Cloud để thực thi hoặc gửi tường minh; không thao tác nào diễn ra như tác dụng phụ của kiểm tra trước ngoại tuyến.
Chọn bước tiếp theo
Giữ kết quả CPU hai vector làm kiểm tra cài đặt nhanh. Để đánh giá thiết kế riêng, đổi từng đầu vào một và giữ toàn bộ yêu cầu cùng kết quả. Tính năng ngôn ngữ rộng hơn có thể cần đường Google XLS riêng; chạy CUDA cần chọn backend tường minh và thiết bị dùng được.
Với công việc RTL đồ họa, tiếp tục với Lần chạy RTL đầu tiên trong DDS. Với script, dùng Các lệnh engine. Với tệp đã lưu từ xa, đăng nhập bằng xác thực Cloud native và chọn đúng tổ chức/dự án.