OwonBinfileReader 1.0.0

OWON Binfile Reader

This is a simple library to read OWON oscilloscope binfiles. Most of the code is based on reverse engineering and guestimating so don't use this to build a nuclear powerplant or send people into space with!

Usage

using OwonBinfileReader;

var bfr = new BinfileReader();
var bf = await bfr.ReadAsync(@"/path/to/file.bin");

This will read the binfile and return a Binfile object. This object contains the following properties:

• MetaData: contains information about the oscilloscope settings and binfile.
• Measurements: this is an ReadOnlyDictionary<int, double[]>) and contains the measurements per ('displayed') channel.

Tested oscilloscopes

For now this library has only been tested with the Hanmatek DSO1102 which is a rebranded version of the OWON SDS1102 as far as I know and a OWON XDS3104AE. I have found some other .bin files online which worked as well, but you'll have to see for yourself if this library works for you.

File format

This Data Length + Data repeats for each channel where DISPLAY is ON. Then finally an optional segment may follow after the data (End Of Data):

The above segment is not read by this library.

An example of the JSON contained in this file might be:

{
  "TIMEBASE": {
    "SCALE": "200ms",
    "HOFFSET": 120
  },
  "SAMPLE": {
    "FULLSCREEN": 1520,
    "SLOWMOVE": 2000,
    "DATALEN": 1520,
    "SAMPLERATE": "(2.5MS/s)",
    "TYPE": "SAMPle",
    "DEPMEM": "10M"
  },
  "CHANNEL": [
    {
      "NAME": "CH1",
      "DISPLAY": "ON",
      "Current_Rate": 10000,
      "Current_Ratio": 0.78125,
      "Measure_Current_Switch": "OFF",
      "COUPLING": "DC",
      "PROBE": "10X",
      "SCALE": "50.0mV",
      "OFFSET": -201,
      "FREQUENCE": 210.14742,
      "INVERSE": "OFF"
    },
    {
      "NAME": "CH2",
      "DISPLAY": "OFF",
      "Current_Rate": 10000,
      "Current_Ratio": 0.015625,
      "Measure_Current_Switch": "OFF",
      "COUPLING": "DC",
      "PROBE": "10X",
      "SCALE": "1.00mV",
      "OFFSET": 0,
      "FREQUENCE": 210.14742,
      "INVERSE": "OFF"
    },
    {
      "NAME": "CH3",
      "DISPLAY": "OFF",
      "Current_Rate": 10000,
      "Current_Ratio": 0.015625,
      "Measure_Current_Switch": "OFF",
      "COUPLING": "DC",
      "PROBE": "10X",
      "SCALE": "1.00mV",
      "OFFSET": 0,
      "FREQUENCE": 210.14742,
      "INVERSE": "OFF"
    },
    {
      "NAME": "CH4",
      "DISPLAY": "OFF",
      "Current_Rate": 10000,
      "Current_Ratio": 0.015625,
      "Measure_Current_Switch": "OFF",
      "COUPLING": "DC",
      "PROBE": "10X",
      "SCALE": "1.00mV",
      "OFFSET": 0,
      "FREQUENCE": 210.14742,
      "INVERSE": "OFF"
    }
  ],
  "DATATYPE": "SCREEN",
  "RUNSTATUS": "SCAN",
  "IDN": "OWON,XDS3104AE,2308149,V4.0.0",
  "MODEL": "310401101",
  "Trig": {
    "Mode": "SINGle",
    "Type": "EDGE",
    "Items": {
      "Channel": "CH1",
      "Level": "2.50V",
      "Edge": "RISE",
      "Coupling": "DC",
      "HoldOff": "100ns"
    },
    "Sweep": "AUTO"
  },
  "IsSkipIfClosed": true
}

The actual measurement is each 16 bit value � (CurrentRatio / CurrentRate).

Normalization

This library will normalize values to the base unit. So values in mV will be converted to V, values in �s will be converted to s, etc. Where possible values are parsed to enums (e.g. Coupling or Triggermode), bools for ON / OFF values, timespans etc. Values are represented in the double datatype.

Attribution

The logo is composed of the following images:

• Papers Icon by Shahid-Mehmood
• Oscilloscope Icon by Muhammad Ali