UniflashProbe Item¶

class UniflashProbe¶: Flash programmer interface for Texas Instruments MCUs.

Inherits:	`Component`
Properties:	`device`, `file`, `installPath` `programmer`, `serial`
Methods:	`flash()`, `waitForFinished()`
Signals:	`finished()`

Detailed Description¶

UniflashProbe provides a convenient interface to Texas Instruments’ Uniflash. It can be used to read from and write to MCUs via a JTAG programmer.

The current state is experimental. Only XDS110 is supported. Since Uniflash doesn’t have a meaningful command line interface, XML config files are hacked together.

Example:

import qst 1.0
import ti 1.0

Testcase {

    UniflashProbe {
        id: uniflash

        installPath: "C:\ti\uniflash_4.2"
        serial: Xds.availableSerials()[0]
        device: "cc1352r1f3"
        file: test.workingDirectory + "/myApp.out"
    }

    void run() {
        uniflash.flash();
        uniflash.waitForFinished(10000);
    }
}

Properties¶

string device¶: The exact MCU type, e.g. cc1310f128, cc1352r1f3. The case doesn’t matter.

string file¶: Path to a binary file to be read out or to be programmed. The file type has to be supported by Uniflash (.out, .bin, .hex).

string installPath¶: Installation directory of Uniflash.

string programmer¶

Default:	XDS110

The JTAG programmer type.

string serial¶: The serial number of the programmer.

Methods¶

void flash()¶

Writes file to a device connected via programmer. Performs a board reset afterwards.

The method returns immediately and the programming process executes in background. When done, the finished() signal is raised.

bool waitForFinished(int milliseconds)¶

Blocks until the current operation has finished and the finished() signal has been emitted, or until milliseconds have passed.

Returns true if the process finished; otherwise returns false (if the operation timed out, if an error occurred, or if this process is already finished).

If milliseconds is -1, this function will not time out.

Signals¶

void finished()¶

This signal is emitted when an operation has finished.