Difference between revisions of "File format:Sigrok/v2"
Uwe Hermann (talk | contribs) m |
m (→analog-*) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:File format:sigrok/v2}} | {{DISPLAYTITLE:File format:sigrok/v2}} | ||
This page contains the '''sigrok session file format specification'''. | This page contains the '''sigrok session file format specification'''. | ||
See [[File_format:Sigrok/v3]] for the next version of the srzip file format, which currently is '''under development'''. | |||
== Overview == | == Overview == | ||
| Line 9: | Line 10: | ||
== ZIP file contents == | == ZIP file contents == | ||
<!-- | |||
=== mimetype === | === mimetype === | ||
| Line 21: | Line 22: | ||
>30 string mimetype | >30 string mimetype | ||
>>38 string application/vnd.sigrok.session | >>38 string application/vnd.sigrok.session | ||
--> | |||
=== version === | === version === | ||
This ASCII file contains the sigrok session file format version number (a single integer number). Currently this is ''' | This ASCII file (must always exist) contains the sigrok session file format version number (a single integer number). Currently this is '''2'''. It is increased every time the file format changes. | ||
=== metadata === | === metadata === | ||
This ASCII file contains various metadata about the sigrok session. The file format must use the usual "INI"-style syntax (see below). | This ASCII file (must always exist) contains various metadata about the sigrok session. The file format must use the usual "INI"-style syntax (see below). | ||
The file must consist of lines which end with either '''\r''' or '''\n''' or '''\r\n''' or '''\n\r'''. The maximum line length is 4093 characters (not including any trailing newline and carriage return characters). | The file must consist of lines which end with either '''\r''' or '''\n''' or '''\r\n''' or '''\n\r'''. The maximum line length is 4093 characters (not including any trailing newline and carriage return characters). | ||
Empty lines and lines beginning with "#" are ignored. | |||
Sections are started via lines containing only '''[<sectionname>]''' where <setionname> is the name of this specific section. No whitespace is allowed between <sectionname> and the brackets. | Sections are started via lines containing only '''[<sectionname>]''' where <setionname> is the name of this specific section. No whitespace is allowed between <sectionname> and the brackets. | ||
| Line 40: | Line 39: | ||
Section names can contain the following characters: A-Z, a-z, 0-9, <space>. | Section names can contain the following characters: A-Z, a-z, 0-9, <space>. | ||
Every section can contain zero or more lines. Each line must be of the ''key = value'' format. | Every section can contain zero or more lines. Each line must be of the ''key=value'' format. Whitespace before and after "=" is ignored. | ||
The keys can contain the following characters: A-Z, a-z, 0-9, <space>, < | The keys can contain the following characters: A-Z, a-z, 0-9, <space>, <minus>. | ||
==== Section: global ==== | ==== Section: global ==== | ||
| Line 50: | Line 49: | ||
==== Section: device ''X'' ==== | ==== Section: device ''X'' ==== | ||
* driver | * driver (optional) | ||
* capturefile | * capturefile | ||
* unitsize | * unitsize | ||
* total probes | * total probes | ||
* total analog | |||
* samplerate | * samplerate | ||
* | * probe''X'' | ||
* analog''X'' | |||
=== logic-* === | === logic-* === | ||
There can be one or more binary files in the ZIP file, which contain | There can be one or more binary files in the ZIP file, which contain logic analyzer samples. These have a name of | ||
* '''logic-1''' (one large file; deprecated, but still supported), or | |||
* '''logic-1-1''', '''logic-1-2''', '''logic-1-3''', and so on (many smaller files). | |||
=== analog-* === | |||
There can be one or more binary files in the ZIP file, which contain analog samples. These have a name of | |||
* '''analog-1-''<chan>''-1''', '''analog-1-''<chan>''-2''', '''analog-1-''<chan>''-3''', and so on (where ''<chan>'' is the analog channel number). | |||
TODO: Format, contents, endianness, etc. | <!-- TODO: Format, contents, endianness, etc. --> | ||
Latest revision as of 19:33, 12 November 2020
This page contains the sigrok session file format specification. See File_format:Sigrok/v3 for the next version of the srzip file format, which currently is under development.
Overview
The sigrok session file is a standard ZIP file with certain contents and some special requirements.
The recommended file extension is .sr.
ZIP file contents
version
This ASCII file (must always exist) contains the sigrok session file format version number (a single integer number). Currently this is 2. It is increased every time the file format changes.
metadata
This ASCII file (must always exist) contains various metadata about the sigrok session. The file format must use the usual "INI"-style syntax (see below).
The file must consist of lines which end with either \r or \n or \r\n or \n\r. The maximum line length is 4093 characters (not including any trailing newline and carriage return characters).
Empty lines and lines beginning with "#" are ignored.
Sections are started via lines containing only [<sectionname>] where <setionname> is the name of this specific section. No whitespace is allowed between <sectionname> and the brackets.
Section names can contain the following characters: A-Z, a-z, 0-9, <space>.
Every section can contain zero or more lines. Each line must be of the key=value format. Whitespace before and after "=" is ignored.
The keys can contain the following characters: A-Z, a-z, 0-9, <space>, <minus>.
Section: global
- sigrok version
Section: device X
- driver (optional)
- capturefile
- unitsize
- total probes
- total analog
- samplerate
- probeX
- analogX
logic-*
There can be one or more binary files in the ZIP file, which contain logic analyzer samples. These have a name of
- logic-1 (one large file; deprecated, but still supported), or
- logic-1-1, logic-1-2, logic-1-3, and so on (many smaller files).
analog-*
There can be one or more binary files in the ZIP file, which contain analog samples. These have a name of
- analog-1-<chan>-1, analog-1-<chan>-2, analog-1-<chan>-3, and so on (where <chan> is the analog channel number).