{"id":24064805,"url":"https://github.com/techniccontroller/heiso_guntamatic_reader","last_synced_at":"2026-05-09T14:16:55.707Z","repository":{"id":164841096,"uuid":"445159176","full_name":"techniccontroller/HeiSO_guntamatic_reader","owner":"techniccontroller","description":"Python script for reading operating data of a GUNTAMATIC BMK biomass converter and saving it into a MySQL database on an Raspberry Pi.","archived":false,"fork":false,"pushed_at":"2023-11-30T08:54:36.000Z","size":24,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-09T10:52:47.554Z","etag":null,"topics":["guntamatic","mysql","mysql-database","raspberry-pi","rs232","serial"],"latest_commit_sha":null,"homepage":"","language":"Python","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/techniccontroller.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}},"created_at":"2022-01-06T12:18:12.000Z","updated_at":"2024-12-22T12:42:05.000Z","dependencies_parsed_at":"2023-11-30T09:59:07.152Z","dependency_job_id":null,"html_url":"https://github.com/techniccontroller/HeiSO_guntamatic_reader","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techniccontroller%2FHeiSO_guntamatic_reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techniccontroller%2FHeiSO_guntamatic_reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techniccontroller%2FHeiSO_guntamatic_reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techniccontroller%2FHeiSO_guntamatic_reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techniccontroller","download_url":"https://codeload.github.com/techniccontroller/HeiSO_guntamatic_reader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240908940,"owners_count":19876882,"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":["guntamatic","mysql","mysql-database","raspberry-pi","rs232","serial"],"created_at":"2025-01-09T10:52:50.944Z","updated_at":"2026-05-09T14:16:55.673Z","avatar_url":"https://github.com/techniccontroller.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HeiSO_guntamatic_reader\n\n*(Part of project HeiSO - visualization of operating data for heating systems)*\n\nPython script for reading operating data of a **GUNTAMATIC BMK biomass converter** and saving it into a **MySQL** database on an **Raspberry Pi**.\nThe boiler sends its operating data every 10 seconds via its serial RS232 interface. So the Raspberry Pi just need to read the data and save it.\n\nTested with GUNTAMATIC Spezialheizkessel BMK40 (BJ 2008, HAICO Zentraleinheit 7.3I/O 55.1-TAURUS, SW. Vers: V1.0h)\n\u003cimg src=\"https://user-images.githubusercontent.com/36072504/157074498-77abc48d-92bc-413f-a5a4-66ef43855495.png\" height=\"300px\"\u003e     \u003cimg src=\"https://user-images.githubusercontent.com/36072504/157075022-8b63f3b2-83e1-4d5c-8b9e-4e7c5fb033e1.png\" height=\"300px\"\u003e \n\n\n## Hardware\n\nOn the boiler, the interface is designed as an RJ45 socket, which is why a special cable is needed to map the lines to a standardized SUB-D 9-pin socket. In my design I created only a very short adapter cable with a RJ45 jack instead of a RJ45 plug, as shown in the drawing below, to be able to use a standard Ethernet patch cable to connect the GUNTAMATIC biomass converter to my Raspberry Pi box a few meters away.\n\nThe pin mapping is as follows:\n\n|RJ45   | SUB-D (female)  |description   |\n|---|---|---|\n|8   |5   |GND   |\n|6   |2   |RX   |\n|5   |3   |TX   |\n\n![image](https://user-images.githubusercontent.com/36072504/157071015-22a067dd-5bea-4661-a558-8260ffe9c703.png) (source: GUNTAMATIC)\n\n\nFor the connection to the Raspberry Pi a standard RS232 Serial Port to TTL Digital Converter Module is needed (e.g: https://www.ebay.de/itm/281353512577) \n![image](https://user-images.githubusercontent.com/36072504/157070491-f4058956-79ce-4551-a098-801203999cd3.png)\n\n## Software\n\nOn the Raspberry Pi the serial interface must be configured as follows:\n\n|Name|Setting|\n|---|---|\n|**Baudrate**\t|19200|\n|**Parity**\t|NONE|\n|**Stop Bits**\t|1|\n|**Data Bits**\t|8|\n|**Flow Control**\t|NONE|\n\nThe output looks similar to that:\n\n![image](https://user-images.githubusercontent.com/36072504/157072256-863d018d-4665-4a5d-95df-6bd5ecb0086e.png)\n\nThe script [guntamatic_serial_reader.py](https://github.com/techniccontroller/HeiSO_guntamatic_reader/blob/main/guntamatic_serial_reader.py) parses this output and saves some of the data to a MySQL database on the Raspberry Pi. A tutorial how to install MySQL database on Raspberry Pi can be found here: https://pimylifeup.com/raspberry-pi-mysql/. \n\nThe login credentials for the database are saved in the separate file *mysecrets.py* (an example of this file can be found in [mysecrets_example.py](https://github.com/techniccontroller/HeiSO_guntamatic_reader/blob/main/mysecrets_example.py)).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechniccontroller%2Fheiso_guntamatic_reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechniccontroller%2Fheiso_guntamatic_reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechniccontroller%2Fheiso_guntamatic_reader/lists"}