../_images/tiago-icon.png ../_images/tiagopro-icon.png ../_images/ari-icon.png

Using the Web User Interface#

Overview#

This section explains the use PAL’s robots’s Web User Interface and its different plugins. The Web User Interface is a tool designed to simplify the configuration of the robot as well as the user experience. The Web User Interface can be accessed via browser, at the address http://PAL’s robots-Xc , where X is the serial number of the robot.

Technical considerations#

At the moment the Web User Interface supports only the Chrome browser on a laptop or computer. Accessing the Web User Interface from a mobile phone or tablet, or from a different browser, will result in some of the functions not working properly or at all.

Login screen#

When accessing the Web User Interface a user and password will be requested. The default user and password is pal / pal . Once the correct user and password are introduced the user will automatically be redirected to the page he was accessing.

Sessions are not time-constrained, which means that once a user has logged in he won’t be logged out until either he closes the browser or the robot is rebooted.

Login screen of the Web User Interface.

Figure: Login screen of the Web User Interface.#

PAL’s robots Homepage#

In this page there is a grouped list of webapps with short descriptions of each of them. Clicking on any icon will redirect you to the corresponding app:

Note

Depending on the hardware that comes with your robot, you will also have additional apps. Mainly, if your robot comes with a lidar, then you will also have the Navigation and Building apps for navigating purposes.

On top of the page there is a summary of the robot’s status in real-time. It indicates if the emergency button is pressed, if the robot is docked (if it’s charging now) and the level of the robot’s battery.

../_images/home_light.png

To quickly access any webapp use the menu on the left hand side. Under the menu icons there is a switcher between Light and Dark colour themes.

../_images/home_dark.png

Information Panel#

The Information Panel serves to provide visual information on the robot’s current state.

../_images/info_panel.png
  • Emergency indicates the emergency button status (pressed or not). In the case of it being pressed, the icon will be red.

  • Dock Station indicates if the robot is connected to the dock or not.

  • Battery shows the current battery percentage and voltage. Yellow and red colours indicate middle and low battery levels.

  • Localization shows if the robot is located correctly in the navigation map.

  • Network indicates the currently active connection mode of the robot. Can be: Wi-fi Client or Access point.

  • Volume allows management of the robot’s volume and shows the current volume percentage.

  • Touchscreen is connected with the Touchscreen Manager webapp. Here there is the information on the page that is displayed on the touchscreen and its template.

Some examples that may be displayed:

../_images/cards_states.png

Motion Builder#

The Motion Builder is a webapp that allows you to create prerecorded motions and execute them.

../_images/slider_input.png

This app is documented in its own page.

Presentations#

Presentations is a webapp that allows you to create pre-recorded presentations (a combination of Speech, Motions, Touchscreen content and LEDs effects) and execute them.

The features of the Presentations tool include:

  • Creating, Editing, Deleting presentations and presentation slides

  • Adding the custom text to speech in a chosen language

  • Adding motions (previously created in Motion Builder)

  • Managing the content on the touchscreen and it’s duration

  • Choosing and tuning the LED effects

  • Managing all possible combinations of presentation elements on a graphical timeline

  • Storing and executing the presentation

../_images/presentations_overview.png

The interface of Presentations consists of a list of the presentations and a user-friendly editor, where you can create, edit and test presentations from your PC or mobile devices.

This app is documented in its own page

Touchscreen Manager#

The Touchscreen Manager is a webapp that allows you to create web pages and publish them on the PAL’s robots’s touchscreen.

../_images/pwb_bg_color.png

This app is documented in its own page

Command Desks#

With this app, you can teleoperate the robot, and prepare it for events or other needs, by creating Command desks with groups of buttons inside them. Then you assign actions that the robot will perform when you click any button.

To create a new command desk click on the “NEW COMMAND DESK” button at the top of the page. Near it, at the left top corner menu, you can choose a Command desk created earlier.

../_images/cd_start.png

Create a new desk#

Type the name of your desk and create a first group (you must have at least one) by clicking on the “plus” icon near the “New group” title. To create a new button, click “ADD NEW”.

../_images/cd_edit_group.png

Step 1. Button’s name. Choose a name related to the action this button will perform.

../_images/cd_step_1.png

Step 2. Action’s type. You can create buttons with “Motion” type, corresponding to the blue circles, so that the robot makes a movement; or “Custom Speech type”, which is represented by an orange circle, so that the robot says the written text. In this example we chose “Custom speech”.

../_images/cd_step_2.png

Step 3. Action’s details. Here you should define what PAL’s robots will do after clicking on this button. For “Motions” choose an option from the list, for “Custom speech” type a custom text for PAL’s robots to say, and choose the corresponding language.

The button “TEST NOW” allows you to try your button in action before saving it. If all is ok, click “DONE” to save and close the button editor.

../_images/cd_step_3.png

After creating all the buttons you need, click “SAVE” at the right top of the page to exit the Edit mode and return to the Command desk page.

Joystick#

With this webapp you can also navigate the robot. The small joystick button at the bottom of the page opens a virtual joystick. Drag the orange circle towards the direction you wish to move the robot.

../_images/cd_joystick_active.png

Teleoperation#

The Teleoperation webapp serves to navigate a robot remotely by using its cameras. The webapp has 2 tabs: teleoperation and exposure tuning.

The Teleoperation tab allows you to see from the head camera’s point of view. With this display you can click anywhere on the image to have PAL’s robots look at that point, or, by clicking the navigate icon at the top right and then clicking on an empty spot on the floor, have PAL’s robots navigate to this position. The two arrow buttons allow for simple rotation of the base. In this tab you also can Dock/Undock the robot (see Dock/Undock through Web User Interface for further information).

../_images/teleop_tab.png

In order to be able to navigate the robot must be in an Undocked state, displayed by this text on the top menu, which will also change colour to grey.

On the Exposure Tuning tab you can change the exposure settings on the torso front camera, which will affect obstacle avoidance. It is a good practice to do it each time the robot changes its environment. Different quantities of light, and the presence of luminescent light affect the camera image and consequently the robot’s ability to distinguish obstacles on the floor.

To calibrate the exposure, type a number or use the arrow buttons on the bottom of the page to change it. The direction of the arrows (right or left) shows if the exposure number will increase or decrease (respectively). The quantity of the arrows (one or two) means a step of the number changing (10 or 100 respectively). Use the camera image as a reference to a current state of the exposure.

../_images/exp_tunning.png

Click on the top-right SAVE button to store the current configuration.

Building#

The Building app covers the management operations related both to buildings and maps.

../_images/update_map_tab_home.png

Note

This webapp is only available if your robot has the necessary hardware to perform navigation tasks.

This app is documented in its own page.