Field Service Menu (FSM)

From sdk-wiki
Jump to: navigation, search


The Field Service Menu (FSM) is a pre-boot configuration menu that allows the user to do advanced tasks such as check network interface configuration, change the robot computer's hostname, and run low-level hardware checks.

float align=right


The primary purpose of the Field Service Menu (FSM) is to give the user access to low-level, computer configuration options on the robot, especially:

  • Edit Hostname
  • Edit Network Configuration
    • Set Static IP/DNS
    • Set NTP Servers
    • Set ROS naming convention
  • Edit Timezone
  • Change Run Mode (RSDK vs Demo Mode)

The FSM also provides the ability to run low-level hardware tests to do light-weight verification of hardware components that sit below the robot application software level.

Quickstart - FSM Activation / Deactivation

Accessing the FSM

The FSM can only be accessed by hitting a specific key combination during robot boot-up:

  1. Turn off Baxter with the Power button. Wait for complete shutdown (no lights, no noise).
  2. Plug in a USB keyboard to Baxter's USB port (on rear).
  3. You will need to hit <Alt+FF> on the keyboard during the boot-up to trigger the FSM:
    • Turn Baxter back on by hitting the Power button.
    • Once you see the Rethink Animation ...
    • ... on your keyboard, start repeatedly hitting the key combination <Alt+FF>
      (Hit and hold the Alt key, press down on the F key, release, press down on the F key again, release both and repeat).
  4. Repeat this key combination until you see the FSM screen come up:
    • If you hit a screen that says "Loading...", you missed your chance.

Use the Up/Down arrow keys to change menu selections, and the Enter key to go into a menu or select an option.

Exiting: Disabling the FSM

Important: Once the FSM is activated, it will come up every boot thereafter -- unless Disabled before exiting the menu.

To disable the FSM from reappearing next boot:

  1. Select the 'Disable field service menu' option and hit Enter.
    You should now see a line near the top saying: On next boot FSM will be disabled
    Fsm disabled.png
  2. You can now leave the FSM through any of the normal Exit Actions, such as Reboot Robot.

Menu Functions

After Activating the FSM, the top level of the Field Service Menu provides access to three sub-menus and shutdown/reboot options.

Configuration Menu

This menu provides access to Baxter's hostname, timezone, and network configuration information. Information here is useful for setting up Baxter on your Network.


  • Hostname - Rename your Baxter (i.e. change robot computer's hostname)
    Changing the Hostname will also change Baxter's network identity name.
    Upon reboot, Baxter will then be accessible via the new name followed by '.local', rather than by the serial number (default hostname). In the case shown in the screenshot, Baxter's new avahi address would be test.local.
  • Addr Type - Change the network addressing method from DHCP to Custom
    Toggling this will set Address, Netmask, Gateway, and DNS Server to blank, and enable editing them
  • ROS Naming - Change how the master publishes node locations
    Options are:
    • ROS-Hostname
    • ROS-Hostname.local
    • ROS-IP
    See the Networking page for more information on network configurations.
  • Delete stored task data is a flag for the Production version of Baxter, and has no impact on the BRR.

Tip: Make sure to Save Changes after editing any Configuration options, and then Shutdown or Reboot Baxter from the FSM main menu to apply the changes.

Date, Time, Timezone, NTP Servers

Fsm ntp.png

  • Timezone - Set the robot's clock to your local timezone.
    This will primarily affect the time listed in the log files.
  • NTP Servers - Set your pool of NTP servers.

Applications Menu

The Applications menu launches the RSDK software application from the FSM.

Fsm apps.png

  • The 'Robot GUI' action will launch the xdisplay on Baxter and display the Baxter Research Robot logo.
  • The 'RSDK Demo Mode' action will launch the Demo Mode

Tests Menu

The Tests menu provides a number of low-level hardware tests that can be run to verify the embedded hardware throughout Baxter.

Fsm tests.png

  • To run a test, select the test from the menu and follow the on-screen instructions.

Exit Actions

  • Disable field service menu
    Select to disable the FSM from appearing at boot-up.
    Note: By default, accessing the FSM will enable it for future boots.
  • Reboot Robot
    Shuts down the robot computer and hardware, then restarts the robot, reflashing the controller boards and configurations if needed.
  • Shutdown Robot
    Shuts down the entire robot. Use to power off the robot, or do a hard-restart of the robot to ensure new configurations or firmware are written to the hardware.

Note: You can also leave the FSM via the Applications menu to go directly to normal RSDK operation.


For common issues related to core dumps or files on Baxter, check out the Troubleshooting page.