Difference between revisions of "File format:Saleae"
Jump to navigation
Jump to search
(saleae exported file import is supported) |
(more explicit NAK on .logicdata and .sal) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 13: | Line 13: | ||
Saleae's '''Logic''' application can export captures in different formats. CSV and VCD are supported by other input modules. The '''input/saleae''' input module handles binary exports for digital and analog data. | Saleae's '''Logic''' application can export captures in different formats. CSV and VCD are supported by other input modules. The '''input/saleae''' input module handles binary exports for digital and analog data. | ||
Notice that neither .logicdata nor .sal file formats are covered by the sigrok input/saleae support code. Because their format is unknown or undocumented. | |||
== Format == | == Format == | ||
See the vendor's technical FAQ in the [[#Resources]] section. | See the vendor's technical FAQ in the [[#Resources]] section for details. | ||
* The .logicdata format is "underdocumented". Vendor software cannot load the native format of older versions of the vendor software. Recommends to install old and new versions side by side instead. | |||
* The .bin file exports for vendor software versions 1 and 2 are documented. Some file format versions lack meta information so that users need to specify the missing details upon import. | |||
* The .sal file format is officially not documented. By design, to not commit to one format, and to not break external applications when internals happen to change. | |||
The sigrok input module supports those formats and features which are documented and understood. Other features or formats can only get added after essential information on their operation becomes available. | |||
Support for the .sal format additionally depends on the "internal file I/O" feature for input modules. Which currently is lacking in sigrok mainline. | |||
== Implementation == | == Implementation == | ||
| Line 30: | Line 40: | ||
format: Type of input file format. Not all types can get auto-detected. (default 'auto-detect', possible values 'auto-detect', 'logic1-digital', 'logic1-analog', 'logic2-digital', 'logic2-analog') | format: Type of input file format. Not all types can get auto-detected. (default 'auto-detect', possible values 'auto-detect', 'logic1-digital', 'logic1-analog', 'logic2-digital', 'logic2-analog') | ||
changed: Sample value was saved when changed (in contrast to: every sample). (default false) | changed: Sample value was saved when changed (in contrast to: every sample). (default false) | ||
wordsize: The number of bits per | wordsize: The number of bits per set of samples for digital data. (default 8, possible values 8, 16, 32, 64) | ||
logic_channels: The number of digital channels. Word size is used when not specified. (default 0) | logic_channels: The number of digital channels. Word size is used when not specified. (default 0) | ||
samplerate: The samplerate. Needed when the file content lacks this information. (default 0) | samplerate: The samplerate. Needed when the file content lacks this information. (default 0) | ||
| Line 41: | Line 51: | ||
* Vendor FAQ for Logic1 software versions, [https://support.saleae.com/faq/technical-faq/binary-data-export-format digital] and [https://support.saleae.com/faq/technical-faq/data-export-format-analog-binary analog] data exports. | * Vendor FAQ for Logic1 software versions, [https://support.saleae.com/faq/technical-faq/binary-data-export-format digital] and [https://support.saleae.com/faq/technical-faq/data-export-format-analog-binary analog] data exports. | ||
* Vendor FAQ for Logic2 software versions, [https://support.saleae.com/faq/technical-faq/binary-export-format-logic-2 digital and analog] exports | * Vendor FAQ for Logic2 software versions, [https://support.saleae.com/faq/technical-faq/binary-export-format-logic-2 digital and analog] exports | ||
* Vendor FAQ for Logic 1.x .logicdata files, [https://support.saleae.com/faq/technical-faq/can-i-create-or-edit-logicdata-files create/edit .logicdata?], [https://support.saleae.com/faq/technical-faq/open-logicdata-files open .logicdata?] | |||
* Vendor FAQ for Logic 2.x .sal files [https://support.saleae.com/faq/technical-faq/sal-file-format .sal file format documented?] | |||
__NOTOC__ | __NOTOC__ | ||
[[Category:File format]] | [[Category:File format]] | ||
Latest revision as of 09:31, 19 November 2023
| Name | Saleae Logic export files |
|---|---|
| Status | supported |
| Source code (in) | saleae.c |
| Common extension(s) | .bin |
| MIME type | — |
| ASCII format | no |
| Compression | optional (every sample, or when changed) |
| Website | Saleae FAQ |
Saleae's Logic application can export captures in different formats. CSV and VCD are supported by other input modules. The input/saleae input module handles binary exports for digital and analog data.
Notice that neither .logicdata nor .sal file formats are covered by the sigrok input/saleae support code. Because their format is unknown or undocumented.
Format
See the vendor's technical FAQ in the #Resources section for details.
- The .logicdata format is "underdocumented". Vendor software cannot load the native format of older versions of the vendor software. Recommends to install old and new versions side by side instead.
- The .bin file exports for vendor software versions 1 and 2 are documented. Some file format versions lack meta information so that users need to specify the missing details upon import.
- The .sal file format is officially not documented. By design, to not commit to one format, and to not break external applications when internals happen to change.
The sigrok input module supports those formats and features which are documented and understood. Other features or formats can only get added after essential information on their operation becomes available.
Support for the .sal format additionally depends on the "internal file I/O" feature for input modules. Which currently is lacking in sigrok mainline.
Implementation
The sigrok input module for Saleae exports provides the following options. User specs are required where file content lacks necessary information.
$ sigrok-cli -I saleae --show ID: saleae Name: Saleae Description: Saleae Logic software export files Options: format: Type of input file format. Not all types can get auto-detected. (default 'auto-detect', possible values 'auto-detect', 'logic1-digital', 'logic1-analog', 'logic2-digital', 'logic2-analog') changed: Sample value was saved when changed (in contrast to: every sample). (default false) wordsize: The number of bits per set of samples for digital data. (default 8, possible values 8, 16, 32, 64) logic_channels: The number of digital channels. Word size is used when not specified. (default 0) samplerate: The samplerate. Needed when the file content lacks this information. (default 0)
The .logicdata and the .sal file formats are not documented, and currently are not supported.
Resources
- Vendor FAQ for Logic1 software versions, digital and analog data exports.
- Vendor FAQ for Logic2 software versions, digital and analog exports
- Vendor FAQ for Logic 1.x .logicdata files, create/edit .logicdata?, open .logicdata?
- Vendor FAQ for Logic 2.x .sal files .sal file format documented?