> For the complete documentation index, see [llms.txt](https://mysmax.gitbook.io/mysmax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mysmax.gitbook.io/mysmax/joi-platform-overview/understanding-joi.md).

# Understanding JOI

JOI is the innovative middleware at the heart of MySmaX's smart ecosystem, designed to simplify and enhance how IoT and robotics systems communicate and operate.

### What is Middleware?

Think of middleware as the essential software layer connecting all your smart devices, sensors, and robots, enabling them to talk seamlessly to each other and perform tasks smoothly. JOI sits between your devices and the apps or interfaces you use to manage them, quietly handling complex tasks so you don't have to.

### The JOI Hierarchical Structure Explained 

Unlike traditional systems that rely heavily on cloud-based servers, JOI uses a unique, tree-like hierarchical structure that allows multiple smart devices and services to communicate efficiently, securely, and rapidly.

Here's how it works clearly and simply:

* JOI Hubs: At every level—whether it's a single room, a large building, or an entire campus—JOI hubs process data locally and independently, ensuring fast decisions and secure operations.\ <br>
* Super Services: JOI hubs at higher levels can create specialized "Super Services"—services that coordinate tasks across multiple hubs securely. Lower-level hubs request these Super Services when needed, allowing complex tasks and resource sharing without cloud dependency.\ <br>
* Easy Scalability: Adding or reorganizing devices and services is simple. Just connect new JOI hubs or adjust the existing hierarchy, and the system adapts instantly.\ <br>
* Enhanced Privacy and Security: With strictly controlled service access and no direct device-to-device communication, JOI ensures your sensitive data always stays protected.\ <br>

JOI’s flexible, hierarchical middleware design makes managing advanced IoT and robotic systems easy, secure, and efficient—bringing technology seamlessly into everyday life.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mysmax.gitbook.io/mysmax/joi-platform-overview/understanding-joi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.