--- title: "Set up the Machine Kit" slug: "set-up-the-machine-kit" updated: 2024-04-11T13:46:25Z published: 2024-04-11T13:46:25Z --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Set up the Machine Kit *A guide through the set up procedure for your Tulip Machine Kit.* [Video for "VID_Machine_Kits_Setup_demo_2023_1920x1080.mp4"](https://tulip.widen.net/view/video/7ab4qhhnu1/VID_Machine_Kits_Setup_demo_2023_1920x1080.mp4?u=dtggv3) ## Prerequisites ### Versions - Tulip: >= `r255` or >= `LTS11` - EdgeOS: >=`OS54.2` ### Hardware - Access to a single power conductor on the machine - Control Panels or Breaker Cabinets are often the simplest places to access single conductors. ## Setup Process Setup requires 3 key parts: - Hardware Setup - Software Setup - Machine Creation ### Hardware Setup 1. Attach the Edge MC Antenna Screw the included antenna to the corresponding port on the Edge MC. 2. Plug in Edge MC Plug the Edge MC into the wall charger using the included MicroUSB cable. Then, plug the wall charger into an outlet to power the Edge MC 3. Plug in Ethernet Connect an ethernet cable (with access to the outside internet) to the WAN port on the Edge MC NOTE In this document, we assume customers will be relying on a wired internet connection, but you can configure this to be wireless if WiFi is available. 1. Connect the Phidgets Hub Connect the Phidgets Hub to the Edge MC using the included miniUSB to USB cable. 2. Clamp to the power source Current clamps must be clamped around a single wire. Most extension cords include 2 or 3 wires. **A single wire needs to be isolated for the current clamp to accurately measure current either hot or neutral, NOT ground.** Connecting in an a breaker box or control box is likely the simplest place to find an isolated single wire. 3. Connect the Edge MC to Current Clamp Plug the Current Clamp into any of the inputs in the phidgets hub. Take note of this port, we will need it when creating our machine in Tulip. ### Software Setup 1. Connect to the Device Network Connect to the WiFi network. Its name should align with the device serial number. ``` Network Name: TULIP-EMC-01-xxxxxx Network Password: tulip-gw ``` 1. Go to the device In a web browser, navigate to `10.0.3.1`. This will load the setup flow for the device: 1. Follow the device setup steps 2. Give the device a password 3. Assign it to your Tulip Instance 2. Select **Machine Kit** Select the **Machine Kit Quick Configuration**. This will deploy the machine kit flow and start it in Node-Red. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28136%29.png) 3. Install the Library App If this is the first device you are setting up as a machine kit, select **Install** to download the [Machine Kit app](https://tulip.co/library/apps/machine-monitoring-terminal/) to your Tulip instance. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28137%29.png) Connect to your normal internet network when prompted. You will be directed to your Tulip Instance. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28139%29.png) Click **Install** on the Library App Install Modal. ![Install Machine Kit App](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Install%20Machine%20Kit%20App.png) ### Machine Creation The Machine Terminal App has been downloaded along with a Machine Kit Machine Type. This machine type includes machine attributes, machine states, machine triggers and more. We need to create one Machine of this type that will be mapped to the data being passed to Tulip from the Edge MC. 1. Navigate to the **Machines** page. Go to `[your.instance].tulip.co/machines` 2. Create a Machine. 1. Select **Create Machine**. 2. Name your Machine. 3. Select the Machine Type: **Machine Kit**. 4. Click **Create**. #### Map to your Edge Device Data 1. Select the "Machine Current" attribute. 2. In the "Data Sources" pane, select your Edge Device. *ex. EMC-01-FAC2EB49* 3. Expand the Node-Red Folder. 4. Select the Link icon next to the Phidgets Hub port you used . ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28151%29.png) *The machine has now been created, and mapped to its data source. It can now be used in your applications.* ## Running the App 1. Navigate to the [Machine Monitoring Terminal Application](/r230/docs/machine-monitoring-terminal). 2. Click Run. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28150%29.png) ## Configuration and Troubleshooting ### Ideal Machines for Connection For optimal use of the machine kit, it's recommended you connect to a machine that has a consistent current load. The current load should clearly indicate the running state of the machine. Examples of machines that are not ideal for machine kit set up are machines with no easy access to a single conductor. Additionally, machines with very short cycle times and similar current loads when running and stopped are not good for pulling machine kit data. ### Machine Triggers The Machine Kit machine type has 3 machine triggers, one sets the running state (if amperage is above 10A), one sets stopped (if below 10A), and one sets the state to offline if the value is equal to 0. These thresholds can be adjusted to fit the needs of your machine type. Navigate to `[your.instance].tulip.co/machines` to configure these thresholds. More details about machine triggers are available [here](/r230/docs/machine-monitoring). ### Hardware Configuration The Current Clamps included in Machine Kits have a jumper that is by default set to 20A, but can be adjusted to: - Max 10A - Max 20A - Max 50A To get accurate current measurements, you will need to adjust how the values are scaled in the Node-Red Flow. ### Node RED #### Jumper Scalar Configuration Machine Kit Current Clamps The Node Red flow for your machine kits is accessable at: `[edge device ip]/1880`. Login with the credentials below: ``` Username: admin Password: [device password] ``` Within the scaler flow group, the nodes to change the scalar to match 10A and 50A are disabled. Click on these nodes and disable them. Select the "Deploy" button to update the flow runtime. #### Current Data Graph A graph of the raw measured value from all 6 inputs can be found at `http://[edge device ip]:1880/ui`. **Machine Type** **Machine Types** are global definitions of what data to expect from machines of different types. Each Machine Type will have different states, **triggers**, and **attributes**.*EX. We have 5 makes/models of CNC mill, but they all have the same set of attributes (Spindle speed, feed rate, etc.) These can all be combined into a single "CNC Mill" Machine Type* **Machine** A **Machine**is a digital representation of a physical datasource. Machines have **Attributes**that are updated through an OPC-UA Connector or the Tulip API. **Node-RED** **Node-RED**is an open-source flow-based logic language that runs natively on **Edge IO**and **Edge MC.**The Node-RED community has developed 3500+ libraries to interface with just about anything!