hero
Home About Hardware Guide

Categories

Archive

July 2024

June 2024

May 2024

April 2024

March 2024

February 2024

January 2024

December 2023

November 2023

October 2023

September 2023

August 2023

July 2023

June 2023

May 2023

April 2023

March 2023

February 2023

January 2023

December 2022

back to home

When Boards Meet Wheels - Part I - How to connect Peakboard and wheel.me robots

05 July 2024 • 4 mins

Wheel.me is a Norwegian company with a revolutionary concept for building autonomous vehicles. They don’t actually sell an entire vehicle. Instead, they sell four intelligent wheels that can be mounted to all kinds of pallets or other trays, to transport them within a factory. The wheels have access to the local Wi-Fi, and they connect to a software backbone that’s either hosted on AWS or on prem.

This article explains how to use Peakboard to build an interface with the wheel.me backbone. In this article, we will see how to get information about the environment, like the floors, position, and robots. In the second part of this topic, we will focus on commanding the robots to move to certain positions and build an interactive logic for the wheel.me environment.

Set up the extension

The wheel.me API isn’t too complicated, and it can be used in Peakboard directly. But to make our lives easier, we can use the wheel.me extension that’s available in the extension menu. For information about how to install an extension, see the Manage extensions documentation.

image

After the installation, three lists are available:

  • One for the floors
  • One for the positions on a certain floor
  • One for the robots on a certain floor

image

You will need a regular account with enough permissions to access the API of the wheel.me backbone. All three lists of the extension need the credentials (username and password), as well as the base URL, usually in the form of https://XXX.wheelme-web.com/. Make sure to end the base URL with /.

The following screenshot shows the “floors” list. After entering the basic data, we can list all available floors. It’s important to remember the floor ID, because we will need it later for the robots.

image

Query the positions

In our example environment, we have a total of six positions. Besides the five regular points, there’s also one point for charging. Our floor has one robot, and as we can see in the map, it is located in position WH1, and is facing north.

image

Let’s check the output of the “position” data source. We must provide the floor ID to identify the floor we want query. In the list, we can see all the positions from the above screenshot, along with metadata like the physical coordinates and the current state. The state can be either Free or Reserved. And we can also see that the position WH1 is occupied with a robot.

image

Query the robots

The robot data source shows the dynamic aspects of the scenery. As shown in the following screenshot, we need to provide the floor ID again.

We can also provide a filter for the name. This might be important if we have multiple robots on the floor. Then, we could make sure that there’s always one dedicated robot for each data source, by using this filter. That way, it’s much easier to access the data of the robot we want, because we don’t need to look up the robot in a list. Instead, we can always take the first line of the data source.

But again, this only applies when we have more than one robot on the floor. Besides the physical coordinates, we can also see the state (like Navigating or Idle) and the mode (like Autonmous or manual). Most important is the location information: the position the robot is navigating to, as well as the position the robot is currently located at (for each, both the ID and the name of the position is provided).

image

Result and conclusion

Getting the necessary metadata, along with the robot position data, is not too complicated. With these data sources, it’s easy to build Peakboard applications that show the location and status of wheel.me robots.

In the second part of this article, we will learn how to command the robot to move to certain positions, as well as build a logic around missions.

When Boards Meet Wheels - Part I - How to connect Peakboard and wheel.me robots

Newsletter

Want to get notified when a new article is published? Sign up below!