X-Git-Url: https://sigrok.org/gitweb/?a=blobdiff_plain;f=doc%2Fsigrok-cli.1;h=b333bee93de02f34357a80cc0929d6a1a5db58e9;hb=525f48143fc004d104b2e3fb91c6e5bb2a1064df;hp=de0093f53459a968f350bff85e41a1134ef5ba6e;hpb=c45dd41c508bd84b3886eebfa0ca4b2230b2630b;p=sigrok-cli.git diff --git a/doc/sigrok-cli.1 b/doc/sigrok-cli.1 index de0093f..b333bee 100644 --- a/doc/sigrok-cli.1 +++ b/doc/sigrok-cli.1 @@ -34,7 +34,10 @@ This is generally only used by developers to easily update the list of supported protocol decoders in the sigrok wiki. .TP \fB\-d, \-\-driver\fP -A driver must always be selected (unless doing a global scan). Use the +Unless doing a global scan, users typically select one of the available +drivers. This can speedup program start, and can avoid false matches for +ambiguous configurations. Selecting a driver also allows to pass more +driver specific options. Use the .BR "\-L " ( "\-\-list\-supported" ")" option to get a list of available drivers. .sp @@ -48,8 +51,10 @@ Openbench Logic Sniffer: .RB " $ " "sigrok\-cli \-\-driver=ols:conn=/dev/ttyACM0" " [...]" .sp Some USB devices don't use a unique VendorID/ProductID combination, and thus -need that specified as well. This also uses the \fBconn\fP option, using -either \fBVendorID.ProductID\fP or \fBbus.address\fP: +need that specified as well. Notice that colons are used to separate the +driver name from the \fBconn\fP option, thus colons cannot be used within the +\fBconn\fP option's argument. To select a specific USB device, use either +\fBVendorID.ProductID\fP or \fBbus.address\fP: .sp USB \fBVendorID.ProductID\fP example: .sp @@ -59,9 +64,25 @@ USB \fBbus.address\fP example: .sp .RB " $ " "sigrok\-cli \-\-driver=uni\-t\-ut61e:conn=4.6" " [...]" .TP +.B "\-D, \-\-dont\-scan" +Do not automatically scan for device drivers in the absence of a +.BR "\-d " ( "\-\-driver" ) +specification. +.TP .BR "\-c, \-\-config " A colon-separated list of device options, where each option takes the form .BR key=value . +Multiple occurances of the +.B \-\-config +option are supported. +The first item in the list of options can take the form +.B channel_group= +which would override the +.B \-\-channel\-group +specification for this list of options. Other option lists in other +.B \-\-config +occurances are not affected by this list's channel group name. +.sp For example, to set the samplerate to 1MHz on a device supported by the fx2lafw driver, you might specify .sp @@ -76,6 +97,15 @@ The following are all equivalent: .RB " $ " "sigrok\-cli \-d fx2lafw \-\-config samplerate=1m" " [...]" .sp .RB " $ " "sigrok\-cli \-d fx2lafw \-\-config \(dqsamplerate=1 MHz\(dq" " [...]" +.sp +These examples specify options within a channel group. +The first two are equivalent. +.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 " Load input from a file instead of a hardware device. You can specify @@ -201,6 +231,17 @@ Examples: .RB " $ " "sigrok\-cli \-g CH1" " [...]" .sp .RB " $ " "sigrok\-cli \-d demo \-g Logic \-c pattern=graycode" " [...]" +.sp +Channel group specifications in +.B \-\-get +or +.B \-\-config +options take precedence over channel group names in +.B \-\-channel\-group +so that a single +.B sigrok\-cli +invocation can support the query or manipulation of multiple device options +which reside in different channel groups. .TP .BR "\-t, \-\-triggers " A comma-separated list of triggers to use, of the form @@ -251,7 +292,7 @@ Example: $ .B "sigrok\-cli \-i " .br -.B " \-P uart:baudrate=115200:parity_type=odd" +.B " \-P uart:baudrate=115200:parity=odd" .sp The list of supported options depends entirely on the protocol decoder. Every protocol decoder has different options it supports. @@ -327,8 +368,17 @@ Select multiple annotation classes by separating them with a colon: .br .B " \-A i2c=data\-read:data\-write" .sp -You can also select multiple protocol decoders, with an optional selected -annotation class each, by separating them with commas: +Annotation row names will resolve to their respective list of classes. +Row and class names can be used in combination. When names are ambiguous +then class names take precedence. +.sp + $ +.B "sigrok\-cli \-i \-P i2c" +.br +.B " \-A i2c=addr\-data:warnings" +.sp +You can also select multiple protocol decoders, with optionally selected +annotation classes each, by separating them with commas: .sp $ .B "sigrok\-cli \-i \-P i2c,i2cfilter,edid" @@ -415,6 +465,13 @@ This also works for protocol decoders, input modules and output modules: .B "sigrok\-cli \-\-input\-format csv \-\-show $ .B "sigrok\-cli \-\-output\-format bits \-\-show +.sp +This also works for input files, including optional input format specifications: +.sp + $ +.B "sigrok\-cli \-\-input\-file \-\-show + $ +.B "sigrok\-cli \-\-input\-file \-\-input\-format vcd \-\-show .TP .B "\-\-scan" Scan for devices that can be detected automatically. @@ -477,6 +534,20 @@ Sample continuously until stopped. Not all devices support this. Get the value of .B from the specified device and print it. +Multiple variable names can be specified and get separated by colon. +The list of variable names optionally can be preceeded by +.B "channel_group=" +which would override the +.B \-\-channel\-group +specification. +Multiple +.B \-\-get +occurances are supported in a single +.B sigrok\-cli +invocation. +.sp + $ +.B sigrok\-cli \-d demo \-\-get samplerate:averaging \-\-get channel_group=Logic:pattern .TP .BR "\-\-set" Set one or more variables specified with the \fB\-\-config\fP option, without