sigrok-cli - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

sigrok-cli - Máy khách dòng lệnh cho phần mềm sigrok

SYNOPSIS

sigrok-cli [TÙY CHỌN] [CHỈ HUY]

MÔ TẢ

sigrok-cli là một tiện ích dòng lệnh đa nền tảng cho ký tên phần mềm.

Nó không thể hiển thị đầu ra đồ họa, nhưng vẫn đủ để chạy qua toàn bộ
quá trình khởi tạo phần cứng, mua lại, giải mã giao thức và lưu phiên.

Nó hữu ích để chạy trên các hệ thống từ xa hoặc nhúng, netbook, PDA và các
các trường hợp sử dụng khác. Nó có thể hiển thị các mẫu trên đầu ra tiêu chuẩn hoặc lưu chúng trong các tệp khác nhau
định dạng.

LỰA CHỌN

-NS, --Cứu giúp
Hiển thị văn bản trợ giúp và thoát.

-V, --phiên bản
Hiển thị sigrok-cli phiên bản và thông tin về trình điều khiển phần cứng được hỗ trợ, đầu vào
định dạng tệp, định dạng tệp đầu ra và bộ giải mã giao thức.

-NS, --người lái xe
Phải luôn chọn trình điều khiển (trừ khi thực hiện quét toàn cục). Sử dụng -V tùy chọn để
nhận danh sách các trình điều khiển có sẵn.

Người lái xe có thể có các tùy chọn, dưới dạng key = giá trị ngăn cách nhau bằng dấu hai chấm.

Trình điều khiển giao tiếp với phần cứng thông qua cổng nối tiếp luôn cần cổng
được chỉ định như conn Lựa chọn. Ví dụ, để sử dụng Openbench Logic Sniffer:

$ sigrok-cli --driver = ols: conn = / dev / ttyACM0

Một số thiết bị USB không sử dụng kết hợp VendorID / ProductID duy nhất và do đó cần
mà cũng được chỉ định. Điều này cũng sử dụng conn tùy chọn, sử dụng một trong hai
VendorID.ProductID or xe buýt.address:

$ sigrok-cli --driver = uni-t-ut61e: conn = 1a86.e008

-NS, --config
Danh sách các tùy chọn thiết bị được phân tách bằng dấu hai chấm, trong đó mỗi tùy chọn có dạng
key = giá trị. Ví dụ: để đặt tốc độ lấy mẫu thành 1MHz trên thiết bị được hỗ trợ bởi
trình điều khiển fx2lafw, bạn có thể chỉ định

$ sigrok-cli --driver = fx2lafw --config tốc độ lấy mẫu = 1m

Tốc độ lấy mẫu là một tùy chọn phổ biến đối với hầu hết các máy phân tích logic. Đối số chỉ định
tốc độ lấy mẫu tính bằng Hz. Bạn cũng có thể chỉ định tốc độ lấy mẫu theo kHz, MHz hoặc GHz. Các
sau đây là tất cả tương đương:

$ sigrok-cli --người lái xe fx2lafw --config tốc độ lấy mẫu = 1000000

$ sigrok-cli --người lái xe fx2lafw --config tốc độ lấy mẫu = 1m

$ sigrok-cli --người lái xe fx2lafw --config "samplerate = 1 MHz "

-tôi, --tập tin đầu vào
Tải đầu vào từ tệp thay vì thiết bị phần cứng. Nếu --định dạng đầu vào tùy chọn
không được cung cấp, sigrok-cli cố gắng tự động phát hiện định dạng tệp của đầu vào
tập tin.

-TÔI, --định dạng đầu vào
Khi tải một tệp đầu vào, hãy giả sử nó ở định dạng được chỉ định. Nếu tùy chọn này là
không được cung cấp (ngoài --tập tin đầu vào), sigrok-cli cố gắng tự động phát hiện
định dạng tệp của tệp đầu vào. Sử dụng -V tùy chọn để xem danh sách các đầu vào có sẵn
định dạng.

Tên định dạng có thể được theo sau bởi một danh sách các tùy chọn được phân tách bằng dấu hai chấm,
trong đó mỗi tùy chọn có dạng key = giá trị.

-ồ, --output-tệp
Lưu kết quả đầu ra vào một tệp thay vì ghi nó vào stdout. Định dạng mặc định được sử dụng khi
lưu là định dạng tệp phiên sigrok. Điều này có thể được thay đổi với
--định dạng đầu ra tùy chọn.

-Ồ, --định dạng đầu ra
Đặt định dạng đầu ra để sử dụng. Sử dụng -V tùy chọn để xem danh sách đầu ra có sẵn
định dạng.

Tên định dạng có thể được theo sau bởi một danh sách các tùy chọn được phân tách bằng dấu hai chấm,
trong đó mỗi tùy chọn có dạng key = giá trị.

Các định dạng được hỗ trợ hiện bao gồm bit, hex, ascii, nhị phân, VCD, ols, gnuplot,
chronovu-la8, csvvà analog.

bit or hex các định dạng, cho một bit ASCII hoặc ASCII hiển thị thập lục phân, có thể có
tùy chọn "width", chỉ định số lượng mẫu (tính bằng bit) để hiển thị trên mỗi dòng.
Như vậy hex: width = 128 sẽ hiển thị 128 bit trên mỗi dòng, ở hệ thập lục phân:

0: ffff ffff ffff ffff ffff ffff ffff ffff
1: ff00 ff00 ff00 ff00 ff00 ff00 ff00 ff00

Các dòng luôn bắt đầu bằng số kênh (hoặc tên, nếu được xác định), theo sau là
Đại tràng. Nếu không có định dạng nào được chỉ định, nó sẽ mặc định là bit: width = 64, như thế này:

0: 11111111 11111111 11111111 11111111 […]
1: 11111111 00000000 11111111 00000000 […]

-NS, --kênh truyền hình
Danh sách các kênh được phân tách bằng dấu phẩy sẽ được sử dụng trong phiên.

Lưu ý rằng sigrok luôn đặt tên cho các kênh theo cách chúng được hiển thị trên
bao vây của phần cứng. Nếu máy phân tích logic của bạn đánh số các kênh từ 0-15, đó là
bạn phải chỉ định chúng như thế nào với tùy chọn này. Các kênh của máy hiện sóng sẽ
thường được gọi là "CH1", "CH2", v.v. Sử dụng --chỉ tùy chọn để xem
danh sách tên kênh cho thiết bị của bạn.

Mặc định là sử dụng tất cả các kênh có sẵn trên một thiết bị. Bạn có thể đặt tên cho một
kênh như thế này: 1 = CLK. Một loạt các kênh cũng có thể được cung cấp, dưới dạng 1-5.

Ví dụ:

$ sigrok-cli --người lái xe fx2lafw --mẫu 100
--kênh truyền hình 1 = CLK, 2-4,7
CLK: 11111111 11111111 11111111 11111111 […]
2: 11111111 11111111 11111111 11111111 […]
3: 11111111 11111111 11111111 11111111 […]
4: 11111111 11111111 11111111 11111111 […]
7: 11111111 11111111 11111111 11111111 […]

Danh sách được phân tách bằng dấu phẩy được xử lý từ trái sang phải, tức là các mục xa hơn
quyền ghi đè các mục trước đó. Ví dụ 1 = CS, CS = MISO sẽ đặt tên của
kênh 1 đến MISO.

-NS, --nhóm kênh
Chỉ định nhóm kênh để hoạt động.

Một số thiết bị sắp xếp các kênh thành các nhóm, các cài đặt chỉ có thể là
đã thay đổi với tư cách là một nhóm. Danh sách các nhóm kênh, nếu có, được hiển thị với
--chỉ chỉ huy.

-NS, --gây nên
Danh sách các trình kích hoạt được phân tách bằng dấu phẩy để sử dụng, có dạng =. Bạn
có thể sử dụng tên hoặc số của kênh và bản thân trình kích hoạt là một chuỗi
nhân vật:

0 or 1: Giá trị thấp hoặc cao trên chân.
r or f: Giá trị tăng hoặc giảm trên chốt. Một r tương ứng hiệu quả với 01.
c: Bất kỳ loại thay đổi nào trên chốt (cạnh tăng hoặc cạnh giảm).

Không phải mọi thiết bị đều hỗ trợ tất cả các loại trình kích hoạt này. Sử dụng --chỉ lệnh để xem
mà kích hoạt thiết bị của bạn hỗ trợ.

-w, - chờ kích hoạt
Không xuất bất kỳ dữ liệu mẫu nào (ngay cả khi nó thực sự nhận được từ phần cứng)
trước khi điều kiện kích hoạt được đáp ứng. Nói cách khác, không xuất bất kỳ trình kích hoạt trước nào
dữ liệu. Tùy chọn này hữu ích nếu bạn không quan tâm đến dữ liệu có trước
trigger (nhưng dù sao thì phần cứng cũng cung cấp dữ liệu này đến sigrok).

-P, --bộ giải mã giao thức
Tùy chọn này cho phép người dùng chỉ định danh sách bộ giải mã giao thức được phân tách bằng dấu phẩy
sẽ được sử dụng trong phiên này. Các bộ giải mã được chỉ định bởi ID của chúng, như được hiển thị trong
--phiên bản đầu ra.

Ví dụ:

$ sigrok-cli -i -P i2c

Mỗi bộ giải mã giao thức có thể được theo sau bởi một danh sách được phân tách bằng dấu hai chấm
tùy chọn, trong đó mỗi tùy chọn có dạng key = giá trị.

Ví dụ:

$ sigrok-cli -i
-P uart: baudrate = 115200: parity_type = lẻ

Danh sách các tùy chọn được hỗ trợ hoàn toàn phụ thuộc vào bộ giải mã giao thức. Mỗi
bộ giải mã giao thức có các tùy chọn khác nhau mà nó hỗ trợ.

Bất kỳ "tùy chọn" nào được chỉ định cho bộ giải mã giao thức không thực sự được hỗ trợ
tùy chọn, sẽ được hiểu là gán tên / số kênh.

Ví dụ:

$ sigrok-cli -i
-P spi:wordsize=9:miso=1:mosi=5:clk=3:cs=0

Trong ví dụ này, Kích thước từ là một tùy chọn được hỗ trợ bởi mũi nhọn bộ giải mã giao thức.
Ngoài ra, người dùng yêu cầu sigrok giải mã giao thức SPI bằng cách sử dụng kênh 1 như
Tín hiệu MISO cho SPI, kênh 5 là MOSI, kênh 3 là CLK và kênh 0 là CS #
tín hiệu.

-NS, --giao thức-bộ giải mã-ngăn xếp
Tùy chọn này cho phép người dùng chỉ định ngăn xếp bộ giải mã giao thức, tức là cách
đầu ra của một bộ giải mã giao thức nào được đưa vào bộ giải mã giao thức khác. Nếu như
không được chỉ định, ngăn xếp sẽ được thiết lập theo thứ tự mà giao thức
bộ giải mã đã được đưa ra với --bộ giải mã giao thức tùy chọn.

Các bộ giải mã được chỉ định bởi ID của chúng, như được hiển thị trong --phiên bản đầu ra. Trong
ngoài -S tùy chọn, tất cả các bộ giải mã giao thức được sử dụng trong một ngăn xếp, phải
cũng được chỉ định (cùng với các tùy chọn của chúng, nếu có) bằng cách sử dụng -P tham số.

Ví dụ:

$ sigrok-cli -i -P i2c: sda = 4: scl = 7, rtc8564
-S i2c, rtc8564

Trong ví dụ này, -S tùy chọn chỉ định rằng đầu ra của i2c người giải mã là
được đưa vào rtc8564 bộ giải mã, tức là, rtc8564 bộ giải mã được xếp chồng lên nhau
i2c bộ giải mã.

Các tùy chọn bộ giải mã giao thức tương ứng và chỉ định tên / số kênh phải được
đưa ra bằng cách sử dụng -P tùy chọn (bạn không thể chỉ định chúng trong -S Tùy chọn).

-MỘT, --giao thức-giải mã-chú thích
Theo mặc định, chỉ đầu ra chú thích của trình giải mã giao thức trên cùng của ngăn xếp được hiển thị.
Với tùy chọn này, một chú thích khác của trình giải mã có thể được chọn để hiển thị, bằng cách
chỉ định ID của nó:

$ sigrok-cli -i -P i2c, i2cfilter, edid -A i2c

Nếu một bộ giải mã giao thức có nhiều chú thích, bạn cũng có thể chỉ định chú thích nào trong số
chúng sẽ hiển thị bằng cách chỉ định mô tả ngắn gọn của nó như sau:

$ sigrok-cli -i -P i2c, i2cfilter, edid
-A i2c = data-read

Chọn nhiều chú thích bằng cách phân tách chúng bằng dấu hai chấm:

$ sigrok-cli -i -P i2c, i2cfilter, edid
-A i2c = data-read: data-write

Bạn cũng có thể chọn nhiều bộ giải mã giao thức, với một tùy chọn được chọn
chú thích mỗi, bằng cách phân tách chúng bằng dấu phẩy:

$ sigrok-cli -i -P i2c, i2cfilter, edid
-A i2c = data-read: data-write, edid

-l, --mức đăng nhập
Đặt libsigrok và libsigrokdecode loglevel. Ngay bây giờ sigrok-cli không
hỗ trợ thiết lập hai loglevel một cách độc lập. Số càng cao thì càng nhiều
đầu ra gỡ lỗi sẽ được in. Loglevel hợp lệ là:

0 Không áp dụng
1 lỗi
2 Cảnh báo
3 Thông tin
4 Gỡ lỗi
5 Tốc độ

--chỉ
Hiển thị thông tin về tùy chọn đã chọn. Ví dụ: để xem các tùy chọn cho một
thiết bị fx2lafw đã kết nối:

$ sigrok-cli --người lái xe fx2lafw --chỉ

Để có được các tùy chọn thiết bị phù hợp với phần cứng của bạn, một số trình điều khiển có thể cần
một cổng nối tiếp được chỉ định:

$ sigrok-cli --người lái xe ols: conn = / dev / ttyACM0 --chỉ

Để xem tài liệu về bộ giải mã giao thức:

$ sigrok-cli --bộ giải mã giao thức i2c --chỉ

--quét Quét các thiết bị có thể được phát hiện tự động.

Ví dụ:

$ sigrok-cli --quét
Các thiết bị sau đã được tìm thấy:
demo - Thiết bị demo 12 kênh: D0 D1 D2 D3 D4 D5 D6 D7 A0 A1 A2 A3
fx2lafw: conn = 3.26 - CWAV USBee SX với 8 kênh: 0 1 2 3 4 5 6 7

Tuy nhiên, không phải tất cả các thiết bị đều có thể tự động phát hiện (ví dụ như các thiết bị dựa trên cổng nối tiếp). Vì
những người bạn sẽ phải cung cấp conn tùy chọn, xem ở trên.

$ sigrok-cli --người lái xe digitek-dt4000zc: conn = / dev / ttyUSB0 --quét
Các thiết bị sau đã được tìm thấy:
Digitek DT4000ZC với 1 kênh: P1

--thời gian
Mẫu cho mili giây, sau đó thoát.

Bạn có thể tùy ý theo số bằng s để chỉ định thời gian lấy mẫu tính bằng giây.

Ví dụ, --thời gian 2s sẽ lấy mẫu trong hai giây.

--mẫu
Có được mẫu, sau đó bỏ.

Bạn có thể tùy ý theo số bằng k, m, hoặc là g để chỉ định số lượng mẫu
ở dạng kilosa sample, megasamples, hoặc gigasamples, tương ứng.

Ví dụ, --mẫu 3m sẽ thu được 3000000 mẫu.

--khung
Có được khung, sau đó thoát.

--tiếp diễn
Lấy mẫu liên tục cho đến khi dừng lại. Không phải tất cả các thiết bị đều hỗ trợ điều này.

--bộ Đặt một hoặc nhiều biến được chỉ định với --config tùy chọn, mà không cần làm bất kỳ
mua lại.

VÍ DỤ

Để lấy chính xác 100 mẫu từ máy phân tích logic được hỗ trợ fx2lafw được kết nối
phần cứng, chạy lệnh sau:

sigrok-cli --người lái xe fx2lafw --mẫu 100

Nếu bạn muốn lấy mẫu dữ liệu trong 3 giây (3000 mili giây), hãy sử dụng:

sigrok-cli --người lái xe fx2lafw --thời gian 3000

Ngoài ra, bạn cũng có thể sử dụng:

sigrok-cli --người lái xe fx2lafw --thời gian 3s

Để thu thập dữ liệu từ 4 kênh đầu tiên bằng Openbench Logic Sniffer kéo dài 100ms
ở 10 MHz bắt đầu từ điều kiện kích hoạt
0: cao, 1: tăng, 2: thấp, 3: cao, sử dụng:

sigrok-cli --người lái xe ols: conn = / dev / ttyACM0 --config tốc độ lấy mẫu = 10m \
--định dạng đầu ra bit --kênh truyền hình 0-3 - chờ kích hoạt \
--gây nên 0=1,1=r,2=0,3=1 --thời gian 100

Để bật tính năng ghi nhật ký nội bộ trên thiết bị dòng Lascar EL-USB:

sigrok-cli --người lái xe lascar-el-usb: conn = 10c4.0002 \
--config datalog = trên --bộ

EXIT TÌNH TRẠNG

sigrok-cli thoát với 0 khi thành công, 1 với hầu hết các thất bại.

Sử dụng sigrok-cli trực tuyến bằng các dịch vụ onworks.net