KSociety.SharpCubeProgrammer 0.1.70

KSociety.SharpCubeProgrammer Home

KSociety.SharpCubeProgrammer

KSociety.SharpCubeProgrammer is a wrapper for CubeProgrammer_API v2.15.0.

It makes use of several 3rd party tools:

• STM32 Cube Programmer You can find the source, licensing information and documentation here.

Introduction

This is a C# wrapper for STM32 CubeProgrammer_API v2.15.0 (not fully tested). This package does not contain any C/C++ runtimes (MSVC), and is meant to run on Windows operating systems only (for now). Please make sure you have updated the firmware of your ST-LINK V2 / V3, you can do this using STM32CubeProgrammer. The STM32 CubeProgrammer_API is a C-library, created by ST for ST-Link access to micro-controllers for the purpose of flash downloads or general memory access. The ST-Link drivers is required, and can be downloaded from st.com and installed (STSW-LINK009). This has been tested on Windows 10, you don't need to install cubeprogrammer.

KSociety.SharpCubeProgrammer

STM32CubeProgrammer_API C# wrapper, the first wrapper for C#. Any suggestions are welcome.

Get Packages

You can get KSociety.SharpCubeProgrammer by grabbing the latest NuGet package.

Currently supported features

STLINK functions

• GetStLinkList
• GetStLinkEnumerationList
• ConnectStLink
• Reset

Bootloader functions

• GetDfuDeviceList
• ConnectDfuBootloader

General purposes functions

• SetDisplayCallbacks
• SetVerbosityLevel
• CheckDeviceConnection
• GetDeviceGeneralInf
• ReadMemory
• WriteMemory
• EditSector
• DownloadFile
• Execute
• MassErase
• SectorErase
• ReadUnprotect
• TzenRegression (does not exist)
• GetTargetInterfaceType
• GetCancelPointer
• FileOpen
• Verify
• VerifyMemory
• SaveFileToFile
• SaveMemoryToFile
• Disconnect
• DeleteInterfaceList
• AutomaticMode
• GetStorageStructure

Option Bytes functions

• SendOptionBytesCmd
• InitOptionBytesInterface
• FastRomInitOptionBytesInterface
• ObDisplay

Loaders functions

• SetLoadersPath
• SetExternalLoaderPath
• GetExternalLoaders
• RemoveExternalLoader
• DeleteLoaders

STM32WB specific functions

• GetUID64
• FirmwareDelete
• FirmwareUpgrade
• StartWirelessStack
• UpdateAuthKey
• AuthKeyLock
• WriteUserKey
• AntiRollBack
• StartFus
• UnlockChip

STM32MP specific functions

• ProgramSsp

STM32 HSM specific functions

• GetHsmFirmwareID
• GetHsmCounter
• GetHsmState
• GetHsmVersion
• GetHsmType
• GetHsmLicense

Prerequisites

• Visual Studio 2022 (17.8.3 or higher) with the following installed:

Get Started

• Register SharpCubeProgrammer as service with Autofac IoC:

builder.RegisterModule(new KSociety.SharpCubeProgrammer.Bindings.ProgrammerApi());

• Get ST-Link list and connect:

var stLinkList = _cubeProgrammerApi.GetStLinkList();
var stLink = (KSociety.SharpCubeProgrammer.Struct.DebugConnectParameters)stLinkList.First().Clone();
var connectionResult = _cubeProgrammerApi.ConnectStLink(stLink);

• GeneralInfo:

var generalInfo = _cubeProgrammerApi.GetDeviceGeneralInf();

• Erase:

var massErase = _cubeProgrammerApi.MassErase("");

• Flash:

var downloadFile = _cubeProgrammerApi.DownloadFile(firmwarePath, "0x08000000", 1U, 1U);

• Run:

var execute = _cubeProgrammerApi.Execute("0x08000000");

License

The project is under Microsoft Reciprocal License (MS-RL)

Dependencies

List of technologies, frameworks and libraries used for implementation:

• KSociety.Wmi (WMI)