hassio-addons/sbfspot/README.md
2022-08-13 02:38:40 +00:00

4.1 KiB

Community Hass.io Add-ons: SBFspot

project-stage-shield Project Maintenance

Version Arch

This home assistant add-on provides the installation, configuration, and integration for the Bluetooth version of SBFspot 3.9.5. This version is for the Container/supervised installation method of Home assistant. Although the haos version will also work here. Openrc is omitted in the HAOS version due to read only file system.

This add-on installs a cron service for SPFspot uploader at 5 minutely daytime interval, PVoutput account and API are required, it also requires an SQL database like Mariadb. It also sends a MQTT message to home assistant, therefore a MQTT broker is required.

Installation

Initial database creation.

Download and import either No Drop DB create or Create My SQL.sql in phpMyAdmin to create your database. IF you haven't already created the database previously, use the NO Drop version. You will also need to add the Database and User/Password to MariaDB and allocate the port.

screenshot

MQTT

sbfspot_sensors.yaml I use packages to include these yaml sensors. You will need to change to match your plant name and serial as you have set in the add-on configuration options.

MQTT argument options configuration options The MQTT Username, and Password need to be hardcoded into the MQTT_PublisherArgs: The {host} {topic} and {{message}} will be picked up from options.

MQTT_PublisherArgs: '-h {host} -u Your_MQTT_Username -P Your_MQTT_password -t {topic} -m "{{message}}" -d -r'

-d is for MQTT debug in log. Helpful for showing the MQTT messages are actually being sent.

-r is to retain messages. retain is not advised.

Find your Local BT device address with Bluetoothctl

You can use the bluetoothctl command from the console(terminal or ssh addon) in homeassistant. This will list your controller mac address so you can add it to SBFspot addon config.

Example Configuration Options.

Config can be copy/pasted as Example Config or entered via UI Example Options

Data paths

In docker the /data/ path arrives at /usr/share/hassio/addons/data/slug#_sbfspot on the host.

Upload logs

The log file here may need to be cleaned up manually.

Refer to the Wiki for documentation and FAQ.

Special thanks to:

  • LauR3y/hassio-addons which this version is cleaned up from.
  • The SBFspot team for SPFspot.

Supports aarch64 Architecture Supports armhf Architecture Supports armv7 Architecture