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.

SEE ALSO

       nxt-python.conf(5)

       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

3.5.1                                             Jan 12, 2025                                       NXT-TEST(1)