Package Exports

labjack-nodejs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (labjack-nodejs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

LabJack-nodejs

UPDATED FOR LJM VERSION 1.03

Installation notes for windows: Make sure that node-gyp is properlly installed. Peforming the standard npm install command will fail on windows. It will hopefully complain about not having proper "TargetFrameworkVersion or PlatformToolset variables not being set. If this is true, set them: "npm install --msvs_version=2012" or 2013.

This hint came from someone building couchbase

nodejs library for using LJM library.

Created two different objects, device.js and driver.js, that can be imported.
Was created to function much like the LabJack Python driver for LabJack UD devices.
For more information about what each function does, please look at the LabJackM.h file that can be downloaded & installed from LabJacks Software & Driver page.

Currently this wrapper only supports the T7 and T7-Pro LabJack devices. (Which are low cost, high-quality, multifunction USB / Ethernet / 802.11b/g Wifi DAQ devices!)

Device (device.js)

Manages the handle for you & aims to simplify the interface with the LJM driver.

This driver wrapper was created supporting both synchronous and asynchronous function calls to support both functional and object-oriented programing styles. The general format is shown below:

//Synchronous syntax:
var result = exampleFunctionSync(arg1);

//Asynchronous syntax (requiring function callbacks):
exampleFunction(
    arg1,
    function(err) {
        console.log('error', err);
    },
    function(result) {
        console.log('success', result);
    }
);

How To Use:

Before writing any code you must create a device or driver object:

//Device object (to control a LabJack device)
var deviceManager = require('device');
var device = new deviceManager.labjack();

Now you can use any of the implemented functions by:

//not using callbacks
device.exampleFunctionSync();

//using callbacks
device.exampleFunction(
    function (err) {
        console.log('error', err);
    }, 
    function (result) {
        console.log('success', result);
    }
);

//you can also use other callback handlers
onError = function(res)
{
    console.log('error', res);
};
onSuccess = function(res)
{
    console.log('success', res);
};
device.exampleFunction(arg1, arg2, onError, onSuccess);

Available Functions & what they use:

open():

Uses LJM_Open and LJM_OpenS

device.openSync(); //opens the first found labjack device, LJM_OpenS('LJM_dtANY', 'LJM_ctANY', 'LJM_idANY')
device.openSync('LJM_dtANY', 'LJM_ctANY', 'LJM_idANY'); //Connect to first-found device
device.openSync('LJM_dtT7', 'LJM_USB', '470010642'); //Connect to T7 w/ serial number 470010642 connected via USB
device.openSync('LJM_dtT7', 'LJM_ETHERNET', '470010642'); //Connect to T7 w/ serial number 470010642 connected via ETHERNET
device.openSync('LJM_dtT7', 'LJM_WIFI', '470010642'); //Connect to T7 w/ serial number 470010642 connected via WIFI
device.openSync(7, 1, 470010642); //Connect to T7 w/ serial number 470010642 connected via USB

//example with callback:
var onSuccess = function(result) {
    //Code
}
var onError = function(error) {
    //Code
}
//Connect to first-found device w/ callbacks
device.open(
    'LJM_dtANY',
    'LJM_ctANY',
    'LJM_idANY',
    onError, 
    onSuccess
);

getHandleInfo():

Uses LJM_GetHandleInfo

devInfo = device.getHandleInfoSync(); //return the handle info in a dict:
//devInfo is a dictionary with attributes: deviceType, connectionType, serialNumber, ipAddress, port, maxBytesPerMB
devInfo.deviceType; //The device type (7 for T7s)
devInfo.connectionType; //The connection type, 1(USB), 3(ETHERNET), 4(WIFI)
devInfo.serialNumber; //The serial number of the open device
devInfo.ipAddress; //IP address string for the open device
devInfo.port;
devInfo.maxBytesPerMB;

readRaw(data array):

Uses LJM_ReadRaw

read(address 'number' or 'string'):

Uses LJM_eReadAddress, LJM_eReadName, LJM_eReadNameString, and LJM_eReadAddressString.

value = device.readSync('AIN0'); //returns the AIN0 channel reading
value = device.readSync(0); //returns the AIN0 channel reading
value = device.readSync('DEVICE_NAME_DEFAULT'); //returns the name of the device

//example with callback:
value = device.read(
    'AIN0',
    function (res) {
        console.log('err:', res);
    },
    function (res) {
        console.log('ain0Reading:', res);
    }
);

readMany(addresses 'number' or 'string' array):

Uses LJM_eReadAddresses and LJM_eReadNames

value = device.readManySync(['AIN0', 'AIN1']); //returns an array with AIN0 and AIN1 readings
value = device.readManySync([0, 1]); //returns an array with AIN0 and AIN1 readings

writeRaw(data array):

Uses LJM_WriteRaw

write(address 'number' or 'string', value 'number' or 'string'):

Uses LJM_eWriteAddress, LJM_eWriteName, LJM_eWriteAddressString, and LJM_eWriteNameString

errRes = device.writeSync('DAC0', 1.0); //instructs the T7 to set DAC0 analog output to 1V, returns an error number
errRes = device.writeSync(1000, 1.0); //instructs the T7 to set DAC0 analog output to 1V, returns an error number
value = device.writeSync('DEVICE_NAME_DEFAULT', 'NewDeviceName'); //writes a new device name to the device

//example with callback:
errRes = device.write(
    'DAC0',
    1.0,
    function (res) {
        console.log('err:', res);
    }, 
    function (res) {
        console.log('SUCCESS');
    });

writeMany(addresses array 'number' or 'string', values array 'number' or 'string')

writeMany(dict array {addr, vals}):

Uses LJM_eWriteAddresses LJM_eWriteNames

//Two Arrays
//using two separate arrays, one for addresses to write to and one of values
errRes = device.writeManySync(['DAC0', 'DAC1'], [1.0, 2.0]);
errRes = device.writeManySync([1000, 1002], [1.0, 2.0]);

close():

Uses LJM_Close

errRes = device.closeSync();

//example with callback:
device.close(
    function(res){
        console.log('Err:', res);
    },
    function(res){
        console.log('closed!');
    });

All Relevant 'libLabJackM' Functions:

LJM_Open
LJM_OpenS
LJM_GetHandleInfo
LJM_ResetConnection
LJM_Close
LJM_WriteRaw (NOT TESTED)
LJM_ReadRaw (NOT TESTED)
LJM_eWriteAddress
LJM_eReadAddress
LJM_eWriteName
LJM_eReadName
LJM_eReadAddresses
LJM_eReadNames
LJM_eWriteAddresses
LJM_eWriteNames
LJM_eAddresses
LJM_eNames
LJM_eStreamStart
LJM_eStreamRead
LJM_eStreamStop
LJM_eReadString
LJM_eWriteString

LJM_Driver (driver.js)

JavaScript wrapper for the rest of the LJM_Driver functions.

How To Use:

Before writing any code you must create a driver object:

//Driver Object (to gain access to more general driver-related features)
var driverManager = require('driver');
var ljmDriver = new driverManager.ljmDriver();

Available Functions & what they use:

listAll(deviceType 'number' or 'string', connectionType 'number' or 'string'):

Uses LJM_ListAll and LJM_ListAllS

foundDevices = ljmDriver.listAllSync(); //find all T7s
foundDevices = ljmDriver.listAllSync('LJM_dtANY', 'LJM_ctANY'); //find all T7s
foundDevices = ljmDriver.listAllSync('LJM_dtT7', 'LJM_ctUSB'); //find all T7s connected via USB
foundDevices = ljmDriver.listAllSync(7, 1); //find all T7s connected via USB


//using callback functions
ljmDriver.listAll(
    function (err) {
        console.log('Error', err);
    }, 
    function (foundDevices) {
        console.log('Devices Found:');
        console.log(foundDevices);
    }
);

//Both methods return an array of dicts, ex:
//foundDevices.length is the number of devices found
//foundDevices[0].deviceType is a number
//foundDevices[0].connectionType is a number
//foundDevices[0].serialNumber is a number
//foundDevices[0].ipAddress is a string

errToStr(errorNumber):

Uses LJM_ErrorToString, converts an error number to a human-readable string-error. The errors can be found in the ljm_constants.json file.

console.log(ljmDriver.errToStrSync(0)); //returns the string 'Num 0, LJ_SUCCESS'
console.log(ljmDriver.errToStrSync(200)); //returns the string 'Num 200, LJME_WARNINGS_BEGIN'
console.log(ljmDriver.errToStrSync(1268)); //returns the string 'Num 1268, LJME_INVALID_INDEX'

loadConstants():

Uses LJM_LoadConstants

closeAll():

Uses LJM_CloseAll

readLibrary('string' parameter):

Uses LJM_ReadLibraryConfigS, helpful for using LJM's logging features

readLibraryS('string' parameter):

Uses LJM_ReadLibraryConfigStringS, helpful for using LJM's logging features

writeLibrary('string' parameter, value either 'number' or 'string'):

Uses LJM_WriteLibraryConfigS and LJM_WriteLibraryConfigStringS, helpful for using LJM's logging features

logS('number' logLevel, 'string' message to log):

Uses LJM_Log

resetLog():

Uses LJM_ResetLog

All Relevant 'libLabJackM' Functions:

LJM_AddressesToMBFB
LJM_MBFBComm
LJM_UpdateValues
LJM_NamesToAddresses
LJM_AddressesToTypes
LJM_AddressToType
LJM_ListAll
LJM_ListAllS
LJM_ErrorToString
LJM_LoadConstants
LJM_CloseAll
LJM_WriteLibraryConfigS
LJM_WriteLibraryConfigStringS
LJM_ReadLibraryConfigS
LJM_ReadLibraryConfigStringS
LJM_Log
LJM_ResetLog