ScopeCorder SDK (Software Development Kit)

API Overview

The API is provided as a dynamic link library (DLL). The API can be used by linking user applications with this DLL.

The API provides the following three functions.

• Data Acquisition Function
• Flash acquisition data access library
• File operation and transfer feature

Data Acquisition Function
As shown in the following figure, the data acquisition function provides functions for obtaining waveform data being acquired by the instrument and setting measurement conditions to the application. (Free run measurement and trigger measurement)
The API’s data acquisition function supports two acquisition modes: free run and trigger.

(1) Free run mode
Free run mode is used to acquire data from the start to the end of waveform acquisition.
Waveform acquisition specifications in free run mode
Maximum data rate 320 MB/s (10 MS/s×16ch) for 10Gbit Ethernet connection
Maximum data rate 6.4 MB/s (200 kS/s×16ch) for 1Gbit Ethernet/USB connection
Maximum waveform acquisition time 10 days (maximum operation time guaranteed for this API)*
* If data is sent from a DL950/SL2000 at the above data rate in measurement using multi-unit synchronization connection, the possibility of data transmission buffer overrun occurring will increase depending on the connection environment, the PC performance, and so on. As such, it is recommended that measurements be made with the total data rate of the multiple connected units set within the above range.

(2) Trigger mode
Trigger mode is used to acquire waveform using triggers. There are two trigger modes available with the API: (1) synchronous mode in which the DL950/SL2000 acquires waveforms synchronously with the PC and (2) asynchronous mode in which the DL950/ SL2000 acquires waveforms asynchronously with the PC.
Note that the API does not support the following features.

• Waveform acquisition in roll mode (the DL950/SL2000 itself supports waveform acquisition in roll mode, but the API does not support waveform acquisition while the DL950 is acquiring waveforms in roll mode) • DL950/SL2000 trigger mode set to Single N
• Waveform acquisition using dual capture
• Real-time recording (SSD and flash acquisition)
• Recorder mode

Trigger-based waveform acquisition specifications
Maximum waveform acquisition time 10 days (maximum operation time guaranteed for this API)*
When high-speed transmission mode using 10GbpsEthernet is enabled, the maximum record length that can be specified is as shown below due to the memory join limitation.
For details on memory join, see the appendix in the DL950 ScopeCorder/SL2000 High- Speed Data Acquisition Unit User’s Manual (IM DL950-03EN).
Standard model: 250 M
/M1 Model: 1 G
/M2 Model: 2 G

Flash acquisition data access library
As shown in the following figure, the Flash Acquisition Data Access Library provides applications with a function for extracting flash acquisition waveform data stored in a DL950/SL2000 directly to a PC without loading the data into the instrument.
* Note that the acquisition memory is used as a temporary buffer when flash acquisition waveform data is extracted through the use of this API. Thus, data and history information in the acquisition memory that have not been saved to a storage device will be cleared. Waveform data stored in the flash acquisition area is not affected.
* This feature is available only when the /ST2 option is installed.

File operation and transfer feature
The file operation and transfer feature provides applications with features related to the acquisition, transmission, and deletion of DL950/SL2000 measurement data and settings.

Functions

This software can be used to perform the following functions. For details, see “Detailed API Specifications.”

• Initializing the API
• Connecting and disconnecting from measuring instruments
• Setting parameters
• Getting waveform data
• Getting the measurement conditions of waveform data stored in the flash acquisition area
• Getting the waveform data stored in the flash acquisition area
• Getting the list of files stored in the instrument
• Operating and transferring files (instrument to PC and PC to instrument)

Software structure

This software package contains the following items.

ScopeCorder SDK User’s Manual
API files（see below）

Applicable Model

DL950 (Applicable DL950 firmware version is 2.01 or later.)
SL2000 (Applicable SL2000 firmware version is 2.01 or later.)

System requirements

PC

A PC that meets the following conditions is required.
A PC running the English or Japanese version of Windows 10 (32 bit or 64 bit)
A PC running the English or Japanese version of Windows 11
Note that when waveforms are acquired in free run mode using this software, data is saved in a specified buffer.
See User’s Manual for more details.

Development Environment

Visual Studio 2017 or later, .NET Framework 4.7 or later

System requirements for running user programs

When using 10Gbit Ethernet connection

• CPU
  Desktop-Type PC
  Intel Core i7-1165G7 or better, quad core (8 threads) or better, 4.7 GHz or faster
• Memory
  16 GB or more
• SSD
  512 GB or more (M.2 slot SSD recommended, read/write performance 3 GB/s or better)

When using 1Gbit Ethernet or USB connection

• CPU
  Intel Core i5-10210U or better, quad core (8 threads) or better, 4.2 GHz or faster
• Memory
  8 GB or more
• SSD
  256 GB or more (read/write performance 400 MB/s or better)