project-chip / project-chip/certification-tool

[Bug] chip-tool interactive server hangs during ble-wifi commissioning — WebSocket closes with 1011 keepalive ping timeout, aborting FirstChipToolSuite (TC-ACL-2.1)

Open
#1,037 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Bug Needs Triage
Dominant language
Shell
Stars
83
Forks
47
Avg merge
1d 15h
Merged PRs (30d)
17

Description

Describe the bug

When running FirstChipToolSuite (first test case TC-ACL-2.1) on the Matter Test Harness, the run fails during the Commission DUT setup step.

After the operator confirms the DUT is in commissioning mode, the chip-tool interactive (WebSocket) server produces no output at all for ~2.5 minutes, and then the Test Harness closes the WebSocket with:

Test Suite Error: Error occurred during setup of test suite.FirstChipToolSuite. sent 1011 (internal error) keepalive ping timeout; no close frame received

The whole run is aborted (TC-ACL-2.1 → CANCELLED, suite → ERROR).

This does not look like a clean commissioning failure — a clean failure would emit chip-tool error logs and keep the WebSocket alive to report the result. Instead the process appears to hang / become unresponsive:

No chip-tool log lines are emitted between "User chose DONE" (01:32:07) and the keepalive timeout (01:34:37).
On teardown, pkill -SIGTERM on chip-tool does not stop it (Could not get exit code after pkill command ...).
The Docker API call then times out (UnixHTTPConnectionPool ... Read timed out. (read timeout=60)), forcing the container to be stopped.

Steps to reproduce the behavior
  1. Set up the Matter Test Harness (TH v2.16-beta1+summer2026, SDK SHA 9dc6ceb).
  2. Configure the DUT: discriminator=3840, setup_code=20202021, pairing_mode=ble-wifi.
  3. Configure the WiFi network (ssid=TestWiFi).
  4. Start FirstChipToolSuite (test case TC-ACL-2.1).
  5. At the prompt "Make sure the DUT is in Commissioning Mode", click DONE.
  6. Observe: chip-tool stays silent for ~2.5 min, then the WebSocket is closed with a 1011 keepalive ping timeout and the suite aborts.
Expected behavior

Commissioning of the DUT over ble-wifi should complete successfully (or, on failure, chip-tool should emit a clear commissioning error and keep the WebSocket connection alive so the Test Harness can report the failure gracefully instead of timing out). chip-tool should also terminate cleanly on SIGTERM during teardown.

Log files

UI_Test_Run_2026_07_07_09_32_01.log

PICS file

No response

Screenshots

No response

Environment

No response

Additional Information

No response

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing FirstChipToolSuite test case TC-ACL-2.1 with the provided UI_Test_Run_2026_07_07_09_32_01.log as a reference, focusing on the period after “User chose DONE.” Investigate the chip-tool WebSocket hang, 1011 keepalive timeout, and failed pkill/Docker teardown; done means commissioning reports success or a clear failure while the WebSocket stays alive and chip-tool terminates cleanly.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, shell
Domain
devops, networking, testing-qa
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.