iSG Display Max Product Guide

This iSG Display Max guide consolidates the useful setup, operation, settings, advanced feature, and FAQ content from the LinknLink iSG knowledge base.

1. Getting Started

1.1 Introducing iSG

LinknLink iSG (Intelligent Super Gateway) is the next-gen all-in-one smart home super gateway combining a centralized control panel, home automation hub, and multi-protocol gateway. Pre-installed with Home Assistant, it serves as an open ecosystem solution for both beginners and advanced smart home enthusiasts.

1.1.1 Features

• Super powerful hardware with 8-core CPU and 4GB RAM
• Intuitive touchscreen with dashboard
• Built-in Home Assistant
• Built-in Zigbee radio
• Supports external Z-Wave sticks
• Supports over 2,500 smart home brands
• Supports local control and automations
• Syncs with your phone for free remote controls
• Makes everything HomeKit compatible
• Makes everything working with Alexa and Google Home
• Digital photo frame mode supports playing media files from SD Card, USB drive or synced via cloud from smart phone app
• Home energy management (AI-powered)
• AI Agent interaction with Telegram/WhatsApp

1.1.2 Specifications

1.2 Important Notice

1. For optimal performance, use the included original power adapter. If unavailable, use any safety-certified 5V3A (for iSG Display) / 5V2A (for iSG Box) adapter with the appropriate cable.
2. Both iSG Display and iSG Box DO NOT contain batteries, so ensure a constant power supply.
3. To log in, iSG needs an internet connection. After that, it operates locally without internet, though some Home Assistant integrations, like Tuya, may still require it.
4. Default Home Assistant credentials (built-in): admin / admin. You can change it later in Home Assistant settings.

1.3 Installing (iSG Display)

The iSG Display can be placed on a desktop using the included stand or mounted on a wall.

Desktop Standing

Put it on desktop for easy and flexible use

Wall Mounting

Mount it on the wall as a fixed control center

1.4 Desktop Standing

1.4.1 Adjust the bracket angle

Adjust the supporting bracket in the package to the angle as shown in the figure below

1.4.2 Place the device on the stand

Attach the magnetic surface of the desktop stand to the metal plate located at the center of the product's back. Ensure that the lower bracket supports the protruding part of the product's lower back. Then, place the product on the desktop at a slight tilt to ensure stability.

Note: The bottom of the product must be in full contact with the desktop. Do not leave it suspended, as this may cause instability during use. The stand is designed only to provide angled support from the back, not to bear the full weight of the product.

1.5 Wall Mounting

1.5.1 Fix the hanging plate on the wall

The back of the product includes a standard mounting hole, which can be used with a wall-mounted hook or an ordinary nail. When using a regular nail, since there is only a single support point, we recommend applying adhesive to the back of the product for added stability and to prevent shaking during operation.

1.5.2 Hanging plate

For better support, we recommend a three-point mounting setup. While a dedicated mounting bracket is not included with the product, we can provide a 3D printing file so users with the proper resources can print and use a custom bracket.

Click HERE to download the 3D printing file for the mounting bracket

1.5.3 Place the device on the bracket

1.5.4 Hang the device on the hanging plate

When using a regular nail, since there is only a single support point, we recommend applying adhesive to the back of the product for added stability and to prevent shaking during operation.

1.6 Sign-Up and Sign-In

1.6.1 Connect to Internet

Power on the iSG and wait for about one minute. It will launch the software and prompt you to connect to the internet for first-time use.

Click "Connect to Wi-Fi" and select a Wi-Fi network for the iSG, or connect it to Ethernet using a USB-C adapter.

Then, agree the terms and proceed to sign-in page.

1.6.2 Sign-Up

You have two options for signing up for an account.

1.6.3 Sign Up on iSG Directly

Click "Sign up" and enter your email address as your account. Then click "Send verification code".

Check your email for the verification code, enter it, and set a password for your account. Finally, click "Sign up and Sign in" to complete the registration and sign in immediately.

1.6.4 Sign Up on LinknLink App

Download the LinknLink App from the App Store or Google Play and complete the registration process within the app. You can also scan the QR code below to download the app.

1.6.5 Sign-In

You have two options for signing in to iSG

1.6.6 Sign In on iSG Directly

Input the Email and password and click "Sign in".

1.6.7 Sign In by App Scaning

If you are using the LinknLink App, simply open the app and tap "+" > "Scan QR Code".

Then align the scanning frame with the QR code on the iSG and tap Sign in to complete the login.

1.6.8 Select Home

If you have multiple homes created in the LinknLink App, you will be prompted to select a home when signing in to the iSG.

If you are using iSG from scratch, you need to click "Create Home" to create a new home to start.

1.7 Navigating Functions

After signing in, click the icons on the navigation bar (on the left side) to switch between functions on the iSG.

Home: The iSG dashboard. Click " " to edit the dashboard with devices, add-ons, and services.

Devices: Add, edit, and control devices from various sources. You can directly add WiFi (LinknLink and Tuya), Zigbee 3.0, Z-Wave (requires USB Z-Wave stick) and Matter devices from here or sync devices from other brands from "Add Device" > "Apps".

Groups: Group devices by category for easier management (e.g., Living Room Lights).

Scenes: Create scenes by combining different devices for specific scenarios (e.g., Watch TV, Party, etc.).

Energy: Add electricity meters (including smart gadgets with metering functionality) to track and manage energy usage, analyze consumption, and automatically optimize energy efficiency with AI-powered automations.

Automations: Create local automations using devices added to iSG with simple setups (e.g., if... then... under specific conditions).

Media: Use the iSG as a digital photo frame to play your pictures and videos or enjoy extensive apps for entertainment.

Add-Ons: Access useful smart home apps (Home Assistant App, LinknLink, eWeLink, Aqara, etc.) or utility tools (File manager, Browser, Node-Red, etc.).

Settings: Configure iSG Settings, Local HA, External HA, MQTT Settings (for external server), Custom Background, HomeKit, Google Home and Alexa linking and Screen Locker. Keep your iSG up-to-date with System Update from here.

2. Using iSG

2.1 Energy

2.1.1 Prerequisites:

You need to have a device with metering capabilities.

2.1.2 Getting Started:

We will add a device with metering capabilities to iSG. Below is an example of adding a Zigbee device to HA:

1) Add the device through ZHA to HA. If you are not sure about the steps, you can refer to the article "Add Zigbee devices in HA," which shows how to use the built-in HA service of iSG to add Zigbee devices. If you have an external HA and want to import the devices from it to iSG, you can refer to this article to associate the external HA with iSG.

2) After successfully adding the device to HA, next, go back to iSG "Device" → "+" → "Home Assistant," to add devices of the power type and devices that monitor total energy consumption to iSG.

3) Combine an energy device with a power device to form an energy consumption device.

4) Go to the navigation bar on the left side of the iSG and find energy management.

2.2 Weather

2.2.1 LinknLink Weather Service

To add the LinknLink weather service, LinknLink is easier to use—you just need to select your city. However, if your city is not available in the provided list, you can email us at [email protected] or join our Discord community to let us know. Alternatively, you can choose to use Home Assistant to add the weather service.

1) Setup weather service, go to home - weather

2) Choose country and city

2.2.2 Home Assistant Weather Service

To add the Home Assistant weather service, you first need to log into iSG built-in Home Assistant. After adding and configuring the weather integration, you can then select this service in the iSG dashboard.

1) Use PC web browser to visit iSG built in Home assistant, iSG IP:8123

2) Go to Settings - Devices & Services

3) Add interguantion, click "+ ADD INTEGRATION", search "openweather"

4) Get OpenWeatherMap API key

• Use PC browser visit: https://openweathermap.org/appid, sign account with OpenWeather

• Copy API key

5) Get your address Latitude and Longitude from Google Map

6) Add OpenWeather Integration

7) After successful add OpenWeather integration, back to iSG weather setup, Choose weather display style and iSG will automatic discover home assistant service,

8) Name your city and finish weather service setup

2.3 Dashboard

1）Control devices, currently we only support instantly turn them on or off with a single click. If the device's on/off status changes, the card color will update accordingly.

2) Sensor devices, you can view sensor's data and status at a glance.

3) Add-ons, which give you quick access to apps like Home Assistant, Spotify

4) Camera, You can preview the latest snapshots and click to view the camera in full-screen real-time mode.

2.4 Multi Dashboards

1) Manage your favorite devices in dashboard

Select your favorite devices and add-ons to pin to the dashboard.

2) Add a new dashboard, and setup timer. For example, you can show one Dashboard in the morning and different ones at noon or in the evening.

2.5 Add BroadLink Devices

iSG doesn't support importing devices directly from the BroadLink App. You need to add BroadLink devices to the LinknLink App first and then follow the instructions for "Add LinknLink Devices" to import them to iSG.

But you don't need to set up BroadLink devices again in LinknLink App!

The best approach is to unlock the devices in the BroadLink App, and the LinknLink App will automatically discover these devices on the "Add New Device" page. To unlock the device in BroadLink App, enter device page, navigate to "Device Settings" and disable "Lock Device" option.

Although LinknLink supports the BroadLink protocol and can discover all BroadLink WiFi products in the LinknLink App, there might be still some of them unsupported in LinknLink App. If you encounter any unsupported devices during the adding process, please provide us with two crucial pieces of information: the device model and its PID (found in Device Info in the device settings). We will add support for this device within 24 hours.

2.6 Automations

From the iSG main menu，navigate to the "Automations" section.

In the top right corner of the "Automation" screen, locate and click the "+" button to add triggers and actions for your automations.

You can choose devices or groups to perform actions when the trigger activates. Optionally, set conditions like specific time ranges to further refine your cutomation.

Click the switch next to each automation to enable or disable it.

Access the detailed settings page by clicking on an automation. Here you can edit its behavior or remove it completely.

2.7 Space Intelligence

2.7.1 Why is "Continuous No Presence Duration" Crucial?

• Cost-Effective Detection MethodEliminates the need for expensive human presence sensors that monitor existence, activity areas, and trajectories. Instead, we utilize infrared detection combined with time-based calculations to accurately determine whether a space is truly unoccupied.
• Simplified Installation, Reduced CostsTraditional smart home solutions often rely on door sensors, cameras, or multiple sensors to determine "occupied/unoccupied" status, resulting in complex installations and high costs. Our lightweight solution not only achieves precise detection but also significantly lowers hardware and installation expenses.
• Enhanced Energy Efficiency and ComfortAccurate "no presence" detection leads to higher energy-saving efficiency and a more comfortable living experience, helping users achieve intelligent energy management.
• Smart Adaptation to Various ScenariosDifferent time periods and spaces require varying durations of continuous no presence. Traditional solutions often necessitate complex manual settings. Our system adapts automatically through intelligent algorithms, simplifying user operations.

2.7.2 Core Technology

2.7.3 - Concept of Continuous No Presence Duration

• Accurate Unoccupied State DetectionAfter the sensor last detects someone, the system starts a timer. Only if no one is detected within the set duration will the system recognize the space as "truly unoccupied."
• Avoiding Misjudgments with Intelligent ResetIf someone is detected again during the timing period, the timer resets, preventing false positives caused by brief departures or temporary outings.

2.7.4 - Focus on "Presence" Without Determining Activity Areas

• Simplified Hardware and AlgorithmsNo need to track the exact location of individuals within the room or recognize their postures or trajectories, greatly simplifying hardware and algorithm requirements.
• Low-Cost, High-Precision DeploymentBy installing infrared sensors at room entrances or main corridors, high-precision space occupancy detection can be achieved at a minimal cost with easy deployment.

2.7.5 - Low Cost + High Precision

• Affordable HardwareUtilize inexpensive infrared human sensors connected to the iSG system for efficient monitoring.
• Intelligent Time-Based Calculation ModelCombine the collected signals with time-based models within the iSG system to ensure precise determination.

2.7.6 Application Highlights

2.7.7 - Energy-Saving Scenarios

• Lighting ControlAutomatically turns off lights when a space is detected as "continuously unoccupied" and swiftly turns them back on when someone re-enters.
• Air Conditioning Energy SavingsAutomatically adjusts the temperature or turns off the AC after the preset duration of no presence. When someone returns, it immediately restores the comfortable temperature.
• Other Device IntegrationExtends to TVs, speakers, fans, heaters, etc., preventing long-term standby power wastage by cutting off idle power consumption.

2.7.8 - Comfort Experience

• Fully Automated OperationEliminates the hassle of manual switching, ensuring the environment is always in the optimal state for enhanced living convenience.
• Rapid RecoveryWhen someone re-enters, the system instantly restores preset lighting and temperature modes, providing a more thoughtful living experience.
• Security & Privacy BalancedDoes not rely on cameras or other video devices, significantly protecting family privacy while also assisting in determining whether the home is occupied, thereby enhancing security.

2.7.9 - Simplified Operation

No Complex Settings Required，No need to individually configure integrations for each space. Simply place the infrared motion sensor and the execution device within the same space to achieve intelligent control.

2.7.10 System Structure and Working Principle

2.7.11 - System Structure

• Infrared Sensors: Installed at room entrances or key locations to detect human movement signals.
• iSG System: Receives infrared trigger information, applies time-threshold algorithms to determine if the space is "continuously unoccupied."
• Execution Devices: Adjust lighting, air conditioning, curtains, appliances, etc., based on system commands to turn on/off or change modes.

2.7.12 - Working Principle

Through time-based calculations, the iSG system records the last detected presence time, effectively filtering out situations where someone briefly leaves and returns, ensuring accurate determinations.

2.7.13 Q&A / Frequently Asked Questions

• Q1: If someone in the home doesn't move much, will the system mistakenly judge the space as unoccupied?A: The combination of infrared human sensing and time-based determination ensures that any slight movement signal will reset the no presence timer, preventing misjudgments.
• Q2: Does it require complex wiring?A: Infrared sensors can use wireless battery power or simple wiring methods, making installation and maintenance very convenient.
• Q3: How is privacy protected?A: The system only uses infrared to detect human movement without recording faces or uploading images. All data processing occurs locally within the iSG system without uploading to the cloud, ensuring privacy security.

2.7.14 Development and Future Prospects

• Enhanced Space Computing CapabilitiesFuture integrations will include temperature and humidity calculations, CO₂ and PM2.5 monitoring, energy consumption tracking, and illuminance measurements to enrich home health and energy management functions.
• Algorithm IterationContinuous optimization of algorithm models to improve the adaptability and precision of space occupancy determination, meeting more diverse smart home needs.

2.8 Add Zigbee Devices

The Zigbee in iSG comes in two versions: iSG Version and ZHA Version.

iSG Version: Works on iSG software for easier use but may not work well with some brands (ex. Aqara)

ZHA Version: Operates exclusively with Home Assistant (HA) for the best compatibility.

The default setting from the factory is the iSG Version. And the iSG Version can be upgraded to the ZHA Version.

After updating the Zigbee firmware to the ZHA version, the Zigbee radio will only be compatible with Home Assistant and cannot be reverted to the previous iSG version. Please consider this carefully before updating.

Zigbee Dongle Firmware

Built-In Zigbee Firmware

The following text describes the usage method of the iSG Version Zigbee. (If you want to view the usage method for the ZHA Version, please refer to this.)

1. Click the left edge of the screen, select "Devices" from the menu, and then click the "+" in the upper right corner to add a device.

1. In the pop-up window, select the "zigbee" brand, and then choose the corresponding device type based on your zigbee device.

2.9 Add Matter Devices

1. Click the left edge of the screen, select "Devices" from the menu, and then click the "+" in the upper right corner to add a device.

1. In the pop-up window, select the "matter" brand, and then choose the corresponding device type based on your matter device.

2.10 Sync Device from Home Assistant

1）How to connect external HA，https://kb.linknlink.com/isg/settings/ha-services

2) Go to Device - Add device - Home Assistant

3) iSG will automatic search devices added in external HA and iSG build-in HA

4) You can search the device name or choose from the list

5) You can also click "Add All", to add all devices added in external HA

Here are the steps for reference:

2.11 MQTT Broker

2.11.1 When is it necessary to use the MQTT broker add-on?

When using the built-in Home Assistant within iSG, if you need to add MQTT integration, you will need to enable and configure the MQTT broker properly.

2.11.2 How to configure the MQTT Broker add-on?

Ensure the add-on is activated, MQTT Broker's IP address is the iSG's IP address, and use port 1883. Remember to assign a static IP address to iSG on your home router to prevent service disruptions due to IP address changes.

You can set up a username and password for enhanced security when configuring the MQTT Broker add-on, or you can leave these fields empty if you prefer not to use authentication. If you choose to use them, make sure to remember the credentials, as they will be required for any device or service that needs to connect to the MQTT Broker.

2.12 Zigbee2MQTT

2.12.1 Prerequisites:

1）Zigbee Upgrade

• iSG users upgrade the Zigbee Dongle to the ZHA version,https://kb.linknlink.com/isg/settings/firmware-updates/zigbee-dongle-firmware
• iSG MAX users upgrade Zigbee to the ZHA version.https://kb.linknlink.com/isg/settings/firmware-updates/built-in-zigbee-firmware，
• Why I Can't Get Zigbee Firmware Update on iSG Display Max，https://kb.linknlink.com/isg/faq/others/why-i-cant-get-zigbee-firmware-update-on-isg-display-max
• How to differentiate between iSG Display and iSG Display Max，https://kb.linknlink.com/isg/faq/others/how-to-differentiate-between-isg-display-and-isg-display-max

2）Remove the ZHA integration installed in Home Assistant in iSG.

3）Restart iSG

4）Go to iSG Add-on, find MQTT Broker add-on and enter the username and password you want for the MQTT service..

2.12.2 Install and configure Zigbee2MQTT

1）Install Zigbee2MQTT

2）Configure Zigbee2Mqtt

Note: After you enter the information in the configuration pop-up window, click Save. If the content you entered is not displayed, please click Enter again.

• Original iSG

• iSG MAX

3）Enable Service and Auto Start Service

4）Use PC web browser and enter iSG IP:8080

5) Configure Zigbee2MQTT in the web page

• Make sure Zigbee2Mqtt is Not in Join Status
• Enter Settings - Home Assistant integration
• Choose Home Assistant (advanced)
• Input Home Assistant Status topic: hass/status
• Click Submit

2.12.3 Configure HA MQTT Integration

1）In HA settings - Devices & Services - Add integration, search MQTT and add to HA.

2）Click CONFIGURE MQTT

3）Click RE-CONFIGURE MQTT

4）Fill in the Broker information from iSG Mqtt Broker add-on into here

2.12.4 Add Zigbee devices in HA

After the MQTT Integration is configured, please come back to Zigbee2MQTT page. Click "Permit join (All)" and reset your Zigbee device. The Zigbee2MQTT service will automatically discover the device and let it join in.

Now, return to Home Assistant and navigate to Devices page, you will find the Zigbee device automatically shows up.

2.12.5 Add devices to iSG

Go to iSG - Devices - Add Device - Home Assistant, choose devices and add to iSG

2.13 Z-Wave JS Ul

2.13.1 Prerequisite:

1. The iSG system version must be 20124 or higher.
2. You can refer to this guide for upgrading the iSG version: iSG firmware Updates.
3. You need to have a Z-Wave USB dongle.
4. Use the Serial Port Viewer Add-on to view the serial port information of the Z-wave USB dongle in the system and copy its Path information.

2.13.2 Instructions for Use:

1）Turn on the iSG, and in the left navigation bar of the iSG, find "Add-Ons" → "ZWave-JS-Ul". Then click on "Install".

2）After the installation is successful, the service is default to being disabled. If you need to enable it, click on "Enable".

Turn on Auto Start Service. The plug-in service will be automatically started every time iSG restarts.

3）Access iSG ZWave-JS UI webpage in PC web browser by using URL shows on Add-on.

Go to Settings - Z-wave, input the Serial Port Path copied from Serial Port Viewer add-on, and click flash button to generate all keys, then click SAVE

4) Go to Control Panel, you should be able to see the Z-wave dongle you have added. Click the dongle infomation section to see the detail

5) Add Z-wave device in webpage, click right bottom manue and click manage nodes

6) Add to Home Assistant, Go to Settings - Home Assistant, enable WS Server and keep the Serier Port 3000.

7) Login to iSG built in Home Assistant, Go to Settings - Device & Services - ADD Integration, search Z-wave, Click Z-wave.

Input URL, ws://127.0.0.1:3000, then submit

8) You can now see the Z-wave intergration in the list

9) Click Configure to add Z-wave devices

10) Add Z-wace JS to Home Assistant Side bar, Click Settings - Dashboards - Add Dashboard, Input Title and choose the icon, then Creat dashboard.

Go to Side Bar, Choose Z-wave JS, click add card, choose Webpage

Input URL, http://Your iSG IP:8091, sand Save

2.14 iSG Credential Services

iSG Credential Services is an add-on for centralized management of API credentials for third-party platforms such as Telegram, ChatGPT, Gemini, and Home Assistant. With this service, you can enable advanced features such as the AI Agent, which requires interaction with multiple API keys or credentials.

This add-on is optional and not installed by default. To use it, go to the add-on section and click Install to set up the service.

Please wait 1–3 minutes for the installation to complete. Once installed, check if the service is enbled. If not, click the switch next to Enable to activate the service.

After the service is enabled, you can access it from a browser on the WLAN using the URL http://IP:3000 (the exact address will be shown on the add-on settings page).

2.15 iSG Web

Don’t want to always sit in front of the TV and navigate with a remote or mouse? With iSG Web, you can access your iSG directly from your computer’s browser over WLAN, with most iSG features available.

This add-on is optional and not installed by default. To use it, go to the Add-On section, click Install, and then switch Enable on after installation.

In iSG Web, you can also add devices and use certain add-ons directly.

2.16 Node-RED

Node-RED is an open-source, flow-based tool that lets you connect devices, APIs, and services with a simple drag-and-drop interface. It’s widely used for home automation, IoT projects, data processing, and dashboards, making it easy to integrate hardware and software without heavy coding.

This add-on is optional and not installed by default. To use it, go to the Add-On section and click Install to set up the service.

Please wait 5-8 minutes for the installation to complete. Once installed, check if the service is enbled. If not, click the switch next to Enable to activate the service.

After the service is enabled, you can access it from a browser on the WLAN using the URL http://IP:1880 (the exact address will be shown on the add-on settings page).

2.17 Matter Bridge

iSG natively supports adding Matter-over-WiFi devices (see Add Matter Devices). These devices will automatically sync to Home Assistant if your iSG is connected to HA (check Settings > Local HA).

However, if you prefer to add Matter devices directly in iSG's built-in Home Assistant, you’ll need to use this add-on.

This add-on is optional and not installed by default. To use it, go to the Add-On section, click Install, and then switch Enable on after installation.

After enabling the add-on, go to Home Assistant and click ADD on the discovered Matter integration.

2.18 Web Access (ZeroTier )

Users want to remotely access Home Assistant, but they need to add Cloudflare and Nginx Add-ons services within Home Assistant, which can be quite complex to configure. Therefore, we provide a simpler and faster configuration method. Please follow our steps below to set it up.

2.18.1 Sign up account with ZeroTier

1) Go to https://www.zerotier.com/, click top right "Sign Up"

2) You can use Google / Microsoft accout to login, or sign up with new account

3) Choose FREE "Basic Plan"

4) Click "Create A Network", and copy the Network ID

2.18.2 Install "ZeroTier One" App

1) Go to iSG Add-ons, find ZeroTier One and install it

2) Open ZeroTier one after installation, click “Add network”， currently ZeroTier shows OFFLINE

3)

2.19 Cloudflare

1. Open your computer's web browser, navigate to the CloudFlare official website (https://www.cloudflare.com), and complete the registration process to log in to your account.

1. Add a domain name. If you already have a domain name, click "Add a domain". If you don't have a domain name, you can also purchase a domain name in CloudFlare. The domain name purchased in CloudFlare will be automatically added to the Domain list.

It is recommended that individual users choose the free plan

1. In iSG Add-on, select CloudFlare and input domain you will use for remote access iSG HA.

Note:

1）Use the domain name you registered with Cloudflare，such as: linknlink.org

2) Add the subdomain in front of the domain name, such as : abcd

3) The last thing you need to enter is the synthesized subdomain. such as: adcd.linknlink.org

1. Click install CloudFlare

During the installation process, the system will automatically pop up the authorization page through Opera. You need to log in to your CloudFlare account and click Authorize.

Click "Authorize CloudFlare Tunnel", a page will pop up, click your domain name and activate it.

1. After successful authorization, back to CloudFlare will automatic finish intallation

1. Log in to CloudFlare through a computer browser and click on the domain name to configure it

1. In DNS - Records, you can see Record, indicating that iSG CloudFlare has been added successfully.

1. In the iSG built-in home assistant, use File Editor to add the following information:

http: server_port: 8123

use_x_forwarded_for: true

trusted_proxies:

- 127.0.0.1

1. Restart Home Assistant, and then you can access it remotely via YourDomain

2.20 Serial Port Viewer

2.20.1 Prerequisite:

The iSG system firmware version must be 20124 or higher.

You can refer to this guide for upgrading the iSG version: iSG Firmware Updates.

2.20.2 Instructions for Use:

1）Turn on the iSG, and in the left navigation bar of the iSG, find "Add-Ons" → "Serial Port Viewer". Here, you can view the serial port information connected to the iSG's USB port.

2）For example, when we plug a Z-Wave dongle into the USB port on the side of the iSG, clicking here will show us the automatically detected serial port information:

Note： If you plug in the USB dongle, no information is displayed in the details page on the right. You need to click on any other Add-on, and then click on the Serial Port Viewer Add-on, and the USB dongle information will be displayed. If still not, please contact us via discord channel

2.21 Add LinknLink Devices

1. Ensure the devices are already added to the LinknLink App and you have signed in to iSG using the same LinknLink account. If you don't have any devices in the LinknLink App yet, please refer to the device manual to add them.
2. Click "+" (Add Device) > "WiFi" > "LinknLink" > "Add All" to add all devices in your LinknLink account. Alternatively, you can click "Select to Add" and choose which products you want to add.

NOTE: The "Add All" option requires iSG firmware version 20094 or later. After V20149, you can directly add LinknLink device from iSG

2.22 Add Tuya Devices

1. Before configuring the WiFi device, please check whether the ISG network is correctly connected to the 2.4G network. If not, please modify the ISG network connection first.
2. Click the left edge of the screen, select "Devices" from the menu, and then click the "+" in the upper right corner to add a device.

1. In the pop-up window, select the "Tuya" brand, and then choose the corresponding device type based on your Tuya device.

1. Tuya has three pairing methods to add the device to the home Wi-Fi network：

①Wi-Fi Quick Connect

②Bluetooth pairing

③AP pairing.

According to the Tuya manual, select the corresponding pairing method. Then reset the Tuya device(For the setup mode for Tuya products, please refer to the original product manual for more assistance. For new users, this is easier, but existing users will need to set up the devices again).

After the reset is successful, click "Next" and select the home Wi-Fi network，enter the Wi-Fi password and click Start configuration.

NOTE:

• Most Tuya WiFi products after 2021 are designed with Bluetooth-assisted setup. If the product can be automatically discovered on the homepage in the Tuya / Smart Life App, it confirms that Bluetooth-assisted setup mode applies.
• The Tuya brand entry is also applicable to all its OEM brands, which can also be added to the Tuya / Smart Life App.

1. After successful configuration, choose the floor and room where the device is located in the ISG and click finish. This completes the addition of the Tuya Wi-Fi device which we can now successfully control

PS:

If you already have Tuya products set up on your WiFi network and don't want to set them up again, navigate to "Settings" > "Home Assistant" on iSG and add all Tuya products to Home Assistant.

Then, return to "Devices" and click "+" > "Home Assistant". It will discover all devices added to Home Assistant and let you import them to iSG. This method avoids setting them up again, but you need experience with Home Assistant.

You can refer to the specific steps in "How to import a Tuya device to iSG without resetting it."

2.23 Add LinknLink Devices

1. Ensure the devices are already added to the LinknLink App and you have signed in to iSG using the same LinknLink account. If you don't have any devices in the LinknLink App yet, please refer to the device manual to add them.
2. Click "+" (Add Device) > "WiFi" > "LinknLink" > "Add All" to add all devices in your LinknLink account. Alternatively, you can click "Select to Add" and choose which products you want to add.

NOTE: The "Add All" option requires iSG firmware version 20094 or later. After V20149, you can directly add LinknLink device from iSG

2.24 MQTT Broker

2.24.1 When is it necessary to use the MQTT broker add-on?

When using the built-in Home Assistant within iSG, if you need to add MQTT integration, you will need to enable and configure the MQTT broker properly.

2.24.2 How to configure the MQTT Broker add-on?

Ensure the add-on is activated, MQTT Broker's IP address is the iSG's IP address, and use port 1883. Remember to assign a static IP address to iSG on your home router to prevent service disruptions due to IP address changes.

You can set up a username and password for enhanced security when configuring the MQTT Broker add-on, or you can leave these fields empty if you prefer not to use authentication. If you choose to use them, make sure to remember the credentials, as they will be required for any device or service that needs to connect to the MQTT Broker.

2.25 How to Manually Start the Home Assistant Server

• Go to Add-on Management, and click the Refresh button and Update Script button respectively, as shown in the screenshot.

• After the update is complete (usually takes 10–30 seconds), click on Home Assistant Server again.

• Click the Enable button to start the server manually.

3. Settings

3.1 System Updates

3.1.1 Understanding iSG Software

The iSG composes with 3 parts of software:

3.1.2 How to Update iSG Software

The software can be updated using one of the following methods:

3.1.3 Online Update

If a new software version is available, an icon will appear in the top-right corner of the iSG interface. Click this icon to quickly access the System Update section. Alternatively, you can navigate to Settings > System Update to check for updates. If a newer version is available, a red dot will appear next to the System Update button, indicating the difference between the current and latest versions. Click the new version to begin the online update.

For more details, please check the section System Updates > Online Software Update.

3.1.4 Local Update

To update manually, navigate to System Updates > Local Updates. Download the software from the provided links, copy the files to a USB drive or SD card, then open the System Update page and click Install to apply the updates.

For more details, please check the section System Updates > Local Software Update.

3.2 Backing up and Restoration

3.2.1 Backing up iSG System

1）Insert the USB drive/SD card into the slot at the back of the iSG, click on Backup iSG System, and the system will jump to the file manager. Click on the "≡" in the top left corner.

2) Click “USE THIS FOLDER”, screen will back to iSG settings page after backup file successfully saved into USB drive / SD card.

** for iSG display, click "Allow access to "download" "

3.2.2 Backing up Home Assistant

1) It is recommended to perform the backup on the Home Assistant page. Connect your computer to the same network as the iSG, open a browser, enter: iSG IP:8123, and log in to Home Assistant. Go to Settings - Systems

2) Click Backups

3) Click "Creat Backup", The button will change to "Backup is currently being created". Wait for a few minutes. After the backup is successful, the file will appear in the list. Click to download, and save the backup file to your computer and then save it to a USB drive.

3.2.3 Restoring iSG

1) On the login screen, select "Import Backup". Insert the USB drive containing the iSG backup file. Click on the blank box to go to the file manager, and select the iSG backup file from the USB drive.

2）Click "Import" to complete the iSG Restore.

Note: The backup and restore function currently only works on the same iSG device. If you mistakenly restore to a different iSG, please power off the original iSG and do not use it again, as this may cause data confusion between the two iSG devices.

3.2.4 Restoring Home Assistant

1）Usually, Home Assistant can perform restorations on its own page, but iSG uses the Home Assistant Core version, which requires restoration of backups to be completed through iSG. Go to iSG settings - Restore.

2）Directly save the .tar file (do not unzip) downloaded from the Home Assistant backup to a USB drive/SD card, insert it into the iSG, and click Restore HA.

3.3 MQTT Settings

For example, when you integrate Tuya devices locally through iSG and wish to send these devices to an external Home Assistant via your local area network, you simply need to input the MQTT broker information from the external Home Assistant here. Once done, iSG will automatically forward all connected devices to the MQTT integration within the external Home Assistant.

After you have correctly entered the MQTT broker information, the connection status will be displayed in the MQTT settings.

For detailed information on how to use MQTT integration in Home Assistant, please refer to this link.

3.4 Screen Saver/Locker

After setting the screen saver in iSG, the screen will automatically enter the screen saver mode if there is no operation within the set time period. Touching the screen will bring you back to the last page you were operating on.

Go to Settings - Settings - Screen Saver, setup time

3.4.1 How do I change the screen saver picture?

1) Log in to the LinknLink App, select iSG at the bottom of the App, and then choose Media Center.

2）Set up the screen saver, click on the "..." in the top right corner, and select ScreenSaver.

3）Select photos from your phone's album to add to the screensaver.

3.5 Spaces

3.5.1 Add floor and room space

1) Go to "Settings - Spaces", Click top right "+"

2) Add Floors, click "+Customize", enter floor name, and click done. New floor will be listed on the Custom Room page.

3) Add Room, enter room name and choose floor

3.5.2 Edit the relationship between rooms and floors

1）Click the ✏️ Edit icon in the upper right corner.

2）In the pop-up window:

• Left side: Displays all the Floors.
• Right side: Shows all the Rooms.

3）Click on a floor from the left side, then select the rooms you want to assign to that floor from the right side.

3.5.3 Editing and Deleting Floors and Rooms

Select a space card, then click the "..." icon in the upper right corner of the details page on the right to edit the name of the floor or room. You can also delete the space here.

(Currently, you can only select the floor card after login; this issue will be fixed later.)

3.6 Accessing Android OS Settings

3.6.1 Navigation Path

Settings > Settings >System Settings

3.6.2 Function

Accessing Android OS settings for the hardware.

3.7 External HA

3.7.1 Copy token from external HA

1) Install Opera web browser in iSG add-ons, https://kb.linknlink.com/isg/using-isg/add-ons/opera

2) External Home Assistant (HA) must be on the same local network as iSG.

3) Use the Opera web browser to access the external HA. Input external HA "IP address:8123" to visit home assistant

4) Copy token from external HA, Go to user and scroll to the bottom，click “create token”

5) Copy token

3.7.2 Add external HA in HA Service

1) Go to Settings - HA service, click Add HA Service

2) Add external HA

• IP Address: external HA IP
• Port: external HA port, usually is 8123
• Token: copy from Opera

3) external HA connected, you can add more external HA

3.8 Basic Settings

3.8.1 Navigation Path

Settings > Settings

3.8.2 Timezone:

You will be redirected to the OS settings to change your timezone (default: GMT+0).

3.8.3 Temperature Unit:

You can switch the temperature unit between Celsius (°C) and Fahrenheit (°F). Weather information and sensor data will be displayed using the selected unit (default: Celsius).

3.8.4 Auto-Hide Slidebar:

Set the delay time for displaying the slider text (default: 3.0s)

3.8.5 Show Time/Weather on Top:

Turn on/off the display of time and weather info on top of dashboard (default: on).

3.8.6 Manage Menu Bar:

You can customize which functions are displayed in the main menu (default: all enabled).

3.9 Online Update

When the iSG is connected to the internet, it will automatically check for software updates. If a new version is available, a download icon with a red dot will appear at the top right corner of the homepage of any feature. You can click this icon to go directly to the System Update page, or navigate there via Settings > System Update.

The System Update page displays the current software version running on the iSG and the latest available version. If the update has not yet been downloaded, it will show "Not Downloaded". Click New Version, and in the pop-up window, click the Download button to go to the download page.

On the download page, you can click any of the provided links to download the update package. On the next screen, click Download anyway to start the download.

After that, the iSG will automatically return to the System Update page, where you can monitor the download progress of the update package.

Once the download is complete, the status will change to a blue "Downloaded". Click the Update button under New Version to proceed to the installation page.

On the installation page, the default installation method is the online package, and the option to delete the package after installation is checked by default (recommended to save storage space). Click Update to begin the installation.

After the iSG software is installed, the system will return to the iSG homepage. If you're installing a Container or Image, the system will reboot after the installation is complete.

The process for upgrading the Image is slightly different: selecting Update Online will update the image file in real time without downloading the full package (recommended). If the online update fails, select Update from Local Drive to download the offline package. Once downloaded, click the Update button under New Version to start the upgrade.

During the image installation process, the iSG will first back up all settings, then update the image. This may take up to an hour. Do not power off the device during this process. Once the update is complete, the iSG will automatically restore the backup settings and reboot.

3.10 Force Update

Sometimes you may need to update the software even if you cannot enter iSG due to critical issues. In such cases, you can perform a force update through the Android system. This process does not require logging in, and in some cases does not require a network connection.

The force update method only applies to iSG and Container software.

3.10.1 Download APK File(s) to USB Drive

Download the required APK file(s) to a USB drive. Please refer to iSG Downloads and Container Downloads. It is recommended to verify the MD5 checksum of the files before updating.

3.10.2 Access File Manager

To perform a force update, you need to access the system’s file manager app.

3.10.3 On iSG Box:

Press the Settings button on the remote control. The system menu will appear on the right side. Navigate to: Apps > See all apps, then locate and open File Manager+.

3.10.4 On iSG Display Max

Long-press the Power button on the back of the device and select Settings. Then navigate to: Storage > Documents and other.

3.10.5 Install Update

Find the update file (APK) on your USB drive and select it to launch the installer. When prompted, choose Package Installer and select Always.

After the update is installed, click OPEN to launch iSG.

3.11 iSG Downloads

You can click the download link below the version number to download the container software (APK file) for local update if online update is not successful.

NOTE:

1. Starting from version 20120, the software is designed exclusively for 64-bit OS. Users with the original iSG Display must flash the OS to a 64-bit version before updating. For instructions on how to flash the OS, please visit HERE. "How to differentiate between iSG Display and iSG Display Max"
2. Due to download traffic limitations, the availability of the links may be affected. To accommodate this, we provide multiple download links for the update. You can click any of the links below to download, and the application will automatically complete the installation. If a link is invalid, please try another one.

Please read the iSG Update Instructions before updating and refer to the iSG Quick Manual for the use instructions.

3.12 Container Downloads

You can click the download link below the version number to download the container software (APK file) for local update if online update is not successful.

NOTE:

1. Starting from version 100201, the software is designed exclusively for 64-bit OS. Users with the original iSG Display must flash the OS to a 64-bit version before updating. For instructions on how to flash the OS, please visit HERE.
2. Due to download traffic limitations, the availability of the links may be affected. To accommodate this, we provide multiple download links for the update. You can click any of the links below to download, and the application will automatically complete the installation. If a link is invalid, please try another one.

Please read the iSG Update Instructions before updating and refer to the iSG Quick Manual for the use instructions.

3.13 Image Downloads

You can click the version number to download the HA image (tar file) for local updating.

NOTE: It is highly recommended to verify the MD5 value of the file before updating. Download MD5 Checker

3.14 Backup and Restore Home Assistant

You have two ways to backup and restore Home Assistant:

3.14.1 Backup and Restore HA in iSG

3.14.2 Backup HA in iSG

Go to Add-Ons > Home Assistant Server > Backup.

After the backup is complete, click Restore to confirm that iSG has created a backup file for Home Assistant.

3.14.3 Restore HA in iSG

Go to Add-Ons > Home Assistant Server > Restore.

Select the backup file from the default backup folder, or click Select File to browse and choose one from an external drive.

Click Start restoration to restore from the selected backup file.

iSG will display “Restoration is successful” and then automatically exit the restoration page.

3.14.4 Backup and Restore HA in Home Assistant

3.14.5 Backup HA in Home Assistant

1) Connect your computer to the same network as the iSG. Open a browser and enter: iSG IP:8123. Log in to Home Assistant and go to Settings > System.

2) Click Backups

3) Click BACKUP NOW.

If this is your first time using the backup function, you will be prompted to create and save an encryption key. Be sure to keep it in a safe place, as you may need it in the future.

After the encryption key is created, click BACKUP again and choose an option to backup (choose Automatic backup for a full backup).

It will show "Creating backup" on top. Wait a few minutes until the process is complete. Once the backup is successful, it will show "Backed up" on top.

Click Automatic backups to view the backup files.

You can click Download to download the backup file to your drive for safekeeping.

Click the file to download it, save it to your computer, and then copy it to a USB drive for safekeeping.

3.14.6 Restore HA in Home Assistant

Click the backup file, select All Items, and then click RESTORE to restore your Home Assistant to the backed-up state.

3.15 Restore Home Assistant

Like backing up, you have two ways to restore Home Assistant:

3.15.1 Restore Home Assistant in iSG

Go to Add-Ons > Home Assistant Server > Restore.

Select the backup file from the default backup folder, or click Select File to browse and choose one from an external drive.

Click Start restoration to restore from the selected backup file.

iSG will display “Restoration is successful” and then automatically exit the restoration page.

3.15.2 Restore in Home Assistant

3.16 Factory Reset

Go to the iSG settings page and find System Settings.

1）For iSG Display

Go to System - Advanced - Reset Options - Erase all data (factory reset)

2) For iSG Box

System Settings > Device Reference > About > Factory Reset

3.17 Change Language

iSG supports the following languages: English (default), French, German, Italian, Spanish, Portuguese, Romanian, Czech, Arabic, Japanese, Simplified Chinese, and Traditional Chinese.

On the login page, you can click Switch Language to select your preferred language.

If you’d like to change the language after logging in, go to: Settings > Settings > System Settings to open the Android settings page.

From there, navigate to:

• Device Preferences > Language (for iSG Box)
• System > Languages & input > Languages (for iSG Display)

Select your desired language, then return to iSG. The interface will now appear in the language you chose.

3.18 Flashing OS for iSG Display

When your iSG cannot boot normally, you can refer to the following method to perform a complete flash.

Please note: After flashing, all iSG data will be completely cleared.

iSG image flashing Steps：

1. Prepare an SD card with more than 5GB of storage space; ensure it does not contain any files.
2. Click to download the image burning software PhoenixCard_V4.2.9.zip to your computer (only for PC).
3. Download the correct iSG image file according to your device model and purpose (click any link below to download): DO NOT flash the wrong image to SD card!

1. Unzip PhoenixCard_V4.2.9.zip file and run PhoenixCard.exe in the folder.
2. Click on 'Image' and select the image file.
3. Insert the SD card into your computer and click 'Burn'.
4. The system will begin burning the image; it will pause at 32% for a while, please be patient during this time. ---------------------------------------------------------------------- DO NOT close this window if the progress bar doesn't reach 100% ---------------------------------------------------------------------
5. When the progress bar reaches the end, it indicates that the image has been successfully burned to the SD card.
6. Insert the SD card into the iSG.
7. Power off and restart the iSG; it will display a progress bar, wait for it to complete.
8. After the flashing, the screen will go black, indicating that the iSG has been restored to the image.
9. Important! Remove the SD card.
10. Disconnect the iSG power, then reconnect it and wait for the iSG to boot up; it is then ready for use.

3.19 Backing up and Restoration

3.19.1 Backing up iSG System

1）Insert the USB drive/SD card into the slot at the back of the iSG, click on Backup iSG System, and the system will jump to the file manager. Click on the "≡" in the top left corner.

2) Click “USE THIS FOLDER”, screen will back to iSG settings page after backup file successfully saved into USB drive / SD card.

** for iSG display, click "Allow access to "download" "

3.19.2 Backing up Home Assistant

1) It is recommended to perform the backup on the Home Assistant page. Connect your computer to the same network as the iSG, open a browser, enter: iSG IP:8123, and log in to Home Assistant. Go to Settings - Systems

2) Click Backups

3) Click "Creat Backup", The button will change to "Backup is currently being created". Wait for a few minutes. After the backup is successful, the file will appear in the list. Click to download, and save the backup file to your computer and then save it to a USB drive.

3.19.3 Restoring iSG

1) On the login screen, select "Import Backup". Insert the USB drive containing the iSG backup file. Click on the blank box to go to the file manager, and select the iSG backup file from the USB drive.

2）Click "Import" to complete the iSG Restore.

Note: The backup and restore function currently only works on the same iSG device. If you mistakenly restore to a different iSG, please power off the original iSG and do not use it again, as this may cause data confusion between the two iSG devices.

3.19.4 Restoring Home Assistant

1）Usually, Home Assistant can perform restorations on its own page, but iSG uses the Home Assistant Core version, which requires restoration of backups to be completed through iSG. Go to iSG settings - Restore.

2）Directly save the .tar file (do not unzip) downloaded from the Home Assistant backup to a USB drive/SD card, insert it into the iSG, and click Restore HA.

3.20 Flashing OS for iSG Display

When your iSG cannot boot normally, you can refer to the following method to perform a complete flash.

Please note: After flashing, all iSG data will be completely cleared.

iSG image flashing Steps：

1. Prepare an SD card with more than 5GB of storage space; ensure it does not contain any files.
2. Click to download the image burning software PhoenixCard_V4.2.9.zip to your computer (only for PC).
3. Download the correct iSG image file according to your device model and purpose (click any link below to download): DO NOT flash the wrong image to SD card!

1. Unzip PhoenixCard_V4.2.9.zip file and run PhoenixCard.exe in the folder.
2. Click on 'Image' and select the image file.
3. Insert the SD card into your computer and click 'Burn'.
4. The system will begin burning the image; it will pause at 32% for a while, please be patient during this time. ---------------------------------------------------------------------- DO NOT close this window if the progress bar doesn't reach 100% ---------------------------------------------------------------------
5. When the progress bar reaches the end, it indicates that the image has been successfully burned to the SD card.
6. Insert the SD card into the iSG.
7. Power off and restart the iSG; it will display a progress bar, wait for it to complete.
8. After the flashing, the screen will go black, indicating that the iSG has been restored to the image.
9. Important! Remove the SD card.
10. Disconnect the iSG power, then reconnect it and wait for the iSG to boot up; it is then ready for use.

3.21 External HA

3.21.1 Copy token from external HA

1) Install Opera web browser in iSG add-ons, https://kb.linknlink.com/isg/using-isg/add-ons/opera

2) External Home Assistant (HA) must be on the same local network as iSG.

3) Use the Opera web browser to access the external HA. Input external HA "IP address:8123" to visit home assistant

4) Copy token from external HA, Go to user and scroll to the bottom，click “create token”

5) Copy token

3.21.2 Add external HA in HA Service

1) Go to Settings - HA service, click Add HA Service

2) Add external HA

• IP Address: external HA IP
• Port: external HA port, usually is 8123
• Token: copy from Opera

3) external HA connected, you can add more external HA

4. Advanced Features

4.1 AI Agent

With AI Agent feature, you will be able to chat or talk with your favorite chatting app (WhatsApp or Telegram) to access your smart home devices and control them.

4.1.1 Prerequisites

1. Make sure the devices are controllable in Home Assistant, and that their room names, device names, and entity names are user-friendly. (The AI Agent recognizes names based on the configuration in Home Assistant, not on iSG, for WhatsApp/Telegram control.)
2. Ensure your iSG is connected to the Internet.

4.1.2 How to Activate AI Agent

Click the Bot icon at the top-right corner of the dashboard.

1. Enable the AI Service.

If an Update button appears, please click to update the servi

1. Scan the QR code or search for the bot name to add it on WhatsApp or Telegram. Use your phone’s browser to scan the code, and it will automatically open WhatsApp or Telegram.
2. In the chat, send bind-[your iSG’s MAC address]. Your iSG will then display its current MAC address—simply type the same text in the chat and send.

1. You will then receive an email at your registered account containing a one-time verification code. Enter that code in the chat to complete the binding process.

4.1.3 Use AI Agent for Chat Control

After your iSG is bound to the AI Agent, you can send text or voice messages in the chat to control your smart home devices.

NOTE:

• If you send voice messages, there may be a slight delay due to network conditions and voice processing.
• Try to avoid using overly generic device names (e.g., “Light”, “Door”) because the AI Agent may interpret them as a device group.
• Including the room name is not mandatory, but if the control is not accurate, please try adding the room name to improve precision.

4.1.4 Example Utterances

• Turn on Ceiling Lamp in dedroom
• Set Wiz Bulb to Blue 50%
• What's the temperature and humidity in living room?
• Anyone in living room?

4.1.5 Smart Features

1. The chatbot understands any language for both inquiries and device control.
2. The AI Agent supports continuous interaction — you don’t need to repeat the device name or room if you issue another command within 1 minute.
3. The AI Agent can automatically correct minor typos or shortened device names, but we still recommend using the full names for the most accurate control.

4.2 LinknLink Remote

LinknLink brings incredible benefits to the Home Assistant community by offering free remote access to HA with a user-friendly interface. This is the world's first app with native Home Assistant integration, making it easier than ever to control your smart home from anywhere.

4.3 ZHA Integration

4.3.1 Prerequisite:

Before you begin, please ensure that you have accessed the Home Automation (HA) page. If you are not familiar with how to access the HA service on your iSG device, I recommend referring to the following article (Start Home Assistant), which provides detailed steps and instructions on how to access the HA service.

4.3.2 To add the Zigbee service:

1. Click on Settings - Devices & services - ADD INTEGRATION - search for ZHA - select "Zigbee Home Automation."

1. Then, in the pop-up window, choose EZSP for (Radio Type) and configure the (Serial Port Settings) with Serial device path: /dev/ttyAS3( iSG should fill in /dev/ttyUSB0; iSG MAX should fill in /dev/ttyAS3, If you are not sure how to distinguish your iSG model, please refer to this), Port speed: 115200, and select the third option for Data flow control, then submit. See screenshots below:

1. After the Zigbee service is configured, you can add Zigbee devices in Home Assistant.

1. Finally, go back to iSG "Device" → "+" → "Home Assistant," to select the devices you want to add to iSG.

4.4 Accessing Home Assistant

1. Check the status of iSG Home Assistant.When iSG first launches the HA service, it takes about 15 minutes to start up. Check iSG - settings - HA services - the details page on the right should display "running."Then, use the HA add-on to log in with the credentials (if you do not have a HA account, you can use the default system username and password: admin/admin to log in).

1. Access HA through iSG

• Access HA through the Opera browser in iSG: When the HA service status in Settings shows "Running", it means you can click on "iSG HA Service" below to enter HA(If you have not installed the HA APK, then by default, you will access HA through Opera from here).

• Access HA through the Home Assistant app within iSGIn the iSG, click on the navigation bar on the left, select "Add-Ons," and then find the "Home Assistant" card to download and install the service.

After the installation is successful, click "open" to enter HA (Home Assistant).

Note:

In the HA App, do not click the back button. If you wish to exit the app, click the small round button in the center of the menu bar at the bottom of the screen.

1. Access HA through a PC browser

1) The PC must be on the same local network as the iSG.

2) Find the IP address of iSG.

3) Open a browser on the PC and enter "[IP address of iSG]:8123" to visit Home Assistant, for example, 10.10.10.227:8123.

4.5 HA Add-on

This tutorial does not apply to ISG. The remote service described here is only applicable to Home Assistant OS (HA OS).

1) In the left sidebar of Home Assistant, click on Settings, then click on Add-ons.

2) Click "Add-on Store" in the bottom right corner, then click "Repositories" in the top right corner.

3) Enter https://github.com/linknlink/linknlink-remote, then click Add.

4) After successfully adding it, the LinknLink Remote card will appear in the Add-on Store.

5) After clicking on the LinknLink Remote card, click Install to begin the installation. The installation may take up to 10 minutes, depending on your internet download speed.

6) After successful installation, click Configuration, expand Authentication, then enter your LinknLink username and password. click "Save" If you don't have a LinknLink account yet, please download the LinknLink App to register an account.

7) Then click Start, and turn on Watchdog.

8）Switch to the Log page and find the Device ID. Later, if you have multiple HA servers under the same account, you will need to select the corresponding Device ID in the LinknLink App.

4.6 iSG Add-on

In iSG, click Add-Ons from the left sidebar, find the LinknLink Remote card on the right, and click Install.

After installation, click Enable

Then click Settings

Set RemoteAssistance to true.Click Save;

Now you can see a visitor code. This code allows other people to access it. If you are accessing it yourself, the code is not required.

Now, you can follow the guide below:

https://kb.linknlink.com/isg/advanced-features/linknlink-remote/windows-client

4.7 Windows Client

Download the PC software for LinknLink Remote from here: https://eucfg.linklinkiot.com/isg/frpclient-windows-amd64-latest.zip

Unzip the downloaded file and run "frpcclient-windows-amd64.exe"

Click "Login"

Enter your iSG account's email and password to login.

The software will list all iSGs under your account. The one with the check mark and the status “running” is the device with LinknLink Remote enabled. Please check whether the MAC address shown in the software matches the one on your iSG.

Then select the running device and click "Connect Selected Device".

IMPORTANT: Your Windows Security Center may flag the software and display a warning that “PUA:Win32/FRProxy” has been detected. Please allow it to run on your PC; otherwise, the software will not be able to connect to your iSG.

Once your iSG is connected, the remotely accessible services will appear on the right side.

Please click "Copy Port" or "Copy Link" to obtain the information needed for remote access. For instance, for Home Assistant, the link might be http://127.0.0.1:38123. You can simply paste it into your browser to access your Home Assistant on the iSG remotely.

4.8 Mac Software

1. Download the Remote Desktop Software

Visit https://aya.liriliri.io/ in your Mac browser to download the Mac application installer.

1. Install and Launch the Application, then Click the Button as Shown Below

1. Enter the iSG IP Address and Port 5555, then Click Connect. Once connected successfully, the iSG Box SE device information will be listed below in the Device Manager.

1. Return to the Main Application, Click the Button Shown Below to Access the iSG Control Interface

4.9 Windows Software

1、Download the software Download ADB AppControl from the official link below: https://adbappcontrol.com/download/?lang=en

2、Install the software After downloading, follow the installation wizard to complete the setup.

3、Choose a connection method ADB AppControl supports two ways to connect your device:

Method 1 — Connect over Wi-Fi

• Enter your device’s IP address in the top-right IP field
• Click the Wi-Fi icon to connect

Method 2 — Connect via USB

• Connect the device to your PC using a USB cable
• The software will automatically detect the Android device

4、Open the remote control tool Click the “Tool” button, then select “Control your device screen”.

5、Download the required script A pop-up window will ask you to download a script. Click “Yes”.

6、Download the correct script version Your browser will open a Git repository page.

• If your PC is 64-bit, download the win64 version
• If your PC is 32-bit, download the win32 version

7、Select the downloaded script After the download completes, ADB AppControl will automatically open a file selector. Choose the script file you just downloaded — do not extract it.

8、Start remote control Click “Control your device screen” again. You should now be able to access and control the device through the remote desktop interface.

4.10 LinknLink Devices

4.10.1 There are 3 ways to add LinknLink devices to Home Assistant

4.10.2 Using HACS integration

1) Use LinknLink App to successfully add smart home devices and make sure they are under the same wifi as iSG

2) Login iSG built-in Home Assistant in PC web browser, "Your iSG IP:8123"

3) To load the “LinknLink Local” integration via HACS, please refer to the detailed guide on HACS Integration.

4) Add LinknLink Device via Home Assistant Integration, please refer to the detailed guide on HA Integration.

4.10.3 Add through iSG

1) Add LinknLink device to iSG, you need use LinknLink App to add device first, then add it to iSG, please refer to the detailed guide on Add LinknLink Devices

2) Configure MQTT Broker from iSG Add-ons, please refer to the detailed guide on MQTT Broker.

Note : You can skip this step if you already have external Home Assistant and installed mosquitto added as Mqtt broker

3) Connect iSG to MQTT Broker, please refer to the detailed guide on MQTT Settings.

4) Discover devices in Home Assistant

• Add MQTT integration in Home Assistant, please refer to the detailed guide on HA MQTT Intergration. and configure Mqtt integration with iSG Mqtt Broker (information is shown on iSG Mqtt Broker add-on)
• Now, Home Assistant will automatically discover the devices in MQTT integration

4.10.4 Device2MQTT

LinknLink smart home devices will fully support MQTT connections and will connect directly to Home Assistant, once you configure MQTT in your device it will be discovered directly in Home Assistant MQTT integration.

Hint, currently only support eMotion, eMotion Max

For detailed configuration methods, please view eMotion2MQTT

4.11 HomeKit Device

Many HomeKit-supported brand devices have poor compatibility with Home Assistant, or they may not even support Home Assistant integration or HACS integration, creating significant obstacles for users during the setup process. Brands such as Meross, Aqara, and Lifx are examples of this. Please follow the steps outlined below to add these devices.

1) Use iPhone - Apple Home App to pair device

2) After successfully pairing, device should connect home Wi-Fi network

3) Remove device in iPhone - Apple Home App

• Go to Device page
• Click bottom right "settings"
• Scroll down to the very bottom and click "Remove Accessory"

4) Add device in Home Assistant, Go to Settings - ADD INTGRATION - Homekit Device

5) The HomeKit integration will automatically detect the device you just paired with the Apple Home app and add it to Home Assistant.

6) If you still want to control your devices using the Apple Home app, you can re-add them via the HomeKit Bridge. Please refer to the following instructions. https://kb.linknlink.com/isg/home-assistant/homekit

4.12 Tuya Integration

4.12.1 Prerequisite:

Before you begin, please ensure that you have accessed the Home Automation (HA) page. If you are not familiar with how to access the HA service on your iSG device, I recommend referring to the following article (Start Home Assistant), which provides detailed steps and instructions on how to access the HA service.

4.12.2 To add Tuya devices:

1. Click on Settings - Devices & services - ADD INTEGRATION - search for Tuya - select "Tuya"

1. Open the Tuya app, go to Me" → "Settings" → "Account and Security" to find the "User Code", then fill it into the input box and click "SUBMIT".

1. After the QR code appears as shown in the figure, use the Tuya APP to scan the QR code to authorize HA to log in and access your Tuya devices. Then click "SUBMIT" in HA.

1. This way, you can successfully import Tuya devices into HA without the need to reconfigure them.

1. You can try to control the devices within the HA software to see if they respond normally.

1. Finally, go back to iSG "Device" → "+" → "Home Assistant," to select the devices you want to add to iSG.

4.13 Aqara Integration

4.13.1 Prerequisite:

Before you begin, please ensure that you have accessed the Home Automation (HA) page. If you are not familiar with how to access the HA service on your iSG device, I recommend referring to the following article (Start Home Assistant), which provides detailed steps and instructions on how to access the HA service.

4.13.2 To add Aqara devices:

1. Click on Settings - Devices & services - ADD INTEGRATION - search for Aqara - select "Xiaomi"

4.14 MQTT Integration

1. To access the settings in the built-in Home Assistant of iSG, navigate to the "Settings" option in the right-hand sidebar, and then select "Device & Services."

1. Click on the "Add Integration" button located at the bottom right, and then search for "MQTT" in the pop-up window.

1. Select 'MQTT' to enter the settings.

1. Enter the MQTT broker information, making sure that the details you input match those configured in the iSG add-ons. Ensure consistency between the information in the add-on and what you enter here.

1. If the information entered is correct, the integration will successfully connect to the MQTT broker, and the MQTT Integration will appear in the list of integrations.

4.15 ONVIF Integration

4.15.1 Prerequisites

1) Camera needs to be configured to Home Wi-Fi / LAN network

2) The camera needs to support the Onvif protocol. You can check the instructions provided by the camera manufacturer or consult the manufacturer's technical support.

3) Find camera IP address, setup camera login username and password in App or web URL. Please refer to the camera manufacturer's instructions for detailed settings.

Hint: Usually you can directly google "camera brand + onvif"

For Example, Tapo camera,

• search "Tapo Onvif"
• find this url https://www.tapo.com/sg/faq/34/ ,
• follow the instraction to setup you username and password for ONVIF
• Port: 2020

4.15.2 Setup camera using ONVIF integration in Home Assistant

1) Go to Settings - Devices & Services - + Add Integration, search Onvif

2) Input information in the pop up box, then click finish

3) Choose Room, and click finish.

4) After successfully adding the ONVIF camera, return to the Home Assistant overview, where you can watch the camera video.

4.16 HACS Integrations

4.16.1 Add integrations that HACS has released.

1) Many brands of devices and services have been officially released on HACS, so you can directly search for them at the HACS entry point.

2) For example, if you want to add "Tapo" brand smart home devices, you can search Tapo, and choose the integration you need.

3) When you enter the homepage of the selected integration,

• please click on the 'Download' button located at the bottom right corner of the page.
• Click download on pop-up page
• After the download is complete, the pop-up window will automatically close.
• At this point, click to refresh the page. If the 'Download' button in the bottom right corner disappears, it indicates that you have successfully loaded the integration.

After completing this step, please proceed to step 3 to continue with the configuration.

4.16.2 Add integration from HACS Custom repositories

1）Enter HACS, click on the three dots in the top right corner (the 'More' options), and then select 'Custom repositories'.

2）Find the GitHub link provided by the device manufacturer, copy and paste it into the 'Repository' field, then select 'Integration' from the 'Category' dropdown menu, and finally click the 'Add' button. For example, LinknLink smart home device HACS integration github link is: https://github.com/linknlink/linknlink-local

3) Ensure that iSG has internet access at this time, as Home Assistant needs to be able to access GitHub. Once connected, a pop-up will automatically search for the integration, and you can simply click 'Add'. Please follow the subsequent wizard prompts to proceed.

Note： If the integration has already been reviewed and approved by HACS, a pop-up will prompt you to follow the instructions as described in Step 1.

4.16.3 Add device in HA Integration

After loading the integration in HACS, you need to go to the Integrations section in Home Assistant to add the device. For detailed steps, please refer to the Home Assistant Integration documentation.

1）Go to HA Settings - Devices & Services - Add integration

2) Search the Integraion you have added in HACS in Step 1 / 2

3) Finish Adding device

4.17 HomeKit Devices

Many Apple users want to add their connected home devices to the Apple Home app for easier control on their iPhones. This allows for convenient operation through Siri or quick access via the Control Center by swiping down from the top of the phone. Here's how you can use Home Assistant to convert non-HomeKit devices into HomeKit-supported devices.

1）Add device to Home Assistant by using integration or HACS integration

2) Go to Settings - Devices & Services - "+ ADD INTGRATION" - HomeKit Bridge

3) Select the entity types you want to add to the HomeKit Bridge. Click "Submit"

*Please note：you can choose to select all entity types, which will add all these devices to the Apple Home app. Alternatively, you can select specific entity types that you wish to add to the Apple Home app. Keep in mind that only entities successfully added to Home Assistant will appear later in the Apple Home app.

4) After successfully adding the HomeKit Bridge, it will appear in the integration list. Click on the left sidebar, and you will find the HomeKit Bridge QR code.

5) Using an iPhone / iPad, open the Apple Home app. After setting up your home, tap the "+" in the top right corner and select "Add or Scan Accessory." Point the camera at the QR code displayed in Home Assistant and scan to add the device.

Note

1）Each QR code can only be scanned and added once. After successful addition, the QR code will disappear in Home Assistant Notification. If you need to share the device with other family members, there are two options:

• Create a new HomeKit Bridge in Home Assistant, then repeat the process to add the device.
• Use the Family Sharing feature within the Apple system to share the device with family members.

2）Sometimes, after successfully scanning the QR code and clicking "Add," the app may get stuck in a waiting state. There are two possible reasons for this:

• No devices of the selected entity types have been added to Home Assistant. You need to add the devices to Home Assistant first, then create a new HomeKit Bridge.
• An issue occurred when creating the HomeKit Bridge in Home Assistant. In this case, delete the HomeKit Bridge and recreate it.

4.18 Bluetooth Proxy

4.18.1 Prerequisite:

To add Bluetooth devices in Home Assistant (HA), we need to use an ESP32 Bluetooth proxy. By configuring the ESP32 with ESPHome, we can turn it into a Bluetooth proxy, allowing it to transmit data from Bluetooth devices to Home Assistant for remote reception and control.

The steps to add a Bluetooth proxy in HA can be found in this video:https://youtu.be/CjpPdwK_ttg?si=qrtO0ekG3L44PQ8l

4.18.2 Add ESP32 Bluetooth proxy：

1. Once the ESP32 Bluetooth proxy is ready, please connect it to the same local network as the ISG. Next, open the ISG's Home Assistant (HA) page. Click on Settings - Devices & services.

1. Under the "Discovered " category, you will find a device named "esp32s3_ble_proxy ESPHome" that has been detected. Click the "Add" button to complete the device addition process.

4.19 File Editor

1）Go to iSG built in Home Assistant, Click HACS in side-bar, and search "Config editor", click "download", and it will show in the HACS list

2) Search " Config Editor Card" in HACS, and click "download", it will also show in the HACS list

3) Go to iSG add-ons, click HA Web SSH, install and Enable it.

Note, HA Web SSH can only be used in iSG after version 20130_x64, and Container version 100205_x64

4) Use PC Web browser to open http://iSG IP:4200

• Login Username: linknlink_user
• Password: admin
• Input command: ls
• Input command: nano configureation.yaml

5) Input "config_editor:" , and save the configuration.yaml

6) Restart Home Assistant, Go to Settings - Dashboards

7) Click "+ ADD DASHBOARD", choose "New dashboard from scratch"

8) Name the dashboard and choose icon, then click "CREATE"

9) "File Editor" will show on left side-bar, choose it and click top right edit

10) click edit

11) name the card and choose icon, then choose "Panel" in View type, then save it

12) click "+ ADD CARD"

13) Slide to the bottom and choose Custom cards

14) Click SAVE

15) Now you can use File Editor to edit configration.yaml file, choose file from bottom right

4.20 Backup

Access the built-in Home Assistant of iSG through a computer's web browser. Enter the iSG IP address:8123.

1. Click on "Settings" in the left sidebar, and then select "System".

1. Click “ Backups ”

1. Click on the "+ Create Backup" button located at the bottom right, and then click "Create".

1. Typically, the longer the system has been in use, the longer the backup process will take. Once the backup is complete, the most recent backup will appear in the backup list. Click on the download icon to the right, and save the backup file to a USB drive.

4.21 Restore

1. Click on the "Settings" option in the left sidebar of iSG, then select "Restore" and choose "Restore HA".

1. Click “ Choose from files ”

1. Insert the USB drive that contains the saved Home Assistant backup. Click on the directory icon located at the top left corner.

1. Click “USB DISK”，and finish the HA restoration

4.22 Lightwave Integration

1. In HACS, add custom repository: https://github.com/LightwaveSmartHome/homeassistant-lightwave-smart

1. Click "Add", search "Lightwave" in HACS and download the integration.
2. Go to "Settings" > "Devices & services" > "Add Integration" and search "Lightwave". Choose the first one "Lightwave Smart Custom Components".

1. Input your Lightwave username and password to proceed.

1. Click "Submit" and the integration will automatically discover the hub and devices in your local network and ask you to add in room.

5. Remote Screen Control

5.1 Remote screen control

You can download the tools here:

• macOS: https://kb.linknlink.com/isg/advanced-features/linknlink-remote/pc-desktop/mac-software
• Windows: https://kb.linknlink.com/isg/advanced-features/linknlink-remote/pc-desktop/windows-software

6. FAQ

6.1 iSG Related

1.Can One Device Work with Both iSG and Its Native App?

If you set up the devices directly on iSG (using either WiFi > Tuya or Zigbee), they won't be able to be controlled in their native app (e.g., the Tuya App).

However, if you import devices from existing setups (either from native apps like the LinknLink App or from Home Assistant), they will still be accessible and controllable in their native apps.

6.2 iSG MAX with the error message "Failed to get device license information"?

1) Download the latest iSG MAX software from firmware update, and copy it to a USB drive or SD card. Then, insert the external storage into the iSG's USB port or SD slot. * If you get error message from google when you click download, please choose different download source.

2) Press and hold the power button on the back of the iSG Display MAX. Three quick options will appear - select the last one to access the system settings.

3) In the system settings, navigate to storage - Documents & others, and install the APK file from the USB drive or SD card.

4) after APK successfully installed, Use the power button to access the quick options again and select “Restart.”

5) After restarting, a page will appear asking you to send us the MAC address. Please take a photo or write it down, then send the MAC address to [email protected] and wait for our confirmation.（Make sure the photo is taken clearly so that we can read the correct MAC address.）

We will register your MAC address in the cloud for automatic activation, so your iSG will no longer require any activation in the future.

6.3 Why I Can't Get Zigbee Firmware Update on iSG Display Max

All iSG Display Max devices come with a built-in Zigbee radio running the iSG version firmware. You may have already updated the iSG software to V20120 following the instructions in the Knowledge Base article "Firmware Updates | Built-In Zigbee Firmware" and attempted to upgrade the Zigbee firmware to the ZHA version. In some cases, the Zigbee version may display as "ZHA" (as shown in the screenshot below), but it is still actually running the iSG version.

To resolve this, follow these steps:

1. Download the updated iSG software, version 20121_x64_Beta, and use an SD card or USB drive to apply the update. The iSG will automatically reboot after the installation.
2. Go to Settings > USB Function. If the option is set to "HA", click to change it to "Normal USB" and ensure the Zigbee State reads "Network normal".

1. Afterward, return to Firmware Update, and the iSG will correctly identify the current Zigbee firmware and prompt you to update it to the ZHA version.

6.4 How to use USB drive to Update iSG firmware?

6.4.1 Download iSG update file onto a USB drive

6.4.2 Access the system settings

Press and hold the power button on the back of the iSG Display MAX. Three quick options will appear - select the last one to access the system settings.

6.4.3 Find USB Drive in system storage

In the system settings, navigate to storage - Documents & others, and install the APK file from the USB drive.

6.4.4 Click “USB DISK”，select iSG update APK file and finish installation.

6.5 How to use Opera to Update firmware?

Sometimes when we click on the upgrade option in iSG, we might encounter a message saying "Download resources are unavailable." This typically occurs because a large number of users are attempting to download simultaneously, causing the download server to temporarily become unresponsive.

We have provided multiple download links in our online help documentation to support manual upgrades. Here are the specific steps to use Opera for the upgrade:

1）Open Opera in iSG， Add-ons - Opera, click "Open" on the right

2) Input URL " kb.linknlink.com/isg " in Opera browser. click "Firmware Update"

3) Click "iSG Software", click the latest released download link

4) Click " Download anyway "

5) click "Download" in pop up window

6) Click top right user icon, and click "Downloads"

7) click the download apk file to update firmware

8) Click Update, iSG will restart after the update is complete

6.6 How to upgrade iSG to support HA to the latest version? 【update 05/08/2025】

6.6.1 Prerequisites:

1. iSG Upgrade: If you are using the original iSG device (which relies on an external Zigbee dongle), please ensure your iSG has been upgraded to the 64-bit version. For detailed instructions, refer to: https://kb.linknlink.com/isg/faq/firmware-update/upgrading-original-isg-display-to-support-ha-to-the-latest-version
2. Zigbee Dongle Mode: The Zigbee dongle must be switched to ZHA mode before proceeding. Please follow the guide here: https://kb.linknlink.com/isg/settings/firmware-updates/zigbee-firmware-usb-dongle
3. Power & Network Requirements: During the upgrade process, do not disconnect the power or internet connection. This update includes major changes and may take up to 2 hours to complete. Please be patient.

6.6.2 Manual BACKUP

Although we have added automatic backup and restore functions to the upgrade process, we do recommend that users manually back up their files: 1) Backup iSG Go to iSG Settings - iSG Firmware / backup - Backup iSG, save backup file to USB drive

2) Backup Home Assistant · Use PC browser to access home assistant, iSG IP:8123 · In the left sidebar, click “Settings”. · On the “Settings” page, locate and click “System”. · click “Backups” to access the backup management page · Click the “Create Backup” button in the bottom-right corner ` Wait for the Backup to Complete, Download the backup to PC

3) Backup Zigbee · Log in to Zigbee2MQTT, Open your browser, enter your Zigbee2MQTT instance address (e.g., http://iSG IP:8080) · In the topbar, click “Settings”. · Select "Tools" and Click " Request_z2m_backup" · Click "download_z2m_backup", and save backup to PC

4) Backup Z-wave · Use PC browser to access the Z-Wave JS UI management interface (e.g., http://iSG IP:8091). · Go to Settings > Backup & Restore. · Click Download Backup to save the .tar.gz backup file.

6.6.3 Update iSG

1）Online update If your iSG version is kept up to date, you can go to iSG settings - iSG Firmware, find the new version in the details page on the right, and then click "Download Update" to update the firmware. After the update, the device will automatically restart.

2）Manual Update Go to iSG system - storage - usb drive, find the iSG update APK file and select to install. download the latest iSG firmware

Please refer to the "How to use USB drive to Update firmware" guidance. https://kb.linknlink.com/isg/faq/firmware-update/how-to-use-usb-drive-to-update-isg-firmware

6.6.4 A new way to update iSG

Starting from version 20145, iSG will use a new update method. The system update is divided into three parts: iSG, Container, and Image. If there is any update in these three parts, an icon for downloading updates will appear in the upper right column of the homepage. Clicking the icon will directly lead to the update page.

You can also go directly to iSG Settings - System Update to find the update page

6.6.5 Container Update

download the latest container

1) Online Update If you see an upgrade prompt, please click "New Version" to download the latest firmware, and then click "Update" to enter the upgrade wizard. After each upgrade, iSG will restart to take effect.

2) Manual Update You can also download the firmware to your computer from the upgrade webpage first, and then copy it to a USB flash drive. Click "Update" directly, enter the upgrade wizard, click the USB flash drive icon on the page, and select the corresponding upgrade firmware from the USB flash drive. Remember not to change the name of the downloaded upgrade file, otherwise the upgrade may not be successful.

6.6.6 Image Update

download the latest image

Click “Update” to enter the image update.

• Please choose "loacal update"
• It will automaticlly backup Home Assistant, Zigbee2Mqtt and Z-wave JS UI
• It will start a fresh installation of all the programs

Note!

Please keep your system powered and internet connected. It will take 2 hours to finish installation, please be patient!

• Finally, it will auto restore backups to finish update.

6.7 Upgrading Original iSG Display to Support HA to the Latest Version

6.7.1 IMPORTANT:

• This guide is for original iSG Display only.
• This guide is for users want to keep their previous iSG and HA settings. For new users without need of data backup and restoration, please just read part 3 and 5.

6.7.2 Back Up iSG

Go to iSG Settings > iSG Firmware / Backup > Backup iSG, and save the backup file to your USB drive.

6.7.3 Back Up Home Assistant

In iSG Home Assistant, go to Settings > System > Backup, then save the backup file to your USB drive.

For detailed steps, please refer to the iSG and Home Assistant Backup Guide.

6.7.4 Flash iSG image from 32-bit to 64-bit

Flash the iSG image to the 64-bit version.

Refer to the Flashing iSG System Image guide for instructions.

6.7.5 Restore iSG

After flashing and restarting iSG, you'll be prompted to sign in. Do not sign in yet. Instead, click Restore and select your iSG backup file from the USB drive.

6.7.6 Setup Wizard

After restoration, iSG will begin initializing all configurations. Most setups are completed automatically without user intervention.

The only step requiring your input is the Zigbee setup, where you’ll choose the operating mode for the Zigbee radio (Z2M is highly recommended). If you select Z2M mode, please refer to the article Firmware Update > Zigbee Firmware (USB Dongle) to update the firmware on PC.

IMPORTANT: The Zigbee radio firmware update is irreversible if you choose Z2M mode. Once applied, it cannot be changed to Direct Mode.

Afterward, plug in the dongle and proceed with the auto-configuration of the Zigbee profile.

6.7.7 Restore HA

After all configurations are complete, navigate to Settings > Local HA > Restore HA. You’ll be taken to iSG’s file manager. Select the appropriate HA backup file, and iSG will restore your built-in Home Assistant settings to their previous state.

6.7.8 Re-Configure HA Token

After restoring your HA backup, the local HA status may remain in Starting. This is because the current HA instance token differs from what’s in your backup, preventing authentication. To resolve this, go to Settings > Local HA > Start Initialization.

follow the on-screen instructions to copy the token from the current HA instance.

Then, paste it into iSG’s HA Token verification page to complete the verification.

The wizard will also guide you through reconfiguring the MQTT broker. If you choose to use the default settings, simply click Next to proceed and complete the setup.

6.7.9 Done

You have successfully completed the upgrade process. If you encounter any issues during setup or installation, please reach out to our technical support team through the Discord Community.

6.8 How to differentiate between iSG Display and iSG Display Max

Currently, we have two models: iSG Display and iSG Display Max, and the hardware performance of these two is different.

The most straightforward way to distinguish them is by the USB port on the side of the device.

• The iSG Display has a micro USB port on its side.

• The iSG Display Max has a Type-C USB port on its side.

6.9 How to Get iSG Log for Advanced Troubleshooting

6.9.1 WHY AND WHEN DO WE NEED A DEVICE LOG?

A device log continuously records essential operational data for software, services, or interfaces on the device, and it may include diagnostic information for common device or function failures. In cases where standard troubleshooting methods fail, we may ask users to submit their device log to assist with advanced diagnostics for critical issues.

6.9.2 WHAT NEED TO BE PREPARED FOR GETTING THE LOG?

To retrieve the device log, you'll need the following:

• A computer, either a PC (running Windows XP/7/8/10/11) or a Mac.
• A USB cable to connect your computer and iSG device (Micro USB for iSG Display, USB-C for iSG Display Max). Note: iSG Box supports network diagnostics without the need for a cable.
• Download and install the ADB driver on your PC: Download_Link_1 | Download_Link_2
• Download and unzip the ADB tool on your PC: Download_Link_1 | Download_Link_2

The following instruction illustrates a scenario using PC to get log from iSG Display / iSG Display Max.

6.9.3 HOW TO CONNECT ISG TO COMPUTER?

6.9.4 1/ Hardware Connection

Connect your iSG Display to your PC using the USB cable. Your PC should automatically detect the device. To verify if the device is correctly recognized, open "Device Manager" in Windows by searching for it. In the list, you should see "Android Composite ADB Interface" as shown in the screenshot below.

6.9.5 2/ Launch ADB Tool

Navigate to the ADB tool folder on your PC. Right-click on any blank space in the folder and select "Open in Windows Terminal." A command line window will open in this folder.

Alternatively, you can launch the ADB tool by right-clicking the Windows Start icon, selecting "Run," typing "cmd," and pressing Enter. Then use the "cd" command to navigate to the folder (basic knowledge of command line tools is required).

6.9.6 3/ Check Connected iSG

Use the following command to list the devices connected to your PC:

adb devices

If multiple devices are connected, use the command:

adb disconnect XXX

This will disconnect unnecessary devices until only the target device is listed.

6.9.7 HOW TO RETRIEVE THE DEVICE LOG TO PC?

To display the device log, use the following command:

adb shell logcat *:E

This command will continuously print the log until you terminate the process. To stop it, press Ctrl + C.

To save the log directly to the root directory of drive D on your PC, use the command:

adb shell logcat *:E > D:/log.txt

(You can specify any location on your PC to save the log file.)

Once the log is saved, you can send the .txt file to our support team for advanced diagnostics.

6.10 How to factory reset iSG

Before doing the factory reset, please make sure to back up the data on the ISG, especially if you have configured devices on the ISG's Home Assistant (HA). Don’t forget to back up HA as well. You can refer to this article for instructions on how to perform the backup.

6.11 Reset Container

1. Go to iSG Settings - Settings - System Settings

1. Go to App

1. Click See all Apps

1. Find Termux App, and click Storage & cashe

1. Click clear cache & clear storage

6.12 How to Diagnose and Fix Home Assistant Startup Issues via SSH

When Home Assistant (HA) encounters issues such as failure to start, frequent crashes, or not starting automatically after reboot, the most common causes include:

• Broken or conflicting Python dependencies introduced by HACS
• Incompatible third-party (custom) integrations
• System resource issues (high memory usage, blocked processes, etc.)

6.12.1 Why Self-Diagnosis Is Necessary

1️⃣ HACS Comes with Known Risks

Home Assistant Logs warns users that installing HACS and custom integrations involves risk. These warnings are clearly shown in both the HA UI and system logs.

WARNING (SyncWorker_0) [homeassistant.loader] We found a custom integration xxx which has not been tested by Home Assistant. This component might cause stability problems.

6.12.2 2️⃣ Not All HACS Integrations Can Be Fully Tested

While we have tested many popular HACS integrations, it is not possible to guarantee full compatibility for all of them.

Therefore, when HA behaves abnormally, 👉 SSH-based diagnosis is currently the most direct and effective troubleshooting method.

6.12.3 How to Log In via SSH：

6.12.4 Step 1: Open a Command-Line Tool

• Windows: CMD or PowerShell
• macOS / Linux: Terminal

6.12.5 Step 2: Connect to the ISG via SSH

Run the following command:

Notes:

• Replace 127.0.0.1 with your ISG device IP address if needed
• 8022 is the SSH port

6.12.6 Step 3: Enter the Password

• Default SSH password: linknlink123
• For security reasons, you can change it here: ISG → Settings → System → Access Password

6.12.7 How to Start Diagnosing the Issue

6.12.8 Check Home Assistant Logs

Method 1: View recent logs

Method 2: View fault logs

6.12.9 Analyze Logs with an AI Tool (Recommended)

1. Copy the log output
2. Paste it into ChatGPT or another AI tool
3. Clearly describe:Your runtime environment: Ubuntu running under Termux + prootThe issue you are facing (e.g. HA fails to start)

AI tools can often quickly identify:

• Missing Python packages
• Dependency conflicts
• Root causes of startup failures

6.12.10 Enter the Home Assistant Runtime Environment

Execute the following commands in SSH:

Explanation:

• The first command enters the Ubuntu container
• The second activates HA’s Python virtual environment

6.12.11 Fix Dependencies Based on Diagnosis (Example)

Example: Fixing an urllib3 dependency issue

Verify installation

If version information is displayed, the dependency has been restored successfully.

6.12.12 Notes & Best Practices

• HA crashes are not necessarily hardware-related
• Most issues are caused by dependency conflicts or third-party integrations
• Frequent HACS installs or updates increase the risk of conflicts
• Recording the exact time of crashes or restarts greatly helps log analysis
• We are continuously improving the Dependency Check feature to cover more packages, including urllib3

6.13 How to upgrade iSG to support HA to the latest version? 【update 05/08/2025】

6.13.1 Prerequisites:

1. iSG Upgrade: If you are using the original iSG device (which relies on an external Zigbee dongle), please ensure your iSG has been upgraded to the 64-bit version. For detailed instructions, refer to: https://kb.linknlink.com/isg/faq/firmware-update/upgrading-original-isg-display-to-support-ha-to-the-latest-version
2. Zigbee Dongle Mode: The Zigbee dongle must be switched to ZHA mode before proceeding. Please follow the guide here: https://kb.linknlink.com/isg/settings/firmware-updates/zigbee-firmware-usb-dongle
3. Power & Network Requirements: During the upgrade process, do not disconnect the power or internet connection. This update includes major changes and may take up to 2 hours to complete. Please be patient.

6.13.2 Manual BACKUP

Although we have added automatic backup and restore functions to the upgrade process, we do recommend that users manually back up their files: 1) Backup iSG Go to iSG Settings - iSG Firmware / backup - Backup iSG, save backup file to USB drive

2) Backup Home Assistant · Use PC browser to access home assistant, iSG IP:8123 · In the left sidebar, click “Settings”. · On the “Settings” page, locate and click “System”. · click “Backups” to access the backup management page · Click the “Create Backup” button in the bottom-right corner ` Wait for the Backup to Complete, Download the backup to PC

3) Backup Zigbee · Log in to Zigbee2MQTT, Open your browser, enter your Zigbee2MQTT instance address (e.g., http://iSG IP:8080) · In the topbar, click “Settings”. · Select "Tools" and Click " Request_z2m_backup" · Click "download_z2m_backup", and save backup to PC

4) Backup Z-wave · Use PC browser to access the Z-Wave JS UI management interface (e.g., http://iSG IP:8091). · Go to Settings > Backup & Restore. · Click Download Backup to save the .tar.gz backup file.

6.13.3 Update iSG

1）Online update If your iSG version is kept up to date, you can go to iSG settings - iSG Firmware, find the new version in the details page on the right, and then click "Download Update" to update the firmware. After the update, the device will automatically restart.

2）Manual Update Go to iSG system - storage - usb drive, find the iSG update APK file and select to install. download the latest iSG firmware

Please refer to the "How to use USB drive to Update firmware" guidance. https://kb.linknlink.com/isg/faq/firmware-update/how-to-use-usb-drive-to-update-isg-firmware

6.13.4 A new way to update iSG

Starting from version 20145, iSG will use a new update method. The system update is divided into three parts: iSG, Container, and Image. If there is any update in these three parts, an icon for downloading updates will appear in the upper right column of the homepage. Clicking the icon will directly lead to the update page.

You can also go directly to iSG Settings - System Update to find the update page

6.13.5 Container Update

download the latest container

1) Online Update If you see an upgrade prompt, please click "New Version" to download the latest firmware, and then click "Update" to enter the upgrade wizard. After each upgrade, iSG will restart to take effect.

2) Manual Update You can also download the firmware to your computer from the upgrade webpage first, and then copy it to a USB flash drive. Click "Update" directly, enter the upgrade wizard, click the USB flash drive icon on the page, and select the corresponding upgrade firmware from the USB flash drive. Remember not to change the name of the downloaded upgrade file, otherwise the upgrade may not be successful.

6.13.6 Image Update

download the latest image

Click “Update” to enter the image update.

• Please choose "loacal update"
• It will automaticlly backup Home Assistant, Zigbee2Mqtt and Z-wave JS UI
• It will start a fresh installation of all the programs

Note!

Please keep your system powered and internet connected. It will take 2 hours to finish installation, please be patient!

• Finally, it will auto restore backups to finish update.

6.14 Upgrading Original iSG Display to Support HA to the Latest Version

6.14.1 IMPORTANT:

• This guide is for original iSG Display only.
• This guide is for users want to keep their previous iSG and HA settings. For new users without need of data backup and restoration, please just read part 3 and 5.

6.14.2 Back Up iSG

Go to iSG Settings > iSG Firmware / Backup > Backup iSG, and save the backup file to your USB drive.

6.14.3 Back Up Home Assistant

In iSG Home Assistant, go to Settings > System > Backup, then save the backup file to your USB drive.

For detailed steps, please refer to the iSG and Home Assistant Backup Guide.

6.14.4 Flash iSG image from 32-bit to 64-bit

Flash the iSG image to the 64-bit version.

Refer to the Flashing iSG System Image guide for instructions.

6.14.5 Restore iSG

After flashing and restarting iSG, you'll be prompted to sign in. Do not sign in yet. Instead, click Restore and select your iSG backup file from the USB drive.

6.14.6 Setup Wizard

After restoration, iSG will begin initializing all configurations. Most setups are completed automatically without user intervention.

The only step requiring your input is the Zigbee setup, where you’ll choose the operating mode for the Zigbee radio (Z2M is highly recommended). If you select Z2M mode, please refer to the article Firmware Update > Zigbee Firmware (USB Dongle) to update the firmware on PC.

IMPORTANT: The Zigbee radio firmware update is irreversible if you choose Z2M mode. Once applied, it cannot be changed to Direct Mode.

Afterward, plug in the dongle and proceed with the auto-configuration of the Zigbee profile.

6.14.7 Restore HA

After all configurations are complete, navigate to Settings > Local HA > Restore HA. You’ll be taken to iSG’s file manager. Select the appropriate HA backup file, and iSG will restore your built-in Home Assistant settings to their previous state.

6.14.8 Re-Configure HA Token

After restoring your HA backup, the local HA status may remain in Starting. This is because the current HA instance token differs from what’s in your backup, preventing authentication. To resolve this, go to Settings > Local HA > Start Initialization.

follow the on-screen instructions to copy the token from the current HA instance.

Then, paste it into iSG’s HA Token verification page to complete the verification.

The wizard will also guide you through reconfiguring the MQTT broker. If you choose to use the default settings, simply click Next to proceed and complete the setup.

6.14.9 Done

You have successfully completed the upgrade process. If you encounter any issues during setup or installation, please reach out to our technical support team through the Discord Community.

6.15 How to use USB drive to Update iSG firmware?

6.15.1 Download iSG update file onto a USB drive

6.15.2 Access the system settings

Press and hold the power button on the back of the iSG Display MAX. Three quick options will appear - select the last one to access the system settings.

6.15.3 Find USB Drive in system storage

In the system settings, navigate to storage - Documents & others, and install the APK file from the USB drive.

6.15.4 Click “USB DISK”，select iSG update APK file and finish installation.

7. Other

7.1 MQTT Integration

1. To access the settings in the built-in Home Assistant of iSG, navigate to the "Settings" option in the right-hand sidebar, and then select "Device & Services."

1. Click on the "Add Integration" button located at the bottom right, and then search for "MQTT" in the pop-up window.

1. Select 'MQTT' to enter the settings.

1. Enter the MQTT broker information, making sure that the details you input match those configured in the iSG add-ons. Ensure consistency between the information in the add-on and what you enter here.

1. If the information entered is correct, the integration will successfully connect to the MQTT broker, and the MQTT Integration will appear in the list of integrations.

7.2 Mac Software

1. Download the Remote Desktop Software

Visit https://aya.liriliri.io/ in your Mac browser to download the Mac application installer.

1. Install and Launch the Application, then Click the Button as Shown Below

1. Enter the iSG IP Address and Port 5555, then Click Connect. Once connected successfully, the iSG Box SE device information will be listed below in the Device Manager.

1. Return to the Main Application, Click the Button Shown Below to Access the iSG Control Interface

7.3 Windows Software

1、Download the software Download ADB AppControl from the official link below: https://adbappcontrol.com/download/?lang=en

2、Install the software After downloading, follow the installation wizard to complete the setup.

3、Choose a connection method ADB AppControl supports two ways to connect your device:

Method 1 — Connect over Wi-Fi

• Enter your device’s IP address in the top-right IP field
• Click the Wi-Fi icon to connect

Method 2 — Connect via USB

• Connect the device to your PC using a USB cable
• The software will automatically detect the Android device

4、Open the remote control tool Click the “Tool” button, then select “Control your device screen”.

5、Download the required script A pop-up window will ask you to download a script. Click “Yes”.

6、Download the correct script version Your browser will open a Git repository page.

• If your PC is 64-bit, download the win64 version
• If your PC is 32-bit, download the win32 version

7、Select the downloaded script After the download completes, ADB AppControl will automatically open a file selector. Choose the script file you just downloaded — do not extract it.

8、Start remote control Click “Control your device screen” again. You should now be able to access and control the device through the remote desktop interface.

7.4 iSG Related

1.Can One Device Work with Both iSG and Its Native App?

If you set up the devices directly on iSG (using either WiFi > Tuya or Zigbee), they won't be able to be controlled in their native app (e.g., the Tuya App).

However, if you import devices from existing setups (either from native apps like the LinknLink App or from Home Assistant), they will still be accessible and controllable in their native apps.

7.5 HACS Integrations

7.5.1 Add integrations that HACS has released.

1) Many brands of devices and services have been officially released on HACS, so you can directly search for them at the HACS entry point.

2) For example, if you want to add "Tapo" brand smart home devices, you can search Tapo, and choose the integration you need.

3) When you enter the homepage of the selected integration,

• please click on the 'Download' button located at the bottom right corner of the page.
• Click download on pop-up page
• After the download is complete, the pop-up window will automatically close.
• At this point, click to refresh the page. If the 'Download' button in the bottom right corner disappears, it indicates that you have successfully loaded the integration.

After completing this step, please proceed to step 3 to continue with the configuration.

7.5.2 Add integration from HACS Custom repositories

1）Enter HACS, click on the three dots in the top right corner (the 'More' options), and then select 'Custom repositories'.

2）Find the GitHub link provided by the device manufacturer, copy and paste it into the 'Repository' field, then select 'Integration' from the 'Category' dropdown menu, and finally click the 'Add' button. For example, LinknLink smart home device HACS integration github link is: https://github.com/linknlink/linknlink-local

3) Ensure that iSG has internet access at this time, as Home Assistant needs to be able to access GitHub. Once connected, a pop-up will automatically search for the integration, and you can simply click 'Add'. Please follow the subsequent wizard prompts to proceed.

Note： If the integration has already been reviewed and approved by HACS, a pop-up will prompt you to follow the instructions as described in Step 1.

7.5.3 Add device in HA Integration

After loading the integration in HACS, you need to go to the Integrations section in Home Assistant to add the device. For detailed steps, please refer to the Home Assistant Integration documentation.

1）Go to HA Settings - Devices & Services - Add integration

2) Search the Integraion you have added in HACS in Step 1 / 2

3) Finish Adding device

7.6 HomeKit Devices

Many Apple users want to add their connected home devices to the Apple Home app for easier control on their iPhones. This allows for convenient operation through Siri or quick access via the Control Center by swiping down from the top of the phone. Here's how you can use Home Assistant to convert non-HomeKit devices into HomeKit-supported devices.

1）Add device to Home Assistant by using integration or HACS integration

2) Go to Settings - Devices & Services - "+ ADD INTGRATION" - HomeKit Bridge

3) Select the entity types you want to add to the HomeKit Bridge. Click "Submit"

*Please note：you can choose to select all entity types, which will add all these devices to the Apple Home app. Alternatively, you can select specific entity types that you wish to add to the Apple Home app. Keep in mind that only entities successfully added to Home Assistant will appear later in the Apple Home app.

4) After successfully adding the HomeKit Bridge, it will appear in the integration list. Click on the left sidebar, and you will find the HomeKit Bridge QR code.

5) Using an iPhone / iPad, open the Apple Home app. After setting up your home, tap the "+" in the top right corner and select "Add or Scan Accessory." Point the camera at the QR code displayed in Home Assistant and scan to add the device.

Note

1）Each QR code can only be scanned and added once. After successful addition, the QR code will disappear in Home Assistant Notification. If you need to share the device with other family members, there are two options:

• Create a new HomeKit Bridge in Home Assistant, then repeat the process to add the device.
• Use the Family Sharing feature within the Apple system to share the device with family members.

2）Sometimes, after successfully scanning the QR code and clicking "Add," the app may get stuck in a waiting state. There are two possible reasons for this:

• No devices of the selected entity types have been added to Home Assistant. You need to add the devices to Home Assistant first, then create a new HomeKit Bridge.
• An issue occurred when creating the HomeKit Bridge in Home Assistant. In this case, delete the HomeKit Bridge and recreate it.