{"id":31455335,"url":"https://github.com/ziteh/nrf5-sdk-dev","last_synced_at":"2026-05-19T07:33:54.856Z","repository":{"id":311255651,"uuid":"1043128695","full_name":"ziteh/nrf5-sdk-dev","owner":"ziteh","description":"Nordic nRF5 SDK Docker and Dev Containers (not NCS / Zephyr RTOS)","archived":false,"fork":false,"pushed_at":"2025-08-30T00:50:37.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-29T16:54:20.093Z","etag":null,"topics":["dev-container","docker","nrf52840"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ziteh.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,"zenodo":null}},"created_at":"2025-08-23T07:42:11.000Z","updated_at":"2025-08-30T00:50:40.000Z","dependencies_parsed_at":"2025-08-23T09:29:07.832Z","dependency_job_id":"f190d914-e3d9-44c4-b572-3d1ff3bf4516","html_url":"https://github.com/ziteh/nrf5-sdk-dev","commit_stats":null,"previous_names":["ziteh/nrf5-sdk-dev"],"tags_count":1,"template":true,"template_full_name":null,"purl":"pkg:github/ziteh/nrf5-sdk-dev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziteh%2Fnrf5-sdk-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziteh%2Fnrf5-sdk-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziteh%2Fnrf5-sdk-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziteh%2Fnrf5-sdk-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ziteh","download_url":"https://codeload.github.com/ziteh/nrf5-sdk-dev/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziteh%2Fnrf5-sdk-dev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33206320,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-19T07:16:55.748Z","status":"ssl_error","status_checked_at":"2026-05-19T07:16:54.366Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["dev-container","docker","nrf52840"],"created_at":"2025-10-01T09:55:17.770Z","updated_at":"2026-05-19T07:33:54.824Z","avatar_url":"https://github.com/ziteh.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nRF5 SDK Development Environment\n\nA Docker-based development environment for Nordic nRF5 SDK projects.\n\nAvailable on x86-64 and Apple M-series Arm CPU.\n\n## Getting Started\n\n### Prerequisites\n\nOn the ***host***:\n\n1. **nRF5 SDK**: [Download](https://www.nordicsemi.com/Products/Development-software/nRF5-SDK/Download#infotabs) and extract it to your preferred location, such as `C:/nordic/nRF5_SDK_17.1.0_ddde560`.\n2. **Update SDK Path**: Update the SDK mounting path in `.devcontainer.json` to match the location where you extracted the SDK. For example:\n   ```json\n    \"source=/mnt/c/nordic/nrf5_sdk_17.1.0_ddde560,target=/opt/nrf5-sdk\",\n    // or env\n    \"source=${localEnv:NRF5_SDK_PATH},target=/opt/nrf5-sdk\",\n   ```\n3. **Debugger**: Install either [J-Link](https://www.segger.com/downloads/jlink/) or [OpenOCD](https://openocd.org/).\n4. **Configuration**: Check and modify the values in the [`.env`](./.env) file if necessary.\n\n### GDB Server\n\nStart the GDB server on the ***host***:\n\n```bash\nJLinkGDBServer -device nRF52840_xxAA -if SWD -speed 4000\n```\n\n### Development\n\nIn VS Code, press `Ctrl` + `Shift` + `P`, search for and select `Reopen in Container` to enter the dev container.\n\nOn the ***container***:\n\n```bash\n# Build firmware\nmake\n\n# Clean the build folder\nmake clean\n\n# Flash the firmware\nmake flash\n\n# Erase the device\nmake erase\n\n# Reset the device\nmake reset\n\n# Display help\nmake help\n```\n\nAlternatively, you can use the VS Code Tasks from the menu bar: `Terminal` → `Run Task`.\n\n### Debugging\n\nIn the ***container***, use the `Run and Debug` feature in VS Code. This will connect to the GDB server.\n\n## Docker\n\n### Build the Docker Image\n\nOn the ***host***:\n\n```bash\ndocker build -t nrf5-sdk-dev ./.devcontainer\n# or\npodman build -t nrf5-sdk-dev ./.devcontainer\n```\n\n### Build Firmware on the Host\n\nOn the ***host***:\n\n```bash\npodman run --rm \\\n    -v \"${PWD}:/workspace\" \\\n    -v \"${NRF5_SDK_PATH}:/opt/nrf5-sdk\" \\\n    -w /workspace \\\n    nrf5-sdk-dev \\\n    bash -c \"make clean \u0026\u0026 make\"\n```\n\n## TODO\n\n- [ ] Update the [Arm Ttolchain](https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads) (`arm-gnu-toolchain-14.3.rel1-aarch64-arm-none-eabi.tar.xz` and `arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz`).\n\n## References\n\n- [nRF5 SDK v17.1.0: Introduction](https://docs.nordicsemi.com/bundle/sdk_nrf5_v17.1.0/page/index.html)\n- [J-Link GDB Server Commands](https://kb.segger.com/J-Link_GDB_Server#Supported_remote_(monitor)_commands)\n- [GNU Arm Toolchain](https://developer.arm.com/downloads/-/gnu-rm)\n- [Marus/cortex-debug: Visual Studio Code extension for Cortex-M Microcontrollers](https://github.com/Marus/cortex-debug)\n- [NordicSemiconductor/nRF5-SDK-for-Mesh](https://github.com/NordicSemiconductor/nRF5-SDK-for-Mesh)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziteh%2Fnrf5-sdk-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fziteh%2Fnrf5-sdk-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziteh%2Fnrf5-sdk-dev/lists"}