This guide provides a basic introduction to Robotmaster, to help you get familiar with using the software. There is a basic an overview of the user interface and options. Followed followed by a walkthrough of a programming a simple job for a work cell with a six-axis robot manipulator.
| Table of Contents | ||
|---|---|---|
|
Contents
...
Setup
Installation
Installation instructions should be available on the KB.
Licensing
For now, this is covered in separate doc for License Expert and in the RM KB. Rita posted this to the KB. We need to work out where that info will ultimately live.
Part Programming Guide
...
Opening Robotmaster
...
Important options
...
Device and task windows
...
3D navigation
Add CAD, run through the navigation options.
...
Gnomons
Best to show gnomon with walkthrough, Add cad, enter user coordinate system/frame, show how to move.
Walkthrough
...
Creating a new task
...
Importing a CAD file
...
Creating a contouring operation
...
Loading a device
...
Assigning an operation
...
Calculating
...
.
The Getting Started Guide does not cover installation and licensing. If you need help with those steps, please refer to the online knowledge base.
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Open Robotmaster
Go to Windows Start
> Robotmaster 2025.
Robotmaster main window
When Robotmaster opens for the first time, the main window will be empty with no device or tasks loaded. The main window is divided into several areas:
...
Access common commands such as New, Open, Save, Export, set global Options, and so onopen About to view license and version information.
Device tab and Task tabThe pane on the left is divided into two tabs: tabs
As you work in Robotmaster, you will use these tabs to switch between Device and Task sides in Robotmaster. The Device tab side is used for robot cell programming. When the Device tab is active, the viewport, controls, and panels in the Robotmaster window are device-specific.
The Task tab side is used for adding parts and creating paths and operationsoperations. As you add or select tasks in a Robotmaster session, the Task side will become active, with a task-specific viewport, controls, and panels.
Scheduler and simulation
The time-based scheduler is used to simulate and schedule operations for the part program in Robotmaster.
Viewport and Viewport menutoolbar
The viewport is the main work area in Robotmaster where you will view and interact with 3D models of cells, robots, and workpieces.
Point list, Joint list, and Frame editor
Use this area to view and In the Point list, you can view points, edit points, and add non-motion events. The Joint list displays robot joint positions, and coordinate frames. The Frame editor is used to transform frame position and orientation.
Add a new task
At this point in the walkthrough, let’s add a new task.
In the Task paneupper left, select [+] New task.
A new task called “Task 1” will be created. Note that Task 1 is now the active tab.
...
When a task tab is active in Robotmaster, several task-specific panels appear on the left:
Parts: This is where CAD parts in the task are listed. You can import, manipulate, and export parts in this area.
Operations: Operations added in the task are listed here. You can create operations and tool paths and operations for parts in this area.
Custom frames: One or more reference frames for the CAD part task are listed here.
For now, we’ve created a task. Next, let’s add a part to the task.
Import a part
Select the Task 1 tab.
In the Parts panel, select [+].
Browse to the following folder:
C:\Users\Public\Documents\Robotmaster 2025\Samples\CAD
Select Large_Dome.stp.
Click Open.
A part called “Large_Dome” will be added to the task. The CAD model for the part will be visible in the viewport.
...
Now that the part is imported, let’s inspect it in more detail.
Organizing the CAD model for a part
In the Parts panel, click the expand button next to the part to view CAD model detailscontents.
...
You can explore the CAD for any part in this tree view. Depending on the source CAD file format and how the part was drawn in the source CAD file and the CAD file format, it might consist of wires, mesh, points, surfaces, and solids.
...
Right-click Solid#2, then select Move geometry to new part.
A new part called Large_Dome 1 will be created in the Parts panel. This is the work table.
Right-click Large_Dome 1 and change the type to Fixture.
The work table solid body is now classified as a Fixture. Note that it now has a fixture icon.
Double-click the new part and rename it into something that will make it easy to identify, like “Base Fixture.”
With the part added and CAD correctly organized, let’s take a brief look at using the 3D viewport.
Getting familiar with the viewport
As you interact with a part in the viewport, there are some basic default mouse controls.
Mouse actions | Result | |
|---|---|---|
 | Left mouse click | Select |
 | Right mouse click | Context menu |
 | Mouse wheel up | Zoom out |
 | Mouse wheel down | Zoom in |
 | Mouse wheel click and drag | Pan |
 | CTRL key + Mouse wheel click and drag | Rotate |
In Robotmaster Options (Main Menu > Options), you can choose different 3D navigation styles. For example, if you are more comfortable with SOLIDWORKS mouse controls in the 3D space, you can use that style instead of the default.
The Viewport menu taskbar contains task-specific viewport controls, including:
...
These are useful tools which can help as you work in Robotmasterthe viewport.Try switching
Switch between normal views
...
In the viewport menu, select View settings > Top.
The viewport will show a Top view.
Select View settings > Isometric.
Reference frames in Robotmaster allow coordinate systems to be specified for several different components. Some important frames include:
Transforms, frames
Gnomon
Move origin
Move along axis
Move along plane
Rotate about axis
Align axis with external geometry (click the round ball mid axis, then select point).
Right-click to cancel out
Add a contouring operation
...
The viewport will show a perspective isometric view.
Selecting CAD objects
CAD objects can be selected by clicking an area on the part in the viewport.
Since the color of the Large_Dome example part is light blue, it might not be easy to tell when CAD objects on the part are selected. Let’s select the entire part and change its color in Robotmaster, to make things easier to see:
Right-click the part, then choose Select > Whole part.
The entire part will be selected.
Right-click on the selected part, then click the color swatch next to Fill with color.
Set all the ARGB values to 255 to make it white.
Select Fill with color. The dome part will be colored white.
Add a contouring operation and define tool paths
Next, we will add a simple contouring operation and define tool paths for a few holes on the part. Contouring is a general operation that can be used for profile following tasks such as cutting or deburring.
...
On the Task 1 tab, select Operations > [+] > Contouring.
In Contouring mode, in the Paths panel, select [+] > Auto Path.
Select the surface on the part that contains the three holes that need contouring.
The selected surface will be light blue. Note that paths can be automatically applied to all edges on this selected surface.
Click Refresh from selected surfaces.
Potential paths will be added on the edges (shown in orange). There are paths on the edges of the holes and a large path added around the perimeter of the surface. Next, let’s exclude some of the paths we don’t need using the path slider.
Drag the path slider one unit from the right.
The largest potential path will be removed. Dragging from the right will remove paths, starting with the largest path.
Drag the path slider from the right again until the orange path for the next largest hole disappears.
Drag the path slider from the left to eliminate the paths for the four smallest holes.
With paths remaining on only the three medium-sized holes, select Add to path list.
Edge Paths will be added to the Paths list.
Click OK.
At this point, three paths are added to the Contouring operation.
Click Apply.
When you click the Apply button:
Robotmaster generates a preliminary tool path and displays the tool and path in the viewport.
The “Contouring 1” operation is added in the simulation at the bottom of the window.
The Point list on the right now shows points for the operation.
...
At this stage, you can view and edit path length, sequence, entry / exit points, direction, and more. You can also set speeds and parameters for the operation.
For this walkthrough, we will use the default values for the entire operation. Next, we will run the simulation for the task.
Simulate the tool path
At the bottom of the window, click the Play button (▶) to run the simulation for the task.
As the simulation plays, review the tool path created by Robotmaster. At this stage, if you make changes to the tool path (such as reordering paths), click Apply to update the simulation with your changes.
When you are finished editing and reviewing the tool path, click OK.
The operation is fully created in the task.
...
Next, we will load a robot device and program it with the operation.
Load a device
In Robotmaster, a an entire robot cell is considered a “device”“device.” Robotmaster comes pre-loaded with several default work cellsdevices, including which include robots and cell components like tables, rails, and fences. For this walkthrough, we will use a simple device.
Select the Device tab.
Select Load a device.
Set Brand to Robotmaster.
Select ROBOTMASTER_2.7 from the list.
ROBOTMASTER_2.7 is a fictional 6-axis robot manipulator that is used only used for demonstration purposes. Your installation of Robotmaster will likely contain one or more real-world devices that corresponds correspond to the physical robot(s) you will be programming.
With the robot device loaded and the Device tab active, a model of the robot cell will appear in the viewport.
...
In On the Device modeside, device-specific panels will appear on the left:
Operations: Shows the currently loaded device (cell), setup, and program. Assigned operations appear here as well.
Unassigned operations: Any operations created in the job that are not yet assigned to a program are listed here.
Frames: Reference frames for the device appear here.
When the Device tab is active, the viewport toolbar contains many of the same options as Task mode. There are several additional device-related options as well.
For example, you can visualize the reach limits of the robot:
On the viewport toolbar, select the Workspace settings button > Display workspace.
This can help when positioning the workpiece relative to the robot and when resolving Out of reach issues. Note that the reach of the robot wrist (Joint 5) is used as the limit of the workspace.
Let’s turn off this option before we continue:
Clear the Display workspace option.
At this point, we have a device loaded and a . A task is created . However the task is empty. Next, let’s import a part and add a simple contouring operation for it.
Options
Use Options configure the general behavior of Robotmaster.
To open Robotmaster Options:
Select the Main Menu button
> Options.
Some common options that you may want to adjust:
3D Navigation style
Several styles are available for interacting with the 3D viewport.
Joint moves color and Cartesian moves color
Set the
Frames and using the gnomon
Reference frames in Robotmaster allow coordinate systems to be specified for several different components. Some important frames include:
Base frame: Coordinate system at the base of the robot. Stationary point on which other frames are based.
Tool frame or TCP: defines position and orientation of the tip of the tool, relative to J6.
User frame: Defines the position and orientation of the part. Defined with respect to the base frame.
nents.
Import a part.
Change the user frame.
Use example 3D part, have them change the originwith a contouring operation. This operation now needs to be assigned.
If a device is already loaded before a task is added, the operations for the task will automatically be assigned to the device.
Assign an operation to a program
In the Unassigned operations panel, right-click Task 1, then select Assign to > Program 1.
The Contouring 1 operation will be assigned to Program 1 for the ROBOTMASTER_2.7 robot cell.
...
A few things to note when an operation is assigned:
The workpiece and fixture are moved to align with the path mounting frame of the robot.
The tooling is now visible and mounted on the robot.
Home operations are added before and after the assigned operations.
Program 1 appears in the scheduler simulation at the bottom of the window.
The Point list on the right is empty, because the program has not yet been calculated.
Calculate
On the Device tab, select Calculate.
Robotmaster will fully calculate the points needed for the operation. If you select the robot in the pane on the right, a full list of points for the program will be displayed.
...
Simulate the program
Once a program is calculated, the scheduler at the bottom of the window can be used to simulate robot motion for the entire program.
Click the Play button (▶) to run the simulation.
...
Notice the green markers next to the Home and Contouring 1 operations. These markers indicate that there are no kinematic issues encountered by the robot in the course of this program.
At this point, Program 1 will be ready to output as robot code. This step requires a valid post processor package to be loaded. Creating machine-readable code is beyond the scope of this guide.
Save your work
On the Main Menu, select Save.
Select a folder and file name, then click Save.
Robotmaster files are saved with an .rm extension. This .rm file will contain the program, tasks, operations, and device information, so that you can return to it at a later date, if needed.
You have reached the end of the Robotmaster Getting Started Guide. Please explore the Robotmaster documentation site and the online video tutorials in the Knowledge Base to learn more about how to use the software. Thank you!