| Name | vfs-merge JSON |
| Version |
0.1.2
JSON |
| download |
| home_page | None |
| Summary | Merge a MicroPython firmware and with source files into a single binary that can be flashed to a device. |
| upload_time | 2024-05-08 06:20:58 |
| maintainer | None |
| docs_url | None |
| author | Jos Verlinde |
| requires_python | <4.0,>=3.8 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# vfs_merge
Merge a MicroPython firmware and with source files into a single binary that can be flashed to a device.
Merge
- the files in `src/**/*`
- with the firmware in `firmware/<firmware.bin/uf2>`
and write the resulting firmware image to :
- `build/firmware.bin` or `build/firmware.uf2`:
## Esp32
`vfsmerge --port esp32 --firmware ./firmware`
``` log
INFO | Micropython Port: esp32
INFO | Source folder path: src
INFO | Firmware path: firmware\ESP32_GENERIC-20231005-v1.21.0.bin
INFO | Build path: build
INFO | Create littlefs image: build\littlefs.img
DEBUG | Create new filesystem with: 512 blocks of 4096 bytes = 2048Kb
INFO | Add files from src
DEBUG | Adding /foo.py
DEBUG | Adding /main.py
DEBUG | Adding /lib/bar.py
DEBUG | write filesystem to build\littlefs.img
INFO | Merge firmware and littlefs image into build\firmware_lfs.bin
DEBUG | running: esptool --chip esp32 merge_bin -o build\firmware_lfs.bin --flash_mode dio --flash_size 4MB 0x1000 firmware\ESP32_GENERIC-20231005-v1.21.0.bin 0x00200000 build\littlefs.img
esptool.py v4.6.2
Wrote 0x400000 bytes to file build\firmware_lfs.bin, ready to flash to offset 0x0
```
## RP2 Pico_W
`vfsmerge --port rp2-pico_w --firmware .\firmware\rp2-pico-w-20230426-v1.20.0.uf2`
``` log
INFO | Micropython Port: rp2-pico_w
INFO | Source folder path: src
INFO | Firmware path: firmware\rp2-pico-w-20230426-v1.20.0.uf2
INFO | Build path: build
INFO | Create littlefs image: build\littlefs.img
DEBUG | Create new filesystem with: 212 blocks of 4096 bytes = 848Kb
INFO | Add files from src
DEBUG | Adding /foo.py
DEBUG | Adding /main.py
DEBUG | Adding /lib/bar.py
DEBUG | write filesystem to build\littlefs.img
DEBUG | Running D:\MyPython\vfs_merge\vfs_merge\picotool info -a firmware\rp2-pico-w-20230426-v1.20.0.uf2
DEBUG | Number of blocks: 2736
Program name: MicroPython
Board: pico_w
Number of families: 1
- Family RP2040 at 0x1000_0000
Number of ranges: 1
- Range 0: 0x1000_0000 - 0x100A_B000
LittleFS superblocks: 0
Pico drive info
- Drive start: 0x1012_C000
- Drive end: 0x1020_0000
INFO | Reading littlefs binary image from build\littlefs.img
DEBUG | Extend uf2 with: 3392 blocks
DEBUG | LittleFS image size: 3392 blocks
INFO | Writing 3392 blocks to littlefs.uf2
INFO | > Found LittleFS file system header in block 2736 at 0x1012_C000
INFO | > Found LittleFS file system header in block 2752 at 0x1012_D000
DEBUG | Writing 6128 blocks to build\firmware_lfs.uf2
DEBUG | Number of blocks: 6128
Program name: MicroPython
Board: pico_w
Number of families: 1
- Family RP2040 at 0x1000_0000
Number of ranges: 2
- Range 0: 0x1000_0000 - 0x100A_B000
- Range 1: 0x1012_C000 - 0x1020_0000
LittleFS superblocks: 2
- LittleFS superblock 0: block 2736 at 0x1012_C000
- LittleFS superblock 1: block 2752 at 0x1012_D000
Pico drive info
- Drive start: 0x1012_C000
- Drive end: 0x1020_0000
```
Raw data
{
"_id": null,
"home_page": null,
"name": "vfs-merge",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Jos Verlinde",
"author_email": "jos_verlinde@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/dc/86/e1a80379225c41ab36d0d2bb8c5bf9559a52da7fb997d56ad8b9e764328f/vfs_merge-0.1.2.tar.gz",
"platform": null,
"description": "# vfs_merge\nMerge a MicroPython firmware and with source files into a single binary that can be flashed to a device.\n\n\nMerge \n - the files in `src/**/*` \n - with the firmware in `firmware/<firmware.bin/uf2>` \n \n and write the resulting firmware image to : \n - `build/firmware.bin` or `build/firmware.uf2`:\n\n## Esp32 \n`vfsmerge --port esp32 --firmware ./firmware`\n``` log\n\n\nINFO | Micropython Port: esp32\nINFO | Source folder path: src\nINFO | Firmware path: firmware\\ESP32_GENERIC-20231005-v1.21.0.bin\nINFO | Build path: build\nINFO | Create littlefs image: build\\littlefs.img\nDEBUG | Create new filesystem with: 512 blocks of 4096 bytes = 2048Kb\nINFO | Add files from src\nDEBUG | Adding /foo.py\nDEBUG | Adding /main.py\nDEBUG | Adding /lib/bar.py\nDEBUG | write filesystem to build\\littlefs.img\nINFO | Merge firmware and littlefs image into build\\firmware_lfs.bin\nDEBUG | running: esptool --chip esp32 merge_bin -o build\\firmware_lfs.bin --flash_mode dio --flash_size 4MB 0x1000 firmware\\ESP32_GENERIC-20231005-v1.21.0.bin 0x00200000 build\\littlefs.img\nesptool.py v4.6.2\nWrote 0x400000 bytes to file build\\firmware_lfs.bin, ready to flash to offset 0x0\n```\n\n## RP2 Pico_W\n`vfsmerge --port rp2-pico_w --firmware .\\firmware\\rp2-pico-w-20230426-v1.20.0.uf2`\n\n``` log\n\nINFO | Micropython Port: rp2-pico_w\nINFO | Source folder path: src\nINFO | Firmware path: firmware\\rp2-pico-w-20230426-v1.20.0.uf2\nINFO | Build path: build\nINFO | Create littlefs image: build\\littlefs.img\nDEBUG | Create new filesystem with: 212 blocks of 4096 bytes = 848Kb\nINFO | Add files from src\nDEBUG | Adding /foo.py\nDEBUG | Adding /main.py\nDEBUG | Adding /lib/bar.py\nDEBUG | write filesystem to build\\littlefs.img\nDEBUG | Running D:\\MyPython\\vfs_merge\\vfs_merge\\picotool info -a firmware\\rp2-pico-w-20230426-v1.20.0.uf2\nDEBUG | Number of blocks: 2736\nProgram name: MicroPython\nBoard: pico_w\nNumber of families: 1\n - Family RP2040 at 0x1000_0000\nNumber of ranges: 1\n - Range 0: 0x1000_0000 - 0x100A_B000\nLittleFS superblocks: 0\nPico drive info\n - Drive start: 0x1012_C000\n - Drive end: 0x1020_0000\n\nINFO | Reading littlefs binary image from build\\littlefs.img\nDEBUG | Extend uf2 with: 3392 blocks\nDEBUG | LittleFS image size: 3392 blocks\nINFO | Writing 3392 blocks to littlefs.uf2\nINFO | > Found LittleFS file system header in block 2736 at 0x1012_C000\nINFO | > Found LittleFS file system header in block 2752 at 0x1012_D000\nDEBUG | Writing 6128 blocks to build\\firmware_lfs.uf2\nDEBUG | Number of blocks: 6128\nProgram name: MicroPython\nBoard: pico_w\nNumber of families: 1\n - Family RP2040 at 0x1000_0000\nNumber of ranges: 2\n - Range 0: 0x1000_0000 - 0x100A_B000\n - Range 1: 0x1012_C000 - 0x1020_0000\nLittleFS superblocks: 2\n - LittleFS superblock 0: block 2736 at 0x1012_C000\n - LittleFS superblock 1: block 2752 at 0x1012_D000\nPico drive info\n - Drive start: 0x1012_C000\n - Drive end: 0x1020_0000\n\n```",
"bugtrack_url": null,
"license": "MIT",
"summary": "Merge a MicroPython firmware and with source files into a single binary that can be flashed to a device.",
"version": "0.1.2",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3cfbe3b4413dd85e265230213e863961dd5c7661d437afc9beb75b2a0b20a304",
"md5": "b6f0d8136e92587f813b825fbe706de7",
"sha256": "8663a4ce8fc2f0ebbd962f11e6d6455e5a80dd76668088a974cc55093230868a"
},
"downloads": -1,
"filename": "vfs_merge-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b6f0d8136e92587f813b825fbe706de7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 810987,
"upload_time": "2024-05-08T06:20:53",
"upload_time_iso_8601": "2024-05-08T06:20:53.273392Z",
"url": "https://files.pythonhosted.org/packages/3c/fb/e3b4413dd85e265230213e863961dd5c7661d437afc9beb75b2a0b20a304/vfs_merge-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dc86e1a80379225c41ab36d0d2bb8c5bf9559a52da7fb997d56ad8b9e764328f",
"md5": "635c66101e6872f43d268849cc8429e6",
"sha256": "d08758b7f3bbe8cfb3ec21c9af0ea02eb1c15e382d0f935335bac700de83e268"
},
"downloads": -1,
"filename": "vfs_merge-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "635c66101e6872f43d268849cc8429e6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 805341,
"upload_time": "2024-05-08T06:20:58",
"upload_time_iso_8601": "2024-05-08T06:20:58.203473Z",
"url": "https://files.pythonhosted.org/packages/dc/86/e1a80379225c41ab36d0d2bb8c5bf9559a52da7fb997d56ad8b9e764328f/vfs_merge-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-08 06:20:58",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "vfs-merge"
}
