python library which can talk with Voltcraft SEM6000
Go to file
sqozz 8c372513d8 Merge branch 'master' of ssh://git.geekify.de:1421/sqozz/sem6000 2020-05-09 16:44:28 +02:00
collectd collectd: clarify bluepy import 2020-05-02 19:26:19 +02:00
.gitignore Ignore some files in Git 2020-01-20 21:10:05 +01:00
README.md Improved handling of unavailable devices 2020-05-02 19:26:19 +02:00
example.py Adjust example.py 2020-05-09 16:44:06 +02:00
requirements.txt Add PoC lib 2018-08-11 00:32:33 +02:00
sem6000.py Add serial and fw version property 2020-05-09 16:44:06 +02:00

README.md

SEM6000 Python Library

SEM6000 is a energy meter and power switch with Bluetooth 4.0.

This library provides a Python module for these devices

Run the example code

$ git clone … sem6000
$ cd sem6000
$ virtualenv -p python3 python3_venv
$ . ./python3_venv/bin/activate
$ pip3 install -r requirements.txt
$ python3 example.py

Collectd Plugin

You can find a Plugin for collectd in the collectd subdirectory.

Installation procedure (the target directory may be changed of course):

# mkdir -p /usr/local/lib/collectd/python
# cp collectd/collectd_sem6000.py /usr/local/lib/collectd/python
# cp sem6000.py /usr/local/lib/collectd/python

Add or adjust the configuration for your collectds Python plugin as follows:

<Plugin python>
  ModulePath "/usr/local/share/collectd/python"
  LogTraces true
  Interactive false
  Import "collectd_sem6000"

  <Module collectd_sem6000>
    Address "12:34:56:78:90:ab"
    SocketName "FirstSocket"
    ReadTimeout 30
    SuspendTime 300
  </Module>
  <Module collectd_sem6000>
    Address "ab:cd:ef:13:37:42"
    SocketName "ASecondSocket"
  </Module>
  # ...
</Plugin>

ReadTimeout and SuspendTime control whats happening when a device is unavailable. If no value could be retrieved for ReadTimeout seconds, the plugin does not retry for SuspendTime seconds. After that, normal operation is resumed. This procedure ensures that an unreachable device does not block other devices (too often) in the current single-threaded architecture.

If not specified, ReadTimeout is 30 seconds and SuspendTime is 5 minutes.

Make sure that everything listed in requirements.txt is available to the user running collectd.