# Configure a LabJack device

> Connect a LabJack T4 or T7 to the Driver and configure it for tasks.

The Driver connects to [LabJack](https://labjack.com/) T4, T7, and T8 devices over USB, Ethernet, or Wi-Fi. It finds them with the LabJack LJM library. Before a task can use a device, you configure it.

## Prerequisites

* Supported

  WindowsmacOS

* Not supported

  LinuxNI Linux RTDocker

- Install the [LJM library](https://support.labjack.com/docs/ljm-software-installer-downloads-t4-t7-t8-digit) on the computer that runs the Driver. The Driver loads it on its next scan, so you do not need to restart the Driver.
- Connect the device to that computer by USB, or to the same network.

## How the Driver finds devices

The Driver looks for LabJack devices every few seconds. A USB device shows in the [devices toolbar](https://docs.synnaxlabs.com/reference/hardware/devices#devices-toolbar) within a few seconds. A device on the network can take about a minute.

* **Name** -> the model and the last four digits of the serial number, such as `LJM_dtT7-8422`.
* **Location** -> the connection, such as `LJM_ctUSB` or `LJM_ctETHERNET`.

The Console also shows the notification “New LJM_dtT7 connected”, with a **Configure** button.

If the Driver does not find a device on the network, for example because the device is on another subnet, add the IP address of the device to the LJM [`ljm_specific_ips.config`](https://support.labjack.com/docs/ljm-specific-ips) file.

## Configure a device

[Enterprise](https://docs.synnaxlabs.com/reference/get-started/editions "Needs Synnax Enterprise")

**Console**

1. In the devices toolbar, right-click the device and select **Configure**. You can also click **Configure** in the “New … connected” notification. To list each device that the Driver found, click and select **LabJack hardware**.
2. Enter a **Name** and an [**Identifier**](https://docs.synnaxlabs.com/reference/hardware/devices#identifiers), or click one of the identifiers that the Console suggests.
3. Click **Save**. To also open a read task for the device, click **Save and create read task**.

[](https://synnax.nyc3.cdn.digitaloceanspaces.com/docs/device-drivers/labjack/configure-device/lj-configure/04be4350958f-dark.mp4#t=0.001)

**Python**

Find the LabJack devices that the Driver found:

```python
for dev in client.devices.retrieve(makes=["LabJack"]):
    print(dev.key, dev.name, dev.model, dev.location)
```

The key of a LabJack device is its serial number. Configure devices in the Console.

**TypeScript**

Find the LabJack devices that the Driver found:

```typescript
const devices = await client.devices.retrieve({ where: { make: { eq: "LabJack" } } });
for (const dev of devices) console.log(dev.key, dev.name, dev.model, dev.location);
```

The key of a LabJack device is its serial number. Configure devices in the Console.

Do not create LabJack devices in code. The Driver opens a device by its serial number, so only a device that the Driver found works in a task.

## Troubleshooting

* [The device does not show in the devices toolbar.](https://docs.synnaxlabs.com/reference/hardware/labjack/configure-device#the-device-does-not-show-in-the-devices-toolbar)

  * Cause

    The Driver cannot load the LJM library, or it runs on Linux.

  * Fix

    * **LJM is not installed** -> install the LJM library. The device shows after the next scan.
    * **The Driver runs on Linux** -> LabJack devices do not work on Linux. Run the Driver on Windows or macOS.

    For more causes, see [Troubleshoot hardware](https://docs.synnaxlabs.com/reference/hardware/troubleshooting#a-device-does-not-show-in-the-devices-toolbar).

* [The Driver cannot reach the device.](https://docs.synnaxlabs.com/reference/hardware/labjack/configure-device#the-driver-cannot-reach-the-device)

  * Cause

    The task shows “Failed to start task”, “Failed to read data”, or “Failed to write commands”, with this text in the description. Causes:

    * The USB cable or the network connection is lost, or the device has no power.
    * Another program holds the device. A USB device works with one program at a time.

  * Fix

    1. Check the USB cable, the network, and the power to the device.
    2. Close [Kipling](https://support.labjack.com/docs/kipling) and other LabJack software.

    A running task continues when the Driver reaches the device, and the Driver sets up the channels of the device again. A task that failed to start does not retry. Start it again.

For other problems, see [Troubleshoot hardware](https://docs.synnaxlabs.com/reference/hardware/troubleshooting).