# pyfwimagebuilder - Firmware Image Builder
This utility is used to produce image files which can be used with the pymdfu tool: https://pypi.org/project/pymdfu/
## Overview
* install using pip from pypi: https://pypi.org/project/pyfwimagebuilder
## Usage
pyfwimagebuilder can be used as a command-line interface or a library
### Building an image from the command-line
for help, use:
```bash
pyfwimagebuilder --help
```
Example usage:
Building an image:
```bash
pyfwimagebuilder build -i myapp.hex -c myconfig.toml -o myimage.img
```
Decoding an image:
```bash
pyfwimagebuilder decode -i myapp.img -c myconfig.toml -o myimage.txt
```
### Additional command-line switches
* -v LEVEL for selecting logging verbosity ('debug', 'info', 'warning', 'error', 'critical')
# Changelog
## [1.3.0] - July 2025
- PYTOOLS-158, PYTOOLS-162, PYTOOLS-481: Added image binary decoding
- PYTOOLS-479: Added file format support for Cortex-M0+
- PYTOOLS-163: Added warning for data that is not within the device memory range
- PYTOOLS-492: Fixed segment inclusion to not skip data that is in the valid range when there is data that is outside
## [1.0.0] - December 2023
- Public beta release
## [0.0.1] - October 2023
- Package planning
Raw data
{
"_id": null,
"home_page": null,
"name": "pyfwimagebuilder",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "Microchip, bootloader, PIC, AVR, pymdfu",
"author": null,
"author_email": "Microchip Technology <support@microchip.com>",
"download_url": null,
"platform": null,
"description": "# pyfwimagebuilder - Firmware Image Builder\nThis utility is used to produce image files which can be used with the pymdfu tool: https://pypi.org/project/pymdfu/\n\n\n\n\n\n## Overview\n\n* install using pip from pypi: https://pypi.org/project/pyfwimagebuilder\n\n## Usage\npyfwimagebuilder can be used as a command-line interface or a library\n\n### Building an image from the command-line\nfor help, use:\n```bash\npyfwimagebuilder --help\n```\n\nExample usage:\n\nBuilding an image:\n```bash\npyfwimagebuilder build -i myapp.hex -c myconfig.toml -o myimage.img\n```\n\nDecoding an image:\n```bash\npyfwimagebuilder decode -i myapp.img -c myconfig.toml -o myimage.txt\n```\n\n### Additional command-line switches\n* -v LEVEL for selecting logging verbosity ('debug', 'info', 'warning', 'error', 'critical')\n# Changelog\n\n## [1.3.0] - July 2025\n\n- PYTOOLS-158, PYTOOLS-162, PYTOOLS-481: Added image binary decoding\n- PYTOOLS-479: Added file format support for Cortex-M0+\n- PYTOOLS-163: Added warning for data that is not within the device memory range\n- PYTOOLS-492: Fixed segment inclusion to not skip data that is in the valid range when there is data that is outside\n\n## [1.0.0] - December 2023\n\n- Public beta release\n\n## [0.0.1] - October 2023\n- Package planning\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Firmware image builder for Microchip mdfu bootloaders",
"version": "1.3.0.16",
"project_urls": {
"Homepage": "https://www.microchip.com"
},
"split_keywords": [
"microchip",
" bootloader",
" pic",
" avr",
" pymdfu"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "405a2df3a74d7b37c6ab0c847ae04807298bd680dcc19d2ba911712b7d59c0ec",
"md5": "2563abb913ccae3dc6770ed77309e002",
"sha256": "a891a06a90d4348a2ecb42a5adad1a503e00bb14e12ba4bde8bd3104828b0082"
},
"downloads": -1,
"filename": "pyfwimagebuilder-1.3.0.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2563abb913ccae3dc6770ed77309e002",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 24143,
"upload_time": "2025-07-08T11:25:11",
"upload_time_iso_8601": "2025-07-08T11:25:11.747171Z",
"url": "https://files.pythonhosted.org/packages/40/5a/2df3a74d7b37c6ab0c847ae04807298bd680dcc19d2ba911712b7d59c0ec/pyfwimagebuilder-1.3.0.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-08 11:25:11",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyfwimagebuilder"
}
JSON