This guide describes how to set up 3YOURMIND’s machine connectivity.

Prerequisites

• Check which machines are currently supported.

• Assure that the machines are connected to the network. (LAN / WLAN)

• 3YOURMIND’s Aggregator must be downloaded and available in the network.

• Access to 3YOURMIND’s Agile MES Admin and Service Panel. (minimum of version 3.14)

• Assure that all system requirements are met.
  

1. Obtaining IP address and port

Ultimaker

• Make sure the machine is part of the network.

• On the onboard UI of the machine go to System → Network → Connection Status to obtain the IP address and port.

BigRep

• On the onboard UI of the machine click on the Settings button in the top right corner of the screen. Click on Printer information to see the IP address and port. Also refer to section two in this BigRep support article.

Formlabs

• See the Installation And Usage Instructions manual that came with your machine on how to connect it to the internet.

• Create an account on https://formlabs.com and follow the instructions to register the machine with your account.

Carbon3D

• Make sure the machine has access to the internet.

• Contact Carbon3D to create an account for https://print.carbon3d.com/users/sign_in.

EOS

• Access the machine's API documentation at https://si2381/api, replace si2381 with the actual ID of the machine. Navigate to the OPC UA Documentation and look for the Endpoint URL.

2. Machine specific connection information

Certain machines require additional information before they can be connected. The highlighted values mentioned below are needed for the configuration of the Aggregator.

Ultimaker

Option 1:

• On the onboard UI of the machine go to System → Network → Connection Status to get the printer name. You will need to enter this name as the unique_name during Aggregator configuration.

Option 2:

• Navigate to http://[IP address]:[port]/api/v1/system/hostname in a web browser.

Octoprint/BigRep

• Navigate to the URL of the machine in a web browser, this should bring up the OctoPrint Settings.

• Obtain either the global api key or a user bound api key:

  • Click on Api in the left menu and note the Apikey.

  • Click on Access Control, create a new user or note the Apikey of an existing one that has at least STATUS permissions.

Formlabs Rest API

• Obtain developer API credentials in the form of client_id and client_secret by contacting Formlabs at gtl@formlabs.com.

• Note the username and password of your https://formlabs.com account.

Carbon3D Rest API

• Generate an API Key at https://print.carbon3d.com/api_keys by clicking the Create API Key button. This will automatically download a secret.json file.

OPC UA/EOSCONNECT Core

• Obtain username and password at https://si2381/gui/auth, replace si2381 with the actual ID of the machine. This page is secured with a login and you will need to use your EOScada credentials to access it. Only EOScada credentials that have the role of Supervisor can add new clients.

MT Connect Stratasys

• No specific information is needed.

3. Obtain API Token and Agile MES Service ID

API Token

Setup a user

1. Login to the 3YOURMIND Platform as a user that has access to the admin panel.

2. Go to Administration > Users.

3. Click on Add User.

4. Enter username: machine_connectivity (or similar).

5. Enter a long random password. You won’t need it later.

6. Click on Save and continue editing.

7. Enter a valid Email Address.

8. Click on Save.

Provide access to the organization's fulfillment partners

1. Return to the homepage of the admin panel.

2. Go to User profiles.

3. Click on the user you just created.

4. Make sure that the user is assigned to the correct site / domain.

5. Go back to the homepage of the admin panel.

6. Go to Fulfillment partner.

7. Open each service under the Fulfillment partner List.

8. Add the user you created to the list of users.

9. Click on Save.

Create API token

1. Go back to the homepage of the admin panel.

2. Go to Users under Authentication and Authorization.

3. Search for the user you created.

4. Click on Create Token.

Note that this is sensitive information.

Service ID

1. Login to the 3YOURMIND Platform with a user that has access to the service panel.

2. Visit https://[your-domain]/api/v2.0/service-panel/services/.

3. Note the id of the service.
   

   

4. Aggregator Configuration

Download the binary release: We will provide you with a link to a ZIP archive that you can use to download the Aggregator.

Create a configuration

Together with the binary release you will find a sample configuration file called config.sample.json. Rename it to config.json and open it in a text editor:

{
  "machines": 
      [...], // please visit child pages for configuration details of all supported machines
  "mes_services": [
    {
      "id": 1,
      "url": "https://print.3yourmind.com/api/v2.0/machine/730/",
      "token": "28c1610a1240ecc5e9eae9b2e3a0554e64e8eeaf"
    }
  ],
  "aggregator_id": "my aggregator"
}

Machines

In the machine section you will need to configure the URL(s) of the machine(s), give them a name of your choice, define their type and provide a list of mes_service identifiers you want to send data to. Please refer to the tables below to see the configuration details of our supported machines/interfaces:

Carbon3D Machine Configuration

EOS Connect Machine Configuration

MTConnect Machine Configuration

Octoprint Machine Configuration

Ultimaker Machine Configuration

Formlabs Machine Configuration

MES services

Each mes_service contains the Agile MES URL, a service ID and an API token. The following data must be set:

• id : This identifier is used to match Agile MES services and machines within the config.json. You can use any positive number, as long as it is unique.

• url: This is the Agile MES URL in the format https://[your-domain]/api/v2.0/machine/[service ID]

• token: This is the API token of the user in the 3YOURMIND software created in step 3.

Example:
with 730 as serviceId:

{
  "id": 1,
  "url": "https://print.3yourmind.com/api/v2.0/machine/730/",
  "token": "28c1610a1240ecc5e9eae9b2e3a0554e64e8eeaf"
}

5. Start the Aggregator

Make sure that the Aggregator is in the same network as each machine you want to connect to.

• Make sure the Aggregator executable and the config.json you created are in the same directory.

• Run the executable.

Optionally install the Aggregator as a Windows service

• Make sure the install-as-service.bat and uninstall-service.bat are in the Aggregator's directory.

• Double-click on install-as-service.bat.

To remove the service and stop the Aggregator double-click on uninstall-service.bat.

Optionally adjust the settings of the service:

• Click on Windows Start, type Services and hit enter to open the service configuration panel.

• Adjust the settings of the 3YOURMIND Aggregator service as desired. You can e.g. enable automatic restart of the service in case of an error.

6. Activate Machine Connectivity in the Agile MES

1. Login to the 3YOURMIND Platform with a user that has access to the Service Panel. If you do not have access to the service panel, please look at: Service Panel.

2. Open the Service Panel.

3. Go to Settings > Workstations.

4. Select the workstation that the machine should get connected to.

5. Select the machine in the Machine Connectivity section.

6. Click on Connect Machine.