Matter Mode Switching (Button)

[Button <--> InvisOutlet]

Use the outlet's physical button to reset Matter, perform a full factory erase, or temporarily switch a Thread device between Matter-over-Thread and Wi-Fi service mode.

Hold-Time Summary

The firmware measures the total hold time and selects one action when the button is released.

Release time	LED while holding	Action
Less than 5 seconds	Normal device indication	No long-press reset or mode action.
5 to 9.999 seconds	Fast blink	Reset Matter and return to Matter-over-Wi-Fi commissioning.
10 to 29.999 seconds	Slow pulse	Perform a full factory erase and return to the out-of-box Matter-over-Wi-Fi state.
At least 30 seconds	Three rapid flashes followed by a pause	Toggle a Thread device between Matter-over-Thread and Wi-Fi service mode.

The action is determined when the button is released. Releasing between 10 and 30 seconds performs the full erase. Continue holding until the three-flash mode-switch pattern appears if the intended action is Wi-Fi service mode.

LED Threshold Indicators

5 Seconds: Fast Blink

At 5 seconds, the status LED starts blinking rapidly. Release before 10 seconds to reset Matter and return to Matter-over-Wi-Fi commissioning.

The blink uses approximately 200 ms on and 200 ms off intervals.

10 Seconds: Slow Pulse

At 10 seconds, the status LED changes to a slow breathing pulse. Release before 30 seconds to run the full factory erase.

The LED fades up and down over approximately 1.5 seconds in each direction.

30 Seconds: Mode-Switch Pattern

At 30 seconds, the status LED changes to a repeating mode-switch pattern:

• Three rapid flashes.

• Approximately 120 ms on and 120 ms off per flash.

• Approximately 700 ms pause before repeating.

Release while this pattern is active to enter or exit Wi-Fi service mode when the desired Matter transport is Thread.

Button State Transitions

Current runtime mode	Hold 5 to 9.999 seconds	Hold 10 to 29.999 seconds	Hold at least 30 seconds
Matter Wi-Fi	Reset to Matter Wi-Fi commissioning	Full erase to factory-default Matter Wi-Fi	Ignored for mode switching
Matter Thread	Reset to Matter Wi-Fi commissioning	Full erase to factory-default Matter Wi-Fi	Enter Wi-Fi service mode
Wi-Fi service	Reset to Matter Wi-Fi commissioning	Full erase to factory-default Matter Wi-Fi	Return to Matter Thread
OTA update	Uses the separate OTA button behavior	Uses the separate OTA button behavior	Uses the separate OTA button behavior

Return An Uncommissioned Thread Device To Wi-Fi

Use this procedure when the device is running Matter-over-Thread but Thread commissioning has not completed:

1. Press and hold the device button.

2. Wait for the fast-blink indication at 5 seconds.

3. Release the button before the slow pulse begins at 10 seconds.

4. Wait for the device to reboot.

5. Commission the device using Matter-over-Wi-Fi.

This action sets the desired Matter transport to Wi-Fi, clears Matter commissioning state, clears saved Wi-Fi station credentials, and opens a clean Matter-over-Wi-Fi commissioning path.

Temporarily Enable Wi-Fi For A Thread Device

Use Wi-Fi service mode when a Thread-commissioned device needs TCP app access, AWS IoT access, or OTA service without deleting its Thread pairing:

1. Press and hold the button while the device is in Matter Thread mode.

2. Continue holding through the 5-second fast blink and 10-second slow pulse.

3. At 30 seconds, wait for the three-flash mode-switch pattern.

4. Release the button.

5. The device persists Wi-Fi service mode and reboots.

After reboot:

• The desired Matter transport remains Thread.

• Matter and OpenThread do not start.

• Wi-Fi connects using previously saved station credentials.

• TCP, AWS IoT, OTA, and Wi-Fi service discovery can run.

• The Thread fabric and operational dataset remain stored.

Wi-Fi service mode requires usable saved Wi-Fi credentials. If the device has no saved Wi-Fi credentials, use the 5-to-9.999-second reset to return directly to Matter-over-Wi-Fi commissioning.

Return From Wi-Fi Service To Thread

To return to the preserved Matter-over-Thread network without recommissioning:

1. Press and hold the button while the device is in Wi-Fi service mode.

2. Continue holding until the three-flash pattern begins at 30 seconds.

3. Release the button.

4. The device clears only the Wi-Fi service flag and reboots into Matter Thread mode.

The Thread fabric and operational dataset are not erased.

Permanently Return From Thread To Matter Wi-Fi

From either Matter Thread or Wi-Fi service mode:

1. Hold the button for at least 5 seconds.

2. Release it before 10 seconds.

3. The device resets Matter and reboots into Matter-over-Wi-Fi commissioning.

This is a reset, not a temporary service transition. Existing Thread commissioning is erased and must be recreated if the device later returns to Matter-over-Thread.

The same transition can be requested through TCP callback 32 with callbackArgs: [0] while TCP is available.

Switch From Matter Wi-Fi To Thread

The 30-second button action does not switch a Matter-over-Wi-Fi device to Thread. If the desired Matter transport is Wi-Fi, the mode-switch action is ignored.

Switching from Matter Wi-Fi to Thread must be requested by the app through TCP callback 32:

{
  "packetID": 123456,
  "payload": {
    "callbackName": 32,
    "callbackArgs": [1]
  }
}

This intentionally clears the current Matter-over-Wi-Fi commissioning state and reboots into Matter-over-Thread commissioning.

Data Preservation

Action	Desired transport after reboot	Matter fabric and dataset	Saved Wi-Fi credentials	Product settings and preferences	AWS certificate and key
Release at 5 to 9.999 seconds	Wi-Fi	Erased	Erased	Preserved	Preserved
Release at 10 to 29.999 seconds	Wi-Fi	Erased	Erased	Erased	Erased
30-second Thread to Wi-Fi service	Thread	Preserved	Preserved	Preserved	Preserved
30-second Wi-Fi service to Thread	Thread	Preserved	Preserved	Preserved	Preserved
30-second action in Matter Wi-Fi	Wi-Fi	Unchanged	Unchanged	Unchanged	Unchanged

Full Factory Erase

Releasing the button from 10 seconds through 29.999 seconds runs the destructive full-reset path:

• Erases system product NVS.

• Erases the AWS certificate/key NVS partition.

• Erases Matter commissioning and network state.

• Returns the desired Matter transport to the factory default, Matter-over-Wi-Fi.

The full erase cannot preserve Thread pairing, AWS fleet-provisioned credentials, or accessory, PM, and OTA fields stored in the IM system NVS. PM-controller storage outside the IM is governed by the PM firmware's own reset behavior.

Normal Click Behavior

Outside OTA update mode:

Button input	Behavior
Single click	Toggle the controllable outlet.
Double click	Request a PM restart, blink the status LED, wait approximately 3 seconds, and restart the IM.

OTA Update Button Behavior

OTA update mode installs a separate button handler. The normal 5-second, 10-second, and 30-second mode-switch ranges are not active in this runtime mode.

Button input during OTA	Behavior
Single click	Toggle the outlet and its status indication.
Double click	Cancel the IM OTA request, show a slow blink, persist the cleared OTA state, and reboot.
Hold for approximately 5 seconds	Erase system NVS and restart.

Mode changes should normally be performed after OTA exits.

Quick Reference

Goal	Button procedure
Reset to Matter-over-Wi-Fi pairing	Hold 5 seconds and release before 10 seconds.
Completely erase the device	Hold 10 seconds and release before 30 seconds.
Give a Thread device temporary Wi-Fi service access	Hold at least 30 seconds and release.
Return from Wi-Fi service to the preserved Thread network	Hold at least 30 seconds and release.
Switch Matter Wi-Fi to Matter Thread	Not available by button; use TCP callback 32 with [1].