{"id":19640004,"url":"https://github.com/openthread/ot-reference-release","last_synced_at":"2025-04-28T11:31:01.066Z","repository":{"id":37958117,"uuid":"366094817","full_name":"openthread/ot-reference-release","owner":"openthread","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-23T23:42:36.000Z","size":2752,"stargazers_count":11,"open_issues_count":4,"forks_count":27,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-04-24T00:29:36.022Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openthread.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.txt","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,"zenodo":null}},"created_at":"2021-05-10T15:43:39.000Z","updated_at":"2025-04-23T23:42:40.000Z","dependencies_parsed_at":"2024-08-06T00:17:17.803Z","dependency_job_id":"9fdacfdb-7fb2-4a56-8547-9502ecd3c0a7","html_url":"https://github.com/openthread/ot-reference-release","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/openthread%2Fot-reference-release","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openthread%2Fot-reference-release/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openthread%2Fot-reference-release/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openthread%2Fot-reference-release/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openthread","download_url":"https://codeload.github.com/openthread/ot-reference-release/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251304747,"owners_count":21567927,"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":[],"created_at":"2024-11-11T14:04:14.830Z","updated_at":"2025-04-28T11:31:01.057Z","avatar_url":"https://github.com/openthread.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ot-reference-release\n\n## Usage\n\nClone this repository:\n\n```\n$ git clone https://github.com/openthread/ot-reference-release\n```\n\nInitialize the submodules:\n\n```\n$ git submodule update --init --recursive\n```\n\nAt the root of the repository:\n\n```\n$ REFERENCE_PLATFORM=(nrf52840|efr32mg12|ncs|none) REFERENCE_RELEASE_TYPE=(1.2|1.3|1.3.1)  [SD_CARD=/dev/...] [OTBR_RCP_BUS=(UART|SPI)] [IN_CHINA=(0|1)] [OTBR_RADIO_URL='spinel+hdlc+uart:///dev/ttyUSB0'] [OPENTHREAD_COMMIT_HASH=c9c19aa9fa5877cf1532c35a584618900e5c99c7] ./script/make-reference-release.bash\n```\n\nThis will produce a reference release folder in `./build/`. The folder will be\nnamed after the release type, date and the OpenThread commit id.\n\n`SD_CARD` is expected to be the device file path of an SD card inserted to\nthe host. If this variable is specified, the script will flash the Raspberry Pi\nimage containing OpenThread border router service to the SD card.\n\nIf `IN_CHINA` is set to 1, the script will prefer to use apt sources based in\nChina so that you can save time while installing software dependencies.\n\n`OTBR_RCP_BUS` sets the RCP hardware interface type of Spinel on otbr-agent.\nIf this variable is not specified, the interface type is set to `UART` by default.\n\n`OTBR_RADIO_URL` sets the otbr-agent's radio URL. If this variable is not specified,\nthe otbr-agent's argument is set to `spinel+hdlc+uart:///dev/ttyACM0` by default.\n\n`OPENTHREAD_COMMIT_HASH` sets custom openthread commit SHA for NCS builds.\n\nFor example, if you are in China and want to flash the built image to an SD card:\n\n```\n$ REFERENCE_PLATFORM=nrf52840 REFERENCE_RELEASE_TYPE=1.2 IN_CHINA=1 SD_CARD=/dev/sda ./script/make-reference-release.bash\n```\n\nWhen `REFERENCE_RELEASE_TYPE` is `1.2`, reference release contains following components:\n- Raspberry Pi image containing OTBR service and OT Commissioner\n- Firmware\n- THCI\n- Change log\n- Quick start guide\n\nWhen `REFERENCE_RELEASE_TYPE` is `1.3` or `1.3.1`, reference release contains following components:\n- Raspberry Pi image containing OTBR service with border routing feature, service registry feature and OT Commissioner\n- Firmware\n- Change log\n- Quick start guide\n\n**Note**: Currently, only the following boards are supported for CLI/RCP firmwares:\n\n- nRF52840 dongles\n- EFR32MG12 BRD4166A boards\n\nIf the `REFERENCE_PLATFORM` is set to `none`, the firmware won't be generated.\n\n# Contributing\n\nWe would love for you to contribute to OpenThread and help make it even better than it is today! See our [Contributing Guidelines](https://github.com/openthread/openthread/blob/main/CONTRIBUTING.md) for more information.\n\nContributors are required to abide by our [Code of Conduct](https://github.com/openthread/openthread/blob/main/CODE_OF_CONDUCT.md) and [Coding Conventions and Style Guide](https://github.com/openthread/openthread/blob/main/STYLE_GUIDE.md).\n\n# License\n\nOpenThread is released under the [BSD 3-Clause license](https://github.com/openthread/ot-reference-release/blob/main/LICENSE). See the [`LICENSE`](https://github.com/openthread/ot-reference-release/blob/main/LICENSE) file for more information.\n\nPlease only use the OpenThread name and marks when accurately referencing this software distribution. Do not use the marks in a way that suggests you are endorsed by or otherwise affiliated with Nest, Google, or The Thread Group.\n\n# Need help?\n\nOpenThread support is available on GitHub:\n\n- Bugs and feature requests pertaining to the Reference Release — [submit to the openthread/ot-reference-release Issue Tracker](https://github.com/openthread/ot-reference-release/issues)\n- OpenThread bugs and feature requests — [submit to the OpenThread Issue Tracker](https://github.com/openthread/openthread/issues)\n- Community Discussion - [ask questions, share ideas, and engage with other community members](https://github.com/openthread/openthread/discussions)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenthread%2Fot-reference-release","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenthread%2Fot-reference-release","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenthread%2Fot-reference-release/lists"}