Keil Logo

Technical Support

On-Line Manuals

µVision User's Guide

About µVision User Interface Creating Applications Debugging Debug Commands Debug Functions Simulation Flash Programming Dialogs Utilities Command Line Example Programs Appendix B. File Types C. Device Database Parameters E. Error Messages Error E000 Error E001 Error E002 Error E003 Error E004 Error E005 Error E006 Error E007 Error E008 Error E009 Error E010 Error E011 Error E012 Error E013 Error E014 Error E015 Error E016 Error E017 Error E018 Error E019 Error E020 Error E021 Error E022 Error E023 Error E024 Error E025 Error E026 Error E027 Error E028 Error E029 Error E030 Error E031 Error E032 Error E033 Error E034 Error E035 Error E036 Error E037 Error E038 Error E039 Error E040 Error E041 Error E042 Error E043 Error E044 Error E045 Error E046 Error E047 Error E048 Error E049 Error E050 Error E051 Error E052 Error E053 Error E054 Error E055 Error E056 Error E057 Error E058 Error E059 Error E060 Error E061 Error E062 Error E063 Error E064 Error E065 Error E066 Error E067 Error E068 Error E069 Error E070 Error E071 Error E072 Error E073 Error E074 Error E075 Error E076 Error E077 Error E078 Error E079 Error E080 Error E081 Error E082 Error E083 Error E084 Error E085 Error E086 Error E087 Error E088 Error E089 Error E090 Error E091 Error E092 Error E093 Error E094 Error E095 Error E096 Error E097 Error E098 Error E099 Error E100 Error E101 Error E102 Error E103 Error E104 Error E105 Error E106 Error E107 Error E108 Error E109 Error E110 Error E111 Error E112 Error E113 Error E114 Error E115 Error E116 Error E117 Error E118 Error E119 Error E120 Error E121 Error E122 Error E123 Error E124 Error E125 Error E126 Error E127 Error E128 Error E131 Error E132 Error E133 Error E140 Error E145 Error E146 Error E147 Error E148 Error E149 Error E150 Error E151 Error E152 Error E153 Error E154 Error E155 Error E156 Error E157 Error E158 Error E159 Error E160 Error E161 Error E162 Error E163 Error E164 Error E165 Error E166 Error E167 Error E168 Error E169 Error E170 Error E171 Error E172 Error E173 Error E174 Error E175 Error E176 Error E177 Error E178 Error E179 Error E180 Error E181 Error E182 Error E183 Error E184 Error E185 Error E540 Error E541 Error E542 Error E544 Regular Search Expressions H. File Converter FCARM PRINT Directive NOPRINT Directive PAGEWIDTH Directive PAGELENGHT Directive ROOT Directive

H. File Converter FCARM

This file converter reformats all web files into a single C-file which is then included and compiled into the project. All files are stored in the Virtual ROM File System.

Note

  • FCARM can be called automatically by the build process of µVision for converting image files. Refer to Using FCARM with µVision.

FCARM is invoked from the command line and has the syntax:

FCARM @commandfile

Where

commandfile is the name of a command file that can contain an inputlist, outputfile, and directives. (See below.)

or

FCARM <{>inputlist<}> <{> TO outputfile<}> <{>directives<}>

Where

inputlist a comma-separated list of files. The files get converted into one output file. Filenames must be specified with the file extension, but without the path information.
outputfile name of the output C-file containing the converted web files.
directives commands and parameters that control the operation of the file converter.

Available directives:

Directive Description
PRINT Specify the name of the listing file. Default is the base name of the output C-file with the extension *.LST.
NOPRINT Disables generation of the listing (LST) file.
PAGEWIDTH Specifies the number of characters on a line in the listing file.
PAGELENGTH Specifies the number of lines on a page in the listing file.
ROOT Specifies the root path where web files are located relative to the project directory path.

In addition to the output file, FCARM generates a listing file with the base name of the output file and the extension *.LST.

Optimization

FCARM integrates a file optimization algorithm to compress files and creates more compact and smaller executable images. FCARM decides on the file extension which kind of compression is used. Each file group has a different compression and optimization flavor.

When the filename has the tilde prefix (for example, ~doStuff.js) then compression or certain compression optimizations are disabled. This is useful when debugging a file. It is hard to trace code compacted to a single line with no spaces, no comments, and no line feeds.

Compression and optimization is performed in two iterations. In a 2nd pass, further optimization is performed resulting in better code density.

Group Extension Optimization ~Optimization (disabled)
HTML html
htm
inc
HTML compression
Performs the following optimizations:
  • replaces tab characters with spaces
  • removes line-termination CR-LF characters
  • replaces multiple spaces with a single space
  • removes leading and trailing spaces
  • removes space between two html tags (for example, "<ul> <li>")
no compression
CGI cgi
cgx
CGI compression
Optimizes scripts for maximum performance on TCPnet web server:
  • checks the script syntax
  • replaces T,C,I,# script commands with tokens
  • replaces tab characters with spaces
  • removes line-termination CR-LF characters
  • removes multiple spaces
  • removes comments from script lines
  • groups small t-commands
white space removal but without grouping of small t-commands
CSS css CSS compression
Parses and removes redundant information:
  • replaces multiple spaces with a single space
  • removes line-termination CR-LF characters
  • replaces tab characters with spaces
  • removes "/*" and "//" style comments
  • removes redundant spaces inserted in the 1st step
  • removes spaces nearby a delimiter: :;{}
no optimization
JS js JS compression
Parses and removes redundant information:
  • replaces tab characters with spaces
  • replaces multiple spaces with a single space
  • removes line-termination CR-LF characters
  • removes "/*" and "//" style comments
  • removes redundant spaces inserted in the 1st step
  • removes spaces nearby a delimiter: .,:;=!+-*/&|<>(){}"?
no optimization
others .* not affected not affected

Examples

The following command line converts and optimizes index.htm, creates the output C-file index.c, and creates the listing file index.lst.

FCARM index.htm

The following command line converts and optimizes a list of files, creates the output C-file web.c, and creates the listing file web.lst.

FCARM index.htm, keil.gif, llblue.jpg, system.cgi TO web.c

The following command line converts and optimizes a list of files, creates the output C-file web.c, and suppresses the creation of the listing file (nopr - directive). The files are located in the sub-folder Web_Files.

FCARM index.htm, keil.gif, llblue.jpg, system.cgi TO web.c nopr root(Web_Files)

The following command line converts and optimizes a list of files, creates the output C-file web.c, and creates the listing file web.lst. The file doStuff.js is excluded from optimization.

FCARM index.htm, keil.gif, llblue.jpg, system.cgi, ~doStuff.js TO web.c

The following command line uses a command file.

FCARM @FCARM_command_file
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.