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 Free Edition or JEDI Lite Trial. Enter your email address to receive the download links and a license key. Check your spam or junk email folder if you do not see an email within a minute.

• Download Machinechat JEDI: Open the email and click on the download link of a version of JEDI that matches your operating system (Windows, macOS, Linux, Raspberry Pi, BeagleBoard Debian).

• Unzip into Folder: Unzip the downloaded file (e.g. mcjedi_win.exe or mcjedi_mac.zip) into a folder on your computer. Open command prompt on Windows or terminal on macOS or Linux. Use cd command to change directory to the folder where you unzipped the downloaded file.

Step 2: Launch JEDI

• Launch the Software: From the directory where you unzipped the downloaded JEDI file, run mcjedi.exe on Windows or mcjedi.bin on macOS or Linux. JEDI will launch a command-line interface (CLI). Optionally, type help at the jedi-cli 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://:9123 Replace with the actual IP address of the machine running JEDI.

Step 3: Set Up Your Account & Activate Your License

1. Read & Accept the EULA: Review the End User License Agreement and accept it to proceed.

2. Create Your Account: Provide a username and password for your JEDI login. Answer the challenge questions required for password recovery.

3. Sign In: Use your new credentials for your first login.

4. Check Your Email: You will have received a license key in the email along with the download links. Copy the license key so that you can paste it into the JEDI interface.

5. Activate: Paste the license key into the form and click ACTIVATE. JEDI will briefly connect to the internet to validate your license. If the activation fails, check your internet connection, and firewall settings. Once the license is activated, JEDI does not require an internet connection for operation.

Step 4: Send Some Test Data

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

Step 5: Visualize & Explore

• Dashboard Time! On the Navigation Panel click on Data Dashboard. This dashboard was pre-created for you. We will now add a Gauge chart to this dashboard.

  Click ADD CHART to add a new chart to the Data Dashboard.

  Click on Name and enter a name for the chart.

  Click on Chart Type and select Gauge.

  Click on Source and select the target_id that was sent with the data. If you used the sample code or payload provided above, you will see my_device in the list.

  Click on Property and select a property (e.g. temperature or humidity).

  Click on SAVE to save the configuration and add the chart to the dashboard.

• Experiment: Try adding more data sources, send data from your scripts and devices. Read the How-To guides or checkout the Tutorials.

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

Where to Go Next

• Read the full documentation or jump to what interests you the most.

• Set up rules and notifications in the Rules section to trigger actions and alerts based on your data.

Need help? Contact our support team: support@machinechat.io