Added settings for Meter Pro Co2 by ahrmn · Pull Request #430 · sblibs/pySwitchbot

ahrmn · 2025-12-23T16:04:50Z

I reverse-engineered the settings of the Meter Pro (CO2) and implemented them here.
I have no means of testing if this work for the other Meter models.
An example script to fully configure a device using this would be for example

import asyncio

from switchbot.devices.meter import SwitchbotMeter
from switchbot.discovery import GetSwitchbotDevices
from switchbot.const import SwitchbotModel

BLE_MAC='XX:XX:XX:XX:XX:XX'
METER_MODEL=SwitchbotModel.METER_PRO_C

async def main():
    switchbotDevices = await GetSwitchbotDevices().discover()
    meter_advertisement = switchbotDevices[BLE_MAC]
    print(meter_advertisement.data)
    meter = SwitchbotMeter(device=meter_advertisement.device, model=METER_MODEL)
    await meter.show_battery_level(False)
    await meter.set_co2_thresholds(900, 1200)
    await meter.set_comfortlevel(19, 22, 40, 70)
    await meter.set_temperature_update_interval(10)
    await meter.set_co2_update_interval(10)
    await meter.set_button_function(False, False)
    await meter.set_alert_sound(False, 2)
    await meter.set_alert_co2(True, 400, 1200, False)
    
asyncio.run(main())

Additionally one can trigger a new measurement regardless of the frequency using
await meter.force_new_CO2_measurement() and calibrate the sensor (at fresh air!) using
await meter.calibrate_co2_sensor().

ahrmn · 2025-12-23T16:06:53Z

This may solve #416.
@jacekowski Can you test if this synchronises time for the Meter Pro (without CO2 sensor)?

zerzhang · 2026-01-07T03:22:08Z

Additional unit tests are needed. It is recommended to create a base class MeterPro and move the CO2 settings to a separate class MeterProCO2.

ahrmn · 2026-01-25T22:27:51Z

@elgris @zerzhang I integrated my code into the new structure, removed my own time-implementation and started implementing unit-tests (more are coming when i have more time).

It is recommended to create a base class MeterPro and move the CO2 settings to a separate class MeterProCO2.

I have no way to verify which methods would actually work on a MeterPro, so i am not sure abbout that.

elgris · 2026-01-26T20:09:51Z

+
+COMMAND_TEMPERATURE_UPDATE_INTERVAL = f"{SETTINGS_HEADER}070105"
+COMMAND_CO2_UPDATE_INTERVAL = f"{SETTINGS_HEADER}0b06"
+COMMAND_FORCE_NEW_CO2_Measurement = f"{SETTINGS_HEADER}0b04"


(style) it should be all uppercase COMMAND_FORCE_NEW_CO2_MEASUREMENT.

elgris · 2026-01-26T20:17:44Z

+            + absolute_humidity_low_bytes
+        )
+
+    async def set_alert_co2(self, on: bool, co2_low: int, co2_high: max, reverse: bool):


Typo: co2_high: int,

elgris · 2026-01-26T20:21:10Z

+
+        mode = 0x00 if not on else (0x04 if reverse else 0x03)
+        await self._send_command(
+            COMMAND_ALERT_CO2 + f"{mode:02x}" + f"{co2_high:04x}" + f"{co2_low:04x}"


Do we need to send these limits if on is False? I haven't tried this with the device, but I'd assume that it expects all zeroes. If so, then we can probably make set default values for co2_high and co2_low args to 0 and drop their validation when on is False.

No, this would be a reasonable design, but is not what the original app does.
The test I pushed for this method contains only payloads from the original App.
When a mode gets turned off, all values remain set as they were before. And all of them get transmitted.
I tried to stick as close to this as possible. I did not test how the device would react to your proposal.

elgris · 2026-01-26T20:24:39Z

+        Sets the interval in which temperature and humidity are measured in battery powered mode.
+        Original App assumes minutes in {5, 10, 30}
+        """
+        seconds = minutes * 60


Up to @zerzhang and @bdraco, but I'd just pass seconds as an arg and let the caller do the minutes->seconds conversion. The same for other _update_interval methods.

Agreed, it is recommended to use seconds as the parameter.

elgris · 2026-01-26T20:25:16Z

+
+    async def set_button_function(self, change_unit: bool, change_data_source: bool):
+        """
+        Sets the function of te top button:


Typo: te -> the

elgris · 2026-01-26T20:27:56Z

I'd also suggest checking ruff output, it also found some problems. You can also run it locally to verify that everything looks good.

ahrmn · 2026-01-27T22:11:31Z

I added more tests and fixed the typos you found.
After the Auto-Fixes I find some of the test parameters rather hard to read....

ahrmn · 2026-02-12T09:34:41Z

@zerzhang Could you provide me with some guidance, what actions are required to move this forward?
I see that the CI is red, but currently dont see a nice way to solve its problems.

elgris · 2026-02-18T21:32:42Z

@ahrmn : maybe remove set_alert_temperature_humidity from this PR for now? We can approach it separately and iteratively. Also smaller PRs are easier to review IMO. If you ask me, I'd actually split set_alert_temperature_humidity into smaller focused functions, like set_alert_temperature, set_alert_humidity and so on.

codecov · 2026-03-19T19:36:51Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

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

🚀 New features to boost your workflow:

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

ahrmn · 2026-04-19T09:37:19Z

@zerzhang May I ask what is blocking this?
I removed the Humidity- and Temperature alerts that caused problems with the CI and added more test-coverage.

zerzhang · 2026-04-21T10:30:14Z

@zerzhang May I ask what is blocking this? I removed the Humidity- and Temperature alerts that caused problems with the CI and added more test-coverage.
Meter Pro .xlsx

@ahrmn Here is the latest communication protocol file; you can make adjustments based on it.

zerzhang · 2026-01-06T09:57:56Z

+    async def show_battery_level(self, show_battery: bool):
+        """Show or hide battery level on the display."""
+        show_battery_byte = "01" if show_battery else "00"
+        await super()._send_command(COMMAND_SHOW_BATTERY_LEVEL + show_battery_byte)


00 indicates that the battery icon will be displayed when the battery level is <= 20%, 01 indicates the default display.

zerzhang · 2026-01-07T02:44:55Z

+        await super()._send_command(
+            COMMAND_COMFORTLEVEL
+            + hot_byte
+            + f"{wet:02x}"


bit7 is reserved, bit6-0 represent the humidity.

zerzhang · 2026-01-07T02:56:36Z

+        point_five += 0x05
+    if int(hot * 10) % 10 == 5:
+        point_five += 0x50
+    return f"{point_five:02x}"


def get_temp_decimal_byte(cold: float, hot: float) -> int: cold_dec = int(round(cold * 10)) % 10 hot_dec = int(round(hot * 10)) % 10 if not (0 <= cold_dec <= 9 and 0 <= hot_dec <= 9): raise ValueError("Decimal part out of range") return (hot_dec << 4) | cold_dec

"Temperature ValueH decimal
bit [7-4]: Temperature ValueH decimal, upper limit of temperature alarm, decimal part
Temperature ValueL decimal
bit [3-0]: Temperature ValueL decimal, lower limit of temperature alarm, decimal part
0000 –1001: 0~9"

This section itself supports setting decimal numbers from 0 to 9.

zerzhang · 2026-01-07T02:58:17Z

+            + f"{wet:02x}"
+            + point_five
+            + cold_byte
+            + f"{dry:02x}"


same as wet byte

zerzhang · 2026-01-07T03:19:43Z

+        await super()._send_command(
+            COMMAND_ALERT_SOUND + f"{volume:02x}" + sound_on_byte
+        )
+


Alarm Volume
0xFF -hold
0x01 Off
0x02 Low
0x03 Medium (Default)
0x04 High

Audible and visual alarm mode
0x00 - disable
0x01 - Flashing only
0x02 - Sound + flashing

zerzhang · 2026-04-21T10:43:09Z

+        seconds = minutes * 60
+        await self._send_command(COMMAND_TEMPERATURE_UPDATE_INTERVAL + f"{seconds:04x}")
+
+    async def set_co2_update_interval(self, minutes: int):


Missing return type

zerzhang · 2026-04-21T10:43:16Z

+        seconds = minutes * 60
+        await self._send_command(COMMAND_CO2_UPDATE_INTERVAL + f"{seconds:04x}")
+
+    async def set_button_function(self, change_unit: bool, change_data_source: bool):


Missing return type

zerzhang · 2026-04-21T10:43:35Z

+            COMMAND_BUTTON_FUNCTION + change_unit_byte + change_data_source_byte
+        )
+
+    async def force_new_co2_measurement(self):


Missing return type

zerzhang · 2026-04-21T10:43:42Z

+        """Requests a new CO2 measurement, regardless of update interval"""
+        await self._send_command(COMMAND_FORCE_NEW_CO2_MEASUREMENT)
+
+    async def calibrate_co2_sensor(self):


Missing return type

zerzhang · 2026-04-21T10:43:50Z

+        """
+        await self._send_command(COMMAND_CALIBRATE_CO2_SENSOR)
+
+    async def set_alert_sound(self, sound_on: bool, volume: int):


Missing return type

bdraco requested a review from zerzhang December 24, 2025 00:26

elgris mentioned this pull request Dec 31, 2025

Control datetime on SwitchBot Meter Pro CO2 Monitor #433

Merged

elgris reviewed Dec 31, 2025

View reviewed changes

Comment thread switchbot/devices/meter.py Outdated

ahrmn closed this Jan 25, 2026

ahrmn force-pushed the master branch from 862e6e8 to dbbe591 Compare January 25, 2026 21:10

Added settings for Meter Pro Co2

6d71c5b

ahrmn reopened this Jan 25, 2026

chore(pre-commit.ci): auto fixes

8c3107f

elgris reviewed Jan 26, 2026

View reviewed changes

Comment thread switchbot/devices/meter_pro.py

elgris reviewed Jan 26, 2026

View reviewed changes

ahrmn and others added 3 commits January 27, 2026 23:02

Feedback and Tests

4b307e7

chore(pre-commit.ci): auto fixes

8b987ba

Merge branch 'master' into master

2ddebff

Removed Humidity and Temperature Alert

8803eb4

ahrmn and others added 4 commits March 19, 2026 20:51

Covererage

6800eda

Match Errormessage

8c3362a

chore(pre-commit.ci): auto fixes

d53823d

renamed tests

05dfc77

pre-commit-ci Bot and others added 3 commits March 19, 2026 19:58

chore(pre-commit.ci): auto fixes

d9a585e

escape

d2620f6

chore(pre-commit.ci): auto fixes

8091cd7

zerzhang requested changes Apr 21, 2026

View reviewed changes

bdraco mentioned this pull request Apr 23, 2026

ci: auto-close PRs opened from a fork's default branch #477

Merged

5 tasks

Merge branch 'master' into master

6dd6680

Conversation

ahrmn commented Dec 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ahrmn commented Dec 23, 2025

Uh oh!

Uh oh!

zerzhang commented Jan 7, 2026

Uh oh!

ahrmn commented Jan 25, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

elgris Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

elgris commented Jan 26, 2026

Uh oh!

ahrmn commented Jan 27, 2026

Uh oh!

ahrmn commented Feb 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

elgris commented Feb 18, 2026

Uh oh!

codecov Bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

ahrmn commented Apr 19, 2026

Uh oh!

zerzhang commented Apr 21, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ahrmn commented Dec 23, 2025 •

edited

Loading

elgris Jan 26, 2026 •

edited

Loading

ahrmn commented Feb 12, 2026 •

edited

Loading

codecov Bot commented Mar 19, 2026 •

edited

Loading