emfile NAND Image Creator User & Reference Guide Document: UM02003 Software version: 1.03 Revision: 0 Date: November 16, 2016

Similar documents
embos Real Time Operating System CPU & Compiler specifics for PIC18 core using C18 compiler and MPLAB

embos Real-Time Operating System CPU & Compiler specifics for Texas Instruments using TI Code Composer for MSP430

embos/ip Switch Board

embos Real-Time Operating System CPU & Compiler specifics for Renesas RX using Renesas CCRX compiler and e2studio

embos Real-Time Operating System embos plug-in for IAR C-Spy Debugger Document: UM01025 Software Version: 3.0 Revision: 0 Date: September 18, 2017

Flasher ATE. Production Programmer. Getting Started. Document: AN08007 Manual Version: 1.0 Revision: 2 Date: January 9, 2018

embos Real-Time Operating System embos plug-in for IAR C-Spy Debugger Document: UM01025 Software Version: 3.1 Revision: 0 Date: May 3, 2018

embos Real-Time Operating System CPU & Compiler specifics for Renesas RX using KPIT GNU tools

embos Real-Time Operating System CPU & Compiler specifics for RH850 using IAR

empower Evaluation and prototyping platform for SEGGER software User Guide & Reference Manual

embos Real-Time Operating System CPU & Compiler specifics for SH2A core using IAR Embedded Workbench

embos Real-Time Operating System CPU & Compiler specifics for embos Visual Studio Simulation

SEGGER J-Scope. User Guide. Document: UM08028 Software Version: 5.10 Revision: 0 Date: November 26, 2015

emlib Library collection User & Reference Guide Document: UM12001 Software version: 1.0 Revision: 2 Date: January 7, 2016

Flasher STM8 User guide of the stand-alone SWIM programmer for STM8 Cores

Application Note. embos/ip Migration Guide

embos Real-Time Operating System CPU & Compiler specifics for RZ core using KPIT GNU and ARM DS-5

embos Real-Time Operating System CPU & Compiler specifics for ARM core using Keil MDK

J-Link / J-Trace ARM

Flasher ARM User guide of the stand-alone JTAG programmer for ARM Cores

Ozone the J-Link Debugger

Flasher ARM User guide of the stand-alone JTAG/SWD programmer for ARM Cores

emwin Window Manager Widgets Custom Widget Type Creation Guide Document: AN03002 Revision: 0 Date: April 2, 2013

J-Link / J-Trace User Guide

embos Real-Time Operating System CPU & Compiler specifics for ARM core using Atollic TrueStudio

SEGGER Eval Software

J-Link / J-Trace User Guide

Application Note. Using embos tickless support with STM32

emload Bootstrap loader for embedded applications User Guide & Reference Manual

embos Real-Time Operating System CPU & Compiler specifics for ARM core using GCC / emide

embos Real-Time Operating System CPU & Compiler specifics for Cortex M using Atmel Studio

embos Real-Time Operating System CPU & Compiler specifics for Renesas RX using IAR compiler for RX

embos Real Time Operating System CPU & Compiler specifics for RENESAS M16C CPUs and HEW workbench Document Rev. 1

J-Link / J-Trace User Guide

embos Real-Time Operating System CPU & Compiler specifics for Renesas RH850 and IAR

Description of the Windows XP Recovery Console for advanced users

Disk Operating System

EMC DiskXtender File System Manager for UNIX/Linux Release 3.5 Console Client for Microsoft Windows

MDK-ARM Version 5. ULINK Debug Adapters. Microcontroller Development Kit.

HELP Use the help command to list all the following supported commands:

embos Real Time Operating System CPU & Compiler specifics for Texas Instruments MSP430 CPUs and Rowley compiler for MSP430 Document Rev.

EMC DiskXtender File System Manager for UNIX/Linux Release 3.5 SP1 Console Client for Microsoft Windows

MDK-Professional Middleware Components. MDK-ARM Microcontroller Development Kit MDK-ARM Version 5. USB Host and Device. Middleware Pack.

Trace Debug Tools Version 1.2 Installation Guide

Flasher User Guide. Software Version V5.12 Manual Rev. 0. Date: March 30, Document: UM A product of SEGGER Microconroller GmbH & Co.

EMC NetWorker Module for Microsoft for Windows Bare Metal Recovery Solution

User Manual Firmware Update

IAR EWARM Quick Start for. Holtek s HT32 Series Microcontrollers

embos Real Time Operating System CPU & Compiler specifics for ARM core with ARM RealView Developer Suite 3.0 Document Rev. 1

embos Operating System CPU & Compiler specifics for Altera SoC using ARM DS-5 and GNU compiler

Long-term Information Storage Must store large amounts of data Information stored must survive the termination of the process using it Multiple proces

J-Link / J-Trace User Guide

embos Real Time Operating System CPU & Compiler specifics for RENESAS M16C CPUs and IAR compiler Document Rev. 5

makes floppy bootable o next comes root directory file information ATTRIB command used to modify name

J-Link / J-Trace User Guide

AN LPC1700 secondary USB bootloader. Document information. LPC1700, Secondary USB Bootloader, ISP, IAP

Chapter Two File Systems. CIS 4000 Intro. to Forensic Computing David McDonald, Ph.D.

Keil TM MDK-ARM Quick Start for. Holtek s HT32 Series Microcontrollers

Hard Disk Organization. Vocabulary

IAR PowerPac File System User Guide

embos Real-Time Operating System CPU & Compiler specifics for Cortex- M using Rowley CrossStudio for ARM

High Performance Real-Time Operating Systems

File Management. Ezio Bartocci.

IT ESSENTIALS V. 4.1 Module 5 Fundamental Operating Systems

EMC NetWorker Module for SnapImage Release 2.0 Microsoft Windows Version

IAR C-SPY Hardware Debugger Systems User Guide

ECE 598 Advanced Operating Systems Lecture 14

S1C17 Family EEPROM Emulation Library Manual

smxfs Portable FAT File System

EMC SourceOne for Microsoft SharePoint Version 6.7

J-Link / J-Trace User Guide

High Performance Real-Time Operating Systems

Lab - Common Windows CLI Commands

SOFTWARE RELEASE GUIDE FOR THE MOTOROLA "MCUez SDI FOR HC12" SOFTWARE APPLICATION PACKAGE

Small Logger File System

J-Link / J-Trace User Guide

Chapter 4. File Systems. Part 1

Lecture 2 DOS & Windows file commands by: lecturer Raya N.Ismail

BHFlashBurn v2.0. User Guide. BHFlashBurn-UG-02 April 2008

ToolStick-EK TOOLSTICK USER S GUIDE. 1. Kit Contents. 2. ToolStick Overview. Green and Red LEDs. C8051F321 provides USB debug interface.

EMC Documentum Composer

CSI3131 Operating Systems Tutorial 9 Winter 2015 File Systems

J-Link / J-Trace User Guide

C A S P E R TECH EDITION 10 USER GUIDE

C:\> command prompt DOS prompt cursor

emusb-host CPU independent USB Host stack for embedded applications User Guide & Reference Manual

Guide to Computer Forensics and Investigations Fourth Edition. Chapter 6 Working with Windows and DOS Systems

embos Real Time Operating System CPU & Compiler specifics for RENESAS SH2A CPUs and KPIT GNU compiler Document Rev. 1

MiniTutorial: Including RTX 2011 Runtime with Windows Embedded Standard 7

TIBCO ActiveMatrix BusinessWorks Plug-in for REST and JSON Installation. Software Release 1.0 November 2012

IntroductIon to dos. 2.1 IntroductIon. 2.2 SettIng up dos

TN0132 Technical note

File Shredders. and, just what is a file?

Application Note. Analyzing HardFaults on Cortex-M CPU

EMC Ionix Network Configuration Manager Version 4.1.1

emmodbus CPU independent Modbus stack for embedded applications User Guide & Reference Manual

CS333 Intro to Operating Systems. Jonathan Walpole

Binary Markup Toolkit Quick Start Guide Release v November 2016

ARM. Streamline. Performance Analyzer. Using ARM Streamline. Copyright 2010 ARM Limited. All rights reserved. ARM DUI 0482A (ID100210)

Computer Systems. Assembly Language for x86 Processors 6th Edition, Kip Irvine

Transcription:

emfile NAND Image Creator User & Reference Guide Document: UM02003 Software version: 1.03 Revision: 0 Date: November 16, 2016 A product of SEGGER Microcontroller GmbH & Co. KG www.segger.com

2 Disclaimer 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 & Co. KG (the manufacturer) assumes no responsibility for any errors or omissions. The manufacturer makes and you receive no warranties or conditions, express, implied, statutory or in any communication with you. The manufacturer 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 the manufacturer. 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., Hilden / Germany Trademarks Names mentioned in this manual may be trademarks of their respective companies. Brand and product names are trademarks or registered trademarks of their respective holders. Contact address SEGGER Microcontroller GmbH & Co. KG In den Weiden 11 D-40721 Hilden Germany Tel.+49 2103-2878-0 Fax.+49 2103-2878-28 Email: support@segger.com Internet: http://www.segger.com Manual versions This manual describes the latest software version. If any error occurs, please inform us and we will try to assist you as soon as possible. For further information on topics or routines not yet specified, please contact us. Software Revision Date By 1.03 0 161102 MD Added new commands: addpartition, setecclevel, copysectors, creatembr, and listvolumes. 1.01 1 140408 MD Changes to document format. 1.01 0 140311 MD Initial version.

3 About this document How to use this manual This manual explains all the functions that the product offers. Knowledge of the C language or assembly programming is not required. Typographic conventions for syntax This manual uses the following typographic conventions: Style Used for Body Keyword Sample Reference GUIElement Body text. Text that you enter at the command-prompt or that appears on the display (that is system functions, file- or pathnames). s in API functions. Sample code in program examples. Reference to chapters, sections, tables and figures or other documents. Buttons, dialog boxes, menu names, menu commands. Emphasis Very important sections Table 1.1: Typographic conventions

4 SEGGER Microcontroller GmbH & Co. KG develops and distributes software development tools and ANSI C software components (middleware) for embedded systems in several industries such as telecom, medical technology, consumer electronics, automotive industry and industrial automation. SEGGER s intention is to cut software development time for embedded applications by offering compact flexible and easy to use middleware, allowing developers to concentrate on their application. Our most popular products are emwin, a universal graphic software package for embedded applications, and embos, a small yet efficient real-time kernel. emwin, written entirely in ANSI C, can easily be used on any CPU and most any display. It is complemented by the available PC tools: Bitmap Converter, Font Converter, Simulator and Viewer. embos supports most 8/16/32-bit CPUs. Its small memory footprint makes it suitable for single-chip applications. Apart from its main focus on software tools, SEGGER develops and produces programming tools for flash microcontrollers, as well as J-Link, a JTAG emulator to assist in development, debugging and production, which has rapidly become the industry standard for debug access to ARM cores. Corporate Office: http://www.segger.com United States Office: http://www.segger-us.com EMBEDDED SOFTWARE (Middleware) emwin Graphics software and GUI emwin is designed to provide an efficient, processor- and display controller-independent graphical user interface (GUI) for any application that operates with a graphical display. Starterkits, eval- and trial-versions are available. embos Real Time Operating System embos is an RTOS designed to offer the benefits of a complete multitasking system for hard real time applications with minimal resources. The profiling PC tool embosview is included. emfile File system emfile is an embedded file system with FAT12, FAT16 and FAT32 support. emfile has been optimized for minimum memory consumption in RAM and ROM while maintaining high speed. Various Device drivers, e.g. for NAND and NOR flashes, SD/MMC and CompactFlash cards, are available. SEGGER TOOLS Flasher Flash programmer Flash Programming tool primarily for microcontrollers. J-Link JTAG emulator for ARM cores USB driven JTAG interface for ARM cores. J-Trace JTAG emulator with trace USB driven JTAG interface for ARM cores with Trace memory. supporting the ARM ETM (Embedded Trace Macrocell). J-Link / J-Trace Related Software Add-on software to be used with SEGGER s industry standard JTAG emulator, this includes flash programming software and flash breakpoints. USB-Stack USB device stack A USB stack designed to work on any embedded system with a USB client controller. Bulk communication and most standard device classes are supported.

5 Table of Contents 1 Introduction...7 1.1 About this manual...8 1.2 What is the purpose of the NAND Image Creator?...9 2 The NAND Image Creator...11 2.1 Interface of the NAND Image Creator...12 2.2 List of commands...15 2.3 Flash image related functions...16 2.4 File and directory functions...26 2.5 Sector related functions...39 2.6 Image specific functions...43

6 2014-2013 SEGGER Microcontroller GmbH & Co. KG

7 Chapter 1 Introduction This chapter explains the purpose of this manual.

8 CHAPTER 1 Introduction 1.1 About this manual The purpose of this document is to describe the functions and abilities of the emfile NAND Image Creator.

1.2 What is the purpose of the NAND Image Creator? The NAND Image Creator is a command line tool which gives the customer the ability to build a file containing 1-to-1 representation of NAND flash device (image) with preselected files and directories found on the host PC. 1.2.1 How is the image created? Files and directories from the host PC are copied to the image file using emfile API function creating the file structure which is required on the target device. 1.2.2 How is the NAND flash image transferred to the target? The image file created by the NAND Image Creator is a standard bin file which can be flashed directly into the NAND flash of the target via third party tools. 9 UM02002 User & Reference Guide of NAND Image Creator

10 CHAPTER 1 Introduction

11 Chapter 2 The NAND Image Creator This chapter describes the NAND Image Creator, its functions and how it is used.

12 CHAPTER 2 The NAND Image Creator 2.1 Interface of the NAND Image Creator The interface of the NAND Image Creator is used like any other command line based program. For the ease of usage many commands are kept similar to their DOS counterparts. By entering "?" or just pressing the Enter key an overview of the commands is printed on the screen and it should look like the screenshot below. 2014-2013 SEGGER Microcontroller GmbH & Co. KG

13 The NAND Image Creator can work in two modes: interactive and script. The interactive mode is entered when the utility is started with no arguments. In this mode the user is prompted to type in the commands. The script mode is entered when the utility is started with an argument which specifies the name of a file containing the commands to be executed, one command per line.

14 CHAPTER 2 The NAND Image Creator 2.1.1 Script file sample The following sample shows a simple script file which does the following: Creates a 128MB NAND flash image file "C:\flash.bin" Sets the type of NAND driver which will be used on the target to access the NAND flash to Universal. This command is optional since the default driver type is the Universal NAND driver. Writes the file system information to the image Low-level formats the image High-level formats the image Copies the "Test.txt" file from drive "C:" on host PC to root directory on the image. Copies recursively the contents of "Data" directory on host PC to "Data" directory on the image. script file createimage C:\flash.bin 1024 64 2048 setdrivertype uni init formatlow format addfile C:\Test.txt addfolder C:\Data\ q 2014-2013 SEGGER Microcontroller GmbH & Co. KG

15 2.2 List of commands The NAND Image Creator can process a NAND flash image by using built in commands. All commands that are usable are listed below. File(s) Flash image related functions createimage setdrivertype setsectorsize addpartition setecclevel showimageinfo init exportimage Creates/opens a new/existing NAND flash image file. Sets the type of NAND driver which will be used on the target to access the NAND flash. Sets the size of a file system sector. Configures a new logical partition. Configures the error correction type. Shows information about NAND flash image. Initializes the NAND image with the specified parameters. Saves to a file the NAND blocks which contain valid data. File and directory functions cd md rd addfile addfolder type del dir ren move attr copy Changes the directory or displays the name of the current directory. Recursively creates a directory. Removes (deletes) a directory. Copies a file from the HOST to the image. Copies a folder and its subfolders and files from the HOST to the image. Shows the content of a file on the screen. Deletes one file. Lists the content of the directory. Renames a file or directory. Moves a file or directory. Shows/changes the file/directory attributes. Copies a file to another location. Sector related functions storesectors dumpsector copysectors Copies sector data from a file on the host to image. Shows the contents of a sector. Copies sector data on the image. Image specific functions formatlow Low-level formats the volume. format High-level formats the volume. df Shows the available free space on the volume. diskinfo Shows the disk information about the volume. getdevinfo Shows the low level disk information about the volume. checkdisk Performs disk checking operation on the volume. creatembr Writes partition table to master boot record (MBR). listvolumes Shows the names of all available volumes. Table 2.1: List of commands

16 CHAPTER 2 The NAND Image Creator 2.3 Flash image related functions The following section describes functions required to create a NAND flash image. 2014-2013 SEGGER Microcontroller GmbH & Co. KG

17 2.3.1 createimage Creates/opens a new/existing NAND flash image file on the host PC. createimage <ImageFileName> <NumBlocks> <PagesPerBlock> <PageSize> [<SpareAreaSize>] ImageFileName Filename of the NAND flash image file that will be created/ opened. NumBlocks Number of blocks in the NAND flash device PagesPerBlock Number of pages in a NAND block (Typ. 64) PageSize Number of user bytes which can be saved in a page (Typ. 2048 bytes, must be a power of 2 value) Optional number of add. bytes in a page reserved for management SpareAreaSize information. When not specified the value is computed as 1/32 of PageSize Table 2.2: createimage parameter list Additional information The size of the image file will be NumBlocks * PagesPerBlock * (PageSize + SpareAreaSize) bytes large. If the image file already exists but the size of the file does not match it will be silently overwritten. The example shows how to create 128MByte image file. createimage C:\nand.bin 1024 64 2048

18 CHAPTER 2 The NAND Image Creator 2.3.2 setdrivertype Configures the type of NAND driver which will be used to access the NAND flash on the target. setdrivertype <DriverType> Additional information This command is optional. If not executed an image is created which can be accessed using the Universal NAND driver. The examples shows how to specify that the SLC1 NAND driver is used on the target to access the NAND flash. setdrivertype slc1 The type of NAND driver used to access the files on the target. DriverType "slc1" - SLC1 NAND driver (FS_NAND_Driver) "uni" - Universal NAND driver (FS_NAND_UNI_Driver) Table 2.3: setdrivertype parameter list 2014-2013 SEGGER Microcontroller GmbH & Co. KG

19 2.3.3 setsectorsize Configures the error correction type. setsectorsize <SectorSize> Additional information This command is optional. It can be used to set the size of the logical sector when the SLC1 NAND driver type is selected. Any power of 2 value between 512 bytes and the number of bytes in a NAND page size can be used. When this command is not executed the size of the logical sector is set automatically to the configured page size of NAND flash image. This example shows how to set the logical sector size to 512 bytes. setsectorsize 512 Number of bytes in a logical sector (Typ. 2048 bytes, must be SectorSize a power of 2 value) Table 2.4: setsectorsize parameter list

20 CHAPTER 2 The NAND Image Creator 2.3.4 addpartition Configures a new logical partition. addpartition <SectorStart> <NumSectors> [<PartType>] Index of the first sector in the partition relative to the beginning of the storage device. StartSector NumSectors Number of sectors in the partition. Type of the partition to create. Permitted values are: "normal" - The entire partition space can be used by the file system as storage (default). PartType "raid1" - The file system can use only half of the partition space as storage. The other half is used as mirror. Table 2.5: addpartition parameter list Additional information This command is optional. It allows the creation of logical partitions on the image. The command fails if the defined sector range overlaps the range of an already defined logical partition. A maximum of four logical partitions can be created. The partition list has to be stored to image after initialization of the image using the creatembr command. The data on the created logical partitions can be accessed using the DISKPART logical driver. For more details refer to UM02001 emfile User and Reference Guide available from here: https://www.segger.com/downloads/emfile. The logical partitions can be formatted using the format command. This example shows how to configure 2 logical partitions. The sector 0 is reserved for Master Boot Record where the partition list is stored. addpartition 1 10000 addpartition 10001 20000 A possible emfile configuration that allows the application to access the logical partitions looks like this: 2014-2013 SEGGER Microcontroller GmbH & Co. KG

21 /********************************************************************* * * FS_X_AddDevices * * Function description * This function is called by the FS during FS_Init(). * It is supposed to add all devices, using primarily FS_AddDevice(). * * Note * (1) Other API functions * Other API functions may NOT be called, since this function is called * during initialization. The devices are not yet ready at this point. */ void FS_X_AddDevices(void) { FS_AssignMemory(&_aMemBlock[0], sizeof(_amemblock)); FS_SetMaxSectorSize(2048); // // Add and configure the NAND partition. Volume name: "nand:0:" // FS_AddDevice(&FS_NAND_UNI_Driver); FS_NAND_UNI_SetPhyType(0, &FS_NAND_PHY_2048x8); FS_NAND_UNI_SetECCHook(0, &FS_NAND_ECC_HW_NULL); // // Add and configure the first logical volume. Volume name: "diskpart:0" // FS_AddDevice(&FS_DISKPART_Driver); FS_DISKPART_Configure(0, &FS_NAND_UNI_Driver, 0, 0); // // Add and configure the second non-raid volume. Volume name: "diskpart:1" // FS_AddDevice(&FS_DISKPART_Driver); FS_DISKPART_Configure(1, &FS_NAND_UNI_Driver, 0, 1); }

22 CHAPTER 2 The NAND Image Creator 2.3.5 setecclevel Configures bit error correction type. setecclevel <NumBitErrors> Additional information This command is optional. If not executed 1-bit software calculated ECC is stored to spare area. If NumBitErrors 0 is set to 0 the bytes in the spare area reserved to ECC are set to 0xFF. This example shows how to set the correction level to hardware ECC. setecclevel 0 Number of bit errors the ECC stored to spare area should be able to correct. Permitted values: NumBitErrors 0 - hardware ECC 1-1-bit software ECC Table 2.6: setecclevel parameter list 2014-2013 SEGGER Microcontroller GmbH & Co. KG

23 2.3.6 showimageinfo Shows information about the created image. showimageinfo showimageinfo Name: nand.bin Driver type: Universal Num blocks: 1024 Pages per block: 64 Page size: 2048 bytes Spare area size: 64 bytes Bytes per sector: 2048 bytes

24 CHAPTER 2 The NAND Image Creator 2.3.7 init Initialize the NAND flash image and emfile. init Additional information This command must be executed before any other command which operates on files and directories. init 2014-2013 SEGGER Microcontroller GmbH & Co. KG

25 2.3.8 exportimage Saves to a file the NAND blocks which contain valid data. exportimage <FilePathOnHost> Additional information This command can be used to create an image file that can be directly programmed to NAND flash device. Typically, the created image file is smaller than the original image file which helps reduce the programming time. exportimage C:\NAND.bin

26 CHAPTER 2 The NAND Image Creator 2.4 File and directory functions The following section describes functions which can be used for file and directory operations. 2014-2013 SEGGER Microcontroller GmbH & Co. KG

27 2.4.1 cd Changes or displays the name of a directory. cd <DirPathOnImage> cd Test cd.. Path to new directory to change to. Can be ".." to change to DirPathOnImage the parent directory. Table 2.7: cd parameter list

28 CHAPTER 2 The NAND Image Creator 2.4.2 md Creates recursively a directory. md <DirPathOnImage> DirPathOnImage Path of the directory which shall be created. Table 2.8: md parameter list Additional information This command will also create any missing directories in the path. md Test\Dir\ 2014-2013 SEGGER Microcontroller GmbH & Co. KG

29 2.4.3 rd Removes (deletes) a directory. rd <DirPathOnImage> DirPathOnImage Path of the directory which shall be deleted. Table 2.9: rd parameter list Additional information The directory to be deleted must be empty. rd Test

30 CHAPTER 2 The NAND Image Creator 2.4.4 addfile Copies a file from the host PC to the image. addfile <FilePathOnHost> [<FilePathOnImage>] FilePathOnHost Path to source file on the host file system. FilePathOnImage Path to destination file on the image. If not specified the name of the source file is used. Table 2.10: addfile parameter list The following command copies the contents of the "Test.txt" file from host PC to "Dest.txt" file on image. addfile C:\Test.txt Dest.txt The following command copies the contents of "Test.txt" to the file with the same name of the image. addfile C:\Test.txt 2014-2013 SEGGER Microcontroller GmbH & Co. KG

31 2.4.5 addfolder Copies a folder and its subfolders and files from the host PC to the image. addfolder <DirPathOnHost> [<DirPathOnImage>] DirPathOnHost Path to source directory on the host files system. DirPathOnImage Path to destination directory on the image. If not specified the source folder name will be used. Table 2.11: addfolder parameter list The following command copies the contents of the "Data" directory on PC to "Dest" directory on the image. addfolder C:\Data Dest The following command copies the contents of the "Data" directory on PC to a directory with the same name on the image. addfolder C:\Data

32 CHAPTER 2 The NAND Image Creator 2.4.6 type Shows the content of a file. type <FilePathOnImage> FilePathOnImage Path to the file on image to be shown. Table 2.12: type parameter list type Test.txt 2014-2013 SEGGER Microcontroller GmbH & Co. KG

33 2.4.7 del Deletes one file. del <FilePathOnImage> del Test.txt <FilePathOnImage> Path to the file on image to be deleted. Table 2.13: del parameter list

34 CHAPTER 2 The NAND Image Creator 2.4.8 dir Lists the contents of the directory. dir <DirPathOnImage> DirPathOnImage Path to directory on image to be listed. Table 2.14: dir parameter list dir Test 2014-2013 SEGGER Microcontroller GmbH & Co. KG

35 2.4.9 ren Renames a file or directory. ren <FilePathOnImage> <NewFileName> FilePathOnImage Path to file or directory on the image to be renamed. NewFileName New name for the file or directory. Table 2.15: ren parameter list ren Test Test2

36 CHAPTER 2 The NAND Image Creator 2.4.10 move Moves a file or directory. move <OldFilePathOnImage> <NewFilePathOnImage> OldFilePathOnImage Path to file or directory to be moved. NewFilePathOnImage Path to new file or directory on the image. Table 2.16: move parameter list move Test\Test.txt New.txt 2014-2013 SEGGER Microcontroller GmbH & Co. KG

37 2.4.11 attr Shows/changes the file/directory attributes. attr <PathOnImage> <Operation> <Attributes> PathOnImage Path to file or directory. Operation to be executed on attributes Operation "+" sets the attributes "-" clear the attributes The following attributes are supported: "a" Archive Attributes "h" Hidden "r" Read-only "s" System Table 2.17: attrib parameter list In the following example the archive and read-only attributes are cleared. attr Test.txt -ar

38 CHAPTER 2 The NAND Image Creator 2.4.12 copy Copies a file. copy <SrcFilePathOnImage> <DestFilePathOnImage> SrcFilePathOnImage Path to the file to be copied on image. DestFilePathOnImage Path destination file on image. Table 2.18: copy parameter list copy Test.txt Test2.txt 2014-2013 SEGGER Microcontroller GmbH & Co. KG

39 2.5 Sector related functions This section describes functions which can be used to operate on logical sectors.

40 CHAPTER 2 The NAND Image Creator 2.5.1 storesectors Copies sector data from a file on the host to image. storesectors <FilePathOnImage> [<StartSector>] FilePathOnImage Path to the file on host which contains sector data. StartSector Index of the first sector to be written. If not specified sector index 0 is assumed. Table 2.19: storesectors parameter list Additional information The sector data should be stored sequentially in the file. For example if the sector size is 2048 bytes and the data is stored starting from sector index 100 the byte at offset 0 in the file stores the first byte of sector 100, the byte at offset 2048 in the file stores the first byte of sector 101 and so on. The size of the file should be a multiple of sector size. The size of the sector is the size specified as the argument to setsectorsize command. If this command is not called the size of the sector is equal to page size. The page size is the 4th argument of the createimage command. This example reads sector data from the file "SectorData.bin" and writes it starting from sector index 100. storesectors SectorData.bin 100 2014-2013 SEGGER Microcontroller GmbH & Co. KG

41 2.5.2 dumpsector Shows the contents of a sector. dumpsector <SectorIndex> StartSector Index of the sector to be shown. Table 2.20: dumpsector parameter list dumpsector 0 00000000 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000010 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000020 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000030 0D 0A 34 33 32 31 34 33 32 31 34 33 32 31 34 33..43214321432143 00000040 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 00000050 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 00000060 32 31 0D 0A 34 33 32 31 34 33 32 31 34 33 32 31 21..432143214321 00000070 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000080 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000090 34 33 32 31 0D 0A 34 33 32 31 34 33 32 31 34 33 4321..4321432143 000000A0 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 000000B0 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 000000C0 32 31 34 33 32 31 0D 0A 34 33 32 31 34 33 32 31 214321..43214321 000000D0 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 000000E0 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 000000F0 34 33 32 31 34 33 32 31 0D 0A 34 33 32 31 34 33 43214321..432143 00000100 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 00000110 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 00000120 32 31 34 33 32 31 34 33 32 31 0D 0A 34 33 32 31 2143214321..4321 00000130 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000140 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 00000150 34 33 32 31 34 33 32 31 34 33 32 31 0D 0A 34 33 432143214321..43 00000160 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 00000170 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 00000180 32 31 34 33 32 31 34 33 32 31 34 33 32 31 0D 0A 21432143214321.. 00000190 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 000001A0 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 000001B0 34 33 32 31 34 33 32 31 34 33 32 31 34 33 32 31 4321432143214321 000001C0 0D 0A 34 33 32 31 34 33 32 31 34 33 32 31 34 33..43214321432143 000001D0 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 000001E0 32 31 34 33 32 31 34 33 32 31 34 33 32 31 34 33 2143214321432143 000001F0 32 31 0D 0A 34 33 32 31 34 33 32 31 34 33 32 31 21..432143214321

42 CHAPTER 2 The NAND Image Creator 2.5.3 copysectors Copies sector data on the image. copysectors <SrcSector> <DestSector> <NumSectors> SrcSector Index of the first source sector. DestSector Index of the first destination sector. NumSectors Number of sectors to copy. Table 2.21: copysectors parameter list Additional information This command operates only on the "nand:0:" volume. The command returns with an error if the source and destination range overlap. This example copies 10000 sectors from sector index 0 to sector index 20000. copysectors 0 20000 10000 2014-2013 SEGGER Microcontroller GmbH & Co. KG

2.6 Image specific functions The following section describes functions which can be used for image editing operations. 43

44 CHAPTER 2 The NAND Image Creator 2.6.1 df Shows the available free space on the volume. df [VolumeName] VolumeName Name of the volume to query. Table 2.22: df parameter list df Available free space is 127647744 bytes 2014-2013 SEGGER Microcontroller GmbH & Co. KG

45 2.6.2 diskinfo Shows the disk information about the volume. diskinfo [VolumeName] VolumeName Name of the volume to query. Table 2.23: diskinfo parameter list diskinfo 127647744 bytes total disk space 17719296 bytes available free space 8192 bytes per cluster 15582 cluster available on volume 2163 free cluster available on volume

46 CHAPTER 2 The NAND Image Creator 2.6.3 getdevinfo Shows the low-level disk information about the volume. getdevinfo [VolumeName] VolumeName Name of the volume to query. Table 2.24: getdevinfo parameter list getdevinfo 62370 available sectors 2048 bytes per sector 2014-2013 SEGGER Microcontroller GmbH & Co. KG

47 2.6.4 format Performs a high-level format of the volume. format [VolumeName] VolumeName Name of the volume which has to be formatted. Table 2.25: format parameter list format High-level format...ok

48 CHAPTER 2 The NAND Image Creator 2.6.5 formatlow Performs a low-level format of the volume. formatlow [VolumeName] VolumeName Name of the volume which has to be formatted. Table 2.26: formatlow parameter list formatlow Low-level format...ok 2014-2013 SEGGER Microcontroller GmbH & Co. KG

49 2.6.6 checkdisk Checks the volume for errors. checkdisk [VolumeName] VolumeName Name of the volume which has to be checked. Table 2.27: checkdisk parameter list checkdisk

50 CHAPTER 2 The NAND Image Creator 2.6.7 creatembr Writes partition table to Master Boot Record (MBR). creatembr [VolumeName] VolumeName Name of the volume on which the MBR should be stored. Table 2.28: creatembr parameter list Additional information This command stores the partition table configured via addpartition command to the MBR of the specified volume. If the volume name is omitted the partition table is written to the current volume. The command has to be executed after the low-level format and before any high-level format operation. Typ. the partition table is located on "nand:0:" volume. This example stores the MBR to the sector 0 of the "nand:0:" volume. creatembr "nand:0:" 2014-2013 SEGGER Microcontroller GmbH & Co. KG

51 2.6.8 listvolumes Shows the names of all available volumes. listvolumes Shows the names of the volumes of a configuration using four logical volumes. listvolumes Available volumes: nand:0: diskpart:0: diskpart:1: diskpart:2: diskpart:3:

52 CHAPTER 2 The NAND Image Creator 2014-2013 SEGGER Microcontroller GmbH & Co. KG

53 Index C Commands addfile...30 addfolder...31 attrib...37 cd...27 checkdisk...49 copy...38 createimage...17 del...33 df...44 dir...34 diskinfo...45 format...47 formatlow...48 getdevinfo...46 init...24 listvol...44 md...28 move...36 rd...29 ren...35 showimageinfo...23 type...32 L List of command...15 S, conventions used... 3

54 Index