Skip to main content

Command line tool to manipulate microcontroller flash

Project description

ezFlashCLI

Build Status Documentation Status

Command line tools to manage flash devices connected to the Dialog Smartbond™ device family.

The tool relies on Segger J-Link™ library to control the Smartbond SWD interface. The J-Link probe is available on all Smartbond development kits.

Supported platforms

  • macOS
  • Windows 10
  • Linux (tested on ubuntu 20.04LTS 64 bits)

Supported devices

DA145XX

  • DA14531
  • DA14585

Known flash devices:

  • MX25R2035F

DA1459x, DA1468X and DA1469X

  • DA1459x:

    • DA14592
  • DA1468x:

    • DA14680
    • DA14681
    • DA14682
    • DA14683
  • DA1469x:

    • DA14691
    • DA14695
    • DA14697
    • DA14699
  • DA1470x:

    • DA14701
    • DA14705
    • DA14706
    • DA14708

Known flash devices:

  • AT25FF081A
  • AT25FF161A
  • AT25FF321A
  • AT25SL321
  • AT25XE021A
  • EN25S16B
  • EN25S20A
  • GD25LE16
  • GD25LE32
  • IS25WP032
  • MX25R2035F
  • MX25U3235F
  • MX25U6432
  • MX66LM1G45G
  • P25Q11U
  • P25Q32LE
  • P25Q80H
  • W25Q128JW
  • W25Q32JW
  • W25Q64JWIM
  • W25Q80EW
  • W25X10CL
  • W25X20CL
  • W25X40CL

Installation

> pip install ezFlashCLI

Windows: It often happens during python installation that the Script folder is not added in the environment PATH. If ezFLashCLI is not found in your terminal, add <Python install dir>/Scripts to your path.

Usage

List JLink probes

> ezFlashCLI list

INFO:root:ezFlashCLI v1.0.x
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:JLink devices:
INFO:root:  - 483345692
INFO:root:  - 480698727

Probe attached flash

> ezFlashCLI probe

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:Smartbond chip: DA14585/DA14586
INFO:root:Flash information:
INFO:root:  - Device Id: MX25R2035F

Multiple devices

> ezFlashCLI list

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:JLink devices:
INFO:root:  - 483245871
INFO:root:  - 483124587

> ezFlashCLI -j 483245871 probe

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:Smartbond chip: DA1469x
INFO:root:Flash information:
INFO:root:  - Device Id: MX25U3235F

> ezFlashCLI -j 483245871 probe

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:Smartbond chip: DA14682/DA14683
INFO:root:Flash information:
INFO:root:  - Device Id: W25Q80EW

erase Flash

> ezFlashCLI erase_flash

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:Flash erase success

Read Flash

> ezFlashCLI read_flash 0x0 128

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:00000000: 50 70 00 20 00 00 00 20 00 00 eb 00 a5 a8 66 00
INFO:root:00000010: 00 00 aa 11 03 00 01 40 07 c8 4e ff ff ff ff ff

Program Flash

> ezFlashCLI image_flash <path to bin file>

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:[DA1469x] Program image
INFO:root:[DA1469x] Program success

The tool will automatically make the input file bootable if needed

Program Flash and add secondary bootloader

To use SUOTA a secondary bootloader is required. This command adds a precompiled version to the image and writes it all to flash.

> ezFlashCLI image_bootloader_flash <path to bin file>

INFO:root:ezFlashCLI v1.0.X
INFO:root:By using the program you accept the SEGGER J-link™ license
INFO:root:[DA14531] Program image
INFO:root:[DA14531] Program success

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

ezFlashCLI-1.0.28-py3-none-any.whl (81.5 MB view details)

Uploaded Python 3

File details

Details for the file ezFlashCLI-1.0.28-py3-none-any.whl.

File metadata

  • Download URL: ezFlashCLI-1.0.28-py3-none-any.whl
  • Upload date:
  • Size: 81.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for ezFlashCLI-1.0.28-py3-none-any.whl
Algorithm Hash digest
SHA256 61d8ab90c2f792b50d4ae7cce57447595a600bca030fbad3fd975c73a08df232
MD5 b41da55749f21b06d7d25fbedc590bdd
BLAKE2b-256 0b31e02964091afd895e05cb044c9b2e2aa5602d8a24bc0702d6c9000f6335b1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page