Control datetime on SwitchBot Meter Pro CO2 Monitor

[elgris]

This series of changes adds some control over datetime settings on the SwitchBot Meter Pro CO2 Monitor and aims to support HomeAssistant (see this request to allow syncing the device's time from HA).

This functionality was reverse-engineered, I don't have any access to the Switchbot documentation.

The change can contribute to #430, as it focuses on datetime exclusively and provides more precise control over that.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

Files with missing lines	Coverage Δ
switchbot/__init__.py	100.00% <100.00%> (ø)
switchbot/devices/meter_pro.py	100.00% <100.00%> (ø)

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[elgris]

Note: this change provides necessary tools for #416.

[zerzhang]

Rename the file Meter to Meterpro to avoid confusion., The current protocol only applies to MeterPro series devices and does not support Meter type devices.

[elgris]

Rename the file Meter to Meterpro to avoid confusion., The current protocol only applies to MeterPro series devices and does not support Meter type devices.

But that would make it inconsistent with the advertisement parsers: switchbot/adv_parser/meter.py handles the Pro series too (see process_wosensorth_c). Is that OK?

[zerzhang]

The advertisements for these devices are the same in the first part, but the device setup instructions are quite different.
You only need to rename the file you have currently modified.

[elgris]

The advertisements for these devices are the same in the first part, but the device setup instructions are quite different. You only need to rename the file you have currently modified.

Ack, thanks for explaining! Restored meter.py and moved the pro-related code to meter_pro.py, also renamed the test file.

[bdraco]

Please see comments above

[elgris]

Hi folks! Is there anything else I could do / fix / adjust?
Thanks!

[bdraco]

Please don't force push after review has began. It means I have to recheck everything again which creates multi-day/week delays as I need to find a larger time window instead of just checking what has changed

[Copilot]

Pull request overview

This pull request adds datetime control functionality to the SwitchBot Meter Pro CO2 Monitor, enabling HomeAssistant and other applications to sync the device's time. The implementation is based on reverse-engineered protocol analysis and provides methods to get/set time offsets, get/set datetime with timezone support, and configure time display format.

Changes:

• Added new SwitchbotMeterProCO2 class with datetime management methods
• Implemented comprehensive test coverage for all datetime operations
• Exported the new class in the package's public API

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File	Description
switchbot/devices/meter_pro.py	New device class implementing datetime control methods including time offset, datetime with timezone, and display format configuration
tests/test_meter_pro.py	Comprehensive test suite covering all datetime methods with success, failure, and edge case scenarios
switchbot/init.py	Added import and export of SwitchbotMeterProCO2 class to package API

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[bdraco]

Thanks @elgris

[elgris]

Thanks @elgris

Woohoo! Glad to help! Sorry for the noise with force pushes, just wanted to keep the history tidy :) Lesson learned, I'll be more careful with future contributions. Pls don't hesitate to ping me in case of bugs with this code.