LabVIEW for LJM - Windows & macOS | LabJack
 
« Close

Datasheets and User Guides

App Notes

Software & Driver

 

LabVIEW for LJM - Windows & macOS

The LJM library is the high level code library for T-Series devices. LabVIEW is one of the most popular programming languages used by our customers. LabVIEW is a graphical programming language, as demonstrated in the code snippet below, but understand that it is still a powerful programming language not a simple software tool.

http://www.ni.com/gettingstarted/labviewbasics/

Note that using a LabJack in LabVIEW is not identical to using NI hardware in LabVIEW.  The NI hardware is talked to through the NI-DAQ driver, while the T7 or T4 is talked to through the LabJack LJM library.  That means that you will not use measurement & automation explorer, DAQ assistant, or similar NI wizards.

Prerequisites

 

LJM LabVIEW Examples (Software Platform)

LabVIEW example VIs for the LJM library.

Release
Beta

LJM LabView Examples Top (Referencable)

    Getting Started

    1. Experienced LabVIEW programmer?  Proceed to next step.  If you are new to LabVIEW, you need to know the basics such as loops, case structures, arrays, clusters, data types, indicators and controls.  Perhaps most importantly you need to understand the "dataflow" concept, which is one of the biggest differences between LabVIEW and a text language.
    2. Go to the T4 or T7 Quickstart Tutorial and follow the steps to install Windows software and confirm basic operation.
    3. Download the LabVIEW_LJM archive (at the top of this page) and extract the entire archive.
    4. In LabVIEW you will be making calls to our LJM Library to write and read registers on the device.  Go to the main LJM Page for an introduction, and proceed to the LJM User's Guide for more details.
    5. For more information about what registers to write and read, see the T4 or T7 Datasheet and the Modbus Map.
    6. Navigate to the folder \LabVIEW_LJM\Examples\Basics and try out "LJM_eReadName Example.vi".
    7. Move on to the very useful example "Write Read Loop with Config.vi".

    LJM Examples Where Is An Example To Do XYZ (Referencable)

    Overview

    With the LJM library, pretty much everything you might want to do with a device is accomplished by writing and/or reading some registers.  Look at the device's datasheet (T7 or T4) or the Modbus Map to determine what registers you need to write and read, then use eWriteName (or eWriteNames) to write the desired registers and eReadName (or eReadNames) to read the desired registers.  The following examples in the Basic folder are a great place to start:

    • LJM_eWriteName Example
    • LJM_eWriteNames Example
    • LJM_eReadName Example
    • LJM_eReadNames Example
    • Write Read Loop with Config

    Where is an example to do XYZ?

    You will find lots of examples in this archive, but there is not an example for everything the LabJack can do.  The reason for this stems from the "Overview" section above.  Most operations simply involve writing and reading different registers, so you really just need examples that show you how to write and read any register.  If we had examples for every operation, they would just be copies of the example "Write Read Loop with Config" with different registers. The typical workflow to do almost anything beside stream is:

    1. Look at the T-series Datasheet or the Modbus Map to determine what registers you need to write and read.
    2. Use the Register Matrix in Kipling to test writing and reading your desired registers and confirm you see what you expect to see.  This step is optional and not always applicable.
    3. Use eWriteName (or eWriteNames) to write the desired registers and eReadName (or eReadNames) to read the desired registers. Or just use "Write Read Loop with Config", which provides the basic structure used by many user applications.

    Stream mode and other operations that don't fit in "Write Read Loop with Config" will usually have specific examples, and if something seems to be missing let us know.

    LJM LabView Examples Bottom (Referencable)

    LabVIEW_LJM Archive Contents

    The downloadable zip file "LabVIEW_LJM.zip" extracts to a single folder called "LabVIEW_LJM" which contains a few subfolders.  The folder can be stored anywhere, but if you want icons to show up on the LabVIEW function palette (after restarting LabVIEW), place this folder under ...\national instruments\labview #\vi.lib\addons\ (create the addons folder if it does not exist).  Be sure the folder containing our LabVIEW functions is named "LabVIEW_LJM" when added to the LabVIEW addons folder or else the icons may not load properly. If you just see question marks, see this forum topic.

    Many people, including us, do not use the palette icons but rather just copy paste from examples and use the "Select a VI..." balloon from the function palette.  In that case you can put the LabVIEW_LJM folder wherever you want.

    We recommend not having more than one copy of the VIs, and not changing these VIs.  If you want to make your own variation of one of the examples, make a copy in a different location and modify that.

    If you download new VIs from labjack.com, delete and replace the entire LabVIEW_LJM folder.

    The \Functions folder contains simple VIs that do little more than call functions from LJM.  Most of these need a valid Handle input so are intended to be sub-VIs not standalone top level VIs.

    The \LVUtilities folder contains VIs that encapsulate some useful functions.  These are used by other VIs from the \Functions\ and \Examples\ folders to handle things unique to LabVIEW.

    The \Examples\Basics folder contains core examples that demonstrate the basics of interfacing LabVIEW with our LJM library.  Included here is the very useful "Read Write Loop with Config.vi" example which forms the basis for most customer applications.  Use the device datasheet (and/or Modbus Map) to determine what registers you need to write and read and the plug those register names into "Read Write Loop with Config.vi".

    The \Examples\More folder has many more examples that demonstrate specific tasks.  Some of these demonstrate unique techniques, but many are simply variations of the "Write Read Loop with Config.vi" example with different default register names and values.

    The \LJLogM and \LJStreamM folders contain the source code for those sample programs.  The executable versions (.exe) are part of the main LabJack software installer for Windows.  Advanced LabVIEW programmers might find this source code useful, but most users are better off starting with a more basic example.

    Code Snippet

    This example uses 5 calls to the LJM library:

      • LJM_OpenS specifies which device you want to open and returns a handle for that device.
      • LJM_GetHandleInfo returns information about the device we just opened.
      • We pass a register name to LJM_eReadName and it reads the value of that register.  In this case we are reading the register named "SERIAL_NUMBER" which returns the serial number of the device.  For more names refer to the T7 Datasheet or Modbus Map.
      • LJM_Close closes the connection to the device so it is available to other processes.
      • LJM_ErrorToString converts the numeric error code to a readable string.

        Errorcodes

        6000 is added to the LabJack errorcodes to shift them into the LabVIEW user range of 5000-9999.  For example, if the open call cannot find the device you requested it will return LabVIEW-LJM errorcode 7227, which is LabJack-LJM errorcode 1227.  Many errorcodes are listed in Section 4 of the LJM User's Guide, but no need to look there for the basic string as every LabVIEW program should use LJM_ErrorToString.vi to convert the errorcode to a readable string.

        Debugging Sub-VIs

        All sub-VIs, which means everything in the Functions and LVUtilities folders, are set to reentrant execution.  In older versions of LabVIEW, debugging is not allowed when reentrant is enabled, so debugging is disabled in all sub-VIs.

        To allow debugging in sub-VIs in older LabVIEW, you will have to disable reentrent execution.  Go to File => VI Properties, set Category = Execution, un-check Reentrant execution, and check Allow debugging.  In newer versions of LabVIEW, you can enable debugging with reentrant enabled.

          

          

        **Note**:  2 substantial changes were made to the LabVIEW_LJM archive with the 2015_01_23 release:

        1.  In LJM function call VIs that have the NumFrames parameter, that parameter is now optional with a default value of -1 which means "Auto-Detect the Number of Frames".  If you do not wire anything to NumFrames, or pass -1, this signals the VI to use the size of aNames or aAddresses to determine the number of frames.  This should not break any code using previous versions of these VIs.

        2.  A few changes were made to the inputs & outputs of LJM_eStreamStart.vi, and these changes will break code using a previous version of this VI.  See the front panel of LJM_eStreamStart.vi for more details.

         

        Version History

        For version history, see our Github repository.

        9 comments

        when I run "DIO EF Config 1 PWM and 1 Counter.vi" I have an error message: "LabJack Error #2508:  HW_CNTR0_NOT_AVAILABLE occured at LJM_eWriteAddresses.vi"

        The problem is that that example enables Clock0 for the PWM output.  Clock0 uses CounterA & CounterB so they are not available:

        http://labjack.com/support/datasheets/t7/digital-io/extended-features/ef...

        We will change the example to use CounterC on CIO2.

        In the config list use:

        DIO18_EF_TYPE
        DIO18_EF_ENABLE

        ... and then read:

        DIO18_EF_READ_A

        Forgot to click the "List" box.  Now it is showing.

        "LabJack Error #1298:  LJME_ATTR_LOAD_COMM_FAILURE occured at LJM_OpenS.vi"

        LV2014, 64bit machine.  The LJControlPanel and LJStreamUD work just fine.

        The .dll is installed in the systems32 folder.

        What LabJack are you using? The LJM driver and examples only support the LabJack T7 and Digit. For UD devices (U3/U6/UE9) use the UD driver and examples:

        http://labjack.com/support/ud/examples/labview

        dhananjayan's picture

        is that possible to connect analog and counter input simultaneosly in labjack t7

         

        LabJack Support's picture

        Yes you can connect lots of things at the same time.

        I would start by going through the counter tutorial to learn how to configure it and confirm your signal works with the counter:

        https://labjack.com/support/software/applications/t-series/kipling/register-matrix/counter-example

        That shows you which register or registers you need to write to configure the feature, and which register to read to get the count value.  Then you can do the same in LabVIEW using the example "Write Read Loop with Config.vi", and can read any "AIN#" registers at the same time.

        dhananjayan's picture

        when i try to the example stream program for fast counter 16 and 17 it shows the error message.

        help me how to solve this .

        LabJack Error #2509: HW_CNTRB_NOT_AVAILABLE Occurred at LJM_eWriteAddress.VI