Heiman HS1SA-M matter over Thread OTA instruction/guide

[leoXie]

Heiman was the first brand to support Matter for smoke and CO alarms. Since there are several firmware versions out there, some users are having trouble upgrading to v1.5. I’d like to show you how to get those older versions updated.

Release Note:

• 1.0: matter 1.2 initial version.
• 1.1: fix ICD issue and improve stability.
• 1.2: upgrade matter 1.4 version.
• 1.3: fix ICD issue and improve stability.
• 1.4: Migrate LIT ICD features from Matter 1.5 and bug fixing.
• 1.5: Fix LIT ICD features and improve subscription.

Planed OTA release:

• 1.6: fix rarely offline issue in AppleHome/Homekit.
• 1.7: fix LIT ICD issue and supports mute and siren in HomeAssitant.

How to identify the version?

1. Open the Matter Server UI and select your smoke alarm to go to the device page. Click ‘interview’ and wait for the process to complete.
   

   
   
   
   

2. please check the SoftwareVersion and ManufacturingDate in basicalinfomation cluster as below:
   

   

3. if the date is older than May 2025 (because Matter 1.4 was released at early of 2025), please update an interim firmware, let’s say 1.1, and then update to 1.5 version, if your sensor is newer than that, you can skip this step and update directly.

How to update interim firmware 1.1?

here is a good article that guide us how to update it locally.

https://smartdomo.de/en/blogs/news/rauchmelder-sirene-direkt-ansteuern

    # access to you HA console and create the json file:
    cd /addon_configs/core_matter_server/updates/ 
    touch HeimanD1TestNet.json 
    nano HeimanD1TestNet.json

fill into HeimanD1TestNet.json:

    {
      "modelVersion": {
        "vid": 4619,
        "pid": 4099,
        "softwareVersion": 17,
        "softwareVersionString": "1.1",
        "cdVersionNumber": 1,
        "softwareVersionValid": true,
        "otaUrl": "https://heimanfile.oss-cn-shenzhen.aliyuncs.com/eb1257c6c4c544a8bca90e5b17bf896e.ota",
        "otaChecksum": "Oan8n6XrxFSvCaHguD9Jt2hxmVM+XnnVWAn8gV1FEjM=",
        "otaChecksumType": 1,
        "minApplicableSoftwareVersion": 1,
        "maxApplicableSoftwareVersion": 1000
      }
    }

4. restart your Matter server:
   

   

5. navigate to your smoke alarm page again, when you click the update, it will indicates you version 1.1
   

   

6. Waiting for the update to complete, and wait a while, reinteview your device again, it will shows 1.1 version:
   

   

7. remove the json file and restart Matter Server, and now, you should able to update to version 1.5
   

   

8. when you finished the ota process to 1.5, you may need to re-pair the smoke alarm, after re-onboard, you should see the version has shown version 1.5.

Some users and we have tested it but if you still encountering issues, please let us know or leave comments below.

Optional firmware with on/off Siren:

if you would like to use the siren, please update to v4.1 version, you can update it to v4.1 from v1.5 directly, it will exposes an on/off to HA and other ecosystems.

    {
     "modelVersion":{
     "vid":4619,
     "pid":4099,
     "softwareVersion":65,
     "softwareVersionString":"4.1",
     "cdVersionNumber":1,
     "softwareVersionValid":true,
     "otaUrl":"https://heimanfile.oss-cn-shenzhen.aliyuncs.com/15527c11ab2b4ef2be6ab16cabac7d78.ota",
     "otaChecksum":"QlCSt7yawYykPNUC8lVzrSO+jnhS3uuSXUDnPwJEWn0=",
     "otaChecksumType":1,
     "minApplicableSoftwareVersion":1,
     "maxApplicableSoftwareVersion":1000
      }
    }

Updates:
the ota with matter.js is different from the phyton js. see: https://github.com/matter-js/matterjs-server#importing-custom-ota-firmware-files

[snevs]

Just came here to say that I love these smoke sensors. I have a few of HS1SA-M, the Matter-enabled ones. They are HW ver. 0.0, built in 2024 and they are amazing. Not to mention the super low profile.

The only problem was getting these updated from firmware version 1.0 to the latest, which was a pain in the butt. I had to work around it with HA, and at some point I was afraid they might have been bricked, but they came up again, and yes: I had to re-add them in Apple Home and Home Assistant. Anyway, GREAT device, very poor update experience.

It would be great if you could indicate if anything has changed between these manufacturing dates: 2024-2026.

for pre 2025 hardware versions, I would simplify the update procedure a bit, assuming all is done via the Advanced SSH & Web Terminal addon:
1 - Remove from Apple Home or any other home assistant/controlled, besides. the HOME ASSISTANT
2 - Execute:

cd /addon_configs/core_matter_server/updates/ 
touch HeimanD1TestNet.json 
<< cat EOF >> HeimanD1TestNet.json
{
      "modelVersion": {
        "vid": 4619,
        "pid": 4099,
        "softwareVersion": 17,
        "softwareVersionString": "1.1",
        "cdVersionNumber": 1,
        "softwareVersionValid": true,
        "otaUrl": "https://heimanfile.oss-cn-shenzhen.aliyuncs.com/eb1257c6c4c544a8bca90e5b17bf896e.ota",
        "otaChecksum": "Oan8n6XrxFSvCaHguD9Jt2hxmVM+XnnVWAn8gV1FEjM=",
        "otaChecksumType": 1,
        "minApplicableSoftwareVersion": 1,
        "maxApplicableSoftwareVersion": 1000
      }
    }
EOF

ha addons restart core_matter_server

curl -X POST \
  -H "Authorization: Bearer $SUPERVISOR_TOKEN" \
  -H "Content-Type: application/json" \
  http://supervisor/core/api/services/homeassistant/restart

[leoXie]

Thanks @snevs for loving it.
Update it via Home assistant is much more easier than Apple home, as well as Beta version, but I am happy to answer and fix it if there is any questions.

Tha’t good point, but I will strongly recommend to focus on the latest version, I listed some update histories above.

Thanks for sharing your update procedures.