Specifications written in this document are believed to be accurate, but are not guaranteed to
be entirely free of error. The information in this manual is subject to change for functional or
performance improvements without notice. Please make sure your manual is the latest edition.
While the information herein is assumed to be accurate, SEGGER Microcontroller GmbH (SEGGER) assumes no responsibility for any errors or omissions. SEGGER makes and you receive no
warranties or conditions, express, implied, statutory or in any communication with you. SEGGER
specifically disclaims any implied warranty of merchantability or fitness for a particular purpose.
Copyright notice
You may not extract portions of this manual or modify the PDF file in any way without the prior
written permission of SEGGER. The software described in this document is furnished under a
license and may only be used or copied in accordance with the terms of such a license.
This manual describes the Flasher device. For further information on topics or routines not yet
specified, please contact us.
Print date: May 9, 2019
Manual
version
6.360190509MF
6.343190221MF
6.342180205AB
6.322180205AB
6.301180222AG
6.201171130AB
6.200171121AB
6.10a0160922EL
6.000160715NG
5.12e0160511NG
5.02f0151023RH
5.02e0151021EL
5.02f0151014RH
4.50c0150611EL
4.980150205AG
4.860140610AG
4.801131220AG
4.800131031EL
4.780130917AG
4.720130612EL
4.64a0130226EL
4.63a0130131EL
RevisionDateByDescription
added Portable PLUS specific section in multiple-file chapter for clarification
updated chapter Batch Programming in stand-alone mode
Removed all Flasher ATE related topics.
* Content has been moved to UM08035_FlasherATE.pdf
Chapter “Hardware”
* Added safety disclaimer for JTAG isolator
Chapter “Working with Flasher”
* Added STM8 support to universal flash loader.
Chapter “Working with Flasher”
* Section “Custom labels” added.
This document assumes that you already have a solid knowledge of the following:
•The software tools used for building your application (assembler, linker, C compiler).
•The C programming language.
•The target processor.
•DOS command line.
If you feel that your knowledge of C is not sufficient, we recommend The C Programming Lan-guage by Kernighan and Richie (ISBN 0–13–1103628), which describes the standard in C programming and, in newer editions, also covers the ANSI C standard.
How to use this manual
This manual explains all the functions and macros that the product offers. It assumes you have
a working knowledge of the C language. Knowledge of assembly programming is not required.
Typographic conventions for syntax
This manual uses the following typographic conventions:
StyleUsed for
BodyBody text.
Keyword
ParameterParameters in API functions.
SampleSample code in program examples.
Sample commentComments in program examples.
Reference
GUIElementButtons, dialog boxes, menu names, menu commands.
EmphasisVery important sections.
Text that you enter at the command prompt or that appears on
the display (that is system functions, file- or pathnames).
Reference to chapters, sections, tables and figures or other documents.
Flasher is a programming tool for microcontrollers with on-chip or external flash memory.
Flasher is designed for programming flash targets with the J-Flash software or stand-alone.
In addition to that Flasher can also be used as a regular J-Link. For more information about
J-Link in general, please refer to the J-Link / J-Trace User Guide which can be downloaded
at http://www.segger.com.
Flasher connects to a PC using the USB/Ethernet/RS232 interface (what host interfaces are
available depends on the Flasher model), running Microsoft Windows 2000, Windows XP,
Windows 2003, Windows Vista, Windows 7 or Windows 8. In stand-alone mode, Flasher can
be driven by the start/stop button, or via the RS232 interface (handshake control or ASCII
interface). Flasher always has a 20-pin connector, which target interfaces are supported
depends on the Flasher model:
•Flasher ARM: JTAG and SWD are supported.
•Flasher RX: JTAG is supported. Flasher comes with additional 14-pin RX adapter
•Flasher PPC: JTAG is supported. Flasher comes with additional 14-pin PPC adapter.
Ethernet and RS232 as host interface are not available for Flasher Portable
Note
*As a legitimate owner of a SEGGER Flasher, you can always download the latest
software free of charge. Though not planned and not likely, we reserve the right to
change this policy. Note that older models may not be supported by newer versions
of the software. Typically, we support older models with new software at least 3 years
after end of life
The Flasher can operate from a PC with an appropriate software like J-Flash or in standalone mode.
Host System
IBM PC/AT or compatible CPU: 486 (or better) with at least 128MB of RAM, running Microsoft
Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 7 or Windows 8. It
needs to have a USB, Ethernet or RS232 interface available for communication with Flasher.
Power supply
Flasher Portable: 3x standard AAA batteries or 5V DC, min. 100 mA via USB connector.
Flasher Portable PLUS: internal rechargeable 680mAh Li-Ion battery, min. 100 mA via USB
connector.
Other Flashers: 5V DC, min. 100 mA via USB connector.
Installing Flasher PC-software (J-Flash)
The latest version of the J-Flash software, which is part of the J-Link software and documentation package, can always be downloaded from our website:
https://www.segger.com/jlink-software.html For more information about using J-Flash
please refer to UM08003_JFlashARM.pdf (J-Flash user guide) which is also available for
download on our website.
Microsoft Windows 2000
Microsoft Windows XP
Microsoft Windows XP x64
Microsoft Windows 2003
Microsoft Windows 2003 x64
Microsoft Windows Vista
Supported OS
Operating Temperature
Storage Temperature-20 °C … +45 °C
Relative Humidity (non-condensing)<90% rH
Power Supply
Charging via USB70 minutes (at 1A charging current)
Mechanical
Size (without cables)126mm x 70mm x 28mm
Weight (without cables)140g
Available interfaces
USB Host interfaceUSB 2.0
Target interface
Target Interface, Electrical
Target interface voltage (VIF)1.2 … 5V
Target supply voltage
Target supply currentmax. 400mA
Reset TypeOpen drain. Can be pulled low or tristated
Reset low level output voltage (VOL)VOL ≤ 10% of VIF
For the whole target voltage range (1.8V ≤ VIF ≤ 5V)
LOW level input voltage (VIL)VIL ≤ 40% of VIF
HIGH level input voltage (VIH)VIH ≥ 60% of VIF
For 1.8V ≤ VIF ≤ 3.6V
LOW level output voltage (VOL) with a load
of 10 kOhm
HIGH level output voltage (VOH) with a
load of 10 kOhm
For 3.6 ≤ VIF ≤ 5V
Microsoft Windows Vista x64
Microsoft Windows 7
Microsoft Windows 7 x64
Microsoft Windows 8
Microsoft Windows 8 x64
Microsoft Windows 10
Microsoft Windows 10 x64
+5 °C … +60 °C (normal operation)
+5 °C … +45 °C (battery charging)
a) USB powered, 100mA for Flasher
Portable PLUS. 500 mA if target is powered
by Flasher Portable PLUS
b) Rechargeable 680mAh Li-Ion battery
(Sony US14500VR)
Standard 20-pin 0.1“ connector (Adapters
available).
Supply voltage is 4.5V, max. (depends on
the current battery voltage).
The Flasher Portable PLUS is a portable version of SEGGERs Flasher family, which has been
designed to fill the need of an extremely portable, production grade, Flash programmer
used for in-field firmware updates. No need to be tethered to an outlet, it is powered by
an integrated Li-Ion cell (680mAh). The Flasher Portable PLUS programs flash targets in
stand-alone mode or via J-Flash PC software.
Furthermore the Flasher Portable PLUS allows the user to select between eight data images
to be programmed. The images can be easily selected by using the SEL button on the front
of the housing. For more information about support for multiple images, please refer to
Multiple File Support on page 52.
For setup and configuration purposes, the Flasher Portable PLUS connects to a PC via USB
interface, running Microsoft Windows 2000, Windows XP, Windows 2003, Windows Vista,
Windows 7, Windows 8 or Windows 10 and has a built-in standard 20-pin J-Link target
connector.
Note
Ethernet and RS232 as host interface are not available for the Flasher Portable PLUS.
2.1.1 Housing & Buttons
The Flasher Portable PLUS comes with a display, which is for example used to represent
the status of an ongoing flash progress. Furthermore, there are three buttons which allow
the user to control Flasher Portable PLUS. For a detailed description of the functions, take
a look at the table below:
Start programming process with the currently selected image.
Page 30
30CHAPTER 2Flasher Portable PLUS
ButtonDescription
Select image
Power on/off
Select the image to be programmed next time the Program
button is pressed.
Used to power-on / power-off the Flasher Portable PLUS.
Please note that to power up the Flasher Portable PLUS, the
button should be hold for at least 1 second to make sure
software can boot and take control of power circuit, so the
Flasher Portable PLUS keeps powered, after releasing the
button.
2.1.2 Configuration
The Flasher Portable PLUS has some configuration options the other Flashers do not have.
OptionDescriptionValue range
AutoPowerOffOnIdle
ShowDatCRCAfterProgramming
If the Flasher.ini does not contain a [Config] section with the configuration option, the
default value is used.
Specifies the time interval after which the
Flasher Portable will turn off without any
user action
Activates displaying the data file CRC after
the programming in the pop up message
1 to 360060
0 = inactive, 1
= active
Default
value
0
Example:
This sample will show the data file CRC after the programming and the auto power of is
set to five minutes (=300 seconds).
The Flasher Portable is a portable version of SEGGERs Flasher family, which has been
designed to fill the need of an extremely portable, production grade, Flash programmer
used for in-field firmware updates. No need to be tethered to an outlet, it is powered by
three standard AAA batteries. The Flasher Portable programs flash targets in stand-alone
mode or via J-Flash PC software.
Furthermore the Flasher Portable allows the user to select between four data images to be
programmed. The images can be easily selected by using the arrow buttons on the front
of the housing. For more information about support for multiple images, please refer to
Multiple File Support on page 52.
For setup and configuration purposes, the Flasher Portable connects to a PC via USB interface, running Microsoft Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 7 or Windows 8 and has a built-in standard 20-pin J-Link target connector.
Note
Ethernet and RS232 as host interface are not available for the Flasher Portable.
2.2.1 Housing & Buttons
The Flasher Portable comes with several leds which are for example used to represent the
status of an ongoing flash progress. Furthermore, there are three buttons which allow the
user to control Flasher Portable. For a detailed description of the functions, take a look at
the two tables below:
GREEN. Blinks while the Flasher Portable is busy / performs
operations on the target.
GREEN/RED. Indicates, if the last flashing cycle was success-
PASS/FAIL
ful.
•GREEN: Flashing cycle completed successfully.
•RED: Flashing cycle completed with error.
GREEN: Indicates which image is currently selected for pro-
1/2/3/4
gramming. For more information about multiple image support, please refer to Multiple File Support on page 52.
POWER
GREEN: Indicates if Flasher is currently powered. Blinks
while Flasher Portable tries to enumerate via USB.
1) The LED is off, meaning battery voltage is > 3.3V
2) The red LED is constant on if battery voltage is low (≤
LO BAT
3.3V). In this mode, Flasher still allows programming.
3) The red LED starts blinking in case of the battery voltage
is below 3.0V. Flasher refuse programming attempts.
ButtonDescription
Program
Select image
Start programming process with the currently selected image.
Select the image to be programmed next time the Program
button is pressed.
Used to power-on / power-off the Flasher Portable. Please
note that to power up the Flasher Portable, the button
Power on/off
should be hold for at least 1 second to make sure software
can boot and take control of power circuit, so the Flasher
Portable keeps powered, after releasing the button
The Flasher supports 8.3 filenames only (8 characters filename, 3 characters file extension).
Using longer filenames may result in incorrect operation. Integrated functions, like the FTP
server or the terminal server, will refuse writing files with long filenames.
Setting up the IP interface Some of the Flasher models come with an additional Ethernet
interface to communicate with the host system. These Flashers also come with a builtin webserver which allows some basic setup of the emulator, e.g. configuring a default
gateway which allows using it even in large intranets. For more information, please refer
to TCP Services on page 75.
2.4.1 Connecting the first time
When connecting Flasher the first time, it attempts to acquire an IP address via DHCP. The
recommended way for finding out which IP address has been assigned to Flasher is, to use
the J-Link Configurator. The J-Link Configurator is a small GUI-based utility which shows
a list of all emulator that are connected to the host PC via USB and Ethernet. For more
information about the J-Link Configurator, please refer to UM08001_JLink.pdf (J-Link / JTrace user guide), chapter Setup, section J-Link Configurator. The setup of the IP interface
of Flasher is the same as for other emulators of the J-Link family. For more information
about how to setup the IP interface of Flasher, please refer to UM08001, J-Link / J-TraceUser Guide, chapter Setup, section Setting up the IP interface. For more information about
how to use Flasher via Ethernet or prepare Flasher via Ethernet for stand-alone mode,
please refer to Operating modes on page 35.
All Flashers except the Flasher ATE are able to boot in 3 different modes:
•J-Link mode
•Stand-alone mode
•MSD (Mass storage device) mode
Note
The Flasher ATE only supports the stand-alone mode.
Definition J-Link mode
Flasher is connected to a PC via USB/Ethernet and controlled by a PC application (J-Flash).
If there is an RS232 connection to a PC, does not have any influence on if J-Link mode is
entered or not. In this mode, Flasher can be used as a J-Link and controlled by the software
in the J-Link software and documentation package (J-Link Commander, J-Flash, …)
Definition Stand-alone mode
This mode is entered when there is no active USB/Ethernet connection to a host PC, e.g.
if Flasher is only powered via a USB power supply.
Definition MSD mode
Entered only if Flasher Start/Stop button (on Flasher Portable the “PROG” button) is kept
pressed for at least 2 seconds while connection Flasher via USB. In this mode, Flasher
enumerates as a mass storage device (like an USB Stick) at the host PC. In this mode,
configuration + data files can be manually placed on the Flasher and the flasher logfile
can be read out.
2.5.1 J-Link mode
If you want to use Flasher for the first time you need to install the J-Link software and documentation package. After installation, connect Flasher to the host PC via USB or Ethernet.
For more information about how to install the J-Link software and documentation package
please refer to the J-Link / J-Trace User Guide, chapter Setup which can be downloaded
from https://www.segger.com/jlink-software.html.
2.5.1.1 Connecting the target system
Power-on sequence
In general, Flasher should be powered on before connecting it with the target device. That
means you should first connect Flasher with the host system via USB / Ethernet and then
connect Flasher with the target device via JTAG or SWD. Power-on the device after you
connected Flasher to it. Flasher will boot in “J-Link mode”.
Verifying target device connection with J-Link.exe
If the USB driver is working properly and your Flasher is connected with the host system,
you may connect Flasher to your target hardware. Then start the J-Link command line
tool JLink.exe, which should now display the normal Flasher related information and in
addition to that it should report that it found a JTAG target and the targets core ID. The
screenshot below shows the output of JLink.exe.
In J-Link mode, there are also certain LED status codes defined:
#Status of LEDMeaning
Flasher is waiting for USB enumeration or eth-
GREEN
0
high frequency blinking
(On/Off time: 50ms => 10Hz)
GREEN
0
constant
ernet link. As soon as USB has been enumerated or ethernet link has been established, the
green LED stops flashing and is switched to
constant green.
Flasher enumeration process is complete and it
is ready to be controlled by a PC application.
2.5.2 Stand-alone mode
In order to use Flasher in “stand-alone mode”, it has to be configured first, as described
in Setting up Flasher for stand-alone mode on page 39. To boot Flasher in the “standalone mode”, only the power supply to Flasher has to be enabled (Flasher should not be
connected to a PC). In the “stand-alone mode” Flasher can be used as a stand-alone flash
programmer.
Note
Flasher can only program the target device it was configured for. In order to program
another target device, you have to repeat the steps described in Setting up Flasherfor stand-alone mode on page 39.
2.5.2.1 LED status indicators
Progress and result of an operation is indicated by Flasher’s LEDs. The behavior is different
for J-Link and stand-alone mode. For a definition of the different modes, please refer to
Operating modes on page 35.
GREEN constant, RED constant: Operation failed
Goes back to state #0 automatically, but in case of
operation failed, RED remains on until state #1 is
entered the next time.
Older Flasher models have a different behavior. The following serial number ranges behave
different from the table above Flashers with the following serial number ranges behave
different and comply to the table below:
•1621xxxxx (Flasher ARM V2)
•1630xxxxx (Flasher ARM V3)
•4210xxxxx (Flasher PPC V1)
•4110xxxxx (Flasher RX V1)
#Status of LEDMeaning
Flasher is waiting for USB enumeration or ethernet link. As soon as USB has been enumerated or
GREEN
high frequency blinking
0
(On/Off time: 50ms =>
10Hz)
ethernet link has been established, the green LED
stops flashing and is switched to constant green. In
stand-alone-mode, Flasher remains in the high frequency blinking state until state #1 is reached.
Flasher goes to state #1 as soon as a #START command has been received via the ASCII interface or
the Start button has been pushed.
GREEN
1
constant
Connect to target and perform init sequence.
Flashing operation in progress:
•Erasing (slow blinking on/off time: 80 ms => 6.25
GREEN constant, RED constant: Operation failed
Goes back to state #0 automatically, but in case of
operation failed, RED remains on until state #1 is
entered the next time.
When pressing the Start/Stop button of Flasher while connecting it to the PC, Flasher will
boot in the “MSD mode”. This mode can be used to downdate a Flasher firmware version
if a firmware update did not work properly and it can be used to configure Flasher for the
“stand-alone mode”, without using J-Flash. If Flasher has been configured for “stand-alone
mode” as described in the section above, there will be four files on the MSD, FLASHER.CFG,
FLASHER.DAT, FLASHER.LOG, SERIAL.TXT.
FLASHER.CFG contains the configuration settings for programming the target device and
FLASHER.DAT contains the data to be programmed. FLASHER.LOG contains all logging infor-
mation about the commands, performed in stand-alone mode. The SERIAL.TXT contains
the serial number, which will be programmed next. J-Flash supports to configure Flasher
for automated serial number programming.
Currently, J-Flash does not support to configure Flasher for automated serial number programming.
If you want to configure multiple Flasher for the same target you do not have to use J-Flash
all the time. It is also possible to copy the FLASHER.CFG and the FLASHER.DAT files from a
configured Flasher to another one. To copy these files boot Flasher in “MSD mode”.
39CHAPTER 2Setting up Flasher for stand-alone mode
2.6 Setting up Flasher for stand-alone mode
In order to set up Flasher for the stand-alone mode it needs to be configured once using the
J-Flash software. For more information about J-Flash, please refer to the J-Flash User Guide.
After starting J-Flash, open the appropriate J-Flash project for the target Flasher shall be
configured for, by selecting File -> Open Project. If J-Flash does not come with an appropriate sample project for the desired hardware, a new project needs to be created by
selecting File -> File -> New Project.
After the appropriate project has been opened / created, the data file which shall be programmed needs to be loaded, by selecting File -> Open. After this J-Flash should look
like in the screenshot below.
40CHAPTER 2Setting up Flasher for stand-alone mode
Before downloading the configuration (project) and program data (data file) to Flasher, the
connection type (USB/IP) needs to be selected in the project. These settings are also saved
on a per-project basis, so this also only needs to be setup once per J-Flash project. The
connection dialog is opened by clicking Options -> Project settings -> General.
The connection dialog allows the user to select how to connect to Flasher. When connecting
to a Flasher via TCP/IP it is not mandatory to enter an IP address. If the field is left blank
and File -> Download to programmer is selected, an emulator selection dialog pops up
which shows all Flasher which have been found on the network. The user then can simply
select the Flash he wants to download the configuration to.
42CHAPTER 2Setting up Flasher for stand-alone mode
The J-Flash log window indicates that the download to the emulator was successful.
From now on, Flasher can be used in stand-alone mode (without host PC interaction) for
stand-alone programming.
2.6.1 Preparing for stand-alone operation manually
As an alternative, J-Flash can also be used to save config and data file to a hard drive.
This files can later be copied to a Flasher without using J-Flash, which is useful to prepare
additional Flasher for stand-alone programming, if for example a company plans to widen
its production, new Flasher units can be bought and used in production by simply copying
the files to the new units.
Creating config and data files
J-Flash config (*.CFG) and data (*.DAT) files can be created by using the “Save Flasher
config file…” and “Save Flasher data file…” options in the “File” menu.
For some devices, additional files (*.PEX) are needed. J-Flash will create a subdirectory (in
the same directory as the config file) with the same name as the config file and place the
files needed in this directory.
About *.PEX files
When using the “Save Flasher config file…” menu point or when using the “multiple configurations stored on Flasher” feature (See Multiple File Support on page 52.) feature, the
following needs to be taken care of:
For some devices, special connect, reset etc. sequences are necessary which are stored in
so-called *.PEX files on the Flasher.
When using the “Download config & data file to Flasher”, J-Flash takes care of correct use
and download of these files to Flasher.
43CHAPTER 2Setting up Flasher for stand-alone mode
When creating the config files manually and later download them to the Flasher manually,
it is user’s responsibility to put them at the right place.
The *.PEX files need to be placed in a subdirectory with the same name as the corresponding
*.cfg file. J-Flash creates a directory with the correct name automatically when a config
file is created.
Example:
MyConf0 is a project for a device that requires a *.PEX file for connect.
MyConf1 is a project for a device that requires no *.PEX file at all.
As an alternative to the stand-alone mode, configured via J-Flash, there is the Universal
Flash Loader mode. While the normal stand-alone mode relies on using the debug interface
of the device, the Universal Flash Loader mode uses device or vendor specific programming
interfaces and protocols and therefore it is independent of the CPU core.
The Universal Flash Loader is available for the Flasher PRO and for the Flasher Portable.
For some of the supported devices, SEGGER offers specific adapters.
2.7.1 Preparing manually
The Universal Flash Loader uses an initialization file (*.UNI), a device specific flash programming algorithm (*.PEX) and a data file (*.HEX, *.MOT, *.BIN or *.DAT).
2.7.1.1 Configuration
The initialization file basically is split into three parts. The first part, the section [DEVICE],
controls the generic behavior of the Universal Flash Loader. It specifies which protocol
driver and data file to use. It allows enabling and configuring target power and it defines
which actions to perform. The second part consists of one or more [BANKx] sections, which
contain information about the memories. The third part, the section [CONFIG], includes
configuration settings for the protocol driver.
If set to a value >0, power is applied to the target. The value defines the delay (in ms)
after enabling the target power supply and before starting to communicate with the target.
ChipErase
If set to 1, the chip erase function is called for erasing the chip.
Note
Do not enable this setting if the flash programming algorithm does not support chip
erase.
[TASKS]
CheckBlank
Defines if a blank check should be performed before erasing a sector.
Erase
Defines if the sector should be erased before programming.
Program
Defines if the sector should be programmed.
Verify
Defines if the sector should be verified after programming.
Secure
Defines if the device should be secured or protected against read-out after verifying.
[DEVICE]
Algo
File name of the flash programming algorithm. This file is provided by SEGGER and will
typically support a series of devices.
Data
File name of the data file to program. The flasher supports the Flasher DTA, the Intel HEX,
the Motorola S-Record and the binary file format. Flasher DAT files are generated by J-Flash
and offer high performance together with high flexibility. The other file formats produce a
small overhead, because they have to be parsed before the data can be programmed.
Offset
Offset to apply when programming a binary data file. Unless specified differently, binary
files start at offset 0x00000000.
[BANKx]
x blocks with configuration data for the flash banks. All three parameters (Base, Size and
Sect) are mandatory.
This section includes specific configuration data for the flash programming algorithm.
There are no general parameters.
Note
The data file must be organized in ascending address order. Gaps can be included. But
descending addresses will result in programming errors. You can sort the data files by
loading them into the J-Flash tool and saving it as a new file.
The RL78/G10 devices do not require any configuration data.
2.7.1.3 Configuration Data for Renesas RL78 (except RL78/G10)
BaudRate
The baud rate used for programming. Possible values are 115,200, 250,000, 500,000 and
1,000,000.
ClearConfigOnConnect
If this is set to 1, the first sector holding the configuration is cleared on connect. This will
especially reset the clock configuration to its default value allowing a higher programming
speed.
Security
Security configuration byte:
ItemContents
Bit 7Fixed to 1
Bit 6Fixed to 1
Bit 5Fixed to 1
Bit 4
Bit 3Fixed to 1
Bit 2
Bit 1
Bit 0Fixed to 1
Programming disable flag
(1: Enable programming, 0: Disable programming)
The interface mode (0 = low speed / 1 = high speed) used for communication.
ROP
Read out protection configuration byte: Depending on the target, 0x00 or 0xAA.
SectorSize
Sector size: Depending on the target: “64” for low density flash memory, “128” for medium
or high density flash memory.
Pins are connected as follows:
Flasher InterfaceSignal
Pin 1VCCT
Pin 2VCCT
Pin 4GND
Pin 6GND
Pin 8GND
Pin 9SWIM
Pin 10GND
Pin 12GND
Pin 14GND
Pin 15Reset
Pin 16GND
Pin 18GND
Pin 20GND
Note
As the STM8’s option bytes are part of the data image, the data image must not enable
the read out protection for the device in order to allow verification after programming.
The read out protection can be set finally by enabling the step “Secure”. This function
only changes the ROP option byte to the appropriate value.
In order to set up Flasher for the Universal Flash Loader mode, a PC utility called SEGGER
Universal Flash Loader Configurator is available for download.
The Universal Flash Loader Configurator comes with a large list of devices and flash programming algorithms. If you are going to use a device from one of the supported families
which currently is not available in the utility, feel free to contact the support.
It is also possible to have multiple data files and config files on Flasher, to make Flasher
more easy to use in production environment. To choose the correct configuration file and
data file pair, a FLASHER.INI file is used. This init file contains a [FILES] section which
describes which configuration file and which data file should be used for programming. A
sample content of a FLASHER.INI file is shown below:
Using this method all configuration files and data files which are used in the production
only have to be downloaded once. From there on a configuration file / data file pair can
be switched by simply replacing the FLASHER.INI by a new one, which contains the new
descriptions for the configuration file and data file. The FLASHER.INI can be replaced in
two ways:
1. Boot Flasher in MSD mode in order to replace the FLASHER.INI
2. If Flasher is already integrated into the production line, runs in stand-alone mode and
can not be booted in other mode: Use the file I/O commands provided by the ASCII
interface of Flasher, to replace the FLASHER.INI. For more information about the file I/
O commands, please refer to File I/O commands on page 86.
Note
Flasher supports 8.3 filenames only (8 characters filename, 3 characters file extension). Using longer filenames may result in incorrect operation.
2.8.1 Flasher Portable specifics
Flasher Portable allows to choose between four configuration and data file pairs during
runtime by using the select/arrow button on the front of Flasher Portable.
Which config / data file pair is used for which image selection position is determined by the
contents of the FLASHER.INI. For this, the FLASHER.INI contents in the [FILES] section
have been extended. The sample below shows how to enable the user to select between
four different images on the Flasher portable via the select / arrow button:
Using this method, all configuration files and data files which are used in the production only
have to be stored on Flasher Portable via MSD mode. From there on, switching between
the files can be done by simply using the selection button of Flasher Portable.
Flasher Portable PLUS allows to choose between 16 configuration and data file pairs during
runtime by using the select button on the front of Flasher Portable PLUS.
Which config / data file pair is used for which image selection position is determined by
the contents of the FLASHER.INI. For this, the FLASHER.INI may contain several [BATCH]
sections. The sample below shows how to enable the user to select between five different
images on the Flasher Portable PLUS via the select / arrow button:
Using this method, all configuration files and data files which are used in the production
only have to be stored on Flasher Portable PLUS via MSD mode. From there on, switching
between the files can be done by simply using the selection button of Flasher Portable PLUS.
Please also consider the chapter Batch Programming in stand-alone mode on page 58.
Note
There the Flasher Portable PLUS checks if the files exist on its flash storage. If the
a file is missing the entry will be skip and the selection jumps directly to the next
entry in the list.
Flasher supports to assign custom labels to configurations. This allows to specify easy to
remember names for configurations that are stored on the Flasher.
2.9.1 Hardware and software requirements
This feature is supported by the following models:
•Flasher Portable PLUS
This feature is supported since V6.30e of the software package and firmware
2.9.2 Assigning labels
The configuration and data file pairs are specified in the FLASHER.INI file:
•The maximum length of a custom label is 32 characters. If this length is exceeded, the
label is ignored and Flasher switches back to default mode for the affected configuration.
It is possible to program multiple targets which are located in a JTAG chain. The targets
will be programmed each with a configuration and a data file. The configuration for the
desired target must be selected before it can be programmed, this can be done with the
#SELECT command. For more information how to use the #SELECT command please refer
to Chapter “3.3.5 Commands to Flasher”.
Three configurations would be stored on the flasher:
Config 0: Configured to program Device0 (DEVICE0.CFG, DEVICE0.DAT)
Config 1: Configured to program Device1 (DEVICE1.CFG, DEVICE1.DAT)
Config 2: Configured to program Device2 (DEVICE2.CFG, DEVICE2.DAT)
Selection and programming of the target will be done via the ASCII interface:
Programming multiple targets can also be done via J-Flash using the command line interface. For this each target must be handled with its own project file.
Batch programming allows to execute different stand-alone mode jobs in batch to be executed in immediate succession, without any user interaction in between. This can be used
for example to program multiple targets in a JTAG-Chain or multiple data files to a target.
A batch may contains an unlimited number of configurations which consist of a data file
(*.DAT) and config file (*.CFG). For further information regarding config and data files,
please refer to Preparing for stand-alone operation manually on page 42.
In order to specify the batch jobs, a FLASHER.INI file is used. This init file contains a
[BATCH] section which describes which configuration pairs (*.DAT and *.CFG file) should
be used for each batch job. A sample content of a FLASHER.INI file is shown below:
The Flasher Portable PLUS screen will show that the number of jobs contained in the batch
and the configuration file name of the first job.
The progress will be shown during the flashing action. The Flasher lists the current job of
the batch, the current sector address and the percentage of the currently executed action.
The result of the programming will be shown on the screen after finishing all jobs.
Creating / Replacing of the FLASHER.INI file can done in two ways:
1. Boot Flasher in MSD mode in order to replace the FLASHER.INI
2. If Flasher is already integrated into the production line, runs in stand-alone mode and
can not be booted in other mode: Use the file I/O commands provided by the ASCII
interface of Flasher, to replace the FLASHER.INI . For more information about the file
I/O commands, please refer to File I/O commands on page 86. In case of an error
occurred during execution, the Flasher terminates the entire batch processing.
Note
Please note that the batch programming feature can not be used with the multiple file
support feature. Therefore, neither the #SELECT ASCII command nor the [FILES] tag
in the FLASHER.INI file can be used.
Note
Flasher supports 8.3 filenames only (8 characters filename, 3 characters file extension). Using longer filenames may result in incorrect operation.
2.11.1 Flasher Portable specifics
Flasher Portable allows to choose between four different batches during runtime by using
the select/arrow button on the front of Flasher Portable. Which batch configuration is used
for which image selection position is specified in the FLASHER.INI. For this, the FLASHER.INI
contents in the [BATCH] section have been extended. The sample below shows how to
enable the user to select between four different batches on the Flasher Portable via the
select / arrow button:
Using this method allows to have different batches for different setups used in the production to be stored once on the Flasher Portable via MSD mode. From there on, switching
between the batches can be done by simply using the selection button of Flasher Portable.
Example 2: Programming one Data file to the first target in a JTAG-Chain and then programming two data files to another device in the JTAG chain.
Example scenario: 2 Devices in a JTAG chain, a STM32F1 and a STM32F4.
•Follow the same as described before and additionally:
•Create one project file per target (and create a .CFG file of each one).
•Make sure each project file is configured correctly, especially the JTAG-Chain position
(See UM8003 “J-Flash” for more detailed info).
Example 3: Using multiple Batch sections with Flasher Portable.
Example scenario: 2 Devices in a JTAG chain, a STM32F1 and a STM32F4.
Selection 1 will program the STM32F1 target.
Selection 2 will program the STM32F4 target using “F4DATA0.dat”.
Selection 3 will program the STM32F4 target using “F4DATA1.dat”.
Selection 4 will execute 1, 2 and 3 in sequence.
Flasher supports programming of serial numbers. In order to use the serial number programming feature, the J-Flash project to be used as well as some files on the Flasher (depending on the configuration) need to be configured first.
In general, Flasher supports two ways of programming a serial number into the target:
1. Programming continuous serial numbers. Serial number is 1-4 bytes in size. Start serial
number, increment, serial number size and address is configured in the J-Flash project.
2. Programming custom serial numbers from a serial number list file. Start line into serial
number list file to get next serial number bytes, line increment, serial number size and
address is configured in J-Flash project. Serial number list file needs to be specified
and created by user.
In the following some generic information how to setup Flasher & the J-Flash project for
serial number programming are given.
Note
Full serial number programming support has been introduced with V4.51d of the JFlash software and the Flasher firmware that comes with it.
Note
Currently, programming of serial numbers is only supported for stand-alone mode.
Future versions of J-Flash may also support serial number programming in J-Link
mode.
2.12.1 Serial number settings
In order to enable the programming of serial numbers in stand-alone mode, the J-Flash
project has to be configured to enable programming a serial number at a specific address.
This is done by enabling the Program serial number option as shown in the screenshot
and table below:
The address the serial number should be
programmed at.
The length of the serial number (in bytes)
which should be programmed.
If no serial number list file is given, J-Flash
allows to use a 1-4 byte serial number. In
case of 8 is selected as length, the serial number and its complementary is programmed at the given address.
In case a serial number list file is given,
Flasher will take the serial number bytes
from the list file. If a serial number in the
list file does not define all bytes of Len ,
the remaining bytes are filled with 0s. No
complements etc. are added to the serial
number.
In case no serial number list file is given, Next SN is next serial number which
should be programmed. The serial number
is always stored in little endian format in
the flash memory.
In case a serial number list file is given,
Next SN describes the line of the serial
number list file where to read the next
serial number bytes from. Flasher starts
counting with line 0, so in order to start
serial number programming with the first
line of the SNList.txt, Next SN needs to
be set to 0.
Specifies how much Next SN is incremented.
2.12.2 Serial number file
When selecting File -> Download serial number file to Flasher, J-Flash will create a
Serial number file named as <JFlashProjectName>_Serial.txt. This file is downloaded
as SERIAL.TXT on Flasher. The file is generated based on the serial number settings in
the J-Flash project and will contain the value defined by the Next SN option. The serial
number file can also be manually edited by the user, since the serial number is written
ASCII encoded in the SERIAL.TXT file.
2.12.3 Serial number list file
In order to program custom serial numbers which can not be covered by the standard serial
number scheme provided by J-Flash (e.g. when programming non-continuous serial numbers or having gaps between the serial numbers), a so called serial number list file needs to
be created by the user. When selecting File-> Download serial number file to Flasher,
J-Flash will look for a serial number list file named as <JFlashProjectName>_SNList.txt
in the directory where the J-Flash project is located. This file is downloaded as SNList.txt
on Flasher. The serial number list file needs to be created manually by the user and has
the following syntax:
•One serial number per line
•Each byte of the serial number is described by two hexadecimal digits.
Example
A 8-byte serial number should be programmed at address 0x08000000.
The serial number list file should look as follows:
0102030455667788
The number of bytes to read per line is configured via the Len option in J-Flash. For more
information, please refer to Serial number settings on page 61.
Which line Flasher will read at the next programming cycle, is configured via the Next SN
option in J-Flash. For more information, please refer to Serial number settings on page 61.
In this case Next SN needs to be set to 0, since programming should be started with the
serial number bytes defined in the first line of the file.
Note
If the number of bytes specified in a line of the serial number list file is less than
the serial number length defined in the project, the remaining bytes filled with 0s by
Flasher.
Note
If the number of bytes specified in a line of the serial number list file is greater than
the serial number length defined in the J-Flash project, the remaining bytes will be
ignored by Flasher.
2.12.4 Programming process
Flasher will increment the serial number in SERIAL.TXT by the value defined in Increment
, after each successful programming cycle.
For each programming cycle, the FLASHER.LOG on the Flasher is updated and contains the
value from SERIAL.TXT that has been used for the programming cycle.
Note
The serial number in SERIAL.TXT will also be incremented in case if serial number
programming is disabled, to make sure that for the Flasher logfile there is a reference
which programming cycle passed and which not. As long as serial number program-
ming has not been enabled in the J-Flash project, Flasher does not merge any serial
number data into the image data to be programmed.
2.12.5 Downloading serial number files to Flasher
Downloading the serial number files needs to be done explicitly by selecting File-> Download serial number file to Flasher. Please note that the File -> Download config &
data file to Flasher option does only download the configuration and data file to Flasher
since usually the current serial number used for programming shall not be reset/overwritten when just updating the image Flasher shall program.
2.12.6 Sample setup
In the following a small sample is given how to setup Flasher for serial number programming. In the following sample, 4-byte serial numbers starting at 1234567 (0x12D687) shall
be programmed at address 0x08001000.
Defining serial number address, length and start value
In the J-Flash project the following needs to be defined:
Downloading configuration, data and serial number to Flasher.
After setting up the rest of the configuration (Target interface etc.) and selecting an appropriate data file, the configuration, data and serial number file is downloaded into Flasher
via the File -> Download config & data file to Flasher and File-> Download serialnumber file to Flasher option.
After downloading the serial number to Flasher, J-Flash also created the <JFlashProject-Name>_Serial.txt.
Now Flasher is prepared to program the 8-byte serial number.
In stand-alone mode Flasher supports patch files which allows to patch the content of the
data to be programmed. Before starting programming process in stand-alone mode, Flasher
will look for a file named Patches.txt being present on the Flasher. This file includes the
patches. If this file is present, the number in Serial.txt describes the line number of the
Patches.txt that will be used for the current cycle (line counting starts at 0).
Each line in the Patches.txt can hold up to 4 patches, where each patch can be up to
32 bytes in length.
Syntax
Each line begins with <NumPatches> followed by each patch <Addr>,<NumBytes>:<Data>
in sequence and separated by commas. So the syntax for <NumPatches> = = 4 would be
as follows:
67CHAPTER 2Limiting the number of programming cycles
2.14 Limiting the number of programming cycles
Flasher provides a mechanism to limit the number of programming cycles that can be
performed in stand-alone mode with the configuration that is stored on the Flasher. To
make use of this feature, a file called Cntdown.txt needs to be placed on the Flasher. This
file simply contains a decimal number (32-bit unsigned integer) that describes how many
programming cycles can be performed with the current setup.
This feature especially makes sense when used in combination with authorized flashing.
For more information about authorized flashing, please refer to Authorized flashing on
page 68.
Note
The number in the Cntdown.txt is only updated on a successful programming cycle.
Programming cycles that failed, do not affect the Cntdown.txt.
2.14.1 Changed fail/error LED indicator behavior
In case a Cntdown.txt is found at boot time, the fail/error LED of Flasher behaves different
from normal. If the number of programming cycles left is 10 or below, the following will
happen:
•The red error/fail LED will lit for 1 second
•After this, it will blink/toggle x times @ 5 Hz, indicating the number of programming
cycles left. (blinking 5 times for 5 cycles left, …)
2.14.2 Required Flasher hardware version for Cntdown.txt
support
Older Flasher models do not support the limiting of programming cycles. The Flashers with
the following serial number ranges do not support limiting of programming cycles:
•1621xxxxx (Flasher ARM V2)
•1630xxxxx (Flasher ARM V3)
•4210xxxxx (Flasher PPC V1)
•4110xxxxx (Flasher RX V1)
All other models / hardware versions support limiting of programming cycles.
Current hardware versions of Flasher support creation of a so called secure area which
allows to pre-configure the Flasher with a given setup and then give it to external production
facilities etc. without the possibility to read out the Flasher contents via MSD, FILE I/O
functionality (J-Link Commander) or RS232 commands. This section describes how to setup
a secure area on a Flasher and how to move the configuration/data file(s) into it.
2.15.1 Creating / Adding the secure area
By default, Flashers are shipped with a public area only (full Flasher flash size accessible
via MSD etc.). The secure area has to be activated / created once, to make use of it. This
will reserve half of the Flasher storage size (on current models this will be ~64 MB) for
the secure area. The secure area can be removed at any time, providing the full flasher
storage to the public area again. The secure area can be created / removed via J-Link
Commander, which is part of the software package that comes with Flasher.
The following secure area related commands are available in J-Link Commander:
•securearea create
•securearea remove
Note
When creating or removing the secure area, all configuration and data files being
stored on the Flasher, are lost. Please make sure that they are not needed anymore,
before adding / removing the security area.
2.15.2 Moving files to the secure area
Before moving configuration + data to the secure area, proper functionality of the setup
should be tested in stand-alone mode. Once the setup is working as expected, do the
following, to move the configuration + data into the secure area:
•Start Flasher in MSD mode (For more info, please refer to: MSD mode on page 38)
•Create a folder “_SECURE”
•Move all files that shall be moved to the secure area, into this folder
•Reboot Flasher (Do not enter MSD mode again, yet! Otherwise, contents will not be
moved). Now, depending on the configuration and data file size, it may take a bit, before
the Flasher Power LED lit. Once it lit, all contents have been moved to the secure area
and the _SECURE folder in the public area has been deleted.
•Now Flasher can be used in stand-alone mode, as normal, but the files cannot be read
back by the user / operator.
2.15.3 Considerations to be taken when using the secure
area
When using the secure area, some things need to be considered:
•All features like multiple file support, patch file support etc. can also be used when
operating from the secure area.
•The secure area cannot be read back by any utility. Solely the FLASHER.LOG is always
placed and updated in the public area, even when Flasher operates from the securearea.
•If there is any file/folder in the public area, except the FLASHER.LOG and there is also any
configuration / data present in the secure area, stand-alone flashing will fail because it
is not unambiguous which configuration / data shall be used. In such cases, Flashers with
Ethernet / RS232 interface will output an appropriate error message on programming.
All Flasher models will output an appropriate error message in the FLASHER.LOG.
•Moving files from the public into the secure area can be done multiple times, as explained
in Moving files to the secure area on page 68. Each time files are moved from the
public area to the secure area, all contents of the secure area are erased first, to
make sure that no previous configuration is present there.
2.15.4 Required Flasher hardware version
Older Flasher models do not support authorized flashing. The Flashers with the following
serial number ranges do not support authorized flashing:
•1621xxxxx (Flasher ARM V2)
•1630xxxxx (Flasher ARM V3)
•4210xxxxx (Flasher PPC V1)
•4110xxxxx (Flasher RX V1)
All other models / hardware versions support authorized flashing.
Flasher supports download into the internal flash of a large number of microcontrollers. The
number of supported devices is steadily growing, so you can always find the latest list of
supported devices on our website:
In general Flasher ARM supports programming of external flashes listed below:
•parallel NOR flash
•serial NOR flash
•NAND flash
•DataFlash
If the parallel NOR flash device which is used is not CFI-compliant you have to select the
flash device in J-Flash explicitly, for a list of all parallel NOR flash devices which can be explicitly selected in J-Flash, please refer to UM08003, J-Flash User Guide, chapter SupportedFlash Devices. For serial NOR flash, NAND flash and DataFlash devices a custom RAMCode
is needed since the connection of the flash to the CPU differs from device to device. The JFlash software comes with sample projects for custom RAMCodes. For a complete list of all
custom RAMCode projects which come with the J-Flash software, please refer to: http://
www.segger.com/supported-devices.html
2.18.2 Flasher RX
Programming of external parallel NOR flash is currently not supported by Flasher RX. This
limitation will be lifted in the near future.
2.18.3 Flasher PPC
Programming of external parallel NOR flash is currently not supported by Flasher PPC. This
limitation will be lifted in the near future.
Flasher ARM supports and has been tested with the following cores, but should work with
any ARM7/9, Cortex-M0/M1/M3/M4 core. If you experience problems with a particular core,
do not hesitate to contact Segger.
•ARM7TDMI (Rev 1)
•ARM7TDMI (Rev 3)
•ARM7TDMI-S (Rev 4)
•ARM920T
•ARM922T
•ARM926EJ-S
•ARM946E-S
•ARM966E-S
•Cortex-M0
•Cortex-M1
•Cortex-M3
•Cortex-M4
2.19.2 Flasher RX
Flasher RX supports and has been tested with the following cores. If you experience problems with a particular core, do not hesitate to contact Segger.
•RX610
•RX621
•RX62N
•RX62T
2.19.3 Flasher PPC
Flasher PPC supports and has been tested with the following cores. If you experience problems with a particular core, do not hesitate to contact Segger.
75CHAPTER 2Programming multiple targets in parallel
2.21 Programming multiple targets in parallel
To program multiple targets in parallel, a Flasher ATE or multiple Flashers will be needed
(each connecting to one CPU). The Flasher ATE can be used to program up to 10 targets in
parallel by using a single control unit. For further information regarding Flasher ATE, please
refer to the Flasher ATE user manual (UM08035_FlasherATE.pdf).
Using multiple Flashers, this can be done using the production programming software J-Flash. For further information, please refer to Chapter “Command Line Inter-face” Sub-chapter “Programming multiple targets in parallel” of the J-Flash User Guide
(UM08003_JFlash.pdf) which is part of the J-Link Software and Documentation package.
The FTP server provides easy access to the files on the internal file system. The server
supports a maximum of 2 simultaneous connections and works with all common FTP clients.
3.1.1 Access data
Anonymous access to the FTP server is limited to read-only access to the file system.
For write access, special login credentials have to be used:
Login: admin
Password: 1234
Note
The access data for read/write access can not be modified and it is intended to be
used only as a convenience feature to avoid unintended modification of the Flasher’s
file system. It is not meant as a security feature.
All Flashers which come with an Ethernet interface also come with a built-in web server,
which provides a web interface for information and network configuration. For the network,
the IP address settings can be changed and a nick name can be assigned to the device.
Additionally, the web interface provides information about the status of the integrated operating system, the IP stack and the target hardware.
•Manual: Programming operation starts when pressing the button. The LEDs serve as
visible indicators.
•Via Handshake lines: 3 lines on the serial interface are used:
1 line is an input and can be used to start operation,
2 lines are outputs and serve as busy and status signals.
•Terminal communication via RS232.
•Terminal communication via Telnet.
Note
All ways to control Flasher operation are working only if Flasher is in standalone mode.
In J-Link / MSD mode they have no effect.
The Flasher can be remote controlled by automated testers without the need of a connection
to a PC. Therefore the Flasher is equipped with additional hardware control functions, which
are connected to the SUBD9 male connector, normally used as RS232 interface to PC.
The following diagrams show the internal remote control circuitry of Flasher:
Pin No.FunctionDescription
A positive pulse of any voltage between 5 and 30V
with duration of min. 30 ms starts “Auto” function
1START
4BUSY
5GNDCommon Signal ground.
7OK
(Clear / Program / Verify) on falling edge of pulse.
The behavior of the “Auto” function depends on the
project settings, chosen in J-Flash at the Produc-tion tab.
As soon as the “Auto” function is started, BUSY
becomes active, which means that transistor is
switched OFF.
This output reflects result of last action. It is valid
after BUSY turned back to passive state. The output
transistor is switched ON to reflect OK state.
Once set up using J-Flash, the Flasher can be driven by any application or just a simple
terminal using ASCII commands.
Every known command is acknowledged by the Flasher and then executed. After command
execution, Flasher sends an ASCII reply message.
Note
There are situations where the execution of a known command is rejected with
#NACK:ERRxxx if Flasher is currently busy and the received command is not allowed
to be sent while Flasher is busy
4.3.2 General command and reply message format
•Any ASCII command has to start with the start delimiter #.
•Any ASCII command has to end with simple carriage return (’\r’, ASCII code 13).
•Commands can be sent upper or lower case
4.3.3 General usage
Reply messages must be considered in each case. In general, a new command must not
be sent before a reply for the last one has been received.
4.3.4 Settings for ASCII interface via RS232
Flasher is driven via a RS232 serial port with the following interface settings:
•9600 baud
•8 data bits
•no parity
•1 stop bit
The baud rate can be changed by using the #BAUDRATE command.
4.3.5 Settings for ASCII interface via Telnet
A client application can connect to Flasher via Telnet on port 23. Find below a screenshot
of Flasher which is remote controlled via Telnet:
The table below gives an overview about the commands which are supported by the current
version of Flasher firmware. Click on the names for a detailed description:
Usually, the following command sequence will be performed when receiving the #AUTO
command:
•The Flasher erases the target CPU (if not blank)
•The Flasher programs the target CPU
•The Flasher verifies the target CPU
Depending on the settings chosen in the Production tab in J-Flash, this sequence can differ
from the one shown above.
Finally, Flasher responds with
•#OK if no error occurred
•#ERRxxx if any error occurred during operation. xxx represents the error code, normally
replied to Flasher PC program. The #ERRxxx message may be followed by an additional
error text.
During execution of the #AUTO command, Flasher automatically sends “status” messages
via RS232 to reflect the state of execution. Typically during execution of #AUTO command,
Flasher will reply the following sequence of messages:
The #AUTO PATCH command allows patching of the content of the data to be programmed.
Flasher responds with
•#OK if no error occurred
•#ERRxxx if any error occurred during operation. xxx represents the error code, normally
replied to Flasher PC program. The #ERRxxx message may be followed by an additional
error text.
For further information about the usage of the #AUTO PATCH command please refer to Patchfile support on page 66.
#AUTO NOINFO
This command may be used instead of #AUTO, if no status messages from Flasher should
be sent during execution. The NOINFO extension is also available for all other commands.
The command ends with #OK or #ERRxxx
#BAUDRATE<Baudrate>
This command can be sent in order to change the baud rate of the Flasher’s RS232 interface
used for communication. <Baudrate> is expected in decimal format.
If this command succeeds, Flasher responds with:
#ACK
#OK
Otherwise it will respond with one of the following error messages:
#ERR255: Invalid parameters
or
#ERR255: Baudrate is not supported
After sending the #BAUDRATE command you will first have to wait until the Flasher
responds with the #OK message. It is recommended wait 5ms before sending the next
command with the new baudrate in order to give the Flasher the time to change the
baudrate.
#CANCEL
This command can be sent to abort a running program. It may take a while until the current
program is actually canceled.
Flasher will respond with:
#ERR007:CANCELED.
#ERASE
This command can be sent to erase all selected target flash sectors.
Flasher will reply the following sequence of messages:
This command can be used instead of #AUTO to program a target without erasing the target
before programming and without performing a final verification.
#RESULT
This command can be sent any time, even during other command execution. Flasher responds with the last result of the previously executed command.
#SELECT <Filename>
The #SELECT command is used to select a specific config and data file pair which should be
used by Flasher to program the target. <Filename> specifies the name of file pair without
extensions (.CFG and .DAT) on the Flasher which should be selected. Flasher saves the
selected config and data file in the FLASHER.INI file. So this selection is remembered even
between power-cycling Flasher.
This may be verfy helpful in cases where several config and data files are stored on Flasher.
The user can easily switch between these config and data files without connecting Flasher
to a host.
If this command succeeds, Flasher responds with:
#ACK
#OK
Find below a sample sequence which shows how to use the #SELECT command:
#SELECT ATSAM7_1 // ATSAM7_1.CFG and ATSAM7_1.DAT is selected
This command can be sent to release Flasher’s target interface. All signals from Flasher
to target will be set into high-Z mode, reset of target will be released. It may be used to
start target application program.
Flasher will reply with the following sequence of messages:
This command can be sent any time, even during other command execution. Flasher responds with its current state. All defined state messages are described under Replies fromFlasher on page 89.
#VERIFY
This command can used to verify the target flash content against the data stored in Flasher.
4.3.6.2 File I/O commands
The ASCII interface of the Flasher also supports file I/O operations.
The following file I/O commands are supported:
#FCLOSE
The #FCLOSE command closes the file on Flasher which was opened via #FOPEN. After this
command has been issued further file I/O operations except #FDELETE are not allowed until
the #FOPEN command is send again.
A typical sequence when using the #FCLOSE command does look like as follows:
#FCLOSE
#ACK
#OK
Note
When using the #FCLOSE command a file has to be open (previously opened by
#FOPEN). Otherwise Flasher will respond with the following if no file has been opened:
The #FCRC command calculates a 32-bit CRC of the given file. This CRC can be used to verify
file integrity. This command should not be used while a file has been opened via #FOPEN.
The CRC will be also reported by J-Flash when downloading or saving files via J-Flash.
A typical sequence when using the #FCRC command does look like as follows:
#FCRC flasher.dat
#ACK
#OK:0x75BC855A
#FDELETE <Filename>
The #FDELETE command is used to delete a file on Flasher where <Filename> specifies the
name of the file.
A typical sequence when using the #FDELETE command does look like as follows:
#FDELETE flasher.dat
#ACK
#OK
Note
If deletion of the file fails for example if the file does not exist, Flasher will respond
with the following sequence:
#ACK
#ERR255:Failed to delete file
#FOPEN <Filename>
The #FOPEN command is used to open a file on Flasher for further file I/O operations.
<Filename> specifies the file on the Flasher which should be opened. If <Filename> can
not be found on Flasher a new one will be created.
A typical sequence using the #FOPEN command does look like as follows:
#FOPEN flasher.dat
#ACK
#OK
Note
Currently only one file can be open at the same time. If #FOPEN is send and another
file is already open, Flasher will respond with:
#ACK
#ERR255:A file has already been opened
#FREAD <Offset>,<NumBytes>
The #FREAD command is used to read data from a file on Flasher. <Offset> specifies the
offset in the file, at which data reading is started. <NumBytes> specifies the number of bytes
which should be read.
A typical sequence when using the #FREAD command does look like as follows:
#FREAD 0,4
#ACK
#OK:04:466c6173
If the #FREAD command succeeds, Flasher will finally respond with a #OK:<NumBytes>:<Da-
ta> reply message. For more information about the Flasher reply messages, please refer
In order to use the #FREAD command. A file has to be opened before, via the #FOPEN
command. Otherwise Flasher will respond with the following sequence:
#ACK
#ERR255:No file opened
#FSIZE
The #FSIZE command is used to get the size of the currently opened file on Flasher.
A typical sequence when using the #FSIZE command does look like as follows:
#FSIZE
#ACK
#OK:10 // file on flasher which is currently open, has a size of 16 bytes
If the #FSIZE command succeeds, Flasher will respond with a #OK:<Size> reply message.
For more information about the Flasher reply messages, please refer to Replies from Flasher
on page 89.
Note
In order to use the #FREAD command. A file has to be opened before, via the #FOPEN
command. Otherwise Flasher will respond with the following sequence:
#ACK
#ERR255:No file opened
#FWRITE <Offset>,<NumBytes>:<Data>
The #FWRITE command is used to write to a file on Flasher. <Offset> specifies the offset in
the file, at which data writing is started. <NumBytes> specifies the number of bytes which
are send with this command and which are written into the file on Flasher. <NumBytes>
is limited to 512 bytes at once. This means, if you want to write e.g. 1024 bytes, you
have to send the #FWRITE command twice, using an appropriate offset when sending it
the second time.
<Offset> and <NumBytes> are expected in hexadecimal format.
#FWRITE 0,200:<Data>
#FWRITE 200,200:<Data>
The data is expected in hexadecimal format (two hexadecimal characters per byte). The
following example illustrates the use of #FWRITE:
Data to be send: Hello !
ASCII values: 0x48, 0x65, 0x6C, 0x6C, 0x6F, 0x20, 0x21
#FWRITE 0,7:48656C6C6F2021
Note
In order to use the #FWRITE command a file has to be opened via the #FOPEN command,
first. Otherwise Flasher will respond with the following sequence:
#ACK
#ERR255:No file opened
#FLIST
The #LIST command is used to list all files stored on the Flasher.
The #MKDIR command is used to create a directory on Flasher. <Dirname> specifies the
name of the new directory. <Dirname> may also specify a path to create a subdirectory.
A typical sequence using the #MKDIR command does look like as follows:
#MKDIR folder
#ACK
#OK
Note
If the directory can not be created because of a bad <Dirname> argument, Flasher
will respond with:
#ACK
#ERR255:Failed to create directory
4.3.6.3 Replies from Flasher
The reply messages from Flasher follow the same data format as commands. Any reply
message starts with ASCII start delimiter #, ends with simple carriage return (ASCII code
13) and is sent in uppercase. In contrast to commands, replies can be followed by a de-
scriptive message, which gives more detailed information about the reply. This description
is sent in mixed case. The #OK reply, for example, is such a reply. It is followed by a string
containing information about the performance time needed for the operations:
The following reply messages from Flasher are defined:
#ACK
Flasher replies with #ACK message on reception of any defined command before the command itself is executed.
#NACK
Flasher replies with #NACK, if an undefined command was received.
#OK
Flasher replies with #OK, if a command other than #STATUS or #RESULT was executed and
ended with no error.
#OK:<NumBytes>:<Data>
Flasher replies with #OK:<Len>:<Data> if a #FREAD command was executed. <NumBytes>
is the number of bytes which could be read. This value may differ from the number of
requested bytes, for example if more bytes than available, were requested. <NumBytes>
and <Data> are send in hexadecimal format (for <Data>: two hexadecimal characters per
byte).
Flasher replies if #OK:<Size> if a #FSIZE command has been executed. <Size> is the size
(in bytes) of the currently opened file. <Size> is send in hexadecimal format.
#STATUS:
The Flasher replies with its current state.
The following status messages are currently defined:
MessageDescription
#STATUS:READY
#STATUS:CONNECTING
#STATUS:INITIALIZING
#STATUS:UNLOCKINGUnlocking flash sectors.
#STATUS:ERASING
#STATUS:PROGRAMMING
#STATUS:VERIFYING
Flasher is ready to receive a new command.
Flasher initializes connection to target
CPU.
Flasher performs self check and internal
init.
Flasher is erasing the flash of the target
device.
Flasher is programming the flash of the
target device.
Flasher verifies the programmed flash contents.
#ERRxxx
If any command other than #STATUS or #RESULT was terminated with an error, Flasher
cancels the command and replies with an error message instead of #OK message.
Some error codes may be followed by colon and an additional error text.
For example:
#ERR007:CANCELED.
The error code numbers are described in the following table:
MessageDescription
#ERR007
#ERR008
#ERR009Failed to allocate memory.
#ERR010Failed to open file.
#ERR011Failed to read file.
#ERR012Failed to write file.
#ERR013Failed to delete file.
#ERR255
Flasher received #CANCEL command and
has canceled the current operation.
Flasher is already busy with execution of
previous command.
Undefined error occurred. This reply is followed by an error string.
Flasher has a JTAG connector compatible with ARM’s Multi-ICE. The JTAG connector is a
20 way Insulation Displacement Connector (IDC) keyed box header (2.54mm male) that
mates with IDC sockets mounted on a ribbon cable.
6.1.1 Pinout JTAG
The following table lists the Flasher JTAG pinout.
PINSIGNALTYPEDescription
This is the target reference voltage. It is used to check if the
target has power, to create the logic-level reference for the
1VTrefInput
2VsupplyNC
3nTRSTOutput
5TDIOutput
7TMSOutput
9TCKOutput
11 RTCKInput
13 TDOInput
15 RESETI/O
input comparators and to control the output logic levels to
the target. It is normally fed from Vdd of the target board
and must not have a series resistor.
This pin is not connected to Flasher ARM. It is reserved for
compatibility with other equipment. Connect to Vdd or leave
open in target system.
JTAG Reset. Output from Flasher ARM to the Reset signal of
the target JTAG port. Typically connected to nTRST of the
target CPU. This pin is normally pulled HIGH on the target to
avoid unintentional resets when there is no connection.
JTAG data input of target CPU. It is recommended that this
pin is pulled to a defined state on the target board. Typically
connected to TDI of target CPU.
JTAG mode set input of target CPU. This pin should be pulled
up on the target. Typically connected to TMS of target CPU.
JTAG clock signal to target CPU. It is recommended that this
pin is pulled to a defined state of the target board. Typically
connected to TCK of target CPU.
Return test clock signal from the target. Some targets must
synchronize the JTAG inputs to internal clocks. To assist in
meeting this requirement, you can use a returned, and retimed, TCK to dynamically control the TCK rate. Flasher ARM
supports adaptive clocking, which waits for TCK changes to
be echoed correctly before making further changes. Connect
to RTCK if available, otherwise to GND.
JTAG data output from target CPU. Typically connected to
TDO of target CPU.
Target CPU reset signal. Typically connected to the RESET
pin of the target CPU, which is typically called “nRST”,
“nRESET” or “RESET”.
This pin is not connected in Flasher ARM. It is reserved for
17 DBGRQNC
5V-Target
19
supply
Pins 4, 6, 8, 10, 12, 14, 16, 18, 20 are GND pins connected to GND in Flasher ARM. They
should also be connected to GND in the target system.
Output
compatibility with other equipment to be used as a debug
request signal to the target system. Typically connected to
DBGRQ if available, otherwise left open.
This pin is used to supply power to some eval boards. Typically left open on target hardware.
6.1.2 Pinout SWD
The 20-pin connector of Flasher is also compatible to ARM’s Serial Wire Debug (SWD)
interface.
The following table lists the J-Link / J-Trace SWD pinout.
PINSIGNALTYPEDescription
This is the target reference voltage. It is used to check if the
target has power, to create the logic-level reference for the
1VTrefInput
2VsupplyNC
3Not UsedNC
5Not usedNC
7SWDIOI/OSingle bi-directional data pin.
9SWCLKOutput
11 Not usedNC
13 SWOOutput
input comparators and to control the output logic levels to
the target. It is normally fed from Vdd of the target board
and must not have a series resistor.
This pin is not connected in J-Link. It is reserved for compatibility with other equipment. Connect to Vdd or leave open in
target system.
This pin is not used by J-Link. If the device may also be accessed via JTAG, this pin may be connected to nTRST, otherwise leave open.
This pin is not used by J-Link. If the device may also be accessed via JTAG, this pin may be connected to TDI, otherwise leave open.
Clock signal to target CPU.
It is recommended that this pin is pulled to a defined state
of the target board. Typically connected to TCK of target
CPU.
This pin is not used by J-Link. This pin is not used by J-Link
when operating in SWD mode. If the device may also be accessed via JTAG, this pin may be connected to RTCK, otherwise leave open.
Serial Wire Output trace port. (Optional, not required for
SWD communication.)
Target CPU reset signal. Typically connected to the RESET
15 RESETI/O
17 Not usedNCThis pin is not connected in J-Link.
5V-Target
19
supply
Pins 4, 6, 8, 10, 12, 14, 16, 18, 20 are GND pins connected to GND in J-Link. They should
also be connected to GND in the target system.
Output
pin of the target CPU, which is typically called “nRST”,
“nRESET” or “RESET”.
This pin is used to supply power to some eval boards. Not all
J-Links supply power on this pin, only the KS (Kickstart) versions. Typically left open on target hardware.
6.1.3 Target power supply
Pin 19 of the connector can be used to supply power to the target hardware. Supply voltage is 5V, max. current is 400mA. The output current is monitored and protected against
overload and short-circuit.
Power can be controlled via the J-Link commander. The following commands are available
to control power:
CommandExplanation
power onSwitch target power on
power offSwitch target power off
power on permSet target power supply default to “on”
power off permSet target power supply default to “off”
Flasher RX itself has a 20-pin JTAG connector mounted but comes with a 14-pin adapter for
Renesas RX devices. This adapter also enables Flasher RX to optionally power the connected
target hardware. On the adapter there is a jumper which allows selection between 3.3V
and 5V supply target voltage supply. The target is supplied via the VTref connection when
the supply option is jumpered.
The following table lists the Flasher RX 14-pin JTAG pinout.
PinSignalTypeDescription
JTAG clock signal to target CPU. It is recommended that this
1TCKOutput
3TRSTnOutput
4EMLEOutput
5TDOInput
6—NCThis pin is not connected to Flasher RX.
7—NCThis pin is not connected to Flasher RX.
8VTrefInput
9TMSOutput
10 —NCThis pin is not connected to Flasher RX.
11 TDIOutput
13 nRESI/O
pin is pulled to a defined state on the target board. Typically
connected to TCK on target CPU.
JTAG Reset. Output from Flasher ARM to the Reset signal of
the target JTAG port. Typically connected to nTRST of the
target CPU. This pin is normally pulled HIGH on the target to
avoid unintentional resets when there is no connection.
Pin for the on-chip emulator enable signal. When the on-chip
emulator is used, this pin should be driven high. When not
used, it should be driven low. Pulled HIGH to VTref via 1k
pull-up resistor on 14-pin adapter.
JTAG data output from target CPU. Typically connected to
TDO on target CPU.
This is the target reference voltage. It is used to check if the
target has power, to create the logic-level reference for the
input comparators and to control the output logic levels to
the target. It is normally fed from Vdd of the target board
and must not have a series resistor.
JTAG mode set input of target CPU. This pin should be pulled
up on the target. Typically connected to TMS on target CPU.
JTAG data input of target CPU. It is recommended that this
pin is pulled to a defined state on the target board. Typically
connected to TDI on target CPU.
Target CPU reset signal. Typically connected to the RESET
pin of the target CPU, which is typically called “nRST”,
“nRESET” or “RESET”.
•All pins marked NC are not connected to Flasher RX. Any signal can be applied here;
Flasher RX will simply ignore such a signal.
•Pins 2, 12, 14 are GND pins connected to GND in Flasher RX. They should also be
connected to GND in the target system.
Pin 8 of the 14-pin connector can be used to supply power to the target hardware. Supply
voltage is 3.3V / 5V, max. current is 400mA. The output current is monitored and protected
against overload and short-circuit. Power can be controlled via the J-Link commander. The
following commands are available to control power:
CommandExplanation
power onSwitch target power on
power offSwitch target power off
power on permSet target power supply default to “on”
power off permSet target power supply default to “off”
Flasher PPC itself has a 20-pin JTAG connector mounted but comes with a 14-pin adapter
for PowerPC devices.
The following table lists the Flasher PPC 14-pin JTAG pinout.
PinSignalTypeDescription
JTAG data input of target CPU. It is recommended that this
1TDIOutput
3TDOInput
5TCKOutput
7—NCThis pin is not connected to Flasher PPC.
8—NCThis pin is not connected to Flasher PPC.
9nRESI/O
10 TMSOutput
11 VDDE7Input
13 nRDYInput
14 JCOMPOutput
pin is pulled to a defined state on the target board. Typically
connected to TDI on target CPU.
JTAG data output from target CPU. Typically connected to
TDO on target CPU.
JTAG clock signal to target CPU. It is recommended that this
pin is pulled to a defined state on the target board. Typically
connected to TCK on target CPU.
Target CPU reset signal. Typically connected to the RESET
pin of the target CPU, which is typically called “nRST”,
“nRESET” or “RESET”.
JTAG mode set input of target CPU. This pin should be pulled
up on the target. Typically connected to TMS on target CPU.
This is the target reference voltage. It is used to check if the
target has power, to create the logic-level reference for the
input comparators and to control the output logic levels to
the target. It is normally fed from Vdd of the target board
and must not have a series resistor.
Nexus ready output. Indicates to the development tools that
the data is ready to be read from or written to the Nexus
read/write access registers.
JTAG TAP Controller Enable / JTAG Compliancy (JCOMP).
JCOMP is used to enable the TAP controller for communication to the JTAG state machine for boundary scan and for debug access. This pin is set to HIGH by Flasher PPC (in order
to enable the JTAG TAP controller on the target device).
•All pins marked NC are not connected to Flasher PPC. Any signal can be applied here;
Flasher PPC will simply ignore such a signal.
•Pins 2, 12, 6, 12 are GND pins connected to GND in Flasher PPC. They should also be
connected to GND in the target system.
We strongly advise following the recommendations given by the chip manufacturer. These
recommendations are normally in line with the recommendations. Please refer to the the
appropriate tables depending on the core:
•Pinout JTAG on page 94
•Pinout SWD on page 95
•Flasher RX 14-pin connector on page 97
•Flasher PPC 14-pin connector on page 99
In case of doubt you should follow the recommendations given by the semiconductor manufacturer.
6.4.1 Pull-up/pull-down resistors
Unless otherwise specified by developer’s manual, pull-ups/pull-downs are recommended
to be between 2.2 kOhms and 47 kOhms.
6.4.2 RESET, nTRST
The debug logic is reset independently from the CPU core with nTRST. For the core to
operate correctly it is essential that both signals are asserted after power-up.
The advantage of having separate connection to the two reset signals is that it allows the
developer performing software debug to setup breakpoints, which are retained by the debug
logic even when the core is reset. (For example, at the reset vector address, to allow the
code to be single-stepped as soon as it comes out of reset). This can be particularly useful
when first trying to bring up a board with a new ASIC.