[pull] master from project-chip:master

.agents/skills/chip-tool-testing/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: chip-tool-testing
+description:
+    Guidelines for building Matter examples and chip-tool, and testing examples
+    using chip-tool.
+---
+
+# Testing Matter Examples with Chip-Tool
+
+This skill provides guidelines for building Matter example applications and
+`chip-tool`, and using `chip-tool` to commission and interact with the examples
+in a simulated environment (like Linux POSIX).
+
+> [!NOTE] While `chip-tool` and examples support multiple platforms, these
+> guidelines focus on the Linux/POSIX environment, which is the standard
+> environment for agent execution.
+
+## Building from Source
+
+Always build the `chip-tool` and the Matter example application from the same
+revision of the repository to ensure compatibility.
+
+### Building chip-tool
+
+Use the build script to build `chip-tool` for Linux:
+
+```bash
+source scripts/activate.sh
+./scripts/build/build_examples.py --target linux-x64-chip-tool-clang build
+```
+
+The binary will be located in `out/linux-x64-chip-tool-clang/chip-tool`.
+
+### Building Examples
+
+Use the build script to build examples (e.g., `all-devices-app`):
+
+```bash
+source scripts/activate.sh
+./scripts/build/build_examples.py --target linux-x64-all-devices-boringssl build
+```
+
+The binary will be located in
+`out/linux-x64-all-devices-boringssl/all-devices-app`.
+
+## Testing Guidelines
+
+### Running the Example
+
+Run the example application (usually in a separate terminal or the background):
+
+```bash
+./out/linux-x64-all-devices-boringssl/all-devices-app
+```
+
+_Note: Use a clean KVS file (by specifying a new, non-existent file path with
+`--KVS`) or clear the existing one (by deleting the file) to ensure the
+application enters commissioning mode on startup._
+
+### 1. Determine Pairing Credentials
+
+Check the application logs on startup to find the setup PIN code and
+discriminator. Example log:
+
+```
+[DL]   Setup Pin Code: 20202021
+[DL]   Setup Discriminator: 3840 (0xF00)
+```
+
+> [!NOTE] The discriminator value `3840` (0xF00) is the standard default for
+> many Matter examples when not explicitly configured.
+
+### 2. Commissioning (Pairing)
+
+Make sure the device is in commissioning mode. If using a persistent storage
+(KVS), you may need to use a clean KVS file or clear it to force commissioning
+mode on startup. On Linux, the default KVS file is `/tmp/chip_kvs`:
+
+```bash
+rm /tmp/chip_kvs
+```
+
+> [!NOTE] > **Persistence Testing**: If you are performing a persistence test
+> (verifying state across restarts), do NOT delete the KVS file. Reuse the same
+> KVS file to preserve stored attributes.
+
+#### Over IP (On-Network)
+
+If the device is already on the same IP network (e.g., running locally on the
+same host):
+
+-   **With Long Discriminator**:
+    ```bash
+    chip-tool pairing onnetwork-long <node_id> <setup_pin> <discriminator>
+    ```
+-   **Without Discriminator** (looks for any commissionable device):
+    ```bash
+    chip-tool pairing onnetwork <node_id> <setup_pin>
+    ```
+-   **With Manual Pairing Code or QR Code**:
+    ```bash
+    chip-tool pairing code <node_id> <pairing_code_or_qrcode>
+    ```
+-   **Direct IP and Port** (useful if mDNS resolution fails):
+
+    ```bash
+    chip-tool pairing already-discovered <node_id> <setup_pin> <device_ip> <device_port>
+    ```
+
+    > [!CAUTION] If you encounter attestation failures in simulated
+    > environments, you may need to add `--bypass-attestation-verifier true` to
+    > the command. Use this flag ONLY for local simulated testing when you
+    > explicitly accept the security tradeoff of bypassing device attestation.
+
+### 3. Interacting with Clusters
+
+After successful commissioning, you can use `chip-tool` to interact with data
+model clusters.
+
+-   **Read Attribute**:
+
+    ```bash
+    chip-tool <cluster_name> read <attribute_name> <node_id> <endpoint_id>
+    ```
+
+    Example: `chip-tool basicinformation read vendor-id 0x8016 0`
+
+-   **Invoke Command**:
+    ```bash
+    chip-tool <cluster_name> <command_name> [arguments] <node_id> <endpoint_id>
+    ```
+    Example: `chip-tool onoff toggle 0x8016 1`
+
+## Using Chip-Tool Help
+
+`chip-tool` has a built-in help system that allows you to discover available
+clusters and commands. Running any command without all required parameters will
+show a help screen.
+
+-   **List available clusters**:
+    ```bash
+    chip-tool
+    ```
+-   **List available commands/attributes for a cluster**:
+    ```bash
+    chip-tool basicinformation
+    ```
+-   **See help for a specific action**:
+    ```bash
+    chip-tool basicinformation read
+    ```
+    This will show what attributes can be read from the `basicinformation`
+    cluster.
+
+This interactive help is useful for exploring the data model and finding the
+exact syntax needed.
+
+## Troubleshooting
+
+-   **Timeout**: If a command times out, you can increase it with
+    `--timeout <seconds>`.
+-   **Configuration Cache**: `chip-tool` caches state in `chip_tool_config.ini`
+    (often in the current directory or `/tmp`). Deleting this file can resolve
+    stale configuration issues. You can also specify a custom directory with
+    `--storage-directory <path>`.
+
+## Reporting Results
+
+When completing a test task using this skill, you should output a structured
+report to the user. Since every test may verify different features, do not force
+a fixed sequence of steps. Instead, follow these general guidelines for
+reporting each item you verified:
+
+For each verified feature, command, or configuration item, provide:
+
+1. **What was verified**: A clear description of the intent (e.g., "Verified
+   that Endpoint 2 is a child of Endpoint 1").
+2. **The command ran**: The exact `chip-tool` or shell command you used.
+3. **The proof (logs)**: A snippet of the output or logs that proves the
+   verification was successful (e.g., the attribute value read or the success
+   status).
+
+### General Guidelines for Content:
+
+-   **Build Process**: Mention which targets were built and if any custom flags
+    were used.
+-   **Startup**: Include the command used to run the application, and the
+    pairing credentials (Setup PIN and Discriminator) found in the logs.
+-   **Commissioning**: Show the command used and the log snippet confirming
+    success.
+-   **Data Model**: If hierarchy or device composition was verified, show the
+    relevant `Descriptor` reads.
+-   **Cluster Interaction**: For any attribute read/write or command invocation,
+    show the command and the response status.

.github/.wordlist.txt

@@ -72,6 +72,7 @@ approver
 appspot
 appwrite
 aps
+ARD
 arg
 argc
 args
@@ -80,10 +81,6 @@ armeabi
 armino
 ARMmbed
 armv
-ARD
-SCL
-SDA
-VCC
 ASAN
 asdk
 ASR
@@ -93,8 +90,8 @@ ASYNC
 AsyncZeroconfServiceTypes
 ATL
 ATLs
-atomics
 atomicity
+atomics
 att
 attId
 attr
@@ -249,6 +246,7 @@ ChlorodibromomethaneConcentrationMeasurement
 ChloroformConcentrationMeasurement
 chmod
 chown
+chroot
 chrpath
 CIPD
 CircleCI
@@ -294,7 +292,6 @@ commissionee
 CommissioningFlow
 commondatastorage
 Compat
-compat
 CONF
 CONFIG
 ConfigDescription
@@ -344,8 +341,8 @@ cstdint
 csu
 csv
 ctl
-CTS
 ctrl
+CTS
 ctypes
 CurrentHue
 CurrentLevel
@@ -559,9 +556,9 @@ EvalCode
 EvalCodeWithName
 EvalFrameDefault
 EVB
-EVKBMIMXRT
 EventLogging
 evk
+EVKBMIMXRT
 EVSE
 exceptfds
 ExchangeContext
@@ -599,8 +596,10 @@ FFFFFFFFFFFF0102
 FFmpeg
 Fi
 filepath
+filesystems
 fini
 FixedLabel
+fixups
 flashdebug
 FlowMeasurement
 FluorideConcentrationMeasurement
@@ -610,9 +609,9 @@ formatter
 formatters
 FOTA
 framerate
+FRDM
 FreeRTOS
 FreeRTOSConfig
-FRDM
 FS
 fsl
 fstab
@@ -706,7 +705,6 @@ hostname
 hotfixes
 href
 hsm
-HSM
 HTTPS
 Humidistat
 HW
@@ -880,8 +878,8 @@ localhost
 LocalizationConfiguration
 localstatedir
 LockingState
-lookups
 LogEvent
+lookups
 loopback
 LowPower
 LPC
@@ -1085,8 +1083,8 @@ optionMask
 optionOverride
 optionsMask
 optionsOverride
-orgs
 Orchestrator
+orgs
 OSS
 OTA
 OTADownloader
@@ -1185,6 +1183,7 @@ PowerSource
 PowerSourceConfiguration
 pre
 PrebuiltDataModelDirectory
+prepends
 preprocessor
 Presetup
 PressureMeasurement
@@ -1263,7 +1262,6 @@ rebase
 recommand
 recommanded
 Reconnection
-reconnection
 reconnections
 recurse
 refrigeratoralarm
@@ -1337,10 +1335,12 @@ scalability
 scalable
 schema
 schemas
+SCL
 scm
 sco
 scp
 ScriptBinding
+SDA
 SDB
 SDC
 SDHC
@@ -1460,13 +1460,15 @@ svg
 SVR
 SWD
 SWU
+symlink
 symlinks
 sysbuild
 sysconfdir
 SysConfig
 sysctl
 sysdeps
 SYSROOT
+sysroots
 systemctl
 systemd
 systemdsystemunitdir
@@ -1593,6 +1595,7 @@ Unicast
 UniFlash
 UnitLocalization
 unittest
+unlinking
 unpair
 unprovisioned
 unreferenced
@@ -1625,6 +1628,7 @@ UUID
 ux
 valgrind
 validator
+VCC
 vcom
 VCP
 Vectorcall
@@ -1735,8 +1739,8 @@ zclsubscribe
 zclwrite
 ZephyrConfig
 zephyrproject
-zhengyaohan
 Zeroconf
+zhengyaohan
 Zigbee
 zigbeealliance
 zigbeethread

.github/CODEOWNERS

@@ -0,0 +1 @@
+integrations/docker/images/chip-cert-bins/Dockerfile @oxesoft

.github/PULL_REQUEST_TEMPLATE.md

@@ -60,4 +60,5 @@ code readable:
 -   [ ] Try to avoid "squashing" and "force-update" in commit history
 -   [ ] CI time didn't increase
 
-See: [Pull Request Guidelines](https://project-chip.github.io/connectedhomeip-doc/contributing/pull_request_guidelines.html)
+See:
+[Pull Request Guidelines](https://project-chip.github.io/connectedhomeip-doc/contributing/pull_request_guidelines.html)