{"id":19244392,"url":"https://github.com/nanoframework/hex2dfu","last_synced_at":"2025-04-21T09:33:37.570Z","repository":{"id":38328410,"uuid":"192581205","full_name":"nanoframework/hex2dfu","owner":"nanoframework","description":"🛠 hex2dfu tool (nanoFramework toolbox)","archived":false,"fork":false,"pushed_at":"2023-09-14T14:01:34.000Z","size":152,"stargazers_count":9,"open_issues_count":2,"forks_count":9,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-10-29T21:06:14.710Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.nanoframework.net","language":"C#","has_issues":false,"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/nanoframework.png","metadata":{"funding":{"open_collective":"nanoframework","github":"nanoframework"},"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-06-18T17:02:40.000Z","updated_at":"2023-06-27T10:49:05.000Z","dependencies_parsed_at":"2022-08-09T03:00:47.476Z","dependency_job_id":"f400160b-9185-41c8-8908-8e682a03cf29","html_url":"https://github.com/nanoframework/hex2dfu","commit_stats":{"total_commits":34,"total_committers":5,"mean_commits":6.8,"dds":0.2647058823529411,"last_synced_commit":"ae3106c869b5a17e6d58ac865b7e74031b3ae9bb"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoframework%2Fhex2dfu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoframework%2Fhex2dfu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoframework%2Fhex2dfu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoframework%2Fhex2dfu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nanoframework","download_url":"https://codeload.github.com/nanoframework/hex2dfu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247453353,"owners_count":20941247,"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-09T17:23:13.923Z","updated_at":"2025-04-21T09:33:37.550Z","avatar_url":"https://github.com/nanoframework.png","language":"C#","funding_links":["https://opencollective.com/nanoframework","https://github.com/sponsors/nanoframework"],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![#yourfirstpr](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://github.com/nanoframework/Home/blob/main/CONTRIBUTING.md) [![Build Status](https://dev.azure.com/nanoframework/hex2dfu/_apis/build/status/nanoframework.hex2dfu?branchName=main)](https://dev.azure.com/nanoframework/hex2dfu/_build/latest?definitionId=41\u0026branchName=main) [![Discord](https://img.shields.io/discord/478725473862549535.svg)](https://discord.gg/gCyBu8T)\n\n![nanoFramework logo](https://github.com/nanoframework/Home/blob/main/resources/logo/nanoFramework-repo-logo.png)\n\n-----\n\n### Welcome to the **nanoFramework** HEX2DFU tool repository!\n\nThis repo contains the Hex2Dfu tool.\nIt's a .NET 5 console app to convert and/or pack HEX or BIN files in DFU packages (required to update some target boards).\nIt's part of **nanoFramework** toolbox, along with other various tools that are required in **nanoFramework** development, usage or repository management.\nThere are prebuilt versions for Win64 and Linux.\n\n## Usage\n\n### Create a DFU file from a single hex file\n\nTo create a DFU package from a single hex file use the following command line:\n\n```cmd\nhex2dfu -h=hex_file_name -o=output_DFU_image_file_name\n\n```\n\n### Create a DFU file from one or more bin files\n\nTo create a DFU package from one (or more) bin files use the following command line:\n\n```cmd\nhex2dfu -b=bin_file_name -a=hex_address_to_flash [-b=bin_file_name_N -a=hex_address_to_flash_N] -o=output_DFU_image_file_name\n\n```\n\n### Optional parameters\n\nThe following parameters are available and are optional.\n\n#### Set the VID of target USB device\n\nAllows setting the VID of the USB device. Hexadecimal format. If not specified the STM default will be used. Usually used in conjunction with PID.\n\n```cmd\nhex2dfu -h=hex_file_name -o=output_DFU_image_file_name [-v=\"0000\"]\n\n```\n\n#### Set the PID of target USB device\n\nAllows setting the PID of the USB device. Hexadecimal format. If not specified the STM default will be used. Usually used in conjunction with VID.\n\n```cmd\nhex2dfu -h=hex_file_name -o=output_DFU_image_file_name [-p=\"0000\"]\n\n```\n\n#### Set the firmware version of the target device\n\nAllows setting the firmware version of the target device. Hexadecimal format. If not specified the STM default will be used. Can be used by the DFU tool to check for a valid device to update.\n\n```cmd\nhex2dfu -h=hex_file_name -o=output_DFU_image_file_name [-f=\"\"0000\"\"]\n\n```\n\n## Feedback and documentation\n\nFor documentation, providing feedback, issues and finding out how to contribute please refer to the [Home repo](https://github.com/nanoframework/Home).\n\nJoin our Discord community [here](https://discord.gg/gCyBu8T).\n\n## Credits\n\nThe list of contributors to this project can be found at [CONTRIBUTORS](https://github.com/nanoframework/Home/blob/main/CONTRIBUTORS.md).\n\n## License\n\nThe **nanoFramework** HEX2DFU tool is licensed under the [MIT license](https://opensource.org/licenses/MIT).\n\n## Code of Conduct\nThis project has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/)\nto clarify expected behavior in our community.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnanoframework%2Fhex2dfu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnanoframework%2Fhex2dfu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnanoframework%2Fhex2dfu/lists"}