Manual PROGRAMMER
User Manual: Pdf
Open the PDF directly: View PDF .
Page Count: 3
Download | ![]() |
Open PDF In Browser | View PDF |
Using OpenOCD as a Standalone FLASH Programmer (a simple tutorial) Motivation Using OpenOCD as just a programmer instead of a debug tool is very convenient in cases of mass production where you already have a prebuilt and already debugged image and you only need to download that image to the target device. In this mode of operation programming becomes as easy as starting the OpenOCD executable – all the rest is automatic. Installing Device Drivers Please follow the instructions in README.txt file in the drivers folder included in the package. There is nothing specific about the installation process if you have installed Windows drivers before. Connection between OpenOCD and the Target Board As can be seen in the picture below OpenOCD is an executable running on a host PC. OpenOCD communicates with a hardware JTAG adapter in the face of ARM-USB-OCD (and the rest of the series of products by Olimex). The JTAG adapter, in turn, communicates with the JTAG module in the target device. In order to know what to do, OpenOCD needs a configuration script, which contains information about the connected target device (type of processor, available memory, etc.) as well as commands to execute after initialization (in this case to program the device). Connection between Target and OpenOCD OpenOCD Configuration Files As mentioned above, OpenOCD needs a configuration file upon starting. A typical solution is to override the search for the configuration file and provide one or more configuration files with different names using the –f switch. For your convenience configuration files are divided into 2 types, one to configure the JTAG interface being used and another to configure the target processor. Interface configuration files for the supported JTAG adapters are placed inside the directory of OpenOCD executable. Sample target configuration scripts are located in the 'OpenOCD\tcl\target' directory. To implement the programming function of OpenOCD you need to add some lines to the configuration file of the target. These include commands to program the target and commands to start the programming itself. After locating the correct configuration script for your target you need to create a procedure inside in the file to be called to program the device. This procedure will contain the operations for programming. If, for example, it is called “program_device” the syntax will go like this: proc program_device () {… } Note: Please follow the exact syntax, i.e. the needed space between the name of the procedure and the empty brackets. Programming the flash memory of a device typically requires a sequence of: 1) Erasing the device memory 2) Optional: unlocking the flash pages of the device 3) Writing to the memory of the device Luckily enough, all these operations are contained in the “flash write_image”, so provided with the correct parameters it may be the only command inside the body of the procedure. Please consult OpenOCD User’s Guide to see how this command works. However, additional commands may be needed or desired to accompany the “flash write_image”. Here is a sample procedure for programming AT91SAM7S256. proc program_device () { # halt the processor halt wait_halt # write file to flash memory arm7_9 dcc_downloads enable sleep 10 poll flash probe 0 flash write_image erase unlock "AT91SAM7_H256.BIN" 0x00100000 sleep 10 #start execution of the program just downladed reset run sleep 10 #exit OpenOCD shutdown } In this case “flash write_image” is used to its full potential to erase and unlock flash memory before writing the image. Note that you should also provide the image file to program as well as the start address of the flash memory in the device. The example uses a binary file, however there are other formats supported. Besides, the input image file is located in the directory of OpenOCD, otherwise a relative of absolute path will be required. The target device is reset and run after programming. At the end of this procedure OpenOCD shuts down. Note: The procedure you create should be put somewhere in the configuration file, there is no exact place for it. The next thing to do is to put commands to actually start the programming process. Locate the end of the configuration file and add these lines (the place of the commands here is actually important!): init reset init program_device () Please again note the space between the procedure name and the brackets. Save the file and continue. General note: It is actually not a bad idea to initially test basic connectivity with the device prior to editing the configuration file. Starting OpenOCD The OpenOCD executable file is called: openocd-libftdi.exe. It is ready to run and needs no installation! If you do not provide any file with the –f switch the default file to search for is 'openocd.cnf' so do not get upset if you just start 'openocd-libftdi.exe' and end up with an error message. If you are using ARM-OCD-H and an AT91SAM7S256 processor, for example, type: > openocd-libftdi.exe -f olimex-arm-usb-ocd-h.cfg -f sam7s256.cfg Screenshot with OpenOCD executed. This command line assumes that both configuration files and the image file reside in the same folder as the OpenOCD executable. Upon starting OpenOCD connects to the JTAG module of the target device and reset is executed. Then the programming starts (successful execution is marked with an arrow) and after that the target is run. Note: OpenOCD is quite verbose by nature. Although most of the warnings it provides are meaningful and worth clearing, the process will finish just fine in most cases in spite of the warnings. Conclusion Please note that OpenOCD is sometimes pretty tricky to work with so be aware of configuration and runtime issues. Well, if things get very ugly you should stop the server, reconnect the JTAG adapter and start over. If in need of more information check out any of the following: − − http://openocd.berlios.de/web/ - the official web page of the OpenOCD project. http://forum.sparkfun.com/viewforum.php?f=18 – OpenOCD discussion board (very helpful indeed). − http://www.olimex/dev/ - manufacturer of development boards and tools. That's us :). Revision history − 31 January 2011 – initial release. THE END
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.4 Linearized : Yes Tagged PDF : Yes XMP Toolkit : Adobe XMP Core 4.0-c316 44.253921, Sun Oct 01 2006 17:14:39 Producer : Acrobat Distiller 8.1.0 (Windows) Source Modified : D:20110131134613 Create Date : 2011:01:31 15:46:26+02:00 Creator Tool : Acrobat PDFMaker 8.1 for Word Modify Date : 2011:01:31 15:46:31+02:00 Metadata Date : 2011:01:31 15:46:31+02:00 Document ID : uuid:ad832389-93ee-47e5-9b21-597ffb7bb591 Instance ID : uuid:c0df3bac-09fd-4577-ab8d-0f9d9942364f Subject : 7 Format : application/pdf Creator : shondll Title : Page Count : 3 Page Layout : OneColumn Author : shondllEXIF Metadata provided by EXIF.tools