Neobotics Foundation Inc.
Test the systemNEORACER DOCS
NEORACER DOCS
These docs are public and open source.Edit on GitHub

TEST THE SYSTEM

~15 minutes
//You'll need
  • A NeoRacer.
  • A laptop connected to the NeoRacer's router.

RUN THE ASYNC CORE TEST

The Async Core Test notebook checks every sensor and control surface on the car and prints a pass/fail summary at the end.

  • Open http://192.168.10.100:8888 in a browser. JupyterLab opens with the file browser on the left.
    JupyterLab open in a browser at 192.168.10.100:8888, with the file browser highlighted on the left
  • In the file browser, go to neoracer-os → labs → tests.
    The file browser path neoracer-os/labs/tests with the test files listed
  • Double-click test_async_core_real.ipynb to open it.
    The Async Core Test notebook open in JupyterLab
  • Run the notebook from the toolbar at the top of the tab. The play button (red box) runs the selected cell and moves to the next one; the double arrow (blue box) restarts the kernel and runs every cell in order. Either works, as long as the cells run in order.
    The notebook toolbar with the run-cell button boxed in red and the restart-and-run-all button boxed in blue
  • Each test follows the same shape: a title, a short explanation of what is being tested, the code, and the output it prints below. Watch the outputs as they appear.
    A typical test cell with its title and explanation, code block, and printed output

READ THE SUMMARY

The last cell of the notebook prints a summary of every test. On a healthy car it looks like this:

output
================================================================
  NeoRacer - Async Core Test Results
================================================================
  [PASS] Forward camera (/camera/color)
  [PASS] LIDAR (/scan)
  [PASS] IMU (/imu/fused, /mag)
  [PASS] Controller (/joy)
  [PASS] Drive publisher (/drive)
  [PASS] Mux observation (/mux_out)
  [PASS] Battery voltage (/battery/voltage)
  [PASS] FlySky RC (/rc/channels)
  [PASS] Encoder (/encoder/speed)
  [PASS] Dot-matrix (/dotmatrix/text)
  [PASS] Telemetry (CSV + PNG + /diagnostics)
  [PASS] Vision (/edgetpu/inference)
  [PASS] Diagnostics (/diagnostics)
----------------------------------------------------------------
  Not available on this platform (raises NotImplementedError):
  [ -- ] Depth stream (/camera/depth)
         no depth sensor; forward camera is monocular
  [ -- ] Battery current (/battery/current)
         no current shunt on the OSRbot base
  [ -- ] LED strip (/led/pixels)
         no addressable strip
  [ -- ] Dot-matrix pixels (/dotmatrix/pixels)
         panel firmware takes text only
================================================================
  Overall: ALL PASS
================================================================

The four [ -- ] entries are expected: they are features the NeoRacer's hardware does not have, and the library reports them as NotImplementedError by design. Anything printed as [FAIL] names the subsystem to look at.

RESET THE NOTEBOOK

  • When you are done, open the Kernel menu and choose Restart Kernel and Clear Outputs of All Cells.
    The Kernel menu with Restart Kernel and Clear Outputs of All Cells highlighted