.TH SIGROK\-CLI 1 "March 28, 2019" .SH "نام (NAME)" sigrok\-cli \- کلاینت خط فرمانی برای نرم‌افزار sigrok .SH "خلاصه دستور (SYNOPSIS)" .B sigrok\-cli [OPTIONS] [COMMAND] .SH "توضیحات (DESCRIPTION)" \fBsigrok\-cli\fP یک ابزار خط فرمانی چندسکویی برای نرم‌افزار \fBsigrok\fP است. .PP این ابزار قادر به نمایش خروجی گرافیکی نیست، اما همچنان برای طی کردن کل فرایند راه‌اندازی سخت‌افزار، دریافت داده (acquisition)، رمزگشایی پروتکل و ذخیره نشست (session) کاملاً کافی است. .PP این برنامه برای اجرا بر روی سیستم‌های راه دور یا تعبیه‌شده (embedded)، نت‌بوک‌ها، PDAها، و سناریوهای گوناگون دیگر کاربرد دارد. این ابزار می‌تواند نمونه‌ها را در خروجی استاندارد نمایش دهد یا آن‌ها را در قالب‌های مختلف فایل ذخیره کند. .SH "گزینه‌ها (OPTIONS)" .TP .B "\-h, \-\-help" نمایش متن راهنما و خروج. .TP .B "\-V, \-\-version" نمایش نگارش .B sigrok\-cli و نگارش کتابخانه‌های استفاده‌شده. .TP .B "\-L, \-\-list\-supported" نمایش اطلاعات درباره درایورهای سخت‌افزاری پشتیبانی‌شده، قالب‌های فایل ورودی، قالب‌های فایل خروجی، و رمزگشاهای پروتکل. .TP .B "\-\-list\-supported\-wiki" نمایش اطلاعات درباره رمزگشاهای پروتکل پشتیبانی‌شده با نحو (syntax) مدیاویکی. این گزینه عموماً فقط توسط توسعه‌دهندگان استفاده می‌شود تا به سادگی فهرست رمزگشاهای پروتکل پشتیبانی‌شده را در ویکی sigrok به‌روزرسانی کنند. .TP \fB\-d, \-\-driver\fP مگر در مواردی که یک پویش سراسری (global scan) انجام شود، کاربران معمولاً یکی از درایورهای در دسترس را انتخاب می‌کنند. این کار می‌تواند شروع برنامه را تسریع کند و از تطابق‌های نادرست در پیکربندی‌های مبهم جلوگیری نماید. همچنین انتخاب یک درایور امکان ارسال گزینه‌های ویژه درایور بیشتری را فراهم می‌کند. از گزینه .BR "\-L " ( "\-\-list\-supported" ")" برای دریافت فهرستی از درایورهای در دسترس استفاده کنید. .sp درایورها می‌توانند گزینه‌هایی را به شکل \fBkey=value\fP که با دونقطه (:) جدا شده‌اند دریافت کنند. .sp درایورهایی که از طریق یک درگاه سریال با سخت‌افزار ارتباط برقرار می‌کنند، همواره نیاز دارند که درگاه به عنوان گزینه \fBconn\fP مشخص شود. برای نمونه، جهت استفاده از Openbench Logic Sniffer: .sp .RB " $ " "sigrok\-cli \-\-driver=ols:conn=/dev/ttyACM0" " [...]" .sp برخی از دستگاه‌های USB از ترکیب شناسه یکتای VendorID/ProductID استفاده نمی‌کنند و بنابراین نیاز دارند که آن مورد نیز مشخص شود. توجه داشته باشید که از دونقطه برای جداسازی نام درایور از گزینه \fBconn\fP استفاده می‌شود، بنابراین نمی‌توان در داخل آرگومان گزینه \fBconn\fP از دونقطه استفاده کرد. برای انتخاب یک دستگاه USB مشخص، از \fBVendorID.ProductID\fP یا \fBbus.address\fP استفاده کنید: .sp مثال USB با \fBVendorID.ProductID\fP: .sp .RB " $ " "sigrok\-cli \-\-driver=uni\-t\-ut61e:conn=1a86.e008" " [...]" .sp مثال USB با \fBbus.address\fP: .sp .RB " $ " "sigrok\-cli \-\-driver=uni\-t\-ut61e:conn=4.6" " [...]" .TP .B "\-D, \-\-dont\-scan" در صورت عدم تعیین .BR "\-d " ( "\-\-driver" ) ، پویش خودکار برای درایورهای دستگاه انجام نشود. .TP .BR "\-c, \-\-config " فهرستی از گزینه‌های دستگاه که با دونقطه از هم جدا شده‌اند، که در آن هر گزینه به شکل .BR key=value است. استفاده چندباره از گزینه .B \-\-config پشتیبانی می‌شود. نخستین مورد در فهرست گزینه‌ها می‌تواند به شکل .B channel_group= باشد که تعیین .B \-\-channel\-group را برای این فهرست از گزینه‌ها بازنویسی (override) می‌کند. سایر فهرست‌های گزینه‌ها در کاربردهای دیگر .B \-\-config تحت تأثیر نام گروه کانال این فهرست قرار نمی‌گیرند. .sp برای نمونه، جهت تنظیم نرخ نمونه‌برداری (samplerate) روی 1MHz در دستگاهی که توسط درایور fx2lafw پشتیبانی می‌شود، می‌توانید این‌گونه مشخص کنید: .sp .RB " $ " "sigrok\-cli \-d fx2lafw \-\-config samplerate=1m" " [...]" .sp نرخ نمونه‌برداری (Samplerate) گزینه‌ای مشترک میان اکثر تحلیل‌گرهای منطقی (logic analyzers) است. آرگومان، نرخ نمونه‌برداری را بر حسب هرتز (Hz) مشخص می‌کند. همچنین می‌توانید نرخ نمونه‌برداری را بر حسب kHz ،MHz یا GHz تعیین کنید. موارد زیر همگی معادل یکدیگر هستند: .sp .RB " $ " "sigrok\-cli \-d fx2lafw \-\-config samplerate=1000000" " [...]" .sp .RB " $ " "sigrok\-cli \-d fx2lafw \-\-config samplerate=1m" " [...]" .sp .RB " $ " "sigrok\-cli \-d fx2lafw \-\-config \(dqsamplerate=1 MHz\(dq" " [...]" .sp این مثال‌ها گزینه‌ها را در یک گروه کانال مشخص می‌کنند. دو مورد نخست معادل هم هستند. .sp .RB " $ " "sigrok\-cli \-d demo \-\-channel\-group Logic \-\-config pattern=random [...]" .sp .RB " $ " "sigrok\-cli \-d demo \-\-config channel_group=Logic:pattern=random [...]" .sp .RB " $ " "sigrok\-cli \-d demo \-\-config samplerate=1m \-\-config channel_group=Logic:pattern=random [...]" .TP .BR "\-i, \-\-input\-file " بارگذاری ورودی از یک فایل به جای دستگاه سخت‌افزاری. می‌توانید برای استفاده از stdin به عنوان ورودی، "-" را مشخص کنید. اگر گزینه .B \-\-input\-format ارائه نشود، sigrok\-cli تلاش می‌کند قالب فایل ورودی را به طور خودکار تشخیص دهد. .sp مثال برای بارگذاری فایل نشست sigrok: .sp .RB " $ " "sigrok\-cli \-i example.sr" " [...]" .sp مثال برای بارگذاری یک فایل WAV (تشخیص خودکار قالب ورودی): .sp .RB " $ " "sigrok\-cli \-i example.wav" " [...] .sp مثال برای بارگذاری یک فایل VCD از stdin (تشخیص خودکار قالب ورودی): .sp .RB " $ " "cat example.vcd | sigrok\-cli \-i \-" " [...] .TP .BR "\-I, \-\-input\-format " هنگام بارگذاری یک فایل ورودی، فرض شود که فایل در قالب مشخص‌شده است. اگر این گزینه (علاوه بر .BR \-\-input\-file ) ارائه نشود، sigrok-cli تلاش می‌کند تا قالب فایل ورودی را به صورت خودکار تشخیص دهد. از گزینه .BR "\-L " ( "\-\-list\-supported" ")" برای مشاهده فهرستی از قالب‌های ورودی موجود استفاده کنید. .sp نام قالب می‌تواند به صورت اختیاری با فهرستی از گزینه‌ها که با دونقطه جدا شده‌اند دنبال شود، که در آن هر گزینه به شکل .BR "key=value" است. .sp مثال برای بارگذاری یک فایل باینری همراه با گزینه‌ها: .sp .RB " $ " "sigrok\-cli \-i example.bin" .br .BR " \-I binary:numchannels=4:samplerate=1mhz" " [...]" .TP .BR "\-o, \-\-output\-file " ذخیره خروجی در یک فایل به جای نوشتن آن در stdout. قالب پیش‌فرض استفاده‌شده هنگام ذخیره‌سازی، قالب فایل نشست sigrok است. این مقدار را می‌توان با گزینه .B \-\-output\-format تغییر داد. .sp مثال برای ذخیره داده‌ها در قالب نشست sigrok: .sp .RB " $ " "sigrok\-cli " "[...] " "\-o example.sr" .TP .BR "\-O, \-\-output\-format " تعیین قالب خروجی برای استفاده. از گزینه .BR "\-L " ( "\-\-list\-supported" ")" برای مشاهده فهرستی از قالب‌های خروجی در دسترس استفاده کنید. .sp نام قالب به صورت اختیاری می‌تواند با فهرستی از گزینه‌ها که با دونقطه جدا شده‌اند دنبال شود، که در آن هر گزینه به شکل .BR "key=value" است. .sp برای نمونه، قالب‌های .B bits یا .B hex برای نمایش بیتی ASCII یا هگزادسیمال ASCII، می‌توانند گزینه "width" را دریافت کنند که تعداد نمونه‌ها (بر حسب بیت) را برای نمایش در هر خط مشخص می‌کند. بدین ترتیب .B "\-O hex:width=128" تعداد ۱۲۸ بیت در هر خط را به صورت هگزادسیمال نمایش می‌دهد: .sp 0:ffff ffff ffff ffff ffff ffff ffff ffff 1:ff00 ff00 ff00 ff00 ff00 ff00 ff00 ff00 .sp خطوط همواره با شماره کانال (یا نام آن در صورت تعریف شدن) شروع می‌شوند و در ادامه یک دونقطه قرار می‌گیرد. اگر قالبی مشخص نشود، مقدار پیش‌فرض آن .BR bits:width=64 خواهد بود، مانند این:.sp 0:11111111 11111111 11111111 11111111 [...] 1:11111111 00000000 11111111 00000000 [...] .sp مثالی برای ذخیره داده‌ها در قالب CSV به همراه گزینه‌ها: .sp .RB " $ " "sigrok\-cli " "[...] " "\-o example.csv \-O csv:dedup:header=false" .sp توجه داشته باشید که گزینه‌های بولی (boolean) در صورت عدم تعیین مقدار، \fBtrue\fP در نظر گرفته می‌شوند. .TP .BR "\-C, \-\-channels " فهرستی جداشده با کاما از کانال‌هایی که باید در نشست استفاده شوند. .sp توجه داشته باشید که sigrok همواره کانال‌ها را بر اساس نام درج‌شده روی بدنهٔ سخت‌افزار نام‌گذاری می‌کند. اگر تحلیل‌گر منطقی (logic analyzer) شما کانال‌ها را از 0\-15 شماره‌گذاری کرده است، باید آن‌ها را با این گزینه به همان صورت مشخص کنید. کانال‌های یک اسیلوسکوپ معمولاً با نام‌هایی مانند «CH1»، «CH2» و غیره شناخته می‌شوند. از گزینهٔ \fB\-\-show\fP برای مشاهدهٔ فهرست نام کانال‌های دستگاه خود استفاده کنید. .sp حالت پیش‌فرض استفاده از تمام کانال‌های موجود در دستگاه است. می‌توانید نام یک کانال را این‌گونه مشخص کنید: .BR "1=CLK" . محدوده‌ای از کانال‌ها را نیز می‌توان به صورت .BR "1\-5" تعیین کرد. .sp مثال: .sp .RB " $ " "sigrok\-cli \-\-driver fx2lafw \-\-samples 100" .br .B " \-\-channels 1=CLK,2\-4,7" .br 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 [...] .sp فهرست جداشده با کاما از چپ به راست پردازش می‌شود، یعنی مواردی که در سمت راست‌تر قرار دارند موارد قبلی را بازنویسی (override) می‌کنند. برای مثال .B "1=CS,CS=MISO" نام کانال ۱ را به .BR "MISO" تنظیم می‌کند. .TP .BR "\-g, \-\-channel\-group " گروه کانالی را که عملیات روی آن انجام می‌شود مشخص می‌کند. برخی دستگاه‌ها کانال‌ها را در گروه‌هایی سازمان‌دهی می‌کنند که تنظیمات آن‌ها تنها به صورت گروهی قابل تغییر است. فهرست گروه‌های کانال (در صورت وجود) با دستور \fB\-\-show\fP نمایش داده می‌شود. .sp مثال‌ها: .sp .RB " $ " "sigrok\-cli \-g CH1" " [...]" .sp .RB " $ " "sigrok\-cli \-d demo \-g Logic \-c pattern=graycode" " [...]" .sp مشخص کردن گروه کانال در گزینه‌های .B \-\-get یا .B \-\-config بر نام‌های گروه کانال در .B \-\-channel\-group اولویت دارد، به طوری که یک فراخوانی واحد .B sigrok\-cli می‌تواند از پرس‌وجو یا دستکاری گزینه‌های چندگانه دستگاه که در گروه‌های کانال مختلف قرار دارند، پشتیبانی کند. .TP .BR "\-t, \-\-triggers " فهرستی جداشده با کاما از تریگرها برای استفاده، به شکل .BR "=" . می‌توانید از نام یا شمارهٔ کانال استفاده کنید، و خود تریگر دنباله‌ای از نویسه‌ها است: .sp .BR "0 or 1" : مقدار پایین (low) یا بالا (high) روی پایه. .br .BR "r or f" : مقدار بالارونده (rising) یا پایین‌رونده (falling) روی پایه. یک .B r در عمل معادل .BR 01 است. .br .BR "e" : هر نوع تغییری روی یک پایه (لبهٔ بالارونده یا پایین‌رونده). .sp همهٔ دستگاه‌ها از تمام این انواع تریگر پشتیبانی نمی‌کنند. از دستور \fB\-\-show\fP برای مشاهدهٔ تریگرهای پشتیبانی‌شده توسط دستگاه خود استفاده کنید. .TP .BR "\-w, \-\-wait\-trigger" هیچ دادهٔ نمونه‌برداری‌شده‌ای را پیش از برآورده شدن شرط تریگر خارج نکن (حتی اگر عملاً از سخت‌افزار دریافت شده باشد). به عبارت دیگر، هیچ دادهٔ پیش از تریگری (pre-trigger) در خروجی داده نشود. این گزینه زمانی مفید است که داده‌های پیش از تریگر برایتان اهمیتی ندارد (اما سخت‌افزار با این وجود آن داده‌ها را به sigrok تحویل می‌دهد). .TP .BR "\-P, \-\-protocol\-decoders " این گزینه به کاربر امکان می‌دهد فهرستی جداشده با کاما از رمزگشاهای پروتکل را برای استفاده در این نشست تعیین کند. رمزگشاها با شناسهٔ (ID) خود مشخص می‌شوند، همان‌طور که در خروجی .BR "\-L " ( "\-\-list\-supported" ")" نشان داده شده است. .sp مثال: .sp $ .B "sigrok\-cli \-i \-P i2c" .sp هر رمزگشای پروتکل می‌تواند به‌صورت اختیاری با فهرستی جداشده با دونقطه (:) از گزینه‌ها دنبال شود، که در آن هر گزینه قالب .BR "key=value" دارد. .sp مثال: .sp $ .B "sigrok\-cli \-i " .br .B " \-P uart:baudrate=115200:parity_type=odd" .sp فهرست گزینه‌های پشتیبانی‌شده کاملاً به رمزگشای پروتکل بستگی دارد. هر رمزگشای پروتکل گزینه‌های متفاوتی را پشتیبانی می‌کند. .sp هرگونه «گزینه‌ای» که برای یک رمزگشای پروتکل مشخص شود اما در عمل جزو گزینه‌های پشتیبانی‌شده نباشد، به‌عنوان انتساب نام/شماره کانال تفسیر خواهد شد. .sp مثال: .sp $ .B "sigrok\-cli \-i " .br .B " \-P spi:wordsize=9:miso=1:mosi=5:clk=3:cs=0" .sp در این مثال، .B wordsize گزینه‌ای است که توسط رمزگشای پروتکل .B spi پشتیبانی می‌شود. علاوه بر این، کاربر به sigrok اعلام می‌کند که پروتکل SPI را با استفاده از کانال ۱ به عنوان سیگنال MISO برای SPI، کانال ۵ به عنوان MOSI، کانال ۳ به عنوان CLK و کانال ۰ به عنوان سیگنال CS# رمزگشایی کند. .sp توجه داشته باشید که برنامهٔ .B sigrok\-cli از «تطبیق نام» پشتیبانی نمی‌کند. در عوض فرض می‌شود که ردها (traces) در جریان ورودی با ترتیب سیگنال‌های ورودی رمزگشا مطابقت دارند، یا اینکه کاربران صراحتاً نگاشت کانال ورودی به سیگنال رمزگشا را مشخص می‌کنند. .br .sp هنگامی که چندین رمزگشا در یک گزینهٔ .BR -P مشخص شوند، آن‌ها به ترتیبی که تعیین شده‌اند روی یکدیگر پشته‌بندی (stacked) خواهند شد. .sp مثال: .sp $ .B "sigrok\-cli \-i \-P i2c,eeprom24xx" .br $ .B "sigrok\-cli \-i \-P uart:baudrate=31250,midi" .sp هنگامی که گزینه‌های .BR -P متعددی مشخص شوند، هر یک از آن‌ها یک پشتهٔ رمزگشا ایجاد می‌کند که به موازات سایر پشته‌های رمزگشا اجرا می‌شود. .sp مثال: .sp $ .B "sigrok\-cli \-i \-P uart:tx=D0:rx=D1 \-P timing:data=D2" .sp .TP .BR "\-A, \-\-protocol\-decoder\-annotations " به‌طور پیش‌فرض، تمام خروجی‌های یادداشت‌نویسی (annotation) همهٔ رمزگشاهای پروتکل نمایش داده می‌شود. با استفاده از این گزینه می‌توان یادداشت‌های یک رمزگشای خاص را با مشخص کردن شناسهٔ رمزگشا برای نمایش انتخاب کرد: .sp $ .B "sigrok\-cli \-i \-P i2c,i2cfilter,edid \-A i2c" .sp اگر یک رمزگشای پروتکل دارای چندین کلاس یادداشت باشد، می‌توانید با مشخص کردن توضیحات کوتاه آن تعیین کنید که کدام‌یک نمایش داده شود؛ مانند زیر: .sp $ .B "sigrok\-cli \-i \-P i2c,i2cfilter,edid" .br .B " \-A i2c=data\-read".sp انتخاب چندین کلاس یادداشت‌نویسی (annotation class) با جدا کردن آن‌ها به‌وسیلهٔ دونقطه (:): .sp $ .B "sigrok\-cli \-i \-P i2c,i2cfilter,edid" .br .B " \-A i2c=data\-read:data\-write" .sp نام‌های سطر یادداشت‌نویسی به فهرست کلاس‌های مربوطه تبدیل می‌شوند. نام‌های سطر و کلاس را می‌توان به‌صورت ترکیبی استفاده کرد. در صورت وجود ابهام در نام‌ها، اولویت با نام‌های کلاس خواهد بود. .sp $ .B "sigrok\-cli \-i \-P i2c" .br .B " \-A i2c=addr\-data:warnings" .sp همچنین می‌توانید چندین رمزگشای پروتکل را، هر یک با کلاس‌های یادداشت‌نویسی انتخابیِ اختیاری، با جدا کردن آن‌ها به‌وسیلهٔ ویرگول انتخاب کنید: .sp $ .B "sigrok\-cli \-i \-P i2c,i2cfilter,edid" .br .B " \-A i2c=data\-read:data\-write,edid" .TP .BR "\-M, \-\-protocol\-decoder\-meta " در صورت مشخص شدن، خروجی فرادادهٔ (meta output) رمزگشای پروتکل را به‌جای یادداشت‌ها نمایش می‌دهد. آرگومان، نام رمزگشایی است که خروجی فرادادهٔ آن باید نمایش داده شود. .sp $ .B "sigrok\-cli \-i \-M i2c" .sp همهٔ رمزگشاها خروجی فراداده تولید نمی‌کنند. .TP .BR "\-B, \-\-protocol\-decoder\-binary " در صورت مشخص شدن، داده‌های «خام» (raw) گوناگون رمزگشا به‌جای یادداشت‌ها در خروجی استاندارد (stdout) نوشته می‌شوند (این داده‌ها می‌توانند بایت‌های خام دودویی UART/SPI، فایل‌های WAV، فایل‌های PCAP، فایل‌های PNG یا هر چیز دیگری باشند؛ این موضوع کاملاً به رمزگشا و نوع خروجی باینری متناسب برای آن بستگی دارد). .sp هیچ اطلاعات دیگری در خروجی استاندارد چاپ نمی‌شود، بنابراین برای هدایت (pipe) به برنامه‌های دیگر یا ذخیره در یک فایل مناسب است. .sp رمزگشاهای پروتکلی که از خروجی باینری پشتیبانی می‌کنند، فهرستی از کلاس‌های باینری را ارائه می‌دهند؛ برای مثال رمزگشای UART ممکن است دارای «TX» و «RX» باشد. برای انتخاب TX در خروجی، آرگومان این گزینه به شکل زیر خواهد بود: .sp $ .B "sigrok\-cli \-i \-B uart=tx" .br .sp اگر فقط رمزگشای پروتکل بدون کلاس باینری مشخص شود، تمام کلاس‌ها در خروجی استاندارد نوشته می‌شوند: .sp $ .B "sigrok\-cli \-i \-B uart" .sp (این حالت فقط در موارد نادری کاربرد دارد؛ معمولاً یک کلاس باینری خاص را که مد نظرتان است تعیین می‌کنید) .sp همهٔ رمزگشاها خروجی باینری تولید نمی‌کنند. .TP .BR "\-\-protocol\-decoder\-samplenum" در صورت مشخص شدن، یادداشت‌های رمزگشا شامل شماره نمونه‌ها (sample numbers) نیز خواهند بود. این قابلیت به مصرف‌کنندگان امکان می‌دهد اطلاعات زمان‌بندی ماشین‌خوان را دریافت کنند. .TP .BR "\-l, \-\-loglevel " سطح گزارش‌گیری (loglevel) مربوط به libsigrok و libsigrokdecode را تعیین می‌کند. در حال حاضر \fBsigrok\-cli\fP از تنظیم مستقل این دو سطح گزارش‌گیری پشتیبانی نمی‌کند. هرچه عدد بزرگ‌تر باشد، خروجی‌های اشکال‌زدایی (debug) بیشتری چاپ خواهد شد. سطوح گزارش‌گیری معتبر عبارتند از: .sp \fB0\fP None .br \fB1\fP Error .br \fB2\fP Warnings .br \fB3\fP Informational .br \fB4\fP Debug .br \fB5\fP Spew .TP .B "\-\-show" .br اطلاعات مربوط به گزینهٔ انتخاب‌شده را نمایش می‌دهد. برای مثال، جهت مشاهدهٔ گزینه‌های یک دستگاه متصل fx2lafw: .sp $ .B "sigrok\-cli \-\-driver fx2lafw \-\-show" .sp به منظور دریافت درست گزینه‌های دستگاه برای سخت‌افزار شما، ممکن است برخی درایورها نیاز به مشخص کردن یک درگاه سریال داشته باشند: .sp $ .B "sigrok\-cli \-\-driver ols:conn=/dev/ttyACM0 \-\-show" .sp این قابلیت برای رمزگشاهای پروتکل، ماژول‌های ورودی و ماژول‌های خروجی نیز کار می‌کند: .sp $ .B "sigrok\-cli \-\-protocol\-decoders i2c \-\-show" $ .B "sigrok\-cli \-\-input\-format csv \-\-show" $ .B "sigrok\-cli \-\-output\-format bits \-\-show" .sp این قابلیت همچنین برای فایل‌های ورودی، از جمله مشخصات اختیاری قالب ورودی، کار می‌کند: .sp $ .B "sigrok\-cli \-\-input\-file \-\-show" $ .B "sigrok\-cli \-\-input\-file \-\-input\-format vcd \-\-show" .TP .B "\-\-scan" پویش برای دستگاه‌هایی که می‌توانند به صورت خودکار شناسایی شوند. .sp مثال: .sp $ .B "sigrok\-cli \-\-scan" .br The following devices were found: .br demo \- Demo device with 12 channels: D0 D1 D2 D3 D4 D5 D6 D7 A0 A1 A2 A3 .br fx2lafw:conn=3.26 \- CWAV USBee SX with 8 channels: 0 1 2 3 4 5 6 7 .sp با این حال، همهٔ دستگاه‌ها قابل شناسایی خودکار نیستند (مانند دستگاه‌های مبتنی بر درگاه سریال). برای این دستگاه‌ها باید گزینهٔ \fBconn\fP را ارائه دهید، به موارد بالا مراجعه کنید. .sp $ .B "sigrok\-cli \-\-driver digitek\-dt4000zc:conn=/dev/ttyUSB0 \-\-scan" .br The following devices were found: .br Digitek DT4000ZC with 1 channel: P1 .TP .BR "\-\-time " به مدت .B میلی‌ثانیه نمونه‌برداری کرده و سپس خارج می‌شود. .sp می‌توانید به صورت اختیاری پس از عدد حرف \fBs\fP را قرار دهید تا زمان نمونه‌برداری بر حسب ثانیه مشخص شود. .sp برای مثال، .B "\-\-time 2s" به مدت دو ثانیه نمونه‌برداری خواهد کرد. .TP .BR "\-\-samples " تعداد .B نمونه را دریافت (acquire) کرده و سپس خارج می‌شود. .sp می‌توانید به صورت اختیاری پس از عدد از \fBk\fP، \fBm\fP یا \fBg\fP استفاده کنید تا تعداد نمونه‌ها را به ترتیب بر حسب کیلونمونه (kilosamples)، مگانمونه (megasamples) یا گیگانمونه (gigasamples) مشخص کنید. .sp برای مثال، .B "\-\-samples 3m" تعداد ۳۰۰۰۰۰۰ نمونه دریافت خواهد کرد. .TP .BR "\-\-frames " تعداد .B فریم را دریافت کرده و سپس خارج می‌شود. .TP .BR "\-\-continuous" نمونه‌برداری مداوم تا زمان متوقف شدن. همهٔ دستگاه‌ها از این قابلیت پشتیبانی نمی‌کنند. .TP .BR "\-\-get " مقدار .B را از دستگاه مشخص‌شده دریافت کرده و چاپ می‌کند. می‌توان چندین نام متغیر را با دونقطه (:) از هم جدا و مشخص کرد. فهرست نام‌های متغیر می‌تواند به صورت اختیاری با .B "channel_group=" شروع شود که تعریف .B \-\-channel\-group را لغو (override) می‌کند. استفاده از چندین مورد .B \-\-get در یک فراخوانی واحد .B sigrok\-cli پشتیبانی می‌شود..sp $ .B sigrok\-cli \-d demo \-\-get samplerate:averaging \-\-get channel_group=Logic:pattern .TP .BR "\-\-set" تنظیم یک یا چند متغیر مشخص‌شده با گزینهٔ \fB\-\-config\fP، بدون انجام هیچ‌گونه دریافت داده‌ای. .SH "مثال‌ها (EXAMPLES)" جهت دریافت دقیقاً ۱۰۰ نمونه از سخت‌افزار تحلیل‌گر منطقی متصل که توسط fx2lafw پشتیبانی می‌شود، دستور زیر را اجرا کنید: .TP .B " sigrok\-cli \-\-driver fx2lafw \-\-samples 100" .TP اگر می‌خواهید داده‌ها را به مدت ۳ ثانیه (۳۰۰۰ میلی‌ثانیه) نمونه‌برداری کنید، از دستور زیر استفاده کنید: .TP .B " sigrok\-cli \-\-driver fx2lafw \-\-time 3000" .TP همچنین به عنوان روش جایگزین، می‌توانید از دستور زیر استفاده کنید: .TP .B " sigrok\-cli \-\-driver fx2lafw \-\-time 3s" .TP برای ثبت داده‌ها از ۴ کانال نخست با استفاده از Openbench Logic Sniffer به مدت ۱۰۰ میلی‌ثانیه در فرکانس ۱۰ مگاهرتز با شروع از شرط تریگر 0:high، 1:rising، 2:low، 3:high، استفاده کنید از: .TP .nf \fBsigrok\-cli \-\-driver ols:conn=/dev/ttyACM0 \-\-config samplerate=10m \\\fP \fB\-\-output\-format bits \-\-channels 0\-3 \-\-wait\-trigger \\\fP \fB\-\-triggers 0=1,1=r,2=0,3=1 \-\-time 100\fP .TP برای روشن کردن ثبت وقایع داخلی روی یک دستگاه از سری Lascar EL-USB: .TP \fBsigrok\-cli \-\-driver lascar\-el\-usb:conn=10c4.0002 \\\fP \fB\-\-config datalog=on \-\-set\fP .SH "وضعیت خروج (EXIT STATUS)" .B sigrok\-cli در صورت موفقیت با 0 و در اکثر موارد شکست با 1 خارج می‌شود. .SH "همچنین ببینید (SEE ALSO)" \fBpulseview\fP(1) .SH "گزارش باگ‌ها (BUGS)" لطفاً هرگونه باگ را از طریق Bugzilla .RB "(" http://sigrok.org/bugzilla ")" یا در فهرست رایانامهٔ sigrok\-devel .RB "(" sigrok\-devel@lists.souceforge.net ")" گزارش دهید. .SH "مجوز (LICENSE)" .B sigrok\-cli تحت مجوز عمومی همگانی گنو (GPL) قرار دارد. برخی بخش‌ها تحت «GPL v2 or later» و برخی تحت «GPL v3 or later» مجوزدهی شده‌اند. .SH "نویسندگان (AUTHORS)" لطفاً فایل‌های کد منبع را به صورت جداگانه مشاهده کنید. .PP این صفحهٔ راهنما توسط Uwe Hermann نوشته شده است. این سند تحت شرایط GNU GPL (نسخهٔ ۲ یا بالاتر) مجوز دارد.