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