{"id":15653297,"url":"https://github.com/yozik04/nibe-mqtt","last_synced_at":"2025-07-10T10:41:41.792Z","repository":{"id":37406617,"uuid":"487541487","full_name":"yozik04/nibe-mqtt","owner":"yozik04","description":"Nibe MQTT integration to use with HomeAssistant MQTT Autodiscovery","archived":false,"fork":false,"pushed_at":"2025-03-16T16:06:06.000Z","size":69,"stargazers_count":30,"open_issues_count":3,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-29T22:04:28.332Z","etag":null,"topics":["integration","mqtt","nibe"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yozik04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-01T13:13:02.000Z","updated_at":"2025-03-16T16:06:09.000Z","dependencies_parsed_at":"2024-10-23T03:35:28.985Z","dependency_job_id":"6a7a9d23-c8b4-4254-ade3-d8e1729fa259","html_url":"https://github.com/yozik04/nibe-mqtt","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yozik04%2Fnibe-mqtt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yozik04%2Fnibe-mqtt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yozik04%2Fnibe-mqtt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yozik04%2Fnibe-mqtt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yozik04","download_url":"https://codeload.github.com/yozik04/nibe-mqtt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250367201,"owners_count":21418843,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["integration","mqtt","nibe"],"created_at":"2024-10-03T12:45:17.635Z","updated_at":"2025-04-23T04:20:51.161Z","avatar_url":"https://github.com/yozik04.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nibe MQTT integration\nMQTT integration for controlling Nibe heatpumps. Supports HomeAssistant MQTT Autodiscovery.\n\n## Connection methods\n\n- RS485 hardwired using NibeGW on Arduino or RPi. NibeGW was developed by Pauli Anttila for [Openhab's integration](https://www.openhab.org/addons/bindings/nibeheatpump/).\n- TCP Modbus for S Models\n- Serial Modbus for Nibe Modbus 40)\n\n#### Supported heatpump models\n\n - F1145\n - F1245\n - F1155\n - F1255\n - F1345\n - F1355\n - F370\n - F470\n - F730\n - F750\n - S320\n - S325\n - S330\n - S332\n - S735\n - S1156\n - S1256\n - S2125\n - SMO20\n - SMO40\n - SMOS40\n - VVM225\n - VVM310\n - VVM320\n - VVM325\n - VVM500\n\nAdditionally, supports some S series through TCP Modbus (experimental)\n\n## Installation\n### PyPi\nIt is possible to install directly from PyPi\n```bash\npip3 install nibe-mqtt\n```\n\nThen you will be able to run the service with command\n```bash\nnibe-mqtt -c config.yaml\n```\n\n### Docker\nSee [Docker Hub](https://hub.docker.com/repository/docker/yozik04/nibe-mqtt) for available versions (tags)\n\nRun with:\n```bash\ndocker run -ti --pull=always --rm -p 9999:9999/udp -v \"/Users/myuser/Desktop/config.yaml:/config/nibe-mqtt/config.yaml:ro\" yozik04/nibe-mqtt:latest\n```\n\n## Basic configuration\n\n### With NibeGW:\n```yaml\nmqtt:\n  host: 192.168.1.2\n  port: 1883\n  protocol: 5\n  username: user\n  password: pass\nnibe:\n  model: F1255\n  nibegw:\n    ip: 192.168.1.3\n  poll:\n    coils:\n      - bt50-room-temp-s1-40033\n```\n\nFor all configuration options lookup in config.py\n\n### With Modbus:\n```yaml\nmqtt:\n  host: 192.168.1.2\n  protocol: 5\n  username: user\n  password: pass\nnibe:\n  model: F1255\n  word_swap: true\n  modbus:\n    url: tcp://192.168.1.3:502\n    slave_id: 1\n  poll:\n    coils:\n      - bt50-room-temp-s1-40033\n```\n\nFor all configuration options lookup in config.py\n\n## Supported coils\nSee the list of available parameters [here](https://github.com/yozik04/nibe/tree/master/nibe/data)\n\n## Writing Registers\nSee the list of supported coils to find out which registers can be written (set). For setting a register/coil, publish your data under the following topic: `[prefix]/[coil]/set`. Example: Publish `ONE TIME INCREASE` to `nibe/coils/temporary-lux-48132/set` for turning on temporary hot water lux mode.\n\n## Word swap\nYou might need to specify `word_swap` setting to let underneath library understand how to decode 32-bit integers (mostly counters). For most of the heat pumps with NibeGW connection method it will be auto detected (since `nibe-mqtt 1.1.0`, `nibe 2.1.0`).\n\n```yaml\n...\nnibe:\n  ...\n  word_swap: true\n  ...\n```\n\nYou can find the setting value in you Heat pump service menu 5.3.11 (`modbus settings`), there is a setting called `word swap`.\n\nYou need to set `word_swap` setting in yaml to match the setting in the service menu.\n\nFailing to do so will start throwing errors with decoding errors of 32-bit registers.\n\n## Disclaimer\n\nNibe is registered mark of NIBE Energy Systems.\n\nThe code was developed as a way of integrating personally owned Nibe heatpump, and it cannot be used for other purposes. It is not affiliated with any company, and it doesn't have commercial intent.\n\nThe code is provided AS IS and the developers will not be held responsible for failures in the heatpump operation or any other malfunction.\n\n**IMPORTANT**: Using this library to control your heatpump is done at your own risk. The developers assume no responsibility for any damage that may occur to your heating system, property, or for any unsafe conditions that may result from improper use. Changing heatpump parameters can potentially damage your equipment or create hazardous conditions. Users should have sufficient knowledge of their heating system before attempting to control it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyozik04%2Fnibe-mqtt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyozik04%2Fnibe-mqtt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyozik04%2Fnibe-mqtt/lists"}