This repo contains the nano firmware flasher tool. It's a .NET Core CLI Global Tool that allows flashing a nanoFramework target with nanoBooter, nanoCLR, managed application or backup files. Is part of nanoFramework toolbox, along with other various tools that are required in nanoFramework development, usage or repository management.
It makes use of several 3rd party tools:
- Espressif esptool. You can find the esptool and licensing information on the repository here.
- ST DfuSe USB. You can find the source, licensing information and documentation here.
- ST-LINK Utility. You can find the source, licensing information and documentation here.
- Texas Instruments Uniflash You can find the Uniflash tool and licensing information here.
Perform a one-time install of the nanoFramework Firmware Flasher tool using the following .NET Core CLI command:
dotnet tool install -g nanoFirmwareFlasherIn case you're installing a pre-release version of the tool you have to specify the version number and the nanoFramework Azure DevOps NuGet feed as the source. Like this:
dotnet tool install -g nanoFirmwareFlasher --version 9.9.9-preview.100 --add-source https://pkgs.dev.azure.com/nanoframework/feed/_packaging/sandbox/nuget/v3/index.jsonAfter a successful installation a message is displayed showing the command that's to be used to call the tool along with the version installed. Similar to the following example:
You can invoke the tool using the following command: nanoff
Tool 'nanofirmwareflasher' (version '9.9.9-preview.100') was successfully installed.To update nanoFramework Firmware Flasher tool use the following .NET Core CLI command:
dotnet tool update -g nanoFirmwareFlasherOnce the tool is installed, you can call it by using its command nanoff, which is a short version of the name to ease typing.
nanoff [command] [args]The tool includes help for all available commands. You can see a list of all available ones by entering:
nanoff --helpTo update the firmware of an ESP32_WROOM_32 target connected to COM31, to the latest available development version.
nanoff --update --target ESP32_WROOM_32 --serialport COM31To deploy a managed application to an ESP32_WROOM_32 target connected to COM31, which has the deployment region at 0x190000 flash address.
Note: The binary file with the deployment image can be found on the Release or Debug folder of a Visual Studio project after a successful build. This file contains everything that's required to deploy a managed application to a target (meaning application executable and all referenced libraries and assemblies).
nanoff --target ESP32_WROOM_32 --serialport COM12 --deploy --image "E:\GitHub\nf-Samples\samples\Blinky\Blinky\bin\Debug\Blinky.bin" --address 0x190000To update the firmware of an ESP32 target connected to COM31, to the latest available development version. You have to specify the path to the managed application. This example uses the binary format file that was saved on a previous backup operation.
nanoff --update --target ESP32_WROOM_32 --serialport COM31 --deployment "c:\eps32-backups\my_awesome_app.bin"To update the firmware of the NETDUINO3_WIFI target to the latest available stable version.
nanoff --update --target NETDUINO3_WIFI --stableTo deploy a managed application to a ST_STM32F769I_DISCOVERY target, which has the deployment region at 0x08080000 flash address and reset the MCU after flashing it.
Note: The binary file with the deployment image can be found on the Release or Debug folder of a Visual Studio project after a successful build. This file contains everything that's required to deploy a managed application to a target (meaning application executable and all referenced libraries and assemblies).
nanoff --target ST_STM32F769I_DISCOVERY --deploy --image "E:\GitHub\nf-Samples\samples\Blinky\Blinky\bin\Debug\Blinky.bin" --address 0x08040000 --resetTo update the firmware of the ST_STM32F769I_DISCOVERY target to the latest available preview version along with a managed application. You have to specify the path to the managed application. This example uses the binary format file that is generated by Visual Studio when building any nanoFramework C# application. Because it's a binary file you have to specify too the flash address of the deployment region (here 0x08000000, mind the hexadecimal format).
nanoff --update --target ST_STM32F769I_DISCOVERY --binfile "c:\dev\my awesome app\bin\debug\my_awesome_app.bin" --address 0x08000000This useful to list all STM32 devices that are connected through JTAG.
nanoff --listjtagThis useful to list all STM32 devices that are connected through DFU.
nanoff --listdfuTo update the firmware of the TI_CC1352R1_LAUNCHXL target to the latest available stable version.
nanoff --update --target TI_CC1352R1_LAUNCHXL --stableTo install the XDS110 USB drivers.
nanoff --platform cc13x2 --installdriversThe tool output verbosity can be set through the v|verbosity option.
This is convenient, for example, if this tool is being used in a automated process where the minimum output is desired to ease processing the return result of the execution. It can be set to:
- q[uiet]
- m[inimal]
- n[ormal]
- d[etailed]
- diag[nostic]
nanoff -v qThe exit codes can be checked in this source file.
To provide feedback, report issues and finding out how to contribute please refer to the Home repo.
Join our Discord community here.
The list of contributors to this project can be found at CONTRIBUTORS.
The nanoFramework firmware flasher tool is licensed under the MIT license.
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community.