# eMotion2MQTT (HA)

### 1. Prerequisites

Ensure that your MQTT broker is correctly configured on your gateway or server.

* For iSG HA users, the MQTT service and integration come pre-installed with default settings.
* For other existing HA instances, you must manually install the Mosquitto MQTT broker service from Add-Ons and add the MQTT integration. If you need guidance on how to install it, refer to this video: <https://youtu.be/dqTn-Gk4Qeo>
* For non-HA systems, set up a compatible MQTT broker.

### 2. eMotion MQTT Settings

&#x20;  1\) Enter the eMotion device interface, click on the top right corner “...”, and select “MQTT connection” from the drop-down menu to enter the MQTT settings page.

<figure><img src="/files/HeQkoQRlAAMG0iZorKWL" alt="" width="188"><figcaption></figcaption></figure>

&#x20;  2\) MQTT Settings Interface Parameter Description：

&#x20;      ◼ IP Address(URL): Enter the IP address of your host, for instance 192.168.1.5&#x20;

&#x20;      ◼ Port Number: For MQTT Broker, the default port is 11883.&#x20;

&#x20;      ◼ Username & Password: Enter the username and password for your MQTT broker (only alphanumeric characters are allowed).&#x20;

&#x20;      *For iSG HA, both fields can be left blank if the default MQTT integration is used.*

<figure><img src="/files/9To1R9LzZzHckv0Cm4Ez" alt="" width="188"><figcaption></figcaption></figure>

&#x20;  3\) Then click save at the top right corner.After saving, you can revisit this page to check whether the MQTT connection is successful.

### 3. For example

For example, to report our device to Home Assistant (HA) via MQTT, you can refer to the following steps:

* Ensure the MQTT integration is added to your HA.
* Navigate to the device page in the LinknLink app (click the "..." menu in the top-right corner of the device page, then select "MQTT Connection").
* Enter the account and password for your MQTT broker in Home Assistant. The default setting is port number 11883, with the account and password fields left blank.

<figure><img src="/files/2z4f758UskIkPEXFEQp3" alt=""><figcaption></figcaption></figure>

* Once the "MQTT Connection Status" displays "Connected", the MQTT connection is successfully established.
* A new device will automatically be created in your HA instance, syncing the status directly from the device.

<figure><img src="/files/Gbd9SxP9x9cs26B0OYwO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/q3xvqBWVKpHIQjntga62" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/F2HpjoW8TajwiqkhU86z" alt=""><figcaption></figcaption></figure>

For motion sensors, you can adjust the "No-Person Delay" time on the device page in the LinknLink app to modify the delay time for status updates. 

**Setup Video**

<https://www.youtube.com/watch?v=HM5N3zuJLmA>


---

# Agent Instructions: 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:

```
GET https://kb.linknlink.com/kb/smart-home-devices/emotion-series/emotion2mqtt-ha.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.