{"id":23752481,"url":"https://github.com/rwbl/ccu-device-viewer","last_synced_at":"2026-01-27T17:05:00.173Z","repository":{"id":156023970,"uuid":"342505328","full_name":"rwbl/ccu-device-viewer","owner":"rwbl","description":"HomeMatic Smart Home Central Control Unit all devices and current values viewer.","archived":false,"fork":false,"pushed_at":"2025-07-14T09:44:50.000Z","size":15361,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-14T12:34:43.564Z","etag":null,"topics":["b4j","b4x","homematic","xml-api"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","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/rwbl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null}},"created_at":"2021-02-26T08:05:01.000Z","updated_at":"2025-07-14T09:44:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"7d96724b-6105-40a6-990a-7c5d44cd6730","html_url":"https://github.com/rwbl/ccu-device-viewer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rwbl/ccu-device-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwbl%2Fccu-device-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwbl%2Fccu-device-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwbl%2Fccu-device-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwbl%2Fccu-device-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rwbl","download_url":"https://codeload.github.com/rwbl/ccu-device-viewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwbl%2Fccu-device-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28816576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T12:25:15.069Z","status":"ssl_error","status_checked_at":"2026-01-27T12:25:05.297Z","response_time":168,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["b4j","b4x","homematic","xml-api"],"created_at":"2024-12-31T17:53:03.107Z","updated_at":"2026-01-27T17:05:00.167Z","avatar_url":"https://github.com/rwbl.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CCU Device Viewer\r\nOpen Source Project viewing all devices and current values from the [HomeMatic](https://www.homematic.com) Smart Home [Central Control Unit](https://www.eq-3.com/products/homematic/detail/smart-home-central-control-unit-ccu3.html).\r\n## View Option: All datapoints for the device selected\r\n\u003cimg width=\"802\" height=\"630\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/41a6ed7c-5234-41d0-93fc-ba1eaa45876d\" /\u003e\r\n## View Option: Filter by XML Attribute ACTUAL_TEMPERATURE\r\n\u003cimg width=\"803\" height=\"632\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/952d795c-385c-441a-a501-882428c60915\" /\u003e\r\n\r\n## Purpose\r\n* To view the state of devices and their datapoints as configured in the CCU.\r\n* To get device datapoint(s) ID (XML attribute ise_id = \"NNN\") used for XML-API HTTP requests via for example Domoticz Homeautomation.\r\n* To quickly view the status of a device.\r\n* To filter a selected attribute for all devices, i.e. check low battery state (XML attribute type = \"LOW_BAT\").\r\n* To view system variables name, value and ID.\r\n* To export or copy device or datapoint data.\r\n* To save XML-API HTTP response to a text file with XML tree.\r\n* To have fun developing with [B4J](https://www.b4x.com/b4j.html).\r\n\r\n## Requirements\r\n* HomeMatic Smart Home [Central Control Unit](https://www.eq-3.com/products/homematic/detail/smart-home-central-control-unit-ccu3.html).\r\n* [HomeMatic](https://www.homematic.com) is a registered trademark of [eQ-3 AG](https://www.eq-3.com/start.html).\r\n* HomeMatic [XML-API](http://github.com/homematic-community/XML-API) CCU addon to read values from the CCU. Ensure to obtain the mandatory security access token.\r\n* Java JDK 19 to run the application **ccudeviceviewer.jar**. Must [read](https://www.b4x.com/b4j.html) - Note: JavaFX is used, download the recommended Java JDK package from B4J website.\r\n\r\n## Application\r\n* created as an Open Source project for personal use only, according the GNU GENERAL PUBLIC LICENSE; Usage at your own risk.\r\n* tested with an HomeMatic CCU3 3.83.6 and the XML-API CCU Addon 1.23.\r\n* developed with [B4J](https://www.b4x.com/b4j.html) v10.30 (64-bit) [more info](https://www.b4x.com) about the B4X Products.\r\n* tested with Java JDK 19 (see run19.bat how to start).\r\n* published on the [B4J Forum](https://www.b4x.com/android/forum/threads/homematic-smart-home-ccu-device-viewer.128070/).\r\n\r\n## Installation Windows\r\n- Unpack the archive to a folder of choice.\r\n- Run the application from the B4J IDE or using run19.bat.\r\n- The file ccudeviceviewer.json maintains the settings.\r\n\r\n## Concept\r\nThe device data from the CCU is obtained via HTTP XML-API request (running a script), i.e. http://ccu3-webui/addon/devicelist.cgi.\r\nThe HTTP XML-API requests response is an XML tree which is parsed to a map. The map contains lists and maps for the devices and datapoints.\r\nThe devices are selected and their XML attributes name, ise_id, device_type are used to populate a custom listview Devices.\r\nA custom listview Device entry is a panel with fields for the selected XML attributes.\r\n\r\nThe next step is to get the full statelist for all devices and datapoints, i.e. http://ccu3-webui/addon/statelist.cgi.\r\nThis is required to get the datapoints and their selected XML attributes for a device selected in the customlistview Devices.\r\nDepending the number of devices defined in the CCU, this can be a rather big list.\r\nSelecting a device from the Devices list, selects the datapoints from the statelist.\r\nThe datapoints are populated to a B4XTable with 1 to N pages.\r\nThe table has columns for the XML attributes: type, value, ise_id and channel.\r\nThe column headings are Type,Value,ID,Channel.\r\n\r\nThe B4XTable is also used to populate filtered data from all devices.\r\nThe table has columns for the XML attributes: device type, device ise_id, datapoint value, datapoint ise_id.\r\nThe column headings are Device_Type, Device_Value, Datapoint_Value, Datapoint_ID.\r\n\r\nFor the systemvariables the concept is the same, i.e. get data using XML-API HTTP request http://ccu3-webui/addon/sysvarlist.cgi.\r\nThe returned XML tree is parsed and data, name, value, ise_id is added to the B4XTable columns Name, Value, ID\r\n\r\n## Source Code\r\nThe archive **ccudeviceviewer.zip** contains the [B4J](https://www.b4x.com/b4j.html) source code.\r\nAdditional libraries required: B4XCollections, B4XTable, jOkHttpUtils2, Json, Xml2Map, XUI Views.\r\n\r\n## ToDo\r\n* Change the value of a selected datapoint via B4X dialog (\"quickset function\").\r\n* Multiple XML attribute filters (instead one).\r\n* Run HomeMatic scripts remote and capture the output (to be explored).\r\n* Simplify the CCUClass.\r\n\r\n## Credits\r\n* To the developers of the HomeMatic XML-API Addon.\r\n\r\n## Licence\r\nGNU GENERAL PUBLIC LICENSE v3.0.\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frwbl%2Fccu-device-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frwbl%2Fccu-device-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frwbl%2Fccu-device-viewer/lists"}