Add batteryLevel to matter switch

[nickolas-deboom]

Type of Change

• WWST Certification Request
  • If this is your first time contributing code:
    • I have reviewed the README.md file
    • I have reviewed the CODE_OF_CONDUCT.md file
    • I have signed the CLA
  • I plan on entering a WWST Certification Request or have entered a request through the WWST Certification console at developer.smartthings.com
• Bug fix
• New feature
• Refactor

Checklist

• I have performed a self-review of my code
• I have commented my code in hard-to-understand areas
• I have verified my changes by testing with a device or have communicated a plan for testing
• I am adding new behavior, such as adding a sub-driver, and have added and run new unit tests to cover the new behavior

Description of Change

CHAD-12161

Matter drivers currently assume that BatPercentRemaining is available if the BAT feature is supported, but this attribute is only optionally required if this feature is present. The changes in this PR improve the profile selection logic in matter-switch by reading the AttributeList, checking if BatPercentRemaining or BatChargeLevel is available, and then profiling the device as needed.

Note that these changes were originally in PR 1796 but this PR was split up into 5 separate PRs, one for each affected driver.

Summary of Completed Tests

Tested with a matter button, which supports BatPercentRemaining. Relevant logs:

2025-01-30_16:08:45.116 | I | broker     | <Matter Switch (c8775dfd)> <MatterDevice: dd1a6065-2320-4d46-9651-d249e2045b83 [7AE8C08425F969BF-6AB3AA3F0FB2BDDC-11] (Matter Button)> received lifecycle event: added
2025-01-30_16:08:45.161 | I | broker     | <Matter Switch (c8775dfd)> <MatterDevice: dd1a6065-2320-4d46-9651-d249e2045b83 [7AE8C08425F969BF-6AB3AA3F0FB2BDDC-11] (Matter Button)> sending InteractionRequest: <InteractionRequest || type: READ, info_blocks: [<InteractionInfoBlock || cluster: PowerSource, attribute: AttributeList>]>
2025-01-30_16:08:45.541 | I | broker     | <Matter Switch (c8775dfd)> <MatterDevice: dd1a6065-2320-4d46-9651-d249e2045b83 [7AE8C08425F969BF-6AB3AA3F0FB2BDDC-11] (Matter Button)> received InteractionResponse: <InteractionResponse || type: REPORT_DATA, response_blocks: [<InteractionResponseInfoBlock || status: SUCCESS, <InteractionInfoBlock || endpoint: 0x0B, cluster: PowerSource, attribute: AttributeList, data: Array: [Uint16: \xFF\xF8, Uint16: \xFF\xF9, Uint16: \xFF\xFB, Uint16: \xFF\xFC, Uint8: \x00, Uint8: \x01, Uint8: \x02, Uint8: \x0C, Uint8: \x0E, Uint8: \x0F, Uint8: \x10, Uint8: \x1F, Uint16: \xFF\xFD]>>, <InteractionResponseInfoBlock || status: SUCCESS, <InteractionInfoBlock || cluster: PowerSource, attribute: AttributeList>>]>

The device was profiled to 7-button-battery (the profile it was already joined to).

[github-actions]

Duplicate profile check: Passed - no duplicate profiles detected.

[github-actions]

Test Results

   64 files    409 suites   0s ⏱️
2 021 tests 2 021 ✅ 0 💤 0 ❌
3 500 runs  3 500 ✅ 0 💤 0 ❌

Results for commit 8b4c907.

♻️ This comment has been updated with latest results.

[github-actions]

File	Coverage
All files	94%	✅
/home/runner/work/SmartThingsEdgeDrivers/SmartThingsEdgeDrivers/drivers/SmartThings/matter-switch/src/init.lua	96%	✅
/home/runner/work/SmartThingsEdgeDrivers/SmartThingsEdgeDrivers/drivers/SmartThings/matter-switch/src/eve-energy/init.lua	91%	✅
/home/runner/work/SmartThingsEdgeDrivers/SmartThingsEdgeDrivers/drivers/SmartThings/matter-switch/src/aqara-cube/init.lua	96%	✅
/home/runner/work/SmartThingsEdgeDrivers/SmartThingsEdgeDrivers/drivers/SmartThings/matter-switch/src/embedded-cluster-utils.lua	38%	❌

Minimum allowed coverage is 90%

Generated by 🐒 cobertura-action against 8b4c907

[github-actions]

Channel deleted.

[hcarter-775]

LGTM!

[hcarter-775]

Actually I jumped the gun. Before merging, there is some maybe messy conflict with the recent Aqara climate device PR. This should be handled and discussed if necessary before merging.