How to Add and Configure Machines

This guide will help you set up individual machines in Tulip via the Machines page and see their history.

In this article, you will learn:

• How to add individual machines to Tulip and map their data via attributes
• How to view the history of these machines without using an app or analytics

How to Create a Machine

In order to monitor machines in Tulip, you must first establish a connection to your data source:

• How To Build Your First OPC UA Data Source
• How To Build Your First MQTT Data Source

Then, you should set up machine types and attributes to categorize the data coming off the machine.

To start adding individual machines, head to the Machines tab under Shop Floor.

Create a Machine

To add your first machine to Tulip, use the Create Machine button.

1. Give your machine a name.
2. Select your Machine Type.
3. [Optionally] map your machine to a Station.
   1. Mapping to a station will allow you to use at this station trigger actions to share applications across your fleet of machines.

Mapping Machine Attributes to Your Datasource

Our machine has been created, now we need to map its attributes to the topics or nodes on our machine data source.

1. Navigate to the Configuration tab.
   Notice that this tab has a yellow warning icon indicating that some machine attributes are not currently mapped to machine data sources
   

2. Select an attribute. Depending on your desired data source type, mapping will differ.

Map to MQTT

1. Select your broker.
   

2. If no topics have been mapped on this machine select "Map to a new topic".
   

3. Enter the topic path where your machine is outputting data.
   

Get Latest Message

Select the Get Latest Message button to pull the last message (or the retain message) for the entered topic.

JSON Payloads

If the data being passed as a json payload, JSON can be selected from the payload type and a selector can be added to identify what part of the JSON blob to map to the machine attribute, or a key:value pair can be selected in the latest message and a selector will automatically be generated. Tulip implements the JSON-Query format for all JSON extractors.

Select Map to Attribute.

Map to OPC-Ua

1. Select your OPC UA Data Source.

2. Navigate to the OPC UA Node associated with this machine attribute.

3. Click the map icon.
   Note: Only machine attributes of the same type can be mapped to OPC-Ua nodes
   

OPC UA Data Types

Map to Tulip API

To pass data into a Tulip machine from any other hardware, you can leverage the machines API.

1. Select Tulip API from the machine data source selector.

2. Select the Map icon to map this machine attribute to a Tulip API endpoint.

Viewing History of The Machine

Using Machine Triggers, you will want to map these Attributes to states so that you can accurately track the status of the machine on a second by second basis.

After you set up those triggers, you can see a history of the past machine states using the Activity History tab within each individual machine.

Here's how to access the history:

And here's an example of the history:

Each row in the history is defined by the amount of time that the machine spent in a certain state.

Here are the columns in this view with data type:

• State (enum)
• Start Time (datetime)
• End Time (datetime)
• Duration (interval)
• Downtime Reason (enum)
• Program (text)
• Ideal Run Rate (number)
• Defect Count (number)
• Part Count (number)

Machine triggers can update the columns for each state based on attributes that you have mapped.

Ingestion Limits

The following rate limits are enforced for machine data sources:

Further Reading

• How to build your first machine monitoring app

Did you find what you were looking for?

You can also head to community.tulip.co to post your question or see if others have faced a similar question!