meross-iot 0.3.1.5

Meross物联网库

一个基于python的纯库，提供api来控制互联网上的meross iot设备。

要查看当前支持的设备，请查看当前支持的设备部分。 但是，某些设备可能会按预期工作，即使它们未在支持的设备中列出。 在这种情况下，您将被邀请打开问题并报告设备的工作/非工作状态。 这将帮助我们跟踪新设备和库的当前支持状态。

此库仍在工作中，请谨慎使用。

安装

由于图书馆很受欢迎，我决定把它公开列在pipy索引上。 因此，安装只需键入以下命令即可：

pip install meross_iot==0.3.1.3 --upgrade

用法

下面的脚本演示如何使用此库。

frommeross_iot.managerimportMerossManagerfrommeross_iot.meross_eventimportMerossEventTypefrommeross_iot.cloud.devices.light_bulbsimportGenericBulbfrommeross_iot.cloud.devices.power_plugsimportGenericPlugfrommeross_iot.cloud.devices.door_openersimportGenericGarageDoorOpenerimporttimeimportosEMAIL=os.environ.get('MEROSS_EMAIL')or"YOUR_MEROSS_CLOUD_EMAIL"PASSWORD=os.environ.get('MEROSS_PASSWORD')or"YOUR_MEROSS_CLOUD_PASSWORD"defevent_handler(eventobj):ifeventobj.event_type==MerossEventType.DEVICE_ONLINE_STATUS:print("Device online status changed: %s went %s"%(eventobj.device.name,eventobj.status))passelifeventobj.event_type==MerossEventType.DEVICE_SWITCH_STATUS:print("Switch state changed: Device %s (channel %d) went %s"%(eventobj.device.name,eventobj.channel_id,eventobj.switch_state))else:print("Unknown event!")if__name__=='__main__':# Initiates the Meross Cloud Manager. This is in charge of handling the communication with the remote endpointmanager=MerossManager(meross_email=EMAIL,meross_password=PASSWORD)# Register event handlers for the manager...manager.register_event_handler(event_handler)# Starts the managermanager.start()# You can retrieve the device you are looking for in various ways:# By kindbulbs=manager.get_devices_by_kind(GenericBulb)plugs=manager.get_devices_by_kind(GenericPlug)door_openers=manager.get_devices_by_kind(GenericGarageDoorOpener)all_devices=manager.get_supported_devices()# Print some basic specs about the discovered devicesprint("All the bulbs I found:")forbinbulbs:print(b)print("All the plugs I found:")forpinplugs:print(p)print("All the garage openers I found:")forgindoor_openers:print(g)print("All the supported devices I found:")fordinall_devices:print(d)# You can also retrieve devices by the UUID/name# a_device = manager.get_device_by_name("My Plug")# a_device = manager.get_device_by_uuid("My Plug")# Or you can retrieve all the device by the HW type# all_mss310 = manager.get_devices_by_type("mss310")# ------------------------------# Let's play the garage openers.# ------------------------------forgindoor_openers:ifnotg.online:print("The garage controller %s seems to be offline. Cannot play with that..."%g.name)continueprint("Opening door %s..."%g.name)g.open_door()print("Closing door %s..."%g.name)g.close_door()# ---------------------# Let's play with bulbs# ---------------------forbinbulbs:# type: GenericBulbifnotb.online:print("The bulb %s seems to be offline. Cannot play with that..."%b.name)continueprint("Let's play with bulb %s"%b.name)ifnotb.supports_light_control():print("Too bad bulb %s does not support light control %s"%b.name)else:# Let's make it red!b.set_light_color(rgb=(255,0,0))b.turn_on()time.sleep(1)b.turn_off()# ---------------------------# Let's play with smart plugs# ---------------------------forpinplugs:# type: GenericPlugifnotp.online:print("The plug %s seems to be offline. Cannot play with that..."%p.name)continueprint("Let's play with smart plug %s"%p.name)channels=len(p.get_channels())print("The plug %s supports %d channels."%(p.name,channels))foriinrange(0,channels):print("Turning on channel %d of %s"%(i,p.name))p.turn_on_channel(i)time.sleep(1)print("Turning off channel %d of %s"%(i,p.name))p.turn_off_channel(i)usb_channel=p.get_usb_channel_index()ifusb_channelisnotNone:print("Awesome! This device also supports USB power.")p.enable_usb()time.sleep(1)p.disable_usb()ifp.supports_electricity_reading():print("Awesome! This device also supports power consumption reading.")print("Current consumption is: %s"%str(p.get_electricity()))# At this point, we are all done playing with the library, so we gracefully disconnect and clean resources.print("We are done playing. Cleaning resources...")manager.stop()print("Bye bye!")

当前支持的设备

从v0.2.0.0开始，这个库应该支持市场上的大多数meross设备。 测试设备列表如下：

• MSL120
• MSS110
• MSS210
• MSS310
• MSS310H
• MSS425E
• MSS530H
• msg100

我要感谢所有为图书馆早期发展做出贡献的人， 是谁激励我继续开发并使这个库支持更多设备：

感谢Danonekid、Virtualdj、Sobestadt、Sobestadt、Sobestadt、Sobestadt、Sobestadt、Sobestadt。ping本地主机

协议详细信息

这个库是通过反向工程实现的，即插头和meross网络之间的网络通信。 任何人都可以同样，只需在中间安装一个man-in-middle代理，并通过嗅探器路由android模拟器的ssl流量即可。

如果您想了解Meross协议的工作原理，请查看wiki。请注意：此操作仍在进行中，因此wiki的某些页面可能仍为空白/正在构建中。

家庭助理集成

是的，发生了。我一开始开发这个图书馆，就发现了家庭助理的世界。 因此，我决定花些时间来开发一个功能齐全的Homeassistant自定义组件，您可以在这里找到它。 感谢@troykelly，他许下了一个愿望，并支持我开发这种组件的努力！