logo elektroda
logo elektroda
X
logo elektroda

Installing the XML API patch on Homematic CCU3 for TinyMatic - how to do it?

tida1 2268 15
ADVERTISEMENT
Treść została przetłumaczona polish » english Zobacz oryginalną wersję tematu
  • #1 18269043
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    Hello

    I want to install an XML API fix/ patch and I don't know how to go about it.

    This is required by the TinyMatic app( for smart home control) "In order to use TinyMatic, a device with Android 4.0 or later and the HomeMatic CCU1 / CCU2 / CCU3 is required.( and I have a CCU3) In addition, the XML API patch must be installed in the middle." This is a poor automatic google translation from German.

    I downloaded the file:

    https://github.com/hobbyquaker/XML-API/releases/download/1.20/xmlapi addon-1.20.tar.gz

    I copied it to the phone, ( and this is in compressed and uncompressed versions) Astro manager sees the files, but they are not standard *sdk and I still don't know how to install the patch.... I have 7.1.1 NMF26F and tel Mi Max 2.

    kind regards
  • ADVERTISEMENT
  • Helpful post
    #2 18269202
    Anonymous
    Level 1  
  • ADVERTISEMENT
  • #3 18269336
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    And that's an onlooker of me :) Thanks !

    The access to CCU3 is already working, I have not yet managed to install the above mentioned patch, because temporarily
    I am at work and have the PBX connected to a different network than my laptop. Is it easy to configure it so that the webui of the PBX can be accessed from any network ?
  • #4 18269348
    Anonymous
    Level 1  
  • #5 18269355
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    Sorry, I didn't write specifically - same location, just 2 V-LANs.

    Actually, I don't really know if it's 2 VLANs, I just know it's two different network SSIDs, but the internet connection is one.
  • #6 18269369
    Anonymous
    Level 1  
  • ADVERTISEMENT
  • #7 18269426
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    I cable the CCU to a router that has wi-wi. When I connect with my laptop to this wifi network, I can access the CCU.

    When I connect with my laptop to another wifi network ( because it's the other part of the building), I can't access the CCU. I don't know what the router is, neither one nor the other....
  • #8 18269435
    Anonymous
    Level 1  
  • ADVERTISEMENT
  • #9 18269441
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    I wrote above, these are not my networks ( only my employer's, I am now at work and here I connected the CCU) therefore I know nothing about these networks....

    just, I have wifi passwords and that's it :)
  • #10 18269449
    Anonymous
    Level 1  
  • #11 18269705
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    Exactly, for testing only :) .

    I see that there is also a new soft/firmware, it is a file with extension *.tgz version 3.47.22 - do you have to extract it, or such *.tgz upload ?
  • #12 18269842
    Anonymous
    Level 1  
  • #13 18277185
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    I had an emergency trip and have only just returned, so I'm writing on the switchboard :) .

    I have corrected the title of the topicle in general about the update to make it more readable.

    I have successfully updated both the firmware and the API XML soft and still the Mediola plugin, the firmware took about 17 minutes to update, so does that mean the speed of the card is decent ?

    At the moment I still have the warranty, so I wouldn't want to replace the card, but after the warranty I may do so, I'm also curious about this alternative RaspberryMatic soft - what does this give to the average user ?
  • #14 18277192
    Anonymous
    Level 1  
  • #15 18287389
    tida1
    Level 9  
    Posts: 214
    Help: 5
    Rate: 19
    This is my question regarding the default IP address of the CCU3, as the PBX was not seen at all on my home network.

    Unfortunately, my home router (it's a popular Huawei B525 and LTE access from Plus) has default settings in DHCP from 192.168.8.100 to 192.168.8.200, and factory settings after connecting and running the netfinder program showed the PBX address 192.168.1.107, so I changed the settings in the B525, as shown in the screenshot below, and here the problems began...
    Installing the XML API patch on Homematic CCU3 for TinyMatic - how to do it? [img-0].

    CCU3 connects ok on 192.168.1.107, but:

    - Net on the laptop has started to work strangely, badly, there are frequent interruptions, lags, problems with sending/receiving emails, refreshing pages etc. - e.g. I can't add a photo to a post the first time, etc. etc.
    - messages like "site unreachable" Connection has been reset. - need to refresh
    -The access to the wireless thermostat controlled by wifi( controls the gas boiler) has stopped working, the thermostat is connected to the wifi network, but I have a message that it is "offline"
    - From my mobile phone ( although it is correctly connected to the wifi network) I cannot
    send any e-mail, I have tried from several e-mail accounts

    Should I therefore return to the factory settings of the B525 router and change ( force manually ?) the default address of the CCU so that it fits into the pool set by the router ?

    greetings!
  • #16 18287439
    Anonymous
    Level 1  

Topic summary

✨ The discussion revolves around installing the XML API patch on the HomeMatic CCU3 to enable functionality with the TinyMatic app. The user initially struggles with the installation process, having downloaded the necessary file but unsure how to proceed. Responses clarify that the XML API is intended for the CCU and not for Android devices, and installation can be done via the CCU's settings under "Additional software." The user later addresses network access issues, as the CCU is connected to a different Wi-Fi network than their laptop. Suggestions include configuring the router to allow communication between networks and ensuring the CCU is set to obtain an IP address correctly. The user successfully updates both the firmware and the XML API software, with discussions on potential improvements from using alternative software like RaspberryMatic.
Generated by the language model.

FAQ

TL;DR: Get TinyMatic working on CCU3 by installing the add-on and stabilizing IP—one update prep took over 1.5 hours, and “Updating the firmware on any device is dangerous.” [Elektroda, Anonymous, post #18269842]

Why it matters: This FAQ helps Homematic users install XML-API for TinyMatic and avoid network and update pitfalls on CCU3.

Quick Facts

How do I install the XML‑API add‑on for TinyMatic on a CCU3?

Install it on the CCU3, not on Android. In WebUI go to Settings > Control panel > Additional software. Then use the add-on installer to add XML‑API. “This XML API is for CCU and not for Android.” How‑To:
  1. Open CCU3 WebUI > Settings > Control panel > Additional software.
  2. Start the add‑on installer and select XML‑API.
  3. Confirm and reboot if prompted. [Elektroda, Anonymous, post #18269202]

Can I install xmlapi*.tar.gz on my Android phone for TinyMatic?

No. XML‑API is a CCU add‑on, not an Android install. Install it via the CCU3 WebUI under Settings > Control panel > Additional software. This enables TinyMatic to talk to your CCU3. “This XML API is for CCU and not for Android.” [Elektroda, Anonymous, post #18269202]

Do I need to extract the CCU3 firmware .tgz before uploading?

No. Upload the firmware exactly as downloaded. “Such as you download.” The CCU3 handles extraction during the update process. Avoid manual unpacking to prevent upload or integrity issues. [Elektroda, Anonymous, post #18269842]

How long does a CCU3 update take, and what affects it?

Updates usually take several minutes. One unit’s preparation phase took more than 1.5 hours due to a slow SD card. “The culprit, of course, was an SD card with too slow write speeds.” Faster cards shorten update time and reduce stalls. [Elektroda, Anonymous, post #18269842]

What if a CCU3 update fails or the system won’t boot afterward?

Don’t panic. Typically only the SD card contents get corrupted. Reflash the SD and restore the system. Many switch to RaspberryMatic during the reflash for extra features and stability. “Updating the firmware on any device is dangerous.” [Elektroda, Anonymous, post #18269842]

How can I reach the CCU3 WebUI from another Wi‑Fi network or VLAN?

Enable routing between the networks on your router. Isolated SSIDs or VLANs block access by design. Check for Wi‑Fi client isolation and inter‑VLAN rules. Without router admin access, you can’t bridge these segments. [Elektroda, Anonymous, post #18269369]

Laptop on a different SSID can’t reach CCU3. What should I check first?

Verify both devices are on the same IP subnet. If CCU3 is wired and your laptop uses Wi‑Fi, check AP isolation settings. Disable isolation or allow LAN‑Wi‑Fi bridging. Confirm which router or AP manages each SSID. [Elektroda, Anonymous, post #18269369]

The CCU3 IP doesn’t match my router’s subnet. What’s the clean fix?

Keep your router’s DHCP as is. Set CCU3 to obtain an IP via DHCP, then either assign a DHCP reservation or set a static IP outside the DHCP pool (e.g., 192.168.8.99). This preserves stable routing. [Elektroda, Anonymous, post #18287439]

I changed my B525 DHCP range and my network went unstable. How do I recover?

Revert the router to its prior DHCP settings. Before doing that, switch CCU3 to DHCP to avoid lockout. Then either reserve a DHCP IP for CCU3 or set a static address outside the pool. [Elektroda, Anonymous, post #18287439]

Where can I download the XML‑API add‑on for Homematic?

Use the project’s GitHub releases. For example, xmlapi add-on 1.20 was downloaded from the releases page. Save the archive and install it through the CCU3 WebUI’s add‑on installer. [Elektroda, tida1, post #18269043]

Does TinyMatic require XML‑API on a CCU3?

Yes. The app expects the XML‑API patch to be installed on the CCU. Without it, TinyMatic cannot retrieve devices and states via the CCU interface. Install XML‑API first, then configure TinyMatic. [Elektroda, tida1, post #18269043]

How do I install the Mediola plugin on a CCU3 alongside XML‑API?

Install it like other CCU add‑ons through the WebUI’s add‑on section. Users reported updating firmware, XML‑API, and then Mediola successfully in one session. Reboot when prompted to finalize modules. [Elektroda, tida1, post #18277185]

Should I switch my CCU3 to RaspberryMatic? What do I gain?

RaspberryMatic looks like the stock WebUI but adds extras and better flexibility. Many recommend replacing the SD card and moving to RaspberryMatic for reliability. It’s a straightforward improvement path. [Elektroda, Anonymous, post #18269842]

How can I find my CCU3’s IP if it isn’t visible on my LAN?

Connect your computer to the same network segment and run the Netfinder tool. One user saw 192.168.1.107 reported at factory defaults. Align subnets or use DHCP reservation to regain access. [Elektroda, tida1, post #18287389]
Generated by the language model.
ADVERTISEMENT