blob: 2655237fddaf0bf248c9b5a3255251b66cd7bfe6 [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.
# !!!!!!!!!! TEST INFORMATION !!!!!!!!!!!!!!!!!!
# This test file tests Group Multicast Messaging.
# For this test to work, A Group Write/Command and a unicast read need to occur to be able to confirm that the group Communication works. Every test comes in a pair
# Only Works on Linux machines
name: Basic Group Messaging Tests
config:
nodeId: 0x12344321
cluster: "Basic Information"
endpoint: 0
# Test that a group id can be a variable.
groupIdVariable:
type: int16u
defaultValue: 0x0101
nodeId2:
type: node_id
defaultValue: 0x43211234
discriminator:
type: int16u
defaultValue: 3840
payload:
type: char_string
defaultValue: "MT:-24J0AFN00KA0648G00" # This value needs to be generated automatically
tests:
- label: "Wait for the commissioned device to be retrieved"
cluster: "DelayCommands"
command: "WaitForCommissionee"
arguments:
values:
- name: "nodeId"
value: nodeId
- label: "KeySet Write 1"
cluster: "Group Key Management"
command: "KeySetWrite"
arguments:
values:
- name: "GroupKeySet"
value: {
GroupKeySetID: 0x01a1,
# TODO Revert this once MCSP is implemented
# GroupKeySecurityPolicy: 1,
GroupKeySecurityPolicy: 0, # 0 => TrustFirst
EpochKey0: "\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab\xac\xad\xae\xaf",
EpochStartTime0: 1110000,
EpochKey1: "\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xbb\xbc\xbd\xbe\xbf",
EpochStartTime1: 1110001,
EpochKey2: "\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xcc\xcd\xce\xcf",
EpochStartTime2: 1110002,
}
- label: "KeySet Write 2"
cluster: "Group Key Management"
command: "KeySetWrite"
arguments:
values:
- name: "GroupKeySet"
value: {
GroupKeySetID: 0x01a2,
GroupKeySecurityPolicy: 0, # TrustFirst
EpochKey0: "\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xdb\xdc\xdd\xde\xdf",
EpochStartTime0: 2220000,
EpochKey1: "\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xeb\xec\xed\xee\xef",
EpochStartTime1: 2220001,
EpochKey2: "\xf0\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff",
EpochStartTime2: 2220002,
}
- label: "Write Group Keys"
cluster: "Group Key Management"
command: "writeAttribute"
attribute: "GroupKeyMap"
arguments:
value:
[
{ FabricIndex: 0, GroupId: 0x0101, GroupKeySetID: 0x01a1 },
{ FabricIndex: 0, GroupId: 0x0102, GroupKeySetID: 0x01a2 },
]
- label: "Add Group 1 (endpoint 1)"
cluster: "Groups"
command: "AddGroup"
endpoint: 1
arguments:
values:
- name: "GroupID"
value: 0x0101
- name: "GroupName"
value: "Group #1"
response:
values:
- name: "Status"
value: 0
- name: "GroupID"
value: 0x0101
- label: "Add Group 1 (endpoint 2)"
cluster: "Groups"
command: "AddGroup"
endpoint: 2
arguments:
values:
- name: "GroupID"
value: 0x0101
- name: "GroupName"
value: "Group #1"
response:
values:
- name: "Status"
value: 0
- name: "GroupID"
value: 0x0101
- label: "Add Group 2 (endpoint 0)"
cluster: "Groups"
command: "AddGroup"
endpoint: 0
arguments:
values:
- name: "GroupID"
value: 0x0102
- name: "GroupName"
value: "Group #2"
response:
values:
- name: "Status"
value: 0
- name: "GroupID"
value: 0x0102
- label: "Install ACLs"
cluster: "Access Control"
command: "writeAttribute"
attribute: "ACL"
arguments:
value: [
# Any CASE can administer
{
FabricIndex: 0,
Privilege: 5, # administer
AuthMode: 2, # case
Subjects: null,
Targets: null,
},
# Any group can manage
{
FabricIndex: 0,
Privilege: 4, # manage
AuthMode: 3, # group
Subjects: null,
Targets: null,
},
]
# Test Pair 1 : Check initial value (ensure it's not the test value)
- label: "Read initial Attribute value"
command: "readAttribute"
attribute: "NodeLabel"
response:
value: ""
# Test Pair 2 : Sends a Group Write Attribute
- label: "Group Write Attribute"
command: "writeAttribute"
attribute: "NodeLabel"
groupId: 0x0102
arguments:
value: "xyzzy"
# Give the group write time to actually happen; unicast delivery can outrace
# multicast if the unicast packet is sent immediately after the multicast one.
- label: "Wait for write 1"
cluster: "DelayCommands"
command: "WaitForMs"
arguments:
values:
- name: "ms"
value: 1000
# Test Pair 2 : Validates previous group write attribute with a unicast to read
- label: "Read back Attribute"
command: "readAttribute"
attribute: "NodeLabel"
response:
value: "xyzzy"
# Test Pair 3 : Sends a Group Write Attribute
- label: "Restore initial Attribute value"
command: "writeAttribute"
attribute: "NodeLabel"
groupId: 0x0102
arguments:
value: ""
# Give the group write time to actually happen; unicast delivery can outrace
# multicast if the unicast packet is sent immediately after the multicast one.
- label: "Wait for write 2"
cluster: "DelayCommands"
command: "WaitForMs"
arguments:
values:
- name: "ms"
value: 100
# Test Pair 3 : Validates previous group write attribute with a unicast to read
- label: "Read back Attribute"
command: "readAttribute"
attribute: "NodeLabel"
response:
value: ""
# Test Pair 4 : Sends a Group command
- label: "Check on/off attribute value is false for endpoint 1"
cluster: "On/Off"
command: "readAttribute"
attribute: "OnOff"
endpoint: 1
response:
value: 0
- label: "Check on/off attribute value is false for endpoint 2"
cluster: "On/Off"
command: "readAttribute"
attribute: "OnOff"
endpoint: 2
response:
value: 0
- label: "Turn On the light to see attribute change"
cluster: "On/Off"
command: "On"
groupId: groupIdVariable # 0x0101
# Give the group invoke time to actually happen; unicast delivery can outrace
# multicast if the unicast packet is sent immediately after the multicast one.
- label: "Wait for command 3"
cluster: "DelayCommands"
command: "WaitForMs"
arguments:
values:
- name: "ms"
value: 100
# Test Pair 4 : Validates previous group command with a unicast to read
- label:
"Check on/off attribute value is true after on command for endpoint 1"
cluster: "On/Off"
command: "readAttribute"
attribute: "OnOff"
endpoint: 1
response:
value: 1
- label:
"Check on/off attribute value is true after on command for endpoint 2"
cluster: "On/Off"
command: "readAttribute"
attribute: "OnOff"
endpoint: 2
response:
value: 1
- label: "Turn off the light to get ready for the next test for endpoint 1"
cluster: "On/Off"
command: "Off"
endpoint: 1
- label: "Turn off the light to get ready for the next test for endpoint 2"
cluster: "On/Off"
command: "Off"
endpoint: 2
- label: "Cleanup for next test remove Group 1 (endpoint 2)"
cluster: "Groups"
command: "RemoveGroup"
endpoint: 2
arguments:
values:
- name: "GroupID"
value: 0x0101
response:
values:
- name: "Status"
value: 0
- name: "GroupID"
value: 0x0101
- label: "Cleanup ACLs"
cluster: "Access Control"
command: "writeAttribute"
attribute: "ACL"
arguments:
value: [
# Any CASE can administer
{
FabricIndex: 0,
Privilege: 5, # administer
AuthMode: 2, # case
Subjects: null,
Targets: null,
},
]
- label: "Open Commissioning Window from alpha"
cluster: "Administrator Commissioning"
command: "OpenBasicCommissioningWindow"
timedInteractionTimeoutMs: 10000
arguments:
values:
- name: "CommissioningTimeout"
value: 180
# We want to repeat all that from the "gamma" fabric, where our fabric
# index is 3 but the device's will be 2, so we have different fabric
# indices for the same fabric id.
- label: "Commission from gamma"
identity: "gamma"
cluster: "CommissionerCommands"
command: "PairWithCode"
arguments:
values:
- name: "nodeId"
value: nodeId2
- name: "payload"
value: payload
- label: "Wait for the commissioned device to be retrieved for gamma"
identity: "gamma"
cluster: "DelayCommands"
command: "WaitForCommissionee"
arguments:
values:
- name: "nodeId"
value: nodeId2
- label: "KeySet Write 1 for gamma"
identity: "gamma"
cluster: "Group Key Management"
command: "KeySetWrite"
arguments:
values:
- name: "GroupKeySet"
value: {
GroupKeySetID: 0x01a1,
# TODO Revert this once MCSP is implemented
# GroupKeySecurityPolicy: 1,
GroupKeySecurityPolicy: 0, # 0 => TrustFirst
EpochKey0: "\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab\xac\xad\xae\xaf",
EpochStartTime0: 1110000,
EpochKey1: "\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xbb\xbc\xbd\xbe\xbf",
EpochStartTime1: 1110001,
EpochKey2: "\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xcc\xcd\xce\xcf",
EpochStartTime2: 1110002,
}
- label: "KeySet Write 2 for gamma"
identity: "gamma"
cluster: "Group Key Management"
command: "KeySetWrite"
arguments:
values:
- name: "GroupKeySet"
value: {
GroupKeySetID: 0x01a2,
GroupKeySecurityPolicy: 0, # TrustFirst
EpochKey0: "\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xdb\xdc\xdd\xde\xdf",
EpochStartTime0: 2220000,
EpochKey1: "\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xeb\xec\xed\xee\xef",
EpochStartTime1: 2220001,
EpochKey2: "\xf0\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff",
EpochStartTime2: 2220002,
}
- label: "Write Group Keys for gamma"
identity: "gamma"
cluster: "Group Key Management"
command: "writeAttribute"
attribute: "GroupKeyMap"
arguments:
value:
[
{ FabricIndex: 0, GroupId: 0x0101, GroupKeySetID: 0x01a1 },
{ FabricIndex: 0, GroupId: 0x0102, GroupKeySetID: 0x01a2 },
]
- label: "Add Group 1 (endpoint 1) for gamma"
identity: "gamma"
cluster: "Groups"
command: "AddGroup"
endpoint: 1
arguments:
values:
- name: "GroupID"
value: 0x0101
- name: "GroupName"
value: "Group #1"
response:
values:
- name: "Status"
value: 0
- name: "GroupID"
value: 0x0101
- label: "Add Group 2 (endpoint 0) for gamma"
identity: "gamma"
cluster: "Groups"
command: "AddGroup"
endpoint: 0
arguments:
values:
- name: "GroupID"
value: 0x0102
- name: "GroupName"
value: "Group #2"
response:
values:
- name: "Status"
value: 0
- name: "GroupID"
value: 0x0102
- label: "Install ACLs for gamma"
identity: "gamma"
cluster: "Access Control"
command: "writeAttribute"
attribute: "ACL"
arguments:
value: [
# Any CASE can administer
{
FabricIndex: 0,
Privilege: 5, # administer
AuthMode: 2, # case
Subjects: null,
Targets: null,
},
# Any group can manage
{
FabricIndex: 0,
Privilege: 4, # manage
AuthMode: 3, # group
Subjects: null,
Targets: null,
},
]
# Test Pair 1 : Check initial value (ensure it's not the test value)
- label: "Read initial Attribute value for gamma"
identity: "gamma"
command: "readAttribute"
attribute: "NodeLabel"
response:
value: ""
# Test Pair 2 : Sends a Group Write Attribute
- label: "Group Write Attribute for gamma"
identity: "gamma"
command: "writeAttribute"
attribute: "NodeLabel"
groupId: 0x0102
arguments:
value: "xyzzy"
# Give the group write time to actually happen; unicast delivery can outrace
# multicast if the unicast packet is sent immediately after the multicast one.
- label: "Wait for write 1 for gamma"
identity: "gamma"
cluster: "DelayCommands"
command: "WaitForMs"
arguments:
values:
- name: "ms"
value: 100
# Test Pair 2 : Validates previous group write attribute with a unicast to read
- label: "Read back Attribute for gamma"
identity: "gamma"
command: "readAttribute"
attribute: "NodeLabel"
response:
value: "xyzzy"
# Test Pair 3 : Sends a Group Write Attribute
- label: "Restore initial Attribute value for gamma"
identity: "gamma"
command: "writeAttribute"
attribute: "NodeLabel"
groupId: 0x0102
arguments:
value: ""
# Give the group write time to actually happen; unicast delivery can outrace
# multicast if the unicast packet is sent immediately after the multicast one.
- label: "Wait for write 2 for gamma"
identity: "gamma"
cluster: "DelayCommands"
command: "WaitForMs"
arguments:
values:
- name: "ms"
value: 100
# Test Pair 3 : Validates previous group write attribute with a unicast to read
- label: "Read back Attribute for gamma"
identity: "gamma"
command: "readAttribute"
attribute: "NodeLabel"
response:
value: ""
# Test Pair 4 : Sends a Group command
- label: "Check on/off attribute value is false for endpoint 1 for gamma"
cluster: "On/Off"
command: "readAttribute"
attribute: "OnOff"
endpoint: 1
response:
value: 0
- label: "Turn On the light to see attribute change for gamma"
identity: "gamma"
cluster: "On/Off"
command: "On"
groupId: 0x0101
# Give the group invoke time to actually happen; unicast delivery can outrace
# multicast if the unicast packet is sent immediately after the multicast one.
- label: "Wait for command 3 for gamma"
identity: "gamma"
cluster: "DelayCommands"
command: "WaitForMs"
arguments:
values:
- name: "ms"
value: 100
# Test Pair 4 : Validates previous group command with a unicast to read
- label:
"Check on/off attribute value is true after on command for endpoint 1
for gamma"
cluster: "On/Off"
command: "readAttribute"
attribute: "OnOff"
endpoint: 1
response:
value: 1
- label: "Cleanup ACLs for gamma"
identity: "gamma"
cluster: "Access Control"
command: "writeAttribute"
attribute: "ACL"
arguments:
value: [
# Any CASE can administer
{
FabricIndex: 0,
Privilege: 5, # administer
AuthMode: 2, # case
Subjects: null,
Targets: null,
},
]