File format:saleae

saleae

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?