Frequently asked questions about FlashRunner 2.0
These answers apply to FlashRunner 2.0 and are grouped by task. If yours is not here, just ask us.
Getting started and connection
Connecting for the first time, reading the status LEDs, and where to get help.
How do I connect to FlashRunner 2.0 for the first time?
Use the connect button at the top left of the Workbench GUI.
- LAN: the default IP address is
192.168.1.100. Check the connection settings under Tools -> Settings. - USB: in the Windows Device Manager, look under Ports for the programmer’s COM port and connect through that port.
What do the LEDs show, and how can I read their status?
FlashRunner 2.0 has a set of status LEDs:
- One LED shows that the programmer is powered.
- Each channel has its own two-colour LED: green is PASS, red is FAIL.
- One general LED shows that the programmer is busy, that is, at least one channel is executing a command.
The GETENGSTATUS command returns the status of the LEDs.
Where can I get technical support for FlashRunner 2.0?
Contact us using the details in the contact section at the bottom of this page.
The R&D department of SMH Technologies has a support team with full knowledge of every device currently supported and of the whole product range.
Projects and programming data
Running a project, data formats, variable data such as serial numbers, and data encryption.
How do I run a project, whether it was delivered with a development service or is a new one?
- Open the
.prjfile with the Open Project button in the button panel on the left of the GUI. The GUI switches to the Production Tab view automatically. - Click Run to start programming.
- To follow the real-time log, click the RealTimeLog button in the same panel.
Use the PinMap feature in the Tool menu to double-check the connections.
A project can be set up for all channels, even with different devices on different channels, and run by sending a single command through the API.
Which data formats can FlashRunner 2.0 program, and where is the data stored?
FlashRunner 2.0 only reads data in its own proprietary format, FRB (.frb files). You create the FRB file from one source file or a combination of several, for example raw binary, Intel HEX or Motorola S-record.
Before programming starts, the FRB, driver, project and licence files are copied once to the programmer’s storage memory. After the FRB has been read for the first time, its data is held in the programmer’s RAM.
How do I program different firmware on the same device, for example a test firmware first and the application later?
Create two projects, one for each firmware: for example, one project that programs the test firmware and one that programs the main application firmware.
How do I program variable data, such as serial numbers or security keys?
Use the serial numbering feature. It is based on the programmer’s built-in dynamic memory and lets you define, with a command, arbitrary data to be programmed during the programming operation. It is a two-step procedure:
- When you create the FRB, reserve an area for variable data.
- During execution, send the
DYNMEMSETcommand to define the variable data to be programmed.
To clear the data set in the dynamic memory area, use DYNMEMCLEAR.
Can programming data be stored and transferred securely?
Yes. FlashRunner 2.0 can encrypt FRB files, the files that contain all the data to be programmed. Once encrypted, an FRB file can only be read back by the programmer itself, during programming.
Where is the encryption passphrase stored, and how is it used?
The encryption uses AES with a fixed passphrase. The passphrase is hard-coded in the GUI, for encoding, and in the FlashRunner operating system, for decoding. As a result, once data has been encoded, only the programmer can read it back, while it runs scripts.
Reading, verification and troubleshooting
Reading back and comparing device content, finding the cause of an error, and a common command syntax mistake.
How can I read back the flash content and compare it byte by byte?
If the device allows its flash content to be read, the READ and DUMP commands are implemented:
READprints the selected area in the terminal.DUMPsaves the selected area to a binary file. Files from different channels are told apart by the prefix of the file name (for exampleS01_,S02_).
For a byte-by-byte comparison, use the VERIFY READOUT method, which compares the original source file with the programmed flash area.
Some devices also provide a MARGIN VERIFY command, which checks that the programmed content meets quality standards and will remain stable over the years.
How do I find out why a command failed, and can I abort a command?
The SGETERR command walks through the error stack and shows the whole stack of functions that generated the error. There is also a real-time log (RealTimeLog) with increasing levels of verbosity. Both the error stack and the log file can be retrieved through API calls.
A command cannot be aborted. However, whenever a failure occurs, the drivers return the programmer to its initial state.
Why does a command like TPCMD READ F $0 $10 return an error?
The FlashRunner 2.0 operating system does not accept the $ syntax. Use 0x or 0X instead, for example:
TPCMD READ F 0x0 0x10
Production integration and automation
GUI or API, controlling the programmer from your own test software, and several programmers on one host.
What do I need the GUI for, and what can I do through the API?
Every command can be sent to FlashRunner 2.0 both from the GUI and through the API, and the API gives you complete control of the programmer. The GUI is only needed to create a new project and its FRB file.
How can I control FlashRunner 2.0 from external software, such as my own test software?
FlashRunner comes with a DLL library that gives your test software complete control of the programmer. Through it you can send commands that start a project and, of course, send any single command.
Which interfaces does FlashRunner 2.0 have, and how many programmers can one host address?
FlashRunner 2.0 can be connected through USB, LAN (Ethernet) and the control connector.
There is no limit to the number of programmers: they only need to be in the same subnet, each with a different IP address. Every programmer also has a unique serial number, which you can read with the SGETSN command.
Device support and licences
Checking which devices are supported, requesting a new device, updating the device list, and licence types.
Which microcontrollers does FlashRunner 2.0 support, and how long does it take to add a new device?
Search the Device list on this site. To request support for a new microcontroller or memory, contact us.
After receiving a device development request, the R&D team of SMH Technologies evaluates the effort, based on the devices already supported, and gives the best possible delivery date. Developing support for a device takes from a few days up to more than a month for the most complex architectures.
How do I update the device list in the GUI?
Install the latest Workbench setup, available from the Software downloads on the support page.
Which licence types are available for FlashRunner 2.0?
- Single licence for one device
- Full family licence package
- All licences
- Shared licences: a target device licence can be bound to more than one FlashRunner 2.0 serial number.
For further information, contact our sales team.
Software updates and versions
Updating the operating system and the FPGA, checking versions, and how the internal software is structured.
How do I update the FlashRunner 2.0 operating system?
- Download the official operating system update,
update_3_xx.tgz, from the Software downloads on the support page. - Copy
update_3_xx.tgzto the programmer’sDriverfolder with the Advanced File Manager tool in the GUI. Do not extract it. - Restart the programmer to install the update.
If update_3_xx.tgz has disappeared from the Driver folder, the operating system has been updated successfully.
How do I update the FlashRunner 2.0 FPGA?
- Contact us and we will send you an
update.tgzfile. - Copy it to the
Driverfolder with the Advanced File Manager tool in the GUI. - Restart the programmer twice to install the update.
If update.tgz has disappeared from the Driver folder, the FPGA has been updated successfully.
Which commands show the operating system and driver versions?
SGETVERreturns the operating system version.SGETVERALGOLISTreturns the driver versions.
How is the FlashRunner 2.0 software structured internally?
The main application of FlashRunner 2.0 runs on Linux. At run time it loads the algorithms, which FlashRunner 2.0 calls drivers. Technically, drivers are shared libraries.
Each driver contains all the routines needed to program a device’s flash, plus device-specific commands that can be called through the API or included in a project. For this reason, each driver covers a specific set of devices. All device-related commands are implemented in the drivers; generic commands are implemented in the main application.
Power supply and isolation
Powering the programmer and the board under test, external supplies, and galvanic isolation.
Which power supply does FlashRunner 2.0 need?
FlashRunner 2.0 comes with a 15 V power supply unit, its standard operating voltage. A 12 V supply also works, but the maximum voltage of VPROG1 is then reduced to 10.5 V.
Can FlashRunner 2.0 power the board under test, and in which range? Can I use an external supply?
Each programming channel has two power supplies:
| Supply | Use | Range | Max. current |
|---|---|---|---|
| VPROG0 | Powers the device and sets the reference level of the digital signals | 1.65–5.5 V | 250 mA |
| VPROG1 | Can power the entire board | 6–13.5 V | 200 mA |
These commands help:
TESTVPROGsets a defined value on the VPROG lines.GETVPROGreturns the measured value of the selected VPROG line, in mV.
You can use an external power supply, but we advise against using the FlashRunner 2.0 supply and an external supply together.
Is there galvanic isolation between the power supply and the output pins?
Yes. The FlashRunner 2.0 power supply is galvanically isolated from the digital output pins, and both host interfaces, USB and LAN, are opto-isolated.
Channels, memory and specifications
Number of channels and upgrades, RAM and SD card size, and calibration.
How many independent channels does FlashRunner 2.0 have?
Up to 16. With a demultiplexer, FlashRunner 2.0 can program up to 32 devices.
Can I add channels to my FlashRunner 2.0 later?
It depends on the model:
- FR2P0-CH4 can be upgraded by software from 4 to 8 channels (FR2P0-UPG08).
- FR2P0-CH12 can be upgraded by software from 12 to 16 channels (FR2P0-UPG16).
- FR2P0-CH8 cannot be upgraded to 12 or 16 channels, because its hardware configuration is different.
How much RAM and SD card storage does FlashRunner 2.0 have?
FlashRunner 2.0 has 1 GB of on-board RAM. A small part is used by the operating system; most of it holds FRB files temporarily. If the RAM runs out, the operating system loads the data directly from the storage memory.
The built-in SD card is 2 GB by default and can be increased up to 256 GB. It stores the FRB, driver, project and licence files.
Does FlashRunner 2.0 need to be calibrated at regular intervals?
No, it is not necessary.
No question matches this keyword. Try another one, or contact us directly.
Contact us →