Operating instruction manual Command Line Flasher Hilscher Gesellschaft für Systemautomation mbH www.hilscher.com DOC191201OI01EN | Revision 1 | English | 2020-01 | Released | Public Table of contents 2/38 Table of contents 1 Introduction .............................................................................................................................. 3 1.1 Description of the contents............................................................................................... 3 1.2 List of revisions ................................................................................................................ 3 1.3 Conventions in this document .......................................................................................... 4 2 Brief description ...................................................................................................................... 5 3 Tested systems, devices and interfaces ............................................................................... 6 4 Downloading Flasher and USB drivers.................................................................................. 8 5 Installing drivers for Olimex ARM-USB-TINY H and Amontec JTAGkey (optional)......... 10 6 Connecting device and opening command line ................................................................. 15 7 Syntax, commands and parameters .................................................................................... 16 7.1 Syntax ............................................................................................................................ 16 7.2 Commands..................................................................................................................... 17 7.3 Parameters and values .................................................................................................. 19 8 Typical use cases .................................................................................................................. 21 8.1 Getting help.................................................................................................................... 21 8.2 Showing list of interfaces ............................................................................................... 23 8.3 Showing list of flash busses and units ........................................................................... 25 8.4 Writing a file to flash....................................................................................................... 27 8.5 Reading from flash ......................................................................................................... 30 8.6 Erasing area in flash device ........................................................................................... 31 9 Legal notes ............................................................................................................................. 32 List of Figures ........................................................................................................................ 36 List of Tables.......................................................................................................................... 37 Contacts.................................................................................................................................. 38 Command Line Flasher | Operating instruction manual © Hilscher 2020 DOC191201OI01EN | Revision 1 | English | 2020-01 | Released | Public Introduction 3/38 1 Introduction 1.1 Description of the contents This document describes the Command Line Interface Flasher tool (CLI Flasher) for netX SoCs. It provides information about the flasher’s functions and parameters and step-by-step instructions for typical use cases. 1.2 List of revisions Index Date Author Revision 1 2020-01-21 MKE Document created Table 1: List of revisions Command Line Flasher | Operating instruction manual © Hilscher 2020 DOC191201OI01EN | Revision 1 | English | 2020-01 | Released | Public Introduction 4/38 1.3 Conventions in this document Notes, operation instructions and results of operation steps are marked as follows: Notes Important: <important note> Note: <simple note> <note, where to find further information> Operation instructions 1. <operational step> Ø <instruction> Ø <instruction> 2. <operational step> Ø <instruction> Ø <instruction> Results <intermediate result> <final result> Command Line Flasher | Operating instruction manual © Hilscher 2020 DOC191201OI01EN | Revision 1 | English | 2020-01 | Released | Public Brief description 5/38 2 Brief description The CLI Flasher is a command line tool for initial programming of flash memory devices of netX products. Its purpose is to write, read, erase or verify data from/into internal or external flash memory devices connected to the netX. The Flasher runs under Linux and Windows. Note: The Command Line Flasher tool is written in C and LUA. It is open- source and licensed under GPL-2.0. The source code is hosted on GitHub: https://github.com/muhkuh-sys/org.muhkuh.tools-flasher. Executable packages are provided on GitHub for Windows 7 and Windows 10 in 32 and 64 bit and several Ubuntu versions in 32 and 64 bit. Tested CLI Flasher versions are available on the Hilscher knowledge base (for further information, see section Downloading Flasher and USB drivers [} page 8] in this document). Note that the Command Line Flasher is a tool for advanced users. When used in combination with batch files, it allows the automation of the software flashing process during the “end-of-line” production of netX devices. Note: The Flasher and its drivers are also included in the netX Studio CDT installation. netX Studio CDT features a graphical user interface plugin for the Flasher that allows you to use its functions conveniently by mouse-click in a GUI, instead of having to manually enter commands and parameters in a shell. For information on how to use the GUI-integrated Flasher of netX Studio CDT, see How to ... Use the Flasher tool section in the netX Studio CDT Getting started document. The Flasher communicates directly with the ROM loader of the netX ASICs. The supported interfaces of the Flasher are a subset of the netX ROM loader console mode interfaces. Instructions on how to put your netX into console mode (in order to use these interfaces) are provided in the "How to" collection for CLI Flasher of the Hilscher knowledge base. Additionally, the Flasher also supports the JTAG interface of the netX. For using its JTAG interface, the netX does not need to be in console mode. Note that using the Flasher tool on a Windows PC requires the installation of certain Windows USB drivers in order to communicate with the netX via its USB interface, respectively via UART-to-USB or JTAG-to-USB FTDI converter. For further information on how to install these drivers, see section Downloading Flasher and USB drivers [} page 8] in this document. (If you want to use Olimex ARM-USB-TINY H or Amontec JTAGkey JTAG-to-USB debuggers for flashing, see also section Installing drivers for Olimex ARM-USB-TINY H and Amontec JTAGkey (optional) [} page 10]). Command Line Flasher | Operating instruction manual © Hilscher 2020 DOC191201OI01EN | Revision 1 | English | 2020-01 | Released | Public Tested systems, devices and interfaces 6/38 3 Tested systems, devices and interfaces For up-to-date information, please check the release notes of your Flasher version in the knowledge base. Links to the individual Flasher versions are provided on the page: https://kb.hilscher.com/x/6zBbBg. Supported operating systems · Windows 7 · Windows 10 · Linux Tested Flash interfaces The following table provides an overview of the interfaces that are tested and verified for the current CLI Flasher release (V1.6.0). netX type External parallel flash External serial flash Internal flash eMMC / SD card Bus: -b 0 Bus: -b 1 Bus: -b 2 Bus: -b 3 netX 10 Tested units: -u 0 (SQI) Tested chip select: -cs 0 (default) netX Tested units: Tested units: 100/500 -u 0 (SRamBus) -u 0 (SPI) Tested chip select: Tested chip select: -cs 0 (default) -cs 0 (default) netX 50 Tested units: Tested units: -u 0 (SRamBus) -u 0 (SQI) Tested chip select: Tested chip select: -cs 0 (default) -cs 0 (default) netX 51/52 Tested units: -u 0 (SQI) Tested chip select: -cs 0 (default) netX Tested units: Tested units: 4000/4100 -u 0 (SQI) -u 0 (SDIO) Tested chip select: Tested chip select: -cs 0 (default) -cs 0 (default) netX 90 Tested units: Tested units: -u 0 (SQI) -u 0 INTFLASH0 (COM CPU) Tested chip select: -u 1 INTFLASH1 (COM CPU) -cs 0 (default) -u 2 INTFLASH2 (APP CPU) -u 3 INTFLASH01 (combined INTFLASH of COM CPU) Tested chip select: -cs 0 (default) netIOL Tested units: -u 0 (SQI) Tested chip select: -cs 0 (default) Table 2: Tested flash interfaces for CLI Flasher V1.6.0 Command Line Flasher | Operating instruction manual © Hilscher 2020 DOC191201OI01EN | Revision 1 | English | 2020-01 | Released | Public Tested systems, devices and interfaces 7/38 Supported netX interfaces netX type JTAG UART USB * Ethernet netX 10 netX 100/500 netX 50 netX 51/52 netX 4000/4100 netX 90 netIOL Table 3: Supported netX interfaces CLI Flasher V1.6.0 * When connected via USB, netX 50, 51/52 and 4000/4100 present an USB-CDC device to the computer and appear as a serial device plugin (romloader_uart) in the CLI Flasher. Note: You can use the list_interfaces command of the CLI Flasher to display a list of the interfaces that can be used to access your connected netX device (see section Commands [} page 17]). Command Line Flasher