Man page - nxt-test(1)

Packages contains this manual

Package: python3-nxt
apt-get install python3-nxt

Manuals in package:

Documentations in package:

python3-nxt

Manual

NXT-TEST

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
COMMON OPTIONS
EXAMPLES
SEE ALSO
AUTHOR
COPYRIGHT

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) 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.

AUTHOR

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

COPYRIGHT

2021-2025, Nicolas Schodet