-
-
Notifications
You must be signed in to change notification settings - Fork 49
How to add a new robot arm
Dan Royer edited this page Jun 9, 2023
·
11 revisions
- run Robot Overlord.
- In the top-right Entity Manager, click on
Scene
and then the+
above. - Select the new Entity. We will refer to this as the robot's Root Entity.
- in the bottom-right Component Manager, click on
+
and add aRobotComponent
. Some additional required Components will automatically be added. - in the Component Manager, scroll down to the RobotComponent. Click
Edit Arm
. A new window will appear.
# Joints: the number of joints in this robot arm. Texture: a quick way to set a single texture file for the entire robot. File: the 3d mesh for the base of the robot arm. Show DH: when selected, will illustrate the DH parameters in the 3D view. All meshes...: Do not select this if your meshes have origins at their axis of rotation.
The table then has # Joints rows with the following values:
- Max, Min: The joint range limits. All values should be within -360 and +360. All joints are assumed to be revolute joints, not prismatic.
- Home: The value of theta when the robot "goes home".
- Mesh: The 3d mesh for this joint of the robot arm.
- D, R, Alpha, Theta: DH parameters. Theta should be the angle of the arm in your design. During normal operation Theta cannot be set outside the max/min limits. It is best if you set the max/min before setting theta.
- create a new github project
- remove any non-essential items from your scene including floor and Main Camera.
- save your project to
$USERPATH/RobotOverlord/Scene
. - copy the contents of
$USERPATH/RobotOverlord/Scene
to your gibhub project folder. - undo to restore your non-essentials.
- in our gibhub project folder add a
robot.properties
file that follows the robot library specification
name=[your robot name]
version=1.0.0
author=[your name]
maintainer=[your name] <[your email]>
sentence=[one sentence description]
paragraph=[longer description appears after one sentence]
image_url=[128x128 image]
url=[your website or the github url]
- commit your changes but do not publish yet.
- tag your last github commit same as the robot.properties
version
. - publish to github.
- make a Pull Request to https://github.com/MarginallyClever/robotoverlordarms/ and add your github URL to the
all_robots.txt
file.
Your robot will be available to everyone once the master list is updated. Congratulations!
- When the panel is opened several new Entities and Components are added to the robot's Root Entity if they are not detected.
- Robot Overlord measures everything in centimeters, so if your model is 10x too large, you may be exporting in mm. If it is 2.54x too large, you are exporting in inches. Please use Blender or some other program to resize your models.
- if you lower the number of joints the builder will not remove the extra Entities and Components.
last reviewed version: 2.6.2