[New device support]: SGS01Z_V3.0 from ZYCY
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 15.7k
- Forks
- 2k
- Avg merge
- 18h 55m
- Merged PRs (30d)
- 35
Description
Link
Database entry
{"id":16,"type":"EndDevice","ieeeAddr":"0xa4c138b08365e393","nwkAddr":52088,"manufId":4417,"manufName":"ZYCY","powerSource":"Battery","modelId":"SGS01Z_V3.0","epList":[1],"endpoints":{"1":{"profId":260,"epId":1,"devId":12,"inClusterList":[0,1026,1032,1,32],"outClusterList":[],"clusters":{"genBasic":{"attributes":{"appVersion":0}},"genPollCtrl":{"attributes":{"checkinInterval":14400}},"msTemperatureMeasurement":{"attributes":{"measuredValue":2850}},"msSoilMoisture":{"attributes":{"measuredValue":9700}},"genPowerCfg":{"attributes":{"batteryPercentageRemaining":44}}},"binds":[{"cluster":32,"type":"endpoint","deviceIeeeAddress":"0x00124b002de0e8bd","endpointID":1},{"cluster":1026,"type":"endpoint","deviceIeeeAddress":"0x00124b002de0e8bd","endpointID":1}],"configuredReportings":[{"cluster":1026,"attrId":0,"minRepIntval":10,"maxRepIntval":3600,"repChange":100}],"meta":{}}},"appVersion":0,"stackVersion":2,"hwVersion":1,"dateCode":"20251230","swBuildId":"Z:1.05_M:1.05","zclVersion":3,"interviewCompleted":true,"interviewState":"SUCCESSFUL","meta":{},"lastSeen":1787985398904,"checkinInterval":3600}
Zigbee2MQTT version
2.13.0 (unknown)
External definition
import * as m from 'zigbee-herdsman-converters/lib/modernExtend';
export default {
zigbeeModel: ['SGS01Z_V3.0'],
model: 'SGS01Z_V3.0',
vendor: 'ZYCY',
description: 'Automatically generated definition',
extend: [m.temperature(), m.soilMoisture(), m.battery()],
};
What does/doesn't work with the external definition?
m.illuminance(), m.temperature(), m.soilMoisture(), m.battery() All are valid
Notes
software_build_id: Z:1.05_M:1.05
date_code: 20251230
endpoints:
{"1":{"bindings":[{"cluster":"genPollCtrl","target":{"endpoint":1,"ieee_address":"0x00124b002de0e8bd","type":"endpoint"}},{"cluster":"msTemperatureMeasurement","target":{"endpoint":1,"ieee_address":"0x00124b002de0e8bd","type":"endpoint"}}],"clusters":{"input":["genBasic","msTemperatureMeasurement","msSoilMoisture","genPowerCfg","genPollCtrl"],"output":[]},"configured_reportings":[{"attribute":"measuredValue","cluster":"msTemperatureMeasurement","maximum_report_interval":3600,"minimum_report_interval":10,"reportable_change":100}],"scenes":[]}}
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start from the supplied external definition and the modernExtend helpers for the SGS01Z_V3.0 model. Check how existing device definitions register the zigbeeModel, vendor, and supported measurements, then verify that temperature, soil moisture, and battery values are exposed and the definition passes the repository's relevant checks.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- embedded-iot
- Issue type
- Feature
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 74/100