Quick start guide Arduino Uno Q + Machinechat JEDI One

[josh_mickolio]

Quick Start Guide: Arduino Uno Q + Machinechat JEDI One

This guide supports the Arduino Uno Q Rapid Engineering Kit, DigiKey part number DK-MJ-ARQ-4GS1-KIT

This quick start shows how to use the Arduino Uno Q + Machinechat JEDI One Rapid Prototyping Kit with an Adafruit BME280 sensor to create a fully local IoT monitoring system with live dashboards and alerts.

In this setup guide, you will:

• Install App Lab from Arduino
• Download and install Machinechat JEDI One on the Arduino Uno Q (Full license included in kit)
• Load the BME280 sketch (.ino file included below) and required libraries
• Run JEDI in your browser, quickly configure widgets to display temp and humidity data
• Estimated time ~10 to 20 minutes!

Dual Advantage with Arduino Uno Q’s Dual-Architecture

The Arduino Uno Q combines two computing environments on a single board physically connected over a serial interface.

• Qualcomm Dragonwing™ QRB2210 processor running Linux, where Machinechat JEDI One is installed and executed
• STM32U585 microcontroller running Arduino applications and handling real-time sensor interactions

Why It Matters

Unlike many IoT solutions that require gateways, brokers, or custom integrations, the Arduino Uno Q and JEDI One work together through the built-in Qualcomm-Arduino bridge. Sensor data published from your Arduino sketch is automatically discovered by JEDI, allowing you to focus on building rather than configuring infrastructure.

What’s in the Kit?

Item	Purpose
Arduino Uno Q (4GB)	A combined Linux SBC and real-time MCU in one board. Runs JEDI One natively — no separate computer needed.
Adafruit BME280 Sensor	Reads temperature (°F), humidity (%RH), barometric pressure (hPa), and altitude (ft).
Qwiic Cable	Solderless I²C connection from the BME280 to the Uno Q. Keyed connector — plugs in one way only.
License Redemption Card	Contains your unique JEDI One lifetime license key.

You’ll also need:

• A computer (Windows, macOS, or Linux) with a modern browser (Chrome, Firefox, or Edge)
• Internet connection for setup
• Wi-Fi credentials

Three Steps to a Live Sensor Dashboard

Getting from unboxing to a fully operational dashboard is a straightforward three-step process:
By the end, you’ll have a complete local monitoring system running entirely on the Uno Q.

Step 1: Get Your Hardware Ready

Prepare the hardware and complete the setup by connecting the sensor, board, and computer, updating and configuring the board using App Lab, and verifying the setup by looking for IP address.

1. Connect Your Sensor:

• Connect your Adafruit BME280 to the Uno Q via the Qwiic cable.

2. Set Up the Uno Q:

• On your computer, download Arduino App Lab for your OS and install it.
• Connect your Uno Q to your computer via the USB cable and configure as required.
• If you get a warning that your board software is out of date when you open App Lab, flash a new image.

3. Find the Uno Q’s IP Address:

• You’ll need Uno Q’s IP address to reach JEDI in your browser. In App Lab, open the Shell terminal and run:

  ip a
  
  

• Look for the inet address under the wlan0 interface — it will look like 192.168.x.x. Note it down.

Full setup documentation: docs.arduino.cc/hardware/uno-q

Step 2: Download and Install JEDI One

JEDI One is installed directly onto the Uno Q, not on your computer. Using the App Lab Shell terminal, download it to the board, make the binary executable, and register it as a system service so it starts automatically following reboots.

1. Download JEDI One to the Uno Q:

In the App Lab Shell terminal, create a folder for JEDI and download it directly to the board:

mkdir -p ~/Machinechat
cd ~/Machinechat
curl -L [JEDI_DOWNLOAD_URL] -o mcjedi.zip
unzip mcjedi.zip
ls

The ls command at the end confirms that mcjedi.bin is present before you proceed.

2. Make the JEDI Binary Executable:

Once downloaded, make the JEDI binary executable:

chmod +x mcjedi.bin

3. Register and Start JEDI as a System Service:

Rather than running JEDI manually each time, install it as a service so it starts automatically whenever the Uno Q powers on:

./mcjedi.bin --service install
./mcjedi.bin --service start

If you want to run JEDI manually instead:

./mcjedi.bin

4. Verify Installation and Create Your Account

• Open a browser on your computer and navigate to: http://[your-uno-q-ip]:9123
  • Or, if your network supports mDNS hostname: http://mcjedi.local:9123
• Accept the End-User License Agreement.
• Create your admin account by entering username, password, and license key.

Full JEDI documentation: https://docs.machinechat.io/

Step 3: Get the Data Flowing

The final step is to use an Arduino sketch to read the BME280 sensor and send the data over Qualcomm-Arduino Data Collector to JEDI, that is now running on Uno Q.

1. Understanding the Sketch:

The sketch performs three simple tasks:

1. Initialize the Hardware: The application starts the Qualcomm-Arduino bridge, initializes the Qwiic interface, and verifies that the BME280 sensor is available.
2. Read and Package Sensor Data: The sketch continuously reads and packages sensor data into a JSON payload.
3. Send Data to JEDI: The JSON payload is sent to Machinechat JEDI through the bridge using Bridge.notify().

2. Create a New App:

• In App Lab, click Create New App in the top-right corner.
• Give your app a name (e.g., “BME280 Monitor”) and pick an icon.
• Click the Sketch folder to open the code editor.

3. Run Arduino Sketch:

• Download the sketch for BME280 (file below)
  bme280_only.ino (3.4 KB)

• Paste it into your sketch or replace any existing code with it.

• Install the required libraries via the Library icon in App Lab: Adafruit BME280 Library and ArduinoJson (note the Arduino_RouterBridge is a required library but that is installed by default)

• Click the dropdown arrow next your app name and enable Run at Startup to ensure the sketch restarts automatically after any reboot.

• Then click Run.

To verify data flow, go to JEDI in your browser and go to Settings → Devices. Your Uno Q should appear as a connected device, with temperature, humidity, pressure, and altitude values updating every 10 seconds.

At this point, the complete data pipeline is operational.

Visualize Your Data in JEDI

Now that JEDI is receiving data, you can build dashboards, add charts, set up automated alerts, and more without writing a line of code.

Create a Dashboard:

• In JEDI, navigate to Dashboards→Grid Dashboard.
• Click on the orange +Add Chart button

Add Charts:

• Add numeric Tiles for temperature and humidity.
• Create a Time Series chart for temperature and humidity.

Create and configure widgets
1. To add your first tile, click on the “Tile” option under SINGLE METRIC, give it a name like Temp

2. To configure the data to display in the tile, navigate to the DATA SELECTION tab at the top, under DEVICE, select the UNO-Q-JEDI. Under METRIC, select temperature, then click the green save button at the bottom.

3. After clicking save, you will be placed back into your Grid Dashboard, where you will see a live tile with the temperature in celsius (note this refreshes every 10 seconds)
4. You can then click +Add Chart again in the upper right, add one more tile, name it something like humidity, under the DATA SELECTION tab, choose the UNO-Q-JEDI again but select humdity as your metric.
5. Now you can add one more chart for a Time Series graph (this is under MULTI METRIC chart types, give it a name Temp-humidity trend, in the DATA SELECTION tab, select your device, but now add both temperature and humidity and click the green ADD button on the right. You should have something that looks like this:

6. Now, before clicking save, navigate to theCHART OPTIONS tab and turn MULTIPLE Y-AXES to “On”
7. In the DATA OPTIONS tab, there you will see options for temperature and humidity, by clicking either one, you can assign a color and select the Y-AXIS assignment for that value, and label the axis for that value, and define units. You should see something like this:

8. After clicking SAVE your dashboard should look like this:

Next Steps:

You’re ready to move from simple monitoring to advanced setups and applications.

• Explore setting Rules and Alerts based on conditions and schedule.
• Explore Transforms to dynamically process and manipulate data in real time.
• Consider adding additional Qwiic sensors, creating advanced dashboards, or integrating external data sources.

In just a few steps, you’ve built a complete edge monitoring solution that runs entirely on the Arduino Uno Q board. The Arduino Uno Q + Machinechat JEDI One Rapid Prototyping Kit removes much of the complexity traditionally associated with configuring integrations and infrastructure.

This project is only the beginning. Experiment with new sensors and expand from prototyping a new idea to building intelligent, custom edge technologies. Check out JEDI’s full documentation to explore further.

FAQs

Is JEDI One a subscription service?

No. JEDI One uses a lifetime license model with no recurring subscription fees.

How often is sensor data updated?

The Arduino sketch above sends data every 10 seconds. You can adjust the reporting interval by modifying the delay value in the sketch.

Where is the sensor data stored?

JEDI stores data locally on the Uno Q as open CSV files at metrics/yyyy/mm/dd/source/hh.csv

Can I access the dashboard from my phone or tablet?

Yes. Any device on the same network can access the dashboard using a web browser at http://[uno-q-ip]:9123.

What happens if the Uno Q loses power?

If you’ve enabled Run at Startup for the Arduino sketch and installed JEDI as a service, both the sensor application and JEDI One will restart automatically when power is restored.

Where do I find my license key if I lose the card?

Your license key was included on the redemption card in the box. If you have lost it, contact Machinechat support at support@machinechat.io with your order details.

---

Full documentation: docs.machinechat.io · Arduino Uno Q docs: docs.arduino.cc/hardware/uno-q · Download JEDI One: machinechat.io/digikey-kits-jedi. Adafruit BME280 sensor: Datasheet and setup guide