> For the complete documentation index, see [llms.txt](https://kb.linknlink.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.linknlink.com/kb/smart-home-devices/emotion-series/emotion2mqtt-ha.md).

# 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>