Input output formats

From sigrok
Revision as of 00:08, 25 April 2011 by Uwe Hermann (talk | contribs) (ChronoVu LA8 input/output format.)
Jump to navigation Jump to search

Input formats

Logic analyzer

TODO

Binary

Raw, binary input format without any metadata.

sigrok session

TODO

ChronoVu LA8

See below.

Output formats

sigrok session

TODO

Bits

$ sigrok-cli --samples 1000 -f bits
Acquisition with 8/8 probes at 200 KHz
1:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
2:00000000 00011111 11111111 11100000 00000000 00011111 11111111 11110000 
3:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
4:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
5:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
6:01111000 01001100 01111100 01100000 00011100 01101100 00011100 00100011 
7:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
8:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
1:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
2:00000000 00001111 11111111 11110000 00000000 00000111 11111111 11111000 
3:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
4:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
5:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
6:00011110 00100111 00001110 00110000 01001110 00110010 01101110 00010000 
7:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
8:11111111 11111111 11111111 11111111 11111111 11111111 11111111 11111111 
[...]

ASCII

$ sigrok-cli -d 0 --time 10 -p 1,2 -o samplerate=1M -f ascii
Acquisition with 2/16 probes at 1 MHz
1:/""""""""\.........../""""""""\.........../""""""""\.........../""""""""\.
2 :........../"""""""""""""""""""\...................../"""""""""""""""""""\.
1:........./"""""""""\........../"""""""""\........../"""""""""\........../"
2:..................../"""""""""""""""""""\..................../""""""""""""
1:""""""""\........../""""""""\.........../""""""""\.........../""""""""\...
2:"""""""\...................../"""""""""""""""""""\...................../""
1:......../""""""""\........../"""""""""\........../"""""""""\........../"""
2:"""""""""""""""""\...................../"""""""""""""""""""\..............
1:""""""\........../"""""""""\........../""""""""\.........../""""""""\.....
2:....../"""""""""""""""""""\...................../"""""""""""""""""""\.....

Hex

$ sigrok-cli --samples 1000 -f hex
Acquisition with 8/8 probes at 200 KHz
1:ff ff ff ff ff ff ff ff 
2:00 7f ff c0 00 3f ff c0 
3:ff ff ff ff ff ff ff ff 
4:ff ff ff ff ff ff ff ff 
5:ff ff ff ff ff ff ff ff 
6:71 b2 71 8f 70 9f 78 c0 
7:ff ff ff ff ff ff ff ff 
8:ff ff ff ff ff ff ff ff 
1:ff ff ff ff ff ff ff ff 
2:00 3f ff e0 00 1f ff e0 
3:ff ff ff ff ff ff ff ff 
4:ff ff ff ff ff ff ff ff 
5:ff ff ff ff ff ff ff ff 
6:f8 d8 f8 c0 3c 4c 1c 63 
7:ff ff ff ff ff ff ff ff 
8:ff ff ff ff ff ff ff ff 
[...]

Binary

Raw, binary output format without any metadata. In the example below every byte contains one sample consisting of 8 probe values (each bit denotes the high or low value of one probe; bit 0 corresponds to probe 0, and so on). In the example, probe 6 is tied to GND (i.e., low), all others are high.

$ sigrok-cli --samples 1000 -f binary > somefile.dat
$ hexdump -Cv somefile.dat
00000000  bf bf bf bf bf bf bf bf  bf bf bf bf bf bf bf bf  |................|
00000010  bf bf bf bf bf bf bf bf  bf bf bf bf bf bf bf bf  |................|
00000020  bf bf bf bf bf bf bf bf  bf bf bf bf bf bf bf bf  |................|
00000030  bf bf bf bf bf bf bf bf  bf bf bf bf bf bf bf bf  |................|
[...]

VCD (Value Change Dump)

sigrok VCD output viewed in gtkwave

$ sigrok-cli --samples 1000 -f vcd
$date Wed Apr  2 00:01:40 2011 $end
$version sigrok 0.2 $end
$comment
  Acquisition with 8/8 probes at 200 kHz
$end
$timescale 1 ns $end
$scope module sigrok $end
$var wire 1 ! channel1 $end
$var wire 1 " channel2 $end
$var wire 1 # channel3 $end
$var wire 1 $ channel4 $end
$var wire 1 % channel5 $end
$var wire 1 & channel6 $end
$var wire 1 ' channel7 $end
$var wire 1 ( channel8 $end
$upscope $end
$enddefinitions $end
$dumpvars
#0
1!
#0
0"
#0
1#
#0
1$
#0
1%
#0
0&
#0
1'
#0
1(
#3
1&
[...]
$dumpoff
$end

Gnuplot

sigrok gnuplot output format, PNG format

$ sigrok-cli --samples 1000 -f gnuplot
# Sample data in space-separated columns format usable by gnuplot
#
# Generated by: sigrok 0.2 on Fri Apr 15 20:25:58 2011
# Comment: Acquisition with 8/8 probes at 500 kHz
# Period: 500 ms
#
# Column        Probe
# -----------------------------------------------------------------------------
# 0             Sample counter (for internal gnuplot purposes)
# 1             1
# 2             2
# 3             3
# 4             4
# 5             5
# 6             6
# 7             7
# 8             8

0               1 0 1 1 1 0 1 1 
6               1 0 1 1 1 1 1 1 
11              1 0 1 1 1 0 1 1 
14              1 0 1 1 1 1 1 1 
[...]

OLS

sigrok OLS output format in jawi's OLS client

The OLS file format, as supported by jawi's "Alternative" OLS client (>= 0.9.4-rc1).

$ sigrok-cli -d demo:patternmode=random --samples 1000 -f ols
;Rate: 200000
;Channels: 8
;EnabledChannels: -1
;Compressed: true
;CursorEnabled: false
00000067@0
000000c6@1
00000069@2
00000073@3
00000051@4
000000ff@5
0000004a@6
000000ec@7
00000029@8
000000cd@9
000000ba@10
000000ab@11
000000f2@12
000000fb@13
000000e3@14
00000046@15
0000007c@16
[...]

ChronoVu LA8

sigrok chronovu-la8 output format in the ChronoVu LA8 software

This is the file format understood by the ChronoVu LA8 software. The usual file name extension is .kdt.

$ sigrok-cli -d 0 --samples 1000 -f chronovu-la8 -o foo.kdt

Limitations:

  • The file size must be exactly 8388613 bytes (8 MB samples + 5 bytes metadata).