{"id":22261675,"url":"https://github.com/marplex/tuyafree","last_synced_at":"2025-09-05T20:40:21.972Z","repository":{"id":218942900,"uuid":"747762004","full_name":"Marplex/tuyaFree","owner":"Marplex","description":"Environment for building firmware for Zigbee TeLink Tuya devices.","archived":false,"fork":false,"pushed_at":"2024-01-24T15:38:52.000Z","size":31,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-25T13:46:50.382Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Marplex.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2024-01-24T15:37:36.000Z","updated_at":"2024-05-27T10:40:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"26d604a8-da0a-4359-a60f-4a29fe1ae01d","html_url":"https://github.com/Marplex/tuyaFree","commit_stats":null,"previous_names":["marplex/tuyafree"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Marplex/tuyaFree","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marplex%2FtuyaFree","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marplex%2FtuyaFree/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marplex%2FtuyaFree/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marplex%2FtuyaFree/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Marplex","download_url":"https://codeload.github.com/Marplex/tuyaFree/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marplex%2FtuyaFree/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273817442,"owners_count":25173610,"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","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-12-03T09:13:45.608Z","updated_at":"2025-09-05T20:40:21.948Z","avatar_url":"https://github.com/Marplex.png","language":"C","readme":"\u003ch1 align=\"center\"\u003etuyaFree\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\nEnvironment for building firmware for Zigbee TeLink Tuya devices.\n\u003cbr\u003eInspired by \u003ca href=\"https://github.com/doctor64/tuyaZigbee\"\u003edoctor64/tuyaZigbee\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/marplex/tuyaFree/blob/main/LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/marplex/tuyaFree\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Marplex\"\u003e\u003cimg alt=\"Github\" src=\"https://img.shields.io/static/v1?label=GitHub\u0026message=marplex\u0026color=005cb2\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# About\nThis is a work in progress.\n\nThe goal of this project is to create a stable and developer friendly environment for building custom Zigbee firmwares for Tuya devices.\nI will continue this by developing a firmware for the **TS0004** [in-wall zigbee mini switches](https://www.aliexpress.us/item/1005005534030750.html) adding support for interlocking and inching.\n\n# Supported devices\nMany Tuya devices come with `ZT2S` or `ZTU` modules. They all use the \"Z2\" RF chip which is based on the supported `TLSR8258`. Please refer to [doctor64/tuyaZigbee](https://github.com/doctor64/tuyaZigbee/tree/master#is-my-device-supported) for additional info.\n\n\n### TS0004\nThis mini switch uses the ZT2S and ZTU modules depending on the supported channels.\n\n- **ZT2S** for 1ch/2ch\n- **ZTU** for 3ch/4ch\n\nI have reverse engineered the board wirings of the ZTU 4ch version. The mapping is available at [boards/board_ztu_TS0004_4ch.h](src/tuyaFree/boards/board_ztu_TS0004_4ch.h)\n\n# Prepare toolchain and SDK\nDownload and prepare the **Linux toolchain** for Telink chips.\n```bash\n#Download toolchain\nwget http://shyboy.oss-cn-shenzhen.aliyuncs.com/readonly/tc32_gcc_v2.0.tar.bz2\n\n#Extract to /opt\nsudo tar -xvjf tc32_gcc_v2.0.tar.bz2 -C /opt/\n```\n\nAutomatically download and prepare the **TelinkSDK**\n```bash\n./install.sh\n```\n\n# Compile\nConfigure the build and compile the project. The build script will output the `tuyaFree.bin` file directly in the root folder.\n```bash\n#Configure\n./configure.sh\n\n#Build\n./build.sh\n```","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarplex%2Ftuyafree","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarplex%2Ftuyafree","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarplex%2Ftuyafree/lists"}