{"id":30397848,"url":"https://github.com/jschoedt/genvex-smartthings-edge","last_synced_at":"2025-08-21T14:13:59.591Z","repository":{"id":309355983,"uuid":"1035916856","full_name":"jschoedt/genvex-smartthings-edge","owner":"jschoedt","description":"SmartThings edge driver for Genvex HVAC","archived":false,"fork":false,"pushed_at":"2025-08-11T11:05:50.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-11T13:06:56.267Z","etag":null,"topics":["lua-programming","smartthings-edge"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/jschoedt.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-11T09:35:25.000Z","updated_at":"2025-08-11T11:05:54.000Z","dependencies_parsed_at":"2025-08-11T13:07:03.366Z","dependency_job_id":null,"html_url":"https://github.com/jschoedt/genvex-smartthings-edge","commit_stats":null,"previous_names":["jschoedt/genvex-smartthings-edge"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jschoedt/genvex-smartthings-edge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschoedt%2Fgenvex-smartthings-edge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschoedt%2Fgenvex-smartthings-edge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschoedt%2Fgenvex-smartthings-edge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschoedt%2Fgenvex-smartthings-edge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jschoedt","download_url":"https://codeload.github.com/jschoedt/genvex-smartthings-edge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschoedt%2Fgenvex-smartthings-edge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271493232,"owners_count":24769117,"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","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["lua-programming","smartthings-edge"],"created_at":"2025-08-21T14:13:55.413Z","updated_at":"2025-08-21T14:13:59.584Z","avatar_url":"https://github.com/jschoedt.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Genvex HVAC SmartThings Edge Driver\n\nControl your Genvex HVAC system directly from the SmartThings app using a local, LAN-based Edge driver. The driver implements the Genvex device protocol described in the genvexnabto project and communicates over UDP on your local network.\n\n- Protocol reference: https://github.com/superrob/genvexnabto\n- Nabto platform (reference repo): https://github.com/nabto\n\n## Features\n\n- Thermostat mode: heat, cool, auto, off\n- Heating and cooling setpoints\n- Current temperature and humidity monitoring\n- Fan speed control\n- Automatic device discovery on the local network\n- Manual refresh\n\n## How It Works\n\n- Local-only communication (no cloud hops) over UDP on port 5570\n- Discovers compatible Genvex units on your LAN and exchanges protocol packets for status and control\n- Based on the protocol as described in the genvexnabto project; see the references above for background\n\n## Requirements\n\n- A SmartThings Hub with Edge support\n- A compatible Genvex HVAC unit connected to the same local network as the hub\n- Stable LAN connectivity; multicast/broadcast must be allowed by your router/switch\n- An authorized email registered for access to your Genvex/Nabto-enabled device\n\n## Installation\n\n1. Obtain the driver package (Edge driver).\n2. Install it to your SmartThings Hub using your preferred method (for example, SmartThings CLI or Developer Workspace).\n3. In the SmartThings app, add a device and run discovery; the driver should find your Genvex unit automatically.\n\nNotes:\n- Ensure your phone, hub, and Genvex device are on the same subnet/VLAN.\n- If discovery fails, temporarily disable AP/client isolation or IGMP snooping that may block broadcasts.\n\n## Authorization: Email Requirement\n\nThis driver requires an authorized email to communicate with the device.\n\n- Register your email with your Genvex/Nabto-enabled unit (per your device/vendor instructions).\n- After the device is added in the SmartThings app, open the device’s Settings and enter the same authorized email in the Email field.\n- If the email is missing or incorrect, the connection will not be established and the device will not control the unit.\n\n## Configuration\n\nMost setups require no manual configuration beyond entering your authorized email. If your device isn’t discovered:\n\n- Verify the Genvex unit is powered, on the same LAN, and reachable.\n- Ensure your network allows UDP broadcast/response on port 5570.\n- Reboot the hub and Genvex unit if necessary, then retry discovery.\n\n## Capabilities Exposed\n\n- Thermostat Mode\n- Thermostat Heating Setpoint\n- Thermostat Cooling Setpoint\n- Temperature Measurement\n- Relative Humidity Measurement\n- Fan Speed\n- Refresh\n\n## Usage\n\n- Adjust thermostat mode and setpoints from the device panel in SmartThings.\n- Change fan speed if supported by your model.\n- Use Refresh to request an immediate status update.\n\n## Troubleshooting\n\n- Device not found:\n    - Confirm the hub and Genvex are on the same network and not separated by VLAN/firewall rules.\n    - Check that your router isn’t blocking broadcasts or UDP traffic on port 5570.\n- Controls not responding:\n    - Ensure the authorized email is correctly set in the device’s Settings in the SmartThings app.\n    - Use Refresh to resync state.\n    - Power-cycle the Genvex unit and hub.\n    - Verify the device remains reachable on the LAN (e.g., check DHCP leases).\n\n## Development Notes\n\nThis driver follows the on-device protocol outlined in the genvexnabto repository and communicates via UDP port 5570. For deeper protocol insights and historical background, consult:\n- genvexnabto: https://github.com/superrob/genvexnabto\n- Nabto (reference repo): https://github.com/nabto\n\n## Security and Privacy\n\n- Local network communication only; no cloud proxying by the driver.\n- Ensure your LAN is trusted. Consider placing IoT devices on a dedicated VLAN with appropriate firewall rules.\n\n## License\n\nProvided as-is, without warranty. Use at your own risk.\n\n## Acknowledgments\n\n- Protocol reference and background: genvexnabto project\n- Nabto platform resources and documentation","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjschoedt%2Fgenvex-smartthings-edge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjschoedt%2Fgenvex-smartthings-edge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjschoedt%2Fgenvex-smartthings-edge/lists"}