Learn how to use the HAL Robotics Framework from Rhinoceros and Grasshopper.

• table of contents
• back to main site
• issues and bugs

0. Administration and Setup

0.1. Install

0.2. Create and Administer an Organization

0.3. Join an Organization

0.4. Purchase Licenses

0.5. Complete Uninstallation


0.1. Install

Objective:

In this tutorial you will learn how to install the HAL Robotics Framework from the user portal.

Requirements to follow along:

How to:

In order to install and use the HAL Robotics Framework, you will first need to create your account on the HAL user portal. If you already have an account, you can simply login to the user portal.

Register using a valid email address, as it will be used for support and licensing.

Upon validation of your registration details, please verify that our confirmation email is not blocked by your spam filter.

A final registration confirmation will be displayed once you click on the link you received via email.

The login page simply requires your email and password.

On the home page you should see a Downloads tab which will give you a link to download the HAL Robotics Framework. By clicking on that link, you will download the HAL Robotics Framework Installer.

The user portal Downloads page.

The downloaded “Setup.exe” application will install the HAL Robotics Framework Installer.

Once the download is complete, run the installer and you should see a list of all available packages and extensions. Select the ones you want to install according to the robots that you will want to program using the HAL Robotics Framework and the host software you want to add the Framework to. Once you have selected your configuration simply click apply and the installation will start.

Every time there are updates available for the packages you have installed simply clicking apply will download and install the latest version.

Once the installation is complete you have successfully installed the HAL Robotics Framework.

Important information is displayed during the installation phases, please take notice of these elements before using the software.

The HAL Robotics Framework is composed of functionality modules. The installer lets you select the ones you wish to install.

Each module is distributed with a corresponding End-User License Agreement (EULA), please take notice of these elements before using the software.

Upon validation of the module selection, the installer will download and install each module and the corresponding dependencies.

You can exit the installer once the setup is complete.


0.2. Create and Administer an Organization

Objective:

This tutorial is aimed at organization administrators who would like to manage licenses and users for their institution from the user portal. If you are a user trying to access their organization’s licenses please skip forward to the Join an Organization tutorial. Please note that all new organizations need approval from a HAL Robotics team member so please do not follow this tutorial unless you represent an organization.

Requirements to follow along:

Background:

Creating an organization will allow members to share floating licenses. This maximizes the usage of your licenses and avoids employees or students leaving with access to a license you’ve paid for.

How to:

Start by browsing to the user portal and logging in. You can then navigate to the Organizations tab. Here you should see a list of any organizations you are already a member of. It’s likely that this list is empty at this stage so let’s create an organization for you company or institution.

Click on the “Create” button at the top of the tab. There are a few details that need to be entered here:

Fill the organization creation form then validate using the Create button.

Click “Request Creation” and you will be redirected to your “Organizations” tab. Once the organization has been confirmed by the HAL Robotics team, you can view the members and licenses of the organization, and purchase licenses on the organization’s behalf. You can use the “Members” tab to toggle the admin status of members or remove them. The “Licenses” tab can be used to check which licenses are in use and when they expire.

The “Organizations” tab displays your memberships.

The “Members” tab of an organization displays members and their roles.

The “Licenses” tab of an organization displays licenses and their status.


0.3. Join an Organization

Objective:

This tutorial is aimed at users who want to join their organization on the user portal and access the organization’s licenses. If you are unsure of whether your company or institution has an organization please talk to your I.T. department or HAL Robotics Framework admin.

Requirements to follow along:

Background:

Joining an organization will allow you to access your organization’s licenses.

How to:

Start by browsing to the user portal and logging in. You can then navigate to the Organizations tab. Here you should see a list of any organizations you are already a member of. It’s likely that this list is empty at this stage so let’s join the organization for you company or institution.

Click on “Join” at the top of the page. Here you will be asked for the organization’s name and passphrase. If you don’t know these details for your organization please ask to your I.T. department or HAL Robotics Framework admin as they will have access to these details. If your organization isn’t found please check the spacing, punctuation and casing of both entries.

The “Join” tab will allow you to join your organization and access its licenses.


0.4. Purchase Licenses

Objective:

This tutorial will guide you through how to purchase licenses for the HAL Robotics Framework on the user portal. The process is the same whether you’re purchasing for yourself or for an organization.

Requirements to follow along:

Background:

Purchasing licenses will allow you to use the HAL Robotics Framework and are sold on a subscription basis, starting from 1 year. They do not automatically renew.

How to:

Start by browsing to the user portal and logging in. You should then see navigate the Purchase Licenses tab.

Once you have entered all of your information you can “Buy Now” or “Request” your licenses, depending on whether we can automatically validate your purchase. If you do have to make a request, we will review this within 1 business day and either send you an invoice directly or be in touch to clarify any details.

If you do have “Buy Now” as an option, and most people should, then your invoice should open in a new tab. If it doesn’t, don’t worry, there will be a link to it in the summary text on the web page and you will receive it by email too. This invoice will give you links to our secure payment providers through which you can pay online. As soon as your payment clears, your licenses will be issued and we will confirm this by email.

The “Purchase Licenses” tab will allow you to purchase or renew you HAL Robotics Framework licenses.

If we need to manually validate the license type you have requested, you may be asked to “Request” your licenses, rather than to “Buy Now”.


0.5. Complete Uninstallation

Objective:

In this tutorial you’ll learn how to completely uninstall the HAL Robotics Framework.

Requirements to follow along:

Background:

Whilst we make every effort to ensure that our software is stable it may occasionally be necessary to completely remove a version of the HAL Robotics Framework.

How to:

Start by opening the HAL Robotics Installer and clicking uninstall. This will uninstall all packages and extensions you added through the installer.

You can then uninstall the Installer itself through the usual Windows uninstall methods.

Once this is done you can clean up any remnants that the uninstallation process may have missed by deleting the following folders:


Continue to: 1. Getting Started