Configure a LabJack Device
Learn how to connect and configure LabJack devices.
Prerequisites
Before you can start using your LabJack hardware with Synnax, you will need to ensure that you have the following:
- A Synnax Core running on your network.
- A Synnax Driver running on your network. This Driver must be connected to the Core and running on the same machine as your LabJack hardware is connected to.
- The LJM library installed on the machine running the Synnax Driver.
- The Synnax Console installed on your local machine.
Configuration Parameters Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable device name for identification in Console |
rack | string | Yes | Synnax Driver (rack) key where the device is connected |
model | string | Yes | LabJack model (LJM_dtT4, LJM_dtT7, or LJM_dtT8) |
location | string | Yes | Physical connection identifier (see below) |
identifier | string | Yes | Device identifier: serial number, IP address, device name, etc. |
connection_type | string | No | Connection method: ANY (default), USB, TCP, ETHERNET, or WIFI |
connection_type is only supported through the Python and TypeScript client
libraries.
How-To
Before you begin, connect to your device and update it using Kipling.
Synnax will automatically detect new LabJack devices and display a notification in the Console when a new device is connected. To start configuring the device, find the device in the Devices Toolbar, right click on the device and select “Configure”.
import synnax as sy
from synnax.hardware import labjack
# Connect to Synnax
client = sy.Synnax()
# Get the embedded rack (local driver rack)
rack = client.hardware.racks.retrieve_embedded_rack()
# Configure device connection
device = labjack.Device(
model=labjack.T7, # Model: T4, T7, T8
identifier="ANY", # Serial number, IP, name, or "ANY"
name="My LabJack T7", # Device name
location="ANY", # Connection identifier
rack=rack.key, # Rack key
connection_type="ANY", # "ANY", "USB", "TCP", "ETHERNET", "WIFI"
)
# Create the device in Synnax
device = client.hardware.devices.create(device)
# Or retrieve by model
device = client.hardware.devices.retrieve(model="LJM_dtT7")
# Or retrieve by name
device = client.hardware.devices.retrieve(name="My LabJack T7")
print(f"Device configured: {device.name} (key={device.key})")import { Synnax } from "@synnaxlabs/client";
// Connect to Synnax
const client = new Synnax();
// Get the embedded rack (local driver rack)
const rack = await client.hardware.racks.retrieveEmbeddedRack();
// Configure device connection
const device = await client.hardware.devices.create({
rack: rack.key,
name: "My LabJack T7",
make: "LabJack",
model: "LJM_dtT7", // Model: LJM_dtT4, LJM_dtT7, LJM_dtT8
location: "ANY", // Connection identifier
properties: {
connection: {
identifier: "ANY", // Serial number, IP, name, or "ANY"
connection_type: "ANY", // "ANY", "USB", "TCP", "ETHERNET", "WIFI"
},
read: {
index: 0,
channels: {},
},
write: {
channels: {},
},
},
});
// Or retrieve by model
const device = await client.hardware.devices.retrieve({ model: "LJM_dtT7" });
// Or retrieve by name
const device = await client.hardware.devices.retrieve({ name: "My LabJack T7" });
console.log(`Device configured: ${device.name} (key=${device.key})`);