configs/sample.cfg docs/c3_s6_app_gpsign.dox lib/lcfg/README lib/lcfg/lcfg_static.c lib/lcfg/lcfg_static.h src/gpsign.c @@ -1,6 +1,8 @@ # Ignore libraries *.a *.o +# Ignore swap files +.*.swp # Ignore documentation docs/html/* docs/latex/* @@ -10,3 +12,4 @@ pusb pserial ukermit ucmd +gpsign .gitignore @@ -7,4 +7,4 @@ Nishanth Menon <nm@ti.com> - pusb pserial ukermit ucmd + pusb pserial ukermit ucmd gpsign MAINTAINER @@ -14,10 +14,11 @@ Table of Contents: 3) pserial help 4) ukermit help 5) ucmd help -6) ucmd help -7) Generic Example of usage -8) Files and Directories -9) Credits +6) pusb help +7) gpsign help +8) Generic Example of usage +9) Files and Directories +10) Credits +----------------------------------------------------------------------------+ IMPORTANT NOTE: This document is meant for folks who dont have generated @@ -214,7 +215,31 @@ NOTE: it is required to run this program in sudo mode to get access at times Usage Example: Linux: sudo ./pusb -f u-boot.bin -7) Generic Example of usage +7) gpsign help +============== +App description: +--------------- +generates a formatted image which may be used for +nand, onenand or mmc boot on a OMAP GP device. +This can also add a configuration header which +allows for preconfiguration of various clock,ram +GPMC or MMC settings prior to the image starting. + +Syntax: +------- +./gpsign [-c config file] [-l loadaddr] [-f input_file] [-?] +Where: +------ +-c config_file: CH configuration file[Default none] +-l loadaddress: load address for result img[Default 0x40208800] +-f input_file: input binary to sign[Default x-load.bin] +-? : provide extended help including a sample config file +------ + +Usage Example: +All OS: gpsign + +8) Generic Example of usage =========================== The following example is using U-Boot-V2. But it is not restricted to just that! My notes in [NOTE:] comments below @@ -259,11 +284,13 @@ Match Found. Operation completed! [NOTE: you could embedd these in script files to automate commonly used operations such as flashing an image etc.. and ease up things a lot more] -8) Files and Directories +9) Files and Directories ======================== . (Source Root. All final executables are generated here) |-- COPYING (Copy Right file ->READ THIS) |-- README (This file) +|-- configs (Sample configuration files for boards) +| `-- sample.cfg |-- docs (documentation Directory) | |-- c1_s1_main.dox | |-- c2_s1_caveat.dox @@ -287,19 +314,24 @@ operations such as flashing an image etc.. and ease up things a lot more] | |-- file_posix.c (Linux/Mac OS/posix compilant file ops) | |-- file_win32.c (Windows file ops) | |-- f_status.c (show off status of operations) +| |-- lcfg (liblcfg library for configuration file handling) +| | |-- README +| | |-- lcfg_static.c +| | `-- lcfg_static.h | |-- serial_posix.c (Linux/Mac OS/posix Serial port ops) | `-- serial_win32.c (Windows Serial port ops) |-- makefile (make file for build) `-- src (app source directory) + |-- gpserial.c (gpserial source) |-- pserial.c (pserial source) |-- ucmd.c (ucmd source) - |-- pusb.c (ucmd source) + |-- pusb.c (pusb source) `-- ukermit.c (ukermit source) -4 directories, 26 files +6 directories, 33 files -9) Credits +10) Credits ======================== At the start of writing this code, there was no git, no svn, just zip files, so a couple of honorable mentions at this time: @@ -308,4 +340,7 @@ http://groups.google.com/group/beagleboard/browse_thread/thread/ae2c601ebe104a4 pusb is a scratch write but in general uses the same concepts Rob Clark - Mac OS support, tons of cleanups in serial code, and in general a - willing experimenter with new ideas :) +willing experimenter with new ideas :) + +Paul Baecher for writing liblcfg: http://liblcfg.carnivore.it/ - I recommend it +to anyone looking for a quiet simple config file handling parser README @@ -7,4 +7,5 @@ U-Boot utilities provide the following apps: response to ASIC ID over USB connection. @li @subpage ub_ucmd - Send a command to U-Boot and wait till a specific match appears. @li @subpage ub_ukermit - Download a file from host without using kermit to U-Boot. +@li @subpage ub_gpsign - Sign a image for booting with additional parameters. */ docs/c3_s1_apps.dox @@ -1,6 +1,6 @@ /** @page ub_compiliation Compiling the Code -@html <h2>Table Of Contents </h2> @endhtml +Table Of Contents @li @ref a @li @ref a_1 docs/c4_s1_compile.dox @@ -5,6 +5,8 @@ In general accessing OS specific system devices such as file and serial port ten there we define a set of APIs which are OS independent . APIs and defines can be found here: @li @ref include/serial.h - provide for OS independent APIs for applications to access serial port @li @ref include/file.h - provide OS independent APIs for accessing file +@li lib/lcfg/lcfg_static.h - liblcfg library from Paul Baecher's http://liblcfg.carnivore.it/ +generated with the mksinglefile.sh - rev 0.2.0 -The corresponding OS dependent implementation is done in lib/serial_<OS>.c lib/file_<OS>.c +The corresponding OS dependent implementation is done in lib/serial_[OS].c lib/file_[OS].c */ docs/c5_s1_library.dox @@ -511,7 +511,7 @@ RECURSIVE = YES # excluded from the INPUT source files. This way you can easily exclude a # subdirectory from a directory tree whose root is specified with the INPUT tag. -EXCLUDE = +EXCLUDE = lib/lcfg/lcfg_static.c lib/lcfg/lcfg_static.h # The EXCLUDE_SYMLINKS tag can be used select whether or not files or # directories that are symbolic links (a Unix filesystem feature) are excluded docs/doxyfile @@ -49,13 +49,14 @@ LIB_FILES=lib/serial_win32.c lib/file_win32.c else LIB_FILES=lib/serial_posix.c lib/file_posix.c endif -LIB_FILES+=lib/f_status.c +LIB_FILES+=lib/f_status.c lib/lcfg/lcfg_static.c #App source code PSERIAL_FILES=src/pserial.c KERMIT_FILES=src/ukermit.c UCMD_FILES=src/ucmd.c PUSB_FILES=src/pusb.c +GPSIGN_FILES=src/gpsign.c DOCS=docs/html docs/latex @@ -64,18 +65,20 @@ PSERIAL_EXE=pserial$(EXE_PREFIX) KERMIT_EXE=ukermit$(EXE_PREFIX) UCMD_EXE=ucmd$(EXE_PREFIX) PUSB_EXE=pusb$(EXE_PREFIX) +GPSIGN_EXE=gpsign$(EXE_PREFIX) # Object Files PSERIAL_OBJ=$(PSERIAL_FILES:.c=.o) KERMIT_OBJ=$(KERMIT_FILES:.c=.o) UCMD_OBJ=$(UCMD_FILES:.c=.o) PUSB_OBJ=$(PUSB_FILES:.c=.o) +GPSIGN_OBJ=$(GPSIGN_FILES:.c=.o) LIB_OBJ=$(LIB_FILES:.c=.o) CLEANUPFILES=$(PSERIAL_OBJ) $(LIB_OBJ) $(PSERIAL_EXE) $(GWART_OBJ)\ $(KERMIT_EXE) $(KERMIT_OBJ) $(UCMD_OBJ) $(UCMD_EXE)\ - $(PUSB_EXE) $(PUSB_OBJ) + $(PUSB_EXE) $(PUSB_OBJ) $(GPSIGN_EXE) $(GPSIGN_OBJ) CC=$(COMPILER_PREFIX)gcc LD=$(COMPILER_PREFIX)gcc @@ -83,7 +86,7 @@ RM=$(APP_PREFIX)rm$(EXE_PREFIX) ECHO=$(APP_PREFIX)echo$(EXE_PREFIX) DOXYGEN=$(APP_PREFIX)doxygen$(EXE_PREFIX) -CFLAGS=-Wall -O3 -Iinclude +CFLAGS=-Wall -O3 -Iinclude -Ilib/lcfg LDFLAGS= CFLAGS+=-fdata-sections -ffunction-sections @@ -108,7 +111,7 @@ endif .PHONY : all -all: $(PSERIAL_EXE) $(KERMIT_EXE) $(UCMD_EXE) +all: $(PSERIAL_EXE) $(KERMIT_EXE) $(UCMD_EXE) $(GPSIGN_EXE) usb: $(PUSB_EXE) @@ -127,6 +130,11 @@ $(UCMD_EXE): $(UCMD_OBJ) $(LIB_OBJ) makefile $(if $(VERBOSE:1=),@)$(LD) $(UCMD_OBJ) $(LIB_OBJ) $(LDFLAGS) -o $@ @$(ECHO) +$(GPSIGN_EXE): $(GPSIGN_OBJ) $(LIB_OBJ) makefile + @$(ECHO) "Generating: $@" + $(if $(VERBOSE:1=),@)$(LD) $(GPSIGN_OBJ) $(LIB_OBJ) $(LDFLAGS) -o $@ + @$(ECHO) + $(PUSB_EXE): $(PUSB_OBJ) $(LIB_OBJ) makefile @$(ECHO) "Generating: $@" $(if $(VERBOSE:1=),@)$(LD) $(PUSB_OBJ) $(LIB_OBJ) $(LDFLAGS) $(LDFLAGS_USB) -o $@ makefile fcefcac34e61998fd2190070aafa5db65d743984 Nishanth Menon nm@ti.com http://github.com/nmenon/omap-u-boot-utils/commit/d29bb1728e01ad8c74cec663bb2ec0b86db0881a d29bb1728e01ad8c74cec663bb2ec0b86db0881a 2009-05-05T10:37:17-07:00 2009-04-23T17:20:38-07:00 GPSIGN: add image generation tool This application can generate configuration header for allowing images such as u-boot to boot straight from NAND to SDRAM without using the 2 stage x-loader assisted boot NOTE: This uses http://liblcfg.carnivore.it/ liblcfg for parsing configuration files This uses ideas on formatting help messages from Raghavendra K Signed-off-by: Nishanth Menon <nm@ti.com> d5d97d485adc6fcdb030599d914630d5f2989139 Nishanth Menon nm@ti.com