Machinechat JEDI Quickstart Guide

Ready to transform your devices and sensors into a powerful IoT data hub? This Quickstart Guide will help you get started with Machinechat JEDI in minutes.

Step 1: Download and Install

• Visit the Machinechat JEDI Website: Download JEDI from Machinechat website's Downloads page. Enter your email address to receive the download links and a license key.

• Download Machinechat JEDI: Open the email and click on the download link of a version of JEDI that matches your operating system. Check your spam or junk email folder if you do not see an email within a minute.

• Unzip into Folder: Unzip the downloaded file (e.g. mcjedi_win.zip or mcjedi_mac.zip) into a folder on your computer.

Step 2: Launch JEDI

• Launch the Software:

  • Navigate to the unzipped JEDI folder on command prompt (Windows) or terminal (macOS or Linux).
  • Run mcjedi.exe (Windows) or mcjedi.bin (macOS or Linux).
  • JEDI will launch a command-line interface (CLI). Optionally, type help at the jedi prompt to see the list of commands.

• Open the Web Interface:

  • Open a web browser on the same computer or on a different machine on your network.

  • Navigate to one of the following URLs:

    • If on the same machine as JEDI: http://localhost:9123

    • If on a different machine: http://mcjedi.local:9123 or http://ip-address-of-computer-running-jedi:9123 (Replace ip-address-of-computer-running-jedi with the actual IP address of the machine running JEDI.)

Step 3: Set Up Your Account & Activate Your License

1. Getting Started: Click Next to continue to License Agreement.

2. License Agreement: Review the License Agreement and click Agree & Continue to proceed.

3. Create Your Account: Provide a username, password, and the license key you received on email to set up your account.

Step 4: Explore the Dashboard

1. Quick Start Profile: Choose a preconfigured profile to quickly explore the dashboard using near-realistic data from JEDI’s built-in IoT simulator.

• Uncheck this option if you want to start with an empty dashboard.

2. Explore the Live Dashboard: Take a moment to explore how different charts display metrics and respond in real time.

3. Edit the Grid Dashboard: Customize the dashboard to explore its features.

• Enable Edit at top left corner to edit your dashboard.
• Add new charts to visualize different metrics
• Delete charts you no longer need
• Move and resize charts by dragging and repositioning them

Send Test Data Manually

Using a tool like Postman, or a simple Python script, or a cURL command, send a test payload in JSON format to the endpoint http://<jedi-device-ip>:8100/v1/data/mc Here's a sample payload:

{
  "context": {
    "target_id": "my_device",
    "target_ip": "192.168.1.10" 
  },
  "data": {
    "temperature": 25.5,
    "humidity": 68
  }
}

Here are some sample scripts or code you can use to send test data to JEDI. Replace the IP address in the script or code with the IP address of the computer running JEDI.

You can also read the Data Generation or Data Acquisition to learn about more ways to send data to JEDI.

import requests
import json

url = 'http://<jedi_ip>:8100/v1/data/mc'  # Replace <jedi_ip> with your JEDI IP address

payload = {
    "context": {
        "target_id": "my_device",
        "target_ip": "192.168.1.10" 
    },
    "data": {
        "temperature": 25.5,
        "humidity": 68
    }
}

headers = {'Content-Type': 'application/json'}
response = requests.post(url, data=json.dumps(payload), headers=headers)

if response.status_code == 200:
    print('Data sent successfully')
else:
    print('Error sending data:', response.text)

#include <Arduino.h>

// ... (Sensor setup code) ... 

void setup() {
Serial.begin(9600); // Or the baud rate appropriate for your device 
}

void loop() {
float temperature = readTemperature(); // Replace with your sensor reading function
int humidity = readHumidity();        // Replace with your sensor reading function

Serial.print("{\"context\":{\"target_id\":\"arduino1\",\"target_ip\":\"");
Serial.print(WiFi.localIP()); // Replace with your Arduino's network IP retrieval 
Serial.println("\"},\"data\":{\"temperature\":");  
Serial.print(temperature);
Serial.print(",\"humidity\":");
Serial.print(humidity);
Serial.println("}}");

delay(5000); // Send data every 5 seconds, adjust as needed 
}

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"context":{"target_id":"my_device","target_ip":"192.168.1.10"},"data":{"temperature":25.5,"humidity":68}}' \
    http://<jedi_ip>:8100/v1/data/mc

Congratulations! You're now collecting and exploring IoT data with Machinechat JEDI.

Where to Go Next

You’ve just explored how easy it is to visualize and customize data using JEDI’s simulated environment—now it’s time to take the next step!

Dive into the dedicated sections of the documentation on Dashboards, Charts, Controls, and setting up Rules and Actions to start turning real-world data into meaningful insights.

Need help?

Contact our support team: support@machinechat.io