Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/magcode/sem6000-mqtt
MQTT for VOLTCRAFT SEM6000
https://github.com/magcode/sem6000-mqtt
ble iot mqtt voltcraft
Last synced: 1 day ago
JSON representation
MQTT for VOLTCRAFT SEM6000
- Host: GitHub
- URL: https://github.com/magcode/sem6000-mqtt
- Owner: magcode
- License: gpl-3.0
- Created: 2020-06-07T07:50:07.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-01-18T13:53:55.000Z (12 days ago)
- Last Synced: 2025-01-18T14:41:33.257Z (11 days ago)
- Topics: ble, iot, mqtt, voltcraft
- Language: Java
- Homepage:
- Size: 113 KB
- Stars: 20
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MQTT for VOLTCRAFT SEM6000
This tool allows to control VOLTCRAFT SEM6000 BLE (bluetooth low energy) power measurement sockets via MQTT and therefore easy integration in the home automation of your choice!
Based on the great work of [Heckie](https://github.com/Heckie75/voltcraft-sem-6000) and [hypfvieh](https://github.com/hypfvieh/bluez-dbus).
At the moment only crucial features are implemented: switching the relay, getting power and today's consumption values.
# Supported environments
The tool only runs on Linux and requires Java and [Bluez](http://www.bluez.org/).
It has been tested on the following environments:
```
Raspberry PI 3 B, Raspbian 10 Buster, OpenJDK 11.0.7, Bluez 5.50, built-in Bluetooth adapter usb:v1D6Bp0246d0532
Raspberry PI 3 B, Raspbian 10 Buster, OpenJDK 11.0.7, Bluez 5.50, USB Bluetooth adapter 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle
Virtual machine, Ubuntu 20.04, OpenJDK 11.0.7, Bluez 5.54, Intel Bluetooth adapter 8087:0a2b
```
# Please contribute
For problems: Report [issues](https://github.com/magcode/sem6000-mqtt/issues).
For the missing features: Create pull requests.
# Configuration
You need a `sem6.properties` file where you can configure multiple SEM6000 devices.
```
rootTopic=home/mysemdevices # the mqtt root topic
mqttServer=tcp://192.168.0.1 # IP or hostname of your mqtt broker
username=mqttuser # username for mqtt broker (optional, leave empty if not needed)
password=mqttpassword # password for mqtt broker (optional, leave empty if not needed)
mqttDiscovery=true # set to false if you don't want to use mqtt discovery
homeassistantRootTopic=homeassistant # the root topic for homeassistant discovery messages
sem1.mac=00:00:00:00:00:01 # the mac of your sem6000 device
sem1.pin=0000 # the PIN of your sem6000 device
sem1.name=sem1 # the name of your sem6000 device, use [a-z0-9]
sem1.refresh=60 # the schedule to send MQTT status information, seconds. Do not go below 30.
sem2.mac=00:00:00:00:00:02
sem2.pin=0000
sem2.name=sem2
sem2.refresh=60
```
How to get the mac? Log on to your host and enter
```
bluetoothctl
devices
```
# Running
It can simply be run with
`java -jar sem6000-mqtt-1.0.0-jar-with-dependencies.jar`
Don't forget to put the `sem6.properties` right beside the jar file.
## MQTT Discovery
If you set `mqttDiscovery=true` in the properties file, the tool will expose the SEM6000 devices to Home Assistant via MQTT discovery. The devices will be automatically discovered and added to Home Assistant.
# Control sockets
Use the following topic and payloads to control the relay:
```
//relay/set (true|false)
```
Use the following topic and payloads to enable/disable the LED:
```
//led/set (true|false)
```
# Get socket data
The tool will publish the following messages every 60 seconds (as configured in properties file):
```
//voltage (voltage)
//power (current power in watts)
//relay (relay, true or false)
//energytoday (consumed energy since midnight in watt hours)
```
# Stability and reconnects
A BLE connection is not stable sometimes. The tool will attempt to reconnect to the socket after five minutes in case the connection gets lost. It will stop reconnecting after reaching 100 consecutive unsuccessful reconnects.
# Raspberry PI
Install the required packages:
```
sudo apt install default-jdk
```
## Systemd service
You can create a systemd service to run the tool as a service. Create a file `/etc/systemd/system/sem6000-mqtt.service` with the following content:
```
[Unit]
Description=sem6000-mqtt
After=network.target
[Service]
ExecStart=/path/to/java -jar /path/to/sem6000-mqtt-1.0.0-jar-with-dependencies.jar
WorkingDirectory=/path/to
StandardOutput=inherit
StandardError=inherit
Restart=always
User=pi
[Install]
WantedBy=multi-user.target
```
Replace `/path/to/java`, `/path/to/sem6000-mqtt-1.0.0-jar-with-dependencies.jar` and `/path/to` with the correct paths.
You will find the java path by running: `which java` and the path to the jar file by running: `pwd` in the directory where the jar file is located.
Then run the following commands to reload the systemd configuration:
```
sudo systemctl daemon-reload
```
Then run the following commands to enable and start the service:
```
sudo systemctl enable sem6000-mqtt
sudo systemctl start sem6000-mqtt
```