---
name: "nxt-test"
section: "1"
platform: "linux"
package: "python3-nxt"
version: "3.5.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/nxt-test"
---

# nxt-test(1)

Test the NXT-Python setup

## NAME

nxt-test - Test the NXT-Python setup

## SYNOPSIS

**nxt-test** \[**–backend** *NAME*\] \[**–config** *NAME*\] \[**–config-filename** *PATH*\] \[**–name** *NAME*\] \[**–host** *ADDRESS*\] \[**–server-host** *HOST*\] \[**–server-port** *PORT*\] \[**–filename** *FILENAME*\] \[**–no-sound**\] \[**–log-level** *LEVEL*\]

## DESCRIPTION

**nxt-test** tests connection with a NXT brick. It allows one to debug the NXT-Python setup.

The NXT brick can be connected using USB, Bluetooth or over the network.

## OPTIONS

- **--no-sound**

  Be quiet, disable the sound test.

- **--log-level** *LEVEL*

  Set the log level. One of **DEBUG**, **INFO**, **WARNING**, **ERROR**, or **CRITICAL**. Messages whose level is below the current log level will not be displayed.

## COMMON OPTIONS

Those options are common to programs using NXT-Python.

- **--backend** *NAME*

  Enable given backend. Can be used several times to enable several backends. One of *usb*, *bluetooth*, *socket* or *devfile*.

- **--config** *NAME*

  Name of configuration file section to use.

- **--config-filename** *PATH*

  Path to configuration file. Can be used several times to use several configuration files.

- **--name** *NAME*

  Name of NXT brick (for example: NXT). Useful to find the right brick if several bricks are connected.

- **--host** *ADDRESS*

  Bluetooth address of the NXT brick (for example: 00:16:53:01:02:03).

- **--server-host** *HOST*

  Server address or name to connect to when using *socket* backend.

- **--server-port** *PORT*

  Server port to connect to when using *socket* backend.

- **--filename** *FILENAME*

  Device filename (for example: **/dev/rfcomm0**), when using *~nxt.backend.devfile* backend.

See **[nxt-python.conf(5)](/nxt-python.conf/5.md)** documentation for better explanation of the options to find the NXT brick.

## EXAMPLES

Running for a NXT brick connected using USB:

```
$ nxt-test
Finding brick...
NXT brick name: NXT
Host address: 00:16:53:01:02:03
Bluetooth signal strengths: (0, 0, 0, 0)
Free user flash: 48480
Protocol version 1.124
Firmware version 1.29
Battery level 8433 mV
Play test sound...done
```

To report problems, please enable debug logs:

```
$ nxt-test --log-level DEBUG
```

When debugging Bluetooth connection problems, try to give the address explicitly:

```
$ nxt-test --log-level DEBUG --host 00:16:53:01:02:03
```

The address can be found in the “Settings” menu, under “NXT Version” screen, it is the last line labeled “ID”. Add the colon to separate each pair of digits.

## SEE ALSO

**[nxt-python.conf(5)](/nxt-python.conf/5.md)**

NXT-Python documentation \<*https://ni.srht.site/nxt-python/latest/*\>

## AUTHOR

This program is part of NXT-Python which is currently maintained by Nicolas Schodet.

## COPYRIGHT

2021-2025, Nicolas Schodet