Skip to main content

Premium Feature — Alexa Integration

Harshal
  • Updated

3.0 Overview

The Premium Alexa Integration allows residents to control MHT lighting systems using Amazon Alexa voice commands.

Before starting the Alexa setup, make sure the Alexa device and the MHT lighting system are connected to the same Unit Wi-Fi network. This is an important requirement for successful Matter commissioning and device discovery.

Important: The Wi-Fi network used for the Alexa device must be the same Wi-Fi network used by the MHT lighting system. Wifi Details can be found on Lighting system Rack.

The Alexa integration uses Matter to connect Alexa with the MHT lighting system.

3.1 Prerequisites

Before starting the Alexa setup, make sure you have:

  • An Amazon Alexa-compatible device.
  • The Alexa mobile app installed on your phone.
  • Access to the Unit Wi-Fi network.
  • The NUC static IP address provided during room handover.
  • A laptop connected to the same Unit Wi-Fi network as the Alexa device.
  • The MHT lighting system fully commissioned and online.

The NUC static IP address will be provided during handover and will be documented on the rack.

3.2 Connect Alexa to Unit Wi-Fi

First, connect the Alexa device to the Unit Wi-Fi network.

Make sure the Wi-Fi network selected during Alexa setup is the same network being used by the MHT lighting system.

Once the Alexa device is connected to Wi-Fi, continue with the Matter setup.

3.3 Add the MHT Matter Device in the Alexa App

Open the Alexa app on your phone.

  1. Open the Devices section.
  2. Select the + icon in the top-right corner.
  3. Select Add Device.
  4. Select Matter.
  5. Follow the instructions displayed in the Alexa app.

Amazon's current Matter setup flow also uses Devices → + → Add Device → Matter, followed by scanning the Matter QR code or entering the pairing code. Refer to screenshot shown below

 

When Alexa asks you to scan the Matter QR code, leave the Alexa app open on the QR-code scanning screen.

3.4 Generate the Matter QR Code

The Matter QR code is generated through the MHT NUC.

Step 1 — Connect Your Laptop

Connect your laptop to the same Unit Wi-Fi network being used by the Alexa device.

Important: Your laptop and Alexa device must be connected to the same Unit Wi-Fi network.

Step 2 — Open the MHT Matter Integration Page

Open a web browser on your laptop and enter:

http://<NUC-STATIC-IP>:8080

Replace <NUC-STATIC-IP> with the static IP address provided during room handover.

For example:

http://192.168.x.x:8080

Note: The actual NUC static IP will be provided during handover and will be written on the rack.

Step 3 — Open Matter Bridge

Once the page loads:

  1. Navigate to Integrations.
  2. Select Matter Bridge.
  3. Select Open Commissioning.

The system will display a Matter QR code.

3.5 Scan the Matter QR Code

The QR code is displayed on your laptop, while the Alexa app is open on your phone.

Use the phone's camera through the Alexa app to scan the QR code displayed on the laptop.

After scanning:

  1. Follow the setup instructions in the Alexa app.
  2. Allow any requested permissions.
  3. Complete the Matter commissioning process.
  4. Wait until Alexa confirms that the setup is complete.

Amazon's Matter commissioning documentation confirms that the Alexa app uses the QR code to commission the Matter device and then completes the setup through the app.

3.6 Run Device Discovery

After completing the Matter commissioning:

  1. Return to the MHT web interface on your laptop.
  2. Navigate to Devices.
  3. Run the Discovery process.
  4. Wait for discovery to complete.

The MHT lighting devices should now appear in the device list.

These devices represent the lighting groups that can be exposed to Alexa.

 

3.7 Add Lighting Groups

After discovery is complete:

  1. Review the discovered lighting devices.
  2. Select Add for the desired lighting group.
  3. Enter a name for the lighting group.
  4. Use the apartment's established naming convention.

For example:

  • Living Room
  • Kitchen
  • Bedroom
  • Dining Room
  • Bathroom

Use names that are simple and easy to recognize when speaking to Alexa.

Recommendation: Use consistent room names throughout the apartment. Avoid unnecessary abbreviations or names that are difficult to pronounce.

3.8 Verify Lighting Groups Using Clusters

After naming the lighting groups:

  1. Navigate to Clusters.
  2. Locate the corresponding cluster.
  3. Use the ON/OFF controls to identify the physical lights controlled by that cluster.
  4. Verify that the lighting group name matches the correct physical location.

If a group is incorrectly named or assigned:

  1. Return to the appropriate device/group.
  2. Rename it using the correct naming convention.
  3. Repeat the verification process.

This step is important to ensure that the voice command controls the intended lighting area.

3.9 Test Alexa Voice Control

Once all lighting groups have been discovered, added, and correctly named, test the system using Alexa voice commands.

For example, if the lighting group is named Living Room, you can say:

"Alexa, turn on Living Room."

You can also use commands such as:

"Alexa, turn off Living Room."

"Alexa, dim Living Room."

"Alexa, set Living Room to 50 percent."

The exact voice commands available may depend on the Matter device capabilities exposed to Alexa.

3.10 Final Verification

Before completing the Alexa setup, verify:

  • Alexa is connected to the Unit Wi-Fi.
  • The laptop is connected to the same Unit Wi-Fi.
  • The NUC is online.
  • The Matter Bridge is accessible.
  • Matter commissioning completed successfully.
  • Device discovery completed successfully.
  • All required lighting groups have been added.
  • Lighting groups have been named according to the apartment naming convention.
  • Clusters have been tested and verified.
  • Alexa voice commands control the correct lighting groups.

Once all of these checks are complete, the Alexa Premium Integration is ready for use.

3.11 Troubleshooting

Alexa cannot complete Matter setup

Verify:

  • Alexa is connected to the correct Unit Wi-Fi.
  • The laptop displaying the QR code is connected to the same Unit Wi-Fi.
  • The Matter QR code was generated using Open Commissioning.
  • The QR code is clearly visible on the laptop screen.
  • The Alexa app has permission to access the phone's camera.

Matter QR code cannot be scanned

Try the following:

  • Increase the brightness of the laptop screen.
  • Make sure the entire QR code is visible.
  • Move the phone closer or farther from the screen.
  • Generate a new QR code using Open Commissioning.
  • Make sure the Alexa app has camera permission.

Devices do not appear after commissioning

Verify:

  • Matter commissioning completed successfully.
  • The Alexa device and MHT system are on the same Unit Wi-Fi.
  • The NUC is online.
  • The MHT lighting devices are online.
  • Run the Discovery process again.

Lights are incorrectly identified

Use the Clusters page to turn individual clusters ON/OFF and identify the physical lighting area.

Once identified, rename the lighting group using the correct apartment naming convention.

3.12 Example Complete Workflow

Connect Alexa → Unit Wi-Fi

↓

Connect laptop → Same Unit Wi-Fi

↓

Open NUC

http://<NUC-STATIC-IP>:8080

↓

Integrations → Matter Bridge

↓

Open Commissioning

↓

Matter QR Code displayed on laptop

↓

Scan QR code using Alexa app

↓

Complete Matter setup

↓

Return to MHT Web Interface

↓

Devices → Discovery

↓

Add Lighting Groups

↓

Name Lighting Groups

↓

Clusters → Verify Lights

↓

Test Alexa Voice Commands

↓

Alexa Integration Complete

Related articles

Powered by Zendesk