{"id":19972741,"url":"https://github.com/thkl/hm-interface","last_synced_at":"2025-07-15T05:47:09.204Z","repository":{"id":57264610,"uuid":"323883026","full_name":"thkl/hm-interface","owner":"thkl","description":null,"archived":false,"fork":false,"pushed_at":"2021-07-25T12:58:12.000Z","size":194,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T21:27:23.641Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thkl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-23T11:22:21.000Z","updated_at":"2021-07-25T12:58:15.000Z","dependencies_parsed_at":"2022-08-25T02:52:13.490Z","dependency_job_id":null,"html_url":"https://github.com/thkl/hm-interface","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thkl/hm-interface","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkl%2Fhm-interface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkl%2Fhm-interface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkl%2Fhm-interface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkl%2Fhm-interface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thkl","download_url":"https://codeload.github.com/thkl/hm-interface/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkl%2Fhm-interface/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264929327,"owners_count":23684788,"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":[],"created_at":"2024-11-13T03:09:05.411Z","updated_at":"2025-07-15T05:47:09.140Z","avatar_url":"https://github.com/thkl.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is a node implementation for an eq3 CCU Hardware Interface\n\n\nUsage \nnpm install hm-interface\n\n```\nconst HMInterface = require('hm-interface')\n\nlet options = {\n  localIp: 'XXX.XXX.XXX.XXX', // The IP the interface should listen to\n  localPort: XXXX, // the port\n  ccuIP: 'AAA.AAA.AAA.AAA' // The ip from your ccu ; this is needed to change the rega init urls\n}\n\nlet newInteface = new HMInterface.HomematicInterface(options)\nnewInteface.init()\n\n// the interface will save XMPRPC Init IDs to use after an relaunch; if you want to use saved IDs \n// (you do not have to restart rega) you can do it by :\nnewInteface.loadClients(options.ccuIP)\n\n// Load a device definition and create a device\nlet devData = require(path.join(__dirname, 'HM-LC-Sw1-Pl.json'))\nlet switchDevice = newInteface.initDevice('Example', 'ABCD001234', 'HM-LC-Sw1-Pl', devData)\n\n// Message when the interface will change the value\nnewInteface.on('event_device_channel_value_change', (changedObject) =\u003e {\n  console.log('Device Value Change Event', JSON.stringify(changedObject))\n})\n\n// Message when rega will change the value\nnewInteface.on('device_channel_value_change', (changedObject) =\u003e {\n  console.log('Device Value Change bySetValue', JSON.stringify(changedObject))\n})\n\n````\n\n\nfor more see the example\n\nYou have to add the interface to your CCU by adding it to /etc/config/InterfacesList.xml\nJust add: (IP and Port see the example above)\n\n```\n\t\u003cipc\u003e\n\t \t\u003cname\u003emyFirstInterface\u003c/name\u003e\n\t \t\u003curl\u003exmlrpc://XXX.XXX.XXX.XXX:XXXX\u003c/url\u003e\n\t \t\u003cinfo\u003emyFirstInterface\u003c/info\u003e\n\t\u003c/ipc\u003e\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthkl%2Fhm-interface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthkl%2Fhm-interface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthkl%2Fhm-interface/lists"}