Metadata-Version: 2.4
Name: bflb-iot-tool
Version: 1.10.0
Summary: Bouffalolab Iot Tool
Home-page: https://pypi.org/project/bflb-iot-tool/
Author: bouffalolab
Author-email: jxtan@bouffalolab.com
License: MIT
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft
Classifier: Operating System :: Unix
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: toml==0.10.0
Requires-Dist: configobj==5.0.9
Requires-Dist: cryptography==37.0.4
Requires-Dist: pyserial==3.5
Requires-Dist: pylink-square==0.5.0
Requires-Dist: pycklink>=0.1.1
Requires-Dist: portalocker==2.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


## Bouffalolab Iot Command Tool
====================================

The functions of bflb_iot_tool is the same as DevCube(IOT View) which is a GUI tool for image programing.
bflb_iot_tool is designed for the convenience of integrating into the compilation system after image buid,
and making it more easy for users who are accustomed to using command line operations.

### basic download config:

* --chipname：mandatory, name of chip(bl602/bl702/bl616...)
* --interface：1.uart, 2.jlink, 3.cklink, 4.openocd, default is uart
* --port：serial port or jlink serial number
* --baudrate：baudrate of serial port, default is 115200
* --xtal：xtal on the board, for bl602,1:24M,2:32M,3:38.4M,4:40M(default value when not specified),5:26M; for bl702,1:32M(default value when not specified); for bl616,just use value 7(auto adjust)
* --config：eflash loader configuration file, default is chips/blXXXX/eflash_loader/eflash_loader_cfg.ini
* --ota：dir of ota file, default is chips/blXXXX/ota

### files for download:

1.scattered files:
* --firmware：mandatory, select the firmware binary file which your sdk build out
* --dts：optional, select the device tree file you used
* --pt：mandatory, partition table of flash, default is located in chips/chipname/partition
* --boot2：mandatory,boot2 binary file as bootloader, default is located in chips/chipname/builtin_imgs/boot2_isp_xxxxx
* --mfg：optional, mfg binary file, only use when do RF test
* --romfs：optional, romfs dir to create romfs.bin

2.one whole image file:
* --addr：address to program, default is 0
* --single：the single file to be programmed, the tool will add nothing for this file

### other options:

* --build：build image only,not program into flash
* --key：aes encrypt key
* --iv：aes encrypt iv
* --pk：ecc sign public key
* --sk: ecc sign private key

### EXAMPLE:
* bflb_iot_tool.exe --chipname=bl602 --port=COM28 --baudrate=2000000 --firmware="helloworld_bl602.bin" --pt="chips/bl602/partition/partition_cfg_2M.toml" --dts="chips/bl602/device_tree/bl_factory_params_IoTKitA_40M.dts"
* bflb_iot_tool.exe --chipname=bl602 --port=COM28 --baudrate=2000000 --firmware="helloworld_bl602.bin" --pt="chips/bl602/partition/partition_cfg_2M.toml" --dts="chips/bl602/device_tree/bl_factory_params_IoTKitA_40M.dts" --build
* bflb_iot_tool.exe --chipname=bl602 --port=COM28 --baudrate=2000000 --addr=0x0 --firmware="helloworld_bl602.bin" --single
