readme

可用于TM1300/PNX1300系列DSP（主要用于视频处理）压缩库即应用例子。

tmSEA is a tool embeds a directory in compressed form in an executable that
unpacks and writes that directory to its local file system. This kind of 
self extracting archieve will effectively cause a 50% size reduction of 
the load archieve.

The user must provide a directory which will be acrhieved. All subdirectories
of the specified directory will also be archieved.

The output directory to which the data will be written may be specified by
a user. The default output dir is '/flash'. The directory must be an absolute
path i.e. preceded by '/'. If using flash as the archieve, the output directory
path must begin with '/flash'.

A user may specify whether the tmSEA output is big Endian or little Endian. Big
Endian is the defaulf Endianness.

The user can specify where the root of the TCS tree, if it is not in the defualt location.

The user can specify the path of the c source file, tmunpackarch.c, if it is not
in the default location.

If a user is not using the TriMedia Flash the parameter '-nostandard' should be 
added to the command line. By default ths standard Flash Library and Flash source
file (from the directory './tmunpacharch') are pulled in.

If a user is using the Flash BSP then a user should add '-flashbsp' to the
command line. Otherwise the Flash specific driver file in the Makefile will
be used as the Flash driver.

Users can specify additional compiler-time and link-time options to tmcc using the
-ldflags and -cflags parameters.

The autogenerated output can be verbose if the user specifies the -v options. However to
view the printfs the user must, link some output device such as a uart object file using
the -ldflags options.

The defauly output name is 'a.out'. A user can specify a different name using the
following paramater "-o output-file".

Below is a more syntacital explanation of tmSEA input parameters.

usage: tmSEA input-dir [-od output-dir] [-e[l|b]] [-nostandard]  \
   [-flashbsp] [-v] [-cflags "ccstring"] [-ldflags "ldstring"]   \
   [-o output-file] [-tcs "tcspath"] [-cpath "sourcepath"]
   
   'tmSEA' creates a Self Extacting Archieve (SEA) output file.  Given a current
   input directory and its corresponding archieve directory, the input directory 
   will be embedded in a compressed form in a specified output file.
   The output file can be downloaded and run, where the input directory will be
   be uncompressed and placed in the archieve output directory.
   
   input-dir  : directory from which input data will be read.
   -od output-dir : directory to which output data will be written in archieve.
       default '/flash' - if used with flash must begin with '/flash'.
   -e[lb] : specify endianness of SEA output file.
       -eb for big endian (default).
       -el for little endian.
   -nostandard : Disable default usage of 'TriMedia' Flash.
   -flashbsp : Use flash driver that is part of relevant BSP
       default is to use flash specific driver as specified in makefile.
   -v : Specify that the auto-generated part of output is verbose.
   -cflags "cc_string" : A string of arguements to pass to tmcc when compiling 
       sources for SEA application.
   -ldflags "ld_string" : A string of arguements to pass to tmcc when linking SEA
       application.
   -o output-file: name of SEA output-file that will be created. default output
       name is 'a.out'.
   -tcs "tcspath" : Current TCS path that tmSEI will use to build TriMedia image.
        default is C:\\TriMedia for Windows users and /usr/local/tcs; for Unix users 
        default is /usr/local/tcs
   -cpath "sourcepath" : path of c source file, tmunpackarch.c, that tmSEI will use
        to create a TriMeida image. default is .\\tmunpackarch for Windows ; for Uxix
        users ./tmunpackarch is default.