python-mystrom 0.5.0

要求

您需要安装Python。

• myStrom设备（灯泡、插头或按钮）
• requests
• 网络连接
• 连接到网络的设备

安装

这个包在Python Package Index中提供。

$ pip install python-mystrom

插头/开关

目前涵盖以下端点：

• /report：用于获取当前状态和功耗
• /relay：用于设置中继状态

您仍然可以将设备与智能手机应用程序一起使用， curl或其他工具。下面的示例演示如何将开关与 httpie和curl以及python-mystrom。

$ http http://IP_ADDRESS_PLUG/report
HTTP/1.1 200 OK
Content-Length: 39
Content-Type: application/json
Date: Mon, 15 Feb 201617:52:21 GMT

{"power": 51.630947,
    "relay": true}

$ curl -X GET http://IP_ADDRESS_PLUG/relay?state=1

灯泡

如果灯泡是亮的，那么您应该能够检索 灯泡。

浏览到http://IP_ADDRESS_BULB/api/v1/device/MAC_ADDRESS_BULB或使用 命令行工具。

$ curl -d "color=0;0;100" -d "action=on" http://IP_ADDRESS_BULB/api/v1/device/MAC_ADDRESS_BULB
{"5DFF7FAHZ987":         {"on": true,
            "color": "0;0;100",
            "mode": "hsv",
            "ramp": 100,
            "notifyurl": ""}}

灯泡无法处理格式化为json的有效负载。必须 使用application/x-www-form-urlencoded。如果有什么事 不起作用，尤其是在用hsv设置颜色时。

如果你打算用你的灯泡和Home Assistant 使用应用程序或使用下面的命令将灯泡设置为从colors开始的状态。

$ curl -d "color=0;0;100" IP_ADDRESS_BULB/api/v1/device/MAC_ADDRESS_BULB

$ curl -d "color=0;0;100" http://IP_ADDRESS_BULB/api/v1/device/MAC_ADDRESS_BULB

$ curl -d "color=10;100" http://IP_ADDRESS_BULB/api/v1/device/MAC_ADDRESS_BULB

$ curl -d "action=on&ramp=1000&color=00FF0000" http://IP_ADDRESS_BULB/api/v1/device/MAC_ADDRESS_BULB

按钮

这些按钮可以通过mystrom应用程序设置，也可以直接通过http请求设置。

要设置配置，有效负载必须包含 操作：

$ curl -v-d"single=<url>&double=<url>&long=<url>&touch=<url>"http://IP_ADDRESS_BUTTON/api/v1/device/MAC_ADDRESS_BUTTON

可用操作：

• single：短推（大约1/2秒）
• double：2次连续短推（2秒内）
• long：长推（大约2秒）
• touch：触摸按钮表面（仅对WiFi有效 按钮+

设置该按钮可将电池的使用寿命延长至 可能的。这意味着只有在前3分钟内或连接时 对于USB端口/USB充电器，如果电池未满，则按钮可以 接收配置信息或发布其详细信息。

^{tt（TT）16}$helper工具

命令行工具mystrom可以帮助设置按钮并获取 灯泡和插头的细节。

$ mystrom
Usage: mystrom [OPTIONS] COMMAND [ARGS]...

  Simple command-line tool to get and set the values of a myStrom devices.

  This tool can set the targets of a myStrom button for the different
  available actions single, double, long and touch.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  bulb    Get and set details of a myStrom bulb.
  button  Get and set details of a myStrom button.
  config  Get and set the configuration of a myStrom...

这些例子展示了如何获得给定灯泡的细节。

$ mystrom config read
IP address of the myStrom device: IP_ADDRESS_BULB
MAC address of the device: MAC_ADDRESS_BULB
Read configuration from IP_ADDRESS_BULB
{'MAC_ADDRESS_BULB':{'type':'rgblamp',
      'battery':False,
      'reachable':True,
      'meshroot':False,
      'on':True,
      'color':'191;90;14',
      'mode':'hsv',
      'ramp':100,
      'power':0.953,
      'fw_version':'2.25'}}

模块的示例用法

下面的示例演示如何使用这个python模块。

importpymystromplug=pymystrom.MyStromPlug('IP_ADDRESS_PLUG')# Preserve stateSTATE_ON=plug.get_relay_state()# Switch relay on if the plug is currently offifnotSTATE_ON:print("Relay will be switched on")plug.set_relay_on()# Wait a few seconds to get a reading of the power consumptionprint("Waiting for a couple of seconds...")time.sleep(10)# Get the new state of the switchprint("Relay state:",plug.get_relay_state())print("Power consumption:",plug.get_consumption())# Switch relay off if it was off.ifnotSTATE_ON:plug.set_relay_off()

灯泡的示例可以在目录examples中找到。

许可证

python-mystrom在mit下获得许可，有关更多详细信息，请检查许可证。