instrument-com

Support many methods to communication with instrument through ethernet or usb

Now it only support GWINSTE's GDS2000E series

Example

You can direct use known port and ip to create a new instance

var dsoDriver = require('./index.js');
 
// create a new instance and bind to ethernet interface with ip:172.16.5.68 and port:3000
var dsoCtrl=dsoDriver.DsoNet(3000,'172.16.5.68');
 
// connect to instrument , connect must be done before any operation.
dsoCtrl.connect().then(dsoCtrl.run);
 

Or you can browse which one you want to

var dsoDriver = require('./index.js');
var dsoCtrl, i, len ;
 
 
/*
 * .showNetDevice use mdsn to browse available device
 * @return (Array Object) [ { name, port, addr } , ...]
 */
var deviceList = dsoDriver.showNetDevice();
len = deviceList.length
for( i = 0; i < len; i += 1 ){
  if(deviceList[i].name === 'GDS2102E-01' ){
    dsoCtrl = deviceList.DsoNet( deviceList[i].port, deviceList[i].addr );
    break;
  }
}
 
if(dsoCtrl === undefined){
  console.log('GDS2000E not available');
  process.exit(1);
}
 
dsoCtrl.connect().then(dsoCtrl.run);
 

API

• showNetDevice( )
• DsoNet( port, address )
• DsoUSB( vid, pid )

Show avaiable device

Find all instrument-dso service using mdns. When DSO socket server on, you can use showNetDevice() to count available DSO, and showNetDevice() will return an array object that store dso's name, port and ip like this

[ {name:'GDS2102E-01',port:'3000', addr:'172.16.5.111'}
 ,{name:'GDS2102E-02',port:'3000', addr:'172.16.5.112'} ]

Create new instance via Ethernet

Use DsoNet( port, address ) to create a new instance that contains many methods to control remote DSO via ethernet. Remote DSO has a port and ip address to identify it self, use unique port and ip address to pass to DsoNet() and DsoNet() will return an object to control that remote DSO

var dsoCtrl=dsoDriver.DsoNet(3000,'172.16.5.68');
console.log( dsoCtrl );

Create new instance via USB

You can use one of DsoNet() or dsoUSB() to create a new instance but can't use both.

Methods

When dsoCtrl object was created, you can use many methods to control device.

• .connect( )
• .disconnect( )
• .syncConfig( )
• .enableCh( ch )
• .disableCh( ch )
• .getHorizontal( )
• .setHorizontal( hor )
• .getVertical( ch )
• .setVertical( ch )
• .getEdgeTrig( )
• .setEdgeTrig( )
• .getSnapshot( )
• .getRawdata( ch )
• .getMeas( mch )
• .supportedMeasType( )
• .setMeas( { mch, src1, src2, type } )
• .statisticOn( )
• .statisticOff( )
• .statisticWeight( weight )
• .run( )
• .stop( )
• .single( )
• .autoset( )
• .force( )
• .closeDev( )

.connect

Connect to device, create a connection to the device, if return with no error, the other methods can be useed

// create a new instance and bind to ethernet interface with ip:172.16.5.68 and port:3000
var dsoCtrl=dsoDriver.DsoNet(3000,'172.16.5.68');
 
// connect to instrument , connect must be done before any operation.
dsoCtrl.connect()
  .then(dsoCtrl.run);

.disconnect

Disconnect from device, if nothing else to do, disconnect from the device.

  dsoCtrl.dsiconnect().then(dsoCtrl.closeDev);

.syncConfig

.enableCh

Turn remote DSO's channel on

//turn channel 1 on
dsoCtrl.connect()
  .then(dsoCtrl.enableCh('ch1'));

.disableCh

Turn remote DSO's channel off

//turn channel 1 off
dsoCtrl.connect()
  .then(dsoCtrl.disableCh('ch1'));

.getHorizontal

Return current remote DSO's horizontal system setting

dsoCtrl.connect()
    .then(function(){
        dsoCtrl.getHorizontal()
            .then(function(res){
                console.log(res);
            });
    });

Console displayed infomation

 { temp: 0,
  position: '0.000E+00',
  zposition: '0.000E+00',
  scale: '1.000000e-04',
  zscale: '1.000E-05',
  mode: 'MAIN',
  expand: 'CENTER',
  prop: { get: [Function], set: [Function] } }

The meaning of the return object

• temp: never mind
• position: offset of the waveform trace in time axis
• scale: a waveform trace can be cut into 10 block, the scale is the time of a block
• zscale: never mind
• mode: nerver mind
• expand: never mind
• prop: never mind

.setHorizontal

setHorizontal( hor ), setup remote DSO's horizontal system, hor is an object that include position,zposition,scale,zscale,mode,expand. Those parameter have some limitation.

You can pass parameter only you care

dsoCtrl.connect()
    .then(function(){
        dsoCtrl.setHorizontal({ position:'2.000E-04', scale:'2.0E-04'})
            .then(function(){
                console.log('done');
            })
            .catch(function(err){
                console.log('catch error: '+err);
            })
    })
    .then(dsoCtrl.stop)
    .catch(function(){
        console.log('dsoCtrl error');
    });

We set the position to 200us and set the scale to 200us

.getVertical

Return current remote DSO's vertical system setting

dsoCtrl.connect()
    .then(function(){
        dsoCtrl.getVertical('ch1')
            .then(function(res){
                console.log(res)
            });
    })
    .catch(function(){
        console.log('dsoCtrl error');
    });

Console displayed infomation

{ coupling: 'DC',
  impedance: '1E+6',
  invert: 'OFF',
  bandwidth: 'FULL',
  expand: 'GND',
  state: 'ON',
  scale: '1.000E-01',
  position: '0.000E+00',
  deskew: '0.000e+00',
  rawdata: <Buffer 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 60 00 00 03 01 00 00 00 78 00 00 03 01 00 00 00 90 00 00 03 01 00 00 00 01 00 00 00 00 00 00 00 ff ff ... >,
  raw_state: '0',
  probe: { unit: 'VOLTAGE', atten: '1.000000e+00' },
  dataCount: 0,
  recCount: 0,
  id: 'ch1',
  prop: { get: [Function], set: [Function] } }

.setVertical

Setup remote DSO's vertical system

.getEdgeTrig

Retrun current remote DSO's edge trigger setting

.setEdgeTrig

Setup remote DSO's edge trigger

.getSnaphot

Return an RLE buffer that store screen data displayed on remote DSO

dsoCtrl.connect()
    .then(function(){
        dsoCtrl.getSnapshot()
            .then(function(res){
                console.log(res)
            });
    })
    .catch(function(){
        console.log('dsoCtrl error');
    });

.getRawdata

Return sampled value, each two int8 bytes encodes the vertical data of a data point, and store in big endian format

.getMeas

Return measurement value for selected measurement source

.supportedMeasType

Return suppoted measurement type

.setMeas

Setup measurement type for selected measurement source

.statisticOn

Turn statistic measure on for all measurement source

.statisticOff

Turn statistic measure off for all measurement source

.statisticWeight

Setup statistic weighting

.run

Turn remote DSO into run state

.stop

Turn remote DSO into stop state

.single

Turn remote DSO into single state

.autoset

Turn remote DSO into autoset state

.force

Turn remote DSO into force state

.closeDev

Close opened device

Error Message

You can use promise catch method to catch error message

dsoCtrl.connect()
    .then(function(){
        dsoCtrl.setHorizontal({ position:'-1E7',
                                scale:'2.0E-04'
                            })
            .then(function(){
                console.log('done');
            })
            .catch(function(err){
                console.log(err);
            })
    })

Console displayed information

[ '-500',
  '\'-1e+7\' argument does not accept, set to near one -5.000E+01\n' ]
 

Array[0] show error type

• -100 : Parameter Error
• -200 : Execution Error
• -300 : Device-specific Error
• -400 : Query Error
• -500 : Parameter Not Accept

Array[1] show error message