blob: 9adbd5d30f2adf66812d365909b8e5821d6e3e62 [file] [log] [blame]
# Copyright (c) 2021 Project CHIP Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# Auto-generated scripts for harness use only, please review before automation. The endpoints and cluster names are currently set to default
name:
3.3.12. [TC-DD-3.12] Commissioning Flow = 1 (User-Intent Flow) - QR Code
[DUT - Commissioner]
PICS:
- MCORE.ROLE.COMMISSIONER
- MCORE.DD.QR_COMMISSIONING
- MCORE.DD.USER_INTENT_COMM_FLOW
config:
nodeId: 0x12344321
cluster: "Basic"
endpoint: 0
tests:
- label: "Note"
verification: |
Chip-tool command used below are an example to verify the DUT as commissioner test cases. For certification test, we expect DUT should have a capability or way to run the equivalent command.
disabled: true
- label: "Preconditions"
verification: |
1 - DUT is on an operational network and has accurate date, time, timezone, regulatory, and fabric information available.
2 - 5.1.3 - QR code is printed on the device or in additional provided materials (ex: manual).
An example onboarding QR code could be "MT:-24J029Q00KA0648G00" (following 5.1.3 "QR Code", Table 34 "Packed Binary Data Structure for Onboarding Payload") which includes:
- 3-bit Version String=000
- 16-bit Vendor ID=0xFFF1 (as defined in section 2.5.2. "Vendor Identifier")
- 16-bit Product ID=0x8001 (as defined in section 2.5.3. "Product Identifier")
- 2-bit Custom Flow=10 (Custom Commissioning Flow = 2)
- 8-bit Discovery Capabilities Bitmask=00000100 (OnNetwork)
- 12-bit Discriminator=0xF00
- 27-bit Passcode=20202021
- 4-bit Padding=0000
- no variable-length TLV Data included (as defined in section 5.1.3.1. "Payload", subsection "TLV Data")
disabled: true
- label:
"User-Intent Commissioning Flow: Use a Commissionee with a QR code
that has the Custom Flow field set to 1 and supports BLE for its
Discovery Capability. Commissionee is NOT in commissioning mode.
Ensure the Version bit string follows the current Matter spec.
documentation."
PICS: MCORE.DD.DISCOVERY_BLE
verification: |
Verify on the TH as commissionee side:
$ ./out/ble/all-clusters-app/chip-all-clusters-app --capabilities 2 --custom-flow 1 --ble-device 1
...
[1657234110.765249][370717:370717] CHIP:SVR: SetupQRCode: [MT:-24J0YXE00KA0648G00]
[1657234110.765314][370717:370717] CHIP:SVR: Copy/paste the below URL in a browser to see the QR Code:
[1657234110.765364][370717:370717] CHIP:SVR: https://dhrishi.github.io/connectedhomeip/qrcode.html?data=MT%3A-24J0YXE00KA0648G00
disabled: true
- label: "Scan the QR code from the previous step using the DUT."
PICS: MCORE.DD.SCAN_QR_CODE
verification: |
1. Verify the QR code is scanned by DUT
Note: chip-tool does not support physically scanning QR codes
disabled: true
- label: "DUT parses QR code."
PICS: MCORE.DD.DISCOVERY_BLE
verification: |
1. Parse the payload of the TH commissionee
Verify on the DUT Commissioner side:
$ ./chip-tool payload parse-setup-payload MT:-24J0YXE00KA0648G00
2. Verify that TH logs do not show the commissionee being commissioned by the DUT.
disabled: true
- label:
"User should follow any TH-specific steps for putting the TH
Commissionee device into commissioning mode and to complete the
commissioning process using BLE."
PICS: MCORE.DD.DISCOVERY_BLE
verification: |
Verify on the TH Commissionee side:
[1651101988.943015][23212:23212] CHIP:SVR: Commissioning completed successfully
[1651101988.943058][23212:23212] CHIP:DIS: Updating services using commissioning mode 0
Verify on the DUT Commissioner side:
./chip-tool pairing code 1 MT:-24J0YXE00KA0648G00
[1657234147237] [31454:16822562] CHIP: [CTL] Successfully finished commissioning step "SendComplete"
[1657234147237] [31454:16822562] CHIP: [CTL] Commissioning stage next step: "SendComplete" -> "Cleanup"
[1657234147237] [31454:16822562] CHIP: [CTL] Performing next commissioning step "Cleanup"
[1657234147237] [31454:16822562] CHIP: [CTL] Successfully finished commissioning step "Cleanup"
[1657234147237] [31454:16822562] CHIP: [TOO] Device commissioning completed with success
disabled: true
- label:
"User-Intent Commissioning Flow: Use a Commissionee with a QR code
that has the Custom Flow field set to 1 and supports IP Network for
its Discovery Capability. Commissionee is NOT in commissioning mode.
Ensure the Version bit string follows the current Matter spec.
documentation."
PICS: MCORE.DD.DISCOVERY_IP
verification: |
Verify on the TH Commissionee side:
$ ./out/all-clusters-app/chip-all-clusters-app --custom-flow 1 --capabilities 4
[1660353382.200125][249074:249074] CHIP:SVR: SetupQRCode: [MT:-24J029Q00KA0648G00]
[1660353382.200152][249074:249074] CHIP:SVR: Copy/paste the below URL in a browser to see the QR Code:
[1660353382.200173][249074:249074] CHIP:SVR: https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3A-24J029Q00KA0648G00
disabled: true
- label: "Scan the QR code from the previous step using the DUT."
PICS: MCORE.DD.SCAN_QR_CODE
verification: |
1. Verify the QR code is scanned by DUT
Note: chip-tool does not support physically scanning QR codes
disabled: true
- label: "DUT parses QR code."
PICS: MCORE.DD.DISCOVERY_IP
verification: |
1. Parse the payload of the TH commissionee
Verify on the DUT Commissioner side:
$ ./chip-tool payload parse-setup-payload MT:-24J029Q00KA0648G00
2. Verify that TH logs do not show the commissionee being commissioned by the DUT.
disabled: true
- label:
"User should follow any TH-specific steps for putting the TH
Commissionee device into commissioning mode and to complete the
commissioning process using IP Network."
PICS: MCORE.DD.DISCOVERY_IP
verification: |
Verify on the TH Commissionee side:
[1657234324.992098][370755:370755] CHIP:SVR: Commissioning completed successfully
[1657234324.992146][370755:370755] CHIP:DIS: Updating services using commissioning mode 0
Verify on the DUT Commissioner side:
./chip-tool pairing code 1 MT:-24J029Q00KA0648G00
[1657234324847] [31475:16824564] CHIP: [CTL] Successfully finished commissioning step "SendComplete"
[1657234324847] [31475:16824564] CHIP: [CTL] Commissioning stage next step: "SendComplete" -> "Cleanup"
[1657234324847] [31475:16824564] CHIP: [CTL] Performing next commissioning step "Cleanup"
[1657234324847] [31475:16824564] CHIP: [CTL] Successfully finished commissioning step "Cleanup"
[1657234324847] [31475:16824564] CHIP: [TOO] Device commissioning completed with success
disabled: true
- label:
"User-Intent Commissioning Flow: Use a Commissionee with a QR code
that has the Custom Flow field set to 1 and supports SoftAP for its
Discovery Capability. Commissionee is NOT in commissioning mode.
Ensure the Version bit string follows the current Matter spec.
documentation."
PICS: MCORE.DD.DISCOVERY_SOFTAP
verification: |
Out of Scope for V1.0
SoftAP commissioning not currently supported
disabled: true
- label: "Scan the QR code from the previous step using the DUT."
PICS: MCORE.DD.SCAN_QR_CODE
verification: |
Out of Scope for V1.0
SoftAP commissioning not currently supported
disabled: true
- label: "DUT parses QR code."
PICS: MCORE.DD.DISCOVERY_SOFTAP
verification: |
Out of Scope for V1.0
SoftAP commissioning not currently supported
disabled: true
- label:
"User should follow any TH-specific steps for putting the TH
Commissionee device into commissioning mode and to complete the
commissioning process using SoftAP."
PICS: MCORE.DD.DISCOVERY_SOFTAP
verification: |
Out of Scope for V1.0
SoftAP commissioning not currently supported
disabled: true