Using the internal USB port

  • Male USB-C to male USB-A or USB-C cable

  • Computer with a USB port

  • Serial terminal

If the instrument is not connected to a charged internal battery, an external power supply is needed.

Connecting to the internal USB port

The internal USB port should only be used in a raised, dry, covered area, such as an indoor lab bench, the back of a hatched vehicle, or an outdoor table covered by an awning.

Intended uses

  • Configuring or updating the instrument.

  • Retrieving data from the instrument.

  • Performing detailed diagnostics on the instrument.

To use the internal USB port

  1. Follow the steps in Opening the instrument to access the internal.

  2. Connect your computer to the USB-C port shown to the right.

  3. If the instrument is not connected to a charged internal battery:

    1. Connect the MCIL-6-FS RS-232 to USB-C cable to the MCBH-6-MP RS-232 connector on the instrument’s endcap.

    2. Connect the terminal block on the MCIL-6-FS RS-232 to USB-C cable to an external power supply set to 12V and ideally limited to 1A.

    3. Power on the external power supply.

    4. Wait ~15s for the instrument to boot. Current will drop from ~150-200mA to ~50mA.

  4. Enumerate USB devices (in Device Manager on Windows, in "/dev" on Linux) to check that your computer recognizes the instrument.

20240226 140243 1

USB-C port on the internal RBRcervello faceplate

Windows

On a Windows-based workstation, use any terminal emulator console that supports a serial port, such as Tera Term.

Tera Term

Tera Term is an open-source terminal emulator that lets you connect to hosts via serial port or the network. The default settings should work with the RBRcervello interface. In the unlikely event when they do not, load the configuration file provided below using the "Setup→Restore setup" menu.

teraterm cervello menu 2

Tera Term

Alternatively, configure the settings manually as follows:

  • In "Setup→Terminal setup" menu, enter the terminal size:

terminal settings 2
  • In "Setup→Keyboard setup" menu, select "Delete key":

keyboard settings 2
  • In "Setup→Serial port setup and connection" menu, select the correct COM port:

serial settings 2

Highlighting text on the terminal automatically copies it to the clipboard. Right-clicking on the terminal will paste the saved text on it.

Linux

On a Linux-based workstation, use any terminal emulator console that supports a serial port, such as Minicom.

Minicom

Minicom is a serial communication program that connects to devices through a GNU/Linux serial ports. Use the "-s" command to set up the terminal with the right port and settings, or execute it with explicit settings at runtime with the correct device:

minicom -D /dev/ttyACM0
image2023 3 15 12 30 11 2

Minicom

image2023 3 15 12 27 46 2

Minicom serial settings

To copy and paste text from and to a Linux terminal, use Ctrl+Shift+C and Ctrl+Shift+V.

Due to the nature of virtual serial ports, the baudrate is unimportant and can be set to an arbitrary value.

Diagnostic menu overview

Access the RBRcervello menu via the diagnostic port. It is a fully-featured Bash terminal (Restricted Bash) with "tab" completion. To see the list of available commands, execute the "help" command. You will find all you need to deploy the RBRcervello with the RBR instruments. As a quick in-menu reference, each command displays a short manual when executed with the "-h" or "--help" argument.

image2023 3 15 12 31 11 2

"status" help

RBRcervello Menu.

These are the available commands to manage RBRcervello

   disable               Disable deployment.
   status                Provide a general overview or detailed information on
                         controller and instruments.
   mount-storage         Mount the data to the host computer.
   unmount-storage       Unmount the data to the host computer.
   diagnose              Diagnostics for MLM and telemetry.
   transparent-link      Establish a transparent link to an instrument
                         serial port.
   config-check          Print the configuration of a specific RBR subsystem.
   edit-config           Edit the configuration of a specific RBR subsystem.
   set-instrument-clock  RBR instrument clock sync.
   set-cervello-clock    RBRcervello clock setter.
   cervello-clock        RBRcervello clock checker.
   scrub-controller      Clear all data stored in the SD card.
   scrub-instrument      RBR instrument scrubber.
   enable                Enable deployment according to internal configuration
                         files.
   reboot-controller     Reboot the controller.
   help                  Show this menu.

See the Diagnostic menu section for more information.