How to Extract Data from the Binary File of SDS2000X, SDS1000X, and SDS1000X-E

Table 1 Format of the Binary File

Address	Parameter	Description
0x00-0x03	wave_length	Reserved
0x04-0x07	mso_wave_length	digital channels wave length
0x10-0x13	mso_ch_open_num	Total enabled digital channels 32-bit signed integer, little endian.
0x14	mso_ch_open_state[0]	on/off status of digital channel 0 (D0), 1 – ON, 0 – OFF 8-bit unsigned integer.
0x15	mso_ch_open_state[1]	on/off status of digital channel 1 (D1)
0x16	mso_ch_open_state[2]	on/off status of digital channel 2 (D2)
0x17	mso_ch_open_state[3]	on/off status of digital channel 3 (D3)
0x18	mso_ch_open_state[4]	on/off status of digital channel 4 (D4)
0x19	mso_ch_open_state[5]	on/off status of digital channel 5 (D5)
0x1a	mso_ch_open_state[6]	on/off status of digital channel 6 (D6)
0x1b	mso_ch_open_state[7]	on/off status of digital channel 7 (D7)
0x1c	mso_ch_open_state[8]	on/off status of digital channel 8 (D8)
0x1d	mso_ch_open_state[9]	on/off status of digital channel 9 (D9)
0x1e	mso_ch_open_state[10]	on/off status of digital channel 10 (D10)
0x1f	mso_ch_open_state[11]	on/off status of digital channel 11 (D11)
0x20	mso_ch_open_state[12]	on/off status of digital channel 12 (D12)
0x21	mso_ch_open_state[13]	on/off status of digital channel 13 (D13)
0x22	mso_ch_open_state[14]	on/off status of digital channel 14 (D14)
0x23	mso_ch_open_state[15]	on/off status of digital channel 15 (D15)
0xbc-0xbf	ch1_volt_div_val	V/div value of CH1, in units of mV. Such as 2.48 mV/div. 32-bit float point, little endian.
0xc0-0xc3	ch2_volt_div_val	V/div value of CH2, in units of mV. Such as 2.48 mV/div. 32-bit float point, little endian.
0xc4-0xc7	ch3_volt_div_val	V/div value of CH3, in units of mV. Such as 2.48 mV/div. 32-bit float point, little endian.
0xc8-0xcb	ch4_volt_div_val	V/div value of CH4, in units of mV. Such as 2.48 mV/div. 32-bit float point, little endian.
0xdc-0xdf	ch1_vert_offset	Offset value of CH1, with the unit of pixel. Refer to “Calculate the Vertical Offset” to get the actual offset voltage 32-bit signed integer, little endian.
0xe0-0xe3	ch2_vert_offset	Offset value of CH2
0xe4-0xe7	ch3_vert_offset	Offset value of CH3
0xe8-0xeb	ch4_vert_offset	Offset value of CH4
0xf0-0xf3	ch1_volt_div	The coarse V/div index of CH1. Refer to Table 3 for the details. 32-bit signed integer, little endian.
0xf4-0xf7	ch2_volt_div	The coarse V/div index of CH2.
0xf8-0xfb	ch3_volt_div	The coarse V/div index of CH3.
0xfc-0xff	ch4_volt_div	The coarse V/div index of CH4.
0x100-0x103	ch1_on	on/off status of CH1, 1 – ON, 0 – OFF 32-bit signed integer, little endian.
0x104-0x107	ch2_on	on/off status of CH2
0x108-0x10b	ch3_on	on/off status of CH3
0x10c-0x10f	ch4_on	on/off status of CH4
0x248-0x24b	time_div	T/div index. Refer to Table 2 for the details 32-bit signed integer, little endian.
0x250-0x253	time_delay	Time delay (Trigger delay) value, in units of pixel. Refer to “Calculate the Time Delay” to get the actual time delay 32-bit signed integer, little endian.
0x1470-end	data	Data. Analog data first, and then digital data. Only data of the enabled channel(s) are stored to the file 8-bit unsigned integer for analog data 1-bit binary integer for digital data

Table 2 T/div Table

Index	SDS2000X	SDS1000X
0	1 ns/div
1	2 ns/div	2 ns/div
2	5 ns/div	5 ns/div
3	10 ns/div	10 ns/div
4	20 ns/div	20 ns/div
5	50 ns/div	50 ns/div
6	100 ns/div	100 ns/div
7	200 ns/div	200 ns/div
8	500 ns/div	500 ns/div
9	1 us/div	1 us/div
10	2 us/div	2 us/div
11	5 us/div	5 us/div
12	10 us/div	10 us/div
13	20 us/div	20 us/div
14	50 us/div	50 us/div
15	100 us/div	100 us/div
16	200 us/div	200 us/div
17	500 us/div	500 us/div
18	1 ms/div	1 ms/div
19	2 ms/div	2 ms/div
20	5 ms/div	5 ms/div
21	10 ms/div	10 ms/div
22	20 ms/div	20 ms/div
23	50 ms/div	50 ms/div
24	100 ms/div	100 ms/div
25	200 ms/div	200 ms/div
26	500 ms/div	500 ms/div
27	1 s/div	1 s/div
28	2 s/div	2 s/div
29	5 s/div	5 s/div
30	10 s/div	10 s/div
31	20 s/div	20 s/div
32	50 s/div	50 s/div

Table 3 V/div Table

Index	SDS2000X	SDS1000X
0	1 mV/div	500uV/div
1	2 mV/div	1 mV/div
2	5 mV/div	2 mV/div
3	10 mV/div	5 mV/div
4	20 mV/div	10 mV/div
5	50 mV/div	20 mV/div
6	100 mV/div	50 mV/div
7	200 mV/div	100 mV/div
8	500 mV/div	200 mV/div
9	1 V/div	500 mV/div
10	2 V/div	1 V/div
11	5 V/div	2 V/div
12	10 V/div	5 V/div
13		10 V/div

Calculate the Sample Rate

sample_rate = (wave_length)/(hori_div_num*time_div_val)
[example]
hori_div_num = 14 # total horizontal divisions, on SDS2000X is 14
wave_length = 700 pts # length of each frame. Could be got by calculating the length of the data section in the file
time_div_val = 50 ns/div # use the T/div index got from the binary file to search Table 2

So:
sample_rate = 700/(14*50e-9) = 1e9(Sa/s)

Calculate the Vertical Offset

vert_offset = (ch_vert_offset – 220)*( ch_volt_div_val/pixels_per_div)
[example]
pixels_per_div = 50 # total display pixels in a vertical division, on SDS2000X is 50
ch_vert_offset = 270 # offset value, with the unit of pixel, got from the binary file
ch_volt_div_val = 50 mV/div # v/div value, got from the binary file

So:
vert_offset = (270 – 220)*(50 mV/50) = 50 mV;

Calculate the Time Delay

hori_offset_time = (time_offset – 349)*( time_div_val /pixels_per_div)
[example]
pixels_per_div = 50 # total display pixels in a horizontal division, on SDS2000X is 50
time_offset = 299 # time delay value, with the unit of pixel, got from the binary file
time_div_val = 50 ns # use the T/div index got from the binary file to search Table 2

So:
hori_offset_time = (299 – 349)*(50 ns/50) = -50ns

Convert the Data to Voltage

voltage = (data-128) * ch_volt_div_val /1000/code_per_div + ch_vert_offset
[example]
code_per_div = 50 # total data code in a horizontal division, on SDS2000X is 25
data = 194 # got from the binary file
ch_volt_div_val = 5000 mV/div # V/div, in units of mV
ch_vert_offset = -7.7 V # vertical offset

So:
voltage = (194-128) * 5000/1000/25+(-7.7) = 5.5 V