Multi-Generic Switch in Matter

RE: Multi-Generic Switch in Matter

Maria Gilje — Thu, 29 Feb 2024 09:19:31 GMT

Update from the developers:

The hardcoded Fixed Label is implemented in the All Clusters Example Application.

The Fixed Label cluster is not supported by all ecosystems. Google Home lists the unsupported features here.

By using the chip-tool, you are able to test more features than with most commercial ecosystems. Make sure that the chip-tool version installed is from your NCS version (v2.4.2). See this documentation for installation and use.

Best regards,

Maria

RE: Multi-Generic Switch in Matter

Maria Gilje — Wed, 28 Feb 2024 14:03:34 GMT

Hi Ethan,

Thank you for your continued patience.

I have asked the developers for some assistance on how the LabelList should be filled. When they reply I will share it with you.

Best regards,

Maria

RE: Multi-Generic Switch in Matter

Maria Gilje — Wed, 28 Feb 2024 12:28:42 GMT

The err = b indicates that the current buffer for an outgoing ReportData buffer has run out. It is not serious, because the data will be sent in the next chunk.

The devs are aware of the misleading message classification.

RE: Multi-Generic Switch in Matter

EthanZhao — Wed, 21 Feb 2024 03:19:13 GMT

By the way, there is another issue. I frequently encounter an error during device pairing with HomeApp.

E: 83484 [DMG]Error retrieving data from clusterId: 0x0000_001D, err = b
.....
E: 83021 [DMG]Error retrieving data from clusterId: 0x0000_003E, err = b
......
E: 55885 [DMG]Error retrieving data from clusterId: 0x0000_0028, err = b
..........

I found that error "b" in CHIPError.h means " The attempt to allocate a buffer or object failed due to a lack of memory". Although I have increased CONFIG_CHIP_MALLOC_SYS_HEAP_SIZE, the issue still persists in every pairing attempt.

RE: Multi-Generic Switch in Matter

EthanZhao — Wed, 21 Feb 2024 01:33:47 GMT

Hi Maria,

Thanks for your replay. In this product,I need two generic switch.
I've been used zap tool to add fixed label cluster in each generic switch endpoint and modified the hard-coded part in DeviceInfoProviderImpl.cpp like

bool DeviceInfoProviderImpl::FixedLabelIteratorImpl::Next(FixedLabelType & output)
{
    bool retval = true;

    // A hardcoded list for testing only
    CHIP_ERROR err = CHIP_NO_ERROR;

    const char * labelPtr = nullptr;
    const char * valuePtr = nullptr;

    VerifyOrReturnError(mIndex < 2, false);

    ChipLogProgress(DeviceLayer, "Get the fixed label with index:%u at endpoint:%d", static_cast<unsigned>(mIndex), mEndpoint);


    switch(mEndpoint)
    {
    case 0:
        printf("mIndex case 0\n");
        labelPtr = "room";
        valuePtr = "bedroom 2";
        break;
    case 1:
        printf("mIndex case 1\n");
        labelPtr = "orientation";
        valuePtr = "North";
        break;
    case 2:
        printf("mIndex case 2\n");
        labelPtr = "floor";
        valuePtr = "2";
        break;
    case 3:
        printf("mIndex case 3\n");
        labelPtr = "direction";
        valuePtr = "up";
        break;
    default:
        err = CHIP_ERROR_PERSISTED_STORAGE_VALUE_NOT_FOUND;
        break;
    }

    if (err == CHIP_NO_ERROR)
    {
        VerifyOrReturnError(std::strlen(labelPtr) <= kMaxLabelNameLength, false);
        VerifyOrReturnError(std::strlen(valuePtr) <= kMaxLabelValueLength, false);

        Platform::CopyString(mFixedLabelNameBuf, kMaxLabelNameLength + 1, labelPtr);
        Platform::CopyString(mFixedLabelValueBuf, kMaxLabelValueLength + 1, valuePtr);

        output.label = CharSpan::fromCharString(mFixedLabelNameBuf);
        output.value = CharSpan::fromCharString(mFixedLabelValueBuf);

        mIndex++;

        retval = true;
    }
    else
    {
        retval = false;
    }

    return retval;
}

I utilized mEndpoint to assign distinct labels for different endpoints. However, upon pairing this device with HomeApp, I'm observing that only a single generic label is displayed.

Any suggertion?

Thanks~
Ethan

RE: Multi-Generic Switch in Matter

Maria Gilje — Tue, 20 Feb 2024 15:55:33 GMT

Hello,

I'm starting out with a clarification: FixedLabel is a cluster which has LabelList as an attribute.

The usage is as follows:

Every Generic Switch requires a FixedLabel cluster server. This can be enabled for the Generic Switch application through ZAP tool (Adding clusters guide).
The LabelList for each endpoint needs to be filled by the manufacturer and the contents should be specific to each switch. The format of the LabelList is a struct where its entry/entries has a label and a value.

For code reference for the FixedLabel cluster, please see the source code for the FixedLabel cluster (server) for the implementation. You can find an example for using the LabelList in DeviceInfoProviderImpl.cpp in the provider examples. Note that the implementation has a hard-coded LabelList and is meant for testing only.

In the Matter test suite for certification where is an example for how the TH writes to an attribute in the UserLabel cluster, which also applies to the FixedLabel cluster for a Generic Switch.

Best regards,

Maria

RE: Multi-Generic Switch in Matter

EthanZhao — Thu, 15 Feb 2024 01:37:09 GMT

Hi Maria,

Could you please provide an example that demonstrates how to use the Label cluster and Fixlabel cluster in a multi-generic switch? I would like to reference it for guidance.

Thanks~

RE: Multi-Generic Switch in Matter

Maria Gilje — Mon, 12 Feb 2024 11:30:22 GMT

Thank you for your patience. Yes, the FixedLabel cluster is required for generic switches in NCS v2.4.2

Best regards,.

Maria

RE: Multi-Generic Switch in Matter

Susheel Nuguru — Fri, 09 Feb 2024 09:35:26 GMT

Sorry for delays Ethan, Maria is away and will be back on Monday. She will write to you then. Thanks for your patience so far

RE: Multi-Generic Switch in Matter

EthanZhao — Tue, 06 Feb 2024 02:34:57 GMT

Hi Maria,
Thanks for your replay~ So if I want to implement a multi-generic switch, does that mean I need to enable the Fixed Label cluster in each generic switch endpoint?

Thanks~
Ethan

RE: Multi-Generic Switch in Matter

Maria Gilje — Mon, 05 Feb 2024 12:05:35 GMT

Hello,

You are referring to conflicting versions for NCS and Matter. NCS v2.4.2 uses Matter v1.1 and there were some changes in the Label-/TagList in Matter 1.2.

Matter 1.1 has a requirement for the FixedLabel cluster on a Generic Switch device. The FixedLabel cluster has a LabelList which is the equivalent for the TagList in Matter 1.2. See Chapter 6.6.4 in Matter Device Library v1.1 for more.

For future reference, the Matter versions for each NCS version is listed here.

Best regards,

Maria