readme

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

tmSEI is a tool that converts an executable object file into a compressed form, 
and adds a startup uncompressor. This kind of self extracting image will effectively 
cause a 50% size reduction of load images.

'tmSEI' accepts a standard executable image (*.out). Firstly tmSEI converts 
the executable into a memory image to reduce the loaded image. The memory image is
them compressed using the zlib compression library.  The compressed image is then stored
as data and compiled with an unpacking startup file to output a standard executable. The
new load image can then be downloaded.

The downloaded image will then uncompress the compressed data. Copy the memory image into
the specified position and then hand control over to the memory image.

The description above desribes the default behaviour. 

The input image is a standard executable and the executable must be converted to a memory
image. This is done at tmSEI run-time. The user may specify the Processor frequency 
"-tm_freq freq " , default 10000000, the MMIO base address "-mmio_base address" 
default 0xefe00000 and the cache support "-cache support", default LeaveCachingToDownloader. 
See end of README file for description of cache support options.

The output file may be either a memory image or and a standard executable. If the output
image is a memory image, then the user must specify the  memory region to tmSEI using 
the parameter '-sei begin,end'.

The user can choose whether the output file is big endian or little endian. Big endian
is the default.

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, tmunpackimage.c, if it is not
in the default location.

The user can specify which host type the output should run on. 'nohost' is the default.

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

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.

Below is a more syntacital explanation of tmSEI input parameters.

usage: tmSEI -load begin_mem,end_mem image-file [-e[l|b]] [-host type] \
   [-v] [-tm_freq freq] [-mmio_base address] [-cache support] [-sei begin,end] \
   [-cflags "ccstring"] [-ldflags "ldstring"] [-o output-file]
   [-tcs "tcspath"] [-cpath "sourcepath"]
   
   'tmSEI' creates a Self Extacting Image (SEI) output file, given an memory image
    file. The input image file will be embedded in a compressed form in the output file.
   The output image file can be downloaded and run, where the original memory image will
    be uncompressed, copied to SDRAM and executed.

   -load begin_mem,end_mem : Specify download memory region of input image-file
   input-file : name of image-file to be extracted by SEI output file
   -e[lb] : specify endianness of SEI output file
       -eb for big endian (default) 
       -el for little endian;
   -v : Specify that the auto-generated part of output is verbose
   -host type : Specify one of the following types of host processor 
       nohost    : No Host (default)
       tmsim     : TM Simulator is Host
       Win95     : Win95 is Host
       MacOS     : MacOS is Host
       WinNT     : WinNT is Host
   -tm_freq freq : Specify the TM clock frequency. 100000000 is default
   -mmio_base address : Specify MMIO base address. 0xefe00000 is default
   -cache support : Specification of setting the resposiblity of setting the cacheable
       limit and the cachelocked regions
       LeaveCachingToUser: cacheable limit and cachelocked 
           entirely under control of the user, the regions are downloader code won't
           touch it.
       LeaveCachingToDownloader: cachelocked regions and cacheble limit are entirely
           under control of the downloader, which will use this control to intelligently
           map the different cached/uncached/cachelocked sections within the specified
           sdram, partitioned in different caching property regions, and let the downloaded
           program set cacheable limit and cachelocked regions accordingly. (default)
       CachesOff: cachelocked regions and cacheble limit are entirely under control of the
           downloader, which will let the downloaded program run with 'cache off'.
   -sei begin,end : Specify download memory region for optional SEI (Self Extraction Image)
        memory image
   -cflags "cc_string" : A string of arguements to pass to tmcc when compiling sources for
       SEI application.
   -ldflags "ld_string" : A string of arguements to pass to tmcc when linking SEI
       application.
   -o output-file: name of SEI 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, tmunpackimage.c, that tmSEI will use
        to create a TriMeida image. default is .\\tmunpackimage for Windows ; for Uxix
        users ./tmunpackimage is default.


Cache Support options.

LeaveCachingToUser: cacheable limit and cachelocked \n");
   entirely under control of the user, the regions are downloader code won't\n");
   touch it.\n");
LeaveCachingToDownloader: cachelocked regions and cacheble limit are entirely\n");
   under control of the downloader, which will use this control to intelligently\n");
   map the different cached/uncached/cachelocked sections within the specified\n");
   sdram, partitioned in different caching property regions, and let the downloaded\n");
   program set cacheable limit and cachelocked regions accordingly. (default)\n");
CachesOff: cachelocked regions and cacheble limit are entirely under control of the\n");
   downloader, which will let the downloaded program run with 'cache off'.